transeptor bundler

A lightweight, blazing-fast, modular ERC-4337 TypeScript bundler built with functional programming

transeptorlabs
27
4
TypeScript

Built by Transeptor Labs, we champion bundler diversity, mempool compatibility, and open experimentation—because a decentralized Ethereum depends on resilient public-good infrastructure.

Node Version TypeScript codecov ESM Supported Docker pulls

⚠️ The main branch of Transeptor is under active development and is compatible with Entrypoint releases/v0.8.

Support for previous EntryPoint releases are available below.

Table of Contents

What is Transeptor?

Run a node. Join the ecosystem. Help shape the future of account abstraction.

Transeptor is a high-performance, modular ERC-4337 bundler designed to make smart accounts scalable and usable on Ethereum. Built in TypeScript with a functional programming foundation, it prioritizes security and developer experience. Transeptor helps abstract complexity so teams can build intuitive applications on top of Account Abstraction.

This project is maintained by Transeptor Labs, an open-source collective building public-good infrastructure to support Ethereum’s evolution toward a user-centric experience.

Our long-term vision is to:

  • Run it yourself - Make it easy for anyone to run their own bundler node.
  • Promote bundler diversity and reduce centralization risks — We are committed to decentralization by offering public bundlers anyone can use, and empowering developers to run and customize their own.
  • Bundler compatibility - Maintain strict compatibility with erc-4337/bundler-spec-test to preserve the vision of a Unified ERC-4337 mempool.
  • Embrace the Future - Experiment safely with advanced features to push bundler UX and performance forward. Any system that can be written down can be realized.

By contributing to Transeptor, you’re helping build an open, composable infrastructure layer that strengthens Ethereum’s decentralization and usability without requiring any changes to the protocol.

Quick Start

To quickly start using Transeptor, follow the instructions in our Quick Start guide.

Development

Prerequisites

Before getting started, make sure you have the following tools installed on your machine:

Tip: You can run the ./scripts/check-prerequisites.sh script to verify your system is ready to run the development environment:

This script will validate the required versions of Node.js, Yarn, Git, Docker Compose, and Foundry.

chmod +x ./scripts/check-prerequisites.sh
./scripts/check-prerequisites.sh

Getting started

Follow these instructions to get the project up and running on your local machine for development purposes:

  1. Run the following commands in order to prepare dev environment.
# Ensure the submodule is checked out properly by running
git submodule update --init --recursive

# Use the correct node version
nvm use

# Use yarn version 4.7.0
corepack enable

# Install dependencies
yarn install

# Starts dev nodes `geth` and `geth-with-erc7562-tracer` Docker images and deploys entrypoint contract to the 1337 network.
yarn start:eth-dev
  1. Please wait for environment vars to be printed in the terminal and copy it to your .env files.
  2. In a new terminal window, start the bundler node in dev mode with a live watch for changes in the ./src path with auto restarts. There are two different dev modes:
  • yarn dev - To start the bundler node in safe mode with full storage and opcode checks.
  • yarn dev:unsafe - To start the bundler node in unsafe mode with no storage or opcode checks.

The bundler node will start on http://localhost:4337/rpc.

Test

Run the test suite.

yarn test

Run an e2e script to send a userOp through the bundler.

yarn send-op

Lint

yarn lint
yarn lint:fix

Running Transeptor

Transeptor offers multiple options for installation and configuration. Refer to the Running Transeptor guide for details.

Node Configuration

For detailed configuration options, including command-line arguments and environment variables, visit the Node Configuration guide.

Contribute

We welcome contributions to enhance our ERC-4337 Bundler. Please follow our contribution guidelines.

Contact Us

If you have any questions or feedback about Transeptor, reach out to us:.

License

Licensed under the GPL-3.0 License.

Acknowledgements

We appreciate the open-source community and those who have shared their knowledge, enabling us to build on their work:

  • Infinitism - for inspiring our project and serving as a reference for implementation techniques.

Relevant Documents