Solana error codes › Metaplex Token Metadata
201 error codes defined by Metaplex Token Metadata (program ID metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s). In logs they appear as custom program error: 0x… after Program metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s failed.
| Hex | Code | Error |
|---|---|---|
| 0x0 | 0 | InstructionUnpackError |
| 0x1 | 1 | InstructionPackError |
| 0x2 | 2 | NotRentExempt Lamport balance below rent-exempt threshold |
| 0x3 | 3 | AlreadyInitialized Already initialized The name points to account state: an account was expected to exist (or not exist) already. |
| 0x4 | 4 | Uninitialized The name points to account state: an account was expected to exist (or not exist) already. |
| 0x5 | 5 | InvalidMetadataKey Metadata's key must match seed of ['metadata', program id, mint] provided |
| 0x6 | 6 | InvalidEditionKey Edition's key must match seed of ['metadata', program id, name, 'edition'] provided |
| 0x7 | 7 | UpdateAuthorityIncorrect Update Authority given does not match |
| 0x8 | 8 | UpdateAuthorityIsNotSigner Update Authority needs to be signer to update metadata The name points to a permission check: the wrong signer or owner account was passed. |
| 0x9 | 9 | NotMintAuthority You must be the mint authority and signer on this transaction |
| 0xa | 10 | InvalidMintAuthority Mint authority provided does not match the authority on the mint |
| 0xb | 11 | NameTooLong Name too long |
| 0xc | 12 | SymbolTooLong Symbol too long |
| 0xd | 13 | UriTooLong URI too long |
| 0xe | 14 | UpdateAuthorityMustBeEqualToMetadataAuthorityAndSigner The name points to a permission check: the wrong signer or owner account was passed. |
| 0xf | 15 | MintMismatch Mint given does not match mint on Metadata |
| 0x10 | 16 | EditionsMustHaveExactlyOneToken Editions must have exactly one token |
| 0x11 | 17 | MaxEditionsMintedAlready |
| 0x12 | 18 | TokenMintToFailed |
| 0x13 | 19 | MasterRecordMismatch |
| 0x14 | 20 | DestinationMintMismatch |
| 0x15 | 21 | EditionAlreadyMinted |
| 0x16 | 22 | PrintingMintDecimalsShouldBeZero |
| 0x17 | 23 | OneTimePrintingAuthorizationMintDecimalsShouldBeZero |
| 0x18 | 24 | EditionMintDecimalsShouldBeZero |
| 0x19 | 25 | TokenBurnFailed |
| 0x1a | 26 | TokenAccountOneTimeAuthMintMismatch |
| 0x1b | 27 | DerivedKeyInvalid Derived key invalid |
| 0x1c | 28 | PrintingMintMismatch The Printing mint does not match that on the master edition! |
| 0x1d | 29 | OneTimePrintingAuthMintMismatch The One Time Printing Auth mint does not match that on the master edition! |
| 0x1e | 30 | TokenAccountMintMismatch The mint of the token account does not match the Printing mint! |
| 0x1f | 31 | TokenAccountMintMismatchV2 The mint of the token account does not match the master metadata mint! |
| 0x20 | 32 | NotEnoughTokens Not enough tokens to mint a limited edition The name points to a balance check: an account holds less than the instruction needs. |
| 0x21 | 33 | PrintingMintAuthorizationAccountMismatch |
| 0x22 | 34 | AuthorizationTokenAccountOwnerMismatch |
| 0x23 | 35 | Disabled The name points to a feature or pool state that currently blocks this action. |
| 0x24 | 36 | CreatorsTooLong Creators list too long |
| 0x25 | 37 | CreatorsMustBeAtleastOne Creators must be at least one if set |
| 0x26 | 38 | MustBeOneOfCreators |
| 0x27 | 39 | NoCreatorsPresentOnMetadata This metadata does not have creators |
| 0x28 | 40 | CreatorNotFound This creator address was not found |
| 0x29 | 41 | InvalidBasisPoints Basis points cannot be more than 10000 |
| 0x2a | 42 | PrimarySaleCanOnlyBeFlippedToTrue Primary sale can only be flipped to true and is immutable |
| 0x2b | 43 | OwnerMismatch Owner does not match that on the account given |
| 0x2c | 44 | NoBalanceInAccountForAuthorization This account has no tokens to be used for authorization |
| 0x2d | 45 | ShareTotalMustBe100 Share total must equal 100 for creator array |
| 0x2e | 46 | ReservationExists |
| 0x2f | 47 | ReservationDoesNotExist |
| 0x30 | 48 | ReservationNotSet |
| 0x31 | 49 | ReservationAlreadyMade |
| 0x32 | 50 | BeyondMaxAddressSize |
| 0x33 | 51 | NumericalOverflowError The name points to a checked arithmetic failure inside the program, often from extreme amounts or an outdated client. |
| 0x34 | 52 | ReservationBreachesMaximumSupply |
| 0x35 | 53 | AddressNotInReservation |
| 0x36 | 54 | CannotVerifyAnotherCreator You cannot unilaterally verify another creator, they must sign |
| 0x37 | 55 | CannotUnverifyAnotherCreator You cannot unilaterally unverify another creator |
| 0x38 | 56 | SpotMismatch |
| 0x39 | 57 | IncorrectOwner Incorrect account owner |
| 0x3a | 58 | PrintingWouldBreachMaximumSupply |
| 0x3b | 59 | DataIsImmutable Data is immutable |
| 0x3c | 60 | DuplicateCreatorAddress No duplicate creator addresses |
| 0x3d | 61 | ReservationSpotsRemainingShouldMatchTotalSpotsAtStart |
| 0x3e | 62 | InvalidTokenProgram Invalid token program |
| 0x3f | 63 | DataTypeMismatch Data type mismatch |
| 0x40 | 64 | BeyondAlottedAddressSize |
| 0x41 | 65 | ReservationNotComplete The name points to a feature or pool state that currently blocks this action. |
| 0x42 | 66 | TriedToReplaceAnExistingReservation |
| 0x43 | 67 | InvalidOperation Invalid operation |
| 0x44 | 68 | InvalidOwner Invalid Owner The name points to a permission check: the wrong signer or owner account was passed. |
| 0x45 | 69 | PrintingMintSupplyMustBeZeroForConversion Printing mint supply must be zero for conversion |
| 0x46 | 70 | OneTimeAuthMintSupplyMustBeZeroForConversion One Time Auth mint supply must be zero for conversion |
| 0x47 | 71 | InvalidEditionIndex You tried to insert one edition too many into an edition mark pda |
| 0x48 | 72 | ReservationArrayShouldBeSizeOne |
| 0x49 | 73 | IsMutableCanOnlyBeFlippedToFalse Is Mutable can only be flipped to false |
| 0x4a | 74 | CollectionCannotBeVerifiedInThisInstruction Collection cannot be verified in this instruction |
| 0x4b | 75 | Removed This instruction was deprecated in a previous release and is now removed |
| 0x4c | 76 | MustBeBurned |
| 0x4d | 77 | InvalidUseMethod This use method is invalid |
| 0x4e | 78 | CannotChangeUseMethodAfterFirstUse Cannot Change Use Method after the first use |
| 0x4f | 79 | CannotChangeUsesAfterFirstUse Cannot Change Remaining or Available uses after the first use |
| 0x50 | 80 | CollectionNotFound Collection Not Found on Metadata |
| 0x51 | 81 | InvalidCollectionUpdateAuthority Collection Update Authority is invalid |
| 0x52 | 82 | CollectionMustBeAUniqueMasterEdition Collection Must Be a Unique Master Edition v2 |
| 0x53 | 83 | UseAuthorityRecordAlreadyExists The Use Authority Record Already Exists, to modify it Revoke, then Approve |
| 0x54 | 84 | UseAuthorityRecordAlreadyRevoked The Use Authority Record is empty or already revoked |
| 0x55 | 85 | Unusable This token has no uses |
| 0x56 | 86 | NotEnoughUses There are not enough Uses left on this token. The name points to a balance check: an account holds less than the instruction needs. |
| 0x57 | 87 | CollectionAuthorityRecordAlreadyExists This Collection Authority Record Already Exists. |
| 0x58 | 88 | CollectionAuthorityDoesNotExist This Collection Authority Record Does Not Exist. |
| 0x59 | 89 | InvalidUseAuthorityRecord This Use Authority Record is invalid. |
| 0x5a | 90 | InvalidCollectionAuthorityRecord |
| 0x5b | 91 | InvalidFreezeAuthority Metadata does not match the freeze authority on the mint |
| 0x5c | 92 | InvalidDelegate All tokens in this account have not been delegated to this user. |
| 0x5d | 93 | CannotAdjustVerifiedCreator |
| 0x5e | 94 | CannotRemoveVerifiedCreator Verified creators cannot be removed. |
| 0x5f | 95 | CannotWipeVerifiedCreators |
| 0x60 | 96 | NotAllowedToChangeSellerFeeBasisPoints |
| 0x61 | 97 | EditionOverrideCannotBeZero Edition override cannot be zero |
| 0x62 | 98 | InvalidUser Invalid User |
| 0x63 | 99 | RevokeCollectionAuthoritySignerIncorrect Revoke Collection Authority signer is incorrect The name points to a permission check: the wrong signer or owner account was passed. |
| 0x64 | 100 | TokenCloseFailed |
| 0x65 | 101 | UnsizedCollection Can't use this function on unsized collection |
| 0x66 | 102 | SizedCollection Can't use this function on a sized collection |
| 0x67 | 103 | MissingCollectionMetadata Missing collection metadata account |
| 0x68 | 104 | NotAMemberOfCollection This NFT is not a member of the specified collection. |
| 0x69 | 105 | NotVerifiedMemberOfCollection This NFT is not a verified member of the specified collection. |
| 0x6a | 106 | NotACollectionParent This NFT is not a collection parent NFT. |
| 0x6b | 107 | CouldNotDetermineTokenStandard Could not determine a TokenStandard type. |
| 0x6c | 108 | MissingEditionAccount This mint account has an edition but none was provided. |
| 0x6d | 109 | NotAMasterEdition This edition is not a Master Edition |
| 0x6e | 110 | MasterEditionHasPrints This Master Edition has existing prints |
| 0x6f | 111 | BorshDeserializationError |
| 0x70 | 112 | CannotUpdateVerifiedCollection Cannot update a verified collection in this command |
| 0x71 | 113 | CollectionMasterEditionAccountInvalid Edition account doesnt match collection |
| 0x72 | 114 | AlreadyVerified Item is already verified. |
| 0x73 | 115 | AlreadyUnverified |
| 0x74 | 116 | NotAPrintEdition This edition is not a Print Edition |
| 0x75 | 117 | InvalidMasterEdition Invalid Master Edition |
| 0x76 | 118 | InvalidPrintEdition Invalid Print Edition |
| 0x77 | 119 | InvalidEditionMarker Invalid Edition Marker |
| 0x78 | 120 | ReservationListDeprecated Reservation List is Deprecated |
| 0x79 | 121 | PrintEditionDoesNotMatchMasterEdition Print Edition does not match Master Edition |
| 0x7a | 122 | EditionNumberGreaterThanMaxSupply Edition Number greater than max supply |
| 0x7b | 123 | MustUnverify Must unverify before migrating collections. |
| 0x7c | 124 | InvalidEscrowBumpSeed Invalid Escrow Account Bump Seed |
| 0x7d | 125 | MustBeEscrowAuthority Must Escrow Authority |
| 0x7e | 126 | InvalidSystemProgram Invalid System Program |
| 0x7f | 127 | MustBeNonFungible Must be a Non Fungible Token |
| 0x80 | 128 | InsufficientTokens Insufficient tokens for transfer |
| 0x81 | 129 | BorshSerializationError Borsh Serialization Error |
| 0x82 | 130 | NoFreezeAuthoritySet Cannot create NFT with no Freeze Authority. |
| 0x83 | 131 | InvalidCollectionSizeChange Invalid collection size change |
| 0x84 | 132 | InvalidBubblegumSigner Invalid bubblegum signer The name points to a permission check: the wrong signer or owner account was passed. |
| 0x85 | 133 | EscrowParentHasDelegate Escrow parent cannot have a delegate |
| 0x86 | 134 | MintIsNotSigner Mint needs to be signer to initialize the account The name points to a permission check: the wrong signer or owner account was passed. |
| 0x87 | 135 | InvalidTokenStandard Invalid token standard |
| 0x88 | 136 | InvalidMintForTokenStandard Invalid mint account for specified token standard |
| 0x89 | 137 | InvalidAuthorizationRules Invalid authorization rules account |
| 0x8a | 138 | MissingAuthorizationRules Missing authorization rules account |
| 0x8b | 139 | MissingProgrammableConfig Missing programmable configuration |
| 0x8c | 140 | InvalidProgrammableConfig Invalid programmable configuration |
| 0x8d | 141 | DelegateAlreadyExists Delegate already exists |
| 0x8e | 142 | DelegateNotFound Delegate not found |
| 0x8f | 143 | MissingAccountInBuilder Required account not set in instruction builder |
| 0x90 | 144 | MissingArgumentInBuilder Required argument not set in instruction builder |
| 0x91 | 145 | FeatureNotSupported Feature not supported currently |
| 0x92 | 146 | InvalidSystemWallet Invalid system wallet |
| 0x93 | 147 | OnlySaleDelegateCanTransfer Only the sale delegate can transfer while its set |
| 0x94 | 148 | MissingTokenAccount Missing token account |
| 0x95 | 149 | MissingSplTokenProgram Missing SPL token program |
| 0x96 | 150 | MissingAuthorizationRulesProgram Missing authorization rules program |
| 0x97 | 151 | InvalidDelegateRoleForTransfer Invalid delegate role for transfer |
| 0x98 | 152 | InvalidTransferAuthority Invalid transfer authority |
| 0x99 | 153 | InstructionNotSupported Instruction not supported for ProgrammableNonFungible assets |
| 0x9a | 154 | KeyMismatch Public key does not match expected value |
| 0x9b | 155 | LockedToken Token is locked |
| 0x9c | 156 | UnlockedToken Token is unlocked |
| 0x9d | 157 | MissingDelegateRole Missing delegate role |
| 0x9e | 158 | InvalidAuthorityType Invalid authority type The name points to a permission check: the wrong signer or owner account was passed. |
| 0x9f | 159 | MissingTokenRecord Missing token record account |
| 0xa0 | 160 | MintSupplyMustBeZero Mint supply must be zero for programmable assets |
| 0xa1 | 161 | DataIsEmptyOrZeroed Data is empty or zeroed |
| 0xa2 | 162 | MissingTokenOwnerAccount Missing token owner |
| 0xa3 | 163 | InvalidMasterEditionAccountLength Master edition account has an invalid length |
| 0xa4 | 164 | IncorrectTokenState Incorrect token state |
| 0xa5 | 165 | InvalidDelegateRole Invalid delegate role |
| 0xa6 | 166 | MissingPrintSupply Print supply is required for non-fungibles |
| 0xa7 | 167 | MissingMasterEditionAccount Missing master edition account |
| 0xa8 | 168 | AmountMustBeGreaterThanZero Amount must be greater than zero |
| 0xa9 | 169 | InvalidDelegateArgs Invalid delegate args |
| 0xaa | 170 | MissingLockedTransferAddress Missing address for locked transfer |
| 0xab | 171 | InvalidLockedTransferAddress Invalid destination address for locked transfer |
| 0xac | 172 | DataIncrementLimitExceeded Exceeded account realloc increase limit |
| 0xad | 173 | CannotUpdateAssetWithDelegate Cannot update the rule set of a programmable asset that has a delegate |
| 0xae | 174 | InvalidAmount Invalid token amount for this operation or token standard |
| 0xaf | 175 | MissingMasterEditionMintAccount Missing master edition mint account |
| 0xb0 | 176 | MissingMasterEditionTokenAccount Missing master edition token account |
| 0xb1 | 177 | MissingEditionMarkerAccount Missing edition marker account |
| 0xb2 | 178 | CannotBurnWithDelegate Cannot burn while persistent delegate is set |
| 0xb3 | 179 | MissingEdition Missing edition account |
| 0xb4 | 180 | InvalidAssociatedTokenAccountProgram Invalid Associated Token Account Program |
| 0xb5 | 181 | InvalidInstructionsSysvar Invalid InstructionsSysvar |
| 0xb6 | 182 | InvalidParentAccounts Invalid or Unneeded parent accounts |
| 0xb7 | 183 | InvalidUpdateArgs Authority cannot apply all update args |
| 0xb8 | 184 | InsufficientTokenBalance Token account does not have enough tokens |
| 0xb9 | 185 | MissingCollectionMint Missing collection account |
| 0xba | 186 | MissingCollectionMasterEdition Missing collection master edition account |
| 0xbb | 187 | InvalidTokenRecord Invalid token record account |
| 0xbc | 188 | InvalidCloseAuthority The close authority needs to be revoked by the Utility Delegate |
| 0xbd | 189 | InvalidInstruction Invalid or removed instruction |
| 0xbe | 190 | MissingDelegateRecord Missing delegate record |
| 0xbf | 191 | InvalidFeeAccount |
| 0xc0 | 192 | InvalidMetadataFlags |
| 0xc1 | 193 | CannotChangeUpdateAuthorityWithDelegate Cannot change the update authority with a delegate |
| 0xc2 | 194 | InvalidMintExtensionType Invalid mint extension type |
| 0xc3 | 195 | InvalidMintCloseAuthority Invalid mint close authority |
| 0xc4 | 196 | InvalidMetadataPointer Invalid metadata pointer |
| 0xc5 | 197 | InvalidTokenExtensionType Invalid token extension type |
| 0xc6 | 198 | MissingImmutableOwnerExtension Missing immutable owner extension |
| 0xc7 | 199 | ExpectedUninitializedAccount Expected account to be uninitialized The name points to account state: an account was expected to exist (or not exist) already. |
| 0xc8 | 200 | InvalidEditionAccountLength Edition account has an invalid length |
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.