云书 AI

Agent 钱包 · Base Sepolia · x402

能自主付费、却不会超支的 agent

AI agent 拥有自己的钱包,支出上限写在智能合约里。它自己为 API 调用付费。违反规则的付款在资金动用前就被拒绝,每一笔付款和拒绝都记录在任何人都能核对的公开账本上。

状态: 开发中。合约尚未部署;部署后,实时付款会显示在这个页面上。

一笔付款如何完成

  1. 1

    agent 调用付费 API

    API 按开放的 x402 标准返回 402 Payment Required 和价格,例如 0.01 测试 USDC。

  2. 2

    钱包检查规则

    签名之前,agent 先请钱包合约授权这笔付款。合约在链上检查每一项限额,agent 无法绕过。

  3. 3

    允许:付款结算

    agent 以钱包为付款方签署标准 x402 付款,由 x402 facilitator 用测试 USDC 结算,API 随即返回数据。

  4. 4

    拒绝:资金不动

    合约把拒绝连同原因记录为公开事件。资金不动,API 也收不到钱。

每个 agent 钱包执行的规则

由运营方设定。改动从 agent 的下一笔付款起生效。

付款为什么会被拒绝

每次拒绝都带有且只带有下面一个原因,按此顺序检查。

  1. PAUSED运营方已暂停这个 agent。
  2. INVALID_AMOUNT金额为零,或付款已过期。
  3. PAYEE_NOT_ALLOWED收款方不在 agent 的白名单上。
  4. OVER_PER_PAYMENT_CAP这笔付款超过了单笔上限。
  5. OVER_TASK_BUDGET付款后任务支出会超过任务预算。
  6. OVER_DAILY_BUDGET付款后当天支出会超过每日预算。
  7. INSUFFICIENT_FUNDS钱包里的 USDC 不够。

这个页面将会显示什么

示例数据,仅作演示。下面的内容都还没有上链。

research-bot-01

今天0.01 / 5.00 USDC

任务:market-research0.01 / 2.00 USDC

时间付款对象金额结果
09:00:12api.demo.yunshu.ai/quote0.01已付款
09:00:15api.demo.yunshu.ai/quote1.50已拒绝 · OVER_PER_PAYMENT_CAP
09:00:19unlisted-service.example0.01已拒绝 · PAYEE_NOT_ALLOWED

技术栈