@acedatacloud/x402-client odpowiada za podpisywanie nagłówka żądania PAYMENT-SIGNATURE po napotkaniu 402 Payment Required.
Adresy kodu źródłowego i pakietów:
- Repozytorium SDK: https://github.com/AceDataCloud/SDK
- Repozytorium 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
Instalacja zależności
@solana/web3.js:
@acedatacloud/sdki@acedatacloud/x402-clientmożna instalować z npm i importować przez Node.js.etherssłuży do podpisywania typed data EVM, a@solana/web3.jsdo konstruowania transakcji Solana.
Przykład Base
W przeglądarce można bezpośrednio użyćwindow.ethereum. W Node.js można użyć ethers.Wallet, aby opakować provider w stylu EIP-1193.
Przykład portfela w przeglądarce
Podczas używania MetaMask, Coinbase Wallet lub WalletConnect w aplikacji frontendowej zazwyczaj bezpośrednio przekazuje się provider EIP-1193:Przykład Solana
Solana używa SPL USDCTransferChecked. Przekazany adapter portfela musi udostępniać publicKey i signAndSendTransaction.
exact, a nie obsługuje upto. Jeśli API zwróci wiele accepts, handler wybierze pozycję z network = 'solana'.
Ścieżka Solana została zweryfikowana na tym samym publicznym API: płatna ponowna próba może zwrócić HTTP 200 i ADC_SOLANA_E2E_OK. Publiczne zapytania RPC mogą podlegać ograniczeniom szybkości, dlatego ten artykuł nie podaje hash transakcji Solana; gdy wymagane jest uzgodnienie on-chain, użyj własnego Solana RPC lub potwierdź je w zapisach konsoli.
Wybór exact lub upto
Obecny handler TypeScript wybiera pierwsze wymaganie płatności dla pasującej sieci zwrócone przez serwer. API Ace Data Cloud zazwyczaj umieszcza exact dla tej samej sieci przed upto, dlatego jeśli wyraźnie chcesz użyć rozliczania późniejszego, musisz przekazać preferScheme: 'upto'.
Przykład:
upto dla tej sieci, handler automatycznie powróci do pierwszego dostępnego requirement dla tej sieci, zazwyczaj exact.
upto wymaga jednorazowej autoryzacji Permit2. upto jest obecnie dostępne tylko na Base, dlatego wystarczy wykonać jedną autoryzację dla Base USDC:
upto zakończyło publiczną weryfikację API: HTTP 402 -> HTTP 200, a transakcja późniejszego settlement to 0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036. Pełne dane wyjściowe znajdują się w opisie schematu rozliczeń.
Co robi SDK
Transport@acedatacloud/sdk wykona handler płatności raz po otrzymaniu 402:
@acedatacloud/x402-client wykona:
- Wybierze wymaganie płatności docelowej sieci z
ctx.accepts. - Skonstruuje podpis EVM EIP-712 lub transakcję transferu Solana zgodnie z siecią.
- Zserializuje envelope do Base64.
- Zwróci
{ headers: { 'PAYMENT-SIGNATURE': '<base64>' } }. - SDK automatycznie ponowi próbę z oryginalnym body żądania.

