Перейти до основного вмісту
Ace Data Cloud X402 наразі здійснює розрахунки в USDC та підтримує два типи мереж: EVM і Solana. Способи підпису, адреси активів, поведінка gas і сценарії застосування відрізняються залежно від мережі, тому перед інтеграцією потрібно спочатку вибрати мережу.

Ідентифікатори мереж використовують CAIP-2

accepts[].network у x402 v2 є ідентифікатором CAIP-2, а не скороченою назвою на кшталт base чи solana. Клієнт повинен зіставляти мережі за рядком CAIP-2:

Матриця підтримки

upto наразі доступний лише на Base. Фактично доступні елементи визначаються значенням accepts, яке повертає API. Ви також можете переглянути Facilitator:
Відповідь Facilitator /supported:
Пояснення результатів:
  • exact для Base і Solana є шляхом оплати з фіксованою сумою.
  • Лише Base надає шлях обліку після використання upto, який залежить від Permit2 approve.
  • extra.facilitatorAddress у записі upto — це адреса, яку клієнт повинен записати у witness під час підпису, і вона повинна збігатися зі значенням, яке повертає сервер.

Base

Base використовує офіційний контракт USDC:
У схемі exact клієнт підписує EIP-712 TransferWithAuthorization. Вміст підпису включає:
  • from: адресу гаманця платника
  • to: адресу отримувача Ace Data Cloud
  • value: суму цієї оплати
  • validAfter / validBefore: часовий проміжок чинності підпису
  • nonce: 32-байтовий випадковий nonce
Після перевірки підпису Facilitator викличе в ончейні transferWithAuthorization USDC для завершення переказу. Base є найбільш рекомендованою мережею для повноцінної інтеграції, особливо для обліку після використання upto, оскільки екосистема Permit2, USDC і гаманців є зрілішою. Приклад результату перевірки Base exact:
Пояснення результатів:
  • Повторний запит API після оплати повертає вміст моделі ADC_BASE_E2E_OK.
  • Ончейн-транзакцію вже можна знайти в BaseScan, номер блоку — 46726299.
  • 95215 atomic USDC відповідає 0.095215 USDC, що є фактичною сумою розрахунку за цей виклик API.
Результат виконання програми для оплати замовлення через Base exact:
Пояснення результатів:
  • Кінцевий статус замовлення на платформі — Finished.
  • pay_id замовлення записується в той самий хеш транзакції Base.
  • 1200000 atomic USDC відповідає 1.2 USDC, що є історичною фактично сплаченою сумою цього замовлення на 10 Credits за старою політикою; нові замовлення більше не отримують додаткову знижку за спосіб оплати X402, а конкретна сума підпису визначається відповіддю 402 цього разу.

Solana

Solana використовує SPL USDC TransferChecked. Клієнт сформує транзакцію переказу, підпише та надішле її, а потім помістить підпис транзакції або серіалізовану транзакцію до envelope PAYMENT-SIGNATURE. Особливості Solana:
  • Використовуються Solana wallet adapter або base58 secret key;
  • Активом є Solana USDC mint;
  • Наразі підтримується лише exact;
  • Facilitator перевіряє mint, destination, authority та amount інструкції transfer.
Якщо використовується режим wallet fee payer, гаманець безпосередньо надсилає транзакцію, а Facilitator відповідає за підтвердження транзакції та повернення результату settlement. Приклад результату перевірки Solana exact:
Пояснення результатів:
  • Повторний запит після оплати вже повернув HTTP 200, а модель вивела ADC_SOLANA_E2E_OK.
  • Під час запиту ончейн signature через публічний RPC можна зіткнутися з обмеженням частоти.
  • Оскільки запити до публічного RPC можуть бути обмежені за частотою, тут не вказано Solana explorer. Якщо потрібна сувора звірка, використовуйте власний Solana RPC або записи про розрахунки на боці платформи для підтвердження підпису транзакції.

Як вибрати

Незалежно від вибраного ланцюга, не кодуйте ціну жорстко в клієнті. Ціна визначається значенням accepts[].maxAmountRequired, яке повертає сервер.

Додавання нової EVM-мережі

Підтримку коду для платежів із фіксованою сумою в нативному USDC у наведених нижче мережах надано, відкриття відбувається по черзі за мережами. Доступність визначається accepts, що повертається замовленням або API; це не означає, що всі мережі увімкнено у production. Ці мережі підтримують лише 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, щоб увімкнути відповідний ланцюг; кілька flag розділяються комами. Щоб вимкнути один ланцюг, використовуйте ?features=-x402-arbitrum, щоб очистити локальні перевизначення, використовуйте ?features=none. Перемикачі зберігаються окремо для кожного домену. Котирування замовлень і повторні спроби платежів використовують той самий перемикач, сервер виконує незалежну перевірку; наявні записи про платежі все ще можна переглядати. Увімкнення лише page flag не активує ланцюг, який ще не налаштовано, конкретні мережі, доступні для оплати, як і раніше визначаються реальним часом accepts.