Editionプラグイン

Editionプラグインは、個々のAssetsにエディション番号を保存します。コレクティブルシリーズや限定版の「1 of 100」のような番号付きプリントを作成するために使用します。

概要

Editionプラグインは、Assetに固有のエディション番号を保存するAuthority Managedプラグインです。番号付きエディションをグループ化するために、CollectionsのMaster Editionプラグインと一緒に使用するのが最適です。

• Authority Managed（update authorityが制御）
• Asset作成時に追加する必要がある
• authorityが変更可能なら番号を更新可能
• 自動番号付けにはCandy Machine Edition Guardを使用

対象外

供給量の強制（情報提供のみ）、自動番号付け（Candy Machineを使用）、コレクションレベルのエディション（CollectionsにはMaster Editionプラグインを使用）。

クイックスタート

ジャンプ先: 変更可能なエディションを作成 · 不変のエディションを作成 · エディションを更新

1. Asset作成時に固有の番号でEditionプラグインを追加
2. オプションで不変性のためにauthorityをNoneに設定
3. 変更可能なら後で番号を更新

対応

引数

Editionsプラグインを持つAssetの作成

EditionsプラグインはAssetの作成時に追加する必要があります。変更可能である限り、番号は変更できます。

変更可能なプラグインで作成

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プラグインで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プラグインが変更可能な場合、他のプラグインと同様に更新できます：

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作成時に追加する必要があります。既存のAssetsには追加できません。

Authority mismatch

（変更可能な場合）update authorityのみがエディション番号を更新できます。

Plugin is immutable

EditionプラグインのauthorityがNoneに設定されています。番号は変更できません。

注意事項

• エディション番号は一意であることが強制されません—クリエイターがこれを追跡する必要があります
• プラグインはcreate()中に追加する必要があり、作成後はできません
• authorityをNoneに設定すると、エディション番号は永続的になります
• 適切なグループ化のためにCollectionsのMaster Editionプラグインと一緒に使用

クイックリファレンス

Authorityオプション

推奨セットアップ

FAQ

エディション番号は一意であることが強制されますか？

いいえ。エディション番号は情報提供のみです。クリエイターは一意の番号を確保する責任があります。自動連番にはCandy MachineとEdition Guardを使用してください。

既存のAssetにEditionプラグインを追加できますか？

いいえ。Editionプラグインは Asset作成時に追加する必要があります。エディション番号が必要な場合は事前に計画してください。

「1 of 100」スタイルのエディションを作成するにはどうすればよいですか？

Assetsに（番号1-100で）Editionプラグインを追加し、CollectionにmaxSupply: 100でMaster Editionプラグインを追加します。Master Editionはエディションをグループ化し、総供給量を示します。

作成後にエディション番号を変更できますか？

はい、プラグインauthorityがNoneに設定されていなければ可能です。Update authorityはupdatePluginを使用して番号を変更できます。

EditionとMaster Editionの違いは何ですか？

EditionはAssetに個別の番号（例：#5）を保存します。Master EditionはCollection上にコレクションレベルのデータ（最大供給量、エディション名/URI）を保存し、エディションをグループ化します。

用語集