Solana error codes › Metaplex Candy Machine

Metaplex Candy Machine error codes

52 error codes defined by Metaplex Candy Machine (program ID cndy3Z4yapfJBmL3ShUp5exZKqR3z33thTzeNMm2gRZ). In logs they appear as custom program error: 0x… after Program cndy3Z4yapfJBmL3ShUp5exZKqR3z33thTzeNMm2gRZ failed.

Custom errors start at 6000 (0x1770). If a code is below 6000 and not listed here, see the Anchor framework errors.

HexCodeError
0x17706000IncorrectOwner
Account does not have correct owner!
0x17716001Uninitialized
Account is not initialized!
The name points to account state: an account was expected to exist (or not exist) already.
0x17726002MintMismatch
Mint Mismatch!
0x17736003IndexGreaterThanLength
Index greater than length!
0x17746004NumericalOverflowError
Numerical overflow error!
The name points to a checked arithmetic failure inside the program, often from extreme amounts or an outdated client.
0x17756005TooManyCreators
Can only provide up to 4 creators to candy machine (because candy machine is one)!
0x17766006UuidMustBeExactly6Length
Uuid must be exactly of 6 length
0x17776007NotEnoughTokens
Not enough tokens to pay for this minting
The name points to a balance check: an account holds less than the instruction needs.
0x17786008NotEnoughSOL
Not enough SOL to pay for this minting
The name points to a balance check: an account holds less than the instruction needs.
0x17796009TokenTransferFailed
Token transfer failed
0x177a6010CandyMachineEmpty
Candy machine is empty!
0x177b6011CandyMachineNotLive
Candy machine is not live!
0x177c6012HiddenSettingsConfigsDoNotHaveConfigLines
Configs that are using hidden uris do not have config lines, they have a single hash representing hashed order
0x177d6013CannotChangeNumberOfLines
Cannot change number of lines unless is a hidden config
0x177e6014DerivedKeyInvalid
Derived key invalid
0x177f6015PublicKeyMismatch
Public key mismatch
0x17806016NoWhitelistToken
No whitelist token present
0x17816017TokenBurnFailed
Token burn failed
0x17826018GatewayAppMissing
Missing gateway app when required
0x17836019GatewayTokenMissing
Missing gateway token when required
0x17846020GatewayTokenExpireTimeInvalid
Invalid gateway token expire time
0x17856021NetworkExpireFeatureMissing
Missing gateway network expire feature when required
0x17866022CannotFindUsableConfigLine
Unable to find an unused config line near your random number index
0x17876023InvalidString
Invalid string
0x17886024SuspiciousTransaction
Suspicious transaction detected
0x17896025CannotSwitchToHiddenSettings
Cannot Switch to Hidden Settings after items available is greater than 0
0x178a6026IncorrectSlotHashesPubkey
Incorrect SlotHashes PubKey
0x178b6027IncorrectCollectionAuthority
Incorrect collection NFT authority
0x178c6028MismatchedCollectionPDA
Collection PDA address is invalid
0x178d6029MismatchedCollectionMint
Provided mint account doesn't match collection PDA mint
0x178e6030SlotHashesEmpty
Slot hashes Sysvar is empty
0x178f6031MetadataAccountMustBeEmpty
The metadata account has data in it, and this must be empty to mint a new NFT
0x17906032MissingSetCollectionDuringMint
Missing set collection during mint IX for Candy Machine with collection set
0x17916033NoChangingCollectionDuringMint
Can't change collection settings after items have begun to be minted
0x17926034CandyCollectionRequiresRetainAuthority
Retain authority must be true for Candy Machines with a collection set
0x17936035GatewayProgramError
Error within Gateway program
0x17946036NoChangingFreezeDuringMint
Can't change freeze settings after items have begun to be minted. You can only disable.
0x17956037NoChangingAuthorityWithCollection
Can't change authority while collection is enabled. Disable collection first.
0x17966038NoChangingTokenWithFreeze
Can't change token while freeze is enabled. Disable freeze first.
0x17976039InvalidThawNft
Cannot thaw NFT unless all NFTs are minted or Candy Machine authority enables thawing
0x17986040IncorrectRemainingAccountsLen
The number of remaining accounts passed in doesn't match the Candy Machine settings
0x17996041MissingFreezeAta
FreezePDA ATA needs to be passed in if token mint is enabled.
0x179a6042IncorrectFreezeAta
Incorrect freeze ATA address.
0x179b6043FreezePDAMismatch
FreezePDA doesn't belong to this Candy Machine.
0x179c6044EnteredFreezeIsMoreThanMaxFreeze
Freeze time can't be longer than MAX_FREEZE_TIME.
0x179d6045NoWithdrawWithFreeze
Can't withdraw Candy Machine while freeze is active. Disable freeze first.
0x179e6046NoWithdrawWithFrozenFunds
Can't withdraw Candy Machine while frozen funds need to be redeemed. Unlock funds first.
0x179f6047MissingRemoveFreezeTokenAccounts
Missing required remaining accounts for remove_freeze with token mint.
0x17a06048InvalidFreezeWithdrawTokenAddress
Can't withdraw SPL Token from freeze PDA into itself
0x17a16049NoUnlockWithNFTsStillFrozen
Can't unlock funds while NFTs are still frozen. Run thaw on all NFTs first.
0x17a26050SizedCollectionMetadataMustBeMutable
Setting a sized collection requires the collection metadata to be mutable.
0x17a36051CannotSwitchFromHiddenSettings
Cannot remove Hidden Settings.

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.