Skip to main content

Network Information

Complete network configuration reference for GhostSpeak on Solana devnet and upcoming mainnet deployment.

Current Network: Solana Devnet

Production Status: GhostSpeak is currently devnet-only. Do not use real funds or production agents. Mainnet launch planned for Q1 2026.

Devnet Configuration

const config = {
  cluster: 'devnet',
  programId: '4wHjA2a5YC4twZb4NQpwZpixo5FgxxzuJUrCG7UnF9pB',
  rpcUrl: 'https://api.devnet.solana.com',
  commitment: 'confirmed',
}

RPC Endpoints

Public RPC Endpoints (Devnet)

Official Solana Devnet RPC
https://api.devnet.solana.com
  • Rate Limit: ~100 requests/second (shared)
  • Reliability: High
  • Cost: Free
  • Best For: Testing, development
Recommendation: Use Helius or QuickNode for production-grade testing with higher reliability and better rate limits.

SDK RPC Configuration

import { GhostSpeakClient } from '@ghostspeak/sdk'

// Option 1: Use default public RPC
const client = new GhostSpeakClient({
  cluster: 'devnet',
})

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

// Option 3: Advanced configuration
const client = new GhostSpeakClient({
  cluster: 'devnet',
  rpcUrl: 'https://api.devnet.solana.com',
  rpcConfig: {
    commitment: 'confirmed',
    confirmTransactionInitialTimeout: 60000, // 60 seconds
  },
})

Blockchain Explorers

Devnet Explorers


Mainnet Explorers (GHOST Token)


Faucets (Get Devnet SOL)

1

Solana CLI Faucet

Fastest method via command line:
solana airdrop 2 YOUR_WALLET_ADDRESS --url devnet
  • Limit: 2 SOL per request
  • Cooldown: 24 hours between requests
  • Requires: Solana CLI installed
2

Web Faucet (Solana)

Official web faucet:Visit: https://faucet.solana.com
  • Limit: 1-2 SOL per request
  • Cooldown: 24 hours
  • No signup required
3

QuickNode Faucet

Multi-token faucet:Visit: https://faucet.quicknode.com/solana/devnet
  • Limit: 0.1 SOL per request
  • Cooldown: 1 hour
  • Also provides: USDC, USDT devnet tokens
4

Discord Faucet

Community faucet:Join Solana Discord and use:
!faucet YOUR_WALLET_ADDRESS
  • Limit: 1 SOL per request
  • Cooldown: 24 hours
  • Community support available
Pro Tip: If you need more devnet SOL, create multiple devnet wallets and aggregate the airdrops.

Network Parameters

Transaction Costs (Devnet)

OperationEstimated CostNotes
Agent Registration~0.003 SOLIncludes PDA creation + account rent
Issue Credential (cNFT)~0.0002 SOLCompressed NFT (5000x cheaper)
Update Reputation~0.00001 SOLAccount write operation
Stake GHOST~0.0005 SOLToken account + staking account
Create DID~0.002 SOLDID document account creation
Rent-Exempt Minimum: All accounts are rent-exempt (permanent). Costs include both transaction fees and rent deposit.

Transaction Limits

ParameterValueDescription
Max Transaction Size1232 bytesTotal serialized transaction size
Max Instructions64Instructions per transaction
Max Accounts64Accounts per transaction
Compute Units200,000 defaultCan request up to 1.4M with priority fees
Max Retry Time60 secondsBlockhashExpired after this

Commitment Levels

Choose the right commitment level for your use case:
Fastest (not recommended for production)
{ commitment: 'processed' }
  • Transaction validated by leader
  • Not guaranteed to be finalized
  • Latency: ~400ms
  • Use for: Immediate UI feedback
GhostSpeak Default: We use confirmed commitment for best balance of speed and safety.

Mainnet Configuration (Q1 2026)

Coming Soon: Mainnet deployment planned for Q1 2026. Configuration details will be updated closer to launch.
Expected Mainnet Configuration:
const mainnetConfig = {
  cluster: 'mainnet-beta',
  programId: 'TBD', // Will be announced at launch
  rpcUrl: 'https://api.mainnet-beta.solana.com',
  commitment: 'confirmed',
}
Migration Path:
  1. SDK v2.1.0 will support both devnet and mainnet
  2. Simple cluster: 'mainnet-beta' switch
  3. No code changes required beyond configuration
  4. Full backward compatibility maintained

Network Health Monitoring


WebSocket Endpoints

For real-time updates (account changes, transaction confirmations):
import { createSolanaRpc, createSolanaRpcSubscriptions } from '@solana/rpc'

// HTTP RPC
const rpc = createSolanaRpc('https://api.devnet.solana.com')

// WebSocket RPC
const rpcSubscriptions = createSolanaRpcSubscriptions('wss://api.devnet.solana.com')

// Subscribe to account changes
const subscription = await rpcSubscriptions
  .accountNotifications(agentAddress, { commitment: 'confirmed' })
  .subscribe(async (notification) => {
    console.log('Agent account updated:', notification)
  })
WebSocket Endpoints:
  • Devnet: wss://api.devnet.solana.com
  • Mainnet: wss://api.mainnet-beta.solana.com

Rate Limiting Best Practices

async function retryRpcCall<T>(fn: () => Promise<T>, maxRetries = 3): Promise<T> {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn()
    } catch (error) {
      if (i === maxRetries - 1) throw error
      await new Promise(resolve => setTimeout(resolve, 2 ** i * 1000))
    }
  }
  throw new Error('Max retries exceeded')
}
// Instead of multiple getProgramAccounts calls
const agents = await client.agents.getAllAgents({
  filters: { owner: walletAddress }
})

// Use batch fetch for multiple accounts
const accounts = await rpc.getMultipleAccounts([addr1, addr2, addr3]).send()
const client = new GhostSpeakClient({
  cluster: 'devnet',
  cache: {
    enabled: true,
    ttl: 60000, // 60 seconds
  },
})

Troubleshooting Network Issues

IssueCauseSolution
429 Too Many RequestsRate limit exceededUse paid RPC provider or implement backoff
Connection timeoutRPC overloadedSwitch to alternative RPC endpoint
Blockhash not foundTransaction too oldFetch fresh blockhash before signing
Account not foundWrong networkVerify cluster configuration
Signature verification failedNetwork mismatchEnsure signer network matches RPC network

Need Help? Join our Discord for network troubleshooting and RPC recommendations.