Solana error codes › SPL Token

SPL Token error codes

20 error codes defined by SPL Token (program ID TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA). In logs they appear as custom program error: 0x… after Program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA failed.

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.

SPL Token: MintMismatch

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.

SPL Token: OwnerMismatch

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.

SPL Token: AccountFrozen

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.

HexCodeError
0x00NotRentExempt
Lamport balance below rent-exempt threshold
0x11InsufficientFunds
Insufficient funds
The source token account holds fewer tokens than the instruction tries to move or burn.
0x22InvalidMint
Invalid Mint
0x33MintMismatch
Account not associated with this Mint
A token account passed to the instruction belongs to a different mint than the one expected.
0x44OwnerMismatch
Owner does not match
The signer is not the owner (or approved delegate) of the token account being debited.
0x55FixedSupply
Fixed supply
0x66AlreadyInUse
Already in use
The name points to account state: an account was expected to exist (or not exist) already.
0x77InvalidNumberOfProvidedSigners
Invalid number of provided signers
The name points to a permission check: the wrong signer or owner account was passed.
0x88InvalidNumberOfRequiredSigners
Invalid number of required signers
The name points to a permission check: the wrong signer or owner account was passed.
0x99UninitializedState
State is unititialized
The name points to account state: an account was expected to exist (or not exist) already.
0xa10NativeNotSupported
Instruction does not support native tokens
0xb11NonNativeHasBalance
Non-native account can only be closed if its balance is zero
0xc12InvalidInstruction
Invalid instruction
0xd13InvalidState
State is invalid for requested operation
0xe14Overflow
Operation overflowed
The name points to a checked arithmetic failure inside the program, often from extreme amounts or an outdated client.
0xf15AuthorityTypeNotSupported
Account does not support specified authority type
0x1016MintCannotFreeze
This token mint cannot freeze accounts
0x1117AccountFrozen
Account is frozen
The token account is frozen. Only the mint's freeze authority can freeze or thaw token accounts.
0x1218MintDecimalsMismatch
The provided decimals value different from the Mint decimals
0x1319NonNativeNotSupported
Instruction does not support non-native tokens

Decode an 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.

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.