Introduction to Bundlers

Bundlers power ERC-4337.

In ERC-4337, a Bundler is the core infrastructure component that allows account abstraction to work on any EVM network. On the highest level, its purpose is to work with a mempool of User Operations to get the transaction to be included on-chain.

Security considerations

When reading the EIP specs, you'll notice that there are many rules a bundler must follow. Although the list of rules may seem long and complex, each one has been extensively debated and discussed by security researchers and builders within the Ethereum ecosystem.

One of the bundlers main jobs is to comply with these rules to prevent all possible DoS attack vectors. These include everything from basic sanity checks that make sure a User Operation is structurally sound to more in-depth tracing for banned opcodes and storage access to make sure bundles cannot be censored once submitted to the network.

Similar to Ethereum clients, all bundler implementations are expected to pass a test suite to ensure its compliance and that it won't fragment the mempool.

👍

Stackup's bundler currently maintains 100% coverage of the test suite.

Although the spec is still a work in progress, all future iterations will strive to maintain full compliance coverage.

UserOperation mempool

The canonical mempool for EIP-4337 is decentralized and is made up of a permissionless P2P network of independent bundlers. To maintain this requirement, it doesn't make any assumptions about which contracts are okay and which are not. All contracts must follow the same rules during validation.

However, there will be cases where some contracts are audited and proven to be safe even though they break some of the rules set by the canonical mempool. In this case a group of bundlers can create alternative mempools for such exceptions. A common example of when this might be needed is in the case of a Deposit Paymaster that can abstract gas fees with any ERC-20 token.

Another role of the bundler is to maintain a connection to the canonical mempool and also any other alternative mempools it opts into. To read more about this topic, we highly recommend checking out this article.

Stackup bundler

One of Stackup's core open-source contributions is to develop a fully compliant and production grade bundler in Go. We see this work as critical to pushing account abstraction forward and improving the user experience for all accounts on Ethereum and other EVM networks.

Modes

An instance of the bundler supports different modes out of the box. Although all modes produce the same outcome, they vary in three areas:

  1. Mempool support: A private mempool is only visible to an individual bundler whereas a P2P mempool has UserOperations that have been propagated to all bundlers in the network.
  2. Networks: Some modes rely on specific features (e.g. mev-boost) that makes it only available to a certain set of EVM networks.
  3. DoS mitigation strategy: A bundler that sends a batch of User Operations on-chain must secure itself against front-running.
ModeMempool supportNetworksDoS mitigation strategy
privatePrivate mempool of UserOperations onlyAll EVM networksIP throttle clients that send UserOperations which revert transactions
searcherCan support both private and P2P mempool 1Ethereum onlyIntegrates with block builders like flashbots to send UserOperations via mev-boost
conditional2Can support both private and P2P mempoolEVM networks with conditional transactionsRelies on validators/sequencers to reject transactions that can cause a revert through certain state changes
1. searcher mode with P2P support is not yet implemented.
2. conditional mode is not yet implemented.