Metaplex

紹介

MPL-Distro

Last updated August 27, 2026

MPL-Distro は、既存の SPL トークン をウォレットまたは レガシー NFT 保有者のリストへ配布する Solana プログラムです。受取人リスト全体ではなく、コンパクトな Merkle ルートをオンチェーンに保存します。

概要

MPL-Distro は受取人リストを 1 つのオンチェーン Merkle ルートとしてコミットし、トークンをボールトに保持し、各成功クレームを記録して再利用できないようにします。

  • 受取人リスト全体をオンチェーンに保存せず、既存の SPL トークン mint を配布します。
  • ウォレットアドレス、または特定のレガシー NFT mint の現在の保有者を対象にします。
  • Permissionless、recipient のみ、または permissioned のクレーム送信を選べます。
  • クレーム期間後に未クレームトークンと未使用のレシート家賃補助金を回収します。

配布を構築する

ウォレット配布を作成、資金投入、クレームします。

本番でクレームを届ける

証明を保存し、クレームページまたは API を運用し、未クレームトークンを回収します。

配布タイプを選ぶ

ウォレットとレガシー NFT の割り当てモデルを比較します。

CLI

ターミナルから配布の作成、資金投入、確認、回収を行います。

MPL-Distro の配布モデル

Merkle ツリーは受取人リストを 1 つの 32 バイトハッシュ（ルート）にします。各受取人はそのリストに含まれることを短い証明で示せるため、リスト全体をオンチェーンに置く必要はありません。

  1. 配布権限者が、各受取人、amount、任意の nonce を含むオフチェーンリストを構築します。
  2. prepareDistribution が Merkle ルートと割り当てごとの証明を作成します。
  3. createDistribution がルート、クレーム期間、mint、アクセス規則を保存します。
  4. deposit がトークン割り当て全体を配布の associated token account へ転送します。
  5. distribute または distributeToLegacyNft が証明を検証し、永続的なクレームレシートを作成します。
  6. withdraw が配布が非アクティブになった後に未クレームトークンを返します。

クレームデータを保存する

プログラムが保存するのは Merkle ルートだけであり、受取人リストや証明は保存しません。各割り当てのアドレス、amount、nonce、証明をデータベースまたはダウンロード可能なクレームファイルに残してください。

MPL-Distro の配布タイプ

MPL-Distro はウォレットアドレス割り当てとレガシー NFT mint 割り当てを、別々のクレーム命令でサポートします。

配布タイプMerkle リーフの identityクレーム命令最適な用途
Walletウォレットまたはその他の公開鍵distribute手当、貢献者報酬、直接トークンエアドロップ
LegacyNftレガシー NFT mintdistributeToLegacyNftNFT の現在のトークンアカウント所有者がクレームする報酬

LegacyNft タイプは、リストされた NFT mint を現在所有するウォレットへ支払います。対象 NFT と所有権の確認は レガシー NFT 配布 を参照してください。

MPL-Distro の Allowed Distributor モード

Allowed distributor モードは、有効な Merkle クレームトランザクションを誰が送信できるかを制御します。

モード必須の署名者動作
Permissionless任意の支払者サービスまたは第三者が受取人の代わりにクレームを送信できます
Recipient受取人ウォレットまたはレガシー NFT 所有者受益者がクレームを承認する必要があります
Permissioned設定された distributor指定された 1 つの distributor だけがクレームを送信できます

Permissionless 送信はトークンの行き先を変えません。プログラムは常に受取人の正規 associated token account へ割り当てを送ります。

MPL-Distro のプロトコル手数料

成功した Merkle クレームはプロトコル手数料を課し、クレームトランザクションの支払者が支払います。

インストラクションSolana
distribute / distributeToLegacyNft0.002 SOL*

* Receipt subsidies do not cover this fee.

Metaplex プログラム全体の現行額は プロトコル手数料 を参照してください。

注意事項

MPL-Distro のオンチェーンチェックはクレームを保護しますが、オフチェーンの割り当て検証の代わりにはなりません。

  • totalClaimants はメタデータであり、有効な証明数の上限ではありません。
  • 入金はすべての Merkle 割り当ての合計と照合されません。クレーム開始前に十分なトークンをボールトへ入れてください。
  • クレームレシートはクローズされないため、家賃は割り当てられたままです。
  • プログラムは Token-2022 ではなくオリジナル SPL Token プログラムを対象とします。
  • MPL-Distro はベスティング、ストリーミング、部分クレーム、構造化プログラムイベントを提供しません。

FAQ

MPL-Distro は何に使いますか？

MPL-Distro は既存の SPL トークン割り当てを、ウォレットアドレスまたはレガシー NFT mint の固定リストへ Merkle 証明で配布します。

MPL-Distro はトークンローンチパッドですか？

いいえ。MPL-Distro は既存 mint を配布します。トークン生成イベント、セール、Launch Pool、ボンディングカーブが必要な場合は Genesis を使います。

受取人の代わりに誰かがトランザクション手数料を払えますか？

はい。Permissionless 配布では任意の支払者が受取人の有効なクレームを送信できます。Recipient と Permissioned モードは送信できる主体を制限します。

MPL-Distro はベスティングに対応していますか？

いいえ。MPL-Distro は各 Merkle 割り当てを 1 回のクレームで解放します。スケジュール型のプロジェクト割り当てには Genesis のプロジェクトベスティング を使います。

用語集

MPL-Distro は Merkle 証明と決定的アカウントでトークン割り当てを検証し記録します。

用語定義
Distributionトークン mint、Merkle ルート、期間、権限者、クレーム合計を含むプログラムアカウント
Distribution authority設定の更新、トークン入金、未クレーム資金の回収ができるウォレット
Merkle treeオンチェーンルートと割り当てごとの証明を生成するオフチェーン構造
Merkle rootオフチェーン割り当てリスト全体への 32 バイトコミットメント
Merkle proof1 つの割り当てがコミット済みツリーに属することを示す兄弟ハッシュ
Claim receipt1 つの (distribution, recipient, amount, nonce) 割り当てがクレームされたことを示す PDA
Nonceそれ以外は同一の受取人と amount のリーフを区別する数値
Token base unitsmint の最小単位。decimals が 6 のトークンは 1.0 トークンあたり 1_000_000 単位
Receipt subsidyクレームレシート家賃を補填するために配布 PDA が任意で保持する SOL
Next
はじめに