https://github.com/stackup-wallet/stackup-bundler

A fast, reliable, and modular ERC-4337 Bundler written in Go.
https://github.com/stackup-wallet/stackup-bundler

account-abstraction bundler erc4337 ethereum go golang

Last synced: about 1 month ago
JSON representation

A fast, reliable, and modular ERC-4337 Bundler written in Go.

• Host: GitHub
• URL: https://github.com/stackup-wallet/stackup-bundler
• Owner: stackup-wallet
• License: gpl-3.0
• Created: 2022-10-08T00:32:36.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-02-07T03:22:58.000Z (5 months ago)
• Last Synced: 2024-02-07T05:46:55.426Z (5 months ago)
• Topics: account-abstraction, bundler, erc4337, ethereum, go, golang
• Language: Go
• Homepage: https://docs.stackup.sh
• Size: 682 KB
• Stars: 193
• Watchers: 8
• Forks: 109
• Open Issues: 49
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-stars - stackup-wallet/stackup-bundler - 4337 Bundler. (Go)
• awesome-web3-tools-and-dapps - Stackup Bundler - Introducing a free bundler called ERC-4337 made by Stackup, crafted using the Golang programming language. (dApps directory / Account Abstraction (ERC-4337) Bundlers)
• awesome-eip-4337 - Stackup (Go) by Stackup
• awesome-stars - stackup-wallet/stackup-bundler - A fast, reliable, and modular ERC-4337 Bundler written in Go. (golang)
• awesome-wallet - Stackup Bundler - wallet/stackup-bundler?style=flat-square)  - A modular Go implementation of an ERC-4337 Bundler. (Just for fun / Flutter SDK / Libraries)
• awesome-erc-4337 - stackup bundler
• awesome-account-abstraction - Stackup - Golang Implementation

README

        
![](https://i.imgur.com/fMnLV0q.png)

![GitHub release (latest by date)](https://img.shields.io/github/v/release/stackup-wallet/stackup-bundler)

![Compliance status](https://github.com/stackup-wallet/stackup-bundler/actions/workflows/compliance.yml/badge.svg?branch=main)

![E2E status](https://github.com/stackup-wallet/stackup-bundler/actions/workflows/e2e.yml/badge.svg?branch=main)

![core status](https://github.com/stackup-wallet/stackup-bundler/actions/workflows/core.yml/badge.svg?branch=main)

# 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](https://docs.stackup.sh/docs/erc-4337-bundler).

# Contributing

## Prerequisites

- Go 1.20 or later

- Access to a node with `debug` API enabled for custom tracing.

## Setup

```bash

# 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:

```bash

make dev-private-mode

```

If you need to reset the embedded database:

```bash

# 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](./LICENSE) for more information.

# Contact

Feel free to direct any technical related questions to the `dev-hub` channel in the [Stackup Discord](https://discord.gg/VTjJGvMNyW).