API blockchain ou nœud : lequel choisir ?
Un nœud blockchain synchronise et stocke toute la chaîne. Une API blockchain héberge des nœuds et ajoute données décodées et webhooks. Coûts et choix.
Relu par Maurice Sobiera
Un nœud blockchain est un logiciel qui synchronise, valide et stocke une blockchain, et répond à des requêtes de bas niveau. Une API blockchain est un service hébergé qui exploite des nœuds pour vous et renvoie du JSON décodé, souvent avec des webhooks. Choisissez un nœud pour un contrôle total, et une API pour livrer des paiements sans gérer d’infrastructure.
De quoi avez-vous besoin pour interagir avec une blockchain ?
Toute application qui lit des soldes, envoie des transactions ou réagit à des dépôts a besoin d’une connexion à un nœud. Prenons un dépôt sur un exchange : un utilisateur voit une adresse Tron et y envoie 100 TRX. L’exchange doit apprendre que le transfert est arrivé. Il peut analyser lui-même chaque nouveau bloc, ou demander à un service de l’appeler quand une adresse reçoit des fonds. La lecture d’un solde fonctionne de la même manière. Quand vous consultez une adresse sur un explorateur de blocs comme Etherscan, l’explorateur a obtenu ce chiffre auprès d’un nœud.
Que faut-il pour exploiter son propre nœud ?
Vous installez un client, vous attendez la synchronisation initiale, puis vous gardez la machine à jour, sauvegardée et surveillée. Le matériel dépend de la chaîne. Pour Ethereum, la documentation officielle sur les nœuds indique comme minimum 2 cœurs de CPU, 16 Go de RAM, un SSD NVMe de 2 To et 25 Mbit/s de bande passante (vérifié le 5 novembre 2026). Ces chiffres évoluent avec les versions des clients et la croissance de la chaîne. La page elle-même note que l’exigence de disque sera probablement dépassée d’ici 2027. Un nœud Ethereum a besoin de deux logiciels, un client d’exécution et un client de consensus (ethereum.org). Les autres chaînes ont leurs propres exigences : un nœud complet Bitcoin et un nœud complet Tron ont chacun besoin de leur propre client, de leur propre disque et de leur propre temps de synchronisation.
Un nœud renvoie des données brutes. Sur l’interface JSON-RPC d’Ethereum, les quantités sont des chaînes hexadécimales. Une requête de solde renvoie par exemple 0x2386f26fc10000, soit 10^16 wei ou 0,01 ETH, et votre code doit le convertir. Les transferts de tokens sont des entrées de journal que vous décodez avec l’ABI du contrat.
La détection des dépôts est la partie la plus difficile. Les nœuds Ethereum peuvent pousser des événements via une souscription WebSocket, mais une connexion coupée laisse un trou que vous comblez en analysant les blocs. Un scanner que vous écrivez vous-même doit faire ceci :
- Récupérer chaque nouveau bloc, ou les journaux qui correspondent à l’événement
Transferdu token. - Comparer le destinataire de chaque transfert avec votre liste d’adresses de clients.
- Attendre assez de confirmations et gérer les blocs remplacés lors d’une réorganisation de la chaîne.
- Enregistrer le numéro du dernier bloc traité, pour qu’un redémarrage ne saute aucun bloc.
- Répéter tout cela pour chaque chaîne prise en charge, car chacune a son propre client et son propre format de données.
Pour Tron, la documentation sur la souscription aux événements décrit la voie par plug-in, que vous devez aussi exploiter.
Que fait différemment une API blockchain ?
Elle exploite les nœuds, décode les données et les expose sous forme d’endpoints JSON. Avec Chaingateway, un webhook remplace l’analyse des blocs. Cette requête enregistre une URL qui est appelée lorsqu’une adresse donnée reçoit un token TRC20 :
curl -X POST https://app.chaingateway.io/api/v2/tron/webhooks \ -H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "to": "TWrTTVizHkF3LxTiWE9vCnhWC7CBpNXe22", "url": "https://example.com/hooks/deposit", "type": "TRC20", "reference": "order-1042" }'Des webhooks existent pour Tron, Ethereum, BNB Smart Chain, Polygon, Arbitrum et Bitcoin. Solana n’en a pas : sur Solana, vous interrogez les transactions à la place.
Que se passe-t-il quand un webhook échoue ?
Les notifications échouées ne sont pas renvoyées automatiquement. Elles apparaissent dans une liste que vous lisez avec GET /api/v2/<chain>/webhooks/notifications/failed. Vous appelez ensuite POST /api/v2/<chain>/webhooks/notifications/{id}/retry pour chaque entrée. Une notification qui échoue de nouveau retourne dans la liste. Chaque notification stockée contient l’ID de la transaction, le type (par exemple TRC20), l’adresse du contrat, l’expéditeur, le destinataire, le numéro de bloc et le nombre de tentatives.
Cela entraîne deux conséquences pour votre serveur récepteur. Il doit répondre rapidement avec un statut de succès. Il doit aussi supporter que le même événement arrive deux fois, par exemple après un renvoi manuel. Utilisez l’ID de la transaction comme clé de déduplication.
Que choisir : un nœud ou une API ?
Aucun des deux ne l’emporte en général. Le tableau montre où ils diffèrent.
| Nœud propre | API blockchain | |
|---|---|---|
| Mise en place | Installer le client, synchroniser, sécuriser le serveur | Créer un compte et un token |
| Matériel et entretien | À votre charge : disque, correctifs, mises à jour du client, surveillance | À la charge du fournisseur |
| Format des données | Brut (quantités hexadécimales, journaux encodés) | JSON décodé |
| Notifications de dépôt | Vous les construisez | Webhooks, là où l’API les prend en charge |
| Contrôle | Total : version du client, configuration, pas de limites partagées | Limité à ce que l’API expose |
| Coût | Serveurs et temps d’ingénierie | Prix du forfait, à l’usage ou mensuel |
| Gestion des pannes | Votre équipe | Infrastructure du fournisseur, mais vous en dépendez |
Choisissez un nœud si vous avez besoin de méthodes qu’une API n’expose pas, si vous devez contrôler la version du client, ou si des raisons réglementaires imposent de garder toute l’infrastructure en interne. Choisissez une API si votre produit n’est pas de l’infrastructure. Des équipes qui emploient déjà des ingénieurs blockchain utilisent parfois quand même une API pour les chaînes dont elles ne sont pas spécialistes.
Comment démarrer avec Chaingateway ?
Créez un compte pour l’essai gratuit de 7 jours, qui ne demande ni carte ni KYC, et utilisez le testnet en ajoutant X-Network: testnet à vos requêtes. Les forfaits commencent à 49 € par mois.
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.