{"id":13767559,"url":"https://github.com/transeptorlabs/transeptor-bundler","last_synced_at":"2026-03-07T16:03:09.072Z","repository":{"id":157479059,"uuid":"625661547","full_name":"transeptorlabs/transeptor-bundler","owner":"transeptorlabs","description":"An ERC-4337 Bundler — open-source infrastructure powering Account Abstraction on Ethereum.","archived":false,"fork":false,"pushed_at":"2026-01-19T19:33:01.000Z","size":5237,"stargazers_count":27,"open_issues_count":1,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-20T01:19:37.636Z","etag":null,"topics":["account-abstraction","bundler","erc4337","esm","ethereum","functional-programming","nodejs","p2p","typescript"],"latest_commit_sha":null,"homepage":"https://docs.transeptor.io","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/transeptorlabs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"transeptorlabs"}},"created_at":"2023-04-09T19:51:47.000Z","updated_at":"2026-01-19T19:33:01.000Z","dependencies_parsed_at":"2024-01-12T00:09:18.557Z","dependency_job_id":"892ac4a2-0af0-4170-84fb-7e1e6a1877fb","html_url":"https://github.com/transeptorlabs/transeptor-bundler","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/transeptorlabs/transeptor-bundler","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/transeptorlabs%2Ftranseptor-bundler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/transeptorlabs%2Ftranseptor-bundler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/transeptorlabs%2Ftranseptor-bundler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/transeptorlabs%2Ftranseptor-bundler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/transeptorlabs","download_url":"https://codeload.github.com/transeptorlabs/transeptor-bundler/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/transeptorlabs%2Ftranseptor-bundler/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30221193,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T14:02:48.375Z","status":"ssl_error","status_checked_at":"2026-03-07T14:02:43.192Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["account-abstraction","bundler","erc4337","esm","ethereum","functional-programming","nodejs","p2p","typescript"],"created_at":"2024-08-03T16:01:09.731Z","updated_at":"2026-03-07T16:03:09.065Z","avatar_url":"https://github.com/transeptorlabs.png","language":"TypeScript","funding_links":["https://github.com/sponsors/transeptorlabs"],"categories":["Uncategorized"],"sub_categories":["Uncategorized"],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://docs.transeptor.io/bundler\"\u003e\n    \u003cimg width=\"500\" title=\"Transeptor\" src='https://docs.transeptor.io/img/brand/transeptor.png' /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/node-22.14.0-green\" alt=\"Node Version\"\u003e\n  \u003cimg src=\"https://badgen.net/badge/-/TypeScript?icon=typescript\u0026label\u0026labelColor=blue\u0026color=555555\" alt=\"TypeScript\"\u003e\n  \u003cimg src=\"https://github.com/transeptorlabs/transeptor-bundler/actions/workflows/main.yml/badge.svg?branch=main\"\u003e\n  \u003ca href=\"https://app.codecov.io/gh/transeptorlabs/transeptor-bundler\"\u003e\n    \u003cimg src=\"https://img.shields.io/codecov/c/github/transeptorlabs/transeptor-bundler.svg?style=flat-square\" alt=\"codecov\"\u003e\n  \u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/ESM-supported-brightgreen\" alt=\"ESM Supported\"\u003e\n  \u003cimg src=\"https://img.shields.io/docker/pulls/transeptorlabs/bundler\" alt=\"Docker pulls\"\u003e\n\u003c/p\u003e\n\n\u003e :warning: **The `main` branch of Transeptor is under active development and is compatible with [Entrypoint releases/v0.8](https://github.com/eth-infinitism/account-abstraction/tree/releases/v0.8).**\n\u003e\n\u003e **Support for previous EntryPoint releases are available below.**\n\u003e\n\u003e - Compatible with [Entrypoint releases/v0.7](https://github.com/eth-infinitism/account-abstraction/tree/releases/v0.7): [Transeptor v0.11.0-alpha.0](https://github.com/transeptorlabs/transeptor-bundler/tree/v0.11.0-alpha.0)\n\u003e - Compatible with [Entrypoint releases/v0.6](https://github.com/eth-infinitism/account-abstraction/tree/releases/v0.6): [Transeptor v0.5.3-alpha.0](https://github.com/transeptorlabs/transeptor-bundler/tree/v0.5.3-alpha.0)\n\n**Table of Contents**\n\n\u003c!--TOC--\u003e\n\n- [What is Transeptor bundler?](#what-is-transeptor-bundler)\n- [Quick Start](#quick-start)\n- [Development](#development)\n  - [Prerequisites](#prerequisites)\n  - [Getting started](#getting-started)\n  - [Test](#test)\n  - [Lint](#lint)\n- [Running Transeptor](#running-transeptor)\n- [Node Configuration](#node-configuration)\n- [Contribute](#contribute)\n- [Contact Us](#contact-us)\n- [License](#license)\n- [Acknowledgements](#acknowledgements)\n- [Relevant Documents](#relevant-documents)\n\n\u003c!--TOC--\u003e\n\n## What is Transeptor bundler?\n\n\u003e Run a node. Join the ecosystem. Help shape the future of account abstraction.\n\n**Transeptor bundler 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.\n\nThis project is maintained by **[Transeptor Labs](https://transeptorlabs.io/)**, an open-source collective building public-good infrastructure to support Ethereum's ERC-4337 ecosystem.\n\nOur long-term vision is to:\n\n- **Run it yourself** - Make it easy for anyone to run their own bundler node.\n- **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.\n- **Bundler compatibility** - Maintain strict compatibility with [erc-4337/bundler-spec-test](https://bundlers.erc4337.io/) to preserve the vision of a [Unified ERC-4337 mempool](https://notes.ethereum.org/@yoav/unified-erc-4337-mempool).\n- **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.\n\nBy contributing to Transeptor bundler, you're helping build an open, composable infrastructure layer that strengthens Ethereum’s decentralization and usability without requiring any changes to the protocol.\n\n## Quick Start\n\nTo quickly start using Transeptor, follow the instructions in our [Quick Start guide](https://docs.transeptor.io/bundler/get-started#quick-start).\n\n## Development\n\n### Prerequisites\n\nBefore getting started, make sure you have the following tools installed on your machine:\n\n- [Node.js](https://nodejs.org/) (\u003e= **v22.14.0**)\n- [nvm](https://github.com/nvm-sh/nvm) – Node version manager\n- [Yarn](https://classic.yarnpkg.com/lang/en/) (**v4.7.0**)\n- [Docker](https://docs.docker.com/compose/install/) – with Docker Compose **v2**\n- [Git](https://git-scm.com/)\n- [Foundry (forge)](https://getfoundry.sh/introduction/installation) (\u003e= **1.1.0**)\n\n\u003e **Tip:** You can run the `./scripts/check-prerequisites.sh` script to verify your system is ready to run the development environment:\n\u003e\n\u003e This script will validate the required versions of Node.js, Yarn, Git, Docker Compose, and Foundry.\n\n```bash\nchmod +x ./scripts/check-prerequisites.sh\n./scripts/check-prerequisites.sh\n```\n\n### Getting started\n\nFollow these instructions to get the project up and running on your local machine for development purposes:\n\n1. Run the following commands in order to prepare dev environment.\n\n```bash\n# Ensure the submodule is checked out properly by running\ngit submodule update --init --recursive\n\n# Use the correct node version\nnvm use\n\n# Use yarn version 4.7.0\ncorepack enable\n\n# Install dependencies\nyarn install\n\n# Starts dev nodes `geth` and `geth-with-erc7562-tracer` Docker images and deploys entrypoint contract to the 1337 network.\nyarn start:eth-dev\n```\n\n2. Please wait for environment vars to be printed in the terminal and copy it to your `.env` files.\n3. 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:\n\n- `yarn dev` - To start the bundler node in safe mode with full storage and opcode checks.\n- `yarn dev:unsafe` - To start the bundler node in unsafe mode with no storage or opcode checks.\n\nThe bundler node will start on `http://localhost:4337/rpc`.\n\n### Test\n\nRun the test suite.\n\n```bash\nyarn test\n```\n\nRun an e2e script to send a userOp through the bundler.\n\n```bash\nyarn send-op\n```\n\n### Lint\n\n```bash\nyarn lint\nyarn lint:fix\n```\n\n## Running Transeptor\n\nTranseptor offers multiple options for installation and configuration. Refer to the [Running Transeptor](https://github.com/transeptorlabs/transeptor-bundler/blob/main/docs/running-transeptor.md) guide for details.\n\n## Node Configuration\n\nFor detailed configuration options, including command-line arguments and environment variables, visit the [Node Configuration guide](https://github.com/transeptorlabs/transeptor-bundler/blob/main/docs/node-configuration.md).\n\n## Contribute\n\nWe welcome contributions to enhance our ERC-4337 Bundler. Please follow our [contribution guidelines](https://github.com/transeptorlabs/transeptor-bundler/blob/main/CONTRIBUTING.md).\n\n## Contact Us\n\nIf you have any questions or feedback about Transeptor, reach out to us:.\n\n- **Twitter**: [@transeptorlabs](https://twitter.com/transeptorlabs)\n- **Telegram**: [Telegram channel](https://t.me/+eUGda3KIND4zMjRh)\n\n## License\n\nLicensed under the [GPL-3.0 License](https://github.com/transeptorlabs/transeptor-bundler/blob/main/LICENSE).\n\n## Acknowledgements\n\nWe appreciate the open-source community and those who have shared their knowledge, enabling us to build on their work:\n\n- [Infinitism](https://github.com/eth-infinitism/bundler) - for inspiring our project and serving as a reference for implementation techniques.\n\n## Relevant Documents\n\n- [ERC-4337](https://eips.ethereum.org/EIPS/eip-4337)\n- [ERC-7562](https://eips.ethereum.org/EIPS/eip-7562)\n- [EIP-1153](https://eips.ethereum.org/EIPS/eip-1153)\n- [EIP-7702](https://eips.ethereum.org/EIPS/eip-7702)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftranseptorlabs%2Ftranseptor-bundler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftranseptorlabs%2Ftranseptor-bundler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftranseptorlabs%2Ftranseptor-bundler/lists"}