核心功能与用法
AgentWalletApi 是一套面向 AI 代理的加密货币钱包 API，允许程序化管理以太坊钱包资产。核心能力包括：
1. 钱包发现与管理
通过 /api/agent/wallets 获取托管钱包列表，包含钱包 ID、标签、地址及网络信息，支持多钱包策略管理。
2. 余额查询
POST /api/agent/token-balance 可同时查询 ETH 及全部 ERC-20 代币余额，支持 USDC、USDT、DAI、WETH、WBTC、UNI、LINK 等主流资产。
3. 资产转账/api/agent/transfer 支持两种转账模式：
- 直接转账 ETH：指定
amount为可读的以太单位（如 "0.01"） - 代币转账：通过
token参数指定符号（如 "USDC"），amount为代币标准单位（如 "100"）
4. 网络与代币支持
通过 /api/agent/supported-tokens 查询各网络支持的代币清单，注意不同网络代币可用性存在差异。
显著优点
- 简化开发：封装以太坊节点交互细节，无需直接处理 ABI、gas 估算、nonce 管理
- 人性化参数：支持
amount人类可读值，自动处理小数位转换 - 多钱包架构：支持标签化管理，便于区分用途（如 "Trading Bot"、"Treasury"）
- 安全策略内置：支持白名单地址限制、单笔交易额上限等治理策略
潜在缺点与局限
- 中心化托管：私钥由 AgentWalletApi 托管，存在平台风险，非自主托管方案
- 网络受限：仅支持以太坊及兼容网络，不支持比特币、Solana 等主流链
- 功能待完善：swap、approve、quote 等 DeFi 核心功能标记为 501（未实现）
- 费用结构：默认收取 1% 平台手续费，高于部分竞争对手
- gas 依赖：发送 ERC-20 仍需 ETH 支付 gas，对纯代币钱包需额外管理
适合人群
- 需要快速集成加密支付能力的 AI Agent 开发者
- 接受托管方案、重视开发效率的自动化交易系统
- 需要多钱包策略管理的企业/机构用户
- 不适合：追求极致去中心化、要求完全自主托管的 DeFi 高级用户
常规风险提示
- 托管风险：平台若遭遇攻击或停运，可能导致资产损失
- API 密钥泄露：
X-Agent-Key一旦泄露，攻击者可转移全部资金 - 策略误配置：白名单或限额设置错误可能导致交易失败或资金锁定
- 网络确认延迟：链上交易需等待确认，API 返回 txHash 不代表最终上链成功
- gas 价格波动：高峰期可能因 gas 不足导致交易 pending 或失败