DÉPANNAGE · ETHEREUM
Transaction Ethereum échouée : pourquoi payer du gas ?
À la fin de ce cours : Comprendre ce qui a échoué et pourquoi du travail peut avoir été facturé.
01 / DÉBUTANT
D’abord, de quoi parle-t-on ?
Sur Ethereum, une transaction peut être incluse dans un bloc mais échouer pendant l’exécution. Les changements prévus par l’appel sont alors annulés, tandis que du gas a été consommé. C’est différent d’une demande refusée avant d’être envoyée au réseau.
Les mots à connaître
- Échec d’exécution
- Les règles du programme ou la limite de ressources empêchent l’action d’aboutir.
- Revert
- Une interruption qui annule les changements d’état de l’exécution.
- Frais consommés
- Le coût du travail facturé, même si l’objectif n’est pas atteint.
L’idée à comprendre
Consulter le reçu sur le bon réseau. Distinguer refus local, attente et échec inclus avant de rechercher une cause. Une capture de l’interface n’est pas toujours suffisante.
VOIR EN PRATIQUE
Maintenant, un exemple concret
Un échange fictif exige au moins 10 unités reçues. À l’exécution, le résultat serait 9,8 : le contrat peut annuler l’échange pour respecter la limite. La protection sur le montant fonctionne, mais le travail exécuté peut coûter du gas.
À VOUS DE JOUER
Un échec facturé prouve-t-il que le destinataire a reçu le montant envoyé ?
Formulez une réponse avant d’ouvrir l’explication. Vous pouvez aussi en discuter à voix haute.
Comparer avec l’explication
Non. Les frais et l’effet prévu sont distincts. Vérifier le reçu et les changements effectifs ; ne pas déduire la réception du seul débit de frais.
02 / INTERMÉDIAIRE
Comment cela fonctionne, et pourquoi
Consulter le reçu sur le bon réseau. Distinguer refus local, attente et échec inclus avant de rechercher une cause. Une capture de l’interface n’est pas toujours suffisante.
Une condition de contrat non satisfaite, un prix ayant changé ou une limite de gas insuffisante peuvent expliquer un échec. Augmenter le montant des frais ne résout pas une règle de contrat qui reste fausse.
Le swap n’a pas eu lieu, mais votre solde d’ETH a diminué. La première question est le statut de la transaction dans l’explorateur du bon réseau. Le mot « erreur » dans une application ne suffit pas à déterminer ce qui a été facturé.
Lire le reçu d’une transaction échouée
Notre reçu fictif montre 53 000 unités de gas consommées à un prix effectif de 12 gwei. Le calcul donne 53 000 × 12 × 10⁻⁹ = 0,000636 ETH. Avec une hypothèse pédagogique de 3 000 € par ETH, cela représente 1,91 €. Ces nombres ne sont pas des cours actuels.
Sur Ethereum L1, le reçu permet de distinguer gas consommé et plafond de gas autorisé. Le plafond n’est pas automatiquement la dépense. Une erreur « out of gas » peut toutefois consommer toute la limite d’exécution. Sur une couche 2, l’affichage des frais peut comprendre d’autres composantes.
Pourquoi l’action a-t-elle échoué ?
Le motif dépend du contrat : délai dépassé, condition non satisfaite, montant minimum de sortie non atteint ou limite de calcul insuffisante. Recherchez le message exact dans le reçu, puis dans la documentation officielle de l’application. Une augmentation du prix du gas ne corrige pas une condition métier refusée.
Un achat en plusieurs étapes peut avoir un reçu réussi pour l’autorisation et un reçu échoué pour l’échange. L’échec de l’échange ne retire pas forcément l’autorisation précédemment confirmée. Vérifiez les opérations séparément.
Avant une nouvelle tentative
Conservez le hash et le message d’erreur. Vérifiez le réseau, le solde disponible pour les frais et les conditions de l’action. Relancer sans comprendre peut répéter la même dépense. Une opération encore en attente suit une autre procédure, expliquée dans notre guide dédié.
- Ne confondez pas prix du gas, quantité de gas et montant envoyé.
- Ne relevez pas aveuglément la tolérance au slippage pour faire disparaître une erreur.
- Un échec on-chain ordinaire ne crée pas un remboursement automatique des frais de réseau.
03 / APPROFONDI
Les règles derrière l’interface
Le reçu Ethereum expose un status et du gasUsed. Dans une transaction échouée, les effets d’exécution sont annulés, mais le nonce du compte émetteur est consommé et les frais restent dus. Une opération locale sans inclusion ne produit pas ce reçu.
Un revert peut fournir une raison exploitable ; un manque de gas obéit à des règles différentes. Un appel interne qui échoue peut aussi être géré par un contrat parent : vérifier le reçu global et la logique de l’application.
À VOUS DE JOUER
Le contrat refuse car l’émetteur n’a pas le rôle requis. Doubler la priorité suffit-il ?
Formulez une réponse avant d’ouvrir l’explication. Vous pouvez aussi en discuter à voix haute.
Comparer avec l’explication
Non. La priorité concerne l’inclusion ; elle ne donne pas une autorisation manquante. Il faut comprendre la condition rejetée avant de réessayer.
Les sources officielles en fin de page permettent d’examiner ces mécanismes plus en détail.
Que dit l’explorateur ?
Choisissez un statut pour comprendre ce qu’il signifie, puis lisez l’exemple fictif. Cet exercice ne recherche aucune transaction et ne se connecte pas à votre portefeuille.
La transaction a été incluse, mais l’exécution a échoué. Lisez le reçu : le gas consommé peut rester facturé. Identifiez l’erreur avant de recommencer.
- Statut
- Reverted
- Gas used
- 53 000
- Effective gas price
- 12 gwei
- Coût réseau
- 0,000636 ETH
53 000 × 12 gwei = 636 000 gwei = 0,000636 ETH. Un gwei vaut 0,000000001 ETH. Le gas réellement consommé reste facturé même si l’action demandée échoue ; refuser une demande avant diffusion est un autre cas.
Une lecture complémentaire : Lire une transaction sur Etherscan : le guide simple
LA RÉPONSE EN BREF
Une transaction Ethereum incluse dans un bloc peut échouer après avoir consommé du calcul. L’action est annulée, mais le gas utilisé reste facturé. Un simple refus dans le portefeuille avant envoi est différent : cette tentative n’a pas été exécutée sur la blockchain.
Les questions qui restent
Les tokens envoyés sont-ils perdus lors d’un revert ?
Dans une transaction EVM ordinaire révoquée par un revert, les changements de cette exécution sont annulés, mais les frais restent dus. Une autorisation ou une autre transaction antérieure demeure distincte. Vérifiez le reçu et les soldes plutôt que le seul message de l’interface.
Cliquer sur « Refuser » coûte-t-il du gas ?
Refuser une demande avant sa diffusion n’exécute pas cette demande sur le réseau. Vérifiez cependant qu’une autre étape n’avait pas déjà été signée et envoyée.
Sources et approfondissement
- Ethereum.org — Gas and fees · en anglais
- Ethereum.org — Transactions · en anglais
- MetaMask — Failed smart contract transactions · en anglais
Page mise à jour le
Vérification documentaire le · WhyTheBlockchain · Méthode éditoriale