@solana/kit · JSON-RPC server errors

Solana error #-32002

JSON_RPC__SERVER_ERROR_SEND_TRANSACTION_PREFLIGHT_FAILURE

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

Message

Transaction simulation failed

What it means

The node simulated the transaction before sending and it failed. The inner cause is a transaction or instruction error.

What to do

  • Read error.cause (a TRANSACTION_ERROR__* or INSTRUCTION_ERROR__* Kit error) and the logs in the context.
  • Paste the simulation logs into the decoder on this site to get the failing program and code.

Decode it locally instead

npx @solana/errors decode -- -32002 '<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_SEND_TRANSACTION_PREFLIGHT_FAILURE) lets you branch on it.

Decode another error

Try: