Comment ajouter un jeton ERC-721 ou ERC-1155 à Metamask?

Metamask prend en charge les jetons ERC-721 et ERC-1155, qui peuvent être ajoutés manuellement à l'aide de leurs adresses contractuelles et sont affichées sous l'onglet "Collectibles".

Jul 02, 2025 at 04:01 am

Comprendre les jetons ERC-721 et ERC-1155

ERC-721 et ERC-1155 sont deux des normes de jeton les plus populaires sur la blockchain Ethereum. ERC-721 est principalement utilisé pour les jetons non butins (NFT), où chaque jeton représente un atout unique. D'un autre côté, l'ERC-1155 permet à la fois des jetons fongibles et non butins dans le même contrat, le rendant plus flexible et efficace dans certaines applications.

Avant d'ajouter ces jetons à votre portefeuille, il est essentiel de comprendre que Metamask , l'un des principaux portefeuilles Ethereum, prend en charge les deux types de jetons. Cependant, contrairement aux jetons ERC-20 , qui peuvent être automatiquement détectés ou ajoutés via un processus simple, les jetons ERC-721 et ERC-1155 nécessitent un ajout manuel en utilisant des adresses contractuelles spécifiques.

Prérequis avant d'ajouter des jetons

Pour ajouter avec succès un jeton ERC-721 ou ERC-1155 à Metamask , assurez-vous d'avoir ce qui suit:

• Un portefeuille métamasque fonctionnel installé comme extension de navigateur ou application mobile.
• L' adresse du contrat correct du jeton que vous souhaitez ajouter.
• Accès au réseau Ethereum (ou au réseau approprié où le jeton existe).
• Connaître si le jeton est ERC-721 ou ERC-1155 , bien que Metamask gère les deux de la même manière lors de l'ajout manuellement.

Si vous n'êtes pas sûr de l' adresse du contrat , vérifiez le marché NFT où vous avez acheté le jeton, tel que Opensea, Rarible ou LooksRare. La plupart des plates-formes affichent l'adresse du contrat dans la section Détails NFT.

Étapes pour ajouter un jeton ERC-721 ou ERC-1155

Pour ajouter manuellement un jeton à Metamask , suivez ces étapes:

• Ouvrez votre portefeuille Metamask et assurez-vous que vous êtes connecté au réseau correct où réside le jeton (par exemple, Ethereum MainNet, Polygon, etc.).
• Accédez à l' onglet «Assets» situé en haut de l'interface du portefeuille.
• Cliquez sur le bouton «Importer Tokens» trouvé en bas de l'écran.
• Dans la fenêtre contextuelle, sélectionnez l' onglet «Jeton personnalisé» .
• Collez l' adresse du contrat de jeton dans le champ désigné.
• Attendez que Metamask récupérera automatiquement le symbole du jeton et les décimales. S'il échoue, vous devrez peut-être les entrer manuellement si disponibles.
• Confirmez en cliquant sur le bouton «suivant» , suivi de «Ajouter des jetons» .

Une fois terminé, le jeton doit apparaître sous votre onglet «Collectibles» s'il s'agit d'un ERC-721 ou d'un ERC-1155 .

Localisation des jetons ajoutés dans Metamask

Après l'importation, les jetons ERC-721 et ERC-1155 n'apparaîtront pas dans la section «Tokens» principale. Au lieu de cela, ils sont affichés dans la section «Collectibles» de votre portefeuille. Pour y accéder:

• Ouvrez votre portefeuille Metamask .
• Cliquez sur l' onglet «Collectibles» .
• Vous devriez voir tous les objets de collection importés répertoriés ici, y compris leurs miniatures et leurs informations de base.

Si une vignette ne se charge pas immédiatement, attendez quelques instants ou rafraîchissez le portefeuille. Parfois, les images prennent le temps de récupérer à partir du stockage décentralisé comme les IPF.

Dépannage des problèmes communs

Parfois, les utilisateurs sont confrontés à des problèmes lorsque vous essayez d'ajouter des jetons ERC-721 ou ERC-1155 à Metamask . Voici quelques problèmes communs et comment les résoudre:

• Le jeton n'apparaît pas après l'importation : revérifiez l' adresse du contrat pour toute fausse ou les caractères incorrects. Assurez-vous également que vous êtes sur le réseau correct.
• Vignette non chargée : cela est souvent dû au chargement d'image lent à partir de sources décentralisées. Essayez de rafraîchir ou d'attendre quelques minutes.
• Réseau incorrect sélectionné : assurez-vous que le réseau dans Metamask correspond au réseau où le jeton a été émis. Par exemple, si le jeton est sur le polygone , basculez Metamask au polygone Mainnet avant l'importation.
• Symbole de jeton non détecté : certains contrats n'exposent pas correctement les métadonnées. Si cela se produit, vous pouvez toujours ajouter le jeton, mais vous devrez compter sur des outils externes pour vérifier la propriété et les métadonnées.

Si aucune de ces solutions ne fonctionne, envisagez de tendre la main à la plate-forme ou à la communauté où vous avez obtenu le jeton pour plus d'assistance.

Connexion avec des plates-formes externes

De nombreux marchés NFT permettent une connexion directe à Metamask , permettant une visualisation et une gestion transparentes des jetons ERC-721 et ERC-1155 . Cependant, parfois les jetons peuvent ne pas se synchroniser immédiatement en raison de problèmes de mise en cache ou de métadonnées.

Pour assurer la synchronisation:

• Débranchez et reconnectez votre portefeuille Metamask à la plate-forme.
• Effacez le cache ou les cookies dans votre navigateur si vous utilisez un portefeuille sur le Web.
• Utilisez l'option «Refresh Metadata» si disponible sur la plate-forme.

Cela garantit que le dernier état de vos objets de collection se reflète à la fois dans le portefeuille et le marché.

---

Questions fréquemment posées

Q: Puis-je ajouter plusieurs jetons ERC-721 ou ERC-1155 à la fois?

R: Non, Metamask ne permet actuellement qu'un seul jeton d'être ajouté à la fois manuellement. Vous devez répéter le processus d'importation pour chaque jeton.

Q: Que dois-je faire si l'adresse du contrat change?

R: Les adresses du contrat sont immuables une fois déployées sur la blockchain. Si vous pensez qu'il y a un changement, vérifiez la source ou contactez l'équipe du projet, car elle pourrait indiquer une désinformation ou une fraude.

Q: Dois-je payer des frais de gaz pour ajouter des jetons à Metamask?

R: Non, l'ajout de jetons à Metamask ne nécessite aucun frais de transaction ou de gaz. C'est purement une action de vue uniquement.

Q: Pourquoi mes jetons ERC-1155 apparaissent-ils comme des entrées distinctes pour chaque identifiant?

R: C'est un comportement normal. Les jetons ERC-1155 prennent en charge plusieurs ID dans un seul contrat, et Metamask répertorie chaque ID séparément sous l' onglet «Collectibles» .