Core Candy Machineプログラム概要

概要

Core Candy Machineは、Solana上でMPL Core Assetコレクションをローンチするために特化したMetaplexのミント・配布プログラムです。アイテムメタデータのロードからガード付きミント、ローンチ後のクリーンアップまで、NFTドロップの完全なライフサイクルを管理します。

• 支払い、アクセス制御、スケジューリング、ボット保護のための23以上のコンポーザブルなガードをサポート
• MPL Core Assets（単一アカウントNFT）をミント。レガシーToken Metadata NFTではありません
• アイテムはメタデータ参照としてロードされ、オンチェーンアセットはミント時にのみ作成
• 別のCandy Guardプログラムが、カスタムミントワークフロー用のフォーク可能なアクセス制御レイヤーを提供

はじめに

2022年9月までに、Solana上のすべてのNFTの78%がMetaplexのCandy Machineを通してミントされました。これには、Solanaエコシステムで最もよく知られたNFTプロジェクトの大部分が含まれます。2024年にMetaplexは、SolanaでNFTを再定義するCoreプロトコルを導入し、それに伴いCore標準に対応する同じミント機能を提供する新しいCandy Machineが登場しました。

以下にその機能をいくつか紹介します。

• SOL、NFT、またはあらゆるSolanaトークンでの支払いを受け入れ。
• 開始/終了日、ミント制限、サードパーティ署名者などによるローンチ制限。
• 設定可能なボット税やCaptchaなどのゲートキーパーによるボット保護。
• 特定のアセット/NFT/トークンホルダーまたは厳選されたウォレットリストへのミント制限。
• 異なるルールセットを持つ複数のミントグループの作成。
• ローンチ後にアセットを公開しつつ、ユーザーがその情報を検証できる機能。
• その他多数の機能！

Core Candy Machineのライフサイクル

Core Candy Machineのライフサイクルは、作成、アイテムロード、ミント、オプションの引き出しの4つの連続フェーズで構成されます。各フェーズは次のフェーズが開始される前に完了する必要があります。

フェーズ1 — Candy Machineの作成と設定

最初のステップは、クリエイターが新しいCore Candy Machineを作成し、コレクションアドレス、アイテム数、オプションのConfig Line SettingsまたはHidden Settingsを含む設定を構成することです。

作成されたCore Candy Machineは独自の設定を追跡し、すべてのアセットがどのように作成されるべきかを決定します。例えば、このCore Candy Machineから作成されるすべてのアセットに割り当てられるcollectionパラメータがあります。Core Candy Machineの作成と設定の詳細については、Core Candy Machineの作成を参照してください。

フェーズ2 — Candy Machineへのアイテム挿入

作成後、ミントされる各アイテムのメタデータをCandy Machineにロードする必要があります。各アイテムはnameと、事前にアップロードされたJSONメタデータを指すuriで構成されます。

各アイテムは2つのパラメータで構成されます：

• name: アセットの名前。
• uri: アセットのJSONメタデータを指すURI。これは、JSONメタデータが既にオンチェーン（例：Arweave、IPFS）またはオフチェーン（例：AWS、独自サーバー）ストレージプロバイダーを介してアップロードされていることを意味します。Candy Machine作成ツール（CLIやJS SDKなど）は、これを支援するヘルパーを提供します。

その他のパラメータはアセット間で共有されるため、繰り返しを避けるためにCandy Machineの設定に直接保持されます。詳細はアイテムの挿入を参照してください。

フェーズ3 — Candy Machineからのアセットミント

Candy Machineが完全にロードされ、設定されたすべてのガード条件が満たされると、ユーザーはCore Assetsのミントを開始できます。各ミントはCandy Machineから1つのアイテムを消費し、新しいオンチェーンアセットを作成します。

ミント前に、一部のユーザーはCaptchaの実行やMerkle Proofの送信など、追加の検証手順を実行する必要がある場合があります。詳細はミントを参照してください。

フェーズ4 — Candy Machineの引き出し

すべてのアセットがミントされた後、Candy Machineはその目的を果たし、削除してオンチェーンストレージのレントを回収できます。権限が回収されたSOLを受け取ります。

Core Candy Machineアカウント構造

Core Candy Machineアカウントは、ミントプロセスを管理するために必要なすべての設定と状態データを保存します。オンチェーンデータ構造は、マシンバージョン、有効な機能、権限キー、コレクションバインディング、引き換え数を追跡します。

authorityは、設定の更新、アイテムの挿入、レントの引き出しなどの管理操作を制御します。mint_authorityはミント命令をトリガーできる人を制御します。Candy Guardがアタッチされると、ミント権限となり、ミントが進行する前にすべてのガード検証が通過する必要があります。

Candy Guardシステム

Candy Guardプログラムは、Core Candy Machineのミントにコンポーザブルで設定可能なアクセス制御を提供するコンパニオンSolanaプログラムです。ガードはミントプロセスを制限または変更するモジュラールールです。

クリエイターは「ガード」と呼ばれるものを使用して、Core Candy Machineにさまざまな機能を追加できます。Metaplex Core Candy Machineには、Candy Guardと呼ばれる追加のSolanaプログラムが付属しており、合計23以上のデフォルトガードが含まれています。追加プログラムを使用することで、高度な開発者はデフォルトのCandy Guardプログラムをフォークして独自のカスタムガードを作成しながら、メインのCandy Machineプログラムに依存し続けることができます。

各ガードは自由に有効化・設定できるため、クリエイターは必要な機能を選択できます。すべてのガードを無効にすることは、誰でもいつでも無料でアセットをミントできるようにすることに相当しますが、これはおそらく望ましいことではありません。

Candy Guardの組み合わせ例

ガードは組み合わせることで完全なミントポリシーを形成します。以下の例は、4つのガードを組み合わせてボット保護、時間制限、レート制限、有料ミントを作成する方法を示しています。

Core Candy Machineに以下のガードがあるとします：

• Sol Payment: ミントウォレットが設定された宛先ウォレットに設定された量のSOLを支払うことを確保します。
• Start Date: 設定された時刻以降にのみミントが開始できることを確保します。
• Mint Limit: 各ウォレットが設定された量を超えてミントできないことを確保します。
• Bot Tax: ミントのガード検証に失敗した場合、ミントを試行したウォレットに少額の設定されたSOL量を請求し、ボットを抑止します。

最終的に、ボット保護され、SOLを請求し、特定の時刻にローンチし、ウォレットあたりの制限されたミント量のみを許可するCandy Machineが完成します。具体的な例を以下に示します。

23以上のデフォルトガードとカスタムガードを作成する能力により、クリエイターは重要な機能を厳選し、完璧なCandy Machineを構成できます。ガードはガードグループに整理して、異なるルールを持つ複数のミントフェーズを定義することもできます（例：許可リストウォレット向けのアーリーアクセスフェーズの後にパブリックミント）。ガードについて詳しく知るための最適な出発点は、Candy Guardsページです。

注意事項

• Core Candy MachineはMPL Core Assetsのみをミントします。Token Metadata NFTをミントするには、代わりにCandy Machine V3を使用してください。
• Config Line Settingsを使用する場合、ミントが開始される前にすべてのアイテムを挿入する必要があります。
• 各アイテムのJSONメタデータは、Candy Machineにアイテムを挿入する前にストレージプロバイダー（Arweave、IPFS、AWSなど）にアップロードする必要があります。
• Candy Machineの引き出しは不可逆で、そのマシンのすべてのオンチェーンデータが削除されます。
• Candy GuardプログラムはCandy Machine Coreプログラムとは別のものです。カスタムロジック用にガードプログラムをフォークしても、コアミントプログラムを変更する必要はありません。
• Bot Taxが有効な場合、ガード検証の失敗はトランザクションを単純に拒否するのではなく、失敗したミンターに課金します。

Metaplex Foundationによるメンテナンス · 最終確認 2026年3月 · GitHubでソースを表示

FAQ

Core Candy Machineとは何ですか？Candy Machine V3とどう違いますか？

Core Candy MachineはMPL Core Assets専用に設計された最新のMetaplexミントプログラムです。Candy Machine V3は旧標準のToken Metadata NFTをミントします。Core Candy MachineはMPL Coreの単一アカウントモデルを使用するため、より軽量でコスト効率の高いアセットを生成します。

Core Candy Machineで利用可能なガードはいくつありますか？

Core Candy MachineはコンパニオンであるCandy Guardプログラムを通じて23以上のデフォルトガードを提供します。これらのガードは支払い（SOL、SPLトークン、NFT）、アクセス制御（許可リスト、トークンゲート、NFTゲート）、スケジューリング（開始日・終了日）、ボット保護（ボット税、ゲートキーパー）をカバーします。

開発者はCore Candy Machine用のカスタムガードを作成できますか？

はい。ガードシステムは別のCandy Guardプログラムとして実装されており、フォーク可能です。開発者はメインのCandy Machineプログラムのミントロジックに依存しながら、カスタムガードを作成できます。

すべてのアイテムがミントされた後、Core Candy Machineはどうなりますか？

すべてのアイテムがミントされた後、Candy Machineを引き出してオンチェーンストレージのレントを回収できます。この操作は不可逆で、レントに使用されたSOLが権限ウォレットに返還されます。

Core Candy Machineにロードする前にアイテムをオンチェーンアセットとして存在させる必要がありますか？

いいえ。Candy Machineにロードするのはアイテムメタデータ（名前とURIのペア）であり、実際のオンチェーンアセットではありません。Core Assetsはユーザーがミントする瞬間にのみSolanaブロックチェーン上に作成されます。詳細はアイテムの挿入を参照してください。

Candy Machine権限とミント権限の違いは何ですか？

authorityはCandy Machineの設定管理（設定の更新、アイテムの挿入、引き出し）を制御します。mint authorityはミントをトリガーできる人を制御します。通常、ミント前にガード検証が強制されるよう、Candy Guardアカウントがミント権限として設定されます。

用語集