Solana error codes › Metaplex Token Metadata

Metaplex Token Metadata error codes

201 error codes defined by Metaplex Token Metadata (program ID metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s). In logs they appear as custom program error: 0x… after Program metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s failed.

HexCodeError
0x00InstructionUnpackError
0x11InstructionPackError
0x22NotRentExempt
Lamport balance below rent-exempt threshold
0x33AlreadyInitialized
Already initialized
The name points to account state: an account was expected to exist (or not exist) already.
0x44Uninitialized
The name points to account state: an account was expected to exist (or not exist) already.
0x55InvalidMetadataKey
Metadata's key must match seed of ['metadata', program id, mint] provided
0x66InvalidEditionKey
Edition's key must match seed of ['metadata', program id, name, 'edition'] provided
0x77UpdateAuthorityIncorrect
Update Authority given does not match
0x88UpdateAuthorityIsNotSigner
Update Authority needs to be signer to update metadata
The name points to a permission check: the wrong signer or owner account was passed.
0x99NotMintAuthority
You must be the mint authority and signer on this transaction
0xa10InvalidMintAuthority
Mint authority provided does not match the authority on the mint
0xb11NameTooLong
Name too long
0xc12SymbolTooLong
Symbol too long
0xd13UriTooLong
URI too long
0xe14UpdateAuthorityMustBeEqualToMetadataAuthorityAndSigner
The name points to a permission check: the wrong signer or owner account was passed.
0xf15MintMismatch
Mint given does not match mint on Metadata
0x1016EditionsMustHaveExactlyOneToken
Editions must have exactly one token
0x1117MaxEditionsMintedAlready
0x1218TokenMintToFailed
0x1319MasterRecordMismatch
0x1420DestinationMintMismatch
0x1521EditionAlreadyMinted
0x1622PrintingMintDecimalsShouldBeZero
0x1723OneTimePrintingAuthorizationMintDecimalsShouldBeZero
0x1824EditionMintDecimalsShouldBeZero
0x1925TokenBurnFailed
0x1a26TokenAccountOneTimeAuthMintMismatch
0x1b27DerivedKeyInvalid
Derived key invalid
0x1c28PrintingMintMismatch
The Printing mint does not match that on the master edition!
0x1d29OneTimePrintingAuthMintMismatch
The One Time Printing Auth mint does not match that on the master edition!
0x1e30TokenAccountMintMismatch
The mint of the token account does not match the Printing mint!
0x1f31TokenAccountMintMismatchV2
The mint of the token account does not match the master metadata mint!
0x2032NotEnoughTokens
Not enough tokens to mint a limited edition
The name points to a balance check: an account holds less than the instruction needs.
0x2133PrintingMintAuthorizationAccountMismatch
0x2234AuthorizationTokenAccountOwnerMismatch
0x2335Disabled
The name points to a feature or pool state that currently blocks this action.
0x2436CreatorsTooLong
Creators list too long
0x2537CreatorsMustBeAtleastOne
Creators must be at least one if set
0x2638MustBeOneOfCreators
0x2739NoCreatorsPresentOnMetadata
This metadata does not have creators
0x2840CreatorNotFound
This creator address was not found
0x2941InvalidBasisPoints
Basis points cannot be more than 10000
0x2a42PrimarySaleCanOnlyBeFlippedToTrue
Primary sale can only be flipped to true and is immutable
0x2b43OwnerMismatch
Owner does not match that on the account given
0x2c44NoBalanceInAccountForAuthorization
This account has no tokens to be used for authorization
0x2d45ShareTotalMustBe100
Share total must equal 100 for creator array
0x2e46ReservationExists
0x2f47ReservationDoesNotExist
0x3048ReservationNotSet
0x3149ReservationAlreadyMade
0x3250BeyondMaxAddressSize
0x3351NumericalOverflowError
The name points to a checked arithmetic failure inside the program, often from extreme amounts or an outdated client.
0x3452ReservationBreachesMaximumSupply
0x3553AddressNotInReservation
0x3654CannotVerifyAnotherCreator
You cannot unilaterally verify another creator, they must sign
0x3755CannotUnverifyAnotherCreator
You cannot unilaterally unverify another creator
0x3856SpotMismatch
0x3957IncorrectOwner
Incorrect account owner
0x3a58PrintingWouldBreachMaximumSupply
0x3b59DataIsImmutable
Data is immutable
0x3c60DuplicateCreatorAddress
No duplicate creator addresses
0x3d61ReservationSpotsRemainingShouldMatchTotalSpotsAtStart
0x3e62InvalidTokenProgram
Invalid token program
0x3f63DataTypeMismatch
Data type mismatch
0x4064BeyondAlottedAddressSize
0x4165ReservationNotComplete
The name points to a feature or pool state that currently blocks this action.
0x4266TriedToReplaceAnExistingReservation
0x4367InvalidOperation
Invalid operation
0x4468InvalidOwner
Invalid Owner
The name points to a permission check: the wrong signer or owner account was passed.
0x4569PrintingMintSupplyMustBeZeroForConversion
Printing mint supply must be zero for conversion
0x4670OneTimeAuthMintSupplyMustBeZeroForConversion
One Time Auth mint supply must be zero for conversion
0x4771InvalidEditionIndex
You tried to insert one edition too many into an edition mark pda
0x4872ReservationArrayShouldBeSizeOne
0x4973IsMutableCanOnlyBeFlippedToFalse
Is Mutable can only be flipped to false
0x4a74CollectionCannotBeVerifiedInThisInstruction
Collection cannot be verified in this instruction
0x4b75Removed
This instruction was deprecated in a previous release and is now removed
0x4c76MustBeBurned
0x4d77InvalidUseMethod
This use method is invalid
0x4e78CannotChangeUseMethodAfterFirstUse
Cannot Change Use Method after the first use
0x4f79CannotChangeUsesAfterFirstUse
Cannot Change Remaining or Available uses after the first use
0x5080CollectionNotFound
Collection Not Found on Metadata
0x5181InvalidCollectionUpdateAuthority
Collection Update Authority is invalid
0x5282CollectionMustBeAUniqueMasterEdition
Collection Must Be a Unique Master Edition v2
0x5383UseAuthorityRecordAlreadyExists
The Use Authority Record Already Exists, to modify it Revoke, then Approve
0x5484UseAuthorityRecordAlreadyRevoked
The Use Authority Record is empty or already revoked
0x5585Unusable
This token has no uses
0x5686NotEnoughUses
There are not enough Uses left on this token.
The name points to a balance check: an account holds less than the instruction needs.
0x5787CollectionAuthorityRecordAlreadyExists
This Collection Authority Record Already Exists.
0x5888CollectionAuthorityDoesNotExist
This Collection Authority Record Does Not Exist.
0x5989InvalidUseAuthorityRecord
This Use Authority Record is invalid.
0x5a90InvalidCollectionAuthorityRecord
0x5b91InvalidFreezeAuthority
Metadata does not match the freeze authority on the mint
0x5c92InvalidDelegate
All tokens in this account have not been delegated to this user.
0x5d93CannotAdjustVerifiedCreator
0x5e94CannotRemoveVerifiedCreator
Verified creators cannot be removed.
0x5f95CannotWipeVerifiedCreators
0x6096NotAllowedToChangeSellerFeeBasisPoints
0x6197EditionOverrideCannotBeZero
Edition override cannot be zero
0x6298InvalidUser
Invalid User
0x6399RevokeCollectionAuthoritySignerIncorrect
Revoke Collection Authority signer is incorrect
The name points to a permission check: the wrong signer or owner account was passed.
0x64100TokenCloseFailed
0x65101UnsizedCollection
Can't use this function on unsized collection
0x66102SizedCollection
Can't use this function on a sized collection
0x67103MissingCollectionMetadata
Missing collection metadata account
0x68104NotAMemberOfCollection
This NFT is not a member of the specified collection.
0x69105NotVerifiedMemberOfCollection
This NFT is not a verified member of the specified collection.
0x6a106NotACollectionParent
This NFT is not a collection parent NFT.
0x6b107CouldNotDetermineTokenStandard
Could not determine a TokenStandard type.
0x6c108MissingEditionAccount
This mint account has an edition but none was provided.
0x6d109NotAMasterEdition
This edition is not a Master Edition
0x6e110MasterEditionHasPrints
This Master Edition has existing prints
0x6f111BorshDeserializationError
0x70112CannotUpdateVerifiedCollection
Cannot update a verified collection in this command
0x71113CollectionMasterEditionAccountInvalid
Edition account doesnt match collection
0x72114AlreadyVerified
Item is already verified.
0x73115AlreadyUnverified
0x74116NotAPrintEdition
This edition is not a Print Edition
0x75117InvalidMasterEdition
Invalid Master Edition
0x76118InvalidPrintEdition
Invalid Print Edition
0x77119InvalidEditionMarker
Invalid Edition Marker
0x78120ReservationListDeprecated
Reservation List is Deprecated
0x79121PrintEditionDoesNotMatchMasterEdition
Print Edition does not match Master Edition
0x7a122EditionNumberGreaterThanMaxSupply
Edition Number greater than max supply
0x7b123MustUnverify
Must unverify before migrating collections.
0x7c124InvalidEscrowBumpSeed
Invalid Escrow Account Bump Seed
0x7d125MustBeEscrowAuthority
Must Escrow Authority
0x7e126InvalidSystemProgram
Invalid System Program
0x7f127MustBeNonFungible
Must be a Non Fungible Token
0x80128InsufficientTokens
Insufficient tokens for transfer
0x81129BorshSerializationError
Borsh Serialization Error
0x82130NoFreezeAuthoritySet
Cannot create NFT with no Freeze Authority.
0x83131InvalidCollectionSizeChange
Invalid collection size change
0x84132InvalidBubblegumSigner
Invalid bubblegum signer
The name points to a permission check: the wrong signer or owner account was passed.
0x85133EscrowParentHasDelegate
Escrow parent cannot have a delegate
0x86134MintIsNotSigner
Mint needs to be signer to initialize the account
The name points to a permission check: the wrong signer or owner account was passed.
0x87135InvalidTokenStandard
Invalid token standard
0x88136InvalidMintForTokenStandard
Invalid mint account for specified token standard
0x89137InvalidAuthorizationRules
Invalid authorization rules account
0x8a138MissingAuthorizationRules
Missing authorization rules account
0x8b139MissingProgrammableConfig
Missing programmable configuration
0x8c140InvalidProgrammableConfig
Invalid programmable configuration
0x8d141DelegateAlreadyExists
Delegate already exists
0x8e142DelegateNotFound
Delegate not found
0x8f143MissingAccountInBuilder
Required account not set in instruction builder
0x90144MissingArgumentInBuilder
Required argument not set in instruction builder
0x91145FeatureNotSupported
Feature not supported currently
0x92146InvalidSystemWallet
Invalid system wallet
0x93147OnlySaleDelegateCanTransfer
Only the sale delegate can transfer while its set
0x94148MissingTokenAccount
Missing token account
0x95149MissingSplTokenProgram
Missing SPL token program
0x96150MissingAuthorizationRulesProgram
Missing authorization rules program
0x97151InvalidDelegateRoleForTransfer
Invalid delegate role for transfer
0x98152InvalidTransferAuthority
Invalid transfer authority
0x99153InstructionNotSupported
Instruction not supported for ProgrammableNonFungible assets
0x9a154KeyMismatch
Public key does not match expected value
0x9b155LockedToken
Token is locked
0x9c156UnlockedToken
Token is unlocked
0x9d157MissingDelegateRole
Missing delegate role
0x9e158InvalidAuthorityType
Invalid authority type
The name points to a permission check: the wrong signer or owner account was passed.
0x9f159MissingTokenRecord
Missing token record account
0xa0160MintSupplyMustBeZero
Mint supply must be zero for programmable assets
0xa1161DataIsEmptyOrZeroed
Data is empty or zeroed
0xa2162MissingTokenOwnerAccount
Missing token owner
0xa3163InvalidMasterEditionAccountLength
Master edition account has an invalid length
0xa4164IncorrectTokenState
Incorrect token state
0xa5165InvalidDelegateRole
Invalid delegate role
0xa6166MissingPrintSupply
Print supply is required for non-fungibles
0xa7167MissingMasterEditionAccount
Missing master edition account
0xa8168AmountMustBeGreaterThanZero
Amount must be greater than zero
0xa9169InvalidDelegateArgs
Invalid delegate args
0xaa170MissingLockedTransferAddress
Missing address for locked transfer
0xab171InvalidLockedTransferAddress
Invalid destination address for locked transfer
0xac172DataIncrementLimitExceeded
Exceeded account realloc increase limit
0xad173CannotUpdateAssetWithDelegate
Cannot update the rule set of a programmable asset that has a delegate
0xae174InvalidAmount
Invalid token amount for this operation or token standard
0xaf175MissingMasterEditionMintAccount
Missing master edition mint account
0xb0176MissingMasterEditionTokenAccount
Missing master edition token account
0xb1177MissingEditionMarkerAccount
Missing edition marker account
0xb2178CannotBurnWithDelegate
Cannot burn while persistent delegate is set
0xb3179MissingEdition
Missing edition account
0xb4180InvalidAssociatedTokenAccountProgram
Invalid Associated Token Account Program
0xb5181InvalidInstructionsSysvar
Invalid InstructionsSysvar
0xb6182InvalidParentAccounts
Invalid or Unneeded parent accounts
0xb7183InvalidUpdateArgs
Authority cannot apply all update args
0xb8184InsufficientTokenBalance
Token account does not have enough tokens
0xb9185MissingCollectionMint
Missing collection account
0xba186MissingCollectionMasterEdition
Missing collection master edition account
0xbb187InvalidTokenRecord
Invalid token record account
0xbc188InvalidCloseAuthority
The close authority needs to be revoked by the Utility Delegate
0xbd189InvalidInstruction
Invalid or removed instruction
0xbe190MissingDelegateRecord
Missing delegate record
0xbf191InvalidFeeAccount
0xc0192InvalidMetadataFlags
0xc1193CannotChangeUpdateAuthorityWithDelegate
Cannot change the update authority with a delegate
0xc2194InvalidMintExtensionType
Invalid mint extension type
0xc3195InvalidMintCloseAuthority
Invalid mint close authority
0xc4196InvalidMetadataPointer
Invalid metadata pointer
0xc5197InvalidTokenExtensionType
Invalid token extension type
0xc6198MissingImmutableOwnerExtension
Missing immutable owner extension
0xc7199ExpectedUninitializedAccount
Expected account to be uninitialized
The name points to account state: an account was expected to exist (or not exist) already.
0xc8200InvalidEditionAccountLength
Edition account has an invalid length

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.