TriportRPC

Solana errors

Solana methods use the shared JSON-RPC {jsonrpc,id,error} envelope. See the shared error reference for product codes -32001 through -32005 and -32601.

Common Solana-specific cases documented by the method pages are:

  • -32602 for malformed base58 public keys, invalid configs, invalid filters, and stale or unknown subscription IDs;
  • -32002 tier_insufficient when a key cannot use a gated category such as sol_das;
  • -32003 rate_limited when category RPS is exceeded; honor Retry-After;
  • WebSocket application code 4029 when the subscription rate is exceeded.

Do not turn a normal null result or an empty account into an error. Individual method pages document method-specific validation and upstream errors.