@solana/kit · JSON-RPC server errors

Solana error #-32602

JSON_RPC__INVALID_PARAMS

Appears as Solana error #-32602; Decode this error by running `npx @solana/errors decode -- -32602 '…'`

Message

JSON-RPC error: Invalid method parameter(s) ($__serverMessage)

Placeholders (__serverMessage) are filled from the error’s context. Paste the base64 argument below to see the real values.

What it means

Errors returned by the RPC node itself. The numeric code is the JSON-RPC error code from the server (negative numbers), wrapped by Kit.

What to do

  • The $__serverMessage in the context is the node's own explanation; read it first.
  • Preflight failures wrap a transaction or instruction error. Paste the full message into the decoder to get the inner error's page.
  • Node-unhealthy, slot-skipped and block-not-available errors are transient or endpoint-specific: retry or switch RPC provider.
@solana/errors 8.4.0 source ↗All JSON-RPC server errors codes →

Decode it locally instead

npx @solana/errors decode -- -32602 '<base64 context>'

In development, import from @solana/kit as usual and the full message is thrown. In production the message is stripped to keep bundles small; the error object still carries error.context with the same values this page decodes, and isSolanaError(err, SOLANA_ERROR__JSON_RPC__INVALID_PARAMS) lets you branch on it.

Other JSON-RPC server errors codes

-32700PARSE_ERROR-32603INTERNAL_ERROR-32601METHOD_NOT_FOUND-32600INVALID_REQUEST-32021SERVER_ERROR_NO_SLOT_HISTORY-32020SERVER_ERROR_FILTER_TRANSACTION_NOT_FOUND-32019SERVER_ERROR_LONG_TERM_STORAGE_UNREACHABLE-32018SERVER_ERROR_SLOT_NOT_EPOCH_BOUNDARY

Decode another error

Try: