@solana/kit · RPC transport

Solana error #8100001

RPC__TRANSPORT_HTTP_HEADER_FORBIDDEN

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

Message

HTTP header(s) forbidden: $headers. Learn more at https://developer.mozilla.org/en-US/docs/Glossary/Forbidden_header_name.

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

What it means

HTTP transport layer errors when talking to an RPC endpoint.

What to do

  • HTTP 429 means you are rate limited (very common on the public endpoint); use a dedicated provider.
  • HTTP 403 often means the public RPC rejected a browser or data-centre origin; add an API-keyed endpoint.
  • 5xx responses are provider outages: retry with backoff or fail over.
@solana/errors 8.4.0 source ↗All RPC transport codes →

Decode it locally instead

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

Other RPC transport codes

8100000INTEGER_OVERFLOW8100002TRANSPORT_HTTP_ERROR8100003API_PLAN_MISSING_FOR_RPC_METHOD

Decode another error

Try: