Skip to main content
Ace Data Cloud X402 attualmente effettua regolamenti in USDC e supporta due tipi di chain: EVM e Solana. Le modalità di firma, gli indirizzi degli asset, il comportamento del gas e gli scenari applicabili differiscono tra le varie reti; prima dell’integrazione è necessario scegliere la rete.

​
L’identificatore di rete utilizza CAIP-2

accepts[].network di x402 v2 è un identificatore CAIP-2, non un’abbreviazione come base o skale. Quando il client abbina la rete, deve confrontare la stringa CAIP-2:

​
Matrice di supporto

upto è attualmente disponibile solo su Base. Gli elementi effettivamente disponibili dipendono da accepts restituito dall’API. Puoi anche controllare il Facilitator:
La risposta del Facilitator /supported:
Spiegazione dei risultati:
  • Gli exact di Base, SKALE e Solana sono percorsi di pagamento a importo fisso.
  • Solo Base fornisce il percorso di misurazione posticipata upto, che dipende dall’approvazione Permit2.
  • extra.facilitatorAddress nell’elemento upto è l’indirizzo da scrivere nel witness durante la firma del client e deve essere coerente con il valore restituito dal server.

​
Base

Base utilizza il contratto USDC ufficiale:
Nello schema exact, il client firma TransferWithAuthorization EIP-712. Il contenuto della firma include:
  • from: indirizzo del wallet pagatore
  • to: indirizzo destinatario di Ace Data Cloud
  • value: importo di questo pagamento
  • validAfter / validBefore: finestra temporale di validità della firma
  • nonce: nonce casuale di 32 byte
Dopo aver verificato la firma, il Facilitator chiamerà on-chain transferWithAuthorization di USDC per completare il trasferimento. Base è la rete più consigliata per l’integrazione in produzione, specialmente per la misurazione posticipata upto, poiché gli ecosistemi Permit2, USDC e wallet sono tutti più maturi. Esempio di risultato della verifica Base exact:
Spiegazione dei risultati:
  • Il retry pagato dell’API restituisce il contenuto del modello ADC_BASE_E2E_OK.
  • La transazione on-chain è consultabile su BaseScan e il numero del blocco è 46726299.
  • 95215 atomic USDC corrispondono a 0.095215 USDC, ovvero l’importo effettivamente regolato per questa chiamata API.
Risultato dell’esecuzione del programma per il pagamento dell’ordine Base exact:
Spiegazione dei risultati:
  • Lo stato finale dell’ordine sulla piattaforma è Finished.
  • Il pay_id dell’ordine scrive lo stesso hash della transazione Base.
  • 1200000 atomic USDC corrispondono a 1.2 USDC, ovvero l’importo storico effettivamente pagato per questo ordine da 10 Credits secondo la vecchia politica; i nuovi ordini non usufruiscono più di uno sconto aggiuntivo per il metodo di pagamento X402 e l’importo specifico della firma dipende dalla risposta 402 di questa volta.

​
SKALE

SKALE utilizza USDC bridged e il metodo di firma è simile a Base, anch’esso EIP-3009. È adatto agli scenari di pagamento EVM a basso costo del gas; le chiamate effettive dipendono comunque da accepts restituito dall’API. I tipici accepts 402 di SKALE includeranno:
SKALE attualmente fornisce solo exact. Se hai bisogno della misurazione posticipata, utilizza Base upto. Esempio di risultato della verifica SKALE exact:
Spiegazione dei risultati:
  • Il paid retry dell’API restituisce il contenuto del modello ADC_SKALE_E2E_OK。
  • La transazione è già consultabile in SKALE explorer, il numero del blocco è 1969317。
  • L’importo di regolamento di questo pagamento exact è 0.095215 USDC。

​
Solana

Solana utilizza SPL USDC TransferChecked。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 una secret key base58；
  • l’asset è il mint USDC di Solana；
  • attualmente supporta solo exact；
  • il Facilitator verifica il mint, la destination, l’authority e l’amount della transfer instruction。
Se si utilizza la modalità wallet fee payer, il wallet invierà direttamente la transazione, e il Facilitator è responsabile della conferma della transazione e della restituzione del risultato di settlement。 Esempio di risultato della verifica Solana exact：
Spiegazione dei risultati：
  • il paid retry ha già restituito HTTP 200, e il modello ha prodotto ADC_SOLANA_E2E_OK。
  • la query della signature on-chain tramite RPC pubblico potrebbe incontrare limitazioni di frequenza。
  • poiché la query RPC pubblica potrebbe essere soggetta a limitazioni di frequenza, qui non viene indicato Solana explorer。Quando è necessario un riconciliamento rigoroso, utilizzare il proprio RPC Solana o i record di settlement lato piattaforma per confermare la firma della transazione。

​
Come scegliere

Indipendentemente dalla chain scelta, non hardcodare i prezzi nel client。Il prezzo è determinato da accepts[].maxAmountRequired restituito dal server。