Comment vérifier qui détient un NFT : ERC-721 et ERC-1155
Une image de NFT ou le nombre de jetons d'une collection ne désigne pas le détenteur d'un jeton précis. Choisissez la bonne lecture.
Pour un jeton ERC-721 existant, consultez ownerOf(tokenId) sur le bon contrat de collection afin de connaître son détenteur actuellement enregistré. Pour ERC-1155, consultez balanceOf(account, id) afin de connaître le nombre d’unités de cet ID détenues par un compte. Les questions diffèrent : les unités d’un type ERC-1155 peuvent être réparties entre plusieurs comptes.
Commencez par le réseau, l’adresse complète du contrat de collection et l’ID du jeton. Conservez ces trois identifiants ensemble lors de la vérification dans un explorateur ou un lecteur de contrats familier. Une image identique, un nom de collection ou un nombre total de NFT ne suffit pas à identifier un avoir précis.
Ce guide vérifie les registres publics des jetons. Il n’établit ni l’identité de la personne derrière une adresse, ni l’authenticité ou le prix d’une œuvre, ni vos droits auprès d’un service de garde. La procédure ne comporte aucun transfert ni connexion de portefeuille.
Choisir la requête adaptée au standard du jeton
L’interface ERC-721 propose à la fois un décompte par compte et la recherche d’un jeton individuel. Pour ERC-1155, l’interface standard demande ensemble un compte et un ID de type de jeton.
| Standard et lecture | Données à fournir | Sens du résultat |
|---|---|---|
ERC-721 ownerOf(tokenId) |
Un ID de jeton | Adresse du détenteur de ce jeton existant |
ERC-721 balanceOf(account) |
Une adresse de compte | Nombre de NFT de ce contrat détenus par le compte |
ERC-1155 balanceOf(account, id) |
Compte et ID de type de jeton | Nombre d’unités de cet ID détenues par le compte |
Supposons qu’une collection ERC-721 fictive contienne les jetons d’ID 42 et 43. Le compte A détient 42 ; le compte B détient 43. Les deux décomptes valent 1. Ces nombres ne permettent pas de savoir quel compte détient 42 ; la recherche par ID le permet.
Prenons maintenant un autre contrat ERC-1155 fictif. Le compte A détient 3 unités de l’ID 42 et le compte B en détient 2. Les deux soldes peuvent être positifs au même instant. Qualifier A d’unique propriétaire de l’ID 42 ignorerait les unités de B. Ces exemples expliquent les lectures ; ce ne sont pas les résultats d’une collection réelle.
Identifier la collection et l’ID avant de se fier à une correspondance
Un ID de jeton appartient à un contrat précis. L’ID 42 d’une collection ne désigne pas l’ID 42 d’une autre. Les règles d’identification ERC-721 décrivent le couple contrat et ID sur une chaîne ; ne supposez pas que les ID se suivent.
Retrouvez les informations officielles de déploiement de la collection par une voie fiable, ou utilisez une transaction connue, pour confirmer le réseau et l’adresse complète du contrat. Un contrat contrefait peut reprendre un nom et une image familiers. Une réponse apparemment standard de cette copie n’en fait pas la collection recherchée.
Relevez l’ID dans les détails de l’objet au lieu de le deviner à partir de son nom. Conservez sa valeur exacte. Si une interface affiche un ID hexadécimal et une autre un ID décimal, vérifiez qu’ils représentent le même entier avant de les comparer. L’adresse du contrat identifie la collection ; l’adresse du compte désigne le détenteur à vérifier. Le guide des adresses de portefeuille et de contrat de jeton explique cette distinction.
Pour un objet inattendu, lisez le guide de sécurité sur les NFT indésirables avant d’ouvrir un lien intégré à sa description. Vous pouvez consulter les registres publics par une voie déjà fiable sans suivre un lien de réclamation.
Effectuer une lecture et conserver le résultat
Les étapes suivantes décrivent comment consulter des registres publics. Elles n’ont pas été testées sur un portefeuille réel pour cet article. La documentation primaire de ces méthodes a été consultée le 24 octobre 2026.
- Noter l’identité complète. Consignez le réseau, le contrat de collection et l’ID exact du jeton. Ajoutez l’adresse du compte si vous vérifiez un portefeuille précis.
- Confirmer le standard et choisir sa méthode publique de lecture. Utilisez les détails du contrat et l’interface vérifiée de l’explorateur de confiance. Les intitulés varient. Pour ERC-721, utilisez
ownerOfavec l’ID ; pour ERC-1155,balanceOfavec le compte et l’ID. Une interface absente ou non prise en charge appelle une vérification, pas l’hypothèse d’un autre standard. - Lire l’état actuel et noter quand il a été observé. Enregistrez l’adresse ou la quantité renvoyée et le numéro de bloc lorsqu’il est disponible. Comparez si possible les appels au même bloc : des lectures séparées du dernier état peuvent encadrer un transfert.
- Interpréter la réponse à la bonne échelle. Comparez l’adresse complète renvoyée par ERC-721 au compte visé. Pour ERC-1155, un nombre positif confirme les unités enregistrées pour ce compte ; une réponse valide de zéro indique leur absence à cet endroit au moment observé. Aucun des deux résultats n’énumère tous les autres détenteurs.
- Marquer les lectures échouées ou indisponibles comme inconnues. Conservez l’erreur ou l’indication d’indisponibilité. Vérifiez ID, contrat, réseau et outil de lecture avant de conclure à l’absence du jeton. Une requête échouée ne devient pas un solde nul.
La référence OpenZeppelin ERC721 exige un jeton existant pour la méthode publique ownerOf. Un ID inexistant ou brûlé peut donc provoquer une erreur au lieu de fournir un détenteur exploitable. Cette erreur seule ne permet pas de savoir si vous avez mal saisi l’ID, choisi un autre contrat ou interrogé un jeton invalide.
Ne confondez pas cette fonction publique avec une fonction auxiliaire interne dont le nom commence par un trait de soulignement. Vous consultez l’interface publique documentée. Ces lectures ne nécessitent ni signature, ni autorisation, ni phrase de récupération. Si un site en demande uniquement pour révéler le détenteur, abandonnez cette procédure.
Quand le détenteur enregistré est un contrat
Un NFT peut être détenu par un compte de contrat. L’adresse renvoyée peut donc appartenir à un coffre, un séquestre, un dispositif de staking ou un autre service plutôt qu’à votre portefeuille de signature. Cela ne détermine pas, à lui seul, qui dispose des droits économiques ni si l’objet peut être récupéré.
Si vous avez délibérément déposé le NFT auprès d’un service, vérifiez ses registres officiels et la transaction de dépôt connue. Reliez les droits de votre compte à la collection et à l’ID exacts. Ne transférez ni ne retirez des actifs simplement pour obtenir l’image attendue dans la galerie du portefeuille.
Pour une position de liquidité, la vérification du détenteur indique seulement quelle adresse détient le NFT. Le guide du NFT de position Uniswap v3 traite séparément la vérification des actifs et frais de la position sous-jacente. L’adresse du détenteur du NFT, seule, ne fournit aucun de ces montants.
Terminer par un avoir identifié, pas par une miniature
La référence OpenZeppelin ERC1155 décrit le résultat comme des unités d’un type précis détenues par un compte. Conservez cette quantité avec le compte et l’ID. Ne la remplacez pas par une étiquette de propriétaire unique à la manière d’ERC-721 et ne la divisez pas selon une échelle décimale ERC-20 sans rapport.
Votre relevé est complet lorsqu’il contient le réseau, le contrat, l’ID du jeton, le standard, le détenteur renvoyé ou les unités par compte et le bloc ou l’heure d’observation. Ajoutez une note sur la garde si le détenteur enregistré est un contrat de service. Si un champ essentiel reste indéterminé, marquez l’avoir comme non vérifié.
Une galerie facilite la navigation ; ce relevé répond à la question plus précise de ce que le contrat choisi indique pour ce jeton exact. Il ne certifie pas la collection, n’accorde aucun droit de transfert, n’identifie aucune personne et ne calcule aucun prix de vente.
Questions fréquentes
Un solde ERC-721 de 1 prouve-t-il que ce portefeuille détient mon NFT précis ?
Non. balanceOf compte les NFT de ce contrat détenus par le compte. Utilisez ownerOf avec l'ID précis pour connaître le détenteur actuellement enregistré. Vérifiez le même réseau et le même contrat de collection.
Plusieurs portefeuilles peuvent-ils détenir le même ID ERC-1155 ?
Oui. Un ID ERC-1155 peut représenter plusieurs unités. balanceOf prend un compte et un ID et indique les unités de ce type détenues par ce compte. Un résultat positif ne prouve pas qu'il est le seul détenteur.
Faut-il connecter mon portefeuille ou signer pour vérifier le détenteur ?
Ces lectures publiques ne nécessitent ni signature du portefeuille, ni autorisation, ni phrase de récupération. Le résultat identifie les avoirs enregistrés, pas la personne derrière une adresse ni un droit distinct auprès d'un service de garde.