Lässt es sich mit cremefarbenem Papier, einer Tönung, mehr Kontrast oder größerer Schrift besser lesen? Wählen Sie Ihre Farben und Ihre Schrift, einmalig für alle Seiten.

Kostenlose Lektion

So funktioniert ERC-4337: UserOperations und Bundler

Nach dieser Lektion: Ich kann eine UserOperation von der Signatur bis zum Ereignis des EntryPoint verfolgen.

Lektion, 70 Min.3 BefehleAccount-Abstraction-Lab: Smart Accounts, ERC-4337, Paymaster und EIP-7702 auf einer lokalen Chain

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

BegriffWas er bedeutet
UserOperationein signierter Auftrag, was ein Smart Account tun soll
Bundlerein Server, der UserOperations an die Chain schickt
EntryPointder eine Vertrag, der UserOperations prüft und ausführt
Validierungdie Phase, in der das Konto ja oder nein sagt
Ausführungdie Phase, in der das Konto seinen Aufruf macht
EinlageETH, 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

  1. Die Nutzerin signiert eine UserOperation für ihren Smart Account.
  2. Ein Bundler sammelt UserOperations und schickt sie in einer gewöhnlichen Transaktion an den EntryPoint, mit dem Aufruf handleOps.
  3. Der EntryPoint bittet jedes Konto, seine Operation zu validieren.
  4. 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

Befehl
docker exec chain ./steps/userop.sh

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Beispiel: was das Lab gedruckt hat

SchrittWas das Lab gedruckt hat
Zähler vorher0
Nonce im EntryPoint0
Hash, den Alex signiert hat0x8806a321... (64 Hex-Ziffern)
Transaktion handleOpsverbrauchtes Gas 133003
UserOperationEventsuccess true, Gas 114672, Kosten 0.000114672 ETH
Zähler nachher1

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

Befehl
docker exec chain ./steps/refused.sh

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Drei Versuche, drei Antworten

VersuchWas der Bundler gedruckt hat
Von Mallory statt von Alex signiertsimulation failed, not sent: AA24 signature error
Von Alex signiertsent handleOps, success true
Dieselbe Operation noch einmalsimulation 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

Code: python
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

Befehl
docker exec chain grep -n "AA[0-9]" src/EntryPoint.sol

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Über dieses Lab und seinen Quellcode: Account-Abstraction-Lab: Smart Accounts, ERC-4337, Paymaster und EIP-7702 auf einer lokalen Chain

Sie unterrichten eine Gruppe? Weisen Sie dieses Modul Ihren Studierenden zu, mit Handbuch für Lehrende, automatisch geprüften Aufgaben und einem Lab für jede Person.