Solana error codes › Metaplex Candy Machine
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.
| Hex | Code | Error |
|---|---|---|
| 0x1770 | 6000 | IncorrectOwner Account does not have correct owner! |
| 0x1771 | 6001 | Uninitialized Account is not initialized! The name points to account state: an account was expected to exist (or not exist) already. |
| 0x1772 | 6002 | MintMismatch Mint Mismatch! |
| 0x1773 | 6003 | IndexGreaterThanLength Index greater than length! |
| 0x1774 | 6004 | NumericalOverflowError Numerical overflow error! The name points to a checked arithmetic failure inside the program, often from extreme amounts or an outdated client. |
| 0x1775 | 6005 | TooManyCreators Can only provide up to 4 creators to candy machine (because candy machine is one)! |
| 0x1776 | 6006 | UuidMustBeExactly6Length Uuid must be exactly of 6 length |
| 0x1777 | 6007 | NotEnoughTokens Not enough tokens to pay for this minting The name points to a balance check: an account holds less than the instruction needs. |
| 0x1778 | 6008 | NotEnoughSOL Not enough SOL to pay for this minting The name points to a balance check: an account holds less than the instruction needs. |
| 0x1779 | 6009 | TokenTransferFailed Token transfer failed |
| 0x177a | 6010 | CandyMachineEmpty Candy machine is empty! |
| 0x177b | 6011 | CandyMachineNotLive Candy machine is not live! |
| 0x177c | 6012 | HiddenSettingsConfigsDoNotHaveConfigLines Configs that are using hidden uris do not have config lines, they have a single hash representing hashed order |
| 0x177d | 6013 | CannotChangeNumberOfLines Cannot change number of lines unless is a hidden config |
| 0x177e | 6014 | DerivedKeyInvalid Derived key invalid |
| 0x177f | 6015 | PublicKeyMismatch Public key mismatch |
| 0x1780 | 6016 | NoWhitelistToken No whitelist token present |
| 0x1781 | 6017 | TokenBurnFailed Token burn failed |
| 0x1782 | 6018 | GatewayAppMissing Missing gateway app when required |
| 0x1783 | 6019 | GatewayTokenMissing Missing gateway token when required |
| 0x1784 | 6020 | GatewayTokenExpireTimeInvalid Invalid gateway token expire time |
| 0x1785 | 6021 | NetworkExpireFeatureMissing Missing gateway network expire feature when required |
| 0x1786 | 6022 | CannotFindUsableConfigLine Unable to find an unused config line near your random number index |
| 0x1787 | 6023 | InvalidString Invalid string |
| 0x1788 | 6024 | SuspiciousTransaction Suspicious transaction detected |
| 0x1789 | 6025 | CannotSwitchToHiddenSettings Cannot Switch to Hidden Settings after items available is greater than 0 |
| 0x178a | 6026 | IncorrectSlotHashesPubkey Incorrect SlotHashes PubKey |
| 0x178b | 6027 | IncorrectCollectionAuthority Incorrect collection NFT authority |
| 0x178c | 6028 | MismatchedCollectionPDA Collection PDA address is invalid |
| 0x178d | 6029 | MismatchedCollectionMint Provided mint account doesn't match collection PDA mint |
| 0x178e | 6030 | SlotHashesEmpty Slot hashes Sysvar is empty |
| 0x178f | 6031 | MetadataAccountMustBeEmpty The metadata account has data in it, and this must be empty to mint a new NFT |
| 0x1790 | 6032 | MissingSetCollectionDuringMint Missing set collection during mint IX for Candy Machine with collection set |
| 0x1791 | 6033 | NoChangingCollectionDuringMint Can't change collection settings after items have begun to be minted |
| 0x1792 | 6034 | CandyCollectionRequiresRetainAuthority Retain authority must be true for Candy Machines with a collection set |
| 0x1793 | 6035 | GatewayProgramError Error within Gateway program |
| 0x1794 | 6036 | NoChangingFreezeDuringMint Can't change freeze settings after items have begun to be minted. You can only disable. |
| 0x1795 | 6037 | NoChangingAuthorityWithCollection Can't change authority while collection is enabled. Disable collection first. |
| 0x1796 | 6038 | NoChangingTokenWithFreeze Can't change token while freeze is enabled. Disable freeze first. |
| 0x1797 | 6039 | InvalidThawNft Cannot thaw NFT unless all NFTs are minted or Candy Machine authority enables thawing |
| 0x1798 | 6040 | IncorrectRemainingAccountsLen The number of remaining accounts passed in doesn't match the Candy Machine settings |
| 0x1799 | 6041 | MissingFreezeAta FreezePDA ATA needs to be passed in if token mint is enabled. |
| 0x179a | 6042 | IncorrectFreezeAta Incorrect freeze ATA address. |
| 0x179b | 6043 | FreezePDAMismatch FreezePDA doesn't belong to this Candy Machine. |
| 0x179c | 6044 | EnteredFreezeIsMoreThanMaxFreeze Freeze time can't be longer than MAX_FREEZE_TIME. |
| 0x179d | 6045 | NoWithdrawWithFreeze Can't withdraw Candy Machine while freeze is active. Disable freeze first. |
| 0x179e | 6046 | NoWithdrawWithFrozenFunds Can't withdraw Candy Machine while frozen funds need to be redeemed. Unlock funds first. |
| 0x179f | 6047 | MissingRemoveFreezeTokenAccounts Missing required remaining accounts for remove_freeze with token mint. |
| 0x17a0 | 6048 | InvalidFreezeWithdrawTokenAddress Can't withdraw SPL Token from freeze PDA into itself |
| 0x17a1 | 6049 | NoUnlockWithNFTsStillFrozen Can't unlock funds while NFTs are still frozen. Run thaw on all NFTs first. |
| 0x17a2 | 6050 | SizedCollectionMetadataMustBeMutable Setting a sized collection requires the collection metadata to be mutable. |
| 0x17a3 | 6051 | CannotSwitchFromHiddenSettings Cannot remove Hidden Settings. |
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.