Verifying Creators

Summary

Verifying creators toggles the verified flag on a cNFT's creator entries. This page covers verifying and unverifying creators using the verifyCreatorV2 and unverifyCreatorV2 instructions.

• Verify a creator on an existing cNFT (the creator must sign)
• Unverify a creator from a cNFT
• Creators can also be verified at mint time by signing the mint transaction

If a Compressed NFT has a list of creators set in its metadata, these creators can use special instructions to verify and unverify themselves on the cNFT.

These instructions will toggle a Verified boolean on the appropriate item of the cNFT's Creators array. That boolean is important as it allows apps such as wallets and marketplaces to know which creators are genuine and which ones are not.

It is worth noting that creators can verify themselves directly when minting the Compressed NFT by signing the mint transaction. That being said, let's now see how a creator can verify or unverify themselves on an existing Compressed NFT.

Verify a Creator

The Bubblegum program offers a verifyCreatorV2 instruction that must be signed by the creator we are trying to verify. The creator has to be part of the Creators array of the Compressed NFT already. Use the updateMetadataV2 instruction to add a creator to the Creators array first if it is not already part of the array.

Additionally, more parameters must be provided to verify the integrity of the Compressed NFT, as this instruction will replace the leaf on the Bubblegum Tree. Since these parameters are common to all instructions that mutate leaves, they are documented in the following FAQ. Fortunately, we can use a helper method that will automatically fetch these parameters for us using the Metaplex DAS API.

import {
  getAssetWithProof,
  verifyCreatorV2,
  MetadataArgsV2Args
} from '@metaplex-foundation/mpl-bubblegum';
import {
  unwrapOption,
  none,
} from '@metaplex-foundation/umi';

const assetWithProof = await getAssetWithProof(umi, assetId, {truncateCanopy: true});
const collectionOption = unwrapOption(assetWithProof.metadata.collection);
const metadata: MetadataArgsV2Args = {
  name: assetWithProof.metadata.name,
  uri: assetWithProof.metadata.uri,
  sellerFeeBasisPoints: assetWithProof.metadata.sellerFeeBasisPoints,
  collection: collectionOption
    ? collectionOption.key
    : none(),
  creators: assetWithProof.metadata.creators,
};
await verifyCreatorV2(umi, {
  ...assetWithProof,
  metadata,
  creator: umi.identity, // Or a different signer than the umi identity
}).sendAndConfirm(umi);

Unverify a Creator

Similarly to the verifyCreatorV2 instruction, the unverifyCreatorV2 instruction must be signed by the creator and will unverify them on the Compressed NFT.

import {
  getAssetWithProof,
  unverifyCreatorV2,
  MetadataArgsV2Args
} from '@metaplex-foundation/mpl-bubblegum'
import {
  unwrapOption,
  none,
} from '@metaplex-foundation/umi';

const assetWithProof = await getAssetWithProof(umi, assetId, {truncateCanopy: true});
const metadata: MetadataArgsV2Args = {
  name: assetWithProof.metadata.name,
  uri: assetWithProof.metadata.uri,
  sellerFeeBasisPoints: assetWithProof.metadata.sellerFeeBasisPoints,
  collection: unwrapOption(assetWithProof.metadata.collection)
    ? unwrapOption(assetWithProof.metadata.collection)!.key
    : none(),
  creators: assetWithProof.metadata.creators,
};
await unverifyCreatorV2(umi, {
  ...assetWithProof,
  metadata,
  creator: umi.identity, // Or a different signer than the umi identity
}).sendAndConfirm(umi);

Notes

• Only creators already listed in the cNFT's creators array can be verified. Use updateMetadataV2 to add creators first.
• The creator being verified must sign the transaction themselves.
• Creators can be verified at mint time by signing the mint transaction, avoiding the need for a separate verification step.

FAQ

Can I verify a creator who is not in the creators array?

No. The creator must already be listed in the cNFT's creators array. Use updateMetadataV2 to add the creator first, then verify them.

Who signs the verify transaction?

The creator being verified must sign the transaction. You cannot verify a creator on someone else's behalf.

Can a creator verify themselves at mint time?

Yes. If a creator signs the mint transaction, they are automatically verified in the cNFT's creator array.

Glossary