Jetons LP Uniswap v2 : les actifs du pool derrière votre solde

Un solde de jetons LP Uniswap v2 décrit une part d’un pool précis, pas une quantité de l’un ou l’autre des jetons qu’il contient. Pour un instantané comptable en lecture seule, divisez votre solde LP par l’offre totale de LP de la paire, puis appliquez cette fraction à chaque réserve enregistrée. Associez chaque réserve à l’adresse de son jeton et à son échelle décimale.

Cela permet de décrire une position existante. Ce n’est ni un montant de retrait garanti, ni un calcul de bénéfice, ni une instruction pour retirer des liquidités. Une ligne de portefeuille étiquetée UNI-V2 n’est qu’un point de départ : de nombreuses paires différentes utilisent cette étiquette.

Trouver la paire avant d’interpréter son solde LP

L’explication des pools v2 d’Uniswap décrit les jetons de liquidité émis pour les fournisseurs. L’implémentation officielle du jeton LP utilise le même nom et le même symbole pour différentes paires. Un symbole seul ne permet donc pas d’identifier les actifs que représente une détention.

Partez du réseau et de l’adresse complète du contrat de la paire issus d’une transaction de liquidité connue ou de l’interface du protocole à laquelle vous faites déjà confiance. Confirmez la factory à l’aide de la liste officielle des déploiements v2 et vérifiez que les jetons recherchés correspondent à la paire de cette factory. Un nom copié ou un contrat exposant des méthodes familières ne prouve pas un déploiement officiel.

Dans cette implémentation v2, le contrat de la paire est aussi celui du jeton LP. Lisez ses adresses token0() et token1() avant d’utiliser les chiffres des réserves. reserve0 correspond à token0 ; reserve1 correspond à token1. N’attribuez pas les deux quantités selon l’ordre des symboles affichés sur un autre écran.

Limitez cette procédure aux paires Uniswap v2 ordinaires. Un fork, un coffre géré ou une position concentrée peuvent avoir une comptabilité différente. Un NFT de position Uniswap v3 nécessite son propre relevé de position plutôt que ce calcul fondé sur l’offre de LP.

Réunir un ensemble cohérent de quantités

Pour une position LP détenue directement, relevez ces données dans les contrats vérifiés de la paire et des jetons :

Lecture ou champ	Signification	Unité à conserver
balanceOf(account) de la paire	Jetons LP détenus par ce compte	Unités LP
totalSupply() de la paire	Tous les jetons LP émis	Mêmes unités LP
getReserves() de la paire	Réserves enregistrées de chaque côté	Entiers bruts des jetons
token0() et token1() de la paire	Adresses identifiant les deux actifs	Adresses complètes
Décimales de chaque jeton	Échelle de sa réserve brute	Sa propre échelle

Privilégiez un bloc commun pour toutes les lectures. Si l’outil propose seulement des appels séparés au dernier état, conservez leurs heures et signalez que la comparaison peut être incohérente. Un échange, un dépôt ou un retrait entre les appels peut modifier les données d’entrée.

Le solde LP et l’offre totale doivent utiliser la même échelle. Diviser deux entiers LP bruts est valable pour obtenir la fraction, tout comme diviser deux quantités LP correctement formatées. Mélanger un entier brut et un nombre formaté ne l’est pas. Pour les réserves, utilisez séparément les décimales de chaque jeton sous-jacent ; le guide des décimales des jetons explique cette conversion. Laissez les métadonnées inconnues non résolues plutôt que de supposer 18 par défaut.

Ne soustrayez pas les jetons LP verrouillés ou autrement inaccessibles de l’offre totale déclarée pour augmenter votre pourcentage. Ce calcul utilise l’offre émise du contrat, pas une offre en circulation supposée. Si l’offre est nulle ou qu’une lecture essentielle échoue, arrêtez le calcul et notez la donnée manquante.

Dérouler un instantané aux unités identifiées

Prenons une paire hypothétique dont les chiffres sont déjà formatés en unités lisibles. Elle compte 500 jetons LP émis et votre compte détient directement 5 jetons LP. Les réserves enregistrées sont de 80 unités du jeton A et de 24000 unités du jeton B. Ces quantités sont inventées ; il ne s’agit ni d’un pool en direct ni d’une cotation de prix.

La fraction LP est 5 / 500 = 0.01, soit 1%. Appliquée aux réserves enregistrées, elle donne :

