功能
已验证的集合
认证集合功能使 NFT（以及一般代币）能够被分组在一起，并且该信息可以在链上验证。此外，它通过在链上为这些集合分配数据，使管理这些集合变得更加容易。
此功能提供以下优势：
- 无需进行额外的链上调用即可轻松识别任何给定 NFT 所属的集合。
- 可以找到属于给定集合的所有 NFT（查看指南了解如何操作）。
- 易于管理集合元数据，如名称、描述和图片。
集合本身就是 NFT
为了将 NFT（或任何代币）分组在一起，我们必须首先创建一个集合 NFT，其目的是存储与该集合相关的任何元数据。没错，NFT 的集合本身就是一个 NFT。它在链上具有与任何其他 NFT 相同的数据布局。
集合 NFT 和普通 NFT 之间的区别在于，前者提供的信息将用于定义它包含的 NFT 组，而后者将用于定义 NFT 本身。
将 NFT 关联到集合 NFT
集合 NFT 和普通 NFT 通过元数据账户上的"属于"关系链接在一起。为此目的，元数据账户上的可选 Collection 字段被创建。
- 如果
Collection字段设置为None，则表示该 NFT 不属于任何集合。 - 如果
Collection字段已设置，则表示该 NFT 属于该字段中指定的集合。
因此，Collection 字段包含两个嵌套字段：
Key：此字段指向 NFT 所属的集合 NFT。更准确地说，它指向集合 NFT 的铸造账户的公钥。此铸造账户必须由 SPL Token 程序拥有。Verified：此布尔值非常重要，因为它用于验证 NFT 确实属于它所指向的集合。更多内容见下文。
区分 NFT 和集合 NFT
仅凭 Collection 字段就能让我们将 NFT 和集合链接在一起，但它无法帮助我们识别给定的 NFT 是普通 NFT 还是集合 NFT。这就是创建 CollectionDetails 字段的原因。它提供了有关集合 NFT 的附加上下文，并将它们与普通 NFT 区分开来。
- 如果
CollectionDetails字段设置为None，则表示该 NFT 是普通 NFT。 - 如果
CollectionDetails字段已设置，则表示该 NFT 是集合 NFT，并且可以在此字段中找到其他属性。
CollectionDetails 是一个可选的枚举，目前只包含一个选项 V1。此选项是一个包含以下字段的结构体：
Size：集合的大小，即直接链接到此集合 NFT 的 NFT 数量。此数字由 Token Metadata 程序自动计算，但也可以手动设置以方便迁移过程。请注意，目前有一个 MIP 正在废弃此Size属性。
创建集合 NFT
创建集合 NFT 与创建普通 NFT 非常相似。唯一的区别是我们必须设置上一节中看到的 CollectionDetails 字段。我们的一些 SDK 通过在创建 NFT 时请求 isCollection 属性来封装此功能。
1import { generateSigner, percentAmount } from '@metaplex-foundation/umi';
2import { createNft } from '@metaplex-foundation/mpl-token-metadata';
3
4// Assuming umi is set up with mplTokenMetadata plugin
5
6const collectionMint = generateSigner(umi);
7
8await createNft(umi, {
9 mint: collectionMint,
10 name: 'My Collection',
11 uri: 'https://example.com/my-collection.json',
12 sellerFeeBasisPoints: percentAmount(5.5), // 5.5%
13 isCollection: true,
14}).sendAndConfirm(umi);
15
16console.log('Collection NFT created:', collectionMint.publicKey);
1import { generateKeyPairSigner } from '@solana/kit';
2import { createNft } from '@metaplex-foundation/mpl-token-metadata-kit';
3
4// Assuming rpc, rpcSubscriptions, sendAndConfirm, and authority are set up
5
6const collectionMint = await generateKeyPairSigner();
7
8// Create a Collection NFT
9const [createIx, mintIx] = await createNft({
10 mint: collectionMint,
11 authority,
12 payer: authority,
13 name: 'My Collection',
14 uri: 'https://example.com/my-collection.json',
15 sellerFeeBasisPoints: 550, // 5.5%
16 tokenOwner: authority.address,
17 isCollection: true,
18});
19
20await sendAndConfirm({
21 instructions: [createIx, mintIx],
22 payer: authority,
23});
24
25console.log('Collection NFT created:', collectionMint.address);
嵌套集合 NFT
由于集合和 NFT 通过"属于"关系链接在一起，因此在设计上可以定义嵌套集合。在这种情况下，Collection 和 CollectionDetails 字段可以一起使用来区分根集合 NFT 和嵌套集合 NFT。
验证集合 NFT
如上所述，Collection 字段包含一个 Verified 布尔值，用于确定 NFT 是否确实属于它所指向的集合。如果没有这个字段，任何人都可以假装他们的 NFT 属于任何集合。
为了将 Verified 布尔值翻转为 True，集合 NFT 的权限必须签名 NFT，以证明它被允许成为集合的一部分。
极其重要
浏览器、钱包和市场必须检查 Verified 是否为 true。只有在集合 NFT 上的权限对 NFT 运行了 Token Metadata Verify 指令之一时，Verified 才能设置为 true。
这与 Creators 字段的模式相同，其中 Verified 必须为 true 才能验证 NFT。
为了检查 NFT 上的集合是否有效，它必须设置了包含以下内容的集合结构：
key字段与适当的集合父级的铸造地址匹配。verified字段设置为true。
如果不遵循这两个步骤，您可能会在真实集合上暴露欺诈性 NFT。
验证
一旦在 NFT 上设置了 Collection 属性，集合 NFT 的权限就可以在 Token Metadata 上发送验证指令，将其 verify 属性从 false 翻转为 true。此指令接受以下属性：
- Metadata：NFT 的元数据账户地址。这是我们想要在集合中验证的 NFT。
- Collection Mint：集合 NFT 的铸造账户地址。这是已经在 NFT 的元数据账户上设置但尚未验证的集合 NFT。
- Authority：集合 NFT 的权限作为签名者。这可以是集合 NFT 的更新权限或具有适当角色的已批准委托（请参阅"委托权限"页面）。
以下是如何使用我们的 SDK 在 Token Metadata 上验证集合 NFT。
1import { publicKey } from '@metaplex-foundation/umi';
2import { verifyCollectionV1, findMetadataPda } from '@metaplex-foundation/mpl-token-metadata';
3
4// Assuming umi, collectionMint, and collectionAuthority are set up
5
6const mintAddress = publicKey('mintAddress...');
7
8// First find the metadata PDA to use later
9const metadata = findMetadataPda(umi, {
10 mint: mintAddress,
11});
12
13await verifyCollectionV1(umi, {
14 metadata,
15 collectionMint,
16 authority: collectionAuthority,
17}).sendAndConfirm(umi);
18
19console.log('Collection verified on NFT');
1import {
2 getVerifyCollectionV1InstructionAsync,
3 findMetadataPda,
4} from '@metaplex-foundation/mpl-token-metadata-kit';
5
6// Assuming rpc, rpcSubscriptions, sendAndConfirm, and collectionAuthority are set up
7
8const mintAddress = 'mintAddress...'; // The NFT to verify
9const collectionMintAddress = 'collectionMintAddress...'; // The collection NFT
10
11// Find the metadata PDA
12const [metadata] = await findMetadataPda({ mint: mintAddress });
13
14// Verify the collection on the NFT
15const verifyIx = await getVerifyCollectionV1InstructionAsync({
16 metadata,
17 collectionMint: collectionMintAddress,
18 authority: collectionAuthority,
19 payer: collectionAuthority,
20});
21
22await sendAndConfirm({
23 instructions: [verifyIx],
24 payer: collectionAuthority,
25});
26
27console.log('Collection verified on NFT');
取消验证
相反，集合 NFT 的权限可以取消验证属于其集合的任何 NFT。这是通过向 Token Metadata 程序发送取消验证指令来完成的，其属性与验证指令相同。
1import { publicKey } from '@metaplex-foundation/umi';
2import { unverifyCollectionV1, findMetadataPda } from '@metaplex-foundation/mpl-token-metadata';
3
4// Assuming umi, collectionMint, and collectionAuthority are set up
5
6const mintAddress = publicKey('mintAddress...');
7
8// First find the metadata PDA to use later
9const metadata = findMetadataPda(umi, {
10 mint: mintAddress,
11});
12
13await unverifyCollectionV1(umi, {
14 metadata,
15 collectionMint,
16 authority: collectionAuthority,
17}).sendAndConfirm(umi);
18
19console.log('Collection unverified on NFT');
1import {
2 getUnverifyCollectionV1InstructionAsync,
3 findMetadataPda,
4} from '@metaplex-foundation/mpl-token-metadata-kit';
5
6// Assuming rpc, rpcSubscriptions, sendAndConfirm, and collectionAuthority are set up
7
8const mintAddress = 'mintAddress...'; // The NFT to unverify
9const collectionMintAddress = 'collectionMintAddress...'; // The collection NFT
10
11// Find the metadata PDA
12const [metadata] = await findMetadataPda({ mint: mintAddress });
13
14// Unverify the collection on the NFT
15const unverifyIx = await getUnverifyCollectionV1InstructionAsync({
16 metadata,
17 collectionMint: collectionMintAddress,
18 authority: collectionAuthority,
19 payer: collectionAuthority,
20});
21
22await sendAndConfirm({
23 instructions: [unverifyIx],
24 payer: collectionAuthority,
25});
26
27console.log('Collection unverified on NFT');