Newsletter
Vérifier une transaction blockchain : méthode fiable13 min de lecture2 680 mots

Vérifier une transaction blockchain : méthode fiable

Apprenez à vérifier une transaction blockchain sans confondre donnée manquante et zéro. Une méthode concrète pour auditer vos chiffres on-chain.

vérification blockchainaudit on-chaintransaction cryptofinalité blockchaindonnées on-chain
Vérifier une transaction blockchain : méthode fiable

Un reçu parfaitement équilibré... sauf sur la blockchain

Un reçu de rachat de jetons avait tout pour plaire : chaque ligne était détaillée, les frais étaient calculés à six décimales et les soldes collaient au journal des échanges. Et pourtant, entre deux opérations, la trésorerie avait déboursé 0,0020265546 BNB de plus que ce que le document annonçait.

La cause était simple : un transfert de 0,002 BNB vers un portefeuille d'escrow, fait pour couvrir des frais de transaction. Le générateur de reçus n'avait juste pas pris en compte ces transferts liés au gas. L'équipe a reconnu l'omission et a corrigé l'outil. Mais ce qui m'intéresse, ce n'est pas seulement le bug : c'est qu'un contrôle bien cadré, donc reproductible, a permis de le repérer.

En finance décentralisée, un chiffre publié n'est vraiment utile que si on sait précisément ce qui a été interrogé : quelle adresse, quel bloc, quelles unités, et à quel niveau de finalité. Ce n'est pas une exigence réservée aux équipes techniques. Un trésorier, un analyste ou un investisseur peut avoir besoin de confirmer qu'un solde, un paiement ou un rapport correspond à l'état réel de la chaîne. Ci-dessous, une méthode concrète pour vérifier une affirmation on-chain sans transformer une donnée absente en certitude.

Pourquoi un reçu exact en apparence peut être faux

Un reçu de trésorerie décrit ce que la blockchain a permis de calculer, pas la blockchain elle-même. Il s'appuie sur des règles de collecte : quelles adresses sont suivies, quelles opérations sont incluses, comment les frais sont classés, et quelle fenêtre temporelle (ou quel intervalle de blocs) a été retenue. Si le logiciel qui produit le reçu oublie une catégorie de transfert, le document peut rester cohérent ligne par ligne tout en donnant un total incomplet.

Le vrai piège, c'est de confondre cohérence interne et exactitude externe. Un tableur additionne ce qu'on lui donne - ça ne prouve pas que toutes les sorties de fonds ont été capturées. Et un tableau de bord peut afficher un solde très précis, sans préciser le bloc interrogé ni la source des données.

Dans l'exemple du rachat, le contrôle utile consistait à comparer, sur une plage de blocs, la somme des sorties de BNB avec la ligne nette du reçu. Le transfert d'escrow apparaissait bien dans les données on-chain, mais il manquait dans le calcul du générateur de reçus. L'écart de 0,0020265546 BNB regroupait le transfert de 0,002 BNB et les frais associés. Ce n'était pas un simple problème d'arrondi : c'était une étape omise.

Cette leçon vaut pour toute équipe qui produit des rapports à partir d'un réseau public : toute affirmation doit être vérifiable via une requête définie, et appuyée par des preuves conservées. Dire « le solde est correct » ne suffit pas. Il faut pouvoir dire : de quel compte à quel bloc, avec quelle requête, et dans quelles unités.

En DeFi, c'est encore plus important : une même trésorerie peut interagir avec plusieurs contrats, réseaux, et portefeuilles. Un rapport adressé à des associés, à un comité d'investissement ou à des utilisateurs doit permettre de distinguer ce qui a été réellement contrôlé de ce qui est seulement affiché. Pour mieux comprendre les transactions sur une blockchain publique, il faut donc regarder au-delà du reçu et fixer les conditions de vérification.

Les six contrôles à appliquer à une affirmation on-chain

1. Définir la question avant d'interroger le réseau

