プログラム
エージェントトークン
Last updated April 9, 2026
実行内容
登録済みエージェントのトークンを作成してエージェントIDにリンクします：
- 1ステップ:
--agentMintと--agentSetTokenを使ってエージェントにリンクされたボンディングカーブのローンチを作成する - 2ステップ: 個別にトークンローンチを作成し、その後
agents set-agent-tokenでリンクする
Summary
エージェントトークンは、登録済みエージェントIDに永続的にリンクされたGenesisトークンです。エージェントトークンを作成してリンクする方法は2つあります — ローンチ作成時の1ステップフロー、または2ステップの手動フローです。
- 1ステップ（推奨）:
genesis launch create --agentMint <ASSET> --agentSetToken - 2ステップ: ローンチを作成してから
agents set-agent-tokenでリンクする - 取り消し不可: 各エージェントIDが持てるトークンは1つのみで、一度しか設定できない
クイックスタート
ジャンプ: 1ステップ：エージェントでローンチ · 2ステップ：手動リンク · よくあるエラー · FAQ
1ステップ：エージェントでローンチ
エージェントトークンを作成する最もシンプルな方法は、ローンチ作成時に --agentMint を渡すことです。これはエージェントのAsset Signer PDAからクリエイター手数料ウォレットを自動導出し、オプションで同じトランザクションでトークンをリンクします。
mplx genesis launch create --launchType bonding-curve \
--name "Agent Token" \
--symbol "AGT" \
--image "https://gateway.irys.xyz/abc123" \
--agentMint <AGENT_CORE_ASSET_ADDRESS> \
--agentSetToken
--agentSetTokenは取り消し不可
--agentSetToken はローンチされたトークンをエージェントに永続的にリンクします。リンクせずにローンチする場合は省略し、後で agents set-agent-token でリンクしてください。
ローンチプールのローンチでも使用できます：
mplx genesis launch create \
--name "Agent Token" \
--symbol "AGT" \
--image "https://gateway.irys.xyz/abc123" \
--agentMint <AGENT_CORE_ASSET_ADDRESS> \
--agentSetToken \
--tokenAllocation 500000000 \
--depositStartTime 2025-03-01T00:00:00Z \
--raiseGoal 250 \
--raydiumLiquidityBps 5000 \
--fundsRecipient <WALLET_ADDRESS>
詳細はローンチ（API）— エージェントローンチを参照してください。
2ステップ：手動リンク
--agentSetToken なしでトークンローンチを作成した場合、agents set-agent-token を使って後からリンクできます。これにはasset-signerウォレットモードが必要です。
ステップ1：Asset-Signerウォレットの設定
mplx config wallets add --name my-agent --type asset-signer --asset <AGENT_ASSET>
mplx config wallets set my-agent
ステップ2：トークンのリンク
mplx agents set-agent-token <AGENT_ASSET> <GENESIS_ACCOUNT>
取り消し不可
各エージェントIDが持てるトークンは1つのみで、一度しか設定できません。このコマンドを実行する前に両方のアドレスを十分に確認してください。
出力
--------------------------------
Agent Asset: <agent_asset_address>
Genesis Account: <genesis_account_address>
Signature: <transaction_signature>
Explorer: <explorer_url>
--------------------------------
エンドツーエンドの例
# 1. 新しいエージェントを登録する
mplx agents register --name "My Agent" \
--description "An autonomous trading agent" \
--image "./avatar.png"
# 出力からアセットアドレスをメモする
# 2. エージェントにリンクされたボンディングカーブトークンをローンチする
mplx genesis launch create --launchType bonding-curve \
--name "Agent Token" --symbol "AGT" \
--image "https://gateway.irys.xyz/abc123" \
--agentMint <ASSET_ADDRESS> --agentSetToken
# 3. エージェントにトークンがリンクされているか確認する
mplx agents fetch <ASSET_ADDRESS>
よくあるエラー
| エラー | 原因 | 対処法 |
|---|---|---|
| Agent token already set | 2回目のトークン設定を試みた | 各エージェントIDが持てるトークンは1つのみです — 取り消し不可です |
| Agent is not owned by the connected wallet | APIが新しく登録されたエージェントをまだインデックスしていない | 約30秒待ってから再試行するか、agents fetch で確認してください — ローンチは成功している可能性があります |
| Not in asset-signer mode | ウォレットを設定せずに set-agent-token を実行した | 先にasset-signerウォレットをセットアップしてください（前提条件を参照） |
Notes
- 1ステップフロー（
--agentMint --agentSetToken）が推奨です — 1つのトランザクションですべて処理します - 2ステップフローでは
set-agent-tokenインストラクションがオーソリティとしてAsset Signer PDAを使用するため、asset-signerモードが必要です set-agent-tokenを実行する前に、Genesisアカウントがすでに存在している必要があります--agentMintを使用すると、クリエイター手数料ウォレットはエージェントのAsset Signer PDAから自動的に派生されます
FAQ
設定後にエージェントトークンを変更できますか？ いいえ。各エージェントIDが持てるトークンは1つのみで、一度しか設定できません。この操作は取り消せません。
--agentSetToken と set-agent-token の違いは何ですか？ 両方とも同じことをします。--agentSetToken はローンチ作成時にトークンを1ステップでリンクします。set-agent-token はローンチ後に個別にリンクし、asset-signerモードが必要です。
set-agent-token にasset-signerモードが必要なのはなぜですか？ set-agent-token インストラクションにはオーソリティとしてAsset Signer PDAが必要です。asset-signerモードはCLIがこのPDAを自動的に派生・使用するよう設定します。