Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/candidelabs/voltaire
Account Abstraction Bundler written in Python & Rust - ERC-4337
https://github.com/candidelabs/voltaire
bundler erc4337 ethereum
Last synced: about 2 months ago
JSON representation
Account Abstraction Bundler written in Python & Rust - ERC-4337
- Host: GitHub
- URL: https://github.com/candidelabs/voltaire
- Owner: candidelabs
- License: lgpl-3.0
- Created: 2023-02-14T02:29:28.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-09T22:36:40.000Z (4 months ago)
- Last Synced: 2024-09-11T03:16:17.300Z (4 months ago)
- Topics: bundler, erc4337, ethereum
- Language: Rust
- Homepage: https://docs.candide.dev/wallet/bundler/erc-4337-intro
- Size: 46.2 MB
- Stars: 46
- Watchers: 8
- Forks: 12
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-web3-tools-and-dapps - Voltaire - Introducing a Python bundler called ERC-4337, created by the talented Candide wallet team. It's an open-source tool! (dApps directory / Account Abstraction (ERC-4337) Bundlers)
- awesome-account-abstraction - Voltaire - Python Implementation
README
Voltaire
Modular and lighting-fast Python Bundler for Ethereum EIP-4337 Account Abstraction
# Using an instance
For a quick bundler instance, use one of our [public hosted endpoints](https://docs.candide.dev/wallet/bundler/rpc-endpoints/) for your development.
# Deployment
Deploy Voltaire using the latest docker image
```
docker run --net=host --rm -ti ghcr.io/candidelabs/voltaire/voltaire-bundler:latest --bundler_secret $BUNDLER_SECRET --rpc_url $RPC_URL --rpc_port $PORT --ethereum_node_url $ETHEREUM_NODE_URL --chain_id $CHAIN_ID --verbose --unsafe --disable_p2p
```
# Development
## Ubuntu: Get started testing the bundler in 5 minutes
### Install Poetry
```
curl -sSL https://install.python-poetry.org | python3 -
```
### Install dependencies
```
poetry install
```
### Make sure you are using the right python version
```
poetry env use python3.11
```
### Install Docker
Follow the installation guide to install [docker on ubuntu](https://docs.docker.com/engine/install/ubuntu/)
### Post docker installation
Follow the instruction for docker's [post linux instalation](https://docs.docker.com/engine/install/linux-postinstall/)
### Start geth
```
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
```
### Deploy the EntryPoint and fund the signer (in another terminal)
```
geth --exec 'loadScript("scripts/deploy.js")' attach http://0.0.0.0:8545
```
### Set env values
```
source scripts/init-params
```
### Run the bundler
```
poetry run python3 -m voltaire_bundler --entrypoint $ENTRYPOINT --bundler_secret $BUNDLER_SECRET --chain_id 1337 --verbose
```
### Test the bundler by cloning `eth-infinitism/bundler-spec-tests`
Follow the instruction in eth-infinitism/bundler-spec-tests to install dependencies and run the test
## P2P rust section development
### Install Rust
```
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```
### Install build dependencies
```
sudo apt install musl-tools
rustup target add x86_64-unknown-linux-musl
```
### Build the rust section using poetry script
```
poetry run build_p2p
```
## Contributions
Thank you for considering contributing to open-source code! We welcome contributions and are grateful for even the smallest of fixes.
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.
## License
LGPL
## Acknowledgments
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](https://ethereum.foundation/)
* Lighthouse: Ethereum consensus client