Agent Payments

Agent Payments 是 StableOps 的 Agent 支付控制层。运营者预先登记付款钱包、激活不可变支出策略、设置预算并签发受限 Agent Key。Agent 运行时只能在这些边界内购买收费资源。

一笔支付如何完成

1. Agent SDK 请求收费资源，并读取 HTTP 402 响应中的 x402 付款要求。
2. StableOps 控制面校验来源、收款地址、网络、资产、金额、策略和两级日预算。
3. 需要人工决定时，Intent 进入审批。通过后继续使用同一个 Intent。
4. 客户自行部署的签名器伴随服务校验短时执行授权，再使用本地密钥或 AWS KMS 签名。
5. Agent SDK 携带支付凭证重试原资源，控制面异步对账资源响应与链上结算状态。

信任边界

• Agent 运行时只持有受限 Agent Key 和伴随服务鉴权令牌，不能修改钱包、策略、预算或审批。
• 签名器只签署与 StableOps 执行授权完全一致的类型化数据，不提供任意签名接口。
• 付款钱包私钥或 KMS 权限始终留在客户环境中。
• StableOps 不代理业务请求、不广播付款交易，也不持有客户私钥。
• 支付状态与资源状态分别记录。拿到资源不等于已经确认链上结算。

软件包

支持范围

• 服务端 Node.js 20 或更高版本。不支持浏览器或边缘运行时。
• x402 v2 exact、GET 和 HTTPS 收费资源。
• 当前资产固定为下表中的 USDC；TRON 主网和 Nile 测试网暂不支持。
• 沙盒只能使用测试网，正式环境只能使用主网。正式环境默认关闭，组织完成风控与恢复演练门禁后由 StableOps 开通。

沙盒和正式环境的网络限制会在策略、钱包、支付意图和授权接口中分别校验，不能通过自行构造请求跨环境使用网络。

正式环境网络

沙盒网络

BNB Smart Chain 使用 Binance-Peg USDC，测试网使用社区锚定测试代币，不应表述为 Circle 官方 USDC。

签名器与燃料费

• EIP-3009 网络在沙盒中使用 LocalTestSigner，正式环境使用 AwsKmsSigner。x402 结算服务提交付款交易，付款钱包不需要为每笔付款准备原生代币。
• Permit2 网络的沙盒使用本地 EVM 测试签名器，正式环境使用 AWS KMS。付款钱包必须先授权规范 Permit2 合约（0x000000000022D473030F116dDEE9F6B43aC78BA3）使用 USDC。授权额度应以资金管理策略实际需要为限；广播前必须逐项核对网络、代币、被授权方和金额。该授权交易由钱包广播，因此钱包需要持有对应网络的原生代币支付燃料费；后续 x402 付款交易仍由结算服务提交。
• Solana 使用 LocalSvmSigner。结算服务的费用支付方负责交易费，付款钱包无需为了 x402 付款持有 SOL。
• AwsKmsSigner 只支持 EVM 网络。Solana 私钥必须留在客户环境，并由 LocalSvmSigner 使用。

金额单位

支付报价、审批和回执中的金额使用上表所列资产位数。策略和预算则始终使用 6 位 USDC 预算单位：1000000 表示 1 USDC。BNB Smart Chain 上 1 USDC 的支付金额为 1000000000000000000，但策略限额仍为 1000000。

从沙盒迁移到正式环境

沙盒和正式环境彼此隔离。不能在正式环境中复用沙盒的 Agent、Agent Key、钱包、策略、预算、签名器实例、授权记录存储或幂等键。

首次主网付款前应完成以下检查：

1. 完成 StableOps 组织风控审核和恢复演练，并确认正式环境已经开通、收款地址风险筛查链路健康。
2. 创建正式环境 Agent Payments 管理 API Key 和新的正式环境 Agent，在目标主网上登记并绑定专用钱包。
3. 使用 6 位预算单位重新创建策略和预算，并把生产资源来源、收款地址、网络及上表列出的 USDC 合约固定到策略中。
4. 把签名器配置为 environment: 'LIVE' 和目标主网的准确 CAIP-2 标识；每个签名器实例使用独立、持久的授权记录存储。
5. 使用 BNB Smart Chain 时核对 Permit2 授权余额和原生代币燃料费余额；所有网络都应独立核对钱包 USDC 余额。
6. 先执行一笔金额很小且需要人工审批的验证付款。确认收费资源响应、StableOps 支付与回执、签名 Webhook、结算服务结果和钱包余额全部一致后，再启用自动付款。

ak_sandbox_... Agent Key 不能访问正式环境，必须重新签发并安全保存 ak_live_... Key。主网请求返回 403 风控错误，表示组织尚未完成开通；返回 503 风险筛查错误时必须保持拒绝并升级处理，不能通过创建第二个 Intent 重试付款。

从哪里开始

• 想先查看真实 402 挑战：打开在线 x402 测试。
• 想跑通第一笔受控支付：按快速开始逐步配置。
• 已完成基础流程：继续阅读管理 SDK、签名器和 Webhook。