@solana/kit · Transaction building

Solana error #5663031

TRANSACTION__INSTRUCTION_HEADERS_PAYLOADS_MISMATCH

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

Message

The transaction does not have the same number of instruction headers and instruction payloads. Got $numInstructionHeaders instruction headers, and $numInstructionPayloads instruction payloads.

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

What it means

Assembling, compiling, signing and size-checking transaction messages.

What to do

  • Set a fee payer and a lifetime (blockhash or durable nonce) before compiling.
  • Keep the serialised transaction at or under 1,232 bytes; use address lookup tables for large transactions.
  • A durable-nonce transaction must have AdvanceNonceAccount as its first instruction.
@solana/errors 8.4.0 source ↗All Transaction building codes →

Decode it locally instead

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

Other Transaction building codes

5663000INVOKED_PROGRAMS_CANNOT_PAY_FEES5663001INVOKED_PROGRAMS_MUST_NOT_BE_WRITABLE5663002EXPECTED_BLOCKHASH_LIFETIME5663003EXPECTED_NONCE_LIFETIME5663004VERSION_NUMBER_OUT_OF_RANGE5663005FAILED_TO_DECOMPILE_ADDRESS_LOOKUP_TABLE_CONTENTS_MISSING5663006FAILED_TO_DECOMPILE_ADDRESS_LOOKUP_TABLE_INDEX_OUT_OF_RANGE5663007FAILED_TO_DECOMPILE_INSTRUCTION_PROGRAM_ADDRESS_NOT_FOUND

Decode another error

Try: