Agent
POST为 Agent 注资
Last updated August 1, 2026
构建一个交易，将 SOL 从发送方钱包转账到 Agent 的签名者 PDA 钱包，并附带链上备注。任何人都可以为任何 Agent 注资。
Summary
- 将 SOL 转账到 Agent 的钱包 PDA（由服务端根据 Agent 地址解析）
- 附加一条必需的、由发送方签名的备注指令，用于归因
- 返回未签名的交易，由发送方签名并提交
Quick Reference
| 项目 | 值 |
|---|---|
| 方法 | POST |
| 路径 | /agents/{address}/fund |
| 认证 | 无需 |
| 响应 | 序列化交易 |
端点
POST /agents/{address}/fund
路径参数
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
address | string | 是 | Agent 的 Core 资产铸造地址（base58）。 |
请求体
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
sender | string | 是 | 发送 SOL 的钱包（base58）。为交易签名。 |
amount | number | 是 | 以 SOL 为单位的金额。必须为正数。 |
memo | string | 是 | 记录在链上的备注，1–256 个字符。 |
network | string | 否 | solana-mainnet（默认）或 solana-devnet。 |
请求示例
curl -X POST "https://api.metaplex.com/v1/agents/7nE9GvcwsqzYcPUYfm5gxzCKfmPqi68FM7gPaSfG6EQN/fund" \
-H "Content-Type: application/json" \
-d '{
"sender": "4Nd1mYvJ9jVexjIXG5oJhanoGWyF7Cz6XkY8dEc4RsyG",
"amount": 0.5,
"memo": "Operating budget for July"
}'
响应
{
"success": true,
"tx": "<base64-encoded transaction>",
"blockhash": {
"blockhash": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
"lastValidBlockHeight": 123456789
}
}
发送方对交易进行反序列化、签名并提交 — 请参阅签名和提交。
错误
| 状态码 | 响应体 | 含义 |
|---|---|---|
400 | { "success": false, "error": "Invalid input data" } | 请求体验证失败（公钥无效、金额非正数、缺少备注）。 |
404 | { "success": false, "error": "Agent not found" } | 在指定网络的该地址上没有注册的 Agent。 |
500 | { "success": false, "error": "Failed to prepare fund transaction" } | 服务器错误。 |