COMPRENDRE · VÉRIFIER · S’ENTRAÎNER
Token absent de MetaMask : les vérifications utiles
À la fin de ce cours : Distinguer un problème d’affichage d’un transfert absent.
01 / DÉBUTANT
D’abord, de quoi parle-t-on ?
Un portefeuille affiche les données qu’il sait lire sur le réseau sélectionné. Un token peut être enregistré sur votre compte sans apparaître dans cette liste. À l’inverse, afficher un token ne prouve pas qu’un transfert réel a eu lieu. Il faut vérifier le réseau, le compte et le contrat.
Les mots à connaître
- Contrat du token
- L’adresse du programme qui tient la comptabilité du token.
- Importation
- L’ajout d’un token à la liste affichée ; pas un transfert.
- Explorateur
- Un outil pour lire les données du réseau.
L’idée à comprendre
Partir de la preuve d’envoi : réseau, identifiant, statut, destination et contrat. Comparer ensuite avec le réseau et le compte affichés dans le portefeuille.
VOIR EN PRATIQUE
Maintenant, un exemple concret
Un USDC reçu sur Base ne sera pas visible en consultant uniquement Ethereum. Choisir Base permet de consulter le bon état ; cela ne déplace pas l’USDC. Ce scénario fictif illustre deux réseaux réels.
À VOUS DE JOUER
Importer un token peut-il annuler un envoi vers une mauvaise adresse ?
Formulez une réponse avant d’ouvrir l’explication. Vous pouvez aussi en discuter à voix haute.
Comparer avec l’explication
Non. L’importation agit sur l’affichage. Elle ne modifie ni la destination ni l’historique du réseau.
02 / INTERMÉDIAIRE
Comment cela fonctionne, et pourquoi
Partir de la preuve d’envoi : réseau, identifiant, statut, destination et contrat. Comparer ensuite avec le réseau et le compte affichés dans le portefeuille.
Si le transfert est confirmé au bon endroit, l’affichage peut nécessiter l’ajout du token officiel. Ne jamais approuver une dépense ou révéler un secret pour simplement afficher un solde.
Vous attendiez des USDC, mais la liste de votre portefeuille reste vide. Avant de refaire le transfert, séparez trois questions : où ont-ils été envoyés, à quel compte et que montre réellement le réseau ?
Trois mots avant de commencer
- Compte
- L’adresse que vous consultez. Un même portefeuille peut gérer plusieurs comptes.
- Explorateur
- Un site de consultation de l’activité d’un réseau. Etherscan sert par exemple à consulter Ethereum.
- Contrat du token
- L’identifiant du programme qui gère ce token sur un réseau. Ce n’est pas votre adresse de réception.
Exemple : 25 USDC sur Base, écran Ethereum ouvert
Léa attend 25 USDC sur Base. Dans cet exemple fictif, le transfert est confirmé vers le bon compte et le solde USDC de ce compte sur Base est de 25. Son application est pourtant filtrée sur Ethereum. Elle regarde le mauvais réseau ; envoyer une seconde fois ne corrigerait pas ce filtre.
USDC, Base et Ethereum existent réellement. Circle publie une adresse de contrat USDC différente pour chacun de ces deux réseaux. Le symbole « USDC » ne suffit donc pas à identifier ce que vous consultez.
Vérifier dans cet ordre
1. Retrouvez le réseau d’envoi et l’identifiant de transaction, appelé hash. Un statut « retrait en cours » sur une plateforme n’est pas forcément une confirmation sur la blockchain.
2. Consultez le hash dans l’explorateur de ce réseau. Contrôlez le statut, le token, le destinataire et son solde actuel. Un transfert reçu hier ne décrit pas à lui seul le solde d’aujourd’hui.
3. Comparez avec le compte et le réseau affichés dans MetaMask. Si le token attendu est bien présent à cette adresse, vérifiez sa visibilité dans la gestion des tokens ; l’ajout manuel se fait avec le contrat du bon réseau.
Les menus varient entre extension et mobile. Le guide officiel ci-dessous donne les étapes actuelles. N’utilisez pas un contrat reçu d’un inconnu et ne réinstallez pas le portefeuille comme premier réflexe.
Ce que l’affichage ne peut pas réparer
Ajouter un token à la liste ne crée ni réception ni transfert entre réseaux. Si l’adresse de destination n’était pas la vôtre, ce bouton ne rapatrie pas les fonds. Si vous attendiez un dépôt sur une plateforme, ses règles de réseau et de crédit du compte s’ajoutent à la confirmation blockchain.
Un token peut aussi apparaître avec une quantité, sans prix en euros. L’absence de cotation et l’absence de tokens sont deux problèmes différents. Une valeur affichée ne garantit pas non plus qu’un acheteur acceptera de payer ce montant.
03 / APPROFONDI
Les règles derrière l’interface
Comparer le solde lu dans le contrat à l’indexation du portefeuille. Certains outils dépendent de listes de tokens, d’indexeurs ou de caches. Une interface en retard ne suffit pas à conclure à une perte.
L’identité complète d’un token EVM inclut le réseau et le contrat. Vérifier les décimales pour l’affichage et les événements du bon contrat. Un événement émis par un faux token n’atteste pas la réception du token officiel.
À VOUS DE JOUER
Le même symbole apparaît deux fois, avec deux contrats différents. Peut-on additionner les soldes ?
Formulez une réponse avant d’ouvrir l’explication. Vous pouvez aussi en discuter à voix haute.
Comparer avec l’explication
Pas comme s’il s’agissait automatiquement du même actif. Identifier chaque contrat, son émetteur et ses droits ; l’un peut être une imitation ou une représentation bridgée.
Les sources officielles en fin de page permettent d’examiner ces mécanismes plus en détail.
LIRE · RAISONNER · APPLIQUER
3 situations à examiner
Pour chaque cas : comparez les documents, formulez votre raisonnement, prenez une décision, puis résolvez une variante. Le corrigé explique ses hypothèses et ses limites. Sans chronomètre.
DOCUMENTS FICTIFS · AUCUNE OPÉRATION RÉELLE
Les 25 USDC de Léa
Le transfert fictif de Léa est confirmé. Le compte destinataire correspond au sien. Comparez maintenant le réseau du transfert avec le filtre de son application.
- Réseau du transfert
- Base
- Solde USDC sur Base
- 25 USDC
- Filtre de l’application
- Ethereum
Associez chaque information à son réseau et à son compte. Le zéro affiché sur Ethereum décrit-il le solde sur Base ?
Ce texte n’est ni noté automatiquement ni envoyé. Il reste dans la mémoire de cette page et disparaît en la quittant ou en la rechargeant. Utilisez seulement les données fictives.Un indice pour ma décision
Le transfert et l’écran ne parlent pas du même réseau.
2. Ma décision
Tous les documents, questions et corrigés détaillés
Les 25 USDC de Léa
Le transfert fictif de Léa est confirmé. Le compte destinataire correspond au sien. Comparez maintenant le réseau du transfert avec le filtre de son application.
- Réseau du transfert
- Base
- Solde USDC sur Base
- 25 USDC
- Filtre de l’application
- Ethereum
Quelle vérification vient ensuite ?
Associez chaque information à son réseau et à son compte. Le zéro affiché sur Ethereum décrit-il le solde sur Base ?
Raisonnement : Léa n’a pas besoin de déplacer les USDC pour vérifier ce cas. Elle doit regarder le bon compte sur Base. Si la liste reste vide ensuite, elle pourra examiner la détection du token. Une cause possible à la fois.
Commencer par faire correspondre compte et réseau.
Variante
Léa affiche maintenant Base et le bon compte. Le solde public du contrat USDC attendu indique toujours 25, mais le token est absent de l’application. Quelle vérification vient ensuite ?
MetaMask permet d’afficher des tokens détectés ou ajoutés par leur contrat. Utilisez la référence officielle du token sur le bon réseau. Cette opération d’affichage ne récupère pas un envoi vers un autre destinataire et ne déplace pas les fonds.
Une quantité, mais aucun prix
Sam voit 12 jetons dans son compte. La colonne du prix affiche un tiret. Le token utilisé ici, ATELIER, est inventé pour distinguer quantité et cotation.
- Token
- ATELIER — inventé
- Quantité
- 12
- Prix unitaire
- — non disponible
Que peut-on déduire de ce seul écran ?
Distinguez quantité, estimation en euros et possibilité de vendre. Quelle information possède-t-on réellement ?
Raisonnement : Le tiret ne permet de conclure ni à une valeur nulle ni à une valeur garantie. Dans ce cas, Sam doit distinguer les 12 unités affichées de l’information de prix absente. Le fait de posséder un token ne suffit pas à établir ce qu’un marché en donnera.
Quantité, cotation et possibilité de vendre sont trois questions.
Variante
Marché entièrement fictif : une offre ferme achète seulement 5 de vos 12 tokens ATELIER, à 0,40 € l’unité, sans frais dans ce modèle. Quel montant concerne cette offre ? Ne supposez pas qu’elle accepte les 12.
5 × 0,40 = 2 €. Les 7 autres unités ne sont pas couvertes par l’offre. Multiplier les 12 par 0,40 donnerait une valorisation théorique de 4,80 €, pas une possibilité de vendre l’ensemble à ce prix.
Le hash dit « confirmé »
Dans ce cas fictif, l’explorateur indique une réception vers le compte B. Vous attendez les fonds sur le compte A, dont le solde reste à zéro. Ces lettres remplacent les adresses pour l’exercice.
- Statut
- Confirmé
- Destinataire dans le transfert
- Compte B
- Compte consulté
- Compte A
Ajouter le token à la liste du compte A résout-il ce cas ?
Comparez l’adresse destinataire de la transaction avec le compte observé. Que signifie « confirmé » dans ce contexte ?
Raisonnement : Un transfert confirmé doit encore correspondre au compte attendu. Ici, A et B sont différents. Il manque l’identification de B : on ne peut promettre une récupération, ni conclure que B appartient à un fraudeur.
Un statut réussi ne remplace pas la vérification du destinataire.
Variante
Après vérification, B est bien un second compte que vous contrôlez. Le solde public du token sur B confirme la réception sur le réseau attendu. Que faut-il faire pour consulter ce solde ?
Les fonds sont associés au compte B sur le réseau concerné. Pour les déplacer vers A, il faudrait une opération distincte, avec ses propres vérifications et frais éventuels. Si B n’était pas sous votre contrôle, cette solution ne serait pas applicable.
Deux autres questions utiles
Faut-il connecter son wallet à un explorateur ?
Une consultation par adresse publique ou hash ne nécessite pas de signature. L’exercice de cette page utilise seulement des données inventées : vous n’avez rien à connecter.
Ajouter un token valide-t-il sa fiabilité ?
Non. C’est une action d’affichage. Vérifier le contrat et la source du token reste nécessaire avant de décider d’interagir avec lui.
Une lecture complémentaire : Wallet crypto : clés, garde et récupération
LA RÉPONSE EN BREF
Un token invisible dans MetaMask n’est pas forcément perdu. Vérifiez le réseau, le compte et le résultat du transfert dans un explorateur. Si le bon token est bien présent à votre adresse, sa détection ou son affichage peut être en cause.
Sources et approfondissement
- MetaMask — Missing or incorrect token balance · en anglais
- MetaMask — Display tokens · en anglais
- MetaMask — Missing token price · en anglais
- MetaMask — Check activity in an explorer · en anglais
- Circle — USDC and its networks · en anglais
- ERC-20 — Token standard · en anglais
Page mise à jour le
Vérification documentaire le · WhyTheBlockchain · Méthode éditoriale