@solana/kit · Instruction plans

Solana error #7618010

INSTRUCTION_PLANS__MAX_INSTRUCTIONS_PER_TRANSACTION_EXCEEDED

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

Message

Planning this transaction message would require $numInstructions instructions, which exceeds the configured maximum of $maxInstructions instructions per transaction. This limit is configurable, and intended to leave headroom for inner instructions which are included in the maximum instruction limit for transactions. Increase `maxInstructionsPerTransaction` on the transaction planner (or `maxInstructions` on the message packer) to allow more instructions per transaction.

Placeholders (numInstructions, maxInstructions) 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 -- 7618010 '<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__MAX_INSTRUCTIONS_PER_TRANSACTION_EXCEEDED) lets you branch on it.

Decode another error

Try: