Pourquoi ma transaction STON.fi a-t-elle échoué ? Guide complet pour diagnostiquer les transactions ayant échoué
Une transaction échouée sur STON.fi peut être frustrante, surtout lorsque votre portefeuille affiche une erreur sans expliquer clairement ce qui n’a pas fonctionné. Mais une opération échouée ne signifie pas automatiquement que le protocole STON.fi est défaillant.
La cause peut être beaucoup plus proche de l’utilisateur : $GRAM insuffisant pour les frais de réseau, un changement des conditions du marché, un impact sur le prix excessif, des limites de slippage, des problèmes de portefeuille ou de connexion, un problème spécifique à un jeton, un verrouillage de farm, ou un échec réel de l’exécution on-chain.
La méthode la plus fiable pour dépanner le problème consiste à identifier exactement quelle opération vous effectuiez, déterminer si la transaction a réellement été diffusée sur la blockchain TON, puis analyser les conditions pertinentes avant de réessayer.
Le Centre d’aide STON.fi sépare les problèmes par transactions, retraits, problèmes de tokens et problèmes techniques, tandis que sa documentation sur les swaps explique les conditions de prix, de dérapage et de frais blockchain qui peuvent affecter l’exécution.
1. Commencez par identifier l’opération
La première question doit toujours être : que cherchiez-vous à faire ?
Un swap, un retrait de liquidité, un retrait de ferme, une opération de pool et un transfert de token peuvent échouer pour différentes raisons.
Par exemple, un retrait de liquidité nécessite $GRAM pour couvrir les frais blockchain. STON.fi indique explicitement aux utilisateurs qui ne peuvent pas retirer une liquidité de d’abord vérifier leur solde $GRAM avant d’en conclure qu’il y a un problème de protocole.
Les opérations de farming peuvent introduire une autre condition : certaines fermes ont une période de blocage. Si un utilisateur tente de retirer alors que la position est encore bloquée, la transaction peut ne pas être disponible, indépendamment du solde du wallet. STON.fi recommande d’abord de vérifier la durée de blocage restante, puis de vérifier le solde $GRAM et de reconnecter le wallet si nécessaire.
Cela fait du type d’opération un indice de diagnostic important.
Avant de réessayer, déterminez si l’action ayant échoué était :
Un swap de tokens
Vérifiez le taux annoncé, l’impact sur le prix, le montant minimum reçu, la tolérance de dérapage, les avertissements sur les tokens et le $GRAM disponible pour couvrir les frais blockchain.
Un retrait de liquidité
Vérifiez si le wallet contient suffisamment de $GRAM et si la connexion du wallet fonctionne correctement.
Un retrait de ferme ou une opération de clôture
Vérifiez s’il existe une période de blocage active, un $GRAM suffisant, la connectivité du wallet et, si nécessaire, si un autre wallet compatible produit le même résultat.
Une interaction de token personnalisé
Vérifiez l’adresse du contrat du token, les métadonnées, les décimales, la liquidité et tout avertissement avant d’interagir à nouveau. STON.fi avertit spécifiquement que le nom, le ticker ou le logo d’un token personnalisé ne prouvent pas qu’il est légitime.
Identifier correctement l’opération vous évite d’appliquer une solution inadaptée.
2. Vérifiez le solde $GRAM de votre wallet
L’une des causes les plus simples d’une transaction échouée est aussi l’une des plus faciles à ignorer : le wallet a besoin de suffisamment de $GRAM pour payer les frais réseau.
STON.fi décrit les frais blockchain comme le coût réseau requis pour exécuter une transaction, et sa documentation indique que les utilisateurs doivent avoir $GRAM dans le wallet pour les frais réseau. Le montant exact dépend de l’opération et peut être affiché dans l’interface avant la confirmation.
C’est important car l’actif que vous échangez n’est pas nécessairement celui utilisé pour payer les frais blockchain.
Par exemple, vous pourriez avoir suffisamment de USDT pour effectuer un swap, mais ne pas pouvoir exécuter la transaction si votre wallet n’a pas assez de $GRAM pour les frais réseau requis.
La documentation de retrait de STON.fi fait la même remarque : les retraits depuis les pools de liquidité et les fermes nécessitent $GRAM pour couvrir les frais de la blockchain.
Pourquoi le solde peut être trompeur
Avoir un solde $GRAM non nul ne signifie pas automatiquement que c’est suffisant.
Une transaction peut nécessiter plus de valeur réseau que le montant actuellement disponible après prise en compte des exigences de traitement de la transaction. Les transactions TON peuvent inclure des frais de stockage, de gas, d’action et de forwarding selon le flux de messages.
Par conséquent, ne vous contentez pas de demander :
« Ai-je $GRAM ? »
Demandez :
« Ai-je assez de $GRAM pour cette opération précise ? »
Le champ de frais blockchain affiché par STON.fi avant la signature est utile pour ce contrôle.
1. Comprendre le dérapage et l’impact sur le prix
Pour les swaps, l’une des distinctions les plus importantes est celle entre l’impact sur le prix et le dérapage.
Ils sont liés, mais ce ne sont pas la même chose.
Impact sur le prix
L’impact sur le prix correspond à la mesure dans laquelle votre propre ordre modifie le prix au sein du pool de liquidité.
Comme STON.fi utilise un modèle de market maker automatisé, échanger des tokens modifie le ratio des actifs dans un pool. Un gros swap par rapport à la liquidité disponible peut donc déplacer significativement le prix du pool.
Cela signifie qu’un swap peut échouer à fournir l’exécution attendue même si le marché n’a pas bougé de manière spectaculaire. L’ordre est peut-être simplement trop important par rapport à la liquidité disponible.
Dérapage
Le dérapage est différent.
Elle décrit la différence entre le prix que vous voyez lors de la demande de transaction et le prix réel lorsque la transaction s’exécute on-chain.
Des retards réseau, la volatilité du marché et d’autres traders peuvent faire évoluer le prix attendu entre ces deux moments.
STON.fi documente actuellement une tolérance de dérapage par défaut de 1% et un seuil d’impact sur le prix par défaut de 5%. Ces valeurs peuvent être modifiées dans les paramètres de swap, mais les augmenter expose l’utilisateur à une exécution potentiellement pire.
C’est pourquoi augmenter le dérapage sans discernement n’est pas une stratégie de dépannage correcte.
Si la transaction échoue parce que le marché a dépassé les limites acceptées, la bonne question n’est pas simplement :
« Comment faire pour que la transaction passe ? »
C’est :
« Pourquoi l’exécution attendue est-elle devenue inacceptable ? »
Vous devrez peut-être réduire la taille du trade, attendre que les conditions du marché se stabilisent, ou reconsidérer la paire de tokens sélectionnée plutôt que d’accepter simplement un taux moins bon.
4. Vérifier le minimum reçu et les détails du swap
Avant de confirmer un swap, STON.fi affiche plusieurs paramètres importants.
Le taux de swap vous indique la quantité de l’actif de sortie que vous êtes censé recevoir.
L’impact sur le prix indique dans quelle mesure votre trade affecte le prix du pool.
Le montant minimum reçu représente le plus faible montant du token de sortie que vous devriez obtenir dans les conditions de dérapage configurées.
Les frais blockchain indiquent le coût réseau requis pour exécuter la transaction.
Ces valeurs doivent être revues avant de signer, et pas uniquement après qu’un problème se soit produit.
Une transaction qui semblait attrayante au départ peut devenir moins favorable si le marché bouge, si la liquidité change, ou si le prix d’exécution attendu se dégrade.
Les ordres importants méritent une attention particulière, car un gros trade face à un pool relativement petit peut créer un impact sur le prix nettement plus élevé. STON.fi note qu’un gros swap peut être découpé en transactions plus petites pour réduire l’impact sur le prix, bien que plusieurs transactions ajoutent aussi des frais et ne garantissent donc pas automatiquement un meilleur résultat global.
5. Faites attention aux avertissements sur les tokens
Toutes les transactions échouées ou problématiques ne sont pas causées par des conditions de liquidité ou de réseau.
Le token lui-même peut être le problème.
STON.fi permet aux utilisateurs d’importer des tokens personnalisés en saisissant leur adresse de smart-contract. Cependant, la plateforme avertit explicitement les utilisateurs d’obtenir la bonne adresse de contrat officielle et de rechercher le token de manière indépendante, car des tokens frauduleux peuvent copier des noms, symboles et logos légitimes.
C’est particulièrement important lors de l’interaction avec des actifs inconnus.
Un token peut sembler légitime parce que son nom et son logo affichés ressemblent à un projet connu, tandis que son contrat sous-jacent est complètement différent.
La documentation propre de TON renforce cette préoccupation de sécurité : les métadonnées de token seules ne doivent pas être traitées comme une preuve d’authentification, car des attaquants peuvent créer de fausses jettons avec des noms, symboles et images correspondants.
Avant de réessayer une transaction impliquant un token personnalisé, vérifiez :
l’adresse du contrat officiel ;
les métadonnées du token et ses décimales ;
s’il existe suffisamment de liquidité ;
si l’actif est réellement le token prévu ;
si STON.fi affiche un avertissement ;
si le token a un comportement inhabituel ou suspect.
Le glossaire de STON.fi identifie aussi les tokens factices et les honeypots comme risques connus.
Une transaction échouée est parfois un avertissement invitant à examiner un actif plus attentivement, plutôt qu’une chose à forcer à passer.
6. Vérifier si la transaction a réellement été diffusée
C’est l’une des étapes de diagnostic les plus importantes.
Il y a une différence entre :
Une transaction qui n’a jamais été soumise avec succès par le wallet
et
Une transaction qui a été soumise à TON mais a échoué pendant l’exécution on-chain.
Si le wallet a refusé la demande avant de la diffuser, il se peut qu’il n’y ait aucune transaction on-chain correspondante à inspecter.
Mais si la transaction a atteint la blockchain, son exécution peut être analysée à l’aide d’un explorateur TON.
La documentation TON explique que des liens de transaction peuvent être générés à l’aide de l’adresse du compte, du logical time et du hash de transaction, ce qui permet d’inspecter la transaction via un explorateur.
Par conséquent, après une transaction échouée, cherchez le hash de transaction ou le lien d’explorateur fourni par le wallet ou l’application.
S’il n’y a aucune trace de transaction, concentrez-vous d’abord sur le wallet, la connexion, la signature ou l’étape de soumission.
S’il existe une transaction on-chain, inspectez son statut blockchain et les détails d’exécution.
7. Lire le résultat de transaction TON
Un explorateur peut révéler des informations qu’un simple message d’erreur du wallet ne montre pas.
Les transactions TON passent par différentes phases d’exécution, notamment les phases de stockage, de calcul et d’action. Selon ce qui s’est mal passé, la blockchain peut enregistrer un échec d’exécution ou générer un message « bounce ».
Un « bounce » est particulièrement utile en tant que signal de diagnostic. La documentation TON explique qu’un message de bounce peut être généré lorsqu’un message « bounceable » échoue pendant l’exécution du contrat ou lorsqu’une action échoue dans les conditions appropriées.
Cela signifie qu’une transaction apparaissant comme « échouée » ne raconte pas toute l’histoire à elle seule.
Regardez la trace de la transaction et déterminez :
La transaction a-t-elle été incluse on-chain ?
Quel contrat a reçu le message ?
L’exécution a-t-elle atteint le contrat attendu ?
Y a-t-il eu un échec de la phase de calcul ?
Y a-t-il eu un échec de la phase d’action ?
Le message a-t-il été renvoyé (bounce) ?
Y avait-il une indication de fonds insuffisants ?
Un message ultérieur a-t-il réussi ou échoué ?
Pour les opérations complexes, une seule action utilisateur peut impliquer plusieurs messages blockchain. L’examen de la trace de transaction peut donc fournir plus d’informations que de se fier à la première erreur affichée dans le wallet.
8. Les problèmes de wallet et de connexion peuvent aussi en être la cause
Les indications de dépannage de STON.fi recommandent à plusieurs reprises de reconnecter le wallet lorsqu’une opération échoue.
Pour certains problèmes de retrait, STON.fi suggère de déconnecter puis reconnecter le wallet, puis, si nécessaire, d’essayer le même wallet via une autre application de wallet TON compatible. Si l’opération fonctionne dans un autre wallet, le problème peut être lié à l’application de wallet d’origine plutôt qu’au protocole STON.fi.
C’est une méthode de diagnostic importante car elle aide à isoler la source de l’échec.
Par exemple :
Échec uniquement dans un wallet :
Il peut y avoir un problème spécifique au wallet au niveau de la connexion, de la signature ou de l’implémentation.
Échec sur plusieurs wallets compatibles :
Le problème est moins susceptible d’être limité à une seule application de wallet et peut nécessiter une enquête au niveau du protocole ou de la blockchain.
STON.fi recommande spécifiquement de contacter l’équipe de support du wallet quand un problème n’apparaît que dans ce wallet, tandis que les problèmes reproduits sur plusieurs wallets doivent être escaladés au support STON.fi.
9. Les transactions de farming et de retrait ont des conditions supplémentaires
Toutes les transactions ne sont pas des swaps.
Les positions de farming peuvent avoir des périodes de blocage, et ces restrictions doivent être vérifiées avant de considérer un retrait infructueux comme un échec technique.
STON.fi indique que la période de blocage s’affiche avant qu’une position de farming soit confirmée. Si un message « bloquant » apparaît, la première étape consiste à vérifier si la période de blocage a expiré. Ensuite, vérifiez le solde $GRAM et reconnectez le wallet si nécessaire.
De même, fermer une position de farming peut nécessiter $GRAM pour les frais réseau. La séquence de dépannage de STON.fi consiste à vérifier la durée de blocage, confirmer le solde $GRAM, reconnecter le wallet, puis essayer un autre wallet compatible si le problème persiste.
Cela montre pourquoi le type d’opération compte autant : un swap échoué et un retrait de ferme bloqué ne sont pas forcément diagnostiqués de la même façon.
10. Ne pas réessayer immédiatement la même transaction
Une des erreurs les plus courantes consiste à appuyer à répétition sur « Réessayer » sans comprendre la cause.
Si le problème vient d’un $GRAM insuffisant, une autre tentative ne le résoudra pas.
Si le problème vient d’un impact sur le prix excessif, répéter immédiatement le même trade peut produire le même résultat.
Si le marché a dépassé votre tolérance de dérapage, réessayer sans reconsidérer le prix annoncé peut vous laisser exactement dans la même situation.
Si le token lui-même est suspect, des tentatives répétées peuvent augmenter votre exposition au risque sous-jacent.
Et si la transaction a déjà été diffusée, créer une autre transaction avant d’en vérifier le statut peut rendre plus difficile de comprendre ce qui s’est réellement passé.
Une meilleure séquence est :
Identifier → Inspecter → Diagnostiquer → Corriger → Réessayer.
Pas :
Échec → Réessayer → Échec → Réessayer.
11. Un workflow pratique de dépannage STON.fi
Lorsqu’une transaction STON.fi échoue, procédez dans l’ordre suivant.
Étape 1 : identifier l’opération
S’agissait-il d’un swap, d’un dépôt de liquidité, d’un retrait de liquidité, d’une action de farming, d’une opération de staking ou d’une interaction de token ?
Étape 2 : vérifier le wallet
Confirmez que le bon wallet est connecté et qu’il contient assez de $GRAM pour couvrir les frais réseau.
Étape 3 : examiner les paramètres de la transaction
Pour les swaps, vérifiez :
taux de swap ;
impact sur le prix ;
montant minimum reçu ;
tolérance de dérapage ;
route sélectionnée ou option d’exécution ;
frais blockchain.
STON.fi expose ces paramètres pour aider les utilisateurs à comprendre la transaction avant confirmation.
Étape 4 : vérifier la légitimité du token
Pour les tokens non familiers ou importés manuellement, vérifiez l’adresse de contrat officielle et examinez tout avertissement avant de continuer à interagir.
Étape 5 : vérifier le statut de la transaction on-chain
Trouvez le hash de la transaction et inspectez-le avec un explorateur TON. Déterminez si la transaction a été diffusée, exécutée, « bounced » ou a échoué pendant l’une des phases d’exécution.
Étape 6 : isoler la source
Reconnectez le wallet.
Si c’est approprié, testez le même wallet dans une autre application de wallet TON compatible. STON.fi utilise cette approche dans sa documentation de dépannage pour distinguer les problèmes côté wallet des problèmes plus larges.
Étape 7 : corriger la cause réelle
Ajoutez suffisamment de $GRAM si le problème vient des frais.
Attendez ou reconsidérez le trade si le mouvement du marché est le problème.
Réduisez la taille de l’ordre si l’impact sur le prix est excessif.
Vérifiez le token si l’actif est inconnu.
Attendez l’expiration d’un blocage de ferme si la position est encore bloquée.
Reconnectez ou changez l’application de wallet si le problème semble spécifique au wallet.
Étape 8 : réessayer seulement après diagnostic
Une fois la cause probable identifiée et corrigée, une nouvelle tentative devient pertinente.
Quelles informations devez-vous collecter pour le support ?
Lorsque le problème persiste après le dépannage de base, évitez d’envoyer uniquement un message tel que :
« Ma transaction a échoué. »
Cela donne très peu d’informations exploitables.
Au lieu de cela, collectez les données pertinentes de la transaction.
Inclure :
Adresse du wallet : de préférence l’adresse publique impliquée dans la transaction.
Hash de transaction ou lien d’explorateur : quand la transaction a réellement été diffusée.
Type d’opération : swap, retrait, farming, liquidité, etc.
Paire de tokens : pour les swaps.
Montant : le montant tenté.
Heure approximative de la transaction : utile pour localiser l’événement.
Message d’erreur : fournissez le texte exact affiché par STON.fi ou par votre wallet.
Application du wallet : identifiez quel wallet TON compatible a été utilisé.
Captures d’écran : lorsque c’est utile, surtout pour afficher l’erreur ou l’avertissement exact.
Ne fournissez votre phrase de seed, clé privée, phrase de récupération ou tout autre identifiant sensible du wallet à qui que ce soit qui prétend être du support.
STON.fi oriente les utilisateurs vers ses canaux de support officiels lorsque le dépannage ne permet pas de résoudre le problème.
Le point clé
Une transaction STON.fi échouée n’est pas automatiquement une défaillance du protocole.
L’approche de dépannage la plus efficace consiste à localiser l’endroit où la transaction a échoué.
Elle a peut-être échoué avant la diffusion à cause du wallet ou de la connexion.
Il a peut-être été rejeté car il n’y avait pas suffisamment de $GRAM pour les frais réseau.
Il est peut-être devenu inacceptable à cause d’un impact sur le prix ou d’un dérapage.
Cela a peut-être été restreint par les conditions de blocage d’une ferme.
Cela peut impliquer un token nécessitant une vérification supplémentaire.
Ou la transaction a pu atteindre TON et échouer pendant l’exécution on-chain.
La solution n’est donc pas d’augmenter aveuglément le dérapage ou d’appuyer plusieurs fois sur « Réessayer ».
La bonne approche est d’identifier l’opération, vérifier le solde du wallet, examiner les paramètres de la transaction, vérifier le token, inspecter le statut de la transaction TON, isoler la cause probable puis seulement ensuite réessayer.
Cela transforme un message vague « transaction échouée » en un processus de dépannage structuré.
Liste finale de diagnostic
Opération : que cherchais-je exactement à faire ?
$GRAM : y a-t-il assez de $GRAM natif pour les frais réseau ?
Conditions de swap : l’impact sur le prix ou le dérapage ont-ils dépassé les limites acceptables ?
Montant minimum reçu : la sortie attendue a-t-elle changé ?
Token : l’adresse du contrat est-elle légitime et l’actif est-il sûr pour l’interaction ?
Wallet : le bon wallet est-il connecté et répond-il correctement ?
Explorer : la transaction a-t-elle réellement été diffusée, et que s’est-il passé on-chain ?
Farming/retrait : y a-t-il un blocage actif ou une autre restriction spécifique à l’opération ?
Réessayer : ai-je identifié et corrigé la cause probable avant de soumettre une autre transaction ?
Support : avez-vous prêt le hash de la transaction, l’adresse du wallet, les détails de l’opération, l’horodatage et le message d’erreur ?
Le dépannage devient beaucoup plus simple une fois ces questions répondue dans cet ordre.
Le Centre d’aide officiel de STON.fi reste la référence principale pour les problèmes de transaction et de retrait, tandis que l’explorateur TON et la documentation blockchain fournissent les preuves on-chain plus approfondies nécessaires lorsque la transaction a déjà été diffusée.