Pourquoi ma transaction Solana a-t-elle échoué et comment le vérifier sur Solscan ?

Un swap affiche une étiquette rouge « échec », les fonds que vous vouliez transférer n’ont pas bougé et votre portefeuille ne vous donne guère plus qu’un message d’erreur vague. C’est une situation courante sur Solana, et l’explication complète se trouve généralement sur la blockchain, à une recherche de distance.

L’essentiel est de déterminer laquelle de ces deux situations s’est produite : une transaction qui a atteint le réseau et échoué, ou une transaction qui n’a jamais été inscrite sur la chaîne. Solscan peut généralement vous indiquer laquelle, et souvent pourquoi.

Ce que peut signifier « échec » sur Solana

Dans le premier cas, la transaction a atteint un validateur, a été incluse dans un bloc, puis a été rejetée lors de son exécution parce qu’une condition dont elle dépendait n’était pas remplie. Ce type d’échec est enregistré de façon permanente sur la chaîne, avec une erreur et les journaux du programme associés.

Dans le second cas, la transaction n’est jamais inscrite sur la chaîne. Chaque transaction Solana fait référence à un blockhash récent qui reste valide pendant environ 150 blocs, soit approximativement 60 à 90 secondes. Si la transaction n’est pas traitée dans ce délai, elle expire et est abandonnée. En général, une telle transaction n’apparaît sur aucun explorateur, car elle n’a jamais été inscrite sur la blockchain.

Causes courantes d’échec d’une transaction Solana

Pour les transactions qui sont inscrites sur la chaîne puis échouent, les causes habituelles sont un solde de SOL insuffisant pour couvrir les frais du réseau (ainsi qu’une petite caution lorsqu’il faut créer un nouveau compte de jeton), le dépassement de la tolérance au slippage lors d’un swap parce que le prix a trop bougé, ou un changement de l’état d’un compte entre la signature et l’exécution. Une transaction peut aussi dépasser sa limite de calcul, ce qui est plus fréquent lors d’opérations complexes.

Pour les transactions qui ne sont jamais inscrites sur la chaîne, les causes habituelles sont l’expiration du blockhash, souvent en raison d’une signature lente, d’une hésitation devant la demande de confirmation ou d’une connexion qui traîne, ainsi que la congestion du réseau. Lorsque le réseau est très sollicité, une transaction avec des frais de priorité facultatifs faibles peut être abandonnée avant même d’être traitée par un validateur.

Comment découvrir la cause sur Solscan

Commencez par copier la signature de la transaction depuis l’historique d’activité de votre portefeuille ou depuis l’application utilisée, puis collez-la dans la barre de recherche de Solscan. Si la transaction a été inscrite sur la chaîne, la page affiche généralement un statut d’échec plutôt qu’un statut de réussite et peut indiquer l’instruction qui a échoué.

Plus bas sur la page, recherchez des sections telles que les détails des instructions ou les messages des journaux ; leurs noms exacts et leur présentation peuvent évoluer au fil du temps. Les journaux indiquent quel programme a été exécuté et à quel moment il s’est arrêté, généralement au moyen d’un numéro d’instruction accompagné d’un nom ou d’un code d’erreur. Les codes d’erreur étant propres à chaque programme, un même numéro peut avoir des significations différentes selon le programme ; la documentation de celui-ci peut aider à le décoder. Si Solscan ne trouve pas du tout la signature, il se peut que la transaction n’ait pas été inscrite sur la chaîne, ou qu’elle ne le soit pas encore.

Que deviennent vos fonds et les frais ?

Solana exécute une transaction comme une seule unité. Si l’une de ses instructions échoue, toutes les modifications qu’elle aurait apportées sont annulées et le solde de vos jetons reste inchangé. En général, le seul coût est le faible frais de réseau lié à la tentative, qui est tout de même facturé puisque les validateurs ont effectué le travail nécessaire à son traitement.

Une transaction qui a expiré sans jamais être inscrite sur la chaîne n’entraîne généralement pas de frais, puisqu’elle n’a jamais atteint la blockchain. Avant de réessayer, il vaut toutefois la peine de vérifier la première tentative sur Solscan : une transaction qui semble bloquée peut tout de même aboutir, et l’envoyer deux fois peut entraîner un transfert en double.

Rappel de WEEX : vérifiez avant de réessayer

WEEX rappelle aux utilisateurs de vérifier le statut de la première tentative sur Solscan avant de la soumettre à nouveau, et de conserver un petit solde de SOL dans leur portefeuille pour couvrir les frais. Les transactions échouées attirent aussi les escrocs : toute personne qui propose de « réparer » une transaction échouée et demande une phrase de récupération ou une clé privée n’est pas digne de confiance, quelle que soit son apparence officielle. Aucun dépannage légitime ne nécessite l’une ou l’autre de ces informations.

Conclusion

Une transaction Solana échouée n’a rien de mystérieux dès lors que vous recherchez sa signature. Solscan peut vous indiquer si elle a échoué sur la chaîne ou si elle n’y a jamais été inscrite, et les journaux indiquent souvent l’instruction qui l’a interrompue. Dans la plupart des cas, les fonds restent là où ils étaient et seul un petit montant de frais est perdu. Le bon réflexe consiste donc à vérifier d’abord, puis à réessayer.

FAQ

1. Est-ce que je perds mes jetons lorsqu’une transaction Solana échoue ?
En général, non. Solana exécute une transaction comme une seule unité : si l’une de ses instructions échoue, les modifications sont annulées et le solde de vos jetons reste inchangé. En général, seuls les frais de réseau sont perdus.

2. Dois-je quand même payer des frais pour une transaction Solana échouée ?
Si la transaction a été inscrite sur la chaîne puis a échoué, de faibles frais de réseau sont généralement tout de même facturés. Si elle a expiré sans jamais être inscrite sur la chaîne, aucun frais n’est généralement facturé et elle n’apparaît habituellement pas sur Solscan.

3. Pourquoi ne puis-je pas trouver ma transaction sur Solscan ?
Il se peut qu’elle n’ait pas encore été inscrite sur la chaîne, qu’elle ait expiré ou été abandonnée, ou que la signature ait été copiée incorrectement. Vérifiez la signature, patientez un peu et comparez-la au statut indiqué dans votre portefeuille.

4. Où trouver l’erreur sur Solscan ?
Recherchez la signature de votre transaction, puis repérez le statut d’échec et les sections telles que les détails des instructions ou les journaux, qui indiquent généralement quelle instruction a échoué et quelle erreur a été renvoyée. La présentation et les libellés peuvent évoluer au fil du temps.

5. Peut-on réessayer sans risque une transaction Solana échouée ?
Souvent, oui, mais vérifiez d’abord sur Solscan que la transaction initiale n’a pas abouti et qu’elle n’est pas toujours en attente. Une transaction qui semble bloquée peut tout de même aboutir ; la renvoyer trop tôt peut entraîner un transfert en double.