@acedatacloud/x402-client відповідає за підписання заголовка запиту PAYMENT-SIGNATURE при виникненні 402 Payment Required.
Вихідний код та адреси пакетів:
- Репозиторій SDK: https://github.com/AceDataCloud/SDK
- Репозиторій X402 Client: https://github.com/AceDataCloud/X402Client
- npm SDK: https://www.npmjs.com/package/@acedatacloud/sdk
- npm X402 Client: https://www.npmjs.com/package/@acedatacloud/x402-client
Встановлення залежностей
@solana/web3.js:
@acedatacloud/sdkі@acedatacloud/x402-clientможна встановити з npm та імпортувати через Node.js.ethersвикористовується для підпису EVM typed data, а@solana/web3.js— для створення Solana transaction.
Приклад Base
У браузері можна безпосередньо використовуватиwindow.ethereum. У Node.js можна обгорнути ethers.Wallet provider’ом у стилі EIP-1193.
Приклад браузерного гаманця
Під час використання MetaMask, Coinbase Wallet або WalletConnect у фронтенд-застосунку зазвичай безпосередньо передається EIP-1193 provider:Приклад Solana
Solana використовує SPL USDCTransferChecked. Переданий wallet adapter має надавати publicKey та signAndSendTransaction.
exact і не підтримує upto. Якщо API повертає кілька accepts, handler вибере елемент із network = 'solana'.
Шлях Solana уже перевірено на тому самому публічному API: paid retry може повертати HTTP 200 та ADC_SOLANA_E2E_OK. Запити до публічного RPC можуть мати обмеження швидкості, тому в цій статті не вказано Solana tx hash; якщо потрібна ончейн-звірка, використовуйте власний Solana RPC або підтвердження із записів консолі.
Вибір exact або upto
Поточний TypeScript handler вибирає першу payment requirement для відповідної мережі, повернену сервером. API Ace Data Cloud зазвичай розміщує exact тієї самої мережі перед upto, тому якщо ви точно хочете використовувати післяплатний облік, потрібно передати preferScheme: 'upto'.
Приклад:
upto requirement для цієї мережі, handler автоматично повернеться до першої доступної requirement для цієї мережі, зазвичай це exact.
Для upto потрібна одноразова авторизація Permit2. upto наразі доступний лише в Base, тому потрібно лише один раз надати авторизацію для Base USDC:
upto пройшов перевірку на публічному API: HTTP 402 -> HTTP 200, післяплатний settlement tx — 0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036. Повний вивід дивіться в описі схеми виставлення рахунків.
Що робить SDK
Transport@acedatacloud/sdk виконує payment handler один раз при отриманні 402:
@acedatacloud/x402-client, виконає:
- Вибере payment requirement цільової мережі з
ctx.accepts. - Створить EVM EIP-712 підпис або Solana transfer transaction відповідно до мережі.
- Серіалізує envelope у Base64.
- Поверне
{ headers: { 'PAYMENT-SIGNATURE': '<base64>' } }. - SDK автоматично повторить спробу з вихідним тілом запиту.

