CLI

x402-gonka 二进制既是协调器，也是本地付款工具。签名发生在运行 pay 的机器上。

安装

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

curl -fsSL {{BASE}}/releases/x402-gonka-source.tar.gz | tar -xz
cd x402-gonka
go run ./cmd/x402-gonka

pay

GET 该 URL，期望 402，签署匹配的 Gonka 交易，再带 PAYMENT-SIGNATURE 重试。

go run ./cmd/x402-gonka pay --key "$GONKA_PRIVATE_KEY" --url {{BASE}}/demo
go run ./cmd/x402-gonka pay --key "$GONKA_PRIVATE_KEY" --url {{BASE}}/demo --asset usdc

`--key`	secp256k1 私钥（hex）。必填。不会上传。
`--url`	付费资源 URL。必填。
`--asset`	`gnk`（默认）或 `usdc`。从 `accepts` 中选择。

pay 仅用 GONKA_RPC_URL（默认 https://rpc.gonka.gg）读取账户编号和 sequence。结算由资源服务器通过本协调器完成。

该命令已在链上结算。密钥留在 $GONKA_PRIVATE_KEY。核对与浏览器：

curl -sS https://rpc.gonka.gg/chain-api/cosmos/tx/v1beta1/txs/23B76D1281F9EFCC7AFC90659480CF3219A7099959C0513720769F700E9B73B2

交易 23B76D1281F9EFCC7AFC90659480CF3219A7099959C0513720769F700E9B73B2 见 gonka.gg。完整输出见快速开始。

keygen

打印新的 gonka1… 地址和 hex 密钥。支付前请先充值。在收到转账之前，该地址尚未在链上注册。

go run ./cmd/x402-gonka keygen

serve

运行协调器、文档和 /demo。PAY_TO 必须是有效的商户地址。

curl -fsSL {{BASE}}/releases/x402-gonka-source.tar.gz | tar -xz
cd x402-gonka
cp .env.example .env
# set PAY_TO
go run ./cmd/x402-gonka serve

环境变量

`PORT`	监听端口。默认 `4020`。
`PUBLIC_BASE_URL`	用于演示 `resource.url` 和 discovery 的绝对源站。
`GONKA_RPC_URL`	默认 `https://rpc.gonka.gg`。
`GONKA_CHAIN_ID`	默认 `gonka-mainnet`。
`PAY_TO`	接收演示（及默认）付款的商户地址。
`DEMO_AMOUNT_GNK`	`/demo` 的原子 ngonka 数量。
`DEMO_AMOUNT_USDC`	`/demo` 的原子 USDC 数量。
`USDC_CONTRACT`	CW-20 地址。见网络与资产。