Skip to main content

Get Started

Overview​

Transeptor is in Alpha

Please note that while the software is fully functional, it is important to know that it may contain bugs and incomplete features and undergo frequent updates.

We invite you to actively participate in the development of this software. Visit our GitHub repository to get involved.

Transeptor is a lightweight, blazing-fast, modular ERC-4337 TypeScript bundler built with functional programming. It offers a wide range of bundling modes to fit your needs.

Quick Start​

Transeptor is easy to set up with Docker and requires minimal configuration. For this guide, we will walk through running Transeptor with a geth native tracer in searcher mode on the Sepolia testnet. See more on the modes that Transeptor supports here.

Follow the steps below to get started with Transeptor:

Get your network provider URL​

To connect the Transeptor to the Ethereum network on the Sepolia testnet, you can use public Ethereum networks like Infura.

To get your network provider URL, sign up for an account on Infura. Your network provider needs to debug_traceCall with support for prestateTracer. The Infura Developer price plan will give access to Debug / Trace API.

An Infura network provider URL should look like https://sepolia.infura.io/v3/<your-project-id>.

Pull Transeptor Docker image​

docker pull transeptorlabs/bundler:latest

Set environment variables​

Transeptor requires a set of environment variables to run. Create a .env file and add the following variables:

# Required
TRANSEPTOR_ENTRYPOINT_ADDRESS=0x0000000071727De22E5E9d8BAf0edAc6f37da032
TRANSEPTOR_BENEFICIARY=<address_to_receive_funds>
TRANSEPTOR_MNEMONIC=<your-mnemonic>

# Optional
TRANSEPTOR_WHITE_LIST=<address_to_allow_SEPARATED_BY_COMMA>
TRANSEPTOR_BLACK_LIST=<address_to_ban_SEPARATED_BY_COMMA>

Start up geth native tracer node​

Pull the native tracer image from Docker Hub and start the container. The native tracer is required for full validation during userOp simulation to enforce ERC-7562: Account Abstraction Validation Rules.

docker run -d --name geth-native-tracer -p 8888:8888 accountabstraction/geth-native-tracer \
    --verbosity 1 \
    --http.vhosts '*,localhost,host.docker.internal' \
    --http \
    --http.port 8888 \
    --http.api eth,net,web3,debug \
    --http.corsdomain '*' \
    --http.addr "0.0.0.0" \
    --networkid 1337 \
    --dev \
    --dev.period 0 \
    --allow-insecure-unlock \
    --rpc.allow-unprotected-txs \
    --dev.gaslimit 20000000

Start Transeptor​

With the Geth native tracer node running, you can now start Transeptor. You can pass the path to your .env file to the Docker container.

  • Ensure the signer account is funded with ETH with the desired minBalance before starting Bundler. And replace yourDesiredBalanceInEth with the desired balance.
  • The bundler will use the first HD path from your mnemonic to sign transactions.
  • Make sure to replace <your-project-id> with your Infura project ID.
docker run -d --name transeptor -p 4337:4337 --env-file <path_to_your_.env> transeptorlabs/bundler:latest \
  --httpApi web3,eth,debug \
  --txMode searcher \
  --port 4337 \
  --minBalance yourDesiredBalanceInEth \
  --network https://sepolia.infura.io/v3/your-project-id \
  --tracerRpcUrl http://host.docker.internal:8888 \
  --auto

Traneptor will start on http://localhost:4437/rpc. Run curl command to check if the Transeptor is running:

curl -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}' http://localhost:4337/rpc

You are now ready to start bundling userOp on the Sepolia testnet with Transeptor.

Contact us​

Have questions or need help? Here are a few ways to get in touch:

  1. Open an issue of Transeptor Github
  2. Send us a message on Telegram