← Blog
10 min di lettura
|
Pubblicato
|
Aggiornato

Chaingateway V2.1 Beta: testnet e webhook

Chaingateway V2.1 beta, rilasciata il 16 settembre 2024: supporto testnet, sistema di webhook ricostruito, dashboard ridisegnata e passi per migrare dalla V2.

Capitoli
C
Chaingateway Team
Esperti di blockchain

Verificato da Maurice Sobiera

Chaingateway V2.1 è la riscrittura del 2024 dell’API e della dashboard di Chaingateway. Ha aggiunto il supporto ai testnet tramite l’header X-Network, un sistema di webhook ricostruito e un’interfaccia utente ridisegnata. L’URL di base dell’API è passato da api.chaingateway.io/v2 a app.chaingateway.io/api/v2. Questa nota elenca le modifiche e i passi di migrazione dall’annuncio della beta del 16 settembre 2024.

Aggiornamento, 5 novembre 2026: la V2.1 è l’API attuale. Da questo rilascio sono stati aggiunti Solana e Arbitrum (Solana non ha webhook), il Tron Paymaster descritto qui sotto è stato deprecato, e i pagamenti crypto per i piani sono cambiati nell’aprile 2025 (vedi New payment flow). L’elenco degli endpoint è nel file OpenAPI.

Come accedo alla V2.1?

La V2.1 è disponibile per tutti i clienti e per gli utenti in trial, su app.chaingateway.io. È stata progettata per essere compatibile con la V2, quindi la maggior parte delle integrazioni richiede solo un nuovo URL di base. I passi di migrazione sono alla fine di questa nota.

Se il vostro trial è scaduto, create un account oppure contattateci per prolungarlo. La beta aveva anche una community Telegram.

Che cosa c’è di nuovo nella V2.1?

Il rilascio conteneva queste modifiche:

  1. Supporto testnet su ogni chain.
  2. Tron Paymaster, un servizio di commissioni per i trasferimenti TRC-20. Ora è deprecato.
  3. Documentazione dell’API con esempi di richiesta e risposta.
  4. Un portale per sviluppatori rielaborato.
  5. Una dashboard ridisegnata.
  6. Cambi di piano immediati per i pagamenti con carta.
  7. Un sistema di webhook ricostruito e una nuova gestione delle commissioni.

Quali testnet sono supportati?

Aggiungete l’header X-Network: testnet a una richiesta per usare la rete di test di una chain. Per la mainnet inviate X-Network: mainnet oppure omettete l’header. Tutto ciò che si può fare sulla mainnet funziona anche sul testnet. Potete cambiare rete anche dall’intestazione della dashboard.

ChainTestnet nella V2.1Riferimento
EthereumSepoliaethereum.org: networks
TronNileTRON developer hub: networks
BNB Smart ChainBSC testnetBNB Chain docs
PolygonAmoyPolygon docs
BitcoinTestnet3Bitcoin developer examples: testing

L’elenco attuale, che comprende anche Arbitrum Sepolia e il devnet di Solana, si trova nella documentazione sulle reti supportate.

Intestazione della dashboard di Chaingateway con il banner «You are in TESTNET mode» e l'interruttore del testnet

Che cos’era il Tron Paymaster?

Paymaster era un servizio che pagava le commissioni di Energy e Bandwidth per i trasferimenti TRC-20, così che un wallet non dovesse possedere TRX. Era fatturato separatamente dall’abbonamento, e sul testnet non costava nulla. Paymaster è deprecato. Usate invece TronFuel. La vecchia guida a Paymaster resta disponibile come riferimento.

Che cosa è cambiato nella documentazione e nella dashboard?

La documentazione dell’API ha più esempi di richiesta e risposta, e il portale per sviluppatori ha una nuova guida introduttiva e tutorial per le funzioni principali. La dashboard è stata ridisegnata, e il monitor dei webhook permette di ispezionare i payload inviati e di filtrarli per valore.

Dashboard di Chaingateway con i contatori di richieste e transazioni, un grafico delle richieste e un elenco di webhook falliti

Che cosa è cambiato nella fatturazione?

I clienti che pagano con carta tramite Stripe possono passare subito a un piano superiore, invece di attendere il ciclo di fatturazione successivo. Se raggiungete i limiti dell’API, cliccate su «Change Plan» nella pagina di fatturazione, e i limiti aumentano subito. La fattura mostra solo la differenza di prezzo tra il vecchio e il nuovo piano. L’annuncio precisava che lo stesso sarebbe valso per i pagamenti crypto, che sono arrivati con il flusso di pagamento dell’aprile 2025.

Che cosa è cambiato tecnicamente?

L’API gira su un nuovo stack tecnologico. L’annuncio segnalava che alcune risposte potevano differire leggermente dalla V2 e chiedeva di segnalare le differenze al supporto.

La gestione delle commissioni è stata rielaborata. Se le vostre richieste impostano gasPrice, maxFeePerGas o maxPriorityFeePerGas, nella V2.1 non è più necessario inviarli. I campi del gas restano facoltativi nella definizione OpenAPI attuale.

Il sistema di webhook è stato ricostruito dopo le interruzioni del servizio webhook nelle settimane precedenti al rilascio, durante le quali alcuni blocchi non erano stati elaborati. Il monitor dei webhook nella dashboard mostra i payload inviati. I webhook non vengono ripetuti automaticamente. Le notifiche fallite sono elencate per chain, per esempio sotto GET /api/v2/tron/webhooks/notifications/failed, e si inviano di nuovo con l’endpoint di retry.

Che cosa era previsto dopo la V2.1?

L’annuncio indicava tre seguiti: supporto a Solana, Paymaster per altre chain e correzioni alle risposte dell’API. Il supporto a Solana è stato rilasciato. Paymaster è stato invece deprecato anziché esteso.

Come si migra dalla V2 alla V2.1?

  1. Cambiate l’URL di base da api.chaingateway.io/v2 a app.chaingateway.io/api/v2.
  2. Facoltativo ma consigliato: aggiungete il prefisso Bearer alla vostra chiave API, così che l’header sia Authorization: Bearer <token>.
  3. Testate la vostra integrazione sul nuovo URL.
  4. Finché la migrazione non è completa, gestite l’abbonamento nella vecchia dashboard.

I dati degli utenti, gli indirizzi e le chiavi API sono stati copiati dalla V2 alla V2.1 ogni minuto durante la transizione. Gli indirizzi creati nella V2.1 non possono essere usati nella V2. I webhook sono stati copiati ogni 10 minuti e durante la copia non hanno attivato notifiche. Se vi serve aiuto per migrare i webhook, contattate il supporto.

Come scriviamo questi articoli

Pronto a costruirlo da solo? Ottieni la tua API key — prova di 7 giorni, senza carta — oppure consulta Blockchain API per il riferimento completo degli endpoint.

C
Chaingateway Team
Esperti di blockchain

Il team di Chaingateway si impegna a semplificare l'integrazione blockchain per sviluppatori di tutto il mondo.