shunkakinoki / silius

ERC-4337 (Account Abstraction) - Bundler implementation in Rust.

AA - Bundler

Rust Bundler - ERC-4337 (Account Abstraction).

Stable Diffusion prompt: ethereum bundler account abstraction rust vector logo

For more information: https://hackmd.io/@Vid201/aa-bundler-rust

This project is still under active development.

Prerequisites

Rust version: 1.70

1. libclang, libclang-dev on Debian/Ubuntu.
2. Ethereum execution client JSON-RPC API with enabled debug_traceCall. For production, you can use Geth or Erigon. For testing, we are using Geth dev mode; so you need to install Geth for running tests.
3. solc >=0.8.12.
4. cargo-sort and cargo-udeps.

How to run?

Set up third-party dependencies (ERC-4337 smart contracts and bundler tests):

make fetch-thirdparty
make setup-thirdparty

Create wallet for bundler:

cargo run --release --bin create-wallet -- --output-path ${HOME}/.aa-bundler --chain-id 5

Run bundler (with user operation pool and JSON-RPC API):

cargo run --release -- --eth-client-address http://127.0.0.1:8545 --mnemonic-file ${HOME}/.aa-bundler/0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 --beneficiary 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 --gas-factor 600 --min-balance 1 --entry-points 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789 --min-stake 1 --min-unstake-delay 0 --min-priority-fee-per-gas 0 --max-verification-gas 1500000

Run only user operation pool:

cargo run --release --bin bundler-uopool -- --eth-client-address http://127.0.0.1:8545 --entry-points 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789 --min-stake 1 --min-unstake-delay 0 --min-priority-fee-per-gas 0 --max-verification-gas 1500000

Run only JSON-RPC API:

cargo run --release --bin bundler-rpc

Supported networks

Bundler was tested on the following networks:

Chain	Mainnet	Testnet
Ethereum	🔜	🔜 (Goerli), ✔️ (Sepolia)
Polygon PoS	🔜	✔️ (Mumbai)

Supported Entrypoint

The EntryPoint address is the same on all EVM networks.

Address	Commit	Audited
0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789	9b5f2e4	April 2023

Examples

To get started, check the examples here. More examples will be added in the future.

Contributing

Thank you for showing interest in contributing to the project!

There is a contributing guide to help get you started.

There are some additional prerequisites for testing:

1. geth

Before making a PR, make sure to run the following commands:

make format
make lint
make test

Official bundler spec tests developed by the eth-infinitism team are also included in the repo's CI pipeline. You can find more information on how to run tests here. Make sure your contribution doesn't break the tests!

Contact

The best place for the discussion is the dedicated Telegram group.

Authors

• Vid Kersic: GitHub, Twitter
• WillQ: GitHub, Twitter

Licenses

This project is dual-licensed under Apache 2.0 and MIT terms:

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT License (LICENSE-MIT or http://opensource.org/licenses/MIT)

Donations

aa-bundler is an open-source project and a public good. If you want to help the project, you can send donations of any size via:

• Ethereum address: 0x7cB801446AC4f5EA8f7333EFc58ab787eB611558

Acknowledgements

• Bundler - eth-infinitism
• Akula
• ethers-rs
• Reth