用途:把任意本地 HTTP 服务通过 x402 支付协议改成付费服务,或让智能体作为买方支付其他智能体的 x402 服务。采用反向代理边车架构,网关位于用户原服务之前,买方经 402/PAYMENT-SIGNATURE 请求网关,网关再以普通 HTTP 转发到用户服务。
主要能力:支持多种计费模式,包括 pay_per_use(每次请求验证并结算)、lifetime、monthly、weekly/quarterly/yearly、prepaid 以及旧版 payperuse、subscription、metered、timepass。默认跟随平台主网全套网络,402 挑战返回多链 accepts 列表,由买方每次选择一条链支付;也可用 --networks 锁定单链。买方侧提供 discover.py、preflight.py、buy.py、client.py 等脚本,用于探测、预检和支付。
使用方式:卖方可用 python3 skills/x402/scripts/monetize.py --name my-api --upstream-port 5173 --mode pay_per_use --price 0.01 --facilitator $FAC 启动。买方先运行 discover.py 探测,再用 preflight.py 检查签名器、策略与余额,最后用 buy.py --url ... --max-usd 支付。lifetime/monthly 等模式必须提供 --facilitator-admin-token,否则启动失败。网关端口需暴露,收入默认进入用户 Privy 钱包。
适用场景与限制:适用于需要按次、订阅或预付计费的 API 与智能体间支付;免费促销最长 90 天,免费仅按钱包身份与 amount 0 验证,不等于匿名或永久免费。测试网仅限测试,主网使用平台 facilitator。Robinhood USDG 的 EIP-712 域为非标准 Diamond 代理,买方原始摘要签名仍为 TODO。其余未在资料中说明的细节暂未提供。