Gli identificatori di rete utilizzano CAIP-2
L’accepts[].network di x402 v2 è un identificatore CAIP-2, non un’abbreviazione come base o solana. Il client deve confrontare le reti in base alla stringa CAIP-2:
Matrice di supporto
upto è attualmente disponibile solo su Base. Le opzioni effettivamente disponibili dipendono da accepts restituito dall’API. Puoi anche consultare il Facilitator:
/supported:
- Gli
exactdi Base e Solana sono percorsi di pagamento a importo fisso. - Solo Base fornisce il percorso di misurazione successiva
upto, che dipende dall’approve Permit2. - L’
extra.facilitatorAddressnella voceuptoè l’indirizzo da inserire nel witness durante la firma del client e deve corrispondere al valore restituito dal server.
Base
Base utilizza il contratto USDC ufficiale:exact, il client firma EIP-712 TransferWithAuthorization. Il contenuto della firma include:
from: indirizzo del wallet pagatoreto: indirizzo di incasso di Ace Data Cloudvalue: importo del pagamento correntevalidAfter/validBefore: finestra temporale di validità della firmanonce: nonce casuale di 32 byte
transferWithAuthorization di USDC per completare il trasferimento.
Base è la rete di integrazione ufficiale più consigliata, particolarmente adatta alla misurazione successiva upto, poiché gli ecosistemi di Permit2, USDC e wallet sono più maturi.
Esempio di risultato della verifica Base exact:
- Il paid retry dell’API restituisce il contenuto del modello
ADC_BASE_E2E_OK. - La transazione on-chain è consultabile su BaseScan, e il numero del blocco è
46726299. 95215atomic USDC corrisponde a0.095215USDC, ossia l’importo effettivamente regolato per questa chiamata API.
exact:
- Lo stato finale dell’ordine della piattaforma è
Finished. - Il
pay_iddell’ordine viene scritto nello stesso hash della transazione Base. 1200000atomic USDC corrisponde a1.2USDC, ossia l’importo storico effettivamente pagato per questo ordine da 10 Credits secondo la vecchia politica; i nuovi ordini non usufruiscono più di sconti aggiuntivi per il metodo di pagamento X402, e l’importo specifico della firma dipende dalla risposta 402 corrente.
Solana
Solana utilizza SPL USDCTransferChecked. Il client costruisce una transazione di trasferimento, la firma e la invia, quindi inserisce la firma della transazione o la transazione serializzata nell’envelope PAYMENT-SIGNATURE.
Caratteristiche di Solana:
- Utilizza Solana wallet adapter o base58 secret key;
- L’asset è il mint di Solana USDC;
- Attualmente supporta solo
exact; - Il Facilitator verifica mint, destination, authority e amount della transfer instruction.
exact:
- Il paid retry ha già restituito HTTP 200 e il modello ha prodotto
ADC_SOLANA_E2E_OK. - Quando si interroga la signature on-chain tramite RPC pubblici, è possibile incontrare limitazioni di frequenza.
- Poiché le query RPC pubbliche possono essere soggette a limitazioni di frequenza, qui non viene indicato Solana explorer. Quando è necessario un riconciliazione rigorosa, utilizza il tuo Solana RPC o i record di settlement lato piattaforma per confermare la firma della transazione.
Come scegliere
Indipendentemente dalla catena scelta, non codificare i prezzi in modo hardcoded nel client. Il prezzo è determinato da
accepts[].maxAmountRequired restituito dal server.
Aggiungere reti EVM
Il supporto nel codice per pagamenti a importo fisso in USDC nativo sulle seguenti reti è stato fornito, e viene abilitato rete per rete. La disponibilità effettiva è determinata dall’accepts restituito dall’ordine o dall’API; ciò non significa che tutte le reti siano già abilitate in produzione.
Queste reti supportano solo
exact, e la precisione della valuta è 6. Non utilizzare USDC bridged con lo stesso nome.
Quando si utilizza il Client X402 TypeScript/Python ufficiale, è possibile passare l’abbreviazione nella tabella o l’identificatore CAIP-2.
Il client utilizza l’ID della catena di destinazione per costruire la firma; il wallet deve supportare la rete di destinazione.
La tabella di supporto ufficiale del wallet estensione Phantom elenca Arbitrum e Polygon; Optimism, Avalanche
non sono attualmente inclusi in questa tabella, ed è possibile utilizzare Rabby o MetaMask che supportano la catena di destinazione. Gli indirizzi EVM possono essere uguali su catene diverse,
ma i saldi sono indipendenti tra loro, e gli indirizzi Solana non sono applicabili a USDC EVM.
Vedere la tabella di supporto del wallet Phantom.
Punto di accesso graduale per nuove reti
I punti di accesso alle nuove catene sono nascosti per impostazione predefinita. Quando si accede alla console o a Studio, è possibile utilizzare?features=x402-arbitrum
per abilitare la catena corrispondente, e separare più flag con virgole. Per disabilitare una singola catena, utilizzare ?features=-x402-arbitrum,
per cancellare le sovrascritture locali utilizzare ?features=none. Le impostazioni vengono salvate separatamente per ciascun dominio.
Il preventivo dell’ordine e i tentativi di pagamento utilizzano lo stesso interruttore, e il server esegue una convalida indipendente; i record di pagamento esistenti restano visualizzabili.
L’abilitazione del solo flag della pagina non attiva una catena non ancora configurata, e le reti effettivamente pagabili restano determinate dall’accepts in tempo reale.
