Summary

Updating a compressed NFT modifies its metadata using the updateMetadataV2 instruction. This page covers update authority rules for collection-based and tree-based cNFTs.

• Update cNFT metadata (name, URI, creators, royalties) using updateMetadataV2
• Collection authority updates cNFTs that belong to a collection
• Tree authority updates cNFTs that do not belong to a collection
• Changes are reflected in the merkle tree and indexed by DAS API providers

updateMetadataV2指令可用于修改压缩NFT的元数据。默克尔根会更新以反映数据的传播哈希，符合Metaplex DAS API的RPC提供商将更新其cNFT索引。

元数据可以由两个权限之一更新，具体取决于压缩NFT是否是集合中的已验证项目。

更新权限

cNFT有两个可能的更新权限：树所有者，或（如果属于集合）集合权限。

集合权限

如果您的cNFT属于某个集合，那么该cNFT的更新权限将是集合的权限。更新cNFT时，您需要向更新函数传递coreCollection参数。

权限将从当前umi身份推断。如果权限与当前umi身份不同，则您需要将authority参数作为签名者类型传入，或创建一个noopSigner以便稍后签名。

await updateMetadataV2(umi, {
  ...
  authority: collectionAuthority,
  coreCollection: publicKey("11111111111111111111111111111111"),
}).sendAndConfirm(umi)

树权限

如果您的cNFT不属于集合，那么cNFT的更新权限将是cNFT所属树的权限。在这种情况下，您应该从更新函数中省略coreCollection参数。

权限将从当前umi身份推断。如果权限与当前umi身份不同，则您需要将authority参数作为签名者类型传入，或创建一个noopSigner以便稍后签名。

更新cNFT

import {
  getAssetWithProof,
  updateMetadataV2,
  UpdateArgsArgs,
} from '@metaplex-foundation/mpl-bubblegum'
import { some } from '@metaplex-foundation/umi'

// 使用辅助函数获取资产和证明。
const assetWithProof = await getAssetWithProof(umi, assetId, {
  truncateCanopy: true,
})

// 然后我们可以用它来更新NFT的元数据。
const updateArgs: UpdateArgsArgs = {
  name: some('New name'),
  uri: some('https://updated-example.com/my-nft.json'),
}
await updateMetadataV2(umi, {
  ...assetWithProof,
  leafOwner,
  currentMetadata: assetWithProof.metadata,
  updateArgs,
  // 可选参数。如果您的权限是与当前umi身份不同的签名者类型，
  // 在此处分配该签名者。
  authority: <Signer>,
  // 可选参数。如果cNFT属于集合，在此处传递。
  coreCollection: publicKey("22222222222222222222222222222222"),
}).sendAndConfirm(umi)

Notes

• The update authority depends on whether the cNFT belongs to a collection. Collection cNFTs use the collection authority; standalone cNFTs use the tree authority.
• You must pass currentMetadata from getAssetWithProof so the program can verify the current leaf before applying updates.
• Use some() for fields you want to update and omit fields you want to keep unchanged.

FAQ

Glossary