« Vérifier le solde » ne veut pas dire grand-chose pour un contrôle. La demande doit préciser au minimum :

  • l'adresse du contrat ou du portefeuille concerné ;
  • le réseau, et idéalement son identifiant de chaîne ;
  • la fonction interrogée, ou le type d'événement recherché ;
  • les arguments passés, avec l'encodage ABI si nécessaire ;
  • le bloc visé, ou l'usage explicite de la tête de chaîne (latest).

Pour un rapprochement de trésorerie, ça peut prendre une forme du genre : « Additionner toutes les sorties de BNB de cette adresse entre les blocs A et B, puis comparer à la ligne nette du reçu. » Là, le contrôle devient réellement répétable : quelqu'un d'autre peut reprendre la même plage de blocs et tester le même calcul.

Attention aussi à la différence entre un bloc fixe et une requête "latest". "Latest" bouge : une nouvelle confirmation ou une réorganisation de chaîne peut changer ce que renvoie l'état. Pour une vérification historique, un numéro de bloc fixe (avec son empreinte cryptographique) donne une référence plus stable.

2. Ne pas interpréter une réponse vide 0x comme un zéro

Une réponse vide 0x n'est pas la même chose qu'un zéro. Elle peut signifier un appel qui n'a pas abouti, une requête mal formée, un contrat indisponible à ce bloc, ou une limite côté fournisseur RPC. Ça peut aussi venir d'un problème de configuration ou d'accès aux données historiques.

Si un outil convertit silencieusement 0x en 0, il transforme une absence d'information en affirmation positive : « le solde est nul ». C'est une erreur de catégorie. Tant que la cause n'est pas clarifiée, la conclusion correcte est non vérifiable.

Concrètement : refaites l'appel sur le réseau et le bloc demandés, puis comparez avec une seconde source (autre RPC, idéalement un nœud d'archive adapté). Si les réponses divergent, il faut diagnostiquer la divergence avant de publier un chiffre. Deux fournisseurs ne garantissent pas une vérité absolue à eux seuls, mais des réponses concordantes depuis des sources distinctes renforcent le contrôle.

3. Refuser les unités supposées

Les contrats renvoient souvent des entiers dans une unité minimale. Puis les interfaces affichent parfois 18 décimales par défaut. Sauf que 18 décimales n'est pas universel. L'échelle dépend du contrat, et un nombre "très propre" à l'écran ne dit pas forcément comment il faut l'interpréter.

Quand c'est possible, vérifiez decimals() et attachez cette information au contrat concerné. Si le contrat ne fournit pas cette donnée et que la documentation ne précise pas l'échelle, mieux vaut marquer l'unité comme inconnue plutôt que d'inventer une convention. Une mauvaise puissance de dix, et la valeur peut être mille fois trop grande ou trop petite. Le nombre de décimales visibles ne rend pas l'interprétation plus fiable.

Même prudence pour les frais et pour toute conversion : dites clairement si on parle de BNB, de wei, d'un jeton spécifique, ou d'un montant déjà converti. Si un montant en euros apparaît, il faut connaître le taux et l'horodatage. Une valeur de marché n'est pas la même chose qu'une quantité enregistrée sur la chaîne.

4. Lier la preuve à l'objet réellement interrogé

Un simple libellé « solde vérifié » ne permet pas de reproduire le contrôle. Pour que la preuve tienne, archivez ce qui relie le résultat à la requête :

  • le réseau et le numéro de bloc ;
  • le hash du bloc ;
  • la requête, ses paramètres et la réponse brute ;
  • la date de collecte et la source ;
  • une empreinte cryptographique (par ex. SHA-256) sur les données conservées.

Et il faut être clair sur ce que protège l'empreinte : si vous hachez du JSON "brut", deux fichiers qui décrivent les mêmes champs mais avec une sérialisation différente peuvent produire des empreintes différentes. La règle doit donc préciser si vous conservez exactement les octets reçus ou si vous appliquez une normalisation déterministe avant calcul. Sans ça, il y a bien un hash, mais il est difficile de comparer.

