Polygon Agent Kit 是 Polygon 官方提供的智能体命令行工具包，用于在 Polygon 网络上执行链上操作。其入口命令为 polygon-agent，通过 npm 全局安装，要求 Node.js 20 及以上版本。
【用途】 该工具包面向需要自主管理链上资产的智能体，覆盖从钱包初始化、资金注入、日常转账与兑换，到 ERC-8004 智能体注册、信誉与反馈查询的完整流程。
【主要能力】
- 钱包管理：setup 创建 EOA 并生成 Sequence 项目与访问密钥；wallet create 创建生态钱包（主消费钱包），支持设置 USDC、原生代币、USDT 及自定义代币限额，并可白名单合约；wallet import、wallet list、wallet address、wallet remove 用于导入、列出、查询与删除钱包。
- 链上操作：balances 查询余额；send、send-native、send-token 执行转账；swap 执行兑换并支持跨链目标；deposit 支持向 Aave 或 Morpho 协议存款；fund 生成 Trails 充值链接；x402-pay 处理 x402 按次付费 API 调用。
- ERC-8004 智能体操作（仅 Polygon 主网）：agent register 注册智能体并铸造 ERC-721 NFT；agent wallet、agent metadata、agent reputation、agent reviews、agent feedback 分别查询钱包、元数据、信誉、评价并提交反馈。
【使用方式】 安装命令：npm install -g github:0xPolygon/polygon-agent-kit（更新需重新安装）。 典型流程：先运行 polygon-agent setup --name "MyAgent" 完成初始化，访问密钥自动存入 ~/.polygon-agent/builder.json 并在后续命令中自动加载，无需手动 export；再运行 polygon-agent wallet create 创建钱包（会打开浏览器等待 6 位验证码）；随后 polygon-agent fund 获取充值链接；polygon-agent balances 验证余额；最后可用 polygon-agent agent register --broadcast 注册智能体。 所有写操作默认 dry-run，需加 --broadcast 才执行。命令在非 TTY 下输出 JSON，建议以格式化 Markdown 呈现结果。
【适用场景】 适合需要让智能体自主完成 Polygon 链上钱包设置、资金管理、DeFi 兑换与存款、x402 付费调用，以及 ERC-8004 智能体身份注册与信誉交互的场景。针对特定工作流还提供子技能：Polymarket 预测市场交易（polygon-polymarket/SKILL.md）、DeFi 兑换与收益（polygon-defi/SKILL.md）、x402 发现与按次付费 API（polygon-discovery/SKILL.md）。
【限制与注意事项】 ERC-8004 智能体操作仅支持 Polygon 主网；钱包会话自创建起 6 个月过期；未设置 --usdc-limit 等限额时，会话仅获得基础默认权限，可能无法交易；deposit 若会话拒绝（合约未白名单），需用 --contract <depositAddress> 重新创建钱包；fund 必须通过命令生成链接，不可手动构造或硬编码地址；wallet create 输出的审批 URL 必须完整、未截断地传给用户。
【存储结构】 数据存放于 ~/.polygon-agent/，包含加密密钥文件、builder.json（EOA 私钥加密、地址、访问密钥、项目 ID）、wallets/<name>.json（钱包地址、会话、链 ID）以及待处理的 requests/<rid>.json。
【环境变量】 访问密钥自动加载，无需手动导出；可选覆盖项包括 SEQUENCE_PROJECT_ACCESS_KEY、SEQUENCE_ECOSYSTEM_CONNECTOR_URL、SEQUENCE_DAPP_ORIGIN、TRAILS_TOKEN_MAP_JSON、POLYGON_AGENT_DEBUG_FETCH、POLYGON_AGENT_DEBUG_FEE。
【ERC-8004 合约地址（Polygon 主网）】 IdentityRegistry：0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 ReputationRegistry：0x8004BAa17C55a88189AE136b182e5fdA19dE9b63