Comment réparer MetaMask n'affichant pas le domaine ENS comme nom de portefeuille ?

Configuration de la résolution ENS

1. Assurez-vous que l'adresse de votre portefeuille MetaMask est correctement enregistrée auprès d'un domaine ENS via l'application ENS officielle à l'adresse app.ens.domains. L'enregistrement nécessite l'envoi d'une transaction pour revendiquer le domaine et la configuration du résolveur.

2. Confirmez que le domaine ENS dispose d'un résolveur valide configuré. Sans résolveur, aucune résolution inverse ou directe ne peut se produire. Vérifiez cela dans l'application ENS sous l'onglet « Résolveur » de votre domaine.

3. Vérifiez que le résolveur a été correctement attribué : il doit être défini sur le résolveur public par défaut (0x4976fb03C32e5B8cfe2b6cCB31c09Ba78EBaBa41), sauf si vous en utilisez un personnalisé avec une compatibilité totale.

4. Assurez-vous que l'adresse du propriétaire du domaine correspond au compte MetaMask que vous utilisez. Si la propriété a été transférée ou déléguée, le nouveau contrôleur doit explicitement établir l'enregistrement inversé.

Configuration de l'enregistrement inversé

1. La résolution inversée mappe l'adresse de votre portefeuille à son nom ENS. Sans cela, MetaMask ne peut pas afficher le domaine comme étiquette de portefeuille.

2. Dans l'application ENS, accédez à votre domaine, cliquez sur « Définir l'enregistrement inversé » et sélectionnez le compte MetaMask connecté comme cible.

3. Soumettez la transaction et attendez la confirmation en chaîne. Cette étape est obligatoire même si la résolution directe est déjà active.

4. Après confirmation, actualisez MetaMask en basculant le réseau ou en redémarrant l'extension du navigateur. Le nom du portefeuille doit être mis à jour en quelques secondes si tous les enregistrements sont actifs.

Problèmes de synchronisation du navigateur et des extensions

1. Effacez le cache local de MetaMask en accédant à Paramètres → Avancé → Réinitialiser le compte. Cela force une nouvelle récupération des métadonnées ENS à partir de la blockchain.

2. Désactivez toutes les extensions de navigateur susceptibles d'interférer avec l'injection Web3, telles que les bloqueurs de publicités ou les outils de confidentialité qui filtrent les requêtes DNS vers les sous-domaines ENS.

3. Confirmez que votre navigateur n'utilise pas de fournisseur DNS personnalisé comme Cloudflare 1.1.1.1 ou Google DNS qui bloque ou retarde les requêtes de résolution .eth — certains résolveurs s'appuient sur des points de terminaison DNS spécifiques.

4. Essayez de basculer temporairement le réseau de MetaMask vers Ethereum Mainnet, puis revenez à votre chaîne cible. Cela déclenche une réinitialisation des recherches ENS sur tous les réseaux pris en charge.

Conflits de vérification de contrat intelligent

1. Si votre domaine ENS pointe vers une adresse de contrat au lieu d'un compte externe (EOA), MetaMask ne le résoudra pas en tant que nom de portefeuille à moins que le contrat n'implémente l'interface compatible EIP-1559 requise pour la résolution inverse.

2. Vérifiez si l'adresse associée au domaine est vérifiée sur Etherscan en tant qu'EOA. Les contrats sans prise en charge EIP-2052 appropriée échoueront aux tentatives de résolution silencieuse.

3. Évitez d'utiliser des contrats enveloppés ou proxy pour l'identification principale du portefeuille. Il leur manque souvent les fonctions de secours nécessaires à une intégration transparente de l’ENS.

4. Si vous avez récemment modifié l'adresse liée à votre domaine, autorisez au moins deux confirmations de blocage avant de vous attendre à ce que MetaMask reflète le changement : les couches de mise en cache peuvent conserver des valeurs obsolètes.

Foire aux questions

Q : Pourquoi mon domaine ENS apparaît-il dans Etherscan mais pas dans MetaMask ? MetaMask s'appuie sur une configuration d'enregistrement inversée, et pas seulement sur une résolution directe. Même si votre domaine est résolu en une adresse sur Etherscan, MetaMask a besoin du mappage inverse pour l'afficher comme nom de portefeuille.

Q : Puis-je utiliser un sous-domaine ENS comme wallet.myname.eth dans MetaMask ? Oui, à condition que le sous-domaine ait son propre résolveur configuré et un enregistrement inversé défini sur l'adresse de votre portefeuille. Les sous-domaines nécessitent une configuration indépendante : l'héritage des domaines parents ne s'applique pas automatiquement.

Q : MetaMask prend-il en charge les noms ENS sur les réseaux de test comme Sepolia ou Polygon ? Uniquement si le testnet a déployé un registre et un résolveur ENS compatibles. Sepolia prend en charge ENS nativement ; Polygon nécessite une configuration RPC manuelle et le déploiement d'un résolveur tiers, ce que de nombreux utilisateurs négligent.

Q : Que se passe-t-il si je change l'adresse de mon portefeuille après avoir défini l'enregistrement inversé ? L'ancien enregistrement inversé reste actif jusqu'à ce qu'il soit mis à jour manuellement ou écrasé. MetaMask continue d'afficher le nom ENS précédent jusqu'à ce qu'une nouvelle transaction définisse l'enregistrement inverse pour la nouvelle adresse.