Nätverksidentifierare använder CAIP-2
accepts[].network i x402 v2 är en CAIP-2-identifierare, inte förkortningar som base eller solana. Klienter måste jämföra nätverk enligt CAIP-2-strängen:
Stödmatris
upto tillhandahålls för närvarande endast på Base. Faktiskt tillgängliga alternativ avgörs av API:ets returnerade accepts. Du kan även kontrollera Facilitator:
/supported:
exactför Base och Solana är betalningsflöden med fast belopp.- Endast Base erbjuder flödet för efterhandsmätning
upto, vilket är beroende av Permit2 approve. extra.facilitatorAddressiupto-posten ä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:exact-schemat signerar klienten EIP-712 TransferWithAuthorization. Signeringsinnehållet inkluderar:
from: betalande plånboksadressto: Ace Data Clouds mottagaradressvalue: betalningsbeloppet denna gångvalidAfter/validBefore: signaturens giltighetsperiodnonce: 32-byte slumpmässig nonce
transferWithAuthorization on-chain för att slutföra överföringen.
Base är det mest rekommenderade nätverket för produktionsintegration, särskilt lämpligt för efterhandsmätning med upto, eftersom Permit2, USDC och plånboksekosystemet är mer mogna.
Exempel på Base exact-verifieringsresultat:
- API:ets betalda återförsök returnerar modellinnehållet
ADC_BASE_E2E_OK. - On-chain-transaktionen kan hittas på BaseScan och blocknumret är
46726299. 95215atomic USDC motsvarar0.095215USDC, vilket är det faktiska avvecklade beloppet för detta API-anrop.
exact:
- Plattformens slutliga orderstatus är
Finished. - Orderns
pay_idskrivs in i samma Base-transaktionshash. 1200000atomic USDC motsvarar1.2USDC, vilket är det historiska faktiskt betalda beloppet för denna order på 10 Credits enligt den gamla policyn; nya ordrar får inte längre ytterligare rabatt för betalningsmetoden X402, och det specifika signerade beloppet ska baseras på detta 402-svar.
Solana
Solana använder SPL USDCTransferChecked. Klienten konstruerar en överföringstransaktion, signerar och skickar in den, och lägger sedan transaktionssignaturen eller den serialiserade transaktionen i envelopen PAYMENT-SIGNATURE.
Egenskaper för Solana:
- 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.
exact-verifieringsresultat:
- Det betalda återförsöket har returnerat HTTP 200, och modellen har producerat
ADC_SOLANA_E2E_OK. - Vid sökning efter on-chain-signature via offentlig RPC kan hastighetsbegränsning förekomma.
- Eftersom offentliga RPC-sökningar kan begränsas anges ingen Solana explorer här. Vid strikt avstämning, använd egen Solana RPC eller bekräfta transaktionssignaturen via plattformens settlement-poster.
Hur du väljer
Oavsett vilken kedja du väljer ska priser inte hårdkodas i klienten. Priset bestäms av
accepts[].maxAmountRequired som returneras av servern.
Lägg till nya EVM-nätverk
Kodstöd har tillhandahållits för betalningar med fasta belopp i inhemsk USDC på följande nätverk, och öppnas ett nätverk i taget. Tillgänglighet avgörs avaccepts som returneras av ordern eller API:et; det innebär inte att alla nätverk har aktiverats i produktion.
Dessa nätverk stöder endast
exact, och valutans precision är 6. Använd inte bryggad USDC med samma namn.
Vid användning av den officiella TypeScript/Python X402 Client kan du ange förkortningen eller CAIP-2-identifieraren i tabellen.
Klienten använder mål-kedje-ID:t för att konstruera signaturen; plånboken måste stödja målnätverket.
Den officiella stödtabellen för Phantom-tilläggsplånboken listar Arbitrum och Polygon; Optimism, Avalanche
finns för närvarande inte med i tabellen, och Rabby eller MetaMask som stöder målkedjan kan användas. EVM-adresser kan vara samma på olika kedjor,
men saldona är oberoende av varandra, och Solana-adresser är inte tillämpliga för EVM USDC.
Se Phantom-plånbokens stödtabell.
Gradvis lanseringsingång för nya nätverk
Ingången för nya kedjor är dold som standard. När du öppnar konsolen eller Studio kan du använda?features=x402-arbitrum
för att aktivera motsvarande kedja, och flera flaggor separeras med kommatecken. Stäng av en enskild kedja med ?features=-x402-arbitrum,
och rensa lokala åsidosättningar med ?features=none. Inställningarna sparas separat för varje domän.
Orderofferter och återförsök av betalningar använder samma inställning, och servern validerar oberoende; befintliga betalningsposter kan fortfarande visas.
Att endast aktivera sidflaggan aktiverar inte en kedja som ännu inte har konfigurerats; de specifika betalbara nätverken avgörs fortfarande av accepts i realtid.
