Comment ajouter des jetons personnalisés à MetaMask ? (Guide d'adresse du contrat)

Comprendre l'intégration des jetons personnalisés

1. MetaMask prend en charge les jetons compatibles Ethereum via les normes ERC-20, ERC-721 et ERC-1155. Les utilisateurs ne peuvent pas simplement rechercher des jetons obscurs dans l'interface : beaucoup nécessitent un ajout manuel à l'aide d'adresses de contrat précises.

2. L'adresse contractuelle d'un jeton est une chaîne hexadécimale unique de 42 caractères déployée sur une blockchain spécifique. Cette adresse sert d'identifiant définitif pour la logique du contrat intelligent et le suivi du solde du jeton.

3. L'ajout d'un jeton personnalisé sans vérifier le réseau correct peut entraîner des soldes nuls ou des actifs fantômes. Chaque jeton n'existe que sur la chaîne où son contrat a été déployé : Ethereum Mainnet, Polygon, BSC, Arbitrum et autres sont des environnements entièrement distincts.

4. MetaMask ne valide pas la légitimité du jeton. Les fraudeurs déploient fréquemment de faux contrats dont les noms imitent des projets populaires. Le croisement des adresses de contrat via Etherscan, Polygonscan ou BscScan est obligatoire avant de continuer.

5. Le symbole du jeton et les décimales doivent correspondre à ceux définis dans le contrat. Des décimales incorrectes entraînent une fausse déclaration du solde : par exemple, saisir 18 décimales pour un jeton qui en utilise 9 affichera des soldes 1 milliard de fois plus petits que la réalité.

Navigation dans le flux d'ajout manuel

1. Ouvrez MetaMask et assurez-vous que le bon réseau est sélectionné dans la liste déroulante en haut à gauche. Il doit correspondre à l'endroit où réside le contrat du jeton.

2. Cliquez sur l'onglet « Actifs », puis faites défiler vers le bas et sélectionnez « Importer des jetons ». Un modal apparaît avec trois onglets : « Jeton personnalisé », « Listes de jetons » et « NFT ».

3. Choisissez « Jeton personnalisé » et collez l'adresse du contrat vérifiée dans le champ désigné. MetaMask récupère automatiquement le nom, le symbole et les décimales si le contrat répond correctement aux appels ERC standard.

4. Si la détection automatique échoue, saisissez manuellement le nom du jeton, le symbole et les décimales. Ces valeurs doivent provenir de la documentation officielle du projet ou de pages vérifiées de l'explorateur de blocs, et non de discussions communautaires ou de sites Web non vérifiés.

5. Cliquez sur « Suivant », vérifiez les détails, puis cliquez sur « Ajouter des jetons ». Le jeton apparaît immédiatement sous « Actifs » si le portefeuille en détient un solde non nul.

Pièges courants liés aux adresses contractuelles

1. Les erreurs de copier-coller introduisent des caractères Unicode invisibles ou des espaces supplémentaires. Collez toujours d'abord dans un éditeur de texte brut et recopiez la chaîne propre de 42 caractères.

2. Certains jetons existent sur plusieurs chaînes avec des noms identiques mais des contrats différents : l'USDT sur Ethereum utilise 0xdAC17F958D2ee523a2206206994597C13D831ec7, tandis que l'USDT sur Polygon utilise 0xc2132D05D31c914a87C6611C10748AEb04B58e8F.

3. Les contrats déployés sur les réseaux de test ne fonctionnent pas sur les réseaux principaux. Tenter d'ajouter un jeton basé sur Goerli au réseau principal Ethereum entraîne un actif non reconnu sans visibilité sur le solde.

4. Les jetons renommés ou mis à niveau conservent souvent les anciennes adresses de contrat dans des listes non officielles. Des projets comme ChainLink ont ​​migré de 0xa0b73e1ff0b80914ab6fe04447664353ee79dff5 vers 0x514910771AF9Ca656af840dff83E8264EcF986CA : l'utilisation d'adresses obsolètes produit des soldes vides.

Vérification de l'authenticité du jeton après l'importation

1. Après l'importation, cliquez sur le nom du jeton dans la liste Actifs pour ouvrir sa vue détaillée. MetaMask affiche l'adresse du contrat : cliquez dessus pour ouvrir l'explorateur de blocs par défaut pour ce réseau.

2. Sur Etherscan ou équivalent, vérifiez l'onglet « Contrat » pour confirmer qu'il est vérifié. Les contrats non vérifiés n'affichent que le bytecode et présentent de sérieux risques.

3. Consultez la section « Lire le contrat » pour appeler totalSupply() et decimals() . Comparez les valeurs renvoyées avec celles saisies lors de l'importation.

4. Examinez l'onglet « Transactions » pour les transferts entrants récents vers des adresses de titulaires connues. Des pics soudains provenant d’expéditeurs inconnus peuvent indiquer une manipulation de liquidité ou des tirages au sort.

5. Vérifiez la section « Analytics » ou « Détenteurs de jetons ». Les jetons légitimes ont généralement des centaines ou des milliers de détenteurs ; les jetons avec moins de dix adresses actives justifient un examen immédiat.

Foire aux questions

Q : Pourquoi MetaMask affiche-t-il « Jeton inconnu » après avoir ajouté l'adresse du contrat ? MetaMask l'affiche lorsque le contrat ne dispose pas d'interfaces ERC standard ou n'a pas été vérifié sur l'explorateur de blocs. Cela ne signifie pas que le jeton n'est pas valide, mais simplement que les métadonnées ne peuvent pas être récupérées automatiquement.

Q : Puis-je ajouter un jeton en utilisant uniquement son nom ou son symbole au lieu de l'adresse du contrat ? Non. MetaMask nécessite l’adresse exacte du contrat. Le nom et le symbole seuls sont insuffisants et ne sont pas uniques au monde : plusieurs contrats peuvent partager des identifiants identiques.

Q : Que se passe-t-il si j'ajoute deux fois le même jeton avec des adresses de contrat légèrement différentes ? MetaMask traite chaque adresse comme un atout distinct. Les entrées en double apparaissent séparément dans la liste des actifs, même si elles représentent le même jeton économique sur la chaîne.

Q : L'ajout d'un jeton personnalisé expose-t-il mes clés privées ou ma phrase de départ ? Non. MetaMask effectue toutes les opérations côté client. L'interaction contractuelle se produit via des messages signés acheminés via des points de terminaison RPC : aucune donnée sensible ne quitte l'extension du navigateur.