Comment ajouter manuellement les icônes de jeton dans Metamask?

Les utilisateurs de Metamask peuvent ajouter manuellement les icônes de jeton en mettant à jour les listes de jetons personnalisées ou en utilisant des outils de développement pour améliorer la reconnaissance des jetons ERC-20 non pris en charge.

Jun 12, 2025 at 03:49 am

Qu'est-ce que Metamask et pourquoi auriez-vous besoin d'ajouter des icônes de jeton?

Metamask est un portefeuille de crypto-monnaie populaire qui permet aux utilisateurs d'interagir avec la blockchain Ethereum. Il prend en charge non seulement l'éther (ETH) mais aussi divers jetons ERC-20. Alors que de nombreux jetons couramment utilisés affichent automatiquement leurs icônes dans l'interface Metamask, certains jetons moins connus ou nouvellement lancés peuvent ne pas afficher une icône , ce qui les rend plus difficiles à identifier en un coup d'œil.

L'ajout manuellement des icônes de jeton aide à améliorer la convivialité en garantissant que chaque jeton a une représentation visuelle reconnaissable. Ceci est particulièrement utile pour les utilisateurs qui gèrent régulièrement les jetons multiples. Si vous rencontrez un jeton sans icône, c'est probablement parce que Metamask n'a pas encore indexé les métadonnées du jeton , ou que les développeurs de jeton ne l'ont pas soumis pour inclusion dans les référentiels publics.

Comment Metamask affiche-t-il les icônes de jeton?

Metamask tire des informations en jetons de plusieurs sources, notamment des listes de jetons de Coingecko et de la communauté telles que celles trouvées sur des référentiels GitHub comme tokenlists.org . Lorsqu'un jeton est ajouté au portefeuille d'un utilisateur, Metamask tente de récupérer son symbole, son nom et son icône à partir de ces sources . Si les données ne sont pas disponibles, le jeton apparaît avec une icône d'espace réservée générique.

L'icône elle-même est généralement stockée comme une URL pointant vers un fichier image hébergé en ligne. Pour que Metamask affiche l'icône correcte, l'adresse du contrat de jeton doit être associée à cette URL d'image dans l'une des listes de jetons reconnues . L'ajout manuelle d'une icône de jeton consiste à mettre à jour l'une de ces listes ou à configurer votre portefeuille local pour reconnaître le chemin d'icône personnalisé.

Étapes pour ajouter manuellement une icône de jeton via la liste des jetons personnalisés

Pour ajouter manuellement une icône de jeton dans Metamask, une méthode implique la création ou la modification d'un fichier JSON de liste de jetons personnalisé qui inclut l'URL d'icône pour le jeton souhaité. Voici comment:

• Assurez-vous d'avoir l' adresse du contrat de jeton et l' URL de l'icône .

• Créez un nouveau fichier JSON ou modifiez un format existant suivant le format:

   {
   'name': 'Custom Token List',
   'logoURI': 'https://example.com/icon.png',
   'timestamp': '2024-03-15T12:00:00Z',
   'tokens': [ { 'chainId': 1, 'address': '0x...', 'symbol': 'TKN', 'name': 'Token Name', 'decimals': 18, 'logoURI': 'https://example.com/tkn-icon.png' }

  ]]
  }

• Enregistrez le fichier et téléchargez-le sur un serveur accessible au public ou un service d'hébergement (par exemple, les pages GitHub).

• Dans Metamask, accédez à Paramètres> Advanced> Gérer les listes de jetons .

• Cliquez sur Ajouter une liste de jetons et collez l'URL de votre fichier JSON hébergé.

• Confirmer et recharger Metamask si nécessaire.

Après avoir terminé ces étapes, votre icône de jeton personnalisée devrait maintenant apparaître aux côtés du nom de jeton dans votre portefeuille.

Ajout d'une icône de jeton sans modifier les listes de jetons

Si vous préférez ne pas gérer les listes de jetons externes, vous pouvez remplacer manuellement l'icône de jeton dans votre instance Metamask à l'aide d'outils de développement. Cette méthode s'applique uniquement à votre installation locale et n'affectera pas les autres utilisateurs.

• Ouvrez Metamask et assurez-vous que le jeton que vous souhaitez personnaliser est déjà ajouté.
• Cliquez avec le bouton droit sur l'extension MetAmask dans votre navigateur et sélectionnez Inspecter pour ouvrir les outils du développeur.
• Accédez à l' onglet Application , puis sous le stockage local , trouvez l'entrée pour metamask-controller-state .
• Localisez la section tokens et trouvez l'objet de jeton correspondant à l'adresse du contrat.
• Dans l'objet token, ajoutez une nouvelle paire de valeurs clés: 'iconUrl': 'https://example.com/tkn-icon.png' .
• Recharger Metamask pour voir l'icône mise à jour.

Cette approche nécessite une certaine familiarité avec les outils de développeur de navigateur et n'est pas persistant entre les appareils ou les sessions sauf sauvegardés .

Où pouvez-vous trouver des icônes de jeton pour l'ajout manuel?

Il est essentiel de trouver l'icône correcte pour un jeton spécifique lors de l'ajout manuellement à Metamask. Les sources les plus fiables comprennent:

• Sites Web officielles de jetons : la plupart des projets hébergent des icônes de haute qualité sur leurs sites officiels.
• Référentiels de GitHub : de nombreux développeurs de jetons maintiennent des actifs, y compris les icônes, dans les référentiels publics.
• Listes de jetons axées sur la communauté : Des plates-formes comme tokenlists.org contiennent souvent des URL icônes vérifiées pour divers jetons.
• Répertoires d'actifs tiers : certains services regroupent les métadonnées de jetons et offrent des icônes téléchargeables.

Avant d'utiliser une URL d'icône, assurez-vous qu'il pointe directement vers un fichier .png et est accessible au public sans authentification. L'utilisation de liens cassés ou non autorisés peut entraîner le chargement des icônes ou bloqué par Metamask.

---

Questions fréquemment posées (FAQ)

Q: Puis-je utiliser un format d'image pour une icône de jeton dans Metamask?

Metamask prend principalement en charge les fichiers .png pour les icônes de jetons en raison de leur support de transparence et de leur large compatibilité. L'utilisation d'autres formats comme .jpg ou .svg peut entraîner des problèmes d'affichage ou un rendu non pris en charge .

Q: Les icônes de jetons ajoutées manuellement resteront-elles après la mise à jour de Metamask?

Les icônes ajoutées par des modifications locales (comme l'édition de stockage local) peuvent se réinitialiser après les mises à jour ou la compensation du cache. Cependant, les icônes ajoutées via des listes de jetons personnalisées sont conservées tant que la liste reste active et inchangée.

Q: Existe-t-il une exigence de taille pour les icônes de jeton dans Metamask?

Bien qu'il n'y ait pas d'exigence de taille stricte, il est recommandé d'utiliser des images carrées d'au moins 64 x 64 pixels pour plus de clarté. Des tailles plus grandes (par exemple, 256x256) sont préférées pour les écrans haute résolution.

Q: Puis-je soumettre l'icône de mon jeton à inclure dans la liste par défaut de Metamask?

Oui, vous pouvez soumettre votre jeton à des plates-formes comme Coingecko ou la liste de jetons d'UniSwap pour une reconnaissance plus large. La soumission à ces services augmente la probabilité de détection automatique des icônes dans Metamask sans intervention manuelle.