Оплачивайте HTTP API в Gonka в GNK или USDC.

Это публичный x402-фасилитатор для Gonka. Агент или приложение запрашивает платный URL, сервер отвечает HTTP 402, клиент подписывает перевод в Gonka, а этот сервис проводит его в сети. Без аккаунтов. Без API-ключей.

Начать

GET /demo

HTTP/1.1 402 Payment Required
PAYMENT-REQUIRED: eyJ4NDAyVmVyc2lvbiI6Mi…

{
  "scheme": "exact",
  "network": "cosmos:gonka-mainnet",
  "asset": "ngonka",
  "amount": "1000"
}

Для кого это

Агенты и покупатели вызывают платные API так же, как любой HTTP-эндпоинт. Увидев 402, они платят и повторяют запрос. См. Агенты и покупатели.

Продавцы ставят цену на HTTP-маршрут, отвечают 402 с условиями оплаты и просят этот фасилитатор провести платёж. См. Продавцы.

Зарегистрированные платные URL — на странице Список ресурсов. Чтобы просто увидеть, как это работает, начните с Начала работы.

Как проходит оплата

Клиент отправляет обычный запрос на платный URL.
Сервер отвечает 402 Payment Required с заголовком PAYMENT-REQUIRED: сеть, актив, сумма и payTo.
Клиент подписывает транзакцию Gonka на эту оплату и повторяет запрос с PAYMENT-SIGNATURE.
Сервер вызывает здесь POST /settle. Подписанная транзакция транслируется в Gonka. Затем сервер отдаёт ресурс и PAYMENT-RESPONSE с хешем транзакции.

В Gonka расчёт авансовый: средства списываются до выдачи ресурса. Клиент подписывает всю транзакцию. Фасилитатор только транслирует её. Он не хранит средства.

Чем можно платить

GNK	Нативная монета. Суммы в `ngonka` (9 знаков). Перевод — `MsgSend`.
USDC	Забридженный Circle USDC как CW-20 (6 знаков). Перевод — контрактный `transfer`.
Сеть	`cosmos:gonka-mainnet`
Схема	`exact` — заплатить не меньше объявленной атомарной суммы.

Все константы — на странице Сеть и активы.

Роли сторон

Клиент	Читает 402, подписывает транзакцию локально, повторяет запрос с заголовком. Приватные ключи на этот сервер не уходят. Используйте CLI или свой подписант.
Сервер ресурса	Объявляет цену, проверяет заголовок, вызывает этот фасилитатор, отдаёт работу после успешного settle.
Фасилитатор	Этот сайт. `/verify` только читает. `/settle` транслирует и ждёт включения в блок.

Детали протокола, заголовки и форматы — в Протоколе. Контракты эндпоинтов — в HTTP API.