@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 во frontend-приложении обычно напрямую передаётся 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, post-settlement tx — 0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036. Полный вывод приведён в описании схемы биллинга.
Что делает SDK
transport@acedatacloud/sdk при получении 402 один раз выполняет payment handler:
@acedatacloud/x402-client, будет:
- Выбирать из
ctx.acceptspayment requirement целевой сети. - Создавать в соответствии с сетью EVM EIP-712 подпись или Solana transfer transaction.
- Сериализовать envelope в Base64.
- Возвращать
{ headers: { 'PAYMENT-SIGNATURE': '<base64>' } }. - SDK автоматически повторит попытку с исходным телом запроса.

