Ідентифікатори мереж використовують CAIP-2
accepts[].network у x402 v2 є ідентифікатором CAIP-2, а не скороченою назвою на кшталт base чи skale. Клієнт повинен порівнювати мережі за рядком CAIP-2:
Матриця підтримки
upto наразі доступний лише в Base. Фактично доступні варіанти визначаються полем accepts, яке повертає API. Ви також можете переглянути Facilitator:
/supported:
exactдля Base, SKALE і Solana є шляхом оплати з фіксованою сумою.- Лише Base надає шлях післяоплатного вимірювання
upto, який залежить від Permit2 approve. 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:
- API paid retry повертає вміст моделі
ADC_BASE_E2E_OK. - Ончейн-транзакцію вже можна перевірити в BaseScan, номер блоку —
46726299. 95215atomic USDC відповідає0.095215USDC та є фактичною сумою розрахунку за цей виклик API.
exact:
- Кінцевий статус замовлення на платформі —
Finished. pay_idзамовлення записується в той самий хеш транзакції Base.1200000atomic USDC відповідає1.2USDC та є історичною фактично сплаченою сумою цього замовлення на 10 Credits за старою політикою; нові замовлення більше не отримують додаткову знижку за спосіб оплати X402, а конкретна сума підпису визначається відповіддю 402 цього разу.
SKALE
SKALE використовує bridged USDC, а спосіб підпису подібний до Base — також EIP-3009. Вона підходить для EVM-сценаріїв оплати з низькою вартістю gas; фактичні виклики все одно визначаються полемaccepts, яке повертає API.
Типовий accepts для SKALE 402 містить:
exact. Якщо вам потрібне післяоплатне вимірювання, використовуйте Base upto.
Приклад результату верифікації SKALE exact:
- API paid retry повертає вміст моделі
ADC_SKALE_E2E_OK。 - Транзакцію вже можна знайти в SKALE explorer, номер блоку —
1969317。 - Сума розрахунку цього платежу
exactстановить0.095215USDC。
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 retry вже повернув HTTP 200, а модель вивела
ADC_SOLANA_E2E_OK。 - Під час запиту on-chain signature через публічний RPC можна зіткнутися з rate limiting。
- Оскільки публічні RPC-запити можуть бути обмежені, Solana explorer тут не вказано。Якщо потрібна сувора звірка, використовуйте власний Solana RPC або записи settlement на стороні платформи для підтвердження підпису транзакції。
Як обрати
Незалежно від обраного ланцюга, не хардкодьте ціну в клієнті。Ціна визначається значенням
accepts[].maxAmountRequired, яке повертає сервер。
