Parts ERC-4626 et actifs : comprendre le solde du coffre

Le solde d’un coffre ERC-4626 est un nombre de parts, pas automatiquement le même nombre de jetons sous-jacents. Identifiez l’actif du coffre, puis distinguez conversion générale, estimation de rachat et limite de rachat du propriétaire. Ces chiffres répondent à des questions différentes sur une même position.

Si un portefeuille affiche 100 parts alors que l’écran du protocole indique 120 jetons sous-jacents, ne supposez pas d’emblée qu’un solde est faux. Vérifiez d’abord ce que mesure chaque nombre. Ce guide permet de rapprocher une détention existante par simple lecture ; il ne recommande ni de déposer dans un coffre ni de racheter les parts.

Identifier le jeton de part et son actif sous-jacent

La norme ERC-4626 définit les parts de coffre comme des jetons ERC-20. balanceOf(account) compte ces parts ; asset() identifie le contrat du jeton sous-jacent. Conservez les deux adresses de contrat avec le réseau et le compte vérifiés.

Un symbole familier ne suffit pas. Confirmez le déploiement exact du coffre dans la documentation officielle du protocole ou une transaction connue, accessible par un chemin fiable. Comparez ensuite l’adresse de l’actif sous-jacent, et pas seulement son nom, avec le jeton attendu. Un contrat copié peut exposer des noms de méthodes familiers sans être le coffre recherché.

Vérifiez les unités des deux côtés. Un montant brut de parts utilise les décimales du jeton de part ; un résultat brut en actifs utilise celles du jeton sous-jacent. Elles ne sont pas nécessairement identiques : le guide des coffres d’OpenZeppelin décrit des implémentations offrant une précision supplémentaire aux parts. Notre guide des décimales des jetons explique comment reconnaître un entier qui doit encore être mis en forme. Ne redimensionnez pas une seconde fois un montant déjà formaté.

Choisir le chiffre qui répond à votre question

Utilisez les lectures documentées du contrat vérifié plutôt que de multiplier par un taux copié d’un autre coffre. La référence API d’OpenZeppelin distingue conversion, estimation et limites.

Lecture	Unité renvoyée	Question traitée
balanceOf(account)	Parts	Combien de parts ce compte détient-il ?
convertToAssets(shares)	Actifs sous-jacents	Quel est l’équivalent général en actifs ?
previewRedeem(shares)	Actifs sous-jacents	Quelle est l’estimation de rachat de ces parts ?
maxRedeem(owner)	Parts	Combien de parts ce propriétaire peut-il racheter actuellement ?

convertToAssets décrit une conversion idéale, hors frais et glissement de l’échange réel. Ce n’est pas un devis de retrait personnalisé. previewRedeem inclut les frais de retrait et reflète les conditions actuelles, mais ignore volontairement les limites de rachat. Pour ces limites, lisez maxRedeem du propriétaire. Les définitions des méthodes de la norme rendent ces distinctions explicites.

Une estimation positive est donc compatible avec une limite plus faible, voire nulle. Une lecture ne réserve pas non plus les fonds : l’état peut changer avant une transaction ultérieure. Suivez les conditions de retrait documentées de ce coffre, y compris toute procédure de demande obligatoire. Un coffre utilisant une extension asynchrone ou une autre interface exige ses propres instructions.

Ne compter qu’une détention dans votre comparaison

Prenons un instantané hypothétique dont tous les chiffres sont déjà exprimés en unités lisibles. Un compte détient 100 parts. Pour ce nombre de parts, le coffre indique 120 jetons sous-jacents via convertToAssets et 119 jetons sous-jacents via previewRedeem. Séparément, maxRedeem du compte vaut 40 parts.

Les 120 jetons sont un équivalent général. Les 119 jetons sont l’estimation pour les 100 parts, pas la preuve que les 100 peuvent être rachetées maintenant. La limite de 40 parts est mesurée en parts ; il ne faut pas la comparer comme s’il s’agissait de 40 jetons sous-jacents. Pour examiner la quantité de parts autorisée, obtenez son estimation propre plutôt que d’appliquer sans changement celle du solde entier.

