one-click kurtosis support

Author: JasonVranek

.gitignore

@@ -24,3 +24,6 @@ devenv.*
 devenv.lock
 .devenv.flake.nix
 .envrc
+
+# Generated from testnet
+kurtosis-dump

justfile

@@ -166,3 +166,39 @@ clean:
 # Runs the suite of tests for all commit-boost crates.
 test:
     cargo test --all-features
+
+# =================
+# === Kurtosis ===
+# =================
+
+# Tear down and clean up all enclaves
+clean-kurtosis:
+  kurtosis clean -a
+
+# Clean all enclaves and restart the testnet
+restart-kurtosis:
+  just clean-kurtosis
+  kurtosis run github.com/ethpandaops/ethereum-package \
+    --enclave CB-Testnet \
+    --args-file provisioning/kurtosis-config.yml
+
+# Build local docker images and restart testnet
+build-kurtosis:
+  just build-all kurtosis
+  just restart-kurtosis
+
+# Inspect running enclave
+inspect-kurtosis:
+  kurtosis enclave inspect CB-Testnet
+
+# Tail logs for a specific service: just logs-kurtosis <service>
+logs-kurtosis service:
+  kurtosis service logs CB-Testnet {{service}} --follow
+
+# Shell into a specific service: just shell-kurtosis <service>
+shell-kurtosis service:
+  kurtosis service shell CB-Testnet {{service}}
+
+# Dump enclave state to disk for post-mortem
+dump-kurtosis:
+  kurtosis enclave dump CB-Testnet ./kurtosis-dump

provisioning/kurtosis-config.yml

@@ -0,0 +1,104 @@
+# ELs: geth, nethermind, erigon, besu, reth, ethrex
+# CLs: nimbus, lighthouse, lodestar, teku, prysm, and grandine
+participants:
+  - el_type: geth
+    cl_type: nimbus
+
+  - el_type: nethermind
+    cl_type: lighthouse
+
+  - el_type: erigon
+    cl_type: lodestar
+
+  - el_type: besu
+    cl_type: teku
+
+  - el_type: reth
+    cl_type: prysm
+
+  - el_type: ethrex
+    cl_type: grandine
+
+additional_services:
+  - dora
+  - spamoor
+mev_type: commit-boost
+
+mev_params:
+  mev_relay_image: ethpandaops/mev-boost-relay:main
+  mev_boost_image: commit-boost/pbs:kurtosis
+  mev_builder_cl_image: sigp/lighthouse:latest
+  mev_builder_image: ethpandaops/reth-rbuilder:develop
+
+network_params:
+  network: kurtosis
+  network_id: "3151908"
+  deposit_contract_address: "0x00000000219ab540356cBB839Cbe05303d7705Fa"
+  seconds_per_slot: 12
+  slot_duration_ms: 12000
+  num_validator_keys_per_node: 128
+  preregistered_validator_keys_mnemonic:
+    "giant issue aisle success illegal bike spike
+    question tent bar rely arctic volcano long crawl hungry vocal artwork sniff fantasy
+    very lucky have athlete"
+  preregistered_validator_count: 0
+  additional_mnemonics: []
+  genesis_delay: 20
+  genesis_time: 0
+  genesis_gaslimit: 60000000
+  max_per_epoch_activation_churn_limit: 8
+  churn_limit_quotient: 65536
+  ejection_balance: 16000000000
+  eth1_follow_distance: 2048
+  min_validator_withdrawability_delay: 256
+  shard_committee_period: 256
+  attestation_due_bps_gloas: 2500
+  aggregate_due_bps_gloas: 5000
+  sync_message_due_bps_gloas: 2500
+  contribution_due_bps_gloas: 5000
+  payload_attestation_due_bps: 7500
+  view_freeze_cutoff_bps: 7500
+  inclusion_list_submission_due_bps: 6667
+  proposer_inclusion_list_cutoff_bps: 9167
+  deneb_fork_epoch: 0
+  electra_fork_epoch: 0
+  fulu_fork_epoch: 0
+  gloas_fork_epoch: 18446744073709551615
+  network_sync_base_url: https://snapshots.ethpandaops.io/
+  force_snapshot_sync: false
+  data_column_sidecar_subnet_count: 128
+  samples_per_slot: 8
+  custody_requirement: 4
+  max_blobs_per_block_electra: 9
+  max_request_blocks_deneb: 128
+  max_request_blob_sidecars_electra: 1152
+  target_blobs_per_block_electra: 6
+  base_fee_update_fraction_electra: 5007716
+  additional_preloaded_contracts: {}
+  devnet_repo: ethpandaops
+  prefunded_accounts: {}
+  bpo_1_epoch: 0
+  bpo_1_max_blobs: 15
+  bpo_1_target_blobs: 10
+  bpo_1_base_fee_update_fraction: 8346193
+  bpo_2_epoch: 18446744073709551615
+  bpo_2_max_blobs: 21
+  bpo_2_target_blobs: 14
+  bpo_2_base_fee_update_fraction: 11684671
+  bpo_3_epoch: 18446744073709551615
+  bpo_3_max_blobs: 0
+  bpo_3_target_blobs: 0
+  bpo_3_base_fee_update_fraction: 0
+  bpo_4_epoch: 18446744073709551615
+  bpo_4_max_blobs: 0
+  bpo_4_target_blobs: 0
+  bpo_4_base_fee_update_fraction: 0
+  bpo_5_epoch: 18446744073709551615
+  bpo_5_max_blobs: 0
+  bpo_5_target_blobs: 0
+  bpo_5_base_fee_update_fraction: 0
+  withdrawal_type: "0x00"
+  withdrawal_address: "0x8943545177806ED17B9F23F0a21ee5948eCaa776"
+  validator_balance: 32
+  min_epochs_for_data_column_sidecars_requests: 4096
+  min_epochs_for_block_requests: 33024