@acedatacloud/x402-client ansvarar för att signera begärandehuvudet PAYMENT-SIGNATURE när 402 Payment Required påträffas.
Källkod och paketadresser:
- SDK-repository: https://github.com/AceDataCloud/SDK
- X402 Client-repository: 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
Installera beroenden
@solana/web3.js:
- Både
@acedatacloud/sdkoch@acedatacloud/x402-clientkan installeras från npm och importeras av Node.js. ethersanvänds för EVM typed data-signering, och@solana/web3.jsanvänds för konstruktion av Solana-transaktioner.
Base-exempel
I webbläsaren kanwindow.ethereum användas direkt. I Node.js kan ethers.Wallet användas för att omsluta en provider i EIP-1193-stil.
Exempel med webbläsarplånbok
När MetaMask, Coinbase Wallet eller WalletConnect används i frontend-applikationer skickas vanligtvis en EIP-1193-provider direkt:Solana-exempel
Solana använder SPL USDCTransferChecked. Den överlämnade wallet adaptern måste exponera publicKey och signAndSendTransaction.
exact, inte upto. Om API:et returnerar flera accepts väljer handlern posten med network = 'solana'.
Solana-flödet har verifierats på samma offentliga API där paid retry kan returnera HTTP 200 och ADC_SOLANA_E2E_OK. Offentliga RPC-frågor kan vara hastighetsbegränsade, därför anges ingen Solana tx hash i denna artikel; när avstämning på kedjan krävs, använd din egen Solana RPC eller bekräfta via konsolposter.
Välj exact eller upto
Den nuvarande TypeScript-handlern väljer det första payment requirement för ett matchande nätverk som returneras av servern. Ace Data Clouds API placerar vanligtvis exact för samma nätverk före upto, så om du uttryckligen vill använda efterföljande mätning måste du ange preferScheme: 'upto'.
Exempel:
upto requirement för det nätverket återgår handlern automatiskt till det första tillgängliga requirement för nätverket, vanligtvis exact.
upto kräver en engångsauktorisering för Permit2. upto erbjuds för närvarande endast på Base, så det behöver bara göras en auktorisering för Base USDC:
upto har slutfört offentlig API-verifiering: HTTP 402 -> HTTP 200, och den efterföljande settlement tx är 0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036. Fullständig utdata finns i beskrivningen av faktureringsschemat.
Vad SDK:t gör
Transporten i@acedatacloud/sdk kör en payment handler en gång när den tar emot 402:
@acedatacloud/x402-client kommer att:
- Välja payment requirement för målnätverket från
ctx.accepts. - Konstruera en EVM EIP-712-signatur eller en Solana transfer transaction baserat på nätverket.
- Serialisera envelopen till Base64.
- Returnera
{ headers: { 'PAYMENT-SIGNATURE': '<base64>' } }. - SDK:t gör automatiskt ett nytt försök med den ursprungliga begärandetexten.

