Modular, developer-friendly and lighting-fast Python Bundler for Ethereum EIP-4337 Account Abstraction

The project is still work in progress.

Deploy Voltaire using the latest docker image

docker run --net=host --rm -ti sherifahmed990/voltaire-bundler:latest --entrypoint $ENTRYPOINT --bundler_secret $BUNDLER_SECRET --rpc_url $RPC_URL --rpc_port $PORT --ethereum_node_url $ETHEREUM_NODE_URL --chain_id $CHAIN_ID --verbose

The information provided is only a rough estimate based on the current implementation. We plan on publishing more documentation for different developer audiences as we move forward.

curl -sSL https://install.python-poetry.org | python3 -

poetry install

poetry env use python3.11

Follow the installation guide to install docker on ubunutu

Follow the instruction for docker's post linux instalation

docker run --rm -ti --name geth -p 8545:8545 ethereum/client-go:v1.10.26 \
  --miner.gaslimit 12000000 \
  --http --http.api personal,eth,net,web3,debug \
  --http.vhosts '*,localhost,host.docker.internal' --http.addr "0.0.0.0" \
  --ignore-legacy-receipts --allow-insecure-unlock --rpc.allow-unprotected-txs \
  --dev \
  --verbosity 4 \
  --nodiscover --maxpeers 0 --mine --miner.threads 1 \
  --networkid 1337

geth --exec 'loadScript("test/deploy.js")' attach http:https://0.0.0.0:8545

source test/init-params 

poetry run python3 main.py --entrypoint $ENTRYPOINT --bundler_secret $BUNDLER_SECRET --chain_id 1337 --verbos

Follow the instruction in eth-infinitism/bundler-spec-tests to install dependencies and run the test

Thank you for considering contributing to open-source code! We welcome contributions and are grateful for even the smallest of fixes.

We will be publishing guidelines on how to contribute as we move forward with Voltaire's development.

If you want to contribute today or follow along with the contributor discussion, you can use our main discord to chat with us about the development of Voltaire.

The project is not ready for production use. We hope to have a full implentation sometimes in April/May 2023, followed by optimizations. In the meantime, we're working on making sure this repo is well-documented, abstracted and tested.

LGPL

None of this would have been possible without the following teams and organizations below:

• EIP-4337: Account Abstraction via Entry Point Contract specification
• eth-infinitism/bundler
• Voltaire is funded exclusively by The Ethereum Foundation