Solana error codes › Token-2022
69 error codes defined by Token-2022 (program ID TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb). In logs they appear as custom program error: 0x… after Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb failed.
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.
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.
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.
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.
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.
| 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 uninitialized 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 |
| 0x14 | 20 | ExtensionTypeMismatch Extension type does not match already existing extensions |
| 0x15 | 21 | ExtensionBaseMismatch Extension does not match the base type provided |
| 0x16 | 22 | ExtensionAlreadyInitialized Extension already initialized on this account The name points to account state: an account was expected to exist (or not exist) already. |
| 0x17 | 23 | ConfidentialTransferAccountHasBalance An account can only be closed if its confidential balance is zero |
| 0x18 | 24 | ConfidentialTransferAccountNotApproved Account not approved for confidential transfers |
| 0x19 | 25 | ConfidentialTransferDepositsAndTransfersDisabled Account not accepting deposits or transfers The name points to a feature or pool state that currently blocks this action. |
| 0x1a | 26 | ConfidentialTransferElGamalPubkeyMismatch ElGamal public key mismatch |
| 0x1b | 27 | ConfidentialTransferBalanceMismatch Balance mismatch |
| 0x1c | 28 | MintHasSupply Mint has non-zero supply. Burn all tokens before closing the mint |
| 0x1d | 29 | NoAuthorityExists No authority exists to perform the desired operation |
| 0x1e | 30 | TransferFeeExceedsMaximum Transfer fee exceeds maximum of 10,000 basis points |
| 0x1f | 31 | MintRequiredForTransfer Mint required for this account to transfer tokens, use `transfer_checked` or `transfer_checked_with_fee` |
| 0x20 | 32 | FeeMismatch Calculated fee does not match expected fee |
| 0x21 | 33 | FeeParametersMismatch |
| 0x22 | 34 | ImmutableOwner The owner authority cannot be changed |
| 0x23 | 35 | AccountHasWithheldTransferFees An account can only be closed if its withheld fee balance is zero, harvest fees to the mint and try again |
| 0x24 | 36 | NoMemo No memo in previous instruction; required for recipient to receive a transfer |
| 0x25 | 37 | NonTransferable Transfer is disabled for this mint The mint has the Non-Transferable extension, so its tokens cannot be transferred between owners. |
| 0x26 | 38 | NonTransferableNeedsImmutableOwnership Non-transferable tokens can't be minted to an account without immutable ownership |
| 0x27 | 39 | MaximumPendingBalanceCreditCounterExceeded |
| 0x28 | 40 | MaximumDepositAmountExceeded Deposit amount exceeds maximum limit |
| 0x29 | 41 | CpiGuardSettingsLocked CPI Guard cannot be enabled or disabled in CPI |
| 0x2a | 42 | CpiGuardTransferBlocked CPI Guard is enabled, and a program attempted to transfer user funds via CPI without using a delegate |
| 0x2b | 43 | CpiGuardBurnBlocked |
| 0x2c | 44 | CpiGuardCloseAccountBlocked CPI Guard is enabled, and a program attempted to close an account via CPI without returning lamports to owner |
| 0x2d | 45 | CpiGuardApproveBlocked CPI Guard is enabled, and a program attempted to approve a delegate via CPI |
| 0x2e | 46 | CpiGuardSetAuthorityBlocked |
| 0x2f | 47 | CpiGuardOwnerChangeBlocked Account ownership cannot be changed while CPI Guard is enabled |
| 0x30 | 48 | ExtensionNotFound Extension not found in account data |
| 0x31 | 49 | NonConfidentialTransfersDisabled Non-confidential transfers disabled The name points to a feature or pool state that currently blocks this action. |
| 0x32 | 50 | ConfidentialTransferFeeAccountHasWithheldFee An account can only be closed if the confidential withheld fee is zero |
| 0x33 | 51 | InvalidExtensionCombination A mint or an account is initialized to an invalid combination of extensions |
| 0x34 | 52 | InvalidLengthForAlloc Extension allocation with overwrite must use the same length |
| 0x35 | 53 | AccountDecryption Failed to decrypt a confidential transfer account |
| 0x36 | 54 | ProofGeneration Failed to generate proof |
| 0x37 | 55 | InvalidProofInstructionOffset An invalid proof instruction offset was provided |
| 0x38 | 56 | HarvestToMintDisabled Harvest of withheld tokens to mint is disabled The name points to a feature or pool state that currently blocks this action. |
| 0x39 | 57 | SplitProofContextStateAccountsNotSupported Split proof context state accounts not supported for instruction |
| 0x3a | 58 | NotEnoughProofContextStateAccounts Not enough proof context state accounts provided The name points to a balance check: an account holds less than the instruction needs. |
| 0x3b | 59 | MalformedCiphertext Ciphertext is malformed |
| 0x3c | 60 | CiphertextArithmeticFailed Ciphertext arithmetic failed |
| 0x3d | 61 | PedersenCommitmentMismatch Pedersen commitment mismatch |
| 0x3e | 62 | RangeProofLengthMismatch Range proof length mismatch |
| 0x3f | 63 | IllegalBitLength Illegal transfer amount bit length |
| 0x40 | 64 | FeeCalculation Fee calculation failed |
| 0x41 | 65 | IllegalMintBurnConversion Withdraw / Deposit not allowed for confidential-mint-burn |
| 0x42 | 66 | InvalidScale Invalid scale for scaled ui amount |
| 0x43 | 67 | MintPaused Transferring, minting, and burning is paused on this mint The mint has the Pausable extension and transfers, minting and burning are currently paused. |
| 0x44 | 68 | PendingBalanceNonZero Key rotation attempted while pending balance is not zero |
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.