Solana error codes › Token-2022

Token-2022 error codes

69 error codes defined by Token-2022 (program ID TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb). In logs they appear as custom program error: 0x… after Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb failed.

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.

Token-2022: MintMismatch

A token account passed to the instruction belongs to a different mint than the one expected.

What to do: Use the token account for the same mint. Token-2022 accounts must also be derived with the Token-2022 program ID, not the classic Token program ID.

Token-2022: 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.

Token-2022: 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.

Token-2022: NonTransferable

The mint has the Non-Transferable extension, so its tokens cannot be transferred between owners.

What to do: Transfers of this token will keep failing; this is how the mint was configured.

Token-2022: MintPaused

The mint has the Pausable extension and transfers, minting and burning are currently paused.

What to do: Wait until the mint's pause authority resumes the mint. Holders cannot unpause it.

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 uninitialized
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
0x1420ExtensionTypeMismatch
Extension type does not match already existing extensions
0x1521ExtensionBaseMismatch
Extension does not match the base type provided
0x1622ExtensionAlreadyInitialized
Extension already initialized on this account
The name points to account state: an account was expected to exist (or not exist) already.
0x1723ConfidentialTransferAccountHasBalance
An account can only be closed if its confidential balance is zero
0x1824ConfidentialTransferAccountNotApproved
Account not approved for confidential transfers
0x1925ConfidentialTransferDepositsAndTransfersDisabled
Account not accepting deposits or transfers
The name points to a feature or pool state that currently blocks this action.
0x1a26ConfidentialTransferElGamalPubkeyMismatch
ElGamal public key mismatch
0x1b27ConfidentialTransferBalanceMismatch
Balance mismatch
0x1c28MintHasSupply
Mint has non-zero supply. Burn all tokens before closing the mint
0x1d29NoAuthorityExists
No authority exists to perform the desired operation
0x1e30TransferFeeExceedsMaximum
Transfer fee exceeds maximum of 10,000 basis points
0x1f31MintRequiredForTransfer
Mint required for this account to transfer tokens, use `transfer_checked` or `transfer_checked_with_fee`
0x2032FeeMismatch
Calculated fee does not match expected fee
0x2133FeeParametersMismatch
0x2234ImmutableOwner
The owner authority cannot be changed
0x2335AccountHasWithheldTransferFees
An account can only be closed if its withheld fee balance is zero, harvest fees to the mint and try again
0x2436NoMemo
No memo in previous instruction; required for recipient to receive a transfer
0x2537NonTransferable
Transfer is disabled for this mint
The mint has the Non-Transferable extension, so its tokens cannot be transferred between owners.
0x2638NonTransferableNeedsImmutableOwnership
Non-transferable tokens can't be minted to an account without immutable ownership
0x2739MaximumPendingBalanceCreditCounterExceeded
0x2840MaximumDepositAmountExceeded
Deposit amount exceeds maximum limit
0x2941CpiGuardSettingsLocked
CPI Guard cannot be enabled or disabled in CPI
0x2a42CpiGuardTransferBlocked
CPI Guard is enabled, and a program attempted to transfer user funds via CPI without using a delegate
0x2b43CpiGuardBurnBlocked
0x2c44CpiGuardCloseAccountBlocked
CPI Guard is enabled, and a program attempted to close an account via CPI without returning lamports to owner
0x2d45CpiGuardApproveBlocked
CPI Guard is enabled, and a program attempted to approve a delegate via CPI
0x2e46CpiGuardSetAuthorityBlocked
0x2f47CpiGuardOwnerChangeBlocked
Account ownership cannot be changed while CPI Guard is enabled
0x3048ExtensionNotFound
Extension not found in account data
0x3149NonConfidentialTransfersDisabled
Non-confidential transfers disabled
The name points to a feature or pool state that currently blocks this action.
0x3250ConfidentialTransferFeeAccountHasWithheldFee
An account can only be closed if the confidential withheld fee is zero
0x3351InvalidExtensionCombination
A mint or an account is initialized to an invalid combination of extensions
0x3452InvalidLengthForAlloc
Extension allocation with overwrite must use the same length
0x3553AccountDecryption
Failed to decrypt a confidential transfer account
0x3654ProofGeneration
Failed to generate proof
0x3755InvalidProofInstructionOffset
An invalid proof instruction offset was provided
0x3856HarvestToMintDisabled
Harvest of withheld tokens to mint is disabled
The name points to a feature or pool state that currently blocks this action.
0x3957SplitProofContextStateAccountsNotSupported
Split proof context state accounts not supported for instruction
0x3a58NotEnoughProofContextStateAccounts
Not enough proof context state accounts provided
The name points to a balance check: an account holds less than the instruction needs.
0x3b59MalformedCiphertext
Ciphertext is malformed
0x3c60CiphertextArithmeticFailed
Ciphertext arithmetic failed
0x3d61PedersenCommitmentMismatch
Pedersen commitment mismatch
0x3e62RangeProofLengthMismatch
Range proof length mismatch
0x3f63IllegalBitLength
Illegal transfer amount bit length
0x4064FeeCalculation
Fee calculation failed
0x4165IllegalMintBurnConversion
Withdraw / Deposit not allowed for confidential-mint-burn
0x4266InvalidScale
Invalid scale for scaled ui amount
0x4367MintPaused
Transferring, minting, and burning is paused on this mint
The mint has the Pausable extension and transfers, minting and burning are currently paused.
0x4468PendingBalanceNonZero
Key rotation attempted while pending balance is not zero

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-program/token-2022 interface/src/error.rs. 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.