Comment réparer MetaMask n'affichant pas le solde des jetons ? (Dépannage)

Comprendre les problèmes de visibilité du solde des jetons

1. MetaMask s'appuie sur des nœuds de blockchain externes pour récupérer les soldes de jetons, et si le point de terminaison RPC du réseau sélectionné ne répond pas ou est mal configuré, les soldes de jetons peuvent ne pas apparaître.

2. Les contrats de jetons personnalisés doivent être vérifiés sur Etherscan ou des explorateurs équivalents ; les contrats non vérifiés entraînent souvent des affichages de solde nul ou manquant malgré les avoirs en chaîne.

3. L'adresse du portefeuille utilisée dans MetaMask peut différer de celle contenant les jetons en raison d'un changement de compte incorrect : les utilisateurs négligent parfois la sélection active du compte dans le coin supérieur droit.

4. Les normes des jetons sont importantes : les jetons ERC-20 nécessitent des entrées d'adresse de contrat, de symbole et de décimales appropriées lors de l'ajout manuel, tandis que les actifs ERC-721 ou ERC-1155 n'apparaîtront pas comme soldes dans la liste d'actifs principale à moins qu'ils ne soient explicitement pris en charge par la version de l'interface.

5. Les conflits d'extensions de navigateur, en particulier avec les bloqueurs de publicités, les outils de confidentialité ou d'autres injecteurs Web3, peuvent supprimer le rendu de l'équilibre en interférant avec l'exécution du script de contenu de MetaMask.

Vérification de la configuration réseau

1. Confirmez que MetaMask est connecté au bon réseau où réside le jeton. Par exemple, un jeton BEP-20 basé sur BSC ne s'affichera pas sur le réseau principal Ethereum.

2. Vérifiez si l'URL RPC personnalisée inclut une clé API valide pour des services comme Infura ou Alchemy ; les clés expirées ou à débit limité renvoient des réponses vides en silence.

3. Le basculement entre les réseaux déclenche l'invalidation du cache : forcer une actualisation manuelle (Ctrl+R ou Cmd+R) après un changement de réseau résout souvent les états d'équilibre obsolètes.

4. Certains réseaux de test ont une prise en charge incohérente des nœuds d'archivage ; l'utilisation d'un point de terminaison public comme Chainstack ou QuickNode améliore la fiabilité par rapport aux URL par défaut fournies par MetaMask.

5. Si vous utilisez un nœud local comme Geth ou Hardhat, assurez-vous que le nœud expose les points de terminaison eth_getBalance et eth_call et que les en-têtes CORS autorisent les requêtes provenant de localhost:3000 ou d'origines similaires.

Ajout de jetons et validation du contrat

1. L'ajout manuel d'un jeton nécessite une correspondance exacte de l'adresse du contrat : le respect de la casse est important, bien que MetaMask normalise automatiquement les sommes de contrôle lors du collage.

2. Les jetons déployés via des modèles de proxy (par exemple, Transparent Proxy ou UUPS) peuvent exposer des adresses de mise en œuvre au lieu d'adresses de proxy ; l'interrogation de l'emplacement d'implémentation du proxy donne le véritable emplacement du contrat.

3. Le totalSupply d'un jeton doit être différent de zéro et sa fonction de transfert accessible ; les contrats avec des transferts suspendus ou des propriétaires sur liste noire peuvent signaler les soldes mais les masquer dans les couches de l'interface utilisateur.

4. Les différences de précision décimale entre le stockage en chaîne et l'entrée MetaMask provoquent des anomalies d'affichage : par exemple, la saisie de 18 décimales pour un jeton avec seulement 9 en chaîne entraîne une division du solde par 1 milliard.

5. MetaMask met en cache les métadonnées des jetons à partir de listes communautaires comme le projet Token Lists ; des entrées obsolètes ou manquantes obligent à s’appuyer sur une interaction contractuelle manuelle, qui manque de logique d’équilibrage automatique.

Vérifications de l'environnement du navigateur et des extensions

1. Désactivez temporairement toutes les extensions non MetaMask, en particulier celles qui injectent des scripts dans les pages dApp telles que Phantom, Coinbase Wallet ou Rainbow.

2. Videz le cache interne de MetaMask en accédant à Paramètres > Avancé > Réinitialiser le compte ; cela force la récupération des soldes sans supprimer les phrases ou les comptes de départ.

3. Assurez-vous que le navigateur autorise les cookies tiers et les données du site ; leur blocage empêche MetaMask de stocker les clés de session nécessaires à l'interrogation du solde des jetons.

4. Essayez d'accéder à la même dApp dans une fenêtre de navigation privée avec uniquement MetaMask activé : cela élimine les interférences des connexions enregistrées, des bundles JS mis en cache ou des techniciens de service.

5. Sur mobile, vérifiez que l'application MetaMask Mobile utilise le même réseau et le même compte que l'extension du navigateur : la synchronisation entre appareils ne s'étend pas aux paramètres de visibilité des jetons.

Foire aux questions

Q : Pourquoi mon token affiche-t-il 0,000000 même si Etherscan confirme que je le détiens ? R : Cela indique généralement une incompatibilité décimale ou une saisie d'adresse de contrat incorrecte : ajoutez à nouveau le jeton en utilisant les détails vérifiés de la page de contrat d'Etherscan.

Q : MetaMask peut-il afficher les jetons de plusieurs chaînes simultanément dans une seule vue ? R : Non. MetaMask affiche les soldes uniquement pour le réseau actuellement sélectionné. Les utilisateurs doivent changer de réseau manuellement pour voir les jetons correspondants.

Q : La réinitialisation de mon compte MetaMask supprime-t-elle mes clés privées ? R : Non. La réinitialisation du compte efface les soldes mis en cache et l'historique des transactions, mais conserve votre phrase de départ et votre accès au portefeuille intacts.

Q : Pourquoi certains jetons apparaissent-ils sous « Objets de collection » mais pas sous « Actifs » ? R : Les objets de collection représentent les NFT (ERC-721/ERC-1155), qui sont suivis séparément des soldes de jetons fongibles et nécessitent une logique de détection différente dans l'interface de MetaMask.