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

Solana error #4615000

INSTRUCTION_ERROR__UNKNOWN

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

Message

The instruction failed with the error: $errorName

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

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.
@solana/errors 8.4.0 source ↗All Instruction errors (on-chain) codes →

Decode it locally instead

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

Other Instruction errors (on-chain) codes

4615001GENERIC_ERROR4615002INVALID_ARGUMENT4615003INVALID_INSTRUCTION_DATA4615004INVALID_ACCOUNT_DATA4615005ACCOUNT_DATA_TOO_SMALL4615006INSUFFICIENT_FUNDS4615007INCORRECT_PROGRAM_ID4615008MISSING_REQUIRED_SIGNATURE

Decode another error

Try: