Comment lire une transaction BSC, champ par champ

Pour lire une transaction BSC, collez son hash dans un explorateur BNB Smart Chain et vérifiez d’abord quatre choses : le statut (réussie, échouée ou en attente), le bloc et les confirmations, les adresses « De » et « À », puis la section des transferts de tokens. Tout le reste (gas, nonce, données d’entrée et logs) explique comment et pourquoi c’est arrivé.

Ça, c’est la version en trente secondes. La suite de ce guide, c’est la version longue, écrite pour le moment où un paiement « n’est pas arrivé », où un swap a échoué tout en vous coûtant des frais, ou encore où le support vous réclame « le TxID » sans que vous sachiez de quoi il parle. Nous prenons comme référence la présentation de BscScan et de notre propre outil de vérification de transactions BNB, mais les champs sont les mêmes sur BSCTrace, OKX Explorer ou tout autre outil de notre classement des explorers. Ils lisent tous la même blockchain.

Qu’est-ce qu’un hash de transaction sur BNB Smart Chain ?

Le hash de transaction est l’identifiant de la transaction : 0x suivi de 64 caractères hexadécimaux, par exemple 0x5c50…e3a1. Il s’agit d’un hash Keccak-256 de la transaction signée : il découle donc de son contenu même, et il suffit de modifier un seul octet pour obtenir un hash totalement différent. Les wallets l’appellent « ID de transaction », « TxID » ou « Tx hash » ; c’est exactement la même chose.

Deux conséquences pratiques. D’abord, le hash existe dès que votre wallet signe, avant même que la transaction figure dans un bloc : un hash seul ne prouve donc pas que quoi que ce soit s’est passé on-chain. Il faut encore le rechercher. Ensuite, un hash ne dépend d’aucune chaîne : la même chaîne de 66 caractères peut être cherchée sur BNB Smart Chain, opBNB ou le testnet BSC, et elle ne sera trouvée que sur le réseau où elle a réellement été envoyée. Si un explorer répond « introuvable », vérifiez d’abord que vous êtes sur le bon réseau : un nombre étonnant de paiements « disparus » se trouvent sur le testnet, voire sur une tout autre chaîne EVM. (Les adresses, elles, sont plus courtes : 0x plus 40 caractères.)

Statut d’une transaction BSC : réussie, échouée ou en attente

La ligne de statut est le champ le plus important, et elle ne peut prendre qu’une poignée de valeurs. Réussie (Success) signifie que la transaction a été incluse dans un bloc et exécutée sans revert. Échouée (BscScan affiche « Fail » avec un motif comme « execution reverted ») signifie qu’elle a été incluse et exécutée, mais que le code s’est arrêté en cours de route et a annulé tous ses effets. En attente (Pending) signifie que le réseau l’a vue, mais qu’aucun validateur ne l’a encore placée dans un bloc. Enfin, Dropped & Replaced signifie qu’une autre transaction avec le même nonce a été confirmée à sa place : celle-ci n’aura donc jamais lieu.

Ce que « réussie » ne veut pas dire : que vous avez obtenu ce que vous attendiez. Un appel réussi au contrat d’un token frauduleux reste une réussite. Un transfert de faux « USDT » qui n’est pas le vrai contrat Tether reste une réussite. Le statut vous dit que le code s’est exécuté ; la section des transferts de tokens, plus bas, vous dit ce qui a réellement bougé. Gardez les deux en tête et vous éviterez la plupart des malentendus classiques.

Bloc, horodatage, confirmations, De et À

Bloc indique le numéro du bloc qui contient la transaction. À côté, la plupart des explorers affichent les confirmations, c’est-à-dire le nombre de blocs ajoutés depuis. Avec un bloc environ toutes les 0,45 seconde depuis le hard fork Fermi, les confirmations s’accumulent vite : une transaction vieille d’une minute en compte déjà bien plus d’une centaine. BNB Smart Chain dispose en outre d’une finalité rapide, qui rend un bloc irréversible en un peu plus d’une seconde. Les plateformes qui attendent encore des dizaines de confirmations font donc preuve de prudence, sans que la technique l’exige.

L’horodatage correspond à l’heure du bloc, pas au moment où vous avez appuyé sur « Envoyer ». Les explorers l’affichent en général en UTC et sous la forme « il y a x secondes ». Les blocs BSC portent désormais aussi un horodatage à la milliseconde, utile quand les blocs sont espacés de moins d’une demi-seconde, mais c’est l’heure lisible que vous communiquerez à votre interlocuteur.

De (From) est toujours un wallet classique (un compte détenu en externe, ou EOA) : seuls les wallets peuvent signer des transactions. À (To) est soit un autre wallet, soit un smart contract (contrat intelligent). C’est là que l’on se trompe le plus souvent. Quand vous envoyez de l’USDT, le champ « À » affiche le contrat du token USDT, 0x55d3…7955, et non l’adresse de votre ami. Le vrai destinataire apparaît dans la section des transferts de tokens. Si « À » est vide et que la page indique « Contract Creation », la transaction a déployé un nouveau contrat, et l’explorer affiche la nouvelle adresse à la place.

La valeur (Value) est le montant de BNB natif joint à la transaction. Pour un simple transfert de BNB, c’est le paiement lui-même. Pour un transfert de token ou un swap, elle vaut souvent 0 BNB, ce qui inquiète ceux qui s’attendaient à y lire « 100 USDT ». Rien d’anormal : les tokens ne sont pas du BNB, et leurs montants se trouvent dans les logs, pas dans le champ valeur.

Frais de transaction, prix du gas, limite de gas et nonce

Chaque opération sur BNB Smart Chain coûte du gas, une unité de travail de calcul. Les frais de transaction payés valent tout simplement gas consommé × prix du gas, affichés en BNB et souvent en dollars. Un simple transfert de BNB consomme toujours exactement 21 000 gas ; un transfert de token, quelques dizaines de milliers ; un swap sur un DEX passant par plusieurs pools, quelques centaines de milliers. Au plancher actuel du réseau, 0,05 gwei, le transfert de 21 000 gas coûte environ 0,00000105 BNB : une infime fraction de centime. Notre suivi des frais de gas BSC en direct montre ce que coûte le gas en ce moment.

La limite de gas est le maximum que votre wallet a autorisé la transaction à consommer ; le gas consommé est ce qu’elle a réellement utilisé. Les explorers affichent souvent les deux avec un pourcentage, par exemple « 131 402 / 197 103 (66,7 %) ». Le gas non utilisé n’est pas facturé. Si le gas consommé est pile égal à la limite et que le statut est échoué, la transaction est tombée à court de gas, et la renvoyer avec une limite plus haute règle généralement le problème.

Le prix du gas est ce que vous avez proposé par unité de gas, en gwei (un milliardième de BNB). BNB Smart Chain prend en charge les transactions de type EIP-1559, mais avec des frais de base fixés à zéro : sur BscScan, vous verrez donc « Base: 0 Gwei » à côté d’un max fee et d’un priority fee. En pratique, c’est le prix effectif du gas qui compte. Une partie des frais collectés dans chaque bloc est brûlée en vertu de BEP-95, d’où la ligne « burnt fees » sur certains explorers.

Le nonce est un compteur propre à chaque adresse d’envoi : votre première transaction a le nonce 0, la suivante 1, et ainsi de suite. Le réseau les traite strictement dans l’ordre. Si le nonce 41 est bloqué, les nonces 42, 43 et 44 attendent derrière lui, quel que soit le gas qu’ils proposent. Cette règle est agaçante quand ça coince, et extrêmement utile pour réparer, comme vous le verrez plus loin. L’explorer affiche aussi un type de transaction (0 pour les transactions legacy, 2 pour les EIP-1559), que vous pouvez la plupart du temps ignorer.

Méthode, données d’entrée et logs d’événements

Quand le destinataire est un contrat, la transaction transporte des données d’entrée (input data) : une instruction qui indique au contrat quelle fonction exécuter et avec quels arguments. Les quatre premiers octets forment le sélecteur de fonction. 0xa9059cbb correspond à transfer(address,uint256), 0x095ea7b3 à approve(address,uint256). Les explorers traduisent le sélecteur en un nom de méthode lisible (« Transfer », « Approve », « Swap Exact Tokens For ETH ») grâce à l’ABI du contrat vérifié ou à une base publique de signatures. Sur un contrat vérifié, BscScan sait aussi décoder chaque argument : vous voyez précisément le spender ou le montant que vous avez signé.

Pourquoi s’en soucier ? Parce que c’est dans la méthode que se cachent les autorisations. Si vous pensiez acheter un token et que la méthode indique « Approve » ou « Set Approval For All », vous n’avez encore rien acheté : vous avez donné à un contrat la permission de déplacer vos tokens. C’est normal sur un DEX, et dangereux sur un site de phishing. Notre guide pour suivre un wallet BNB et ses autorisations explique comment les passer en revue et les révoquer ensuite.

