Agent 钱包 · Base Sepolia · x402
能自主付费、却不会超支的 agent
AI agent 拥有自己的钱包,支出上限写在智能合约里。它自己为 API 调用付费。违反规则的付款在资金动用前就被拒绝,每一笔付款和拒绝都记录在任何人都能核对的公开账本上。
状态: 开发中。合约尚未部署;部署后,实时付款会显示在这个页面上。
一笔付款如何完成
- 1
agent 调用付费 API
API 按开放的 x402 标准返回 402 Payment Required 和价格,例如 0.01 测试 USDC。
- 2
钱包检查规则
签名之前,agent 先请钱包合约授权这笔付款。合约在链上检查每一项限额,agent 无法绕过。
- 3
允许:付款结算
agent 以钱包为付款方签署标准 x402 付款,由 x402 facilitator 用测试 USDC 结算,API 随即返回数据。
- 4
拒绝:资金不动
合约把拒绝连同原因记录为公开事件。资金不动,API 也收不到钱。
每个 agent 钱包执行的规则
由运营方设定。改动从 agent 的下一笔付款起生效。
单笔上限
任何一笔付款都不能超过这个金额。
演示:1 USDC
每日预算
每天(UTC)的总支出不能超过这个金额。
演示:5 USDC
任务预算
agent 的每个任务都有自己的预算。
演示:market-research,2 USDC
收款白名单
agent 只能向名单上的地址付款。
演示:仅限演示 API
暂停开关
运营方可以一键停止所有付款。
演示:关闭
付款为什么会被拒绝
每次拒绝都带有且只带有下面一个原因,按此顺序检查。
PAUSED运营方已暂停这个 agent。INVALID_AMOUNT金额为零,或付款已过期。PAYEE_NOT_ALLOWED收款方不在 agent 的白名单上。OVER_PER_PAYMENT_CAP这笔付款超过了单笔上限。OVER_TASK_BUDGET付款后任务支出会超过任务预算。OVER_DAILY_BUDGET付款后当天支出会超过每日预算。INSUFFICIENT_FUNDS钱包里的 USDC 不够。
这个页面将会显示什么
示例数据,仅作演示。下面的内容都还没有上链。
research-bot-01
今天0.01 / 5.00 USDC
任务:market-research0.01 / 2.00 USDC
| 时间 | 付款对象 | 金额 | 结果 |
|---|---|---|---|
| 09:00:12 | api.demo.yunshu.ai/quote | 0.01 | 已付款 |
| 09:00:15 | api.demo.yunshu.ai/quote | 1.50 | 已拒绝 · OVER_PER_PAYMENT_CAP |
| 09:00:19 | unlisted-service.example | 0.01 | 已拒绝 · PAYEE_NOT_ALLOWED |
技术栈
- Solidity + Foundry
- OpenZeppelin
- x402
- USDC on Base Sepolia
- viem
- Cloudflare Workers
- Astro