What the error means
Error processing Instruction N: custom program error: 0x…
The hex number is an error code from the program that failed. The same number means different things in different programs, so you need both the code and the program ID.
| Where it comes from | Any Solana program |
| Code | Hex code, read per program |
Common codes
| Hex | Decimal | Program | Name |
|---|---|---|---|
| 0x1 | 1 | SPL Token | InsufficientFunds |
| 0x4 | 4 | SPL Token | OwnerMismatch |
| 0x11 | 17 | SPL Token | AccountFrozen |
| 0x1e | 30 | Raydium AMM v4 | ExceededSlippage |
| 0x7d6 | 2006 | Anchor | ConstraintSeeds |
| 0xbbf | 3007 | Anchor | AccountOwnedByWrongProgram |
| 0xbc4 | 3012 | Anchor | AccountNotInitialized |
| 0x1770 | 6000 | Jupiter | EmptyRoute |
| 0x1771 | 6001 | Jupiter | SlippageToleranceExceeded |
| 0x1772 | 6002 | pump.fun | TooMuchSolRequired |
| 0x1773 | 6003 | pump.fun | TooLittleSolReceived |
| 0x1774 | 6004 | PumpSwap | ExceededSlippage |
| 0x1775 | 6005 | pump.fun / Raydium CPMM | BondingCurveComplete / ExceededSlippage |
| 0x1781 | 6017 | Raydium CLMM | PriceSlippageCheck |
| 0x1798 | 6040 | pump.fun | BuyNotEnoughSolToCoverRent |
| 0x17a7 | 6055 | Meteora DLMM | LiquidityLocked |
How to fix it
- Open the failed transaction in a Solana explorer and find the program that logged the error.
- Convert the hex code to decimal, for example 0x1771 is 6001 and 0xbc4 is 3012.
- Codes from 6000 (0x1770) up are the program's own errors; look them up in its published error list or IDL.
- Codes 100 to 5000 in Anchor programs are Anchor framework errors, such as 2006 ConstraintSeeds or 3012 AccountNotInitialized.
- Small codes (0x0 to 0x13) in the SPL Token program are token errors, such as 0x1 InsufficientFunds and 0x11 AccountFrozen.
If that is not it
- Plain-text errors like "Blockhash not found" or "Insufficient funds for fee" come from the Solana runtime, not a program.
More fixes: how to decode any Solana error code and why Solana transactions fail.
Source
Error text and code from Anchor, SPL Token, pump.fun, Jupiter, Raydium and Meteora error definitions, read on 24 October 2026.