> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-de/wallets/built-in-wallet/smart-contract-wallets/decoding-scw-swaps.md).

# Dekodierung von SCW-Swaps

Bei Smart-Contract-Wallets (SCWs) nehmen Swaps einen ganz anderen Weg als bei traditionellen Ethereum/EVM-Wallets. Dieser Unterschied kann verwirrend sein, besonders wenn etwas schiefgeht. Aber sobald du die wichtigsten Beteiligten im Ablauf verstehst — und wie du Schritt für Schritt in der App und im Explorer nachverfolgst, was passiert ist — ergibt alles langsam Sinn.

Gehen wir es gemeinsam durch.

***

#### Von einem Tipp bis zur Ausführung on-chain: was tatsächlich passiert

Wenn du in der App auf „Swap“ tippst, fühlt es sich wie eine einzige Aktion an. In Wirklichkeit startest du einen mehrstufigen Prozess, der auf Ethereums Account Abstraction (ERC-4337) aufbaut. Deine Transaktion geht nicht direkt wie bei einer normalen Wallet an die Blockchain. Stattdessen macht sie einen Umweg:

1. Wir bauen die Route. Wir fragen die Routing-Engine (wie 1inch), den besten Weg für deinen Swap zu finden, und simulieren ihn, um sicherzustellen, dass er funktioniert. Wir schätzen das Gas, prüfen, ob du die Token hast, und verpacken die Anweisungen in ein spezielles Format: eine `UserOperation`.
2. Ein `Bundler` greift ein. Das ist ein Off-Chain-Akteur, der für das Einreichen von UserOperations an die Blockchain verantwortlich ist. Er prüft deine Operation, stellt sicher, dass sie gültig ist, und legt das Gas für dich aus (es wird später erstattet).
3. Deine UserOp gelangt über den `EntryPoint` Smart Contract in die Blockchain. Stell dir das EntryPoint als das eine Tor vor, durch das alle SCW-Transaktionen gehen. Das EntryPoint führt die abschließenden Prüfungen durch, und wenn alles gut aussieht…
4. Das EntryPoint weist deine Smart Contract Wallet (SCW) an, den Swap auszuführen. Deine SCW ruft den Router auf (z. B. 1inch), der Router ruft die Pools auf, Token werden bewegt, und die Ausgabe landet wieder in deiner Wallet.

Kurz zusammengefasst: du tippst auf Swap → wir simulieren → der Bundler sendet → das EntryPoint validiert → deine SCW führt aus.

***

#### Schauen wir uns ein echtes Beispiel an

Jetzt, da wir den groben Ablauf verstanden haben, sehen wir uns an, wie das bei einem echten Swap aussieht: zuerst in der App, dann on-chain:

<figure><img src="https://255243788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN30dLOECKAJpKz7dTr8%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Das sehen wir:

* Wir haben 1 USDC gegen 0,765 KTA getauscht.
* Der Swap wurde auf Base ausgeführt (achte auf das Base-Symbol bei den Coin-Symbolen).
* Wir haben bezahlt:
  * 0,03 $ Gas (in ETH)
  * 0,22 % Swap-Gebühr an goodcryptoX
  * 0,05 % Router-Gebühr an 1inch
* Die Route war einfach: 100 % über einen Uniswap-v4-Pool.
* Bundler: Alchemy (siehe Schritt 2 oben zur Zusammenfassung)
* Explorer-Links erscheinen, wenn die Transaktion die Blockchain erreicht und im Block aufgezeichnet wurde (auch wenn sie fehlschlägt)

Bisher, so gut. Als Nächstes klicken wir auf den BaseScan-Link, um zu sehen, wie diese Transaktion on-chain aussieht:

