SuperAPI AI 工具集

cryptorefills-x402

智能体与模型

查看项目

更新于 10-15 20:29

技能介绍

用途:让持有加密钱包的 AI 智能体自主完成购买,无需账户、OAuth 或 API 密钥,仅需稳定币和签名密钥。基于 x402 协议(HTTP 402 Payment Required 机器对机器支付标准),支持两条结算通道:Base(以太坊 L2 上的 USDC,默认)与 Solana 主网(USDC SPL,需主动选择)。

主要能力:浏览品牌与目录、下单购买礼品卡、手机充值、eSIM 等数字商品,并轮询订单交付状态。REST 接口包括 GET /v1/brands、GET /v1/catalog、POST /v1/orders、GET /v1/orders/{id}。两条通道的流程与订单模型一致,仅 Phase-1 请求头、PAYMENT-REQUIRED 的 extra 字段和签名原语不同。

使用方式:Base 通道用 EIP-712 签署 transferWithAuthorization(EIP-3009),无需 ETH 付 gas,由 Cryptorefills 代转;Solana 通道需构建含 3 条指令的 v0 VersionedTransaction 并部分签名,使用 SPL TransferChecked(0x0c),无需 SOL,由 CDP facilitator 付 gas。下单先 POST 获取 402 响应,验证 X-Payment-Required-Signature(JWS/ES256)后再签名,然后携带 PAYMENT-SIGNATURE 重新 POST 完成订单。

适用场景:自动化礼品卡采购、旅行 eSIM 开通、程序化奖励发放、注册表驱动的 Solana 支付。

限制与安全:需设置每会话消费上限(默认每会话 100 美元、每笔 50 美元);签名前核对金额;使用专用钱包;绝不泄露私钥;礼品卡码属现金类资产需安全存储;数字商品交付后不可退款。Solana 通道 payTo 为 owner 公钥而非 ATA,需在签名前重新获取 recentBlockhash(有效期约 60 秒),且 Phase 2 必须发往与 Phase 1 相同的主机。条款见 https://www.cryptorefills.com/terms/。