NFT de position Uniswap v3 : vérifier les actifs sous-jacents

Le NFT d’une position directe Uniswap v3 représente la propriété d’une position de liquidité, pas un objet de collection avec un solde fixe de tokens. Pour comprendre ce que vous détenez actuellement, vérifiez les actifs dans cette position et ses frais non collectés. Sa présence dans un portefeuille, son image ou un prix plancher de NFT ne permettent pas d’établir cette valeur.

Commencez par la chaîne, le contrat du gestionnaire de positions et l’identifiant du token NFT. Consultez ensuite les quantités actuelles, l’état de la plage et les frais non collectés, puis comptez la position une seule fois. Si son identité ou un montant reste incertain, indiquez qu’il n’est pas vérifié plutôt que d’inventer une valeur.

Ce guide sert à examiner une position directe v3 existante. Il ne vous demande ni de retirer la liquidité, ni de transférer le NFT, ni de choisir un pool. Une position détenue par un coffre (vault) ou un autre contrat de garde nécessite aussi les relevés de ce service.

Pourquoi votre dépôt apparaît comme un NFT

L’explication de la propriété par Uniswap distingue les tokens de liquidité UNI-V2 des NFT utilisés pour les positions v3. Dans v3, chaque position possède sa paire de tokens et sa plage de prix choisie. Le NFT identifie cette position ; les actifs déposés appartiennent à la position du pool au lieu de rester les mêmes soldes dépensables dans votre portefeuille.

Une ligne NFT et une ligne de position du protocole peuvent donc décrire le même avoir. Ce ne sont pas automatiquement deux actifs à additionner. Inversement, l’absence d’une ligne NFT dans un tableau de bord ne prouve pas que la position a disparu. Le tableau peut ne pas reconnaître son contrat, sa chaîne ou son propriétaire.

L’interface habituelle d’Uniswap peut aussi laisser un NFT après le retrait de liquidité. Une miniature familière ne prouve pas qu’il reste du capital. Vérifiez le relevé actuel avant d’attribuer une valeur.

Identifiez la position avant de consulter sa valeur

Partez de votre propre trace de l’apport de liquidité, par exemple une transaction déjà connue. Évitez les liens fournis par un NFT inattendu, un message privé ou une description de token. Examinez les données publiques de la blockchain sans saisir de phrase de récupération ni de clé privée.

Notez ces identifiants avant de comparer les soldes :

Vérification	Élément à noter
Réseau	La chaîne sur laquelle la liquidité a été apportée
Contrat de position	Le gestionnaire de positions v3 déployé sur cette chaîne
Identifiant de position	L’identifiant du token NFT avec son contrat
Détenteur actuel	Le propriétaire indiqué par le relevé actuel du contrat
Actifs	Les adresses des contrats des deux tokens

Un identifiant de token seul n’est pas unique à l’échelle mondiale. Ni la même adresse de portefeuille sur une autre chaîne ni un nom de NFT identique ne permettent d’identifier cette position. Comparez l’adresse du gestionnaire aux informations officielles de déploiement v3 du protocole pour cette chaîne. Si la transaction connue désigne un vault ou un contrat de staking comme détenteur, cessez de considérer la liste de NFT de votre portefeuille comme un relevé complet de propriété. Consultez le service qui détient la position et votre droit sur celle-ci.

Il s’agit d’une vérification d’identité, pas d’une recommandation de connecter un portefeuille. Si une interface exige une connexion pour afficher la position, confirmez d’abord le site officiel et comprenez la demande. La lecture des relevés n’exige ni signature de transfert ni nouvelle autorisation de dépense.

Lisez séparément les quantités, la plage et les frais

La documentation des détails de position distingue les montants détenus dans la position, les frais non collectés et les limites de prix choisies. Conservez ces champs séparément :

1. Vérifiez la quantité actuelle de chaque token sous-jacent. Vérifiez leurs adresses plutôt que de vous fier au seul symbole.
2. Notez la plage choisie et le prix actuel du pool. Précisez si la liquidité est active.
3. Notez les frais non collectés dans chaque token. Ne supposez pas qu’ils sont déjà inclus dans la valeur principale de la position.
4. Notez l’heure de lecture des chiffres et la disponibilité d’une cotation en monnaie fiduciaire. Un prix absent reste inconnu ; ce n’est pas un solde nul.

Pour une position directe v3, la composition évolue lorsque le prix parcourt la plage. Hors de celle-ci, la position ne contient qu’un token et cesse de gagner des frais de swap jusqu’au retour du prix dans la plage. Elle n’a pas forcément été retirée. L’aperçu de la liquidité Uniswap explique aussi que les frais accumulés sont collectés séparément et ne sont pas automatiquement réinvestis dans les positions ordinaires. Un vault géré peut fonctionner autrement ; n’appliquez donc pas cette comptabilité telle quelle à une part de vault.

Les quantités actuelles peuvent différer du dépôt initial. Pour rapprocher deux outils, comparez les relevés actuels, pas une position actuelle du pool avec un ancien reçu de dépôt. Cet examen ne calcule ni bénéfice, ni perte, ni la pertinence de l’apport de liquidité comme investissement.

Comptez la position une seule fois

Supposons, dans un exemple comptable hypothétique, qu’un protocole affiche $400 comme valeur actuelle des actifs dans la position et $7 de frais non collectés. Si les $400 excluent explicitement ces frais, le total à cette cotation et à cet instant est de $407. Si un tableau de bord inclut déjà les frais dans son total affiché, les ajouter à nouveau surestimerait celui-ci.

De même, additionner une position de $400 et sa représentation NFT de $400 produit un total erroné de $800 avant frais. Déterminez d’abord ce que comprend chaque ligne. Gardez l’identifiant de position à côté de votre entrée comptable pour rattacher le NFT et les détails du protocole à un seul avoir.

Séparez les tokens déjà revenus dans votre portefeuille des montants encore dans la position. Après un retrait ou une collecte de frais, actualisez les deux relevés avant de les rapprocher. Une page de protocole obsolète peut encore afficher un montant déjà déplacé dans le portefeuille. Cet exemple n’effectue aucune transaction.

Ce qu’un outil de suivi peut confirmer

Le code de la version Owlio 1.1.0 indique que les plages de liquidité v3 ne sont pas lues. Sa vue DeFi fondée sur les tokens ne reconstitue pas une position Uniswap. Installer l’outil ne fait pas apparaître la plage, les quantités sous-jacentes ou les frais manquants sous forme d’une valorisation complète de la liquidité.

Utilisez le suivi d’adresses publiques pour les avoirs du portefeuille pris en charge, et conservez la position vérifiée du protocole à côté. Si les totaux diffèrent, le guide de rapprochement des soldes aide à distinguer un défaut de couverture de données obsolètes. Ni une liste de NFT ni une source de données apparemment opérationnelle ne comblent une lacune de couverture.

L’examen est terminé lorsque la chaîne, le contrat, l’identifiant du token et le détenteur correspondent à la position visée, et que vous disposez des quantités actuelles, d’un état de la plage et de relevés séparés des frais. Si un champ reste incertain, marquez-le comme non vérifié. Modifier la liquidité ou la garde est une décision distincte avec ses propres vérifications de transaction.