https://github.com/transeptorlabs/betsy
An all in one tool to manage ERC 4337 infrastructure for local development and testing
https://github.com/transeptorlabs/betsy
cli erc4337 golang htmx mempool-explorer
Last synced: 3 months ago
JSON representation
An all in one tool to manage ERC 4337 infrastructure for local development and testing
- Host: GitHub
- URL: https://github.com/transeptorlabs/betsy
- Owner: transeptorlabs
- License: mit
- Created: 2024-06-21T01:02:29.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-07-13T17:05:08.000Z (over 1 year ago)
- Last Synced: 2024-07-13T19:25:13.549Z (over 1 year ago)
- Topics: cli, erc4337, golang, htmx, mempool-explorer
- Language: Go
- Homepage:
- Size: 187 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# Betsy
[](https://pkg.go.dev/github.com/transeptorlabs/betsy)
[](https://goreportcard.com/report/github.com/transeptorlabs/betsy)
An all-in-one CLI tool to manage ERC 4337 infrastructure for local development and testing.
✨ **Features include:**
1. Ephemeral In-Memory Ethereum Execution Client(Geth)
- Starts a fresh instance with each run, ensuring a clean slate every time.
- Destroyed after each Betsy run.
2. Pre-funded accounts
- Default accounts with pre-funded balances.
- Includes private keys for easy access.
3. Pre-deployed contract
- Type-safe Go binding for Account Abstraction contracts:
- [EntryPoint release v7](https://github.com/eth-infinitism/account-abstraction/blob/releases/v0.7/contracts/core/EntryPoint.sol)
- [SimpleAccountFactory release v7](https://github.com/eth-infinitism/account-abstraction/blob/releases/v0.7/contracts/samples/SimpleAccountFactory.sol)
- Additional contract: GlobalCounter.
4. ERC 4337 Bundler clients
- Includes integration with:
- [Transeptor bundler](https://github.com/transeptorlabs/transeptor-bundler)
5. Realtime ERC 4337 userOp Mempool Explorer UI
- Visualize the userOp mempool in real-time, offering an insightful view into current operations.
🚧 **Coming soon:**
1. Supported ERC 4337 bundlers**
- [x] [Transeptor](https://github.com/transeptorlabs/transeptor-bundler)
- [ ] Other bundlers (e.g. [Aabundler](https://github.com/eth-infinitism/bundler), [Okbund](https://github.com/okx/okbund) etc.)
2. Ethereum execution client forks for EVM mainnet and testnet. Run a fork of the Ethereum mainnet or testnet to test your AA smart contracts in a real-world environment.
3. Manage Entrypoint deposits, withdrawals, and stakes on local Entrypoint contract.
4. Realtime ERC 4337 Bundler bundle explorer UI. Visualize the bundler bundle production in real time.
## Installation
For more information on installing Betsy, see the [Installation](./docs/installation.md) guide.
## Development
Information on how to set a development environment for Betsy.
### Branches
The `main` branch acts as the development branch and is the repository's default branch. The main branch build will be marked as `unstable` in the version.
- Betsy's latest `stable` version can be found on branch `release/x.y.z`.
### Running the CLI
Run the following command to start the CLI:
```shell
make run-cli
```
### Running tests
To run the tests, execute the following command:
```shell
make test
```
Or to run the tests with coverage:
```shell
make test-coverage
```
## Contributing
If you would like to contribute, please follow these guidelines [here](https://github.com/transeptorlabs/betsy/blob/main/CONTRIBUTING.md).
## License
Licensed under the [MIT](https://github.com/transeptorlabs/betsy/blob/main/LICENSE).