SuperAPI AI 工具集

pay-with-app

通用与其它

查看项目

更新于 10-15 19:48

技能介绍

用途:处理 OKX Agent Payments Protocol(APP,构建于 x402 之上)在 X Layer(链 196)上发出的 HTTP 402 支付挑战。APP 的 Pay Per Use(OKX 产品名 Instant Payment)与 x402 兼容:收款服务器返回 402 及支付要求,付款方离线签署 EIP-3009 TransferWithAuthorization,OKX 的 facilitator 验证并在链上结算,付款方在 X Layer 上零 gas。

主要能力:检测网络解析为 X Layer 的 402 挑战;校验付款钱包是否持有所需资产(通常为 USDT0);不足时通过 Uniswap Trading API 路由并跨链桥接为 X Layer 上的 USDT0;签署 EIP-3009 授权;构造 X-PAYMENT 载荷并重试原请求。v1.0.0 仅支持 exact 方案,其他 x402 方案(upto、batch-settlement)及 OKX 的 escrow、session、Batch Payment 等不在范围内,遇到非 exact 方案会干净拒绝。

使用方式:需 PRIVATE_KEY 环境变量(切勿提交或硬编码)、UNISWAP_API_KEY(仅在需跨链注资时)、jq 与 cast(Foundry)、Node 18+、viem。流程为解析 402 挑战、确认链 196、检查余额、必要时注资、逐笔用户确认、签署 EIP-3009、构造 X-PAYMENT 并重试。每笔交易(授权、兑换、桥接、签名)都需独立的 AskUserQuestion 确认门,不得合并。

限制:Across 目前不支持 X Layer 作为目的地,跨链 /quote 到链 196 会返回 ResourceNotFound,跨链腿需用户在技能外自行桥接;USDC 在 X Layer 上缺乏可靠 Uniswap v3 路由;OKX 仅赞助 facilitator 的结算转账,其他链上操作由用户支付 OKB;输入需按规则校验(地址正则、链 ID、金额、https URL、拒绝 shell 元字符)。