ERC-20-Gesamtangebot und Wallet-Guthaben: Welche Zahl gehört Ihnen?

Bei einem ERC-20-Token meldet balanceOf(account) das für ein Konto erfasste Guthaben. totalSupply() meldet das Gesamtangebot des Token-Vertrags. Ein großes Angebot auf einer Token-Seite bedeutet keinen großen Bestand auf Ihrem Konto.

Wenn Sie einen Explorer geöffnet haben, um Ihren Bestand zu prüfen, wählen Sie das Kontoguthaben. Um zu prüfen, wie viele Einheiten der Vertrag insgesamt meldet, wählen Sie das Angebot. Keine der beiden Zahlen nennt allein einen Dollarwert, beweist die Kontrolle über eine Adresse oder bestätigt, dass ein Token sicher ist.

Ein Vertrag, zwei verschiedene Fragen

Die ERC-20-Spezifikation definiert diese als getrennte reine Lesemethoden. totalSupply() erhält kein Konto als Eingabe. balanceOf benötigt die Adresse, deren Guthaben Sie prüfen möchten. Der aufgerufene Token-Vertrag bestimmt, nach welchem Vermögenswert Sie fragen.

Abfrage	Eingabe zusätzlich zum Token-Vertrag	Beantwortete Frage
totalSupply()	Keine	Welches Angebot meldet dieser Vertrag?
balanceOf(account)	Öffentliche Kontoadresse	Welches Guthaben erfasst er für dieses Konto?

Stellen Sie sich etwa einen Token mit einem Angebot von 1000 Einheiten vor, von denen Konto A 25 hält. Die korrekten Ergebnisse sind 1000 für das Angebot und 25 für Konto A. Der Unterschied ist zu erwarten. Es gibt keinen fehlenden Bestand von 975 Einheiten, der wiederhergestellt werden müsste.

Diese Mengen sind zur Erklärung erfunden und stammen nicht von einem realen Token. Falls Sie nicht sicher sind, welche Adresse das Konto und welche den Vermögenswert bezeichnet, nutzen Sie vor dem Lesen eines der Felder den Leitfaden zu Wallet-Adresse und Token-Vertrag.

Was verändert Guthaben und was verändert Angebot?

Betrachten Sie einen einfachen hypothetischen Token mit gewöhnlichen Transfers ohne Gebühren oder besondere Buchungsregeln. Zu Beginn liegen 25 Token auf Konto A und 975 auf Konto B:

Ereignis	Konto A	Konto B	Gesamtangebot
Ausgangszustand	25	975	1000
A überträgt 5 an B	20	980	1000
100 neue Token werden für B erzeugt	20	1080	1100
B vernichtet 10 über eine Burn-Funktion	20	1070	1090

Ein Transfer verändert, wer die Einheiten hält. Minting erzeugt Einheiten, und das Vernichten über den gezeigten Mechanismus entfernt Einheiten. Die ERC20-Referenz von OpenZeppelin dokumentiert die Buchung bei Mint und Burn, einschließlich der Angebotsverringerung bei einem Burn.

Die Tabelle beschreibt dieses einfache Modell. Ein Token kann Transfers anpassen oder andere Buchungsregeln verwenden. Betrachten Sie das Senden an eine als „tot“ bezeichnete Adresse nicht als Beweis dafür, dass totalSupply() gesunken ist: Stellen Sie fest, ob der Vertrag das Angebot tatsächlich reduziert. Eine Adressbezeichnung führt keine Burn-Funktion aus.

Ebenso kann Ihr Guthaben gleich bleiben, während sich das Angebot anderswo verändert. Der Angebotsleitfaden von OpenZeppelin erklärt, dass ERC-20 den Angebotsmechanismus den Implementierungen überlässt. Ein aktueller Angebotswert beweist nicht, dass künftiges Minting unmöglich ist.

Beide Werte lesen, ohne Token zu bewegen

Lesen Sie beide Werte aus demselben Token-Vertrag im selben Netzwerk. Das folgende Vorgehen ist eine vorgeschlagene Prüfung, kein Bericht über einen für diesen Artikel durchgeführten Wallet-Test. Die Primärdokumentation wurde am 23. Oktober 2026 geprüft.

