@solana/kit · Codecs

Solana error #8078017

CODECS__UNION_VARIANT_OUT_OF_RANGE

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

Message

Union variant out of range. Expected an index between $minRange and $maxRange, got $variant.

Placeholders (minRange, maxRange, variant) 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 -- 8078017 '<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__UNION_VARIANT_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: