Master Edition 插件

Master Edition 插件将编号的版本 Asset 分组到 Collection 下。存储最大供应量、版本名称和 URI，以创建像"限量 100 份"这样的印刷系列。

摘要

Master Edition 插件是用于 Collection 的权限管理插件，将 Edition Asset 组合在一起。存储最大供应量和可选的版本特定元数据。

• 权限管理（更新权限控制）
• 仅适用于 Collection（不适用于 Asset）
• 值仅供参考，不强制执行
• 与 Candy Machine 配合使用以自动创建版本

范围外

供应强制执行（使用 Candy Machine 守卫）、单个版本号（在 Asset 上使用 Edition 插件）和自动铸造不在范围内。

快速开始

跳转到： 创建 Collection · 更新插件

1. 使用 Master Edition 插件和最大供应量创建 Collection
2. 使用 Edition 插件铸造 Asset（编号 1、2、3...）
3. 根据需要更新最大供应量或元数据

兼容性

参数

使用 Master Edition 插件创建 Collection

import { generateSigner, publicKey } from '@metaplex-foundation/umi'
import { createCollection } from '@metaplex-foundation/core'
const collectionSigner = generateSigner(umi)
await createCollection(umi, {
  collection: collectionSigner,
  name: 'My NFT',
  uri: 'https://example.com/my-nft.json',
  plugins: [
    {
      type: 'MasterEdition',
      maxSupply: 100,
      name: 'My Master Edition',
      uri: 'https://example.com/my-master-edition.json',
    },
  ],
}).sendAndConfirm(umi)

更新 Master Edition 插件

如果 Master Edition 插件是可变的，可以像其他 Collection 插件一样更新：

import { publicKey } from '@metaplex-foundation/umi'
import { updatePluginV1, createPlugin } from '@metaplex-foundation/mpl-core'
const asset = publicKey('11111111111111111111111111111111')
await updatePlugin(umi, {
  asset: asset,
  plugin: {
    type: 'MasterEdition',
    maxSupply: 110,
    name: 'My Master Edition',
    uri: 'https://example.com/my-master-edition',
  },
}).sendAndConfirm(umi)

常见错误

Cannot add to Asset

Master Edition 仅适用于 Collection，不适用于单个 Asset。对 Asset 使用 Edition 插件。

Authority mismatch

只有更新权限可以添加或更新 Master Edition 插件。

注意事项

• 所有值（maxSupply、name、uri）仅供参考——不强制执行
• 使用 Candy Machine 守卫强制执行实际的供应限制
• name/uri 覆盖 Collection 元数据以用于版本特定的品牌
• 权限可以随时更新

快速参考

参数

版本设置模式

常见问题

Master Edition 会强制执行最大供应量吗？

不会。maxSupply 仅供参考。使用带有适当守卫的 Candy Machine 在铸造期间实际强制执行供应限制。

Master Edition name/uri 和 Collection name/uri 有什么区别？

Master Edition name/uri 可以提供与基础 Collection 不同的版本特定元数据。例如，Collection 可能是"Abstract Art Series"，而 Master Edition 名称可以是"Limited Print Run 2024"。

可以创建开放版本（无限供应）吗？

可以。将 maxSupply 设置为 null 或完全省略。这表示没有定义限制的开放版本。

需要同时使用 Master Edition 和 Edition 插件吗？

对于正确的印刷追踪，是的。Master Edition 用于 Collection（分组和供应信息），Edition 用于每个 Asset（单个编号）。它们协同工作。

可以将 Master Edition 添加到现有 Collection 吗？

可以，与 Asset 上的 Edition 插件不同，Master Edition 可以使用 addCollectionPlugin 添加到现有 Collection。

术语表