@solana/kit · Invariant violations

Solana error #9900000

INVARIANT_VIOLATION__SUBSCRIPTION_ITERATOR_STATE_MISSING

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

Message

Invariant violation: WebSocket message iterator is missing state storage. It should be impossible to hit this error; please file an issue at https://sola.na/web3invariant

What it means

Internal consistency checks that should never fail in normal use.

What to do

  • These indicate a bug in Kit or in a custom plugin. Report it with a reproduction.
@solana/errors 8.4.0 source ↗All Invariant violations codes →

Decode it locally instead

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

Other Invariant violations codes

9900001SUBSCRIPTION_ITERATOR_MUST_NOT_POLL_BEFORE_RESOLVING_EXISTING_MESSAGE_PROMISE9900002CACHED_ABORTABLE_ITERABLE_CACHE_ENTRY_MISSING9900003SWITCH_MUST_BE_EXHAUSTIVE9900004DATA_PUBLISHER_CHANNEL_UNIMPLEMENTED9900005INVALID_INSTRUCTION_PLAN_KIND9900006INVALID_TRANSACTION_PLAN_KIND

Decode another error

Try: