@solana/kit · Instruction plans

Solana error #7618011

INSTRUCTION_PLANS__INVALID_MAX_INSTRUCTIONS_PER_TRANSACTION

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

Message

The configured maximum of $maxInstructions instructions per transaction is invalid. It must be a positive integer no greater than the transaction format limit of $transactionInstructionLimit instructions per transaction. Provide a `maxInstructionsPerTransaction` (on the transaction planner) or `maxInstructions` (on the message packer) value between 1 and $transactionInstructionLimit.

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

What it means

The instruction-plan executor could not pack or execute a plan.

What to do

  • Reduce the size of individual instructions, or split sequential plans into smaller transactions.

Decode it locally instead

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

Decode another error

Try: