ERC-4337-Architektur: EntryPoint, Bundler und Paymaster einfach erklärt

Die Account-Abstraktion auf Ethereum hat zwei kanonische Adressen, die Sie sich merken sollten. EntryPoint v0.6 befindet sich unter 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789. EntryPoint v0.7, Anfang 2024 bereitgestellt, befindet sich unter 0x0000000071727De22E5E9d8BAf0edAc6f37da032. Jede ERC-4337-Transaktion im Mainnet, auf Arbitrum, Optimism, Base, Polygon und den meisten anderen EVM-Blockchains läuft über einen dieser beiden Singleton-Verträge. Wenn Sie verstehen, was diese Verträge tun und welche fünf weiteren Rollen es rund um sie gibt, verstehen Sie ERC-4337.

Dies ist Teil 2 unserer Reihe zu Smart Accounts. In Teil 1 ging es darum, warum EOAs keine gute Standardlösung sind. Hier sehen wir uns die Abläufe im Detail an: die sechs Rollen, die UserOperation-Struktur, was tatsächlich passiert, wenn Sie mit einem Smart Account einen Token tauschen, die Änderungen von v0.6 zu v0.7, Paymaster, öffentliche alternative Mempools und private Bundler sowie die zu erwartenden Zusatzkosten.

Die sechs Rollen in einer Übersicht

ERC-4337 teilt die Aufgaben, die ein EOA in einem Schritt erledigt, auf sechs zusammenarbeitende Akteure auf. Dafür war kein Ethereum-Hard-Fork nötig – das gesamte System besteht aus Verträgen und Off-Chain-Infrastruktur.

• Sender (der Smart Account): Eine Vertrags-Wallet, die Ihre Assets hält und validateUserOp implementiert. Aus Sicht jeder DApp, mit der sie interagiert, ist sie der msg.sender. Beispiele: Safe, Kernel, Biconomy Nexus, Coinbase Smart Wallet und Light Account von Alchemy.
• UserOperation: Eine Pseudo-Transaktionsstruktur (keine echte Ethereum-Transaktion), die beschreibt, was der Sender tun möchte. Nutzer signieren UserOps, keine Transaktionen.
• Bundler: Ein Off-Chain-Knoten, der UserOps aus einem Mempool sammelt, simuliert, in einen einzelnen Aufruf von handleOps packt und das L1-Gas bezahlt. Bundler verdienen an der Differenz zwischen der Erstattung durch den Sender (oder Paymaster) und dem Betrag, den sie an den Validator zahlen.
• EntryPoint: Der vertrauenswürdige Singleton-Vertrag, der das Bundle durchläuft, validateUserOp jedes Senders aufruft, die Aufrufdaten ausführt und Erstattungen sowie Rücksetzungen abwickelt. Pro Version und Blockchain gibt es genau einen EntryPoint.
• Paymaster (optional): Ein Vertrag, der sich bereit erklärt, das Gas für einen Sender zu bezahlen – entweder gesponsert (für den Nutzer kostenlos) oder gegen einen ERC-20-Token wie USDC.
• Aggregator (optional): Ein Vertrag, der viele UserOps mit einer einzigen Signaturprüfung validiert – nützlich für BLS-Verfahren oder ZK-Beweise. Heute nur selten in produktiven Anwendungen eingesetzt.

Behalten Sie diese Rollen im Hinterkopf. Im Rest des Artikels geht es darum, wie diese sechs miteinander interagieren.

Die UserOperation-Struktur

Eine UserOperation ist ein für JSON-RPC geeignetes Bündel von Feldern. Sobald sie signiert ist, drückt sie eine Absicht aus, ohne sie bereits auf L1 festzuschreiben. Das Layout von v0.7 umfasst 11 logische Felder:

• sender – die Adresse des Smart Accounts.
• nonce – ein 256-Bit-Wert, bei dem die oberen 192 Bit einen Schlüssel (einen parallelen Nonce-Kanal) und die unteren 64 Bit eine Sequenz darstellen. So unterstützt ERC-4337 parallele Nonces. Bei EOAs wird dagegen alles sequenziell abgewickelt.
• factory und factoryData – für die erstmalige Bereitstellung über CREATE2; nach der Bereitstellung null.
• callData – der Aufruf, den der Smart Account nach erfolgreicher Validierung ausführen soll.
• callGasLimit, verificationGasLimit, preVerificationGas – drei separate Gasbudgets.
• maxFeePerGas, maxPriorityFeePerGas – dieselbe EIP-1559-Semantik wie bei einer regulären Transaktion.
• paymasterAndData (v0.6), aufgeteilt in paymaster, paymasterVerificationGasLimit, paymasterPostOpGasLimit, paymasterData (v0.7).
• signature – undurchsichtige Bytes, die der Smart Account gemäß seiner eigenen validateUserOp interpretiert.

Das Wallet bestimmt das Signaturverfahren. ECDSA über secp256k1 ist verbreitet, aber auch die P-256- und Passkey-Verifizierung, Multisignatur, Schwellenwerte für die soziale Wiederherstellung und Signierer mit Sitzungsschlüsseln lassen sich über dieselbe Schnittstelle abbilden. Genau darum geht es bei dieser Flexibilität.

Von Anfang bis Ende: Was passiert, wenn ein Smart Account USDC gegen ETH tauscht?

Verfolgen Sie einen tatsächlichen Swap, um zu sehen, wie die Rollen der Reihe nach zum Einsatz kommen.

1. Der Nutzer tippt in der Wallet-Oberfläche auf „Swap“. Die Wallet erstellt eine UserOperation: sender = 0xUserSafe, callData = swapUSDCforETH(amount) mit Uniswap als Ziel.
2. Gas-Schätzung. Die Wallet ruft eth_estimateUserOperationGas über die RPC-Schnittstelle eines Bundlers auf. Der Bundler simuliert die Operation mit dem EntryPoint und gibt die drei Gaslimits zurück.
3. Der Nutzer signiert. Die Wallet bildet den Hash der UserOp mit der EntryPoint-Adresse und der Chain-ID, fordert den Nutzer zur Signatur auf (Passkey, Hardware-Schlüssel oder Ähnliches) und fügt die Signatur an.
4. Übermittlung. Die signierte UserOp wird über eth_sendUserOperation an einen oder mehrere Bundler gesendet. Sie gelangt in den alternativen Mempool – ein separates P2P-Netzwerk, getrennt vom regulären Transaktions-Mempool von Ethereum.
5. Simulation durch den Bundler. Der Bundler simuliert die Operation erneut mit eth_call gegen simulateValidation. Dabei prüft er die Speicherzugriffsregeln aus ERC-7562: Während der Validierung darf eine UserOp nur auf den eigenen Speicher zugreifen. Andernfalls riskiert der Bundler gezielte Störungen.
6. Bündelung. Der Bundler packt diese UserOp zusammen mit bis zu etwa 10 weiteren in einen Aufruf von handleOps([...userOps], beneficiary) an den EntryPoint.
7. On-Chain-Ausführung. Der EntryPoint durchläuft die Operationen: Für jede ruft er validateUserOp beim Sender auf, zieht die Vorauszahlung ab und führt anschließend callData aus. Der Uniswap-Swap wird vom Smart Account aus ausgeführt.
8. Erstattung. Der EntryPoint erstattet nicht verbrauchtes Gas dem Sender (oder Paymaster) und zahlt an die Begünstigtenadresse des Bundlers.

Schlägt Schritt 5 fehl, verwirft der Bundler die Operation und der Nutzer erhält einen AAxx-Fehlercode. Am häufigsten sind AA21 (Vorauszahlung nicht geleistet), AA23 (Signaturfehler), AA25 (ungültiger Nonce), AA33 (Paymaster hat die Ausführung zurückgesetzt) und AA40 (Verifizierungslimit für Gas überschritten). Merken Sie sich diese Tabelle – diese Fehler werden Ihnen begegnen.

EntryPoint v0.6 und v0.7 im Vergleich

v0.6 wurde im März 2023 unter 0x5FF1…2789 veröffentlicht. Die Version funktionierte, hatte aber drei hartnäckige Probleme: ein einzelnes paymasterAndData-Datenfeld, das drei Gasdimensionen zusammenfasste, eine umständliche initCode-Packung und eine Gasabrechnung, bei der Sendern zu viel berechnet wurde. v0.7 behob alle drei Probleme.

Die wichtigsten Änderungen in v0.7:

• Adresse: 0x0000000071727De22E5E9d8BAf0edAc6f37da032 (beachten Sie die führenden Nullen: Es handelt sich um eine durch Vanity-Mining ausgewählte Adresse, durch die das Gas für Aufrufdaten günstiger ist, da jedes Null-Byte 4 Gas kostet, gegenüber 16 für ein Byte ungleich null).
• Getrennte Paymaster-Felder: paymaster, paymasterVerificationGasLimit, paymasterPostOpGasLimit und paymasterData sind jetzt separate Felder. Das erleichtert die Schätzung und verringert das Risiko, ein Budget zu vergessen.
• Aufteilung der Factory-Felder: Dasselbe Prinzip gilt hier – factory und factoryData sind separate Felder statt eines gebündelten initCode.
• Strafe für ungenutztes Gas: Sender zahlen 10 % des ungenutzten callGasLimit/paymasterPostOpGasLimit. Das hält davon ab, die benötigten Werte massiv zu überschätzen.
• Kompatibilitätshooks für EIP-7702: v0.7 ergänzte die nötige Infrastruktur, damit ein reguläres EOA vorübergehend an eine Smart-Account-Implementierung delegieren kann. Das wurde zur Grundlage für den in Pectra eingeführten Upgrade-Pfad von EIP-7702.

v0.6 ist weiterhin aktiv und wird nach wie vor genutzt – viele Wallets boten erst im Laufe des Jahres 2024 ein mit v0.7 kompatibles Modul an. Auf den meisten Blockchains laufen beide EntryPoint-Versionen jahrelang parallel.

Paymaster: Wer bezahlt das Gas?

Ein Paymaster ist ein Vertrag, der beim EntryPoint einen ETH-Stake hinterlegt und sich bereit erklärt, das Gas für UserOps zu übernehmen, die seiner Richtlinie entsprechen. Drei Varianten sind besonders verbreitet:

• Verifizierender Paymaster (gesponsert). Das Backend signiert eine Genehmigung außerhalb der Blockchain. Der Paymaster prüft die Signatur On-Chain und zahlt. Das nutzen Apps, die einen Einstieg ohne Gasgebühren ermöglichen wollen – etwa Coinbase Smart Wallet, Farcaster Frames und die meisten NFT-Mints.
• ERC-20-Paymaster. Der Nutzer zahlt in USDC, USDT oder DAI. Der Paymaster tauscht die Token im Backend gegen ETH (oder hält einen ETH-Bestand). Pimlico, Biconomy und Stackup betreiben jeweils öffentliche Angebote.
• Token-Paymaster mit Permit. Nutzt das EIP-2612-Permit, sodass der Nutzer die UserOp und eine Token-Freigabe mit einer einzigen Signatur genehmigt.

Die validatePaymasterUserOp des Paymasters wird während der Validierungsphase des EntryPoint ausgeführt. Wird sie zurückgesetzt, erhalten Sie AA33. Reicht sein Stake nicht mehr aus, zieht der EntryPoint ihn ein und der Bundler trägt den Verlust – deshalb führen Bundler Listen mit Reputationsbewertungen von Paymastern. ERC-7562 legt diese Reputationsregeln fest, damit der Bundler-Mempool gegen Spam geschützt bleibt. Dieselben Grundlagen erklären, warum sich die Freigabe- und Multisignatur-Hygiene bei DeFi auf eine 4337-Welt übertragen lässt: dieselben Bedrohungen, eine neue Verpackung.

Öffentlicher Alt-Mempool oder privater Bundler

Es gibt zwei Wege, eine UserOp on-chain zu bringen.

Öffentlicher Alt-Mempool: Bundler, die ERC-7562 erfüllen, verbreiten UserOps über ein libp2p-Netzwerk. Jeder, der einen Pimlico-, Stackup-, Alchemy-, Etherspot- oder Voltaire-Node betreibt, kann Ihre UserOp aufnehmen. Das ist erlaubnisfrei und zensurresistent, setzt Sie aber denselben MEV-Risiken aus wie gewöhnliche Ethereum-Transaktionen: Suchende können Ihre Operation sehen, bevor sie aufgenommen wird.

Privater Bundler: Sie senden eth_sendUserOperation direkt an den RPC-Endpunkt eines Anbieters. Dieser simuliert, bündelt und übermittelt die Transaktion privat (häufig über Flashbots). Das geht schneller und schützt vor MEV, setzt aber voraus, dass Sie dem Bundler vertrauen und darauf bauen, dass er weder zensiert noch vor Ihnen ausführt. Die meisten Wallets für Endverbraucher verwenden 2026 standardmäßig private Bundler.

Der Zielkonflikt ähnelt dem zwischen einem öffentlichen Mempool und Flashbots Protect bei gewöhnlichen Transaktionen. Falls Sie den zugrunde liegenden Ablauf einer Transaktion seit den L1-Zeiten nicht mehr gesehen haben: Diese Einführung erklärt, was sich ändert, wenn der Bundler ins Spiel kommt.

Aggregatoren, Verbreitung und Kosten

Aggregatoren sind Verträge, die Batches mit nur einer Signaturprüfung validieren. Der typische Anwendungsfall ist BLS: Sie sammeln 50 mit BLS signierte UserOps, fassen die Signaturen zu einer einzigen Pairing-Prüfung zusammen und sparen so rund 95 % der Signatur-Gaskosten. Die Verbreitung verlief schleppend, weil es schwierig ist, Wallets mit BLS-Signaturen zu entwickeln, und sich die Gaseinsparungen erst bei hohem Volumen lohnen. Mitte 2026 verwenden weniger als 1 % der UserOps im Mainnet Aggregatoren.

Verbreitungszahlen (Q1 2026, von bundlebear.com): insgesamt rund 380 Millionen UserOps über alle Chains hinweg; der Großteil entfällt auf Base, Polygon und Arbitrum. Der Anteil des Mainnets liegt bei rund 6–8 % – beim Volumen der geringste, beim übertragenen Wert jedoch der größte. Coinbase Smart Wallet, Farcaster und Argent beherrschen den Endkundenbereich.

Zusätzliche Kosten: Eine UserOp mit v0.7 verbraucht rund 30,000–40,000 Gas mehr als die entsprechende EOA-Transaktion. Darin enthalten sind die EntryPoint-Schleife, die Validierung und die Verwaltungsarbeit beim Bündeln. Bei 20 gwei im Mainnet entspricht das einem Bruchteil eines Dollars pro Operation. Die erstmalige Bereitstellung eines Accounts über factoryData kostet zusätzlich rund 250,000 Gas. Auf L2s, wo Calldata den größten Kostenfaktor darstellt, liegt der prozentuale Mehraufwand im einstelligen Bereich. Bei gesponserten UserOps trägt die dApp diese Kosten. Deshalb sind Transaktionen in Consumer-Apps kostenlos, in anspruchsvollen DeFi-Anwendungen aber nicht. Der ausführliche Überblick zu Transaktionsgebühren erklärt, wie sich dieser Mehraufwand in unterschiedlichen Gebührenmärkten auswirkt.

Kurz gesagt: ERC-4337 umfasst sechs Rollen (Sender, UserOp, Bundler, EntryPoint, Paymaster und Aggregator), eine Struktur, zwei EntryPoint-Adressen, die Sie auswendig kennen sollten, und rund 30–40k Gas zusätzliche Kosten. Dafür erhalten Sie beliebige Signaturverfahren, Gas-Sponsoring, Bündelung und parallele Nonces. Im dritten Teil dieser Reihe geht es um EIP-7702 – Pectras parallelen Ansatz, mit dem Ihr bestehender EOA dieselbe Infrastruktur nutzen kann, ohne die Adresse zu ändern.