Eine Transaktion, die das Konto selbst prüft
ERC-4337 ist der Standard, der Ethereum Smart Accounts gibt, ohne die Regeln der Chain zu ändern. Statt einer Transaktion signieren Sie eine UserOperation. Ein Bundler bringt sie zu einem Vertrag namens EntryPoint.
Die meisten neuen Smart Accounts arbeiten so. Wer den Ablauf kennt, kann also jeden davon lesen.
Am Ende dieser Lektion
Notiz
Ich kann eine UserOperation von der Signatur bis zum Ereignis des EntryPoint verfolgen.
Schlüsselwörter
| Begriff | Was er bedeutet |
|---|---|
| UserOperation | ein signierter Auftrag, was ein Smart Account tun soll |
| Bundler | ein Server, der UserOperations an die Chain schickt |
| EntryPoint | der eine Vertrag, der UserOperations prüft und ausführt |
| Validierung | die Phase, in der das Konto ja oder nein sagt |
| Ausführung | die Phase, in der das Konto seinen Aufruf macht |
| Einlage | ETH, das der EntryPoint verwahrt, um Gas zu bezahlen |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Wer bei ERC-4337 was tut
- Die Nutzerin signiert eine UserOperation für ihren Smart Account.
- Ein Bundler sammelt UserOperations und schickt sie in einer gewöhnlichen Transaktion an den EntryPoint, mit dem Aufruf handleOps.
- Der EntryPoint bittet jedes Konto, seine Operation zu validieren.
- Danach führt er jede Operation aus und zahlt den Bundler aus der Einlage des Kontos zurück.
Der Bundler zahlt das Gas der Transaktion zuerst selbst. Darum will er es zurück.
Was in einer UserOperation steht
Eine UserOperation nennt den Absender, also ihren Smart Account. Sie enthält eine Nonce, die auszuführenden callData und drei Gaslimits. Dazu kommen der höchste Preis je Gaseinheit, ein optionaler Paymaster und eine Signatur.
Das Konto signiert einen Hash über alle Felder außer der Signatur. Der Hash deckt auch die Adresse des EntryPoint und die Chain-Id ab. So lässt er sich nirgendwo anders wiederverwenden.
Eine UserOperation über den Bundler senden
docker exec chain ./steps/userop.shHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Beispiel: was das Lab gedruckt hat
| Schritt | Was das Lab gedruckt hat |
|---|---|
| Zähler vorher | 0 |
| Nonce im EntryPoint | 0 |
| Hash, den Alex signiert hat | 0x8806a321... (64 Hex-Ziffern) |
| Transaktion handleOps | verbrauchtes Gas 133003 |
| UserOperationEvent | success true, Gas 114672, Kosten 0.000114672 ETH |
| Zähler nachher | 1 |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Erst Validierung, dann Ausführung
Der EntryPoint validiert jede Operation eines Bündels, bevor er irgendeine ausführt. Die Validierung prüft die Nonce, lässt das Konto die Signatur prüfen und behält die höchstmöglichen Kosten ein.
Scheitert eine Operation an der Validierung, wird das ganze Bündel zurückgerollt. Der Bundler zahlt dann für nichts Nützliches. Darum simuliert ein Bundler das Bündel zuerst und wirft jede Operation hinaus, die scheitern würde.
Sehen, was die Validierung ablehnt
docker exec chain ./steps/refused.shHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Drei Versuche, drei Antworten
| Versuch | Was der Bundler gedruckt hat |
|---|---|
| Von Mallory statt von Alex signiert | simulation failed, not sent: AA24 signature error |
| Von Alex signiert | sent handleOps, success true |
| Dieselbe Operation noch einmal | simulation failed, not sent: AA25 invalid account nonce |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Ein häufiger Fehler
Warnung
Viele glauben, ein Bundler könne ändern, worum die Nutzerin gebeten hat. Das kann er nicht. Die Signatur deckt jedes Feld ab. Jede Änderung lässt die Validierung mit AA24 scheitern, und das Konto handelt nie.
Wie der Bundler sein Geld zurückbekommt
Vor der Ausführung behält der EntryPoint die höchstmöglichen Kosten ein: alle Gaslimits zusammen, mal den höchsten Preis. Nach der Ausführung berechnet er, was wirklich verbraucht wurde. Den Rest lässt er in der Einlage des Kontos.
preVerificationGas bezahlt den Bundler für Arbeit, die der EntryPoint nicht messen kann. Ist es zu niedrig, verliert der Bundler. Im Lab lag er am Ende 0.000018331 ETH im Minus.
Probieren Sie es: die höchstmöglichen Kosten
GWEI = 10 ** 9
call_gas = 100000
verify_gas = 100000
pre_gas = 21000
max_fee = 1 * GWEI
hoechstens = (call_gas + verify_gas + pre_gas) * max_fee
verbraucht = 114672 * GWEI
print("zuerst einbehalten:", hoechstens, "wei")
print("wirklich verbraucht:", verbraucht, "wei")
print("bleibt in der Einlage:", hoechstens - verbraucht, "wei")
# Setzen Sie call_gas auf 50000. Was wird jetzt zuerst einbehalten?
Der EntryPoint des Labs ist ein Lehrmodell
Der echte EntryPoint, Version 0.7 oder 0.8, packt seine Gasfelder, erlaubt mehrere Nonce-Folgen und kann nach der Ausführung einen Paymaster erneut aufrufen. Seine Validierungsregeln, ERC-7562, stoppen eine Operation, die eine Simulation besteht und dann auf der Chain scheitert.
Das Lab behält die Form und lässt das weg. Sein Bundler ist eine Shell-Funktion, die erst simuliert und dann sendet. Lesen Sie seine Fehlercodes.
Die Fehlercodes des EntryPoint auflisten
docker exec chain grep -n "AA[0-9]" src/EntryPoint.solHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.