ERC-4626: Vault-Anteile und Vermögenswerte richtig unterscheiden

Ein ERC-4626-Vault-Bestand ist eine Anzahl von Anteilen und nicht automatisch dieselbe Anzahl zugrunde liegender Token. Ermitteln Sie das Asset des Vaults und unterscheiden Sie dann allgemeine Umrechnung, Rückgabevorschau und Rückgabelimit des Eigentümers. Diese Zahlen beantworten unterschiedliche Fragen zu einer Position.

Zeigt eine Wallet 100 Anteile und die Protokolloberfläche 120 zugrunde liegende Token, nehmen Sie nicht zuerst einen falschen Bestand an. Prüfen Sie, was jede Zahl misst. Dieser Leitfaden gleicht einen vorhandenen Bestand durch reine Lesezugriffe ab; er empfiehlt weder eine Einzahlung noch die Rückgabe der Anteile.

Anteil-Token und zugrunde liegendes Asset bestimmen

Der ERC-4626-Standard definiert Vault-Anteile als ERC-20-Token. balanceOf(account) des Vaults zählt diese Anteile; asset() bezeichnet den Vertrag des zugrunde liegenden Tokens. Notieren Sie beide Vertragsadressen zusammen mit Netzwerk und geprüftem Konto.

Ein vertrautes Kürzel reicht nicht. Bestätigen Sie den genauen bereitgestellten Vault-Vertrag über die offizielle Protokolldokumentation oder eine bekannte Transaktion, die Sie auf vertrauenswürdigem Weg aufrufen. Vergleichen Sie danach die Adresse des zugrunde liegenden Assets mit dem beabsichtigten Token, nicht nur den Namen. Ein kopierter Vertrag kann vertraute Methodennamen anbieten, ohne der gemeinte Vault zu sein.

Prüfen Sie die Einheiten beider Seiten. Ein roher Anteilbetrag verwendet die Dezimalstellen des Anteil-Tokens; eine rohe Asset-Ausgabe verwendet die des zugrunde liegenden Tokens. Sie müssen nicht übereinstimmen: Der Vault-Leitfaden von OpenZeppelin beschreibt Implementierungen mit zusätzlicher Anteilpräzision. Unser Leitfaden zu Token-Dezimalstellen erklärt, wie Sie eine noch zu formatierende Ganzzahl erkennen. Skalieren Sie einen bereits formatierten Betrag nicht erneut.

Die Zahl auswählen, die Ihre Frage beantwortet

Verwenden Sie die dokumentierten Lesezugriffe des verifizierten Vertrags, statt mit einem Kurs aus einem anderen Vault zu multiplizieren. Die OpenZeppelin API-Referenz trennt Umrechnung, Vorschau und Limits.

Lesezugriff	Rückgabeeinheit	Beantwortete Frage
balanceOf(account)	Anteile	Wie viele Anteile hält dieses Konto?
convertToAssets(shares)	Zugrunde liegende Assets	Wie hoch ist der allgemeine Gegenwert?
previewRedeem(shares)	Zugrunde liegende Assets	Wie lautet die Rückgabeschätzung für diese Anteile?
maxRedeem(owner)	Anteile	Wie viele Anteile kann dieser Eigentümer derzeit zurückgeben?

convertToAssets beschreibt eine ideale Umrechnung ohne Gebühren und ohne Slippage des tatsächlichen Tauschs. Es ist kein persönliches Abhebungsangebot. previewRedeem berücksichtigt Abhebungsgebühren und aktuelle Bedingungen, ignoriert jedoch bewusst Rückgabelimits. Lesen Sie dafür maxRedeem des Eigentümers. Die Methodendefinitionen des Standards machen diese Unterschiede ausdrücklich.

Eine positive Vorschau ist somit mit einem kleineren Limit oder sogar einem Nulllimit vereinbar. Ein Lesezugriff reserviert auch keine Mittel: Der Zustand kann sich vor einer späteren Transaktion ändern. Beachten Sie die dokumentierten Abhebungsbedingungen des jeweiligen Vaults, einschließlich eines gegebenenfalls erforderlichen Antragsverfahrens. Ein Vault mit asynchroner Erweiterung oder anderer Schnittstelle benötigt eigene Anweisungen.

Eine Position im Vergleich nur einmal erfassen

Betrachten Sie einen hypothetischen Zustand, dessen Zahlen bereits in lesbare Einheiten formatiert sind. Ein Konto hält 100 Anteile. Der Vault meldet für diese Anteilmenge 120 zugrunde liegende Token über convertToAssets und 119 zugrunde liegende Token über previewRedeem. Separat beträgt maxRedeem des Kontos 40 Anteile.

Die 120 Token sind ein allgemeiner Gegenwert. Die 119 Token sind die Vorschau für alle 100 Anteile, kein Beleg dafür, dass alle 100 jetzt zurückgegeben werden können. Das Limit von 40 Anteilen wird in Anteilen gemessen und darf nicht wie 40 zugrunde liegende Token verglichen werden. Holen Sie für die erlaubte Anteilmenge eine eigene Vorschau ein, statt die Vorschau des Gesamtbestands unverändert anzuwenden.

