管理集合

Summary

Managing collections for compressed NFTs uses the setCollectionV2 instruction to add, change, or remove MPL-Core collections on existing cNFTs. This page covers setting and removing collections after minting.

• Set an MPL-Core collection on an existing cNFT using setCollectionV2
• Remove a collection from a cNFT
• Change between collections (both authorities must sign)
• Collections must have the BubblegumV2 plugin enabled

cNFT可以在铸造时或之后添加到MPL-Core集合。

如果您不熟悉NFT相关的集合概念，它们是特殊的非压缩NFT，可用于将其他NFT分组在一起。集合的数据因此用于描述整个集合的名称和品牌。自Bubblegum V2以来，它还允许在集合级别提供额外功能，例如允许委托人在无需叶子所有者交互的情况下冻结和解冻cNFT。您可以在此处阅读更多关于MPL-Core集合的信息。 请注意，可以通过使用MintV2指令此处记录直接将压缩NFT铸造到集合中。也就是说，如果您已经铸造了没有集合的cNFT，让我们看看如何在该cNFT上设置集合。与使用具有"已验证"布尔值的Metaplex Token Metadata集合的Bubblegum v1不同，Bubblegum V2使用没有该布尔值的MPL-Core集合。

MPL-Core集合必须包含BubblegumV2插件。

以下部分展示如何在单步交易中为cNFT设置和移除集合。在添加coreCollection和newCoreCollection参数时，也可以在单个指令中执行两个操作。如果两个集合权限不是同一个钱包，则两者都必须签名。

设置压缩NFT的集合

setCollectionV2指令可用于设置cNFT的集合。它也可用于从cNFT移除集合或更改cNFT的集合。

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

const assetWithProof = await getAssetWithProof(umi, assetId, {truncateCanopy: true});

const metadata = assetWithProof.currentMetadata

const signature = await setCollectionV2(umi, {
  ...assetWithProof,
  newCollectionAuthority: newCollectionUpdateAuthority,
  metadata,
  newCoreCollection: newCoreCollection.publicKey,
}).sendAndConfirm(umi);

移除压缩NFT的集合

setCollectionV2指令也可用于从cNFT移除集合。

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

const assetWithProof = await getAssetWithProof(umi, assetId, {truncateCanopy: true});

const collection = unwrapOption(assetWithProof.currentMetadata.collection)

const signature = await setCollectionV2(umi, {
  ...assetWithProof,
  metadata: assetWithProof.currentMetadata,
  authority: collectionAuthoritySigner,
  coreCollection: collection!,
}).sendAndConfirm(umi);

继承版税

通过从集合继承 seller fee basis points铸造的 cNFT 会在叶子上存储哨兵值 65535。这会影响集合管理：

• 移除集合 — 当叶子仍使用继承哨兵时，setCollectionV2 会拒绝该操作。请先通过 updateMetadataV2 将 cNFT 的 sellerFeeBasisPoints 更新为明确值。
• 移动到另一个集合 — 当目标集合具有 Royalties 插件时允许。cNFT 保留继承哨兵并从新集合解析版税。
• 移动到没有版税的集合 — 会被 CollectionMustHaveRoyaltiesPlugin 拒绝。

Notes

• The MPL-Core collection must have the BubblegumV2 plugin enabled before cNFTs can be added to it.
• Unlike Bubblegum V1 (which uses Token Metadata collections with a "verified" boolean), V2 uses MPL-Core collections without verification flags.
• When changing between collections, both the old and new collection authorities must sign the transaction.
• 继承 seller fee 的 cNFT 在叶子上的版税设置为明确值之前，无法从集合中移除。

FAQ

铸造后如何将 cNFT 添加到集合中？

使用 setCollectionV2 指令，并将 newCoreCollection 参数设置为集合的公钥。集合权限必须签名。

可以更改 cNFT 的集合吗？

可以。使用 setCollectionV2 并同时传入 coreCollection（当前）和 newCoreCollection（新）参数。如果权限是不同的账户，两个集合权限都必须签名。

BubblegumV2 插件是什么？

它是一个 MPL-Core 集合插件，在集合级别启用 Bubblegum V2 功能，如冻结/解冻、灵魂绑定 cNFT、版税强制执行和永久委托。

继承版税的 cNFT 可以从集合中移除吗？

不可以。程序会返回 CannotRemoveFromCollectionWithInheritedSellerFee。请先用 updateMetadataV2 将 sellerFeeBasisPoints 设置为明确值，然后调用 setCollectionV2 移除集合。

Glossary