给 AI Agent 一把「能花钱的 API Key」:额度、审批与 x402 付款的实现

0 阅读2分钟

问题:Agent 要花钱,但你不想给钥匙

Agent 调付费 API,最直接的做法是给它一个私钥。问题是:私钥没有额度、没有白名单、没有审批,出了事也没有一张能对上的账单。卡组织那条路又付不了一分钱一次的调用。

所以把两件事拆开:授权交给「钱包」,花钱交给「Key」。

一次调用实际发生了什么

POST /v1/fetch
{ "url": "https://api.nansen.ai/api/v1/token-screener", "maxPrice": "0.05" }

钱包内部的顺序是固定的:

  1. 查这把 key 的总额度、当日额度
  2. 查单笔上限与 maxPrice
  3. 查域名白名单(api.nansen.ai 才放行)
  4. 到审批线就挂起,等人在 Dashboard 点批准
  5. 通过才签 EIP-3009 授权
  6. 带支付头重发请求,拿到数据
  7. 写账单:状态、金额、链上交易哈希

为什么策略必须在签名之前

签名之后再去「对账」,本质上是在追认已经发生的付款。把检查放在签名前,有一个很实际的好处:不合规的调用一分钱都不花,链上也不留垃圾。

另一个细节是「失败不猜」。卖方返回 422 不再结算时,已经签出去的授权在过期前一直有效,所以我们把它标成冻结而不是立刻退款;等过期后去问 USDC 合约 authorizationState 确认没被用过,才把额度放回来。

实测数字

项值
真实付款5 笔 USDC,合计 $0.09,Monad 主网
链Monad / Base / Solana(默认测试网)
测试282 个离线用例
许可AGPL-3.0,v0.7.6

已知限制

  • 只做 USDC + x402,不覆盖普通订阅、也不覆盖网页结账
  • facilitator 是我们自己跑的,多一层信任面
  • 逐笔人工审批在低频场景好用,高频场景需要把审批线调高

链接

仓库:github.com/dongsheng12… 中文说明:moneyswitch.dev/blog/metrop… 自托管指南:moneyswitch.dev/pilot/zh/

image.png