@solana/kit · Instruction errors (on-chain)

Solana error #4615011

INSTRUCTION_ERROR__UNBALANCED_INSTRUCTION

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

Message

Sum of account balances before and after instruction do not match

What it means

Kit's typed wrappers around the runtime's InstructionError variants. The same errors exist in the legacy format; see the linked page for causes and fixes.

What to do

  • The index in the context is the failing instruction's position in the transaction.
  • INSTRUCTION_ERROR__CUSTOM carries the program's own error code; this site decodes it.

This wraps the on-chain error UnbalancedInstruction, which has its own page with causes and fixes.

@solana/errors 8.4.0 source ↗All Instruction errors (on-chain) codes →

Decode it locally instead

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

Other Instruction errors (on-chain) codes

4615000UNKNOWN4615001GENERIC_ERROR4615002INVALID_ARGUMENT4615003INVALID_INSTRUCTION_DATA4615004INVALID_ACCOUNT_DATA4615005ACCOUNT_DATA_TOO_SMALL4615006INSUFFICIENT_FUNDS4615007INCORRECT_PROGRAM_ID

Decode another error

Try: