概要

概要

mplx distro コマンドは、ターミナルから MPL-Distro 配布の作成、資金投入、確認、回収を行います。

• ツール: Metaplex CLI（mplx）の distro コマンドグループ
• クライアント: 現行プログラムに対して @metaplex-foundation/mpl-distro 0.4.x が必要
• オンチェーン作業: 配布 PDA の作成、トークン入金、余り出金、アカウントデータの取得
• オフチェーン作業: Merkle ルート、証明、クレームは JavaScript SDK 側

ジャンプ先: 前提条件 · 一般的なフロー · コマンドリファレンス · Merkle ルートのエンコード · 一般的なエラー · FAQ · 用語集

前提条件

MPL-Distro CLI コマンドには、資金のある identity、既存のオリジナル SPL Token mint、32 バイトの Merkle ルートが必要です。

• @metaplex-foundation/mpl-distro 0.4.x 向けにビルドされ、PATH にある Metaplex CLI
• mplx config で設定した Solana キーペア（配布の権限者）
• 家賃とトランザクション手数料用の SOL
• 既存の SPL トークン mint（Token-2022 ではない）と、入金用に資金のある associated token account
• mplx config rpcs add または -r による RPC エンドポイント

コマンドグループを確認します。

mplx distro --help

一般的なフロー

権限者のセットアップは CLI で行います。受取人は証明を保存するアプリからクレームします。

1. 割り当て — JavaScript SDK の prepareDistribution で受取人リストを構築し、Merkle ルートを生成します。すべてのアドレス、amount、nonce、証明を永続化します。
2. 作成 — mplx distro create がルート、クレーム期間、mint、アクセスモードをオンチェーンに書き込みます。
3. 入金 — mplx distro deposit がトークンを配布ボールトへ移します。入金はいつでも可能です。
4. クレーム — 受取人（またはリレイヤー）が保存済み証明付きで distribute / distributeToLegacyNft を送信します。CLI にクレームコマンドはありません。
5. 回収 — endTime の後（または startTime の前）に mplx distro withdraw が未クレームトークンを返します。

証明の保存とクレームページは 本番デリバリー を参照してください。

mplx distro create \
  --name "Community Airdrop" \
  --mint <TOKEN_MINT> \
  --totalClaimants 2 \
  --startTime "2026-09-01T00:00:00Z" \
  --endTime "2026-09-08T00:00:00Z" \
  --merkleRoot <BASE58_32_BYTE_ROOT>

mplx distro deposit <DISTRIBUTION> --amount 1.0
mplx distro fetch <DISTRIBUTION>
mplx distro withdraw <DISTRIBUTION> --amount 0.5

コマンドリファレンス

mplx distro は 4 つのコマンドを公開します。証明の生成もクレーム送信も行いません。

CLI は AllowedDistributor.Permissioned、updateDistribution、withdrawSubsidy、クレーム命令に対応しません。

Merkle ルートのエンコード

--merkleRoot は 32 バイトの割り当てルートを base58 でエンコードしたものであり、16 進文字列ではありません。

prepareDistribution で生成し、root バイトをエンコードします。

import { prepareDistribution } from '@metaplex-foundation/mpl-distro'
import { publicKey } from '@metaplex-foundation/umi'
import { base58 } from '@metaplex-foundation/umi/serializers'

const { root, proofs, treeHeight } = prepareDistribution([
  { address: publicKey('RecipientWallet111111111111111111111111111'), amount: 100_000n },
  { address: publicKey('RecipientWallet222222222222222222222222222'), amount: 250_000n },
])

const merkleRoot = base58.deserialize(root)[0]
console.log(merkleRoot)

--totalClaimants はそのリストの割り当て数に設定します。CLI は computeTreeHeight(totalClaimants) をオンチェーンに保存します。prepareDistribution の証明はその高さより長くてはいけません。

一般的なエラー

mplx distro でよく見られる失敗です。

注意事項

CLI は SDK で構築した Merkle 割り当てを扱う権限者向けツールです。

• mint はオリジナル SPL Token プログラム所有である必要があります。Token-2022 mint は拒否されます。
• --amount の数量は mint の decimals を使います。--basisAmount はトークンの最小単位です。
• 入金に時間制限はありません。startTime <= clusterTime <= endTime の間は出金が拒否されます。
• --allowedDistributor が受け付けるのは permissionless または recipient のみです。
• CLI はランダムな seed 署名者を生成し、seed は出力しません。create の出力から配布 PDA を保存してください。

FAQ

mplx distro は何をしますか？

mplx distro コマンドグループは MPL-Distro アカウントの作成、SPL トークンの入金と出金、オンチェーン配布情報の取得を行います。Merkle 証明の生成やクレーム送信は行いません。

現在の MPL-Distro プログラムに対応する CLI バージョンはどれですか？

オンチェーンプログラムには @metaplex-foundation/mpl-distro 0.4.x クライアントが必要です。公開済みの @metaplex-foundation/cli 0.4.3 はまだ 0.3.x に依存しており、distro create は BorshIoError で失敗します。mpl-distro 0.4.0 以降に依存する CLI ビルドを使用してください。

CLI は受取人のクレームを送信しますか？

いいえ。prepareDistribution で証明を生成し、JavaScript SDK または クレームページ から distribute または distributeToLegacyNft を送信してください。

権限者はいつトークンを引き出せますか？

開始タイムスタンプの前、または終了タイムスタンプの後です。クレーム期間中の出金は拒否されます。

用語集