Comment récupérer un solde de jetons manquant dans MetaMask après avoir changé de réseau ?

Comprendre la logique de visibilité des jetons

1. MetaMask ne stocke pas les jetons en chaîne ; il affiche les soldes en interrogeant les adresses de contrat de jetons sur le réseau actuellement sélectionné.

2. Lors du changement de réseau, le portefeuille arrête d'interroger les contrats de la chaîne précédente, à moins que ces contrats n'existent de manière identique sur la nouvelle chaîne.

3. Les jetons ERC-20 déployés uniquement sur Ethereum Mainnet disparaissent lors du passage à Polygon ou Arbitrum, même si le même symbole de jeton apparaît ailleurs.

4. Les importations de jetons personnalisés sont à l'échelle du réseau : un USDC ajouté manuellement sur BSC reste invisible sur Avalanche à moins d'y être réimporté.

5. Les jetons cachés ne signifient pas une perte : les actifs restent intacts à l'adresse sous-jacente tant que la clé privée reste inchangée et qu'aucune transaction n'a été envoyée vers une chaîne incompatible.

Procédure de réajout manuel de jetons

1. Confirmez l'adresse contractuelle exacte du jeton manquant à l'aide de son site officiel ou de l'explorateur de style Etherscan pour le réseau cible.

2. Dans MetaMask, assurez-vous que le bon réseau est actif : vérifiez dans le coin supérieur droit les identifiants tels que « Ethereum Mainnet » ou « Polygon PoS ».

3. Cliquez sur le bouton « Importer des jetons », puis sélectionnez « Jeton personnalisé » et collez l'adresse du contrat vérifiée.

4. Attendez que MetaMask détecte automatiquement le nom, le symbole et les décimales ; vérifiez ces documents officiels de match avant de confirmer.

5. Si la détection automatique échoue, saisissez manuellement le nom du jeton, le symbole (par exemple « UNI ») et le nombre décimal (généralement 18), puis cliquez sur « Suivant » et « Ajouter des jetons ».

Pièges courants liés à la commutation de réseau

1. Utiliser un RPC testnet tout en croyant que le portefeuille est connecté au réseau principal conduit à un affichage de solde nul malgré les avoirs réels existant ailleurs.

2. L'ajout accidentel d'un jeton via une adresse de contrat forkée non officielle entraîne un solde fantôme ou des tentatives de transfert irréversibles.

3. Le passage à des chaînes non prises en charge comme Celo ou Gnosis sans activer les fonctionnalités expérimentales peut supprimer complètement la logique de détection de jetons.

4. La corruption du cache du navigateur après un basculement rapide du réseau peut geler les mises à jour du solde jusqu'à ce qu'IndexedDB soit effacé ou que le compte soit réinitialisé.

5. Les interfaces dApp tierces remplacent parfois la sélection de réseau active de MetaMask, provoquant un rendu d'équilibre incompatible à l'insu de l'utilisateur.

Étapes de vérification de la récupération

1. Accédez directement à un explorateur de blocs correspondant au réseau prévu et saisissez l'adresse de votre portefeuille pour confirmer indépendamment les avoirs en jetons en chaîne.

2. Vérifiez l'état de déploiement du contrat du jeton sur cette chaîne : certains jetons migrent entre les forks et perdent la continuité de l'équilibre hérité.

3. Exportez l'adresse du portefeuille et inspectez la réponse du solde brut des points de terminaison RPC publics tels que https://eth-mainnet.g.alchemy.com/v2/KEY à l'aide de curl ou Postman.

4. Comparez les journaux d'appels internes de l'API MetaMask balance (accessibles via le navigateur DevTools > Filtrage de l'onglet Réseau pour « eth_getBalance » ou « eth_call ») avec les réponses attendues.

5. Testez l'envoi de 0 ETH à vous-même sur le même réseau : si la transaction réussit, la connectivité des nœuds et la reconnaissance du compte sont confirmées.

Foire aux questions

Q : Pourquoi mon solde USDT affiche-t-il zéro sur Arbitrum même si je le vois sur Etherscan Arbitrum ? R : MetaMask nécessite l'importation manuelle de l'adresse du contrat Arbitrum de l'USDT (0x94b008aA00579c1307B0EF2c499aD98a8ce58e58) – il ne se synchronise pas automatiquement entre les chaînes.

Q : Je suis passé d'Optimisme à Base et tous mes jetons ont disparu. Est-ce que je les ai perdus ? R : Non. Les jetons résident uniquement sur leur chaîne native. Vos jetons basés sur l'Optimisme n'ont jamais existé sur Base ; ils restent entièrement accessibles une fois que vous revenez.

Q : Puis-je importer un jeton BEP-20 dans MetaMask lorsque je suis connecté à Ethereum ? R : Non. Les jetons BEP-20 fonctionnent exclusivement sur BNB Smart Chain. Tenter d’importer sur Ethereum ne générera aucun solde et peut exposer les utilisateurs à des risques de contrat usurpé.

Q : Après avoir réinitialisé mon compte MetaMask, mes jetons personnalisés ont disparu. Comment puis-je les restaurer ? R : La réinitialisation efface les listes de jetons importés mais préserve l'adresse du portefeuille et la clé privée. Vous devez réimporter chaque token individuellement en utilisant sa bonne adresse contractuelle sur le réseau actif.