x402 on Gonka
检查中…

Git:gonkalabs 的 Git 仓库暂时不可用。请从本网站下载源码 — 源码

在 Gonka 上用 GNK 或 USDC 支付 HTTP API。

这是面向 Gonka 的公开 x402 协调器。代理或应用请求付费 URL,服务器返回 HTTP 402,客户端签署一笔 Gonka 转账,本服务在链上结算。无需账户。无需 API 密钥。

开始使用

适用对象

代理与买家像调用普通 HTTP 接口一样调用付费 API。看到 402 后付款并重试。见 代理与买家

卖家为 HTTP 路由定价,返回带支付详情的 402,再请本协调器结算。见 卖家

已登记的付费 URL 见 资源列表。若只想先看效果,从 快速开始 入手。

支付流程

  1. 客户端向付费 URL 发送普通请求。
  2. 服务器返回 402 Payment Required,并带 PAYMENT-REQUIRED 头:网络、资产、金额和 payTo
  3. 客户端为该笔支付签署 Gonka 交易,并带上 PAYMENT-SIGNATURE 重试。
  4. 服务器在此调用 POST /settle。已签名交易广播到 Gonka。随后服务器返回资源,以及带交易哈希的 PAYMENT-RESPONSE

在 Gonka 上,结算是先付后用:资金先到账,再提供资源。客户端签署完整交易。协调器只负责广播,不托管资金。

可用资产

GNK原生币。金额以 ngonka 计(9 位小数)。转账为 MsgSend
USDC从 Circle 桥接的 USDC,CW-20 代币(6 位小数)。转账为合约 transfer
网络cosmos:gonka-mainnet
方案exact — 至少支付所公布的原子金额。

完整常量见 网络与资产

各方职责

客户端读取 402,在本地签名,带请求头重试。私钥不会发到本服务器。使用 CLI 或自有签名器。
资源服务器公布价格、检查请求头、调用本协调器,结算成功后再提供服务。
协调器本站。/verify 只读。/settle 广播并等待上链。

协议细节、请求头与载荷形状见 协议。接口约定见 HTTP API