@acedatacloud/x402-client è responsabile della firma dell’header di richiesta PAYMENT-SIGNATURE quando si incontra 402 Payment Required.
Indirizzi del codice sorgente e dei pacchetti:
- Repository SDK: https://github.com/AceDataCloud/SDK
- Repository 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
Installare le dipendenze
@solana/web3.js:
- Sia
@acedatacloud/sdksia@acedatacloud/x402-clientpossono essere installati da npm e importati da Node.js. ethersviene usato per la firma dei typed data EVM,@solana/web3.jsviene usato per la costruzione delle transaction Solana.
Esempio Base
Nel browser si può usare direttamentewindow.ethereum. In Node.js si può usare ethers.Wallet per avvolgere un provider in stile EIP-1193.
Esempio di wallet nel browser
Quando si usano MetaMask, Coinbase Wallet o WalletConnect in un’applicazione frontend, solitamente si passa direttamente il provider EIP-1193:Esempio Solana
Solana usa SPL USDCTransferChecked. Il wallet adapter passato deve esporre publicKey e signAndSendTransaction.
exact, non supporta upto. Se l’API restituisce più accepts, l’handler sceglierà quella con network = 'solana'.
Il percorso Solana ha già verificato sulla stessa API pubblica che il paid retry può restituire HTTP 200 e ADC_SOLANA_E2E_OK. Le query RPC pubbliche potrebbero essere soggette a limitazione della frequenza, quindi questo articolo non riporta l’hash della tx Solana; quando è necessaria la riconciliazione on-chain, usa il tuo RPC Solana o la conferma dei record della console.
Scegliere exact oppure upto
L’attuale handler TypeScript sceglierà il primo payment requirement della rete corrispondente restituito dal server. L’API di Ace Data Cloud solitamente mette exact della stessa rete prima di upto, quindi se vuoi esplicitamente usare la misurazione postpagata, devi passare preferScheme: 'upto'.
Esempio:
upto per quella rete, l’handler effettuerà automaticamente il fallback al primo requirement disponibile per quella rete, solitamente exact.
upto richiede un’autorizzazione Permit2 una tantum. upto è attualmente disponibile solo su Base, quindi è necessario effettuare un’autorizzazione una sola volta per Base USDC:
upto ha completato la verifica dell’API pubblica: HTTP 402 -> HTTP 200, la settlement tx postpagata è 0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036. L’output completo è disponibile nella descrizione dello schema di fatturazione.
Cosa fa l’SDK
Il transport di@acedatacloud/sdk eseguirà una volta il payment handler quando riceve un 402:
@acedatacloud/x402-client:
- Seleziona il payment requirement della rete target da
ctx.accepts. - Costruisce una firma EVM EIP-712 o una transaction di trasferimento Solana in base alla rete.
- Serializza l’envelope in Base64.
- Restituisce
{ headers: { 'PAYMENT-SIGNATURE': '<base64>' } }. - L’SDK ritenta automaticamente usando il corpo della richiesta originale.

