API blockchain et interopérabilité : limites et possibilités
Les blockchains ne peuvent pas se lire entre elles. Comment ponts et protocoles déplacent les actifs entre chaînes, et ce qu'une API blockchain résout ou non.
Relu par Maurice Sobiera
L’interopérabilité blockchain est la capacité de chaînes distinctes à échanger actifs ou données. La plupart ne peuvent pas lire l’état des autres, donc transférer de la valeur demande un pont ou un protocole inter-chaînes. Une API blockchain ne le fournit pas : elle offre une interface unique vers plusieurs chaînes.
Pourquoi les blockchains ne peuvent-elles pas se parler ?
Chaque chaîne ne valide que ses propres données. Un smart contract sur Ethereum ne peut pas vérifier qu’une transaction a eu lieu sur Tron, car les deux réseaux utilisent des règles de consensus, des formats d’adresse et des structures de données différents. Un actif qui quitte sa chaîne doit donc être représenté sur la chaîne de destination par quelque chose que celle-ci peut vérifier. C’est le problème de confiance de l’interopérabilité.
Comment les actifs circulent-ils entre les chaînes ?
Par des ponts et des protocoles de messagerie inter-chaînes. La documentation Ethereum sur les ponts distingue deux modèles de confiance :
| Modèle | Fonctionnement | Compromis |
|---|---|---|
| Pont de confiance | Un ensemble externe de vérificateurs (un groupe à signatures multiples, un système MPC ou un réseau d’oracles) confirme les événements de la chaîne source | Rapide et souple, mais vous dépendez de la sécurité des vérificateurs |
| Pont sans confiance | Le pont s’appuie sur les validateurs des chaînes connectées | Hypothèses de sécurité plus fortes, mais moins capable de transporter des données complexes |
La même page signale les risques : failles des smart contracts, actifs enveloppés porteurs d’un risque systémique et risque de contrepartie. Elle indique que les ponts figurent parmi les trois plus gros piratages de la DeFi. Une autre conception est le protocole de communication inter-blockchains (IBC), dans lequel les chaînes vérifient mutuellement leur état via des clients légers. Il est utilisé entre les chaînes Cosmos et suppose que les deux chaînes le prennent en charge.
Aucune de ces options n’est une fonctionnalité d’une API REST. Si vous devez transférer de l’USDT d’Ethereum vers Tron, vous utilisez un pont ou une plateforme d’échange, et vous faites confiance à ce service.
Que fait une API blockchain pour l’interopérabilité ?
Elle supprime, côté application, les différences d’intégration entre chaînes. Chaque chaîne a son propre logiciel de nœud, son format d’adresse et son encodage. L’API Chaingateway utilise le même style de requête, la même authentification et la même enveloppe de réponse (status, ok, message, data) sur les chaînes prises en charge. Un moniteur de dépôts en USDT sur deux chaînes nécessite le même code avec deux paramètres modifiés. La première requête surveille une adresse sur Ethereum :
curl -X POST https://app.chaingateway.io/api/v2/ethereum/webhooks \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "to": "0x922815dFbEa128eAeaAAa185508fe078bECeFBBE", "contractaddress": "0xdac17f958d2ee523a2206206994597c13d831ec7", "type": "ERC20", "url": "https://example.com/hooks/deposit", "reference": "user-77-eth" }'La seconde surveille une adresse Tron pour la version TRC20 du même token. Seuls la chaîne dans le chemin, les formats d’adresse, l’adresse du contrat et le type changent :
curl -X POST https://app.chaingateway.io/api/v2/tron/webhooks \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "to": "TWrTTVizHkF3LxTiWE9vCnhWC7CBpNXe22", "contractaddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "type": "TRC20", "url": "https://example.com/hooks/deposit", "reference": "user-77-tron" }'Les deux notifications arrivent à la même URL avec les mêmes champs : identifiant de transaction, type, adresse du contrat, expéditeur, destinataire, numéro de bloc. Votre code se branche sur le type, et non sur le protocole du nœud de la chaîne. Des webhooks existent pour Ethereum, BNB Smart Chain, Polygon, Arbitrum, Tron et Bitcoin. Il n’en existe pas pour Solana. Les webhooks ne sont pas renvoyés automatiquement, ce qui vaut sur toutes les chaînes.
Quelles différences subsistent entre les chaînes prises en charge ?
L’API suit la structure de chaque chaîne là où les chaînes diffèrent. Ce tableau reprend ce que le fichier OpenAPI indique par chaîne :
| Famille de chaînes | Adresses et portefeuilles | Endpoints liés aux frais | Webhooks |
|---|---|---|---|
| Ethereum, BNB Smart Chain, Polygon, Arbitrum | POST .../addresses, .../addresses/import | GET .../gasprice | Oui |
| Tron | POST .../addresses, .../addresses/import | Geler, dégeler, déléguer, annuler la délégation, paramètres de chaîne | Oui |
| Bitcoin | POST .../wallets | aucun listé | Oui |
| Solana | POST .../addresses | aucun listé | Non |
Les endpoints de frais de Tron concernent l’énergie et la bande passante, que Tron utilise à la place d’un prix du gas. Les raisons tiennent aux chaînes et non à l’API : aucun wrapper ne peut les supprimer.
Que ne résout pas une API blockchain ?
Elle ne déplace pas d’actifs entre chaînes et ne fait pas vérifier une chaîne par une autre. Elle ne masque que les différences d’accès, pas les différences économiques. Tron facture des ressources (énergie et bande passante) là où Ethereum facture du gas. Les délais de confirmation diffèrent selon la chaîne, un solde d’USDT sur Ethereum est un actif différent d’un solde d’USDT sur Tron, et un token ponté est un troisième actif. Votre application doit donc toujours enregistrer la chaîne où se trouve chaque solde.
Les versions antérieures de cet article suggéraient que les API blockchain permettraient une adoption massive en faisant transiter des données entre chaînes. Cette affirmation ne pouvait pas être étayée, et le transfert de données inter-chaînes relève des protocoles de pont décrits plus haut.
Que faut-il demander avant d’utiliser un pont ?
La liste des risques de la page des ponts d’Ethereum donne les questions à poser. Pour le risque lié aux smart contracts, demandez si le pont a été audité et comment il a géré ses incidents passés. Pour le risque systémique, demandez s’il émet des actifs enveloppés et ce qui les garantit. Pour le risque de contrepartie, demandez qui exploite les vérificateurs et ce qui se passe s’ils s’arrêtent. Vérifiez les limites et les frais, et envoyez d’abord un petit montant.
La plateforme d’échange est l’autre voie. Vous déposez sur une chaîne et retirez sur une autre : la plateforme porte donc le risque inter-chaînes, et vous portez le risque de la plateforme. Aucune de ces voies ne fait partie de l’API. Enregistrez chaque transfert, y compris les identifiants de transaction sur les deux chaînes, pour pouvoir retracer un transfert bloqué.
Comment concevoir pour plusieurs chaînes ?
Enregistrez la chaîne avec chaque adresse, transaction et solde. Traitez un même token présent sur deux chaînes comme deux actifs. Choisissez délibérément la chaîne de chaque flux client, et affichez-la dans l’interface pour que les utilisateurs n’envoient pas de tokens sur le mauvais réseau. Testez chaque chaîne sur son testnet d’abord : ajoutez X-Network: testnet à une requête. Enfin, décidez comment vous gérez les notifications de webhook échouées, car l’API les liste sans les renvoyer seule.
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.