Master Editionプラグイン

Master Editionプラグインは、番号付きエディションAssetsをCollection内でグループ化します。「100部限定」のようなプリントシリーズを作成するために、最大供給量、エディション名、URIを保存します。

概要

Master Editionプラグインは、Edition Assetsをグループ化するCollections用のAuthority Managedプラグインです。最大供給量とオプションのエディション固有メタデータを保存します。

• Authority Managed（update authorityが制御）
• Collectionsでのみ動作（Assetsでは不可）
• 値は情報提供のみで、強制されない
• 自動エディション作成にはCandy Machineと一緒に使用

対象外

供給量の強制（Candy Machineガードを使用）、個別のエディション番号（AssetsではEditionプラグインを使用）、自動ミント。

クイックスタート

ジャンプ先: Collectionを作成 · プラグインを更新

1. Master Editionプラグインと最大供給量でCollectionを作成
2. Editionプラグイン（番号1, 2, 3...）でAssetsをミント
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はCollectionsでのみ動作し、個別のAssetsでは動作しません。AssetsにはEditionプラグインを使用してください。

Authority mismatch

Update authorityのみがMaster Editionプラグインを追加または更新できます。

注意事項

• すべての値（maxSupply、name、uri）は情報提供のみで、強制されません
• 実際の供給量制限を強制するにはCandy Machineガードを使用
• name/uriはエディション固有のブランディングのためにCollectionメタデータを上書き
• Authorityによっていつでも更新可能

クイックリファレンス

引数

エディションセットアップパターン

FAQ

Master Editionは最大供給量を強制しますか？

いいえ。maxSupplyは情報提供のみです。ミント中の供給量制限を実際に強制するには、Candy Machineと適切なガードを使用してください。

Master Editionの名前/uriとCollectionの名前/uriの違いは何ですか？

Master Editionの名前/uriは、ベースCollectionとは異なるエディション固有のメタデータを提供できます。例えば、Collectionが「Abstract Art Series」で、Master Editionの名前が「Limited Print Run 2024」になることがあります。

オープンエディション（無制限供給）を作成できますか？

はい。maxSupplyをnullに設定するか、完全に省略します。これは定義された制限のないオープンエディションを示します。

Master EditionとEditionプラグインの両方が必要ですか？

適切なプリント追跡のためには、はい。Master EditionはCollection（グループ化と供給情報）に、Editionは各Asset（個別の番号）に追加します。これらは連携して機能します。

既存のCollectionにMaster Editionを追加できますか？

はい、AssetsのEditionプラグインとは異なり、Master EditionはaddCollectionPluginを使用して既存のCollectionに追加できます。

用語集