Agent 代币 | Metaplex CLI

本页涵盖内容

为已注册 Agent 创建代币并将其关联到 Agent 身份：

一步完成：通过 --agentMint 和 --agentSetToken 在创建联合曲线发行时关联 Agent
两步完成：单独创建代币发行，然后用 agents set-agent-token 关联

摘要

Agent 代币是永久关联到已注册 Agent 身份的 Genesis 代币。有两种创建和关联 Agent 代币的方式——发行创建时的一步流程，或手动的两步流程。

一步完成（推荐）：genesis launch create --agentMint <ASSET> --agentSetToken
两步完成：创建发行，然后用 agents set-agent-token 关联
不可撤销：每个 Agent 身份只能有一个代币，且只能设置一次

快速开始

跳转至： 一步完成：创建带 Agent 的发行 · 两步完成：手动关联 · 常见错误 · FAQ

一步完成：创建带 Agent 的发行

创建 Agent 代币最简单的方式是在创建发行时传入 --agentMint。这将从 Agent 的 Asset Signer PDA 自动推导创作者费钱包，并可选择在同一交易中关联代币。

Create bonding curve with agent token

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 将已发行代币永久关联到 Agent。省略此标志可在不关联的情况下发行，之后再用 agents set-agent-token 关联。

同样适用于 Launchpool 发行：

Launchpool with agent

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>

详见 Launch (API) — Agent 发行。

两步完成：手动关联

如果在创建代币发行时未使用 --agentSetToken，可以之后通过 agents set-agent-token 关联。这需要 asset-signer 钱包模式。

第一步：配置 Asset-Signer 钱包

Set up asset-signer wallet

mplx config wallets add --name my-agent --type asset-signer --asset <AGENT_ASSET>
mplx config wallets set my-agent

第二步：关联代币

Link Genesis token to agent

mplx agents set-agent-token <AGENT_ASSET> <GENESIS_ACCOUNT>

不可撤销

每个 Agent 身份只能有一个代币，且只能设置一次。执行此命令前请仔细核对两个地址。

输出

Expected output

--------------------------------
  Agent Asset: <agent_asset_address>
  Genesis Account: <genesis_account_address>
  Signature: <transaction_signature>
  Explorer: <explorer_url>
--------------------------------

端到端示例

# 1. 注册新 Agent
mplx agents register --name "My Agent" \
  --description "An autonomous trading agent" \
  --image "./avatar.png"
# 记录输出中的资产地址

# 2. 创建关联到 Agent 的联合曲线代币
mplx genesis launch create --launchType bonding-curve \
  --name "Agent Token" --symbol "AGT" \
  --image "https://gateway.irys.xyz/abc123" \
  --agentMint <ASSET_ADDRESS> --agentSetToken

# 3. 验证 Agent 已关联代币
mplx agents fetch <ASSET_ADDRESS>

常见错误

错误	原因	解决方法
Agent token already set	尝试第二次设置代币	每个 Agent 身份只能有一个代币——此操作不可撤销
Agent is not owned by the connected wallet	API 尚未索引刚注册的 Agent	等待约 30 秒后重试，或检查 `agents fetch`——发行可能已成功
Not in asset-signer mode	未配置钱包即运行 `set-agent-token`	先设置 asset-signer 钱包（参见前置条件）

注意事项

一步流程（--agentMint --agentSetToken）是推荐方式——在单笔交易中处理所有操作
两步流程需要 asset-signer 模式，因为 set-agent-token 指令使用 Asset Signer PDA 作为授权方
运行 set-agent-token 前 Genesis 账户必须已存在
使用 --agentMint 时，创作者费钱包将从 Agent 的 Asset Signer PDA 自动推导

FAQ

Agent 代币设置后可以更改吗？ 不可以。每个 Agent 身份只能有一个代币，且只能设置一次。此操作不可撤销。

--agentSetToken 和 set-agent-token 有什么区别？ 它们的作用相同。--agentSetToken 在创建发行时一步完成代币关联。set-agent-token 在发行后单独关联，需要 asset-signer 模式。

为什么 set-agent-token 需要 asset-signer 模式？ set-agent-token 指令需要 Asset Signer PDA 作为授权方。asset-signer 模式让 CLI 自动推导并使用该 PDA。