Comment ajouter un jeton manquant après un échange dans MetaMask ?

Comprendre la visibilité des jetons dans MetaMask

1. MetaMask n'affiche pas automatiquement tous les jetons après un échange en raison de sa logique de détection de jetons par défaut. Seuls les jetons répertoriés sur la liste officielle des jetons ou ceux ajoutés manuellement apparaissent dans l'interface des actifs.

2. Lorsqu'un utilisateur échange contre un jeton nouvellement déployé ou à faible liquidité, l'adresse du contrat peut ne pas être indexée par le registre interne de MetaMask, ce qui entraîne une visibilité sur le solde nul malgré un transfert en chaîne réussi.

3. Le portefeuille repose sur la conformité à la norme ERC-20 et une configuration décimale correcte ; les écarts, tels que les décimales non standard ou les valeurs de retour manquantes dans les fonctions de transfert, peuvent empêcher une analyse correcte du solde.

4. Le contexte du réseau est important : les jetons sur les chaînes L2 comme Arbitrum ou Base nécessitent une sélection explicite de chaîne avant l'ajout du jeton, sinon le panneau d'actifs ignorera le contrat même s'il est saisi correctement.

5. La mise en cache des extensions de navigateur peut retarder l'apparition des jetons. Un rafraîchissement forcé de la popup MetaMask ou un rechargement complet de l'extension est parfois nécessaire après confirmation du contrat.

Processus d'ajout manuel de jetons

1. Ouvrez MetaMask et assurez-vous que vous êtes sur le bon réseau : Ethereum Mainnet, Polygon, Optimism ou une autre chaîne prise en charge sur laquelle réside le jeton.

2. Cliquez sur le bouton « Importer des jetons » situé sous la liste des actifs, puis sélectionnez l'onglet « Jeton personnalisé » .

3. Collez l'adresse contractuelle exacte du token reçu dans le swap. Cette adresse doit correspondre à celle utilisée dans les journaux d'événements de sortie de la transaction d'échange.

4. Cliquez sur « Suivant » . MetaMask tentera de récupérer les métadonnées du jeton (y compris le nom, le symbole et les décimales) de la blockchain via des appels en lecture seule au contrat.

5. Si le chargement des métadonnées échoue, saisissez manuellement le symbole du jeton, le nom et les décimales. Pour la plupart des jetons ERC-20, les décimales sont égales à 18, mais certains jetons utilisent 6, 9 ou 12, et une saisie incorrecte entraîne une fausse déclaration du solde.

Vérification de la réception du jeton en chaîne

1. Accédez à un explorateur de blocs tel qu'Etherscan, Arbiscan ou Basescan, selon le réseau utilisé.

2. Collez l'adresse de votre portefeuille dans la barre de recherche et accédez à la section « Transactions de jetons » ou « Événements de transfert de jetons ERC-20 » .

3. Localisez le transfert entrant le plus récent correspondant à l'adresse contractuelle du jeton et confirmez que le champ de valeur affiche un montant non nul en unités brutes (par exemple, 1 000 000 000 000 pour 1 jeton avec 18 décimales) .

4. Vérifiez le hachage de la transaction avec le reçu de swap. Un statut confirmé et un statut d'exécution réussie indiquent que le jeton a été livré à votre adresse au niveau du protocole.

5. Si l'explorateur affiche le solde mais pas MetaMask, le problème réside uniquement dans l'enregistrement du jeton côté portefeuille et non dans l'échec de la livraison au niveau de la chaîne.

Dépannage des échecs d'importation courants

1. Les erreurs « Impossible de récupérer les informations sur le jeton » proviennent souvent de l'instabilité du point de terminaison RPC. Le passage à un autre fournisseur RPC, tel qu'Alchemy, Infura ou QuickNode, dans les paramètres réseau de MetaMask peut résoudre ce problème.

2. Les jetons déployés sur des réseaux de test comme Sepolia ou Holesky nécessitent une activation réseau explicite. Tenter d'importer un jeton basé sur Sepolia alors que vous êtes connecté au réseau principal ne donne aucun résultat.

3. Certains jetons implémentent des modèles de contrôle d'accès ou de proxy personnalisés qui interfèrent avec les appels balanceOf() standard. Dans de tels cas, la saisie manuelle du symbole et des décimales est obligatoire, et le solde ne peut être mis à jour qu'après avoir interagi directement avec le contrat.

4. Les versions de l'application mobile MetaMask antérieures à 7.12.0 ne prennent pas en charge certains jetons BEP-20 et ERC-677. La mise à jour de l'application résout les écarts de compatibilité pour les actifs inter-chaînes.

5. Si le jeton utilise une interface non standard (par exemple, en omettant totalSupply() ou en renvoyant false sur supportsInterface()), MetaMask peut le supprimer lors de la détection automatique. L’importation manuelle reste fonctionnelle malgré tout.

Foire aux questions

Q : Pourquoi MetaMask affiche-t-il un solde de 0 après l'ajout d'un jeton, même si Etherscan confirme le solde ? R : Cela se produit lorsque des décimales ont été saisies de manière incorrecte lors de l'importation manuelle. Réimportez le jeton en utilisant le nombre décimal exact spécifié dans la fonction decimals() du contrat.

Q : Puis-je ajouter un token sans connaître son adresse contractuelle ? R : Non. L’adresse du contrat est obligatoire. Il peut être récupéré à partir de la page des jetons DEX, de la documentation officielle du projet ou des données d'entrée de la transaction d'échange décodées sur un explorateur de blocs.

Q : L'importation d'un jeton expose-t-elle ma clé privée ou ma phrase de départ ? R : Non. L’importation enregistre uniquement l’adresse du contrat et les métadonnées localement. Aucun matériel cryptographique ne quitte votre appareil ou l'environnement de votre navigateur.

Q : Pourquoi certains jetons apparaissent-ils automatiquement alors que d'autres nécessitent une importation manuelle ? R : MetaMask maintient une liste de jetons organisée et mise à jour chaque semaine. Les jetons répondant aux seuils de liquidité, à la vérification d'audit et aux mesures d'utilisation de la communauté sont automatiquement inclus. D’autres restent uniquement opt-in.