@solana/kit · Codecs

Solana error #8078002

CODECS__EXPECTED_FIXED_LENGTH

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

Message

Expected a fixed-size codec, got a variable-size one.

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 -- 8078002 '<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__EXPECTED_FIXED_LENGTH) lets you branch on it.

Other Codecs codes

8078000CANNOT_DECODE_EMPTY_BYTE_ARRAY8078001INVALID_BYTE_LENGTH8078003EXPECTED_VARIABLE_LENGTH8078004ENCODER_DECODER_SIZE_COMPATIBILITY_MISMATCH8078005ENCODER_DECODER_FIXED_SIZE_MISMATCH8078006ENCODER_DECODER_MAX_SIZE_MISMATCH8078007INVALID_NUMBER_OF_ITEMS8078008ENUM_DISCRIMINATOR_OUT_OF_RANGE

Decode another error

Try: