紹介
Core Candy Machine - SolanaでのNFTミントと配布
Last updated March 10, 2026
MetaplexプロトコルのCore Candy Machineは、SolanaにおけるNFTコレクションのフェアローンチのための主要なミント・配布プログラムです。Metaplex Coreアセット標準向けに構築されたCore Candy Machineは、クリエイターがアイテムをロードし、バイヤーがミントする一時的なオンチェーン自動販売機として機能します。これにより、クリエイターは安全でカスタマイズ可能な方法でデジタル資産をオンチェーンに持ち込むことができます。
- Core Assetsを単一アカウントモデルでミント -- レガシーToken Metadata NFTより低コストでシンプル
- 23以上のコンポーザブルなガードで支払い、タイミング、許可リスト、ボット保護をカスタマイズ
- フルライフサイクルを管理: 作成、アイテム挿入、ミント、引き出し
- ガード設定によりSOL、SPLトークン、またはNFTでの支払いをサポート
この名前は、機械式クランクを使ってコインと引き換えにキャンディを配布する自動販売機に由来しています。この場合、キャンディはNFTであり、支払いはSOLまたはSPLトークンです。
はじめに
お好みの言語やライブラリを選択して、Candy Machinesを始めましょう。
CLIコマンド
Metaplex CLIのインタラクティブウィザードを使用してCandy Machineを作成・管理します。
APIリファレンス
JavaScript APIドキュメントを確認してください。
APIリファレンス
Rust APIドキュメントを確認してください。
このドキュメントは、Core Candy Machineとして知られるCandy Machineの最新バージョンについて説明しています。これはCoreアセットのミントを可能にします。Metaplex Token MetadataのNFTをミントしたい場合は、代わりにCandy Machine V3を参照してください。
Core Candy Machineのライフサイクル
Core Candy Machineは、作成、ロード、ミント、引き出しの4段階のライフサイクルに従います。クリエイターは設定とアイテムメタデータを事前に構成・挿入し、バイヤーがオンデマンドでCore Assetsをミントします。すべてのアイテムがミントされた後、クリエイターはマシンを削除してレントを回収できます。
- 作成と設定 コレクションレベルの設定でCandy Machineを作成
- アイテムの挿入 各アセットの名前とメタデータURIを提供
- ミント -- バイヤーがガードルールに従ってオンデマンドでCore Assetを作成
- 引き出し ローンチ後にCandy Machineを引き出してオンチェーンレントを回収
バイヤーがミントするまで、Core Assetsはオンチェーンに存在しません。Candy Machineは、ミント時に各アセットを作成するために必要なメタデータ参照のみを保存します。
Candy Guardsとミントのカスタマイズ
Candy Guardsは、ミントプロセスを保護・カスタマイズするモジュラーなアクセス制御ルールです。Core Candy Guardプログラムには、クリエイターが独立して有効化・設定できる23以上のデフォルトガードが付属しています。
各ガードは単一の責任を処理するため、コンポーザブル(組み合わせ可能)です。一般的なガードの組み合わせには以下が含まれます:
- Sol Payment -- ミントごとに設定されたSOL額を請求
- Start Date / End Date -- ミントを時間枠に制限
- Mint Limit -- ウォレットごとのミント数を制限
- Bot Tax -- ガード検証に失敗したミントにペナルティを請求
- Allow List -- 事前定義されたウォレットセットにミントを制限
- Token Gate / NFT Gate -- 特定のトークンまたはNFTの保有者にミントを制限
ガードは、Candy Machineのミント権限となる別のCandy Guardアカウントを介して割り当てられます。上級開発者はCandy Guardプログラムをフォークしてカスタムガードを構築でき、コアミントプログラムには引き続き依存できます。クリエイターはガードグループを定義して、異なるオーディエンスに異なるミント条件を提供することもできます(例:許可リストフェーズの後にパブリックセール)。
クイックリファレンス
| 項目 | 値 |
|---|---|
| Core Candy Machineプログラム | CMACYFENjoBMHzapRXyo1JZkVS6EtaDDzkjMrmQLvr4J |
| Core Candy Guardプログラム | CMAGAKJ67e9hRZgfC5SFTbZH8MgEmtqazKXjmkaJjWTJ |
| JS SDK | @metaplex-foundation/mpl-core-candy-machine |
| Rust Crate | mpl-core-candy-machine-core |
| ソース | GitHub |
| JS TypeDoc | mpl-core-candy-machine.typedoc.metaplex.com |
| Rust Docs | docs.rs/mpl-core-candy-machine-core |
| デフォルトガード | 23以上のコンポーザブルガード |
注意事項
- Core Candy MachineはMetaplex Core Assetsのみをミントします。レガシーToken Metadata NFTをミントするには、Candy Machine V3を使用してください。
- ミント制限を強制するには、実質的にCandy Guardアカウントが必要です。Candy Guardがない場合、Candy Machineは無制限の無料ミントを許可します。
- ミントを開始する前にアイテムを挿入する必要があります。各アイテムには
nameと、事前にアップロードされたJSONメタデータを指すuriが必要です。 - すべてのアイテムがミントされた後、Candy Machineを引き出してオンチェーンレントを回収してください。ミントされたアセットは影響を受けません。
- Candy GuardプログラムはCore Candy Machineプログラムとは別のオンチェーンプログラムです。トランザクションの構築時には両方を参照する必要があります。
- ボット保護のベストプラクティスについては、ボット対策保護のベストプラクティスを参照してください。
FAQ
Core Candy MachineとCandy Machine V3の違いは何ですか?
Core Candy MachineはMetaplex Core Assetsをミントし、単一アカウントモデルで低コストかつビルトインプラグインを備えています。Candy Machine V3は複数のアカウントを必要とするレガシーToken Metadata NFTをミントします。新しいプロジェクトにはCore Candy Machineを使用してください。
Core Candy Machineの作成にはどれくらいのコストがかかりますか?
Core Candy Machineの作成にはオンチェーンアカウントのレントが必要で、ロードするアイテム数によって異なります。ミントコストは有効化されたガードによって異なります。例えば、Sol Paymentガードはミントごとにクリエイターが定義したSOL額を請求します。Solanaトランザクション手数料も適用されます。
Core Candy Machineで複数のガードを同時に有効化できますか?
はい。ガードはコンポーザブルです。23以上のデフォルトガードを任意に組み合わせて有効化できます。例えば、Sol Payment、Start Date、Mint Limit、Bot Taxを組み合わせて、時間制限付き、レート制限付き、ボット保護された有料ミントを作成できます。
すべてのアイテムがミントされた後、Core Candy Machineはどうなりますか?
すべてのアイテムがミントされた後、Candy Machineを削除(引き出し)してオンチェーンレントを回収できます。ミントされたCore Assetsはオンチェーンに残り、削除による影響を受けません。
Core Candy Machineには別のCandy Guardアカウントが必要ですか?
実質的には必要です。Candy Guardアカウントがミントルール(支払い、タイミング、許可リスト、ボット保護)を強制します。Candy Guardがない場合、誰でもいつでも無料でミントできます。Candy Guardを作成し、ミント権限として設定するのが標準的なワークフローです。
開発者はカスタムガードを作成できますか?
はい。Candy Guardプログラムはフォーク可能に設計されています。開発者はメインのCore Candy Machineプログラムのミントロジックに依存しながら、カスタムガードロジックを作成できます。23以上のデフォルトガードがほとんどのユースケースをカバーしますが、カスタムガードによりプロジェクト固有の要件に対応できます。
用語集
| 用語 | 定義 |
|---|---|
| Core Candy Machine | アイテムメタデータを保存し、オンデマンドでCore Assetsをミントするオンチェーンのmetaplexプログラム |
| Candy Guard | Candy Machineにコンポーザブルなアクセス制御ルール(ガード)をラップする別のオンチェーンプログラム |
| ガード | ミントプロセスを制限または変更する単一のモジュラールール(例:支払い、タイミング、許可リスト) |
| ガードグループ | 異なるオーディエンスに異なるミント条件を適用するためのガード設定の名前付きセット |
| アイテム | ミント前にCandy Machineにロードされる名前とメタデータURIのペア |
| Core Asset | Metaplex Core NFT -- ビルトインプラグインサポートを持つ単一アカウントのデジタルアセット |
| ミント権限 | ミントをトリガーする権限を持つアカウント。通常はCandy Guardアカウントに設定 |
| コレクション | Candy Machineからミントされるすべてのアセットに割り当てられるオンチェーンコレクションアドレス |
次のステップ
- SDKセットアップ -- JavaScriptまたはRustを選択してSDKをインストール
- Core Candy Machineの作成 -- 設定を構成してデプロイ
- アイテムの挿入 -- アセットメタデータをマシンにロード
- ガードの設定 -- 支払い、タイミング、アクセスルールを設定
- Core Assetsのミント -- ミントフローを理解する