{% hint style="info" %}
Hinweis zu Explorer-Links: In den neuesten App-Versionen öffnen Explorer-Links bereits Ihre AA-Transaktion (UserOp). Wenn Sie das sehen (das Feld „From“ zeigt Ihre Wallet-Adresse an), können Sie direkt zu [Schritt 5 – Seite mit den Details der AA-Transaktion](#step-5-open-the-aa-transaction-details-page). Die vorherigen Schritte gelten nur, wenn Ihr Link auf die äußere Bundler-Transaktion verweist (bei der „From“ NICHT Ihre Wallet ist). Es ist dennoch eine nützliche Lektüre, um besser zu verstehen, wie SCW-Transaktionen funktionieren
{% endhint %}

<figure><img src="https://255243788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN30dLOECKAJpKz7dTr8%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

**Von:** Das ist nicht deine Wallet — es ist der Bundler von Alchemy. Das ist zu erwarten, da der Bundler die Transaktion eingereicht hat.

**An:** EntryPoint (v0.6.0). Auch das ist zu erwarten — alle SCW-Transaktionen laufen hier durch.

**Interne Transaktionen:** zeigt den Fluss nativer Token (ETH auf Base) innerhalb der Transaktion. Hier ist, was wir sehen:

* Unsere Wallet (…0A5) hat ETH an das EntryPoint für die Gasgebühr gesendet.
* Das EntryPoint hat den Bundler mit den tatsächlichen Gaskosten erstattet (da der Bundler das Gas in deinem Namen vorfinanziert hat; siehe Schritt 2 oben). Übrig gebliebenes ETH blieb im EntryPoint als deine Einlage für zukünftige Transaktionen.

**ERC-20-Transfers:** zeigt die tatsächlichen Token-Bewegungen:

Unsere Wallet hat USDC nicht direkt gesendet. Stattdessen hat der USDC-Token-Vertrag (…2A8) die Transfers verarbeitet und ausgeführt. Das ist normal: Auf EVM-Chains werden Token-Transfers vom Token-Vertrag selbst ausgeführt, nachdem er eine Anweisung von deiner Smart-Contract-Wallet erhalten hat.

1. Der USDC-Vertrag hat unsere 1 USDC in drei Transfers aufgeteilt:
   * 0,0022 USDC an die Gebühren-Wallet unseres Protokolls (…608A)
   * 0,0005 USDC an die Gebühren-Wallet von 1inch (…1DE5)
   * Die verbleibenden 0,9973 USDC an den Uniswap-v4-Router (…Universal Router)
2. Der Uniswap-v4-Router leitete sie an den Uniswap-v4-Pool Manager weiter (ein einzelner Vertrag, der alle v4-Pools verwaltet).
3. Der Pool Manager führte den Swap aus: USDC rein → KTA raus.
4. Das KTA wurde über den Aggregation Router von 1inch zurückgeleitet, der es an unsere Wallet (…0A5) weiterleitete.

***

### 🧩 So entschlüsselst du eine fehlgeschlagene SCW-Transaktion

Jetzt, da wir verstanden haben, wie Swaps mit Smart-Contract-Wallets (SCWs) funktionieren — und wir einen erfolgreichen Trade durchgegangen sind — nutzen wir dieselben Werkzeuge, um einen fehlgeschlagenen zu entschlüsseln.

Wir verwenden einen weiteren echten Fall: einen ETH-→-Token-Swap auf Ethereum, der im EntryPoint-Contract fehlschlug, weil nicht genug ETH vorhanden war, um sowohl den Swap als auch die Gasgebühr zu decken.

Okay, du siehst also im App-Status deines Swaps „Error“ oder erhältst eine Push-Benachrichtigung, dass dein Swap fehlgeschlagen ist. Was machst du?

***

#### Schritt 1 — Die Order-Details in goodcryptoX prüfen

Hier ist, was du in diesem Fall siehst:

<figure><img src="https://255243788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN30dLOECKAJpKz7dTr8%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Mit dem Framework, das wir zuvor entwickelt haben, fällt dir schnell auf:

* Der Swap-Status ist `Error` *(fehlgeschlagen?)*
* Es wird keine Fehlermeldung angezeigt *(das ist ungewöhnlich)*
* Es gibt eine Gasgebühr *(Blockchain erreicht?)*
* Es wird eine Route angezeigt *(Simulation war ok?)*
* Es gibt Links zu Blockchain-Explorern *(Ich kann die Tx on-chain prüfen!).*

Lass uns deine Intuition prüfen:

* Der `Error` Der Status bedeutet, dass der Swap fehlgeschlagen ist
* Es sollte sowohl eine menschenlesbare Fehlermeldung (übersetzt aus dem Rohtext) als auch die rohe Meldung geben. Wenn die Fehlermeldung fehlt, ist das definitiv ungewöhnlich
* Die Gasgebühr bedeutet tatsächlich, dass die Transaktion die Blockchain erreicht hat und on-chain Aktivität stattgefunden hat (die Gas verbraucht hat)
* Die Route bestätigt, dass die Transaktionssimulation bestanden hat und einen klaren Pfad zur Ausführung ergeben hat
* Explorer-Links bestätigen, dass die Transaktion die Blockchain erreicht hat — auch wenn sie fehlgeschlagen ist. Wir sollten auf jeden Fall einen davon öffnen und genauer nachsehen

***

**Schritt 2 – Öffne die Transaktion im Blockchain-Explorer**

{% hint style="info" %}
Hinweis zu Explorer-Links: In den neuesten App-Versionen öffnen Explorer-Links bereits Ihre AA-Transaktion (UserOp). Wenn Sie das sehen (das Feld „From“ zeigt Ihre Wallet-Adresse an), können Sie direkt zu [Schritt 5 – Seite mit den Details der AA-Transaktion](#step-5-open-the-aa-transaction-details-page). Die vorherigen Schritte gelten nur, wenn Ihr Link auf die äußere Bundler-Transaktion verweist (bei der „From“ NICHT Ihre Wallet ist). Es ist dennoch eine nützliche Lektüre, um besser zu verstehen, wie SCW-Transaktionen funktionieren
{% endhint %}

Du tippst auf den Etherscan-Link, um zu sehen, was passiert ist:

<figure><img src="https://255243788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN30dLOECKAJpKz7dTr8%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Auf den ersten Blick wird alles noch verwirrender:

* Der Status sagt ✅ Success *— Moment, was?!*
* Aber wir wissen bereits, dass der Swap **nicht durchgegangen ist**
* Unter dem Feld „To“ (EntryPoint) steht eine kleine gelbe Meldung:

  > *„<mark style="color:$warning;">Obwohl ein oder mehrere Fehler aufgetreten sind \[execution reverted] Contract Execution Completed</mark>“*

Was ist hier also eigentlich los?

Erinnerst du dich an den SCW-Transaktionsfluss, den wir zuvor behandelt haben:

* der Bundler packt deinen Swap in eine `UserOperation` (ein Datenpaket mit deiner Swap-Logik)
* und sendet es dann an den EntryPoint-Smart-Contract
* das EntryPoint validiert ihn (prüft deinen Kontostand, die Signatur und die Nonce)
* wenn alles passt, führt es deine Absicht aus — es ruft Router und Pools auf und bewegt Token.

Aus Sicht der Blockchain sieht das Ganze jedoch einfach nur wie „Bundler sendet Daten an EntryPoint“ aus.

In SCW-Begriffen nennt man diesen Schritt die `äußere` Transaktion.

Und diese Transaktion war erfolgreich: Die Daten wurden übermittelt, und das EntryPoint begann mit seiner internen Logik. Daher das ✅ Success oben.

***

Aber der Explorer lässt dich höflich trotzdem wissen, dass etwas fehlgeschlagen ist *innerhalb* des EntryPoint mit dieser kleinen gelben Notiz. Für den Explorer reicht dieser interne Fehler nicht aus, um die Transaktion als fehlgeschlagen zu markieren.

Jetzt fällt auf der Overview-Registerkarte noch ein weiteres Detail auf:

* Etwa **$6** ETH wurden von deiner Wallet an das EntryPoint gesendet (das Gas-Prefund).
* Nur **$2.3** ETH wurden an den Bundler erstattet.
* Und die oben angezeigte Transaktionsgebühr ist sogar noch niedriger — etwa **$2.15**.

Auf den ersten Blick scheinen diese Zahlen nicht zusammenzupassen. Lass uns das erst einmal aufdröseln, bevor wir mit der Untersuchung fortfahren

***

**Schritt 3 – Die Gas-Diskrepanz verstehen**

Hier ist die Aufschlüsselung:

* **SCW → EntryPoint** (\~6 $): Das ist das Gas-Prefund. Das EntryPoint zieht immer mehr ein als nötig, um sicherzustellen, dass deine UserOp ausgeführt werden kann.
* **EntryPoint → Bundler** (\~2,3 $): Das ist die tatsächliche Gas-Erstattung. Das ist der **echte Betrag, den du bezahlt hast** für diesen fehlgeschlagenen Versuch.
* **Transaktionsgebühr** (\~2,15 $): Das ist das, was der Bundler ausgegeben hat, um deine UserOp an das EntryPoint zu senden. Sie ist niedriger, weil das EntryPoint selbst zusätzliches Gas für die Validierung und Erstattung an den Bundler verbraucht hat — diese zusätzlichen Kosten wurden dir berechnet.

Faustregel:

> 👉 Deine tatsächlichen Gaskosten sind immer die Erstattung EntryPoint ➜ Bundler (nicht die oben angezeigte „Transaktionsgebühr“)

Und die Differenz zwischen deinem Vorfinanzierungsbetrag (6 $) und dem erstatteten Betrag (2,3 $) ist nicht verschwunden. Sie blieb im EntryPoint als deine Einlage und wird automatisch auf deine nächste Transaktion angerechnet.

***

**Schritt 4 – Den Tab „AA Transactions“ prüfen**

Im Explorer siehst du einen **AA Transactions** Tab (AA = Account Abstraction). Dort lebt die Aktivität der Smart-Contract-Wallets, da SCWs auf Account Abstraction (ERC-4337) laufen.

Wechseln wir von Overview zu diesem Tab:

<figure><img src="https://255243788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN30dLOECKAJpKz7dTr8%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Hier siehst du endlich unsere UserOperation als separaten Eintrag innerhalb der äußeren Transaktion des Bundlers:

* Das Feld „From“ zeigt jetzt *unsere Wallet-Adresse*, was bestätigt, dass dies unsere Operation ist.
* Es gibt einen separaten AA Txn Hash, der sich vom äußeren Transaktions-Hash unterscheidet. Warum?
  * Der äußere Txn Hash gehört zur Bundler->EntryPoint-Transaktion, die deine UserOp enthielt (und möglicherweise mehrere UserOps verschiedener Nutzer enthalten konnte).
  * Der AA Txn Hash ist die eindeutige Kennung für *deine* UserOperation innerhalb dieses Bundles.

Das ist die zentrale Idee des Bundleings:

* Ein Bundler kann viele UserOps in einer einzigen Transaktion bündeln.
* Jede UserOp erhält ihren eigenen AA Txn Hash, damit sie innerhalb des Bundles separat verfolgt werden kann.
* In unserem Fall, da es sich um eine ältere Transaktion handelt (vor 400+ Tagen), waren SCWs noch selten und das Bundle enthielt nur unsere UserOp — deshalb zeigt der Tab „AA Transactions (1).“ Bei neueren Transaktionen sieht man oft mehrere UserOps, die zusammen in einem Bundle gebündelt sind.

In dieser Ansicht fällt dir außerdem ein (!) Symbol neben deinem AA Txn Hash auf — ein Hinweis darauf, dass dein Swap nicht ausgeführt wurde.

Der nächste Schritt ist, auf den AA Txn Hash zu klicken. Dadurch öffnet sich die spezielle Seite für die UserOperation, auf der du die vollständigen Details unseres Swap-Versuchs siehst — Gebühr, Transfers und wo er fehlgeschlagen ist.

***

#### Schritt 5 – Die Detailseite der AA-Transaktion öffnen

Wenn du auf den AA Txn Hash klickst, gelangst du zur speziellen Detailseite für deine UserOperation:

<figure><img src="https://255243788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN30dLOECKAJpKz7dTr8%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Hier kannst du unseren eigentlichen Swap-Versuch endlich klar nachvollziehen:

* Status: x Fehlgeschlagen (diesmal keine Unklarheit)
* Von: die Adresse deiner Smart-Contract-Wallet
* AA Transaction Fee: \~0,00231 ETH (2,31 $). Das sind die tatsächlichen Gaskosten, die du bezahlt hast — die an den Bundler gesendete Erstattung.
* Interne Transaktion: eine Überweisung von \~0,00145 ETH (6,36 $) von deiner SCW an das EntryPoint (Gas-Prefund). Es gab keine weiteren Transfers, was bestätigt, dass der Swap selbst nie ausgeführt wurde.
* Bundle Txn Hash: ebenfalls angezeigt, mit Verweis zurück auf die äußere Bundler-Transaktion.

Diese Seite bestätigt endlich deine Intuition: Das ist die echte Transaktion — die UserOperation, die deinen Swap-Versuch repräsentierte.

Damit ist unsere Untersuchung fast abgeschlossen. Aber da wir schon so weit gekommen sind, schauen wir uns auch noch **Interne Txns**.

***

#### Schritt 6 – Die Registerkarte „Internal Transactions“ prüfen

Wechsle in der AA-Transaktionsansicht zur Registerkarte „Internal Txns“:

<figure><img src="https://255243788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN30dLOECKAJpKz7dTr8%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Hier siehst du die Schritt-für-Schritt-Aktionen, die das EntryPoint in deinem Namen ausführen wollte:

1. ✅ Transfer von deiner SCW → EntryPoint (\~0,00145 ETH, \~6,36 $) = Gas-Prefund. Das war erfolgreich.
2. ❌ Ausführung von deiner SCW → Uniswap Universal Router (\~0,002 ETH) = versuchter Swap. Dies ist fehlgeschlagen.

Diese Aufschlüsselung erklärt den Fehler:

* Du hast erfolgreich ETH als Gas-Prefund an das EntryPoint gesendet.
* Aber als das EntryPoint versuchte, ETH für den Swap an Uniswap weiterzuleiten, schlug der Versuch fehl.

Für die detaillierteste Aufschlüsselung öffne die Registerkarte „Logs“.

***

#### Schritt 7 – Die Logs-Registerkarte prüfen

Klicke auf Logs (3):

<figure><img src="https://255243788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN30dLOECKAJpKz7dTr8%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Hier findest du drei wichtige Ereignisse:

* **Deposited** → bestätigt, dass dein Gas-Prefund vom EntryPoint empfangen wurde.
* **BeforeExecution** → zeigt, dass das EntryPoint begann, deine UserOperation zu verarbeiten.
* **UserOperationEvent** → `success: False` — der maßgebliche on-chain Nachweis, dass deine UserOp fehlgeschlagen ist.

***

**Was tatsächlich passiert ist (alles zusammengenommen)**

Diese Art von Fehler ist spezifisch für Swaps mit SCWs auf EVMs, bei denen der Input der native Token ist (ETH, BNB, MATIC…).

* Die Lücke: Weder der Bundler noch das EntryPoint prüfen, ob du genug **native Token** hast, um sowohl das Gas-Prefund als auch den Swap zusammen zu decken. Sie prüfen diese Dinge nur getrennt — „genug für Gas?“ und „genug für den Swap?“. Deshalb ist die Simulation durchgelaufen.
* Wir haben für solche Fälle im App eine Sicherheitsvorkehrung eingebaut und dich in der Oberfläche gewarnt, dass das Gas möglicherweise nicht ausreicht. Aber da die Simulation gut aussah, konntest du trotzdem fortfahren.
* Sobald du bestätigt hast, hat der Bundler deine UserOperation an das EntryPoint gesendet.
* Das EntryPoint zog etwa 6 $ in ETH als Prefund ein.
* Als es versuchte, den Swap auszuführen, war nicht genug ETH übrig, um gleichzeitig sowohl den Swap *und* als auch das Prefund zu decken.
* Der Swap-Aufruf wurde innerhalb des EntryPoint zurückgewiesen.
* Du hast trotzdem etwa 2,3 $ an Gas bezahlt (die Erstattung an den Bundler).
* Die ungenutzten etwa 3,7 $ blieben im EntryPoint als deine Einlage und werden bei deiner nächsten Transaktion automatisch verwendet.