• Jeton A : 80 * 0.01 = 0.8 unité.
• Jeton B : 24000 * 0.01 = 240 unités.

L’enregistrement obtenu décrit une position LP avec un équivalent fondé sur les réserves de 0,8 A et 240 B à cet instant. Ce n’est pas 5 A plus 5 B et les quantités de réserve ne sont pas des prix en dollars. Il n’est pas nécessaire de supposer que B est un stablecoin.

N’additionnez pas la valeur affichée du jeton LP et celle de ces mêmes quantités sous-jacentes comme s’il s’agissait de deux avoirs distincts. Les jetons détenus indépendamment hors du pool constituent un solde séparé. Si un tableau de bord décompose déjà le jeton LP en actifs sous-jacents, déterminez ce qu’il inclut avant tout ajout manuel.

C’est aussi différent d’une mesure de performance. Votre part actuelle des réserves n’indique ni les quantités initialement déposées, ni les flux ultérieurs, ni les coûts, ni la valeur qu’aurait la simple conservation des actifs initiaux. La comparaison entre perte impermanente et conservation traite cette question distincte.

Comprendre pourquoi ce n’est pas une promesse de remboursement

L’implémentation de la paire enregistre les réserves séparément de ses soldes réels de jetons. Son calcul de destruction utilise les soldes et peut émettre des jetons LP de frais du protocole avant de sélectionner l’offre totale. La division entière arrondit aussi les montants calculés. Une fraction des réserves enregistrées auparavant ne doit donc pas être présentée comme le montant exact qu’une transaction de retrait de liquidité délivrera.

La transaction peut se dérouler dans un état différent de celui de votre observation. Les règles de transfert propres au jeton peuvent aussi modifier les quantités reçues. Si vous décidez séparément d’effectuer une transaction, utilisez l’estimation actuelle de retrait et les conditions du protocole ; n’envoyez pas de jetons LP directement à la paire et n’appelez pas sa fonction de destruction de bas niveau dans le cadre de cette inspection.

Les quantités de réserve reflètent déjà l’état enregistré du pool. Leur ajouter une estimation de revenus de frais peut compter deux fois la même valeur. Ce guide ne calcule ni versement de frais, ni rendement futur, ni taux actuel de frais du protocole.

La garde ajoute une autre limite. Si les jetons LP ont été placés en staking ou déposés dans un coffre, le balanceOf direct de votre portefeuille peut être nul alors que le service enregistre un droit pour vous. Examinez le dépôt connu et la comptabilité propre au service. N’attribuez pas à votre compte tout le solde LP du service et ne réutilisez pas le calcul simple du portefeuille pour un jeton de reçu de coffre sans ses règles de conversion.

Conserver un relevé que vous pourrez vérifier à nouveau

Ces étapes s’appuient sur la documentation publique et le code source examinés le 28 octobre 2026. Elles n’ont pas été testées sur un portefeuille ou un pool en direct pour cet article.

1. Vérifiez la position. Notez le réseau, la paire, la factory, le compte et les adresses des deux jetons sous-jacents à partir de registres fiables du protocole.
2. Déterminez où sont détenus les jetons LP. Distinguez la détention directe du portefeuille des registres de staking, de coffre ou d’une autre forme de garde.
3. Relevez un instantané cohérent. Conservez le solde LP, l’offre LP émise, les deux réserves, leur correspondance avec les jetons et leurs échelles décimales, ainsi qu’un bloc ou les heures d’observation.
4. Ne calculez qu’avec des données utilisables. Divisez des unités LP identiques, puis appliquez la fraction séparément aux deux réserves. Gardez assez de précision ; n’arrondissez pas la fraction à zéro avant de multiplier.
5. Étiquetez le résultat et rapprochez les comptes une fois. Indiquez qu’il s’agit d’une estimation comptable fondée sur les réserves, conservez les notes sur la garde et les données manquantes, et vérifiez si une autre ligne du portefeuille représente déjà la même position.

Ces lectures publiques ne nécessitent ni signature du portefeuille, ni autorisation de dépense, ni phrase de récupération. Une demande de déplacement de fonds sort de cette procédure. Votre résultat est utile lorsque vous pouvez expliquer quelle paire vous détenez, ce que représentent ses quantités de réserve et pourquoi l’instantané diffère d’un devis de retrait. Laissez les champs non résolus inconnus plutôt que de transformer une lacune d’affichage en solde précis.