accepts и как PAYMENT-SIGNATURE превращает тот же API-запрос в оплаченный запрос.
Подготовка
Вам нужно подготовить:
При вызове Ace Data Cloud API через X402 API Token не требуется. Первый запрос SDK не содержит
Authorization, Gateway вернёт 402 Payment Required и требования к оплате; после подписи SDK автоматически повторит попытку.
Установка SDK
Исходный код и адреса пакетов:- Репозиторий SDK: https://github.com/AceDataCloud/SDK
- Репозиторий X402 Client: https://github.com/AceDataCloud/X402Client
- npm:
@acedatacloud/sdk、@acedatacloud/x402-client - PyPI:
acedatacloud、acedatacloud-x402
acedatacloud-x402.
Вывод проверки установки и импорта в чистой временной среде:
- Пакеты npm и PyPI являются реально опубликованными пакетами, а не названиями-заглушками из документации.
acedatacloud-x402[cli]установит CLI, подкомандаapprove-permit2может использоваться для авторизации Permit2 в сценарияхupto.
Первый запрос вернёт 402
Сначала можно использоватьcurl, чтобы посмотреть, что возвращает неоплаченный запрос. Приведённый ниже пример не приведёт к списанию средств, поскольку он не содержит PAYMENT-SIGNATURE:
accepts, типичная структура выглядит следующим образом:
PAYMENT-REQUIRED в виде base64, чтобы клиент мог получать требования к оплате без разбора body.
Сводка программного вывода неоплаченного запроса к production API выглядит следующим образом:
- Первый запрос не содержит
AuthorizationилиPAYMENT-SIGNATURE, поэтому возвращается HTTP 402, списание средств не произойдёт. accepts— единственная достоверная основа для подписи этого запроса, содержащая доступные сети, scheme, лимит суммы, адрес получателя и адрес актива.network— идентификатор CAIP-2, клиент при выборе сети должен сопоставлять его по строке CAIP-2.- Лимит суммы для этого минимального запроса чата
gpt-4o-miniсоставляет95215atomic USDC, то есть0.095215USDC. - Для каждого запроса следует читать текущий ответ 402, не следует жёстко кодировать примерную сумму в бизнес-коде.
Выполнение повторной попытки оплаты с помощью SDK
Ниже приведён минимальный пример TypeScript. Он указываетnetwork: 'base', handler выберет requirement для оплаты Base из текущего ответа 402; фактическая сумма и адрес получателя по-прежнему определяются accepts:
- SDK отправляет обычный API-запрос без
Authorization. - Gateway возвращает
402 Payment Requiredиaccepts. createX402PaymentHandlerвыбирает payment requirement дляnetwork = 'base'и подписываетPAYMENT-SIGNATURE.- SDK повторяет попытку с тем же телом запроса, а Gateway вызывает Facilitator для проверки и расчёта, после чего пропускает запрос к целевому API.
Просмотр поддерживаемых возможностей Facilitator
X402 API не зависит от каталога ресурсов. Клиент напрямую вызывает известный API и использует возвращаемые этим запросом в реальном времени402 Payment Required и accepts как единственное основание для цены и подписи.
Объявление возможностей Facilitator находится по адресу:
/supported, /verify, /settle и текущие включённые платёжные сети, не перечисляя API-ресурсы.
Адрес production Facilitator Ace Data Cloud:
kinds перечисляют сети и scheme, поддерживаемые Facilitator. При фактическом вызове всё равно следует ориентироваться на accepts, возвращаемые API.
Вывод Facilitator /supported:
/supportedуказывает, что Facilitator обладает возможностями проверки и расчёта для этих сетей и scheme.- Base и Solana обе поддерживают
exact;uptoв настоящее время предоставляется только в Base. - Разрешает ли конкретный API определённую сеть, всё равно определяется его 402
accepts.

