Getting started

A fast, reliable, and modular Go implementation of an ERC-4337 Bundler.

Running an instance

See the Bundler documentation at docs.stackup.sh.

Contributing

Prerequisites

• Go 1.20 or later
• Access to a node with debug API enabled for custom tracing.

Setup

# Installs https://github.com/cosmtrek/air for live reloading.
# Runs go mod tidy.
make install-dev

# Generates base .env file.
# All variables in this file are required and should be filled.
# Running this command WILL override current .env file.
make generate-environment

# Parses private key in .env file and prints public key and address.
make fetch-wallet

Run bundler in private mode

Start a local bundler instance:

make dev-private-mode

If you need to reset the embedded database:

# This will delete the default data directory at /tmp/stackup_bundler
make dev-reset-default-data-dir

License

Distributed under the GPL-3.0 License. See LICENSE for more information.

Contact

Feel free to direct any technical related questions to the dev-hub channel in the Stackup Discord.