在 Gonka 上用 GNK 或 USDC 支付 HTTP API。
这是面向 Gonka 的公开 x402 协调器。代理或应用请求付费 URL,服务器返回 HTTP 402,客户端签署一笔 Gonka 转账,本服务在链上结算。无需账户。无需 API 密钥。
适用对象
代理与买家像调用普通 HTTP 接口一样调用付费 API。看到 402 后付款并重试。见 代理与买家。
卖家为 HTTP 路由定价,返回带支付详情的 402,再请本协调器结算。见 卖家。
已登记的付费 URL 见 资源列表。若只想先看效果,从 快速开始 入手。
支付流程
- 客户端向付费 URL 发送普通请求。
- 服务器返回
402 Payment Required,并带PAYMENT-REQUIRED头:网络、资产、金额和payTo。 - 客户端为该笔支付签署 Gonka 交易,并带上
PAYMENT-SIGNATURE重试。 - 服务器在此调用
POST /settle。已签名交易广播到 Gonka。随后服务器返回资源,以及带交易哈希的PAYMENT-RESPONSE。
在 Gonka 上,结算是先付后用:资金先到账,再提供资源。客户端签署完整交易。协调器只负责广播,不托管资金。
一次真实的 GNK /demo 支付已上链:23B76D1281F9EFCC7AFC90659480CF3219A7099959C0513720769F700E9B73B2,见 gonka.gg。命令与核对见 快速开始。
可用资产
| GNK | 原生币。金额以 ngonka 计(9 位小数)。转账为 MsgSend。 |
|---|---|
| USDC | 从 Circle 桥接的 USDC,CW-20 代币(6 位小数)。转账为合约 transfer。 |
| 网络 | cosmos:gonka-mainnet |
| 方案 | exact — 至少支付所公布的原子金额。 |
完整常量见 网络与资产。
各方职责
| 客户端 | 读取 402,在本地签名,带请求头重试。私钥不会发到本服务器。使用 CLI 或自有签名器。 |
|---|---|
| 资源服务器 | 公布价格、检查请求头、调用本协调器,结算成功后再提供服务。 |
| 协调器 | 本站。/verify 只读。/settle 广播并等待上链。 |