紹介

Core Candy Machine - SolanaでのNFTミントと配布

Last updated March 10, 2026

MetaplexプロトコルのCore Candy Machineは、SolanaにおけるNFTコレクションのフェアローンチのための主要なミント・配布プログラムです。Metaplex Coreアセット標準向けに構築されたCore Candy Machineは、クリエイターがアイテムをロードし、バイヤーがミントする一時的なオンチェーン自動販売機として機能します。これにより、クリエイターは安全でカスタマイズ可能な方法でデジタル資産をオンチェーンに持ち込むことができます。

この名前は、機械式クランクを使ってコインと引き換えにキャンディを配布する自動販売機に由来しています。この場合、キャンディは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をミントします。すべてのアイテムがミントされた後、クリエイターはマシンを削除してレントを回収できます。

  1. 作成と設定 コレクションレベルの設定でCandy Machineを作成
  2. アイテムの挿入 各アセットの名前とメタデータURIを提供
  3. ミント -- バイヤーがガードルールに従ってオンデマンドでCore Assetを作成
  4. 引き出し ローンチ後に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 Cratempl-core-candy-machine-core
ソースGitHub
JS TypeDocmpl-core-candy-machine.typedoc.metaplex.com
Rust Docsdocs.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 GuardCandy Machineにコンポーザブルなアクセス制御ルール(ガード)をラップする別のオンチェーンプログラム
ガードミントプロセスを制限または変更する単一のモジュラールール(例:支払い、タイミング、許可リスト)
ガードグループ異なるオーディエンスに異なるミント条件を適用するためのガード設定の名前付きセット
アイテムミント前にCandy Machineにロードされる名前とメタデータURIのペア
Core AssetMetaplex Core NFT -- ビルトインプラグインサポートを持つ単一アカウントのデジタルアセット
ミント権限ミントをトリガーする権限を持つアカウント。通常はCandy Guardアカウントに設定
コレクションCandy Machineからミントされるすべてのアセットに割り当てられるオンチェーンコレクションアドレス

次のステップ

  1. SDKセットアップ -- JavaScriptまたはRustを選択してSDKをインストール
  2. Core Candy Machineの作成 -- 設定を構成してデプロイ
  3. アイテムの挿入 -- アセットメタデータをマシンにロード
  4. ガードの設定 -- 支払い、タイミング、アクセスルールを設定
  5. Core Assetsのミント -- ミントフローを理解する