Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/transeptorlabs/transeptor-bundler
A lightweight ERC4337 bundler node designed specifically for Node.js environment.
https://github.com/transeptorlabs/transeptor-bundler
account-abstraction bundler erc4337 esm ethereum nodejs p2p typescript
Last synced: about 2 months ago
JSON representation
A lightweight ERC4337 bundler node designed specifically for Node.js environment.
- Host: GitHub
- URL: https://github.com/transeptorlabs/transeptor-bundler
- Owner: transeptorlabs
- License: gpl-3.0
- Created: 2023-04-09T19:51:47.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-18T01:47:28.000Z (3 months ago)
- Last Synced: 2024-10-20T13:47:11.802Z (3 months ago)
- Topics: account-abstraction, bundler, erc4337, esm, ethereum, nodejs, p2p, typescript
- Language: TypeScript
- Homepage: https://transeptorlabs.io/bundler
- Size: 3.38 MB
- Stars: 25
- Watchers: 2
- Forks: 4
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-account-abstraction - Transeptor - Typescript Implementation
README
A light weight blazing fast, modular ERC-4337 TypeScript bundler built with functional programming.
> :warning: **This repository is currently under active development.**
>
> Support ERC-4337 Entrypoint contract [releases/v0.7](https://github.com/eth-infinitism/account-abstraction/tree/releases/v0.7)
## 🚀 Development
Everything you need to get started developing with Transeptor.
### Run local development
1. `git submodule update --init`
2. Use correct node version `nvm use`
3. Add `PRIVATE_KEY` to `contracts/.env` file to deploy the entrypoint contract locally.
4. Install dependencies `yarn install`
5. Start local eth node `yarn local-eth` - Will also deploy the entrypoint contract please wait for environment vars to be printed in the console and copy it to the nodes `.env` files.
6. In a new terminal window start the bundler node with live watch for local dev. `yarn dev`
- The node will start on `http://localhost:4337/rpc`.
You can now make changes to the code and each node will automatically restart.
#### Local dev e2e scripts
Make sure bundler node is running before running to to send a userOp through the bundler
```bash
yarn send-op
```
### Test
```bash
yarn test
```
### Lint
```bash
yarn lint
```
or
```bash
yarn lint:fix
```
## Build
You can build Transeptor from source or use the Docker image.
### 🔧 Run from source
1. Use correct node version: `nvm use`
2. Install dependencies: `yarn install`
3. Build node: `yarn build`
Now let's start the bundler node.
```bash
./transeptor --httpApi web3,eth,debug --txMode base
```
### 🐳 Run from Docker images
Build image
```bash
yarn build:image
```
Run image in the background
```bash
yarn start:image
```
stop image
```bash
yarn stop:image
```
## Node Configuration
### Command line arguments
List of all command line arguments supported by the bundler.
```bash
Options:
-V, --version output the version number
--httpApi ERC4337 rpc method name spaces to enable. (default: "web3,eth")
--network ETH execution client url. (default: "http://localhost:8545")
--p2p p2p mode enabled (default: false)
--findPeers Search for peers when p2p enabled. (default: false)
--port Bundler node listening port. (default: "4337")
--numberOfSigners Number of signers HD paths to use from mnmonic (default: "3")
--minBalance Maximum ETH balance need for signer address. (default: "1")
--minStake Minimum stake a entity has to have to pass reputation system. (default: "1")
--minUnstakeDelay Time paymaster has to wait to unlock the stake(seconds). (default: "0")
--bundleSize Maximum number of pending mempool entities to start auto bundler. (default: "10")
--maxBundleGas Max gas the bundler will use in transactions. (default: "5000000")
--auto Automatic bundling. (default: false)
--autoBundleInterval Auto bundler interval in (ms). (default: "12000")
--txMode Bundler transaction mode (base, conditional, searcher). (default: "base")
--unsafe Enable no storage or opcode checks during userOp simulation.
--metrics Bundler node metrics tracking enabled. (default: false)
--influxdbUrl Url influxdb is running on (requires --metrics to be enabled). (default: "http://localhost:8086")
--influxdbOrg Influxdb org (requires --metrics to be enabled). (default: "transeptor-labs")
--influxdbBucket Influxdb bucket (requires --metrics to be enabled). (default: "transeptor_metrics")
-h, --help display help for command
```
### Environment variables
List of all environment variables supported by the node.
```bash
# Required for production
TRANSEPTOR_ENTRYPOINT_ADDRESS=0x
TRANSEPTOR_BENEFICIARY=
TRANSEPTOR_MNEMONIC=
# Optional
TRANSEPTOR_INFLUX_TOKEN=DEV_TOKEN
TRANSEPTOR_ALCHEMY_API_KEY=
TRANSEPTOR_WHITE_LIST=
TRANSEPTOR_BLACK_LIST=
```
## Contribute
We welcome contributions to enhance our ERC-4337 Bundler. If you would like to contribute, please follow these guidelines [here](https://github.com/transeptorlabs/transeptor-bundler/blob/main/CONTRIBUTING.md). There are a few things you can do right now to help out:
- Add tests. There can never be enough tests.
## Contact Us
If you have any questions or feedback about the ERC-4337 Bundler project, please feel free to reach out to us.
- **Twitter**: [@transeptorlabs](https://twitter.com/transeptorlabs)
- **Telegram**: [Telegram channel](https://t.me/+eUGda3KIND4zMjRh)
## License
Licensed under the [GPL-3.0 License](https://github.com/transeptorlabs/transeptor-bundler/blob/main/LICENSE).
## Acknowledgements
We want to express our gratitude to the following individuals and organizations for their contributions and support in making this project possible:
- [Infinitism](https://github.com/eth-infinitism/bundler) - for inspiring our project and serving as a reference for implementation techniques.
We are grateful to the open-source community and the countless developers who have shared their knowledge and resources, enabling us to build upon their work.
Thank you all for your support!