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.
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:
- Supporto testnet su ogni chain.
- Tron Paymaster, un servizio di commissioni per i trasferimenti TRC-20. Ora è deprecato.
- Documentazione dell’API con esempi di richiesta e risposta.
- Un portale per sviluppatori rielaborato.
- Una dashboard ridisegnata.
- Cambi di piano immediati per i pagamenti con carta.
- 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.
| Chain | Testnet nella V2.1 | Riferimento |
|---|---|---|
| Ethereum | Sepolia | ethereum.org: networks |
| Tron | Nile | TRON developer hub: networks |
| BNB Smart Chain | BSC testnet | BNB Chain docs |
| Polygon | Amoy | Polygon docs |
| Bitcoin | Testnet3 | Bitcoin developer examples: testing |
L’elenco attuale, che comprende anche Arbitrum Sepolia e il devnet di Solana, si trova nella documentazione sulle reti supportate.

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.

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?
- Cambiate l’URL di base da
api.chaingateway.io/v2aapp.chaingateway.io/api/v2. - Facoltativo ma consigliato: aggiungete il prefisso
Beareralla vostra chiave API, così che l’header siaAuthorization: Bearer <token>. - Testate la vostra integrazione sul nuovo URL.
- 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.