@solana/kit · JSON-RPC server errors

Solana error #-32001

JSON_RPC__SERVER_ERROR_BLOCK_CLEANED_UP

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

Message

$__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 -- -32001 '<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__SERVER_ERROR_BLOCK_CLEANED_UP) lets you branch on it.

Other JSON-RPC server errors codes

-32700PARSE_ERROR-32603INTERNAL_ERROR-32602INVALID_PARAMS-32601METHOD_NOT_FOUND-32600INVALID_REQUEST-32021SERVER_ERROR_NO_SLOT_HISTORY-32020SERVER_ERROR_FILTER_TRANSACTION_NOT_FOUND-32019SERVER_ERROR_LONG_TERM_STORAGE_UNREACHABLE

Decode another error

Try: