Solana error codes › 0x1

custom program error: 0x1 (1)

0x1 is decimal 1. Its meaning depends on the program that failed: InvalidProgramAddress in Raydium AMM V4, ResultWithNegativeLamports in System Program, InsufficientFunds in SPL Token and 5 more below.

Small numbers like this are used by native programs (System, SPL Token, Token-2022, Raydium AMM v4 and others), each with its own list, so the meaning depends on which program failed.

System Program: ResultWithNegativeLamports

The paying account does not have enough SOL for the transfer or account creation, on top of the network fee.

What to do: Add SOL to the wallet that pays, or lower the amount. Keep a small SOL balance for fees and for the rent of any new token account the transaction creates.

SPL Token: InsufficientFunds

The source token account holds fewer tokens than the instruction tries to move or burn.

What to do: Check the token balance. In code, remember that amounts are raw base units: multiply the UI amount by 10^decimals of the mint.

Token-2022: InsufficientFunds

The source token account holds fewer tokens than the instruction tries to move or burn.

What to do: Check the token balance. Token-2022 mints with a transfer fee also withhold part of each transfer, so the amount received can be lower than the amount sent.

0x1 by program

ProgramError
Raydium AMM V4InvalidProgramAddress
System ProgramResultWithNegativeLamports
Account does not have enough SOL to perform the operation.
The paying account does not have enough SOL for the transfer or account creation, on top of the network fee.
SPL TokenInsufficientFunds
Insufficient funds
The source token account holds fewer tokens than the instruction tries to move or burn.
Token-2022InsufficientFunds
Insufficient funds
The source token account holds fewer tokens than the instruction tries to move or burn.
Metaplex NFT PacksWrongRedeemDate
Wrong redeem date
Metaplex Token MetadataInstructionPackError
PhoenixInvalidMarketAuthority
Invalid market authority error
SPL Token SwapInvalidProgramAddress
Invalid program address generated from bump seed and key

Same code, other formats

custom program error: 0x1 · {"Custom":1} · Custom(1) · Error Number: 1

How to tell which program failed

  1. Open the failed transaction in an explorer (or the simulation result in your code) and read the program logs.
  2. Find the line Program <address> failed: custom program error: 0x…. If several programs failed with the same code, the first one listed is the deepest call, the one that raised it.
  3. Look the code up for that program. Error processing Instruction 2 is a zero-based index, so it points to the third instruction (often the first one after two Compute Budget instructions).

Decode your exact error

Free, no sign-up, nothing to connect. Works offline from a bundled list; we do not look anything up on-chain.

Swapping a token you do not know? A free Rugsight check shows mint and freeze authority, Token-2022 extensions, holder concentration and liquidity before you trade.

← 0x0 · 0x2 → · All Solana error codes

Data: program error lists from published IDLs (solana-idls 1.2.1, MIT) and the System, SPL Token, Token-2022 and Associated Token Account source code, snapshot 2026-11-16. Programs can be upgraded and add or change errors; the failing program's current IDL is the final word.