Chaingateway V2.1 Beta : testnets et webhooks
Chaingateway V2.1 bêta, publiée le 16 septembre 2024 : testnets, webhooks reconstruits, tableau de bord repensé et migration depuis la V2.
Relu par Maurice Sobiera
Chaingateway V2.1 est la réécriture 2024 de l’API et du tableau de bord Chaingateway. Elle ajoute la prise en charge des testnets via l’en-tête X-Network, un système de webhooks reconstruit et une interface utilisateur repensée. L’URL de base de l’API est passée de api.chaingateway.io/v2 à app.chaingateway.io/api/v2. Cette note récapitule les changements et les étapes de migration depuis l’annonce de la bêta du 16 septembre 2024.
Mise à jour du 5 novembre 2026 : la V2.1 est l’API actuelle. Depuis cette sortie, Solana et Arbitrum ont été ajoutés (Solana n’a pas de webhooks), le Tron Paymaster décrit plus bas a été déprécié, et les paiements crypto pour les forfaits ont changé en avril 2025 (voir Nouveau flux de paiement). La liste des endpoints figure dans le fichier OpenAPI.
Comment accéder à la V2.1 ?
La V2.1 est disponible pour tous les clients et utilisateurs d’essai sur app.chaingateway.io. Elle a été conçue pour être compatible avec la V2, si bien que la plupart des intégrations n’ont besoin que d’une nouvelle URL de base. Les étapes de migration figurent à la fin de cette note.
Si votre essai a expiré, créez un compte, ou contactez-nous pour le prolonger. La bêta disposait aussi d’une communauté Telegram.
Quoi de neuf dans la V2.1 ?
La sortie comprenait ces changements :
- Prise en charge des testnets sur chaque chaîne.
- Tron Paymaster, un service de frais pour les transferts TRC-20. Il est désormais déprécié.
- Documentation API avec des exemples de requêtes et de réponses.
- Un portail développeur repensé.
- Un tableau de bord redessiné.
- Changements de forfait instantanés pour les paiements par carte.
- Un système de webhooks reconstruit et une nouvelle gestion des frais.
Quels testnets sont pris en charge ?
Ajoutez l’en-tête X-Network: testnet à une requête pour utiliser le réseau de test d’une chaîne. Pour le mainnet, envoyez X-Network: mainnet ou omettez l’en-tête. Tout ce que vous pouvez faire sur le mainnet fonctionne aussi sur le testnet. Vous pouvez aussi changer de réseau depuis l’en-tête du tableau de bord.
| Chaîne | Testnet dans la V2.1 | Référence |
|---|---|---|
| Ethereum | Sepolia | ethereum.org : réseaux |
| Tron | Nile | Hub développeur TRON : réseaux |
| BNB Smart Chain | BSC testnet | Documentation BNB Chain |
| Polygon | Amoy | Documentation Polygon |
| Bitcoin | Testnet3 | Exemples développeur Bitcoin : tests |
La liste actuelle, qui comprend aussi Arbitrum Sepolia et le devnet Solana, figure dans la documentation réseaux pris en charge.

Qu’était le Tron Paymaster ?
Paymaster était un service qui payait les frais d’Energy et de Bandwidth des transferts TRC-20, afin qu’un portefeuille n’ait pas besoin de détenir de TRX. Il était facturé séparément de l’abonnement, et il ne coûtait rien sur le testnet. Paymaster est déprécié. Utilisez plutôt TronFuel. L’ancien tutoriel Paymaster reste disponible pour référence.
Qu’est-ce qui a changé dans la documentation et le tableau de bord ?
La documentation API comporte davantage d’exemples de requêtes et de réponses, et le portail développeur propose un nouveau guide de démarrage et des tutoriels pour les fonctions principales. Le tableau de bord a été redessiné, et le moniteur de webhooks permet d’inspecter les charges utiles envoyées et de filtrer par valeur.

Qu’est-ce qui a changé pour la facturation ?
Les clients qui paient par carte via Stripe peuvent passer immédiatement à un forfait supérieur, au lieu d’attendre le cycle de facturation suivant. Si vous atteignez vos limites d’API, vous cliquez sur « Changer de forfait » dans la page de facturation, et les limites augmentent aussitôt. La facture n’affiche que la différence de prix entre l’ancien et le nouveau forfait. L’annonce précisait que la même chose suivrait pour les paiements crypto, ce qui a été livré avec le flux de paiement d’avril 2025.
Qu’est-ce qui a changé techniquement ?
L’API repose sur une nouvelle pile technologique. L’annonce notait que certaines réponses pouvaient différer légèrement de la V2, et demandait aux utilisateurs de signaler les écarts au support.
La gestion des frais a été repensée. Si vos requêtes définissent gasPrice, maxFeePerGas ou maxPriorityFeePerGas, vous n’avez plus besoin de les envoyer en V2.1. Les champs de gas restent facultatifs dans la définition OpenAPI actuelle.
Le système de webhooks a été reconstruit après des pannes du service de webhooks dans les semaines précédant la sortie, pendant lesquelles certains blocs n’avaient pas été traités. Le moniteur de webhooks du tableau de bord affiche les charges utiles envoyées. Les webhooks ne sont pas relancés automatiquement. Les notifications échouées sont listées par chaîne, par exemple sous GET /api/v2/tron/webhooks/notifications/failed, et vous les renvoyez avec l’endpoint de relance.
Qu’était prévu après la V2.1 ?
L’annonce nommait trois suites : la prise en charge de Solana, Paymaster pour davantage de chaînes, et des corrections des réponses de l’API. La prise en charge de Solana est livrée. Paymaster a été déprécié au lieu d’être étendu.
Comment migrer de la V2 vers la V2.1 ?
- Remplacez l’URL de base
api.chaingateway.io/v2parapp.chaingateway.io/api/v2. - Facultatif, mais recommandé : ajoutez le préfixe
Bearerà votre clé API, afin que l’en-tête se liseAuthorization: Bearer <token>. - Testez votre intégration avec la nouvelle URL.
- Tant que la migration n’est pas complète, gérez votre abonnement dans l’ancien tableau de bord.
Les données utilisateur, les adresses et les clés API ont été copiées de la V2 vers la V2.1 toutes les minutes pendant la transition. Les adresses créées dans la V2.1 ne peuvent pas être utilisées dans la V2. Les webhooks étaient copiés toutes les 10 minutes et ne déclenchaient pas de notifications pendant la copie. Si vous avez besoin d’aide pour migrer vos webhooks, contactez le support.
Comment nous rédigeons ces articles
Prêt à le construire vous-même ? Obtenir votre clé API — essai de 7 jours, sans carte bancaire — ou consultez API Blockchain pour la référence complète des endpoints.