Nick Stavros

我将向你展示一个正在运行的 x402 服务的实际底层实现——包括只有真实支付才暴露出来的两个 bug,以及我们在第一天就修复的定价错误。

快速披露:该服务由 Conway(一个我监督的、基于 Claude 的自主代理)设计、编码并部署。我不是开发者;代理写了每一行代码,我负责审批任何不可逆的操作。这也是实验的一部分。

问题

每笔交易都始于一个没人预算的问题:我在给谁付款? 向一个 Base 地址发送资金通常意味着粘贴十六进制字符串并祈祷。链上知道该地址是合约还是钱包、它是否被使用过、它持有什么资产——但直到 x402 出现之前,还没有一种方式能按请求打包这些信息,并让机器无需 API Key 注册即可付费。

因此:Conway Address Intel——GET /report/{address} 以 0.02 USDC 的价格通过 HTTP 402 内联支付返回一份结构化的尽职调查报告。一个免费的 /overview/{address} 则返回预览(合约 vs 钱包、是否持有资金、活动区间),无需任何钱包。

整个支付层只需约 10 行代码

借助 x402-express,中间件会用签名条款响应 402,通过 facilitator 验证买家的 USDC 授权,并在你的处理器响应后完成结算:

import { paymentMiddleware } from "x402-express";
import { facilitator } from "@coinbase/x402"; // mainnet, auth via CDP keys

app.use(paymentMiddleware(
  PAY_TO_WALLET,
  { "GET /report/*": { price: "$0.02", network: "base" } },
  facilitator,
));

Enter fullscreen mode Exit fullscreen mode

买家端使用 x402-fetch 同样简短:

import { wrapFetchWithPayment } from "x402-fetch";
import { privateKeyToAccount } from "viem/accounts";

const payFetch = wrapFetchWithPayment(fetch, privateKeyToAccount(KEY));
const res = await payFetch("https://.../report/0x4200...0006");
// 402 → sign EIP-3009 USDC auth → retry → 200. Buyer needs zero ETH; facilitator pays gas.

Enter fullscreen mode Exit fullscreen mode

只有真实支付才会暴露的三个问题

1. 结算发生在你的处理器响应之后 我们在处理器内记录收据,但每一笔真实支付都被记录为“SIMULATED”——结算头信息当时还不存在。修复方法:在 res.on("finish") 中读取 X-PAYMENT-RESPONSE。我们第一次真正的 testnet 结算在账本中永远被错误标记,之后追加了一条更正记录。账本不可编辑。

2. 在支付层之前进行验证,否则买家可能为垃圾数据付费。 中间件顺序很重要:我们的地址验证运行于 paymentMiddleware 之前,因此 GET /report/0xNOTANADDRESS 会收到 400 响应,提示“你尚未被收费”——这在结构上是正确的,因为条款甚至从未被提供。

3. 用真实资金测试失败路径。 我们将服务指向一个失效的 RPC 并发起真实的(testnet)支付尝试:处理器返回 503,中间件——仅对 2xx 响应进行结算——从未向买家收费。“失败的请求不会被收费”这一说法现在已被实际验证,而非仅是期望。

定价经验

我们最初以 0.50 美元/报告的价格上线。随后我们观察到:x402 服务普遍集中在 0.02–0.03 美元/次。定价为中位数的 20 倍,没有人会冲动测试你——而当你的买家是其他人的代理时,冲动测试正是整个漏斗的顶部。我们将价格调整为 0.02 美元,并提供免费预览。边际成本接近零(纯 RPC 读取),因此任何价格的每次调用都是利润;关键在于量级与集成,而非加价。

发现的鸡生蛋困境

有趣的是:主要的 x402 发现索引(Bazaar)会在你首次结算时自动收录——没有提交表单。因此,一个全新的服务需要它的第一个付费客户才能被其他付费客户发现。我们的解决方案:提供一个无需资金即可集成的免费端点、在 /.well-known/x402 提供机器可读的清单、一个诚实的 /status 页面(计数器在每次部署时重置——页面已说明),并出现在 x402 构建者实际交流的地方。

立即免费试用

curl https://conway-address-intel-production.up.railway.app/overview/0x420000im0000000000000000000000000000000006

Enter fullscreen mode Exit fullscreen mode

完整报告通过任意 x402 客户端只需 2 美分。清单:/.well-known/x402 · 状态:/status · FAQ:/faq

诚实的范围,简要说明:仅提供公开在链上的实时数据。不是安全审计,不是诈骗检测,也不是财务建议。如果你的 x402 客户端在我们的 402 流程中遇到问题,请告诉我——代理会快速修复。

截至发布时,该服务已结算的主网美元金额为零——我们第一位买家的 2 美分将真正把我们载入地图(Bazaar 在首次结算时建立索引)。想要在 AI 代理的追加式账本中留下永久记录吗?机会就在眼前。

web3 #base #x402 #agents