Ces chiffres constituent un exemple inventé de libellés et de périmètre, pas une cotation actuelle de coffre, un barème de frais ni le calcul du taux d’un protocole particulier. Aucun portefeuille n’a été interrogé et aucune transaction n’a été exécutée pour cet exemple.

N’additionnez pas 100 parts et leur équivalent de 120 jetons comme des détentions distinctes. Ils décrivent la même position. Si le portefeuille détient aussi des jetons sous-jacents hors du coffre, enregistrez séparément ce solde réel. Pour comparer des totaux en monnaie fiduciaire, vérifiez quelle représentation un outil de suivi a déjà comptée avant d’ajouter la valeur du protocole. Le guide général de rapprochement de portefeuille aide à distinguer une quantité manquante d’un prix manquant ou d’une position non prise en charge.

Enregistrer un instantané cohérent sans déplacer de fonds

Utilisez un explorateur ou un lecteur de contrats auquel vous faites déjà confiance. Cette procédure décrit une inspection fondée sur la documentation ; elle n’a pas été testée sur un coffre actif pour cet article. Les références primaires ont été vérifiées le 25 octobre 2026.

1. Confirmez l’identité de la position. Notez le réseau, le compte et l’adresse complète du contrat du coffre. Vérifiez que ce déploiement utilise l’interface ERC-4626 que vous voulez inspecter.
2. Identifiez l’actif et les unités. Notez asset() et les échelles décimales des parts et de l’actif. Lisez le solde de parts du compte en distinguant entiers bruts et quantités formatées.
3. Choisissez la lecture pertinente. Pour un rapprochement comptable, notez convertToAssets pour ce nombre exact de parts. Pour une estimation de rachat, notez previewRedeem et étiquetez le résultat comme estimation.
4. Vérifiez séparément la limite du propriétaire. Lisez maxRedeem(owner) et les conditions de retrait du protocole. Ne remplacez pas une limite indisponible par le solde de parts et ne prenez pas une estimation positive pour une autorisation de rachat.
5. Alignez et étiquetez les observations. Préférez le même bloc pour solde, conversion, estimation et limite. Si le lecteur ne propose que des appels séparés au dernier état, conservez leurs horaires et signalez que les instantanés peuvent différer.
6. Rapprochez une seule position. Gardez ensemble nombre de parts, équivalent en actifs et informations de rachat. Marquez une lecture échouée comme inconnue, conservez son erreur et examinez compte, contrat, réseau ou interface avant de conclure à un montant nul.

Ces lectures publiques n’exigent ni signature, ni autorisation de dépense, ni phrase de récupération, ni transfert. Si un site demande l’un de ces éléments uniquement pour afficher un solde, arrêtez ce parcours. Une réponse de contrat peut expliquer un affichage ; elle ne certifie pas la sécurité du contrat.

Une conversion n’est ni un rendement ni un prix de vente

L’équivalent en actifs indique comment le coffre exprime un nombre de parts dans son jeton sous-jacent. Il n’établit ni bénéfice par rapport à votre dépôt initial, ni prix de vente sur le marché, ni rachat futur garanti. Frais, arrondis, modifications du coffre et prix propre de l’actif sous-jacent doivent être consignés séparément.

Ne généralisez pas cette procédure à tous les jetons représentant un dépôt. Par exemple, stETH et wstETH ont leur propre comptabilité et méthode de conversion documentées. Un solde d’apparence similaire ne prouve pas un comportement ERC-4626.

La vérification est terminée lorsque vous pouvez nommer le coffre et l’actif exacts, identifier le nombre de parts et l’instantané, puis expliquer quel écran affiche conversion, estimation ou limite. Si une lecture essentielle est indisponible, laissez cette partie non vérifiée. Déplacer la position relève d’une décision distincte ; ce n’est pas nécessaire pour expliquer son solde affiché.