1. Notieren Sie Netzwerk und vollständige Adresse des Token-Vertrags. Prüfen Sie die Vertragsadresse anhand der offiziellen Angaben des Herausgebers zur Bereitstellung. Gleiche Kürzel in verschiedenen Netzwerken reichen für einen Vergleich desselben Vermögenswerts nicht aus.
2. Notieren Sie das öffentliche Konto, das Sie prüfen möchten. Übernehmen Sie es aus den Kontodetails. Halten Sie es vom Token-Vertrag getrennt. Öffentliches Tracking funktioniert auch für Konten, die Sie nicht kontrollieren. Eine erfolgreiche Abfrage beweist daher kein Eigentum.
3. Öffnen Sie einen vertrauenswürdigen Explorer oder Vertragsleser für das Netzwerk. Wählen Sie dessen Leseoberfläche für den verifizierten Token-Vertrag. Lesen Sie totalSupply() und danach balanceOf mit der Kontoadresse als Eingabe. Oberflächen verwenden unterschiedliche Bezeichnungen; erkennen Sie die jeweilige Frage am Funktionsnamen.
4. Speichern Sie den Zustand zusammen mit den Ergebnissen. Notieren Sie, sofern verfügbar, die Blocknummer. Bevorzugen Sie beide Aufrufe am selben Block. Getrennte „latest“-Abfragen können unterschiedliche Zustände beobachten, wenn dazwischen ein Transfer, Mint oder Burn stattfindet.
5. Notieren Sie die Einheiten vor dem Vergleich. Bewahren Sie Rohantworten auf und vermerken Sie, ob die Oberfläche sie bereits formatiert hat. Ein fehlgeschlagener Aufruf bedeutet nicht verfügbare Daten, kein Guthaben von null.

Die Ethereum-Dokumentation zu ERC-20 zeigt getrennte Aufrufe für Angebot und Kontoguthaben. Sie müssen die dortige Entwicklerumgebung nicht nachbauen, um zu verstehen, welches Ergebnis Sie benötigen. Ein Explorer mit öffentlichen Lesemethoden kann dieselben Informationskategorien liefern.

Das Lesen öffentlicher Zustände erfordert weder Transfer noch Token-Freigabe. Verlangt eine Seite eine Wiederherstellungsphrase oder Signatur, um diese Werte anzuzeigen, brechen Sie diesen Ablauf ab. Beides ist keine Eingabe für diesen Vergleich.

Für beide Zahlen dieselben Einheiten verwenden

Angebot und Kontoguthaben verwenden dieselbe Buchungsskala des Tokens. Die Erklärung von OpenZeppelin zu Dezimalstellen behandelt ausdrücklich die Formatierung beider Werte. Bei einem hypothetischen Token mit 6 bestätigten Dezimalstellen entspricht das Rohangebot 1000000000 genau 1000 Token und das Rohguthaben 25000000 genau 25 Token.

Vergleichen Sie kein Rohangebot mit einem formatierten Guthaben. Teilen Sie keinen Wert, den eine Oberfläche bereits umgerechnet hat. Der Leitfaden zu ERC-20-Dezimalstellen behandelt das Ermitteln dieser Skala, fehlende Metadaten und Rundungen. Hier ist die Skalierung lediglich Voraussetzung für den Vergleich zweier verschiedener Größen; sie macht diese nicht gleich.

Was eine Angebotszahl nicht klären kann

totalSupply() von ERC-20 ist keine standardisierte Berechnung des umlaufenden Angebots. Ein Anbieter kann bei der Schätzung des Umlaufs bestimmte Bestände ausschließen. Seine Methodik muss diese Ausschlüsse erklären; sie entstehen nicht durch das Umbenennen einer Vertragsantwort. Das maximale Angebot ist eine weitere eigenständige Frage. OpenZeppelin dokumentiert eine Erweiterung zur Angebotsbegrenzung, doch ERC-20 selbst verlangt diese Funktion nicht für jeden Token.

Das Ergebnis gehört außerdem zu der konkreten Bereitstellung und dem gelesenen Zustand. Es fasst Token über verschiedene Chains, Wrapper oder verbundene Verträge hinweg nicht automatisch zusammen. Das Addieren ähnlich benannter Bereitstellungen kann eine Zahl ohne klare Bedeutung ergeben, sofern ihre Beziehung und Buchführung nicht gesondert geklärt sind.

Halten Sie für eine Portfolioprüfung einen kurzen abschließenden Datensatz fest: Netzwerk, Token-Vertrag, Konto, Block, Guthaben und Einheiten. Ergänzen Sie das Angebot nur, wenn es eine eigene Frage beantwortet. Beträgt das Kontoguthaben 25 Token und das Vertragsangebot 1000, bewahren Sie beide Bezeichnungen bei den Zahlen auf. Die Differenz bedeutet nicht, dass Token auf dem Konto fehlen.