Dans tous les cas, reliez ce que vous publiez à un bloc pertinent : une capture d'écran ou un chiffre copié ne dit pas forcément pour quel bloc il a été extrait. Dans le contrôle du reçu, les soldes aux deux bornes ont été relus sur des blocs déterminés, puis comparés aux mouvements recensés. C'est ce rapprochement qui a rendu l'écart visible.

5. Intégrer la finalité dans le résultat

Le mot « confirmé » est trop vague. Une transaction peut être incluse dans un bloc sans que la finalité attendue par votre organisation soit atteinte. Sur une couche 2, l'inclusion rapide et l'ancrage ou la finalisation sur la couche de base ne correspondent pas forcément à la même étape. Les délais et les mécanismes varient selon le réseau.

Donc, un rapport doit préciser ce qu'il entend par "confirmation" : nombre de blocs observés, statut annoncé par le réseau, ou étape de finalité propre à la couche concernée. L'idée n'est pas d'imposer une définition unique. Le point, c'est de rendre explicite le niveau de certitude utilisé pour décider.

Pour un tableau de bord exploratoire, une inclusion récente peut suffire. Pour un rapprochement de trésorerie ou une décision de paiement importante, l'équipe peut exiger un seuil plus strict. Le niveau retenu dépend du risque, du réseau et de la valeur en jeu. Dans tous les cas, le statut de finalité doit accompagner la valeur.

6. Auditer aussi ce qui "semble" juste

Un contrôle sans anomalie reste un contrôle : question définie, paramètres conservés, sources vérifiées, preuve liée au bloc concerné.

C'est justement là que les erreurs passent le plus facilement. Quand le total concorde, on a vite tendance à s'arrêter. Pourtant, le reçu de l'exemple semblait lui aussi parfaitement équilibré au premier regard. La concordance n'est pas une preuve que le périmètre était complet : elle prouve seulement que le calcul a respecté ce qu'on lui a donné.

Un processus d'audit reproductible

Pour intégrer ces contrôles, vous n'avez pas besoin de construire une plateforme énorme. Un protocole simple, appliqué de façon régulière à chaque rapport, finit souvent par être plus robuste qu'un système complexe que personne ne sait relire.

Étape 1 : transformer l'affirmation en requête testable

Formulez le résultat attendu de manière précise. Par exemple : « Les sorties de l'adresse X sur le réseau Y, entre les blocs A et B, correspondent au total déclaré dans le reçu. » Précisez aussi les catégories incluses : transferts directs, appels de contrat, frais de gas, et transferts vers des escrows.

Cette étape évite le piège du rapprochement basé uniquement sur les lignes du rapport. Si une catégorie est exclue, le contrôle doit pouvoir le signaler.

Étape 2 : recueillir les données brutes

Exécutez les appels nécessaires ou récupérez les événements, en enregistrant paramètres et limites. Pour une vérification historique, utilisez des bornes de blocs explicites et vérifiez que le fournisseur peut réellement répondre à ce niveau de profondeur. Si les données ne sont pas disponibles, ne comblez pas le vide par un zéro "par défaut".

Étape 3 : confronter les sources et qualifier les unités

Refaites les appels importants via une autre source. Vérifiez l'unité attendue, et confirmez que le contrat interrogé est bien celui que vous pensez interroger. En cas de divergence : documentez, suspendez la conclusion, et traquez la cause.

Étape 4 : rapprocher les mouvements du résultat déclaré

Calculez les entrées et sorties à partir des données retenues, puis comparez au reçu. Séparez le montant transféré des frais de transaction. Cette séparation aide à comprendre un écart au lieu de le noyer dans un total unique.

Étape 5 : conserver la preuve et formuler une conclusion proportionnée

Archivez la requête, les réponses, les blocs et les empreintes. Puis formulez une conclusion qui reflète réellement le test : « vérifié pour les blocs A à B avec deux sources », « incohérence détectée », ou « non vérifiable faute de réponse historique ».

