Skip to main content
Ace Data Cloud X402 använder för närvarande USDC-avräkning och stöder två typer av kedjor: EVM och Solana. Signaturmetoder, tillgångsadresser, gas-beteende och tillämpliga scenarier skiljer sig mellan olika nätverk, så du måste välja nätverk innan integration.

​
Nätverksidentifierare använder CAIP-2

accepts[].network i x402 v2 är en CAIP-2-identifierare, inte förkortningar som base eller skale. Klienten måste jämföra enligt CAIP-2-strängen vid matchning av nätverk:

​
Stödmatris

upto tillhandahålls för närvarande endast på Base. Faktiskt tillgängliga alternativ avgörs av de accepts som API:et returnerar. Du kan också kontrollera Facilitator:
Svaret från Facilitator /supported:
Förklaring av resultat:
  • exact för Base, SKALE och Solana är betalningsvägar med fast belopp.
  • Endast Base erbjuder efterhandsmätningsvägen upto, som är beroende av Permit2 approve.
  • extra.facilitatorAddress i posten upto är adressen som klienten ska skriva in i witness vid signering och måste stämma överens med värdet som returneras av servern.

​
Base

Base använder det officiella USDC-kontraktet:
I exact-schemat signerar klienten EIP-712 TransferWithAuthorization. Signaturinnehållet omfattar:
  • from: den betalande plånboksadressen
  • to: Ace Data Clouds mottagaradress
  • value: betalningsbeloppet denna gång
  • validAfter / validBefore: signaturens giltighetsfönster
  • nonce: slumpmässig nonce på 32 byte
Efter att Facilitator har verifierat signaturen anropar den USDC:s transferWithAuthorization på kedjan för att slutföra överföringen. Base är det mest rekommenderade nätverket för produktionsintegration, särskilt för efterhandsmätning med upto, eftersom ekosystemet för Permit2, USDC och plånböcker är mer moget. Exempel på Base exact-verifieringsresultat:
Förklaring av resultat:
  • API:ets paid retry returnerar modellinnehållet ADC_BASE_E2E_OK.
  • Transaktionen på kedjan kan kontrolleras på BaseScan, och blocknumret är 46726299.
  • 95215 atomic USDC motsvarar 0.095215 USDC och är det faktiska avräkningsbeloppet för detta API-anrop.
Programkörningsresultat för orderbetalning med Base exact:
Förklaring av resultat:
  • Plattformens slutliga orderstatus är Finished.
  • Orderns pay_id skrivs in med samma Base-transaktionshash.
  • 1200000 atomic USDC motsvarar 1.2 USDC och är det historiska faktiskt betalda beloppet för denna order på 10 Credits enligt den gamla policyn; nya ordrar får inte längre någon extra rabatt för betalningsmetoden X402, och det specifika signeringsbeloppet avgörs av detta 402-svar.

​
SKALE

SKALE använder bridged USDC. Signaturmetoden liknar den för Base och är också EIP-3009. Det lämpar sig för EVM-betalningsscenarier med låg gas-kostnad; faktiska anrop avgörs fortfarande av de accepts som API:et returnerar. Typiska accepts för SKALE 402 innehåller:
SKALE tillhandahåller för närvarande endast exact. Om du behöver efterhandsmätning, använd Base upto. Exempel på SKALE exact-verifieringsresultat:
Förklaring av resultat:
  • API paid retry returnerar modellinnehållet ADC_SKALE_E2E_OK。
  • Transaktionen kan kontrolleras i SKALE explorer, och blocknumret är 1969317。
  • Avräkningsbeloppet för denna exact-betalning är 0.095215 USDC。

​
Solana

Solana använder SPL USDC TransferChecked。Klienten bygger en överföringstransaktion, signerar och skickar den, och lägger sedan transaktionssignaturen eller den serialiserade transaktionen i PAYMENT-SIGNATURE envelope。 Solanas egenskaper:
  • Använder Solana wallet adapter eller base58 secret key；
  • Tillgången är Solana USDC mint；
  • För närvarande stöds endast exact；
  • Facilitator validerar transfer instruction:s mint、destination、authority och amount。
Om wallet fee payer-läget används skickar plånboken transaktionen direkt, medan Facilitator ansvarar för att bekräfta transaktionen och returnera settlement-resultatet。 Exempel på Solana exact-valideringsresultat:
Resultatförklaring:
  • paid retry har redan returnerat HTTP 200, och modellens utdata är ADC_SOLANA_E2E_OK。
  • Vid förfrågan om on-chain signature via offentlig RPC kan rate limiting förekomma。
  • Eftersom offentliga RPC-förfrågningar kan rate limitas skrivs Solana explorer inte ut här。När strikt avstämning krävs, använd en egen Solana RPC eller bekräfta transaktionssignaturen via plattformens settlement-poster。

​
Hur du väljer

Oavsett vilken kedja du väljer ska du inte hårdkoda priset i klienten。Priset bestäms av accepts[].maxAmountRequired som returneras av servern。