Diese Zahlen sind ein erfundenes Beispiel für Beschriftungen und Geltungsbereiche, kein aktuelles Vault-Angebot, keine Gebührenordnung und keine Berechnung des Kurses eines bestimmten Protokolls. Dafür wurde weder eine Wallet abgefragt noch eine Transaktion ausgeführt.

Addieren Sie 100 Anteile und ihren Gegenwert von 120 Token nicht als getrennte Bestände. Sie beschreiben dieselbe Position. Hält die Wallet außerdem zugrunde liegende Token außerhalb des Vaults, erfassen Sie diesen tatsächlichen Wallet-Bestand separat. Prüfen Sie bei Fiat-Gesamtsummen, welche Darstellung ein Tracker bereits gezählt hat, bevor Sie einen Protokollwert hinzufügen. Der allgemeinere Leitfaden zum Portfolioabgleich hilft, fehlende Mengen von fehlenden Preisen oder nicht unterstützten Positionen zu unterscheiden.

Einen konsistenten Zustand ohne Mittelbewegung dokumentieren

Verwenden Sie einen Explorer oder Vertragsleser, dem Sie bereits vertrauen. Dieses Verfahren beschreibt eine Prüfung anhand von Dokumentation; es wurde für diesen Artikel nicht an einem aktiven Vault getestet. Die Primärquellen wurden am 25. Oktober 2026 geprüft.

1. Identität der Position bestätigen. Notieren Sie Netzwerk, Konto und vollständige Vault-Vertragsadresse. Prüfen Sie, dass die Bereitstellung die zu untersuchende ERC-4626-Schnittstelle verwendet.
2. Asset und Einheiten bestimmen. Notieren Sie asset() sowie die Dezimalskalierung von Anteilen und Asset. Lesen Sie den Anteilbestand des Kontos und trennen Sie rohe Ganzzahlen von formatierten Mengen.
3. Passenden Lesezugriff wählen. Notieren Sie für einen buchhalterischen Vergleich convertToAssets für genau diese Anteilmenge. Für eine Rückgabeschätzung notieren Sie previewRedeem und kennzeichnen das Ergebnis als Vorschau.
4. Eigentümerspezifisches Limit separat prüfen. Lesen Sie maxRedeem(owner) und die Abhebungsbedingungen des Protokolls. Ersetzen Sie ein nicht verfügbares Limit nicht durch den Anteilbestand und behandeln Sie eine positive Vorschau nicht als Erlaubnis zur Rückgabe.
5. Beobachtungen abstimmen und beschriften. Nutzen Sie möglichst denselben Block für Bestand, Umrechnung, Vorschau und Limit. Bietet der Leser nur getrennte Aufrufe des jeweils neuesten Zustands, speichern Sie deren Zeiten und vermerken Sie mögliche Zustandsunterschiede.
6. Eine Position abgleichen. Halten Sie Anteilzahl, Asset-Gegenwert und Rückgabeinformationen zusammen. Markieren Sie einen fehlgeschlagenen Lesezugriff als unbekannt, bewahren Sie den Fehler auf und untersuchen Sie Konto, Vertrag, Netzwerk oder Schnittstelle, bevor Sie einen Nullbetrag annehmen.

Diese öffentlichen Lesezugriffe erfordern weder Signatur noch Tokenfreigabe, Wiederherstellungsphrase oder Übertragung. Fordert eine Website etwas davon allein zum Anzeigen eines Bestands, brechen Sie diesen Ablauf ab. Eine Vertragsantwort kann eine Anzeige erklären; sie bestätigt nicht die Sicherheit des Vertrags.

Eine Umrechnung ist keine Rendite und kein Verkaufspreis

Ein Asset-Gegenwert beantwortet, wie der Vault eine Anteilmenge in seinem zugrunde liegenden Token ausdrückt. Er belegt weder Gewinn gegenüber Ihrer ursprünglichen Einzahlung noch einen Marktverkaufspreis oder eine garantierte zukünftige Rückgabe. Gebühren, Rundung, Änderungen des Vaults und der eigene Preis des zugrunde liegenden Assets gehören in getrennte Aufzeichnungen.

Übertragen Sie dieses Verfahren nicht auf jeden Beleg-Token. Beispielsweise haben stETH und wstETH eine eigene dokumentierte Buchführung und Umrechnungsmethode. Ein ähnlich aussehender Bestand belegt kein ERC-4626-Verhalten.

Die Prüfung ist abgeschlossen, wenn Sie den genauen Vault und das Asset nennen, Anteilmenge und Zustand bestimmen und erklären können, welche Oberfläche Umrechnung, Vorschau oder Limit zeigt. Ist ein wesentlicher Lesezugriff nicht verfügbar, bleibt dieser Teil ungeprüft. Eine Bewegung der Position ist eine separate Entscheidung und zur Erklärung ihres angezeigten Bestands nicht erforderlich.