Hoppa till huvudinnehåll
TypeScript är ett av de mest rekommenderade sätten att integrera Ace Data Cloud X402. Det officiella SDK:t ansvarar för vanliga API-anrop, uppgiftspollning, felhantering och automatiska återförsök; @acedatacloud/x402-client ansvarar för att signera begärandehuvudet PAYMENT-SIGNATURE när 402 Payment Required påträffas. Källkod och paketadresser:

Installera beroenden

Om Base används krävs EVM-signeringsfunktionalitet:
Om Solana används krävs en Solana wallet adapter eller @solana/web3.js:
Installations- och importkontrollutdata för ett rent npm-projekt:
Förklaring av resultaten:
  • Både @acedatacloud/sdk och @acedatacloud/x402-client kan installeras från npm och importeras av Node.js.
  • ethers används för EVM typed data-signering, och @solana/web3.js används för konstruktion av Solana-transaktioner.

Base-exempel

I webbläsaren kan window.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:
Webbläsarplånboken visar en bekräftelse för signering. Det användaren signerar är inte ett godtyckligt meddelande, utan API:ets returnerade betalningskrav: mottagaradress, USDC-kontrakt, belopp, giltighetstid och nonce ingår alla i signaturen.

Solana-exempel

Solana använder SPL USDC TransferChecked. Den överlämnade wallet adaptern måste exponera publicKey och signAndSendTransaction.
Solana-flödet stöder för närvarande endast 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:
Om servern inte returnerar ett 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:
Base 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:
Handlern som returneras av @acedatacloud/x402-client kommer att:
  1. Välja payment requirement för målnätverket från ctx.accepts.
  2. Konstruera en EVM EIP-712-signatur eller en Solana transfer transaction baserat på nätverket.
  3. Serialisera envelopen till Base64.
  4. Returnera { headers: { 'PAYMENT-SIGNATURE': '<base64>' } }.
  5. SDK:t gör automatiskt ett nytt försök med den ursprungliga begärandetexten.
Detta innebär att affärskoden bara behöver skrivas som vanliga SDK-anrop, utan att manuellt hantera 402-återförsök.