Solana error codes › SPL Token
20 error codes defined by SPL Token (program ID TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA). In logs they appear as custom program error: 0x… after Program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA failed.
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.
A token account passed to the instruction belongs to a different mint than the one expected.
What to do: Use the token account (usually the associated token account) for the same mint as the other accounts in the instruction.
The signer is not the owner (or approved delegate) of the token account being debited.
What to do: Sign with the token account's owner, or pass the right token account for the signing wallet.
The token account is frozen. Only the mint's freeze authority can freeze or thaw token accounts.
What to do: A frozen account cannot send tokens until the freeze authority thaws it. If the mint still has a freeze authority, its holder can freeze accounts at any time.
| Hex | Code | Error |
|---|---|---|
| 0x0 | 0 | NotRentExempt Lamport balance below rent-exempt threshold |
| 0x1 | 1 | InsufficientFunds Insufficient funds The source token account holds fewer tokens than the instruction tries to move or burn. |
| 0x2 | 2 | InvalidMint Invalid Mint |
| 0x3 | 3 | MintMismatch Account not associated with this Mint A token account passed to the instruction belongs to a different mint than the one expected. |
| 0x4 | 4 | OwnerMismatch Owner does not match The signer is not the owner (or approved delegate) of the token account being debited. |
| 0x5 | 5 | FixedSupply Fixed supply |
| 0x6 | 6 | AlreadyInUse Already in use The name points to account state: an account was expected to exist (or not exist) already. |
| 0x7 | 7 | InvalidNumberOfProvidedSigners Invalid number of provided signers The name points to a permission check: the wrong signer or owner account was passed. |
| 0x8 | 8 | InvalidNumberOfRequiredSigners Invalid number of required signers The name points to a permission check: the wrong signer or owner account was passed. |
| 0x9 | 9 | UninitializedState State is unititialized The name points to account state: an account was expected to exist (or not exist) already. |
| 0xa | 10 | NativeNotSupported Instruction does not support native tokens |
| 0xb | 11 | NonNativeHasBalance Non-native account can only be closed if its balance is zero |
| 0xc | 12 | InvalidInstruction Invalid instruction |
| 0xd | 13 | InvalidState State is invalid for requested operation |
| 0xe | 14 | Overflow Operation overflowed The name points to a checked arithmetic failure inside the program, often from extreme amounts or an outdated client. |
| 0xf | 15 | AuthorityTypeNotSupported Account does not support specified authority type |
| 0x10 | 16 | MintCannotFreeze This token mint cannot freeze accounts |
| 0x11 | 17 | AccountFrozen Account is frozen The token account is frozen. Only the mint's freeze authority can freeze or thaw token accounts. |
| 0x12 | 18 | MintDecimalsMismatch The provided decimals value different from the Mint decimals |
| 0x13 | 19 | NonNativeNotSupported Instruction does not support non-native tokens |
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.
Source: solana-idls@1.2.1. 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.