@solana/kit · JSON-RPC server errors

Solana error #-32019

JSON_RPC__SERVER_ERROR_LONG_TERM_STORAGE_UNREACHABLE

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

Message

Failed to query long-term storage; please try again

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 -- -32019 '<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_LONG_TERM_STORAGE_UNREACHABLE) 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-32018SERVER_ERROR_SLOT_NOT_EPOCH_BOUNDARY

Decode another error

Try: