https://github.com/usmansaleem/kurtosis
EthPandaOps Kurtosis scripts to run Ethereum devnet for local testing
https://github.com/usmansaleem/kurtosis
besu geth kurtosis
Last synced: about 1 month ago
JSON representation
EthPandaOps Kurtosis scripts to run Ethereum devnet for local testing
- Host: GitHub
- URL: https://github.com/usmansaleem/kurtosis
- Owner: usmansaleem
- Created: 2025-05-21T00:10:02.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-08-20T11:09:36.000Z (about 2 months ago)
- Last Synced: 2025-08-20T13:12:43.857Z (about 2 months ago)
- Topics: besu, geth, kurtosis
- Language: Solidity
- Homepage:
- Size: 209 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Ethereum devnet using Kurtosis
https://github.com/ethpandaops/ethereum-package
## Prereq
- Kurtosis is installed. https://docs.kurtosis.com/install
- Foundary is installed. https://getfoundry.sh/
- `git submodule update --init --recursive` has been executed on the checked out repo.
- Besu is built locally with `./gradlew distDocker`
- Use `docker images` to determine Besu docker tag. This can be passed when starting kurtosis.
## Start devnet using Kurtosis
```shell
./1_kurtosis_start.sh 25.8-develop-c64327f
```
- Wait for genesis to be created. Takes about a minute.
- The Genesis time can be checked at `dora` at `http://127.0.0.1:36000`. The dora address is reported when kurtosis
command is finished.
### Test
The following script will deploy various contracts and run testing scenarios. See `output/scenarios` for the results.
```shell
./2_run_call_tracer_tests.sh
```
### Tear down
```shell
./3_kurtosis_stop.sh
```
## Useful kurtosis commands
```shell
# Drop into Besu container shell and observe custom logs
kurtosis service shell my-testnet el-2-besu-teku
cat /tmp/calltracer.log
# Report all running services
kurtosis enclave inspect my-testnet
# Read logs of a specific service
kurtosis service logs my-testnet el-2-besu-teku
# Tear down
kurtosis enclave rm -f my-testnet
# Or, Complete teardown of all services and cleanup the enclave
kurtosis clean -a
# Stop the kurtosis engine
kurtosis engine stop
```