@solana/kit · Invariant violations
Solana error #9900003
INVARIANT_VIOLATION__SWITCH_MUST_BE_EXHAUSTIVE
Appears as Solana error #9900003; Decode this error by running `npx @solana/errors decode -- 9900003 '…'`
Message
Invariant violation: Switch statement non-exhaustive. Received unexpected value `$unexpectedValue`. It should be impossible to hit this error; please file an issue at https://sola.na/web3invariant
Placeholders (unexpectedValue) are filled from the error’s context. Paste the base64 argument below to see the real values.
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.
Decode it locally instead
npx @solana/errors decode -- 9900003 '<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__SWITCH_MUST_BE_EXHAUSTIVE) lets you branch on it.