Du hast den Swap-Vertrag freigegeben, das Altbestand-Guthaben gesendet, und der Explorer hat die Transaktion grün markiert. Das alte Kürzel ist verschwunden, und nichts hat seinen Platz eingenommen. Entweder existieren die neuen Einheiten nicht, oder sie existieren und nichts zeichnet sie. Beide Fälle sehen auf einem Wallet-Bildschirm identisch aus und verlangen völlig verschiedene Reaktionen.
Was ein abgeschlossener Swap wirklich belegt
Eine bestätigte Swap-Transaktion sagt dir, dass dein Aufruf in einen Block gelangt ist und dass der äußerste Teil der Ausführung nicht zurückgerollt wurde. Das ist alles. Ein erfolgreicher Belegstatus ist eine Aussage über den Aufruf, keine Aufstellung dessen, was der Aufruf gutgeschrieben hat.
Ein Migrations-Swap hat zwei Beine, weshalb diese Lücke hier stärker ins Gewicht fällt. Ein Bein zieht deine alten Einheiten ab. Das andere zahlt neue Einheiten aus. Der Beleg deckt die Transaktion als Ganzes ab, und ein Vertrag lässt sich so schreiben, dass das zweite Bein weniger tut als erwartet oder gar nichts, ohne dass sich das erste auflöst.
Die zu beantwortende Frage lautet also nicht, ob der Swap funktioniert hat. Sie lautet, ob nun ein neues Guthaben auf deine Adresse geschrieben ist, und falls ja, warum es nichts zeichnet. Das sind zwei getrennte Untersuchungen, und diese Reihenfolge erspart dir den Streit mit einem Support-Team über ein Guthaben, das du bereits hältst.
Wo das neue Guthaben tatsächlich verzeichnet ist
Der neue Token ist ein gewöhnlicher Vertrag mit eigenem Kontobuch, und der ERC-20-Token-Standard hält deine Position darin zweifach fest: einmal als Ereignis im Moment der Gutschrift und einmal als Wert, den der Vertrag auf Anfrage zurückgibt.
Das Ereignis ist das Transfer-Ereignis, das laut Standard bei Token-Übertragungen ausgelöst werden MUSS, einschließlich Übertragungen mit Wert null. Er ergänzt, dass ein Token-Vertrag, der neue Token erzeugt, ein Transfer-Ereignis mit der Absenderadresse 0x0 auslösen SOLLTE. Eine Migration, die auf deine Adresse prägt, hinterlässt daher eine Übertragung von der Nulladresse an dich, und eine, die aus einer vorfinanzierten Reserve zahlt, hinterlässt eine Übertragung aus dieser Reserve. So oder so gibt es eine Zeile zu suchen.
Der Wert ist balanceOf, das der Standard als Rückgabe des Kontoguthabens eines anderen Kontos mit angegebener Eigentümeradresse beschreibt. Es ist ein Lesevorgang, kostet nichts und antwortet für die Gegenwart, nicht für den Moment des Swaps. Öffne den neuen Vertrag in einem Block-Explorer und rufe balanceOf mit deiner eigenen Adresse auf. Die zurückgegebene Zahl ist die maßgebliche Antwort.
| Was du lesen kannst | Was es klärt |
|---|---|
| Der Belegstatus des Swaps | Nur dass der äußere Aufruf nicht zurückrollte |
| Ein Transfer-Ereignis an deine Adresse | Dass dir damals neue Einheiten gutgeschrieben wurden |
| Der balanceOf-Wert im neuen Vertrag | Was du in diesem Kontobuch jetzt hältst |
| Die Asset-Liste deines Wallets | Nichts über Eigentum |
Warum das Guthaben dir gehören und das Wallet nichts zeigen kann
Die letzte Zeile klärt die Variante, deren Behebung nichts kostet. Ein Wallet durchsucht nicht jeden Vertrag der Kette nach deiner Adresse. Es zeichnet eine Liste von Assets, die es verfolgen soll, und ein letzte Woche ausgerollter Vertrag steht nicht auf dieser Liste, bis ihn etwas dort einträgt.
Das ist eine bekannte Lücke, kein Fehler. EIP-747, der Standard hinter der Methode wallet_watchAsset, beschreibt sie als Weg, einem Client zu erlauben, dem Wallet des Nutzers einen Token zur Verfolgung vorzuschlagen, und hält fest, dass ohne sie jedes Wallet entweder eine Liste zugelassener Assets vorladen muss oder Nutzer Assets manuell hinzufügen müssen. Eine Migration erzeugt genau diesen Fall.
Die Behebung besteht darin, den Vertrag von Hand hinzuzufügen, mit der Adresse aus der eigenen Ankündigung des Projekts und nicht aus einem Suchergebnis oder einer Chat-Nachricht. Sobald das Wallet ihn verfolgt, erscheint das Guthaben sofort, falls es die ganze Zeit da war, denn an deiner Position hat sich nichts geändert. Zeigt es weiterhin null, ist die Anzeigefrage ausgeschlossen und alles Übrige liegt auf der Kette.
Wenn der Swap eine Adresse gutgeschrieben hat, die nicht deine ist
Ein Swap-Vertrag muss entscheiden, wem er zahlt, und diese Adresse ist nicht immer die, an die du gedacht hast. Schreibt der Vertrag dem Aufrufer gut, dann ist das signierende Konto das empfangende Konto, und das ist das falsche, wenn zwei Konten im selben Browserprofil geöffnet sind.
Die schwierigere Variante betrifft einen Vermittler. Alte Einheiten auf einer zentralisierten Plattform liegen unter deren Adresse, und ein von einer Einzahlungsadresse gesendeter Swap zahlt an denjenigen, dem diese Adresse gehört. Dasselbe gilt für ein Smart-Contract-Wallet oder ein Multisig. Lies das Transfer-Ereignis und beachte das Empfängerfeld: Es nennt die gutgeschriebene Adresse, und wenn das keine deiner Adressen ist, wären die Token nie dort aufgetaucht, wo du hinsiehst.
Ein formaler Fall lässt sich zuerst ausschließen. Manche Migrationen geben den neuen Token auf einer anderen Kette aus als den alten, sodass die Gutschrift in einem Netzwerk landet, auf das dein Wallet nicht eingestellt ist. Das Netzwerk zu wechseln klärt das in Sekunden.
Wenn die alten Einheiten weg sind und nichts zurückkam
Fehlt das Transfer-Ereignis und liefert balanceOf null, während das alte Guthaben wirklich verschwunden ist, dann lief das Zahlungsbein nicht, und dafür gibt es wenige Gründe.
Der erste ist eine leere Reserve. Ein Swap, der aus vorfinanzierten Token zahlt statt zu prägen, kann deine Einzahlung annehmen und nicht auszahlen, weil das Konto, aus dem er zahlt, geleert wurde. Genau davor schützt die Frist des Swap-Fensters, und deshalb wiegt das Lesen der Reserve vor dem Senden schwerer als das Lesen der Ankündigung.
Der zweite ist ein kleinerer Betrag als erwartet, nicht ein fehlender. Prüfe das Umrechnungsverhältnis und die Dezimalstellen beider Verträge, bevor du entscheidest, dass nichts ankam. Ein Wallet mit 40.000 alten Einheiten hat bei einer Zusammenlegung von einer neuen Einheit je vier alte Anspruch auf 10.000 neue Einheiten, also 25 % der Zahl, die es gewohnt war. In einem Vertrag mit anderem decimals-Wert kann eine korrekte Gutschrift zudem mit dem Komma an ungewohnter Stelle erscheinen.
Der dritte ist, dass die alten Einheiten irgendwohin gingen, wo kein Zahlungsbein hängt. Token direkt an eine Vertragsadresse zu senden statt über die Oberfläche, die ihn aufruft, löst den Swap nicht aus. Der Standard macht das möglich, weil approve einem Ausgebenden erlaubt, bis zu einem festgelegten Betrag von deinem Konto abzuheben, und transferFrom für einen Abhebe-Ablauf dient, der Verträgen erlaubt, Token in deinem Namen zu übertragen. Ein Swap-Vertrag erwartet, bei dir abzuholen, und nicht, etwas zu bekommen, von dem ihm nie erzählt wurde.
Migrationen, die eine Plattform für dein Konto ausgeführt hat
Ein anderer Weg erzeugt dieselbe Beschwerde aus ganz anderen Gründen. Hieltest du den alten Token während der Migration auf einer zentralisierten Plattform, hat sie ihr eigenes Sammelguthaben umgewandelt und deinen Kontoeintrag umgeschrieben, und das Ganze erschien als Kürzelwechsel ohne eine einzige Transaktion von dir.
Auf diesem Weg gibt es keine Swap-Transaktion zu prüfen, also greift keine der Kettenprüfungen. Es greift der Zeitplan der Plattform: eine Aussetzung von Ein- und Auszahlungen für den alten Token, eine auf Kontoguthaben angewandte Umwandlung und eine Wiederaufnahme unter dem neuen Kürzel. Ein während dieser Aussetzung noch nicht umgewandeltes Guthaben ist pausiert, nicht verloren.
Auch die Eskalation unterscheidet sich. Eine Plattform, die dir nicht gutgeschrieben hat, ist eine Support-Frage mit benanntem Gegenüber. Ein Swap auf der Kette, der nicht gezahlt hat, hat kein Gegenüber in der Schleife, weil der Vertrag ausgeführt hat, was in ihn geschrieben wurde.
Was in welcher Reihenfolge zu prüfen ist
| Reihenfolge | Was zu prüfen ist | Was eine negative Antwort ausschließt |
|---|---|---|
| 1 | Ist dein Wallet im Netzwerk der Ausgabe des neuen Tokens | Ein Anzeigeproblem durch die falsche Kette |
| 2 | Hast du die neue Vertragsadresse von Hand ergänzt | Dass das Wallet einen neuen Vertrag nicht verfolgt |
| 3 | Antwortet balanceOf für deine Adresse | Jede verbleibende Erklärung über die Anzeige |
| 4 | Trägt der Swap ein Transfer-Ereignis an dich | Eine Gutschrift, die es gab und die später wegging |
| 5 | Welche Adresse nennt dieses Ereignis | Eine Zahlung an eine Einzahlungsadresse |
| 6 | Passen Verhältnis und decimals zum Eingang | Eine korrekte Gutschrift, falsch gelesen |
| 7 | Hat eine Plattform die Migration für dich ausgeführt | Eine Kettenprüfung, die nie zutraf |
Arbeite diese Liste von oben nach unten ab, nicht quer. Jede Zeile entfernt eine Klasse von Erklärungen, und die unteren Zeilen ergeben erst Sinn, wenn die oberen geklärt sind. Die ersten drei kosten nichts.
Eine Warnung gehört zur ganzen Übung. Ein Wallet, das ein Guthaben verloren zu haben scheint, ist genau der Zustand, nach dem Betrüger suchen, und jede Prüfung oben ist ein öffentlicher Lesevorgang, den du kostenlos ausführst. Niemand braucht deine Wiederherstellungsphrase, um ein Guthaben zu lesen, und ein Angebot, fehlende migrierte Token dafür zurückzuholen, ist ein zweiter Verlust im Gewand einer Behebung des ersten.
Fazit
Eine grüne Swap-Transaktion belegt, dass ein Aufruf ausgeführt wurde, und nicht mehr. Das neue Guthaben ist im neuen Vertrag verzeichnet, als Transfer-Ereignis im Moment der Gutschrift und als balanceOf-Wert danach, und beides ist lesbar, ohne jemanden zu fragen. Bis du sie gelesen hast, weißt du nicht, ob dies ein Anzeigeproblem oder ein Zahlungsproblem ist.
Ist es ein Anzeigeproblem, ist die Abfolge kurz: auf das richtige Netzwerk wechseln, die Vertragsadresse von Hand ergänzen, und das Guthaben ist schon da. Ist es das nicht, nennt das Transfer-Ereignis die tatsächlich gutgeschriebene Adresse, und dieses Feld trennt eine Zahlung an das falsche Konto von einer Zahlung, die nie stattfand. Kläre, welcher der beiden Fälle vorliegt, bevor du sonst irgendetwas irgendwohin sendest. Um die Grundlagen weiter zu lernen, folge weiteren Beiträgen der Bitbase Academy.
Weiterführende Artikel
Weitere Bitbase-Artikel zu diesem Thema:
- Den Treasury-Runway eines Token-Projekts berechnen
- Was ist ein Krypto-Token? Token vs. Coins erklärt
- Buy Walls, Sell Walls und Orderbuch-Tiefe
Haftungsausschluss: Dieser Artikel ist Bildungsinhalt der Bitbase Academy, nur zu Informationszwecken. Er ist keine Anlage-, Handels-, Steuer- oder Finanzberatung. Krypto-Assets sind volatil — schätze dein Risiko selbst ein. Stand September 2026; maßgeblich sind die aktuellen offiziellen Informationen.
Quellen
[1] Ethereum Improvement Proposals, ERC-20: Token Standard (EIP-20, Status Final) eips.ethereum.org
[2] Ethereum Improvement Proposals, EIP-747: wallet_watchAsset RPC Method (Status Final) eips.ethereum.org