Les logs d’événements sont des messages que le contrat émet pendant son exécution. C’est grâce à eux que les explorers savent ce qui s’est passé à l’intérieur. Le plus courant sur BNB Smart Chain est l’événement BEP-20 Transfer, dont le premier topic commence toujours par 0xddf252ad. Chaque log indique le contrat émetteur (le token), les topics indexés (expéditeur et destinataire) et les données (le montant). Les swaps produisent une grappe de logs (transferts vers et depuis le pool, un Sync, un Swap) et les lire dans l’ordre est le moyen le plus fiable de reconstituer une transaction complexe.

Transferts de tokens et transactions internes sur BSC

La section des transferts de tokens (BscScan l’appelle « ERC-20 Tokens Transferred », notre outil « Transferts de tokens ») est le résumé lisible des logs Transfer : quel token, combien, de qui, vers qui. C’est le champ qui répond à « l’USDT est-il arrivé ? ». Vérifiez le nom du token et l’adresse de son contrat : le vrai USDT BEP-20 est 0x55d398326f99059fF775485246999027B3197955, et il utilise 18 décimales, contrairement au Tether d’Ethereum. Tout autre contrat qui se fait appeler USDT est une copie. Notre explorer de tokens BEP-20 liste les contrats authentiques des grands stablecoins.

Les transactions internes sont une tout autre affaire. Ce sont des mouvements de BNB natif déclenchés par un contrat pendant l’exécution : un routeur qui vous verse des BNB après la vente d’un token, un bridge qui libère des fonds, un multisig qui relaie un paiement. Personne ne les signe, elles n’ont pas de hash propre et n’apparaissent pas dans le reçu standard de la transaction. Les explorers les reconstituent en traçant l’exécution, et BscScan comme BSCTrace les affichent dans un onglet « Internal Txns ». Donc si quelqu’un vous dit « je t’ai envoyé des BNB depuis la plateforme » et que la valeur de la transaction est nulle, regardez là. Les explorers légers qui ne lisent que les données RPC publiques, le nôtre compris, affichent les logs et les transferts de tokens, mais pas les appels internes tracés : passez sur BscScan quand vous en avez besoin.

Transaction BNB en attente, échouée ou remplacée : que s’est-il passé ?

En attente

Sur BNB Smart Chain, l’attente est censée durer un clin d’œil. Avec des blocs de moins d’une seconde, une transaction saine est généralement incluse en une ou deux secondes. Si elle traîne, trois suspects habituels. Le prix du gas est inférieur à ce qu’acceptent les validateurs : certains wallets et bots codent encore en dur d’anciennes valeurs, et tout ce qui passe sous le plancher du réseau risque de ne même pas être relayé. Il y a un trou de nonce : une transaction antérieure de votre adresse n’a jamais été confirmée, et celle-ci attend derrière. Ou bien votre wallet a diffusé la transaction via un nœud RPC capricieux qui ne l’a jamais transmise, auquel cas l’explorer peut tout simplement ne pas la connaître. Le centre d’aide de BscScan explique d’ailleurs que les nœuds peuvent retirer des transactions en attente de leur pool quand les frais sont trop bas ou que les limites du pool sont atteintes.

Échouée (revert)

Une transaction échouée est définitive : elle est dans un bloc, pour toujours, avec une étiquette rouge. Le contrat s’est exécuté et a rencontré un require ou un revert, si bien que toutes les modifications d’état ont été annulées, sauf les frais. Sur PancakeSwap, les motifs classiques sont PancakeRouter: INSUFFICIENT_OUTPUT_AMOUNT (le prix a bougé au-delà de votre slippage), EXPIRED (l’échéance est dépassée) et TransferHelper: TRANSFER_FROM_FAILED (autorisation manquante, solde insuffisant ou token soumis à des restrictions de transfert). « Out of gas » signifie que la limite de gas était trop basse. Pour les tokens dont la vente échoue à chaque tentative, lisez notre guide pour repérer un honeypot sur un token BSC avant de dépenser un centime de plus en gas.

Dropped & Replaced

Ce statut signifie qu’une autre transaction, avec le même nonce et depuis la même adresse, a été confirmée en premier. En général, c’est vous : vous avez appuyé sur « Accélérer » ou « Annuler », et le wallet a envoyé un remplacement. L’explication de BscScan sur les transactions remplacées couvre les cas particuliers. L’essentiel : une seule des deux peut s’exécuter, donc une transaction remplacée ne « revient » jamais pour vous facturer deux fois.

Comment accélérer ou annuler une transaction BSC bloquée

