Edition 插件

Edition 插件在单个 Asset 上存储版本号。用于为收藏系列和限量版创建编号的印刷品，如"1 of 100"。

摘要

Edition 插件是一个权限管理插件，在 Asset 上存储唯一的版本号。最好与 Collection 上的 Master Edition 插件 一起使用，将编号的版本组合在一起。

• 权限管理（更新权限者控制）
• 必须在 Asset 创建时添加
• 如果权限可变，可以更新编号
• 使用 Candy Machine Edition Guard 进行自动编号

范围外

供应量强制（仅供参考）、自动编号（使用 Candy Machine）和 Collection 级别版本（对 Collection 使用 Master Edition 插件）。

快速开始

跳转至： 创建可变版本 · 创建不可变版本 · 更新版本

1. 在 Asset 创建时添加带有唯一编号的 Edition 插件
2. 可选地将权限设为 None 以实现不可变性
3. 如果可变，稍后更新编号

适用于

参数

使用 editions 插件创建 Asset

Editions Plugin 必须在资产创建时添加。只要它是可变的，编号就可以更改。

使用可变插件创建

import { publicKey } from '@metaplex-foundation/umi'
import { create } from '@metaplex-foundation/mpl-core'
const assetSigner = generateSigner(umi)
const result = create(umi, {
  asset: assetSigner,
  name: 'My Asset',
  uri: 'https://example.com/my-asset.json',
  plugins: [
    {
      type: 'Edition',
      number: 1
    },
  ],
}).sendAndConfirm(umi)

使用不可变插件创建

要创建带有不可变 Edition Plugin 的 Asset，可以使用以下代码：

import { publicKey } from '@metaplex-foundation/umi'
import { create } from '@metaplex-foundation/mpl-core'
const asset = generateSigner(umi)
const result = create(umi, {
  asset: asset,
  name: 'My Nft',
  uri: 'https://example.com/my-nft',
  plugins: [
    {
      type: 'Edition',
      number: 1,
      authority: { type: 'None' },
    },
  ],
}).sendAndConfirm(umi)

更新 Editions 插件

如果 Editions Plugin 是可变的，可以像其他插件一样更新：

import { publicKey } from '@metaplex-foundation/umi'
import { updatePlugin } from '@metaplex-foundation/mpl-core'
const asset = publicKey('11111111111111111111111111111111')
  await updatePlugin(umi, {
    asset: assetAccount.publicKey,
    plugin: { type: 'Edition', number: 2 },
  }).sendAndConfirm(umi);

常见错误

Cannot add Edition plugin after creation

Edition 插件必须在 Asset 创建时添加。不能添加到现有 Asset。

Authority mismatch

只有更新权限者可以更新版本号（如果可变）。

Plugin is immutable

Edition 插件的权限设置为 None。编号无法更改。

注意事项

• 版本号不强制唯一——创作者必须跟踪
• 插件必须在 create() 期间添加，而不是之后
• 将权限设置为 None 使版本号永久
• 与 Collection 上的 Master Edition 插件一起使用以正确分组

快速参考

权限选项

推荐设置

常见问题

版本号是否强制唯一？

不是。版本号仅供参考。创作者负责确保唯一的编号。使用带有 Edition Guard 的 Candy Machine 进行自动顺序编号。

可以向现有 Asset 添加 Edition 插件吗？

不可以。Edition 插件必须在 Asset 创建时添加。如果需要版本号，请提前规划。

如何创建"1 of 100"风格的版本？

向 Asset 添加 Edition 插件（编号 1-100），并向 Collection 添加 maxSupply: 100 的 Master Edition 插件。Master Edition 分组版本并指示总供应量。

创建后可以更改版本号吗？

可以，如果插件权限未设置为 None。更新权限者可以使用 updatePlugin 修改编号。

Edition 和 Master Edition 有什么区别？

Edition 在 Asset 上存储单个编号（例如 #5）。Master Edition 在 Collection 上存储集合级别的数据（最大供应量、版本名称/URI）并将版本组合在一起。

术语表