概要

概要

mplx genesis コマンドを使用すると、ターミナルから Genesis トークンローンチの全工程を実行できます。アカウントの作成、bucket の設定、入金、請求、権限の取り消しが含まれます。

• ツール: Metaplex CLI（mplx）の genesis コマンドグループ
• bucket タイプ: Launch Pool（比例配分）、Presale（固定価格）、unlocked（トレジャリー）
• Quote token（手動フロー）: デフォルトは Wrapped SOL、任意の SPL token mint アドレスに対応
• Quote token（API フロー）: 現在 SOL または USDC のみ対応
• 不可逆な操作: finalize と revoke は元に戻すことができません

対象外

Genesis スマートコントラクトの内部構造、SDK/TypeScript 統合、フロントエンド開発、トークンエコノミクスの設計、ローンチ後の流動性プールのセットアップ。

Metaplex Foundation によるメンテナンス · 最終確認 2026年2月 · Metaplex CLI（mplx）が必要

前提条件

• Metaplex CLI がインストールされ、PATH に設定されていること
• Solana キーペアファイル（例: ~/.config/solana/id.json）
• トランザクション手数料用の SOL
• mplx config rpc add で設定された RPC エンドポイント、または -r で渡すこと

セットアップを確認：

mplx genesis --help

一般的なフロー

Genesis CLI でトークンをローンチするには2つの方法があります：

API フロー（推奨）

genesis launch create を使用すると、Genesis API を呼び出してトランザクションを構築・署名し、Metaplex プラットフォームにローンチを登録する、オールインワンのフローを実行できます。API を通じて作成されたローンチは metaplex.com と互換性があり、公開ローンチページとしてプラットフォームに表示されます。

mplx genesis launch create \
  --name "My Token" --symbol "MTK" \
  --image "https://gateway.irys.xyz/abc123" \
  --tokenAllocation 500000000 \
  --depositStartTime 2025-03-01T00:00:00Z \
  --raiseGoal 200 --raydiumLiquidityBps 5000 \
  --fundsRecipient <WALLET_ADDRESS>

詳細は Launch（API） を参照してください。

手動フロー

すべてのステップを完全にコントロールする場合：

1. 作成 — genesis create で Genesis アカウントとトークン mint をセットアップします。
2. bucket の追加 — トークンの配布方法を定義するために1つ以上の bucket を追加します。比例配分には bucket add-launch-pool、固定価格販売には bucket add-presale、チーム/トレジャリー割り当てには bucket add-unlocked を使用します。
3. ファイナライズ — genesis finalize で設定をロックします。このステップ以降は bucket を追加できません。
4. 入金 — ユーザーは入金ウィンドウ中に genesis deposit または genesis presale deposit を使用して quote token（例: Wrapped SOL）を bucket に入金します。
5. 出金（オプション） — ユーザーは入金期間中に genesis withdraw で Launch Pool から出金できます。
6. トランジション（オプション） — Launch Pool に終了動作がある場合、入金終了後に genesis transition を呼び出して収集されたトークンを宛先 bucket に転送します。
7. 請求 — 請求期間が開始した後、ユーザーは genesis claim または genesis presale claim で base token を請求します。トレジャリーウォレットは genesis claim-unlocked を使用します。
8. 取り消し（オプション） — genesis revoke でトークンの mint 権限および/または freeze 権限を永久に取り消します。

手動フローを使用し、公開ローンチページが必要な場合は、genesis launch register を使用して genesis アカウントを Metaplex プラットフォームに登録してください。

genesis fetch と genesis bucket fetch を使用して、いつでもローンチの状態を確認できます。

コマンドリファレンス

注意事項

• totalSupply と allocation は base units で指定します — 小数点以下9桁の場合、1000000000000000 = 1,000,000 トークン
• 入金額と出金額は quote token の base units で指定します（SOL の場合は lamports、1 SOL = 1,000,000,000 lamports）
• SOL を quote token として使用する場合、まず mplx toolbox sol wrap <amount> でラップしてください
• ファイナライズは不可逆です — genesis finalize を実行する前にすべての bucket 設定を再確認してください
• 任意のコマンドの完全なフラグドキュメントは mplx genesis <command> --help で確認できます
• コンセプト、ライフサイクルの詳細、SDK ガイドについては Genesis ドキュメント を参照してください

一般的なエラー

FAQ

mplx genesis コマンドとは何ですか？ mplx genesis コマンドグループを使用すると、ターミナルから Genesis トークンローンチの全工程を実行できます。アカウントの作成、bucket の設定、入金、請求、権限の取り消しが含まれます。

Genesis の bucket タイプにはどのような種類がありますか？ Genesis には3つの bucket タイプがあります：Launch Pool（入金額に基づく比例配分）、Presale（固定価格のトークン販売）、unlocked（直接請求できるチーム/トレジャリー割り当て）。

入金前に SOL をラップする必要がありますか？ はい。SOL を quote token として使用する場合、bucket に入金する前に mplx toolbox sol wrap <amount> でラップしてください。

ファイナライズを元に戻すことはできますか？ いいえ。ファイナライズは不可逆です。ファイナライズ後は bucket の追加ができなくなり、設定がロックされます。genesis finalize を実行する前にすべてを再確認してください。

トークン量はどのように指定しますか？ すべての金額は base units で指定します。小数点以下9桁の場合、1,000,000 トークン = 1000000000000000 base units です。入金額は quote token の base units（SOL の場合は lamports、1 SOL = 1,000,000,000 lamports）を使用します。

同じタイプの bucket を複数持つことはできますか？ はい。--bucketIndex フラグを使用して、同じタイプの各 bucket に異なるインデックスを指定してください。

用語集