La règle du nonce est votre bouée de sauvetage. Comme une seule transaction par nonce peut être confirmée, vous pouvez écraser une transaction bloquée en en envoyant une autre avec le même nonce et un prix du gas plus élevé. Voici la marche à suivre que nous appliquons.

1. 1

   Vérifiez qu’elle est vraiment bloquée

   Ouvrez le hash dans un explorer. S’il affiche En attente depuis plus d’une minute, ou si l’explorer ne le trouve pas du tout, contrôlez le nonce : tous les nonces antérieurs de votre adresse doivent déjà être confirmés.

2. 2

   Relevez le nonce de la transaction bloquée

   Le nonce figure sur la page de la transaction, et dans MetaMask parmi les détails de la transaction. Notez-le : la transaction de remplacement doit réutiliser exactement ce numéro.

3. 3

   Accélérer : renvoyez-la avec un prix du gas plus élevé

   Dans MetaMask ou Trust Wallet, appuyez sur Accélérer. Le wallet signe à nouveau la même transaction, avec le même nonce et des frais plus élevés. Les nœuds exigent en général un prix du gas supérieur d’au moins 10 % pour accepter un remplacement.

4. 4

   Ou annuler : envoyez-vous 0 BNB avec le même nonce

   Appuyez sur Annuler, ou envoyez manuellement un transfert de 0 BNB vers votre propre adresse avec le nonce bloqué et un prix du gas plus élevé. La première transaction incluse l’emporte ; l’autre passe en Dropped & Replaced.

5. 5

   Contrôlez le résultat dans l’explorer

   Recherchez votre adresse, pas l’ancien hash. Vous devez y voir le remplacement confirmé avec ce nonce. Ce n’est qu’ensuite que vous enverrez de nouvelles transactions, pour éviter de créer un nouveau trou de nonce.

MetaMask documente ces deux boutons dans son article d’aide sur les transactions en attente ; pour régler le nonce à la main, activez d’abord le nonce personnalisé dans ses paramètres. Si la transaction bloquée est déjà confirmée ou échouée, il n’y a rien à annuler : personne ne peut revenir sur une transaction minée, ni les validateurs ni les explorers. Et si votre wallet affiche « en attente » mais qu’aucun explorer n’a jamais entendu parler du hash, la transaction n’a jamais atteint le réseau : effacer les données d’activité du wallet puis renvoyer suffit en général. Avant de réessayer, vérifiez que votre wallet est sur le bon réseau avec les bons paramètres : notre guide pour ajouter BNB Smart Chain à MetaMask donne le chain ID et l’URL de l’explorer.

Preuve de paiement : pourquoi une capture d’écran ne prouve rien

Voici la vérité qui dérange sur les captures d’écran de pages d’explorer : ce sont des images. Modifier le montant, le destinataire ou le statut dans un navigateur prend quelques secondes avec les outils de développement, et les fausses images de « paiement confirmé » sont un grand classique des arnaques sur les places de marché et en OTC. Si l’on vous envoie une capture, demandez le hash et recherchez-le vous-même. Si c’est vous qui payez, envoyez le hash ou un lien que l’autre partie peut ouvrir.

C’est exactement ce pour quoi notre outil de recherche de transactions a été conçu. Recherchez n’importe quel hash BNB Smart Chain : le résultat propose un lien de partage permanent, le menu de partage natif et des boutons pour Telegram, WhatsApp et X. Le bouton Copier le reçu de paiement copie une courte preuve en texte brut (statut, montant, expéditeur, destinataire, heure, confirmations et lien) pour que le destinataire la vérifie d’un geste. Rien n’est conservé et aucune connexion n’est requise ; le reçu n’est qu’un emballage pratique autour de données publiques, et c’est le lien qu’il contient qui le rend digne de confiance.

Bien contrôler un reçu prend dix secondes : le statut est réussi, le contrat du token est le bon, le destinataire est l’adresse attendue (comparez les six premiers et les six derniers caractères, pas seulement les quatre premiers) et les confirmations continuent d’augmenter. Si ces quatre conditions sont remplies, le paiement est définitif. Pour un deuxième avis, ouvrez le même hash sur BscScan ou BSCTrace : les données concorderont, car tous les explorers lisent le même registre public. Les développeurs qui veulent faire la même vérification par programme peuvent lire le reçu via JSON-RPC, comme le montre notre guide de l’API des explorers BNB, et le modèle de transaction sous-jacent est décrit dans la documentation d’ethereum.org sur les transactions, qui s’applique trait pour trait à BSC.