@solana/kit · Codecs

Solana error #8078016

CODECS__LITERAL_UNION_DISCRIMINATOR_OUT_OF_RANGE

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

Message

Literal union discriminator out of range. Expected a number between $minRange and $maxRange, got $discriminator.

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

What it means

Encoding and decoding bytes: wrong sizes, out-of-range numbers, enum discriminators, sentinels, invalid strings.

What to do

  • Match the codec exactly to the on-chain layout: integer width, endianness, prefix sizes and option encoding.
  • EXPECTED_DECODER_TO_CONSUME_ENTIRE_BYTE_ARRAY usually means the decoder is for a different account version.
@solana/errors 8.4.0 source ↗All Codecs codes →

Decode it locally instead

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

Other Codecs codes

8078000CANNOT_DECODE_EMPTY_BYTE_ARRAY8078001INVALID_BYTE_LENGTH8078002EXPECTED_FIXED_LENGTH8078003EXPECTED_VARIABLE_LENGTH8078004ENCODER_DECODER_SIZE_COMPATIBILITY_MISMATCH8078005ENCODER_DECODER_FIXED_SIZE_MISMATCH8078006ENCODER_DECODER_MAX_SIZE_MISMATCH8078007INVALID_NUMBER_OF_ITEMS

Decode another error

Try: