Skip to content

test(l1): add restart stall reproduction test using eth-docker #6151

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
pablodeymo wants to merge 10 commits into
base: main
Choose a base branch
from
+761 −1
Open

test(l1): add restart stall reproduction test using eth-docker #6151

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
e426aa1
Add restart stall reproduction test using eth-docker
pablodeymo Feb 6, 2026
ccf3005
Use docker compose directly instead of ./ethd to avoid interactive pr…
pablodeymo Feb 6, 2026
c1317fb
Add el-shared.yml to COMPOSE_FILE to expose RPC port to host
pablodeymo Feb 6, 2026
0e83992
Add fee-recipient and PYTHONUNBUFFERED to Makefile restart-stall targets
pablodeymo Feb 6, 2026
8a12e3e
Address Copilot review feedback on restart stall test
pablodeymo Feb 6, 2026
29c2880
Add CHECKPOINT_SYNC_URL to eth-docker configuration based on network.
pablodeymo Feb 6, 2026
192ee9e
Resolve .env path relative to script directory instead of CWD so
pablodeymo Feb 9, 2026
d06fbbb
Add --wipe-el-data flag to restart stall test so each Phase 2 cycle
pablodeymo Feb 9, 2026
7edb2a8
Make data wipe the default behavior in restart stall test. Each Phase 2
pablodeymo Feb 9, 2026
b7dabc9
Loop restart cycles indefinitely by default (Ctrl+C to stop). Each
pablodeymo Feb 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 44 additions & 1 deletion tooling/sync/Makefile
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,8 @@ flamegraph-hoodi start-lighthouse start-ethrex backup-db start-mainnet-metrics-d
start-sepolia-metrics-docker start-holesky-metrics-docker start-hoodi-metrics-docker \
start-metrics-docker tail-syncing-logs tail-metrics-logs copy_flamegraph import-with-metrics \
multisync-up multisync-down multisync-clean multisync-logs multisync-status \
multisync-restart multisync-monitor multisync-run multisync-loop multisync-loop-auto
multisync-restart multisync-monitor multisync-run multisync-loop multisync-loop-auto \
restart-stall-test restart-stall-test-skip-sync restart-stall-test-keep-data

ETHREX_DIR ?= "../.."

Expand Down Expand Up @@ -342,3 +343,45 @@ multisync-loop-auto: ## Continuous loop with auto-update: pull latest, build, an
--build-profile "$(MULTISYNC_BUILD_PROFILE)" \
--image-tag "$(MULTISYNC_LOCAL_IMAGE)" \
--ethrex-dir "$(ETHREX_DIR)"

# ==============================================================================
# Restart Stall Test (eth-docker)
# ==============================================================================
# Tests whether ethrex stalls on header download after restart.
# Uses eth-docker (must be cloned already) with ethrex + Prysm.
# Phase 1: Fresh snap sync (terminate + start, wait for completion)
# Phase 2: Stop only execution client, restart it, check for stall
# ==============================================================================

RESTART_TEST_NETWORK ?= hoodi
RESTART_TEST_COUNT ?= 0
RESTART_TEST_FEE_RECIPIENT ?=
ETH_DOCKER_DIR ?= $(HOME)/eth-docker

restart-stall-test: ## Run restart stall test via eth-docker: configure, sync, then restart cycles.
PYTHONUNBUFFERED=1 python3 restart_stall_test.py \
--eth-docker-dir $(ETH_DOCKER_DIR) \
--network $(RESTART_TEST_NETWORK) \
--restart-count $(RESTART_TEST_COUNT) \
--configure \
$(if $(RESTART_TEST_FEE_RECIPIENT),--fee-recipient $(RESTART_TEST_FEE_RECIPIENT)) \
--ethrex-dir $(ETHREX_DIR)

restart-stall-test-skip-sync: ## Run restart stall test, skip initial sync (node must be synced).
PYTHONUNBUFFERED=1 python3 restart_stall_test.py \
--eth-docker-dir $(ETH_DOCKER_DIR) \
--network $(RESTART_TEST_NETWORK) \
--restart-count $(RESTART_TEST_COUNT) \
--skip-phase1 \
$(if $(RESTART_TEST_FEE_RECIPIENT),--fee-recipient $(RESTART_TEST_FEE_RECIPIENT)) \
--ethrex-dir $(ETHREX_DIR)

restart-stall-test-keep-data: ## Run restart stall test keeping data (stop/start only, no wipe).
PYTHONUNBUFFERED=1 python3 restart_stall_test.py \
--eth-docker-dir $(ETH_DOCKER_DIR) \
--network $(RESTART_TEST_NETWORK) \
--restart-count $(RESTART_TEST_COUNT) \
--configure \
--keep-data \
$(if $(RESTART_TEST_FEE_RECIPIENT),--fee-recipient $(RESTART_TEST_FEE_RECIPIENT)) \
--ethrex-dir $(ETHREX_DIR)
Loading
Loading