给支付智能体加五项独立校验
文章借助 Base 链上约 380 万笔支付记录,演示如何在模型之外设置五项支付检查。示例通过 HTTPS 返回 JSON,无需账号或密钥。
AI 深度解读
给 AI Agent 接上钱包后,最后一道付款审批应该放在哪?Agentic Finance Graph 团队的答案是放在模型之外,由支付代码在签名前查链上事实、执行预算规则。网页内容可能诱导模型发起付款,相似地址也可能让它付错钱,独立检查可以在交易签名之前拦下这类请求。
作者用一份约 380 万笔付款的 Base 账本演示了五项免费检查。最值得看的是两笔相隔几秒的 40 美元请求,以及第二笔为何会在第一笔尚未上链时就被拒绝。
第一笔还没上链,第二笔怎么拦
Agentic Finance Graph 从 Base 上的 ERC-8004 注册记录出发,追踪绑定钱包在注册后的付款。作者在 2026 年 11 月 17 日统计到约 5,877 万美元,其中约 2,695 万美元(46%)进入付款方仍持有的借贷或金库仓位,约 3,183 万美元离开付款方控制。单笔付款中位数是 0.05 美元。用 npx -y agentic-finance-graph state 能查看这些指标各自的测量时间。把资金流动拆开看,才能知道有多少仍是付款方自己的资产。
付款前,客户端可以把 Agent、收款地址和美元金额发给 POST /api/gate/check。Gate 读取收款方的九项实测事实,包括地址是否像过去付过款或提供过资金的地址、到账后是否在十分钟内转走、是否是委托给资金归集程序的 EIP-7702 账户,以及通常收多少钱。它结合 Agent 的历史和调用方策略,返回 allow、log、warn 或 block 及理由。策略可以用 AP2 约束词汇表达允许的收款方、金额范围、预算和重复付款周期,也可以给新收款方单独设上限。遇到未知约束时,Gate 会在规则运行前拒绝请求,避免拼错字段导致限额失效。
单查已入账的付款容易漏掉连续请求。作者用此前三天的 8,146 笔付款测得,从出块到账本计入的中位延迟是 159 分钟。Gate 因此会补计同一个 client_ref 在过去 12 小时内已经获准、但还没在链上看到的金额。下面这段 Node 18+ 脚本演示了怎样用这笔待确认金额拦住拆单。
// gate-split.mjs: one agent, one address it has never paid, and a limit of $50 a day for a new payee.
// Node 18+, no dependencies, no key.
import { randomBytes } from "node:crypto";
const GATE = "https://agenticfinancegraph.com/api/gate/check";
const clientRef = randomBytes(16).toString("hex"); // in production: one fixed value from your configuration
const payee = "0x" + randomBytes(20).toString("hex"); // an address the agent has never paid
const policy = { new_payee: { max: 50, window_hours: 24 } }; // at most $50 in 24 hours to a payee that is new
async function ask(amountUsd) {
const r = await fetch(GATE, {
method: "POST",
headers: { "content-type": "application/json" },
body: JSON.stringify({ agent: "57657", payee, amount_usd: amountUsd, policy, client_ref: clientRef }),
});
const j = await r.json();
return { decision: j.decision, reasons: j.reasons, pending_usd: j.context.pending.usd, receipt: j.decision_id };
}
console.log("first $40:", await ask(40));
console.log("second $40:", await ask(40));
看 body 里的 client_ref。两次请求共用同一个值,第一次得到 allow,第二次得到 block,此时 pending_usd 是 40,理由是 new_payee_window_above_max:40+40>50/24h。中间没有实际付款。生产环境应把固定值留在模型接触不到的支付钩子配置里。不同调用方的待确认金额各自计算,获准后没有付款也会在这 12 小时内占用额度。
作者称,gate.context.v2 的规则和五项测试在编码前就已写好,五项测试都得到预期结果。回放 191 条历史决策时,结果和理由也与旧规则一致。实际拦截仍由支付代码执行。对 x402 客户端,作者给出的接入位置是本地支出检查之后、交易签名之前。
签名回执和 Pass 分别能证明什么
Gate 回执适合留作事后审计。它用 Ed25519 签下当时的 Agent、收款方、金额、策略及其哈希、决策、理由和时间。验证方从 /.well-known/afg-pass-keys.json 按 key_id 取公钥,对 receipt.canonical 的原始 UTF-8 字节检查 SHA-256 和签名,再读取签名文本里的字段。原文用 Agent 57657、25 美元和 recommended-v3 跑通了验证,两项检查都通过,决策为 allow。示例合约曾收到 1,110 个已注册 Agent 的付款,通常每笔约 10 美元。付款最终是否执行,仍要查客户端记录和链上交易。
收款方可以用 GET /api/payer?wallet=... 看付款钱包是否绑定了已注册 Agent,以及最近付款、事件和 Pass 状态。worth_a_look 为空,只表示在各指标的测量时点,账本没有发现值得标记的项目。registered_agent: false 也可能出现在实际由 Agent 使用的未绑定钱包上。查询的覆盖范围是 Base 上可观察到的注册和稳定币付款,私钥持有人身份、其他链上的钱包以及测量之后的变化都在范围之外。
GET /api/pass?agent=57657 则返回某一时点的八项检查。它看 Agent 注册后是否有付款记录、当前有无未结的有害事件、最近 30 天有无入账付款、最新一笔是否符合历史习惯、绑定钱包有无发行方冻结、是否向普通密钥地址给过无限额度授权、90 天内有无有害事件,以及过去一个月有无偏离历史习惯的付款。通过后可以拿到 JSON、JWT 或 W3C Verifiable Credential 格式的签名凭证。验签后要确认签发到过期最多 3 小时,并用验证方自己的时钟检查是否仍有效。示例返回 Agent 57657 为 9 级,规则包含 agent.pass.v3。11 月 17 日 21:32 UTC,31,426 个有评级的 Agent 中有 24,441 个持有 Pass,最常见的未通过原因是最近 30 天没有入账付款。
告警给了理由,命中率该怎么看
GET /api/self-check?agent=57657 汇总评级、Pass、最新一笔付款的 Watch 结果、近 30 天的授权、检测记录,以及私钥失窃时在某个区块可控制的资产范围。GET /api/fleet?agents=57657,45978,99924 一次最多查 60 个,优先列出值得排查的 Agent,也能用 owner=0x... 查某个钱包持有的全部注册记录。
Watch 拿一笔付款和同一个 Agent 的历史比较,比如金额突然升高,或先给某地址转一小笔、接着转一大笔。作者称它已给 28,249 个 Agent 的 3,401,885 笔付款打分。团队在 10 月固定评估集和阈值后,识别出可评分的 15 笔有害付款中的 13 笔,以及 319 笔植入资金转移中的 301 笔。在没有已知事件的样本中,累计 47.7 个 Agent 年收到 37 次告警。
余额骤降还要读整笔交易。检测器会看钱包是否收回流出总价值的至少 90%,资产是否进入自身仓位,或是否桥接到另一条链上的同一地址。桥接追踪覆盖另外六条链。一笔交易如果同时做了兑换和对外转账,只拿兑换那部分算收回比例就容易漏报。团队还通过 Agent Books 提供签名月账单,把账单哈希写入签名日志,再用每日 Base 交易承诺日志内容。自 11 月 1 日起已有 18 笔此类交易,公开规则变更登记有 81 条。一支外部团队编写了独立验签器,另一支逐行重跑了公开样本。
作者用 curl -s https://agenticfinancegraph.com/api/x402-submitters 展示了另一个统计口径。到 11 月 17 日 08:48 UTC 的 24 小时里,Base 上列入 x402 Bazaar 的卖家地址收到 611,295 笔稳定币转账,前一天为 236,903 笔。等距抽取的 2,500 笔里,一个卖家收了 2,219 笔(89%),其余由 55 个卖家分摊。样本中有 2,484 笔使用签名授权,其中 2,478 笔由 facilitator 代为提交上链。计数对象是转入卖家地址的转账,样本比例也主要反映头部卖家的做法。
我的判断
把金额上限和最终签名权交给支付代码,是这篇最扎实的建议。对于只有固定供应商和固定额度的团队,本地白名单加预算已经能处理很多情况,规则也更容易验证。外部 Gate 的增量在于查陌生地址、参考链上行为,以及留下一份独立签名的决策记录。原文给出了串行拆单的实测和历史回放,并发请求、超时重试和未付款检查长期占额时的表现还缺数据。24 小时的新收款方规则和 12 小时的待确认记录也是两个时间窗口,不能从这次演示推出全天任意间隔都能拦住。
Watch 的结果适合拿来安排排查顺序。真实有害样本只有 15 笔可评分,植入样本能展示规则对指定模式的覆盖,作者也没有给出和固定金额阈值的对照。至于密钥泄漏,如果攻击者能直接用密钥签名,就能绕开客户端钩子。此时自查能帮助估算暴露范围,签名权限本身还得靠钱包和签名服务控制。
能拿来做什么
- 给 x402 或 Node 支付客户端加签名前钩子,先执行本地预算和白名单,再读取 Gate 的结构化决策。把
client_ref放在服务端配置里,签名服务按预先设定的规则处理warn和block。 - 用测试钱包发两次同一收款方的 40 美元检查请求,再测并发、超时重试和获准后取消。逐项核对你自己的预算记录和
pending_usd,确认同一请求重试时怎样记账。 - 把签名回执、内部付款请求和链上交易哈希关联起来。后台在展示 Pass 或 Watch 结果时,同时展示测量时间和触发理由,方便值班人员判断该查哪一笔交易。