SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场Polygon Agent

Polygon Agent

智能体与模型

查看项目

更新于 10-15 07:42

技能介绍

Polygon Agent 是 Polygon 官方推出的智能体命令行工具包（Polygon Agentic CLI），用于帮助 AI 智能体在 Polygon 网络上完成链上操作。

一、用途 该工具面向需要自主执行链上任务的智能体，提供从钱包建立、资金管理到 DeFi 交互、按次付费 API 调用以及链上身份注册的完整能力。

二、前置条件与安装 需要 Node.js 20+。全局安装命令：npm install -g @polygonlabs/agent-cli（重新运行同一命令即可更新）。入口命令为 polygon-agent <command>。数据存储在 ~/.polygon-agent/，采用 AES-256-GCM 加密。卸载命令：npm uninstall -g @polygonlabs/agent-cli。

三、架构与钱包类型

  • EOA：由 setup 创建，用于通过 Sequence Builder 进行认证，不需要充值。
  • Ecosystem Wallet：由 wallet create 创建，是主要的花费钱包，需要充值。

四、环境变量 SEQUENCE_PROJECT_ACCESS_KEY、SEQUENCE_INDEXER_ACCESS_KEY 与 TRAILS_API_KEY 是同一个密钥（即 setup 时创建的 Sequence 项目访问密钥），CLI 自动按别名回退读取。setup 后密钥存入 ~/.polygon-agent/builder.json，每次调用自动加载，无需手动 export。仅在需要覆盖存储值时才手动设置。可选覆盖变量包括 SEQUENCE_ECOSYSTEM_CONNECTOR_URL（默认 https://agentconnect.polygon.technology）、SEQUENCE_DAPP_ORIGIN、TRAILS_TOKEN_MAP_JSON、POLYGON_AGENT_DEBUG_FETCH、POLYGON_AGENT_DEBUG_FEE。

五、完整设置流程

  1. polygon-agent setup --name "MyAgent"：创建 EOA 与 Sequence 项目，将 privateKey、eoaAddress、accessKey 保存到 builder.json。
  2. polygon-agent wallet create：创建生态钱包，打开浏览器等待 6 位验证码。Aave V3 Pool 在所有会话中自动加入白名单；如需 Morpho 等 DeFi 金库，需按需添加 --contract 参数。会话保存到 ~/.polygon-agent/wallets/main.json。
  3. polygon-agent fund：读取会话中的 walletAddress，生成 Trails 充值链接。必须运行此命令获取 URL，不可手动构造或硬编码地址。
  4. polygon-agent balances：验证余额。
  5. polygon-agent agent register --name "MyAgent" --broadcast：在链上注册智能体（ERC-8004，仅 Polygon 主网），铸造 ERC-721 NFT 并发出含 agentId 的 Registered 事件。

六、用例子技能 针对特定工作流，需先获取并加载相应子技能：Polymarket 预测市场交易、DeFi（兑换、存款、取款、收益）、x402 发现与按次付费 API。x402 调用前须按顺序执行：读取 discovery 技能、确认钱包存在（必要时创建并充值）、用 balances 确认 USDC 可用。不要猜测端点或搜索 x402 提供商。

七、命令参考 设置：setup。 钱包：wallet create / import / list / address / remove。--chain 支持 polygon（默认主网）、amoy、mainnet、arbitrum、optimism、base；ERC-8004 智能体操作仅支持 polygon。 操作：balances、send、send-native、send-token、swap、deposit、withdraw、fund、x402-pay。 智能体（ERC-8004）：agent register / wallet / metadata / reputation / reviews / feedback。 ERC-8004 合约（Polygon 主网）：IdentityRegistry 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432；ReputationRegistry 0x8004BAa17C55a88189AE136b182e5fdA19dE9b63。

八、关键行为

  • 默认 dry-run：所有写命令需加 --broadcast 才执行。
  • 智能默认值：--wallet main、--chain polygon，wallet create 自动等待。
  • balances --chains 支持逗号分隔多链（最多 20 条），两条及以上返回带 multiChain: true 的 JSON。
  • 费用偏好：同时可用时优先选 USDC 而非原生 POL。
  • fund 返回 https://wallet.polygon.technology 作为 fundingUrl，必须运行命令获取。
  • deposit 通过 Trails getEarnPools 选择最高 TVL 池直接存入；Aave V3 Pool（0x794a61358d6845594f94dc1db02a252b5b4814ad）自动白名单。
  • Gas 预留：使用 deposit 或任何花费代币的命令时，始终预留至少 0.1 USDC 或 0.1 POL 作为 gas，切勿花光全部余额。deposit 命令自动强制 0.1 预留，其他命令需智能体自行遵守。
  • withdraw：--position 为 aToken 或 ERC-4626 金库；--amount 为 max 或底层单位。
  • x402-pay：探测端点 402 响应，智能钱包向 builder EOA 转入精确代币数量，EOA 签署 EIP-3009 支付，链从 402 响应自动检测。
  • send-native --direct：绕过 ValueForwarder 合约直接 EOA 转账。
  • 会话权限：未设置 --usdc-limit 等时，会话仅有最低默认权限，可能无法交易。
  • 会话有效期：创建后 6 个月。
  • 一次性会话设置：若用户意图涉及 DeFi，应在首次 wallet create 时一并加入所需合约，避免后续再次审批。

九、钱包创建流程（v2 Relay） wallet create 使用 Cloudflare Durable Object 中继与 6 位带外验证码，无需 cloudflared 隧道。浏览器用通过中继协商的 X25519 密钥加密已批准的会话，6 位验证码即终端输入的解密密钥。--print-url 标志用于无头或非交互环境，CLI 打印审批 URL 后立即退出，随后用 polygon-agent wallet import --code <6-digit-code> --rid <rid> 完成流程。

十、钱包审批 URL 注意事项 当 wallet create 输出 url 或 approvalUrl 字段时，必须将完整、未截断的 URL 发送给用户，不得缩短、概括或添加省略号，不得拆分到多条消息，须原样输出。

十一、结果呈现 CLI 命令输出 JSON（非 TTY）。运行后应以格式化 markdown 呈现，不要粘贴原始 JSON。balances 用表格；send/swap/deposit/withdraw 用摘要并在广播时附交易哈希与浏览器链接；fund 显示可点击链接；dry-run 结果需明确标注为模拟并提示加 --broadcast 执行；错误需提取 error 字段以清晰语句呈现。

十二、故障排查 涵盖 Builder 已配置（加 --force）、缺少访问密钥（先运行 setup）、缺少钱包、会话过期（6 个月）、费用选项错误、审批超时（--timeout 600）、验证码错误（3 次尝试）、中继请求未找到、存款会话被拒（需同时白名单代币与池地址）、跨链 withdraw 会话问题、Trails 收款地址错误（运行 fund）、x402 各类错误等。

十三、文件结构 ~/.polygon-agent/ 下包含 .encryption-key（AES-256-GCM 密钥，0600）、builder.json（加密私钥、eoaAddress、accessKey、projectId）、wallets/<name>.json（walletAddress、session、chainId、chain）、requests/<rid>.json（待处理钱包创建请求，导入成功后删除）。