Évitez le raccourci « tout est correct » quand le périmètre ou la finalité n'ont pas été précisés.

Cette logique peut être automatisée dans un outil ou un agent, à condition que l'automatisation sache s'arrêter. Un bon système ne sort pas seulement un chiffre : il doit aussi signaler les unités inconnues, les réponses vides et les divergences de sources au lieu de deviner. Des outils comme Onchain Claim Verifier cherchent justement à appliquer ces garde-fous. Pour les contrôles liés aux portefeuilles, un compagnon comme Crypto Wallet Safety Check aide aussi à structurer la vérification.

Ce que cette méthode ne garantit pas

Un contrôle reproductible améliore la qualité des preuves, mais il ne rend pas un rapport "infaillible". Il ne prouve pas automatiquement que le contrat a été audité, que le code applique les règles attendues, ni que l'adresse examinée correspond à l'entité déclarée. Pour ça, il faut d'autres vérifications : analyse du contrat, gouvernance, documentation et procédures internes.

Et même si deux fournisseurs RPC répondent de façon cohérente, ils peuvent s'appuyer sur des infrastructures ou des données qui partagent la même racine. Des réponses concordantes réduisent certains risques d'erreur locale, mais ne remplacent pas l'analyse du réseau et de la méthode de collecte. Pour des montants importants, le choix des sources doit être proportionné au risque.

Enfin, une valeur exacte n'implique pas forcément une interprétation correcte. Le solde d'un portefeuille est parfois simple à lire. Mais déterminer si un mouvement correspond à une dépense, à un transfert interne, ou à une opération économique particulière demande du contexte. Il faut distinguer ce que la chaîne enregistre de ce que l'organisation en déduit.

L'objectif n'est donc pas de promettre une certitude absolue : c'est de rendre les limites visibles, de permettre à quelqu'un d'autre de refaire le contrôle, et de ne pas présenter une inconnue comme un fait. En pratique, cette discipline évite souvent davantage d'incidents que la multiplication de tableaux de bord.

Conclusion

Un reçu "équilibré" n'est pas forcément un reçu "complet". Pour vérifier une affirmation on-chain, il faut cadrer la question, distinguer une réponse vide d'un zéro, contrôler les unités, relier les données à un bloc précis et préciser le niveau de finalité. Le résultat doit rester vérifiable, qu'il confirme le rapport ou qu'il signale un écart.

Commencez par appliquer cette méthode à un seul rapprochement de trésorerie : choisissez une période, définissez les sorties à inclure, puis comparez au résultat obtenu à partir des données brutes de la chaîne. Si une réponse manque ou qu'une unité est incertaine, signalez la limite plutôt que de combler le vide. La blockchain ne fait pas d'arrondi sur votre rapport : vos contrôles ne devraient pas en faire non plus.

Questions frequentes

Non. `0x` correspond à une réponse vide, qui peut signaler un appel non abouti ou un problème d’accès aux données. Tant que la cause n’est pas vérifiée, la conclusion doit être « non vérifiable », et non « zéro ».
Identifiez le réseau, l’adresse, la fonction et ses paramètres, puis interrogez l’état à un numéro de bloc déterminé. Conservez aussi le hash de ce bloc, la réponse brute et la source RPC pour rendre le contrôle reproductible.
Non. Le nombre de décimales dépend du contrat. Vérifiez la valeur exposée par `decimals()` ou consultez une documentation fiable. Si l’échelle reste inconnue, indiquez-le plutôt que d’afficher un montant calculé sur une supposition.
Le terme peut désigner l’inclusion rapide de la transaction ou une étape ultérieure de finalité liée au fonctionnement de la couche 2. Le rapport doit préciser le statut retenu et le réseau concerné, car les mécanismes et les délais diffèrent.
Elles renforcent le contrôle, mais ne constituent pas une garantie absolue. Vérifiez aussi le réseau, le bloc, les paramètres, les unités et la cohérence de la méthode. Pour un enjeu important, adaptez l’indépendance des sources et le niveau de contrôle au risque.

Articles similaires