@solana/kit · RPC subscriptions (WebSocket)

Solana error #8190002

RPC_SUBSCRIPTIONS__CHANNEL_CLOSED_BEFORE_MESSAGE_BUFFERED

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

Message

WebSocket was closed before payload could be added to the send buffer

What it means

WebSocket connection and subscription lifecycle errors.

What to do

  • Check the wss:// URL and that the provider supports subscriptions on your plan.
  • Handle abort signals: subscriptions end when their AbortSignal fires.
@solana/errors 8.4.0 source ↗All RPC subscriptions (WebSocket) codes →

Decode it locally instead

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

Other RPC subscriptions (WebSocket) codes

8190000CANNOT_CREATE_SUBSCRIPTION_PLAN8190001EXPECTED_SERVER_SUBSCRIPTION_ID8190003CHANNEL_CONNECTION_CLOSED8190004CHANNEL_FAILED_TO_CONNECT

Decode another error

Try: