Идентификаторы сетей используют CAIP-2
accepts[].network в x402 v2 — это идентификатор CAIP-2, а не сокращённые названия вроде base или solana. При сопоставлении сети клиент обязан сравнивать строки CAIP-2:
Матрица поддержки
upto сейчас предоставляется только на Base. Фактически доступные варианты определяются значением accepts, возвращаемым API. Вы также можете проверить Facilitator:
/supported:
exactдля Base и Solana — это путь оплаты с фиксированной суммой.- Только Base предоставляет путь постфактумного учёта
upto, зависящий от approve Permit2. extra.facilitatorAddressв записиupto— это адрес, который клиент должен записать в witness при подписи; он должен совпадать со значением, возвращённым сервером.
Base
Base использует официальный контракт USDC:exact клиент подписывает EIP-712 TransferWithAuthorization. Содержимое подписи включает:
from: адрес кошелька плательщикаto: адрес получателя Ace Data Cloudvalue: сумма этого платежаvalidAfter/validBefore: временное окно действия подписиnonce: случайный nonce длиной 32 байта
transferWithAuthorization USDC для завершения перевода.
Base — наиболее рекомендуемая сеть для промышленной интеграции, особенно для постфактумного учёта upto, поскольку экосистема Permit2, USDC и кошельков более зрелая.
Пример результата проверки Base exact:
- Повторный paid-запрос API возвращает содержимое модели
ADC_BASE_E2E_OK. - Ончейн-транзакцию можно найти в BaseScan, номер блока —
46726299. 95215atomic USDC соответствует0.095215USDC и является фактической суммой расчёта за этот вызов API.
exact:
- Итоговый статус заказа на платформе —
Finished. pay_idзаказа записывается в тот же хеш транзакции Base.1200000atomic USDC соответствует1.2USDC и является исторической фактически уплаченной суммой для этого заказа на 10 Credits по старой политике; новые заказы больше не получают дополнительную скидку за способ оплаты X402, конкретная сумма подписи определяется ответом 402 текущего запроса.
Solana
Solana использует SPL USDCTransferChecked. Клиент создаёт транзакцию перевода, подписывает и отправляет её, после чего помещает подпись транзакции или сериализованную транзакцию в envelope PAYMENT-SIGNATURE.
Особенности Solana:
- Используется Solana wallet adapter или base58 secret key;
- Активом является Solana USDC mint;
- В настоящее время поддерживается только
exact; - Facilitator проверяет mint, destination, authority и amount инструкции transfer.
exact:
- Повторный paid-запрос уже возвращает HTTP 200, а модель выводит
ADC_SOLANA_E2E_OK. - При запросе ончейн signature через публичный RPC может возникнуть ограничение частоты.
- Поскольку запросы через публичный RPC могут ограничиваться по частоте, Solana explorer здесь не указан. Если требуется строгая сверка, используйте собственный Solana RPC или записи о settlement на стороне платформы для подтверждения подписи транзакции.
Как выбрать
Независимо от выбранной сети не следует жёстко кодировать цену на стороне клиента. Цена определяется значением
accepts[].maxAmountRequired, возвращённым сервером.
Добавление новых EVM-сетей
Нативные платежи USDC с фиксированной суммой в следующих сетях получили поддержку в коде и открываются по одной сети. Доступность определяетсяaccepts, возвращаемым заказом или API; это не означает, что все сети включены в продакшене.
Эти сети поддерживают только
exact, точность валюты составляет 6. Не используйте мостовой USDC с тем же именем.
При использовании официального TypeScript/Python X402 Client можно передать сокращённое имя из таблицы или идентификатор CAIP-2.
Клиент использует ID целевой цепи для создания подписи; кошелёк должен поддерживать целевую сеть.
В официальной таблице поддержки расширения-кошелька Phantom указаны Arbitrum и Polygon; Optimism, Avalanche
в настоящее время не включены в эту таблицу, можно использовать Rabby или MetaMask, поддерживающие целевую сеть. EVM-адреса могут быть одинаковыми в разных цепях,
но балансы независимы друг от друга, адреса Solana не применимы к EVM USDC.
См. таблицу поддержки кошелька Phantom.
Точка входа в поэтапное развёртывание новых сетей
Точки входа для новых цепей по умолчанию скрыты. При доступе к консоли или Studio можно использовать?features=x402-arbitrum,
чтобы включить соответствующую цепь; несколько флагов разделяются запятыми. Чтобы отключить одну цепь, используйте ?features=-x402-arbitrum,
чтобы очистить локальные переопределения, используйте ?features=none. Переключатели сохраняются отдельно для каждого домена.
Расценки заказов и повторные попытки оплаты используют один и тот же переключатель, сервер выполняет независимую проверку; существующие записи платежей по-прежнему можно просматривать.
Включение только флага страницы не активирует ещё не настроенную цепь, конкретные доступные для оплаты сети по-прежнему определяются актуальным accepts.
