# Remove old version
bun remove @ghostspeak/sdk

# Install new version
bun add @ghostspeak/sdk@latest

# Update peer dependencies
bun add @solana/kit@latest @solana/rpc@latest @solana/addresses@latest

{
  "dependencies": {
    "@ghostspeak/sdk": "^2.0.7",
    "@solana/kit": "^5.1.0",
    "@solana/rpc": "^5.1.0",
    "@solana/addresses": "^5.1.0",
    "@solana/signers": "^5.1.0"
  }
}

import { GhostSpeakClient } from '@ghostspeak/sdk'

// Cluster was optional, defaulted to devnet
const client = new GhostSpeakClient()

// Or with custom RPC
const client = new GhostSpeakClient({
  rpcUrl: 'https://api.devnet.solana.com'
})

import { GhostSpeakClient } from '@ghostspeak/sdk'

// Cluster is now required
const client = new GhostSpeakClient({
  cluster: 'devnet', // Required: 'devnet' or 'mainnet-beta'
})

// With custom RPC
const client = new GhostSpeakClient({
  cluster: 'devnet',
  rpcUrl: 'https://devnet.helius-rpc.com/?api-key=YOUR_KEY',
})

// Agent registration returned just the address
const agentId: string = await client.agents.register(signer, {
  name: 'My Agent',
  capabilities: ['chat'],
  model: 'gpt-4',
})

console.log('Agent ID:', agentId)

// Agent registration returns full transaction result
const result = await client.agents.register(signer, {
  name: 'My Agent',
  capabilities: ['chat'],
  model: 'gpt-4',
})

console.log('Agent Address:', result.address)
console.log('Transaction Signature:', result.signature)
console.log('Explorer:', `https://solscan.io/tx/${result.signature}?cluster=devnet`)

// Find all instances of:
const agentId = await client.agents.register(...)

// Replace with:
const { address: agentId, signature } = await client.agents.register(...)

try {
  const agent = await client.agents.getAgent(agentId)
} catch (error) {
  // String matching and generic error handling
  if (error.message.includes('not found')) {
    console.log('Agent not found')
  } else if (error.message.includes('network')) {
    console.log('Network error')
  } else {
    console.error('Unknown error:', error)
  }
}

import {
  AccountNotFoundError,
  NetworkError,
  GhostSpeakError,
  formatErrorForUser,
} from '@ghostspeak/sdk/errors'

try {
  const agent = await client.agents.getAgent(agentId)
} catch (error) {
  // Typed error handling with rich context
  if (error instanceof AccountNotFoundError) {
    console.log('Agent not found:', error.address)
    console.log('Account Type:', error.accountType)
  } else if (error instanceof NetworkError) {
    console.log('Network error (will retry automatically)')
  } else if (error instanceof GhostSpeakError) {
    // All SDK errors have user-friendly messages
    console.error(formatErrorForUser(error))
  } else {
    console.error('Unexpected error:', error)
  }
}

import {
  Connection,
  PublicKey,
  Keypair,
  Transaction,
} from '@solana/web3.js'

const connection = new Connection('https://api.devnet.solana.com')
const pubkey = new PublicKey('4wHjA2a5YC4twZb4NQpwZpixo5FgxxzuJUrCG7UnF9pB')
const keypair = Keypair.generate()

import { createSolanaRpc } from '@solana/rpc'
import { address } from '@solana/addresses'
import { generateKeyPairSigner } from '@solana/signers'

const rpc = createSolanaRpc('https://api.devnet.solana.com')
const programAddress = address('4wHjA2a5YC4twZb4NQpwZpixo5FgxxzuJUrCG7UnF9pB')
const signer = await generateKeyPairSigner()

# Find all PublicKey usage
grep -r "PublicKey" src/

# Find all Connection usage
grep -r "new Connection" src/

# Find all Keypair usage
grep -r "Keypair" src/

import { ConnectionManager } from '@ghostspeak/sdk'

const manager = new ConnectionManager({
  cluster: 'devnet',
  poolSize: 5,
})

const connection = manager.getConnection()

import { GhostSpeakClient } from '@ghostspeak/sdk'

// GhostSpeakClient manages connections internally
const client = new GhostSpeakClient({
  cluster: 'devnet',
  // Connection pooling is automatic
})

// Access RPC client if needed
const rpc = client.rpc

// tests/setup.ts

// Before (v1.x)
const client = new GhostSpeakClient()

// After (v2.x)
const client = new GhostSpeakClient({ cluster: 'devnet' })

// Before (v1.x)
vi.mock('@solana/web3.js', () => ({
  Connection: vi.fn(),
  PublicKey: vi.fn(),
}))

// After (v2.x)
vi.mock('@solana/rpc', () => ({
  createSolanaRpc: vi.fn(),
}))

vi.mock('@solana/addresses', () => ({
  address: vi.fn((addr: string) => addr),
}))

bun add @ghostspeak/[email protected]

// Devnet (existing, no changes needed)
const devClient = new GhostSpeakClient({ cluster: 'devnet' })

// Mainnet (new)
const mainnetClient = new GhostSpeakClient({ cluster: 'mainnet-beta' })

// .env
GHOSTSPEAK_CLUSTER=devnet
SOLANA_RPC_URL=https://api.devnet.solana.com

// .env
GHOSTSPEAK_CLUSTER=mainnet-beta
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com

const client = new GhostSpeakClient({
  cluster: process.env.GHOSTSPEAK_CLUSTER as 'devnet' | 'mainnet-beta',
  rpcUrl: process.env.SOLANA_RPC_URL,
})

// This will show deprecation warning in v2.x
const manager = new ConnectionManager({ cluster: 'devnet' })
// Warning: ConnectionManager is deprecated. Use GhostSpeakClient instead.