deploy: regenerate compose from vibe-node main 688dbbc13dce

Add PRECONFIRMATION_SERVER_JWT_SECRET and --preconfirmation.jwtSecret=/jwtsecret
to archive hoodi driver services so taiko-client v2.4.0 can start the
preconfirmation block server when PRECONFIRMATION_SERVER_PORT is enabled.

Co-authored-by: Cursor <cursoragent@cursor.com>

CURSOR.md

@@ -0,0 +1,729 @@
+# VIBE.md — ethereum-rpc-docker Operations & Debugging Guide
+
+You are an LLM agent or operator **running or debugging blockchain RPC nodes** from this
+repository. This file is your **primary reference** for all operational tasks.
+
+This repo contains Docker Compose configurations for blockchain RPC nodes plus operational
+scripts for managing them. Everything you need to run, monitor, debug, and fix nodes is here.
+
+---
+
+## 0. WHEN A NODE IS FAULTY — Start Here
+
+### Immediate Triage (30 seconds)
+
+```bash
+# 1. Is the container running?
+./show-running.sh
+
+# 2. Check overall status of all configured nodes
+./show-status.sh
+
+# 3. If you know the config name, check its specific status
+./sync-status.sh <config-name>
+
+# 4. Check logs for the faulty node
+./logs.sh <config-name>
+```
+
+**If the container isn't running**, go to [§3. Container Lifecycle Issues](#3-container-lifecycle-issues)
+
+**If the container is running but not synced**, go to [§4. Sync Issues](#4-sync-issues)
+
+**If the container is running and synced but RPC fails**, go to [§5. RPC/Connectivity Issues](#5-rpcconnectivity-issues)
+
+**If you see errors in logs but aren't sure what they mean**, go to [§6. Log Interpretation](#6-log-interpretation)
+
+---
+
+## 1. Repository Overview
+
+### What This Repo Contains
+
+```
+rpc/
+├── *.yml                    # Docker Compose files for node configurations
+├── *.sh                     # Operational scripts (YOUR PRIMARY TOOLS)
+├── scripts/                 # Additional helper scripts (CometBFT support)
+├── <network>/               # Network directories (e.g., ethereum/, op/, arb/)
+│   ├── *.yml                # Compose files for specific chains
+│   └── <chain>/             # Chain-specific assets
+│       ├── genesis.json     # Custom genesis files
+│       ├── rollup.json      # Rollup configurations (OP Stack)
+│       └── *.Dockerfile      # Custom build files
+├── README.md                # User documentation
+└── VIBE.md                  # THIS FILE — operations guide
+```
+
+### Key Concepts
+
+- **Config name**: The compose filename WITHOUT `.yml` (e.g., `ethereum-mainnet-geth-pruned`)
+- **Service name**: Derived from config name, used in `docker compose` commands
+- **Short name**: Used in URL paths, container labels. Format: `{network}-{chain}[-{client}][-{db_type}]`
+- **Volume names**: Docker volumes follow the full config name pattern
+
+### Supported Networks
+
+**Layer 1**: Ethereum, Polygon, BSC, Avalanche, Gnosis, Fantom, Core, Berachain, Ronin, Viction, Fuse, Tron, ThunderCore, Goat, AlephZero, Haqq, Taiko, Rootstock, Dogecoin, Litecoin, Bitcoin, Bitcoin-Cash, Ripple, Solana, Tron
+
+**Layer 2 (OP Stack)**: Optimism, Base, Zora, Mode, Blast, Fraxtal, Bob, Boba, Worldchain, Metal, Ink, Lisk, SNAX, Celo
+
+**Layer 2 (Arbitrum)**: Arbitrum One, Arbitrum Nova, Everclear, Playblock, Real, Connext, OpenCampusCodex
+
+**Other L2s**: Linea, Scroll, zkSync Era, Metis, Moonbeam, Starknet, zkEVM, Immutable zkEVM, Polygon zkEVM
+
+---
+
+## 2. Essential Scripts Reference
+
+### Status & Monitoring Scripts
+
+| Script | Usage | What It Does |
+|---|---|---|
+| `show-status.sh` | `[config-name]` | Lists ALL configured nodes with sync status, block height, health |
+| `show-running.sh` | | Lists currently running containers |
+| `sync-status.sh` | `<config-name>` | Detailed sync status for one config |
+| `latest.sh` | `<config-name>` | Latest block number + hash |
+| `logs.sh` | `<config-name>` | Tail logs from all containers in a config |
+| `show-db-size.sh` | | Disk usage of ALL Docker volumes, sorted by size |
+| `show-ram.sh` | `<config-name>` | Memory usage of containers |
+| `show-cpu.sh` | | CPU usage display |
+| `peer-count.sh` | | P2P peer count for all running nodes |
+| `time-since-last-block.sh` | `<config-name>` | How long since last block was processed |
+| `ping.sh` | `<container-name>` | Test network connectivity from container |
+| `show-errors.sh` | | Show error counts/logs across containers |
+| `show-size.sh` | | Show size of containers/volumes |
+| `show-file-size.sh` | | Show static file sizes |
+| `show-static-file-size.sh` | | Show static file sizes (alternative) |
+
+### Lifecycle Management Scripts
+
+| Script | Usage | What It Does |
+|---|---|---|
+| `start.sh` | `<config-name>` | Start all containers for a config |
+| `stop.sh` | `<config-name>` | Stop all containers for a config |
+| `force-recreate.sh` | `<config-name>` | Force recreate containers (keeps volumes) |
+| `rm.sh` | `<config-name>` | Remove containers (keeps volumes) |
+| `delete-volumes.sh` | `<config-name>` | **DESTRUCTIVE** - Remove containers AND volumes |
+| `delete-node-keys.sh` | `<config-name>` | Remove node keys (for re-initialization) |
+
+### Backup & Restore Scripts
+
+| Script | Usage | What It Does |
+|---|---|---|
+| `backup-node.sh` | `<config-name> [url]` | Backup volumes locally or to WebDAV |
+| `restore-volumes.sh` | `<config-name> [url]` | Restore volumes from local or HTTP |
+| `clone-node.sh` | `<config-name>` | Clone a node's state |
+| `clone-backup.sh` | | Clone backup files |
+| `clone-peers.sh` | | Clone peer information |
+| `restore-peers.sh` | | Restore peer connections |
+| `list-backups.sh` | | List available backup files |
+| `list-peer-backups.sh` | | List peer backup files |
+| `list-restorable.sh` | | List restorable configurations |
+| `cleanup-backups.sh` | | Remove old backups |
+| `cleanup-volumes.sh` | | Clean up unused volumes |
+
+### Network & Connectivity Scripts
+
+| Script | Usage | What It Does |
+|---|---|---|
+| `upstreams.sh` | | Generate dshackle upstream configuration |
+| `connect-peers.sh` | | Connect to peer nodes |
+| `search-node.sh` | `<query>` | Search compose files for patterns |
+| `search-compose.sh` | `<query>` | Search compose files |
+| `network-to-config.sh` | | Map network names to config files |
+| `reload_dshackle.sh` | | Reload dshackle configuration |
+| `update-whitelist.sh` | | Update IP whitelist |
+| `update-ip.sh` | | Update IP configuration |
+
+### Specialized Scripts
+
+| Script | Usage | What It Does |
+|---|---|---|
+| `op-wheel.sh` | | OP rollup maintenance (rewind, set forkchoice) |
+| `op-wheel-finalize-latest-block.sh` | `<client_svc> [node_svc]` | Finalize latest block (nuclear option) |
+| `catchup.sh` | `<config-name>` | Help node catch up to chain head |
+| `success-if-almost-synced.sh` | `<config-name> <seconds>` | Exit 0 if node is almost synced |
+| `groq.sh` | | Query using Groq |
+| `trai.sh` | | Trace transaction |
+| `multicurl.sh` | | Parallel curl requests |
+| `blocknumber.sh` | | Get block number |
+| `get-block.sh` | | Get block information |
+| `get-local-url.sh` | | Get local RPC URL |
+| `get-shortname.sh` | `<config-file>` | Get short name for a config |
+| `disk-space.sh` | | Check disk space |
+| `limit-bandwidth.sh` | | Limit bandwidth |
+| `maintenance.sh` | | Maintenance helper |
+| `random-port.sh` | | Generate random port |
+| `reference-rpc-endpoint.sh` | | Reference RPC endpoint helper |
+| `reset-terminal.sh` | | Reset terminal |
+| `setup-bandwidth-limit-cron.sh` | | Setup cron for bandwidth limiting |
+
+---
+
+## 3. Container Lifecycle Issues
+
+### Symptom: Container Won't Start
+
+```bash
+# Check why it failed
+./logs.sh <config-name> 2>&1 | tail -50
+
+# Check container exit code
+docker ps -a --filter "name=<config-name>" --format "{{.Names}} | {{.State}} | {{.Status}}"
+
+# Inspect the container
+docker inspect <container-name> | jq '.[0].State'
+```
+
+**Common causes:**
+- **Port conflict**: Two services trying to bind to same host port
+- **Volume permission issues**: Docker can't write to volume
+- **Missing environment variables**: `.env` file incomplete
+- **Invalid compose syntax**: YAML parsing error
+- **Image pull failure**: Network issue or private registry auth
+
+**Fixes:**
+```bash
+# Check for port conflicts
+grep -h "^[0-9]\{1,5\}:[0-9]" *.yml | sort | uniq -d
+
+# Validate compose syntax
+docker compose -f <config-file>.yml config
+
+# Pull images manually
+docker compose -f <config-file>.yml pull
+
+# Start with --build if using custom Dockerfiles
+docker compose -f <config-file>.yml up -d --build
+```
+
+### Symptom: Container Exits Immediately After Starting
+
+```bash
+# View the last 100 lines of logs before exit
+./logs.sh <config-name> 2>&1 | tail -100
+
+# Check exit code
+docker ps -a --filter "name=<service>" --format "{{.Status}}"
+
+# Run interactively to see error
+docker compose -f <config-file>.yml run --rm <service-name> sh
+```
+
+**Common causes:**
+- **Missing config files**: `/config/` mount empty or wrong path
+- **Invalid flags**: Command-line arguments malformed
+- **Database corruption**: Existing data incompatible with new version
+- **Checkpoint/genesis mismatch**: Chain ID or genesis doesn't match
+
+**Fixes:**
+```bash
+# Verify config directory exists (if using custom configs)
+ls -la <network>/<chain>/
+
+# Try with fresh volumes (DESTRUCTIVE)
+./delete-volumes.sh <config-name>
+./start.sh <config-name>
+```
+
+### Symptom: Container Restarts Repeatedly (Crash Loop)
+
+```bash
+# Watch logs in real-time
+./logs.sh <config-name> -f
+
+# Check restart count
+docker inspect <container-name> | jq '.[0].RestartCount'
+
+# Check last restart reason
+docker inspect <container-name> | jq '.[0].State.ExitCode, .[0].State.Error'
+```
+
+**Common causes:**
+- **OOM killed**: Memory limit exceeded
+- **Out of disk space**: No space left on device
+- **Segmentation fault**: Client bug or bad data
+- **Panic**: Go client panic
+
+**Fixes:**
+```bash
+# Check memory usage
+./show-ram.sh <config-name>
+
+# Check disk space
+df -h /var/lib/docker
+./show-db-size.sh
+
+# Increase resources in compose file or .env
+# Then force recreate
+./force-recreate.sh <config-name>
+```
+
+---
+
+## 4. Sync Issues
+
+### Symptom: Node Not Syncing (Stuck at Block 0 or Low Block)
+
+```bash
+# Check sync status
+./sync-status.sh <config-name>
+
+# Check current block
+./latest.sh <config-name>
+
+# Check logs for sync errors
+./logs.sh <config-name> | grep -i -E "sync|error|fail|warn|stuck|behind"
+
+# Check peer count
+./peer-count.sh | grep <config-name>
+```
+
+**Common causes:**
+- **No peers**: P2P network connection failed
+- **Wrong network**: Connected to wrong chain
+- **Checkpoint too old**: Checkpoint URL unavailable or outdated
+- **Snapshot download failed**: Snapshot server unreachable
+
+**Fixes:**
+```bash
+# Check if checkpoint/snapshot is configured
+grep -E "(checkpoint|snapshot)" <config-file>.yml
+
+# Test checkpoint URL manually
+curl -I $(grep checkpoint <config-file>.yml | grep -oE 'http[^ ]+')
+
+# Check peer connections (geth example)
+docker exec <client-container> admin_peers | jq '.[] | .network.remoteAddress' | wc -l
+```
+
+### Symptom: Sync is Very Slow
+
+```bash
+# Check sync speed over time
+./latest.sh <config-name>; sleep 60; ./latest.sh <config-name>
+
+# Check if node is processing blocks
+./time-since-last-block.sh <config-name>
+
+# Check CPU and memory
+top -d 1 -p $(docker inspect <container> | jq -r '.[0].State.Pid')
+```
+
+**Common causes:**
+- **Resource constrained**: CPU throttled, memory swapped
+- **Disk I/O bottleneck**: Slow storage or contention
+- **Network rate limited**: P2P or RPC rate limiting
+- **Too many peers**: P2P overhead
+- **Wrong sync mode**: Full sync instead of snap sync
+
+### Symptom: Sync Stuck at Specific Block
+
+```bash
+# Check logs around the stuck block
+./logs.sh <config-name> | grep -A 10 -B 10 "block <stuck-block-number>"
+
+# Check if it's a known bad block
+# Search online: <chain> bad block <number>
+```
+
+**Common causes:**
+- **Bad block in chain**: Requires client patch or manual intervention
+- **State trie inconsistency**: Database corruption
+- **Fork choice issue**: Node on wrong fork
+
+**Fixes for OP Stack:**
+```bash
+# Try to finalize past the block
+./op-wheel-finalize-latest-block.sh <client-service>
+```
+
+### Symptom: Node on Wrong Fork / Chain
+
+```bash
+# Check chain ID
+./latest.sh <config-name> | grep -i chain
+
+# Check what chain the node thinks it's on
+docker exec <client-container> ethdo chain --endpoint=http://localhost:8545
+
+# Compare with expected chain ID
+grep chainId <config-file>.yml
+```
+
+---
+
+## 5. RPC/Connectivity Issues
+
+### Symptom: RPC Endpoint Not Responding
+
+```bash
+# Test from host
+curl -s http://localhost:<port> | head -c 100
+
+# Check if traefik/proxy is running
+docker ps | grep -E "(traefik|proxy|nginx)"
+
+# Check traefik logs
+docker logs <traefik-container> | tail -50
+```
+
+**Common causes:**
+- **Container not running**: Client crashed
+- **Port not exposed**: Wrong port mapping
+- **Traefik misconfiguration**: Labels wrong or missing
+- **Firewall blocking**: Host firewall or cloud security group
+
+### Symptom: RPC Returns Wrong Chain ID
+
+```bash
+# Query chain ID from RPC
+curl -s -X POST http://localhost:<port> \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'
+```
+
+### Symptom: Cannot Connect to P2P Network
+
+```bash
+# Check peer count
+./peer-count.sh | grep <config-name>
+
+# Test P2P connectivity from container
+docker exec <client-container> nc -zv <bootstrap-node> <p2p-port>
+```
+
+**Fixes:**
+```bash
+# Set public IP in .env
+IP=$(curl -s ipinfo.io/ip)
+echo "IP=$IP" >> .env
+./force-recreate.sh <config-name>
+```
+
+---
+
+## 6. Log Interpretation
+
+### Common Log Patterns
+
+#### Warnings (Node may still function)
+| Pattern | Meaning | Action |
+|---|---|---|
+| `WARN.*sync.*slow` | Sync slower than expected | Check resources |
+| `WARN.*peers.*low` | Fewer peers than desired | Check P2P connectivity |
+| `WARN.*rate.*limit` | API rate limiting active | Normal for public endpoints |
+
+#### Errors (Node is degraded)
+| Pattern | Meaning | Action |
+|---|---|---|
+| `Error.*database.*corrupt` | Database corruption | Restore from backup or resync |
+| `Error.*handshake.*fail` | P2P handshake failed | Check chain ID |
+| `Error.*no.*peers` | Cannot connect to P2P | Check bootstrap nodes |
+| `Error.*timeout` | RPC/HTTP timeout | Check network, increase timeout |
+
+#### Fatal (Node will not function)
+| Pattern | Meaning | Action |
+|---|---|---|
+| `Fatal.*panic` | Client crashed | Check client version |
+| `Fatal.*OOM` | Out of memory | Increase memory limit |
+| `Fatal.*disk.*full` | No disk space | Free space |
+| `Fatal.*permission.*denied` | Filesystem permissions | Fix volume permissions |
+
+---
+
+## 7. Resource Issues
+
+### High CPU Usage
+```bash
+./show-ram.sh <config-name>
+./show-cpu.sh
+docker stats <container-name> --no-stream
+```
+
+### High Memory Usage
+```bash
+./show-ram.sh <config-name>
+docker stats <container-name> --no-stream --format "{{.Container}} | {{.MemUsage}} | {{.MemPerc}}"
+```
+
+### High Disk Usage
+```bash
+./show-db-size.sh
+docker system df -v
+```
+
+### Disk I/O Bottleneck
+```bash
+iotop -o -d 1
+```
+
+---
+
+## 8. Backup and Restore
+
+### Creating a Backup
+```bash
+# Local backup (to /backup directory)
+./backup-node.sh <config-name>
+
+# Remote backup (to WebDAV)
+./backup-node.sh <config-name> https://backup-server.tld/dav
+```
+
+### Restoring from Backup
+```bash
+# List available backups
+./list-backups.sh
+
+# Restore latest backup for config
+./restore-volumes.sh <config-name>
+
+# Restore from specific URL
+./restore-volumes.sh <config-name> https://backup-server.tld/backup/
+```
+
+### Cloning a Node
+
+```bash
+# Clone a node to a new location
+./clone-node.sh <config-name>
+
+# Clone peers (for faster sync)
+./clone-peers.sh <config-name>
+```
+
+### Nuclear Option: Full Reset
+
+```bash
+# WARNING: This deletes ALL data for the config
+./stop.sh <config-name> && \
+./rm.sh <config-name> && \
+./delete-volumes.sh <config-name> && \
+./delete-node-keys.sh <config-name> && \
+./force-recreate.sh <config-name>
+
+# Then check logs
+./logs.sh <config-name>
+```
+
+---
+
+## 9. Common Error Messages
+
+### Database Errors
+| Error | Cause | Solution |
+|---|---|---|
+| `database is corrupted` | Power loss, bug | Restore from backup or resync |
+| `database version mismatch` | Client version changed | Delete and resync |
+
+### P2P Errors
+| Error | Cause | Solution |
+|---|---|---|
+| `no configured peers` | Missing bootstrap nodes | Add bootstrap nodes |
+| `handshake failed` | Chain ID mismatch | Verify genesis.json |
+
+### RPC Errors
+| Error | Cause | Solution |
+|---|---|---|
+| `method not found` | Wrong client | Use correct client |
+| `connection refused` | Port not open | Check container running, port mapping |
+
+---
+
+## 10. OP Stack Specific Debugging
+
+### OP Node Issues
+
+```bash
+# Check op-node logs
+./logs.sh <config-name> | grep -i "op-node\|rollup\|sequencer"
+
+# Check rollup configuration (if custom)
+cat op/<network>/ethereum/rollup.json | jq .
+
+# Check if rollup.json is mounted
+docker exec <op-node-container> cat /config/rollup.json | jq .
+```
+
+### OP Wheel (Manual Intervention)
+
+```bash
+# Rewind to specific block (DANGEROUS - only if you know what you're doing)
+./op-wheel.sh engine set-forkchoice \
+  --unsafe=<block-hash> \
+  --safe=<block-hash> \
+  --finalized=<block-hash> \
+  --engine=http://<client-service>:8551/ \
+  --engine.open=http://<client-service>:8545 \
+  --engine.jwt-secret-path=/jwtsecret
+
+# Nuclear option: finalize latest local block
+./op-wheel-finalize-latest-block.sh <client-service> <node-service>
+```
+
+---
+
+## 11. CometBFT Family (Cosmos, etc.) Specific
+
+### Init Container Issues
+
+```bash
+# CometBFT chains use init.sh inside the container
+# The master script is at scripts/cometbft-common.sh
+
+# Check if init completed
+./logs.sh <config-name> | grep -i "init\|setup\|complete"
+
+# Check the init script
+cat <network>/<chain>/scripts/init.sh
+```
+
+---
+
+## 12. Quick Start Guide
+
+### Starting a Node
+
+```bash
+# 1. Set up environment
+echo "IP=$(curl -s ipinfo.io/ip)" > .env
+echo "DOMAIN=${IP//./-}.traefik.me" >> .env
+echo "MAIL=your-email@example.com" >> .env
+
+# 2. Select which nodes to run
+# Add compose files to COMPOSE_FILE (colon-separated)
+echo "COMPOSE_FILE=base.yml:rpc.yml:ethereum-mainnet-geth-pruned.yml" >> .env
+
+# 3. Start the node
+docker compose up -d
+
+# 4. Verify it's running
+./show-status.sh
+```
+
+### Accessing Your Node
+
+```bash
+# Once running, access via:
+# HTTP: http://<your-domain>/ethereum-mainnet-geth-pruned
+# HTTPS: https://<your-domain>/ethereum-mainnet-geth-pruned
+# WebSocket: wss://<your-domain>/ethereum-mainnet-geth-pruned
+
+# Or locally (if NO_SSL=true):
+# HTTP: http://localhost:<port>
+```
+
+---
+
+## 13. Configuration Reference
+
+### Environment Variables
+
+**Required for most setups:**
+```bash
+IP=203.0.113.42                    # Your public IP
+DOMAIN=203-0-113-42.traefik.me    # Your domain (traefik.me for testing)
+MAIL=your-email@example.com        # For Let's Encrypt SSL
+WHITELIST=0.0.0.0/0               # IP whitelist (0.0.0.0/0 = all)
+```
+
+**Optional:**
+```bash
+NO_SSL=true                       # Disable SSL (testing only)
+CHAINS_SUBNET=192.168.0.0/26      # Docker network subnet
+```
+
+**Chain-specific (examples):**
+```bash
+ETHEREUM_MAINNET_EXECUTION_RPC=https://fallback-rpc.example.com
+ARBITRUM_SEPOLIA_EXECUTION_RPC=https://arb-sepolia-rpc.example.com
+OP_NODE_NETWORK=mainnet
+OP_NODE_L1_RPC_URL=https://l1-rpc.example.com
+```
+
+### Compose File Structure
+
+Each compose file defines one or more services:
+- **client**: Execution layer (Geth, Erigon, Reth, etc.)
+- **node**: Consensus/derivation node (op-node, lighthouse, etc.)
+- **relay**: DA relay (eigenda-proxy, op-alt, etc.)
+- **proxy**: HTTP/WS proxy (nginx, etc.)
+- **database**: External database (Postgres, etc.)
+
+### Volume Naming
+
+Volumes are named after the config:
+```
+<config-name>_<service>_data
+<config-name>_<service>_config
+```
+
+Example: `ethereum-mainnet-geth-pruned_client_data`
+
+---
+
+## 14. Quick Debugging Checklist
+
+Use this checklist when debugging an issue:
+
+- [ ] **Is the container running?** → `./show-running.sh`
+- [ ] **Are there errors in logs?** → `./logs.sh <config> | grep -i error`
+- [ ] **Is the node synced?** → `./sync-status.sh <config>`
+- [ ] **Are peers connected?** → `./peer-count.sh`
+- [ ] **Are resources adequate?** → `./show-ram.sh`, `./show-db-size.sh`
+- [ ] **Is P2P working?** → Check peer count
+- [ ] **Is RPC responding?** → Test with curl
+- [ ] **Is disk space available?** → `df -h /var/lib/docker`
+- [ ] **Is the config file correct?** → `docker compose -f <file>.yml config`
+- [ ] **Are environment variables set?** → Check `.env`
+- [ ] **Is the genesis file correct?** → Check chain ID
+
+---
+
+## 15. When to Escalate
+
+Escalate to a human operator if:
+
+- [ ] Node stuck for > 2 hours with no progress
+- [ ] Repeated `Fatal` or `panic` errors after restart
+- [ ] Database corruption confirmed
+- [ ] Issue affects multiple nodes across different chains
+- [ ] Need to force-push to this repo
+
+---
+
+## 16. File Locations Quick Reference
+
+| What You Need | Where to Find It |
+|---|---|
+| Compose files | Root of this repo (`*.yml`) |
+| Operational scripts | Root of this repo (`*.sh`) |
+| Chain assets | `<network>/<chain>/` or `<stack>/<network>/<settlement>/` |
+| Genesis files | `<stack>/<network>/<settlement>/genesis.json` |
+| Rollup configs | `op/<network>/<settlement>/rollup.json` |
+| Custom Dockerfiles | `<path>/*.Dockerfile` |
+| Init scripts | `<path>/scripts/init.sh` |
+| CometBFT common | `scripts/cometbft-common.sh` |
+| Compose registry | `compose_registry.json` |
+| RPC endpoints | `reference-rpc-endpoint.json` |
+| Environment | `.env` |
+
+---
+
+## 17. Resource Requirements Reference
+
+| Node Type | Disk | RAM | CPU |
+|---|---|---|---|
+| Ethereum pruned | ~500GB | 8GB | 2+ cores |
+| Ethereum archive | ~2TB+ | 16GB+ | 4+ cores |
+| Ethereum archive-trace | ~4TB+ | 32GB+ | 8+ cores |
+| L2 pruned | ~100-500GB | 4-8GB | 2+ cores |
+| L2 archive | ~1-2TB | 8-16GB | 4+ cores |
+
+**Note:** Requirements vary by chain. Check specific chain documentation.
+
+---
+
+*This file is your complete operations and debugging reference. For additional user documentation, see README.md.*

VIBE.md

@@ -0,0 +1,729 @@
+# VIBE.md — ethereum-rpc-docker Operations & Debugging Guide
+
+You are an LLM agent or operator **running or debugging blockchain RPC nodes** from this
+repository. This file is your **primary reference** for all operational tasks.
+
+This repo contains Docker Compose configurations for blockchain RPC nodes plus operational
+scripts for managing them. Everything you need to run, monitor, debug, and fix nodes is here.
+
+---
+
+## 0. WHEN A NODE IS FAULTY — Start Here
+
+### Immediate Triage (30 seconds)
+
+```bash
+# 1. Is the container running?
+./show-running.sh
+
+# 2. Check overall status of all configured nodes
+./show-status.sh
+
+# 3. If you know the config name, check its specific status
+./sync-status.sh <config-name>
+
+# 4. Check logs for the faulty node
+./logs.sh <config-name>
+```
+
+**If the container isn't running**, go to [§3. Container Lifecycle Issues](#3-container-lifecycle-issues)
+
+**If the container is running but not synced**, go to [§4. Sync Issues](#4-sync-issues)
+
+**If the container is running and synced but RPC fails**, go to [§5. RPC/Connectivity Issues](#5-rpcconnectivity-issues)
+
+**If you see errors in logs but aren't sure what they mean**, go to [§6. Log Interpretation](#6-log-interpretation)
+
+---
+
+## 1. Repository Overview
+
+### What This Repo Contains
+
+```
+rpc/
+├── *.yml                    # Docker Compose files for node configurations
+├── *.sh                     # Operational scripts (YOUR PRIMARY TOOLS)
+├── scripts/                 # Additional helper scripts (CometBFT support)
+├── <network>/               # Network directories (e.g., ethereum/, op/, arb/)
+│   ├── *.yml                # Compose files for specific chains
+│   └── <chain>/             # Chain-specific assets
+│       ├── genesis.json     # Custom genesis files
+│       ├── rollup.json      # Rollup configurations (OP Stack)
+│       └── *.Dockerfile      # Custom build files
+├── README.md                # User documentation
+└── VIBE.md                  # THIS FILE — operations guide
+```
+
+### Key Concepts
+
+- **Config name**: The compose filename WITHOUT `.yml` (e.g., `ethereum-mainnet-geth-pruned`)
+- **Service name**: Derived from config name, used in `docker compose` commands
+- **Short name**: Used in URL paths, container labels. Format: `{network}-{chain}[-{client}][-{db_type}]`
+- **Volume names**: Docker volumes follow the full config name pattern
+
+### Supported Networks
+
+**Layer 1**: Ethereum, Polygon, BSC, Avalanche, Gnosis, Fantom, Core, Berachain, Ronin, Viction, Fuse, Tron, ThunderCore, Goat, AlephZero, Haqq, Taiko, Rootstock, Dogecoin, Litecoin, Bitcoin, Bitcoin-Cash, Ripple, Solana, Tron
+
+**Layer 2 (OP Stack)**: Optimism, Base, Zora, Mode, Blast, Fraxtal, Bob, Boba, Worldchain, Metal, Ink, Lisk, SNAX, Celo
+
+**Layer 2 (Arbitrum)**: Arbitrum One, Arbitrum Nova, Everclear, Playblock, Real, Connext, OpenCampusCodex
+
+**Other L2s**: Linea, Scroll, zkSync Era, Metis, Moonbeam, Starknet, zkEVM, Immutable zkEVM, Polygon zkEVM
+
+---
+
+## 2. Essential Scripts Reference
+
+### Status & Monitoring Scripts
+
+| Script | Usage | What It Does |
+|---|---|---|
+| `show-status.sh` | `[config-name]` | Lists ALL configured nodes with sync status, block height, health |
+| `show-running.sh` | | Lists currently running containers |
+| `sync-status.sh` | `<config-name>` | Detailed sync status for one config |
+| `latest.sh` | `<config-name>` | Latest block number + hash |
+| `logs.sh` | `<config-name>` | Tail logs from all containers in a config |
+| `show-db-size.sh` | | Disk usage of ALL Docker volumes, sorted by size |
+| `show-ram.sh` | `<config-name>` | Memory usage of containers |
+| `show-cpu.sh` | | CPU usage display |
+| `peer-count.sh` | | P2P peer count for all running nodes |
+| `time-since-last-block.sh` | `<config-name>` | How long since last block was processed |
+| `ping.sh` | `<container-name>` | Test network connectivity from container |
+| `show-errors.sh` | | Show error counts/logs across containers |
+| `show-size.sh` | | Show size of containers/volumes |
+| `show-file-size.sh` | | Show static file sizes |
+| `show-static-file-size.sh` | | Show static file sizes (alternative) |
+
+### Lifecycle Management Scripts
+
+| Script | Usage | What It Does |
+|---|---|---|
+| `start.sh` | `<config-name>` | Start all containers for a config |
+| `stop.sh` | `<config-name>` | Stop all containers for a config |
+| `force-recreate.sh` | `<config-name>` | Force recreate containers (keeps volumes) |
+| `rm.sh` | `<config-name>` | Remove containers (keeps volumes) |
+| `delete-volumes.sh` | `<config-name>` | **DESTRUCTIVE** - Remove containers AND volumes |
+| `delete-node-keys.sh` | `<config-name>` | Remove node keys (for re-initialization) |
+
+### Backup & Restore Scripts
+
+| Script | Usage | What It Does |
+|---|---|---|
+| `backup-node.sh` | `<config-name> [url]` | Backup volumes locally or to WebDAV |
+| `restore-volumes.sh` | `<config-name> [url]` | Restore volumes from local or HTTP |
+| `clone-node.sh` | `<config-name>` | Clone a node's state |
+| `clone-backup.sh` | | Clone backup files |
+| `clone-peers.sh` | | Clone peer information |
+| `restore-peers.sh` | | Restore peer connections |
+| `list-backups.sh` | | List available backup files |
+| `list-peer-backups.sh` | | List peer backup files |
+| `list-restorable.sh` | | List restorable configurations |
+| `cleanup-backups.sh` | | Remove old backups |
+| `cleanup-volumes.sh` | | Clean up unused volumes |
+
+### Network & Connectivity Scripts
+
+| Script | Usage | What It Does |
+|---|---|---|
+| `upstreams.sh` | | Generate dshackle upstream configuration |
+| `connect-peers.sh` | | Connect to peer nodes |
+| `search-node.sh` | `<query>` | Search compose files for patterns |
+| `search-compose.sh` | `<query>` | Search compose files |
+| `network-to-config.sh` | | Map network names to config files |
+| `reload_dshackle.sh` | | Reload dshackle configuration |
+| `update-whitelist.sh` | | Update IP whitelist |
+| `update-ip.sh` | | Update IP configuration |
+
+### Specialized Scripts
+
+| Script | Usage | What It Does |
+|---|---|---|
+| `op-wheel.sh` | | OP rollup maintenance (rewind, set forkchoice) |
+| `op-wheel-finalize-latest-block.sh` | `<client_svc> [node_svc]` | Finalize latest block (nuclear option) |
+| `catchup.sh` | `<config-name>` | Help node catch up to chain head |
+| `success-if-almost-synced.sh` | `<config-name> <seconds>` | Exit 0 if node is almost synced |
+| `groq.sh` | | Query using Groq |
+| `trai.sh` | | Trace transaction |
+| `multicurl.sh` | | Parallel curl requests |
+| `blocknumber.sh` | | Get block number |
+| `get-block.sh` | | Get block information |
+| `get-local-url.sh` | | Get local RPC URL |
+| `get-shortname.sh` | `<config-file>` | Get short name for a config |
+| `disk-space.sh` | | Check disk space |
+| `limit-bandwidth.sh` | | Limit bandwidth |
+| `maintenance.sh` | | Maintenance helper |
+| `random-port.sh` | | Generate random port |
+| `reference-rpc-endpoint.sh` | | Reference RPC endpoint helper |
+| `reset-terminal.sh` | | Reset terminal |
+| `setup-bandwidth-limit-cron.sh` | | Setup cron for bandwidth limiting |
+
+---
+
+## 3. Container Lifecycle Issues
+
+### Symptom: Container Won't Start
+
+```bash
+# Check why it failed
+./logs.sh <config-name> 2>&1 | tail -50
+
+# Check container exit code
+docker ps -a --filter "name=<config-name>" --format "{{.Names}} | {{.State}} | {{.Status}}"
+
+# Inspect the container
+docker inspect <container-name> | jq '.[0].State'
+```
+
+**Common causes:**
+- **Port conflict**: Two services trying to bind to same host port
+- **Volume permission issues**: Docker can't write to volume
+- **Missing environment variables**: `.env` file incomplete
+- **Invalid compose syntax**: YAML parsing error
+- **Image pull failure**: Network issue or private registry auth
+
+**Fixes:**
+```bash
+# Check for port conflicts
+grep -h "^[0-9]\{1,5\}:[0-9]" *.yml | sort | uniq -d
+
+# Validate compose syntax
+docker compose -f <config-file>.yml config
+
+# Pull images manually
+docker compose -f <config-file>.yml pull
+
+# Start with --build if using custom Dockerfiles
+docker compose -f <config-file>.yml up -d --build
+```
+
+### Symptom: Container Exits Immediately After Starting
+
+```bash
+# View the last 100 lines of logs before exit
+./logs.sh <config-name> 2>&1 | tail -100
+
+# Check exit code
+docker ps -a --filter "name=<service>" --format "{{.Status}}"
+
+# Run interactively to see error
+docker compose -f <config-file>.yml run --rm <service-name> sh
+```
+
+**Common causes:**
+- **Missing config files**: `/config/` mount empty or wrong path
+- **Invalid flags**: Command-line arguments malformed
+- **Database corruption**: Existing data incompatible with new version
+- **Checkpoint/genesis mismatch**: Chain ID or genesis doesn't match
+
+**Fixes:**
+```bash
+# Verify config directory exists (if using custom configs)
+ls -la <network>/<chain>/
+
+# Try with fresh volumes (DESTRUCTIVE)
+./delete-volumes.sh <config-name>
+./start.sh <config-name>
+```
+
+### Symptom: Container Restarts Repeatedly (Crash Loop)
+
+```bash
+# Watch logs in real-time
+./logs.sh <config-name> -f
+
+# Check restart count
+docker inspect <container-name> | jq '.[0].RestartCount'
+
+# Check last restart reason
+docker inspect <container-name> | jq '.[0].State.ExitCode, .[0].State.Error'
+```
+
+**Common causes:**
+- **OOM killed**: Memory limit exceeded
+- **Out of disk space**: No space left on device
+- **Segmentation fault**: Client bug or bad data
+- **Panic**: Go client panic
+
+**Fixes:**
+```bash
+# Check memory usage
+./show-ram.sh <config-name>
+
+# Check disk space
+df -h /var/lib/docker
+./show-db-size.sh
+
+# Increase resources in compose file or .env
+# Then force recreate
+./force-recreate.sh <config-name>
+```
+
+---
+
+## 4. Sync Issues
+
+### Symptom: Node Not Syncing (Stuck at Block 0 or Low Block)
+
+```bash
+# Check sync status
+./sync-status.sh <config-name>
+
+# Check current block
+./latest.sh <config-name>
+
+# Check logs for sync errors
+./logs.sh <config-name> | grep -i -E "sync|error|fail|warn|stuck|behind"
+
+# Check peer count
+./peer-count.sh | grep <config-name>
+```
+
+**Common causes:**
+- **No peers**: P2P network connection failed
+- **Wrong network**: Connected to wrong chain
+- **Checkpoint too old**: Checkpoint URL unavailable or outdated
+- **Snapshot download failed**: Snapshot server unreachable
+
+**Fixes:**
+```bash
+# Check if checkpoint/snapshot is configured
+grep -E "(checkpoint|snapshot)" <config-file>.yml
+
+# Test checkpoint URL manually
+curl -I $(grep checkpoint <config-file>.yml | grep -oE 'http[^ ]+')
+
+# Check peer connections (geth example)
+docker exec <client-container> admin_peers | jq '.[] | .network.remoteAddress' | wc -l
+```
+
+### Symptom: Sync is Very Slow
+
+```bash
+# Check sync speed over time
+./latest.sh <config-name>; sleep 60; ./latest.sh <config-name>
+
+# Check if node is processing blocks
+./time-since-last-block.sh <config-name>
+
+# Check CPU and memory
+top -d 1 -p $(docker inspect <container> | jq -r '.[0].State.Pid')
+```
+
+**Common causes:**
+- **Resource constrained**: CPU throttled, memory swapped
+- **Disk I/O bottleneck**: Slow storage or contention
+- **Network rate limited**: P2P or RPC rate limiting
+- **Too many peers**: P2P overhead
+- **Wrong sync mode**: Full sync instead of snap sync
+
+### Symptom: Sync Stuck at Specific Block
+
+```bash
+# Check logs around the stuck block
+./logs.sh <config-name> | grep -A 10 -B 10 "block <stuck-block-number>"
+
+# Check if it's a known bad block
+# Search online: <chain> bad block <number>
+```
+
+**Common causes:**
+- **Bad block in chain**: Requires client patch or manual intervention
+- **State trie inconsistency**: Database corruption
+- **Fork choice issue**: Node on wrong fork
+
+**Fixes for OP Stack:**
+```bash
+# Try to finalize past the block
+./op-wheel-finalize-latest-block.sh <client-service>
+```
+
+### Symptom: Node on Wrong Fork / Chain
+
+```bash
+# Check chain ID
+./latest.sh <config-name> | grep -i chain
+
+# Check what chain the node thinks it's on
+docker exec <client-container> ethdo chain --endpoint=http://localhost:8545
+
+# Compare with expected chain ID
+grep chainId <config-file>.yml
+```
+
+---
+
+## 5. RPC/Connectivity Issues
+
+### Symptom: RPC Endpoint Not Responding
+
+```bash
+# Test from host
+curl -s http://localhost:<port> | head -c 100
+
+# Check if traefik/proxy is running
+docker ps | grep -E "(traefik|proxy|nginx)"
+
+# Check traefik logs
+docker logs <traefik-container> | tail -50
+```
+
+**Common causes:**
+- **Container not running**: Client crashed
+- **Port not exposed**: Wrong port mapping
+- **Traefik misconfiguration**: Labels wrong or missing
+- **Firewall blocking**: Host firewall or cloud security group
+
+### Symptom: RPC Returns Wrong Chain ID
+
+```bash
+# Query chain ID from RPC
+curl -s -X POST http://localhost:<port> \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'
+```
+
+### Symptom: Cannot Connect to P2P Network
+
+```bash
+# Check peer count
+./peer-count.sh | grep <config-name>
+
+# Test P2P connectivity from container
+docker exec <client-container> nc -zv <bootstrap-node> <p2p-port>
+```
+
+**Fixes:**
+```bash
+# Set public IP in .env
+IP=$(curl -s ipinfo.io/ip)
+echo "IP=$IP" >> .env
+./force-recreate.sh <config-name>
+```
+
+---
+
+## 6. Log Interpretation
+
+### Common Log Patterns
+
+#### Warnings (Node may still function)
+| Pattern | Meaning | Action |
+|---|---|---|
+| `WARN.*sync.*slow` | Sync slower than expected | Check resources |
+| `WARN.*peers.*low` | Fewer peers than desired | Check P2P connectivity |
+| `WARN.*rate.*limit` | API rate limiting active | Normal for public endpoints |
+
+#### Errors (Node is degraded)
+| Pattern | Meaning | Action |
+|---|---|---|
+| `Error.*database.*corrupt` | Database corruption | Restore from backup or resync |
+| `Error.*handshake.*fail` | P2P handshake failed | Check chain ID |
+| `Error.*no.*peers` | Cannot connect to P2P | Check bootstrap nodes |
+| `Error.*timeout` | RPC/HTTP timeout | Check network, increase timeout |
+
+#### Fatal (Node will not function)
+| Pattern | Meaning | Action |
+|---|---|---|
+| `Fatal.*panic` | Client crashed | Check client version |
+| `Fatal.*OOM` | Out of memory | Increase memory limit |
+| `Fatal.*disk.*full` | No disk space | Free space |
+| `Fatal.*permission.*denied` | Filesystem permissions | Fix volume permissions |
+
+---
+
+## 7. Resource Issues
+
+### High CPU Usage
+```bash
+./show-ram.sh <config-name>
+./show-cpu.sh
+docker stats <container-name> --no-stream
+```
+
+### High Memory Usage
+```bash
+./show-ram.sh <config-name>
+docker stats <container-name> --no-stream --format "{{.Container}} | {{.MemUsage}} | {{.MemPerc}}"
+```
+
+### High Disk Usage
+```bash
+./show-db-size.sh
+docker system df -v
+```
+
+### Disk I/O Bottleneck
+```bash
+iotop -o -d 1
+```
+
+---
+
+## 8. Backup and Restore
+
+### Creating a Backup
+```bash
+# Local backup (to /backup directory)
+./backup-node.sh <config-name>
+
+# Remote backup (to WebDAV)
+./backup-node.sh <config-name> https://backup-server.tld/dav
+```
+
+### Restoring from Backup
+```bash
+# List available backups
+./list-backups.sh
+
+# Restore latest backup for config
+./restore-volumes.sh <config-name>
+
+# Restore from specific URL
+./restore-volumes.sh <config-name> https://backup-server.tld/backup/
+```
+
+### Cloning a Node
+
+```bash
+# Clone a node to a new location
+./clone-node.sh <config-name>
+
+# Clone peers (for faster sync)
+./clone-peers.sh <config-name>
+```
+
+### Nuclear Option: Full Reset
+
+```bash
+# WARNING: This deletes ALL data for the config
+./stop.sh <config-name> && \
+./rm.sh <config-name> && \
+./delete-volumes.sh <config-name> && \
+./delete-node-keys.sh <config-name> && \
+./force-recreate.sh <config-name>
+
+# Then check logs
+./logs.sh <config-name>
+```
+
+---
+
+## 9. Common Error Messages
+
+### Database Errors
+| Error | Cause | Solution |
+|---|---|---|
+| `database is corrupted` | Power loss, bug | Restore from backup or resync |
+| `database version mismatch` | Client version changed | Delete and resync |
+
+### P2P Errors
+| Error | Cause | Solution |
+|---|---|---|
+| `no configured peers` | Missing bootstrap nodes | Add bootstrap nodes |
+| `handshake failed` | Chain ID mismatch | Verify genesis.json |
+
+### RPC Errors
+| Error | Cause | Solution |
+|---|---|---|
+| `method not found` | Wrong client | Use correct client |
+| `connection refused` | Port not open | Check container running, port mapping |
+
+---
+
+## 10. OP Stack Specific Debugging
+
+### OP Node Issues
+
+```bash
+# Check op-node logs
+./logs.sh <config-name> | grep -i "op-node\|rollup\|sequencer"
+
+# Check rollup configuration (if custom)
+cat op/<network>/ethereum/rollup.json | jq .
+
+# Check if rollup.json is mounted
+docker exec <op-node-container> cat /config/rollup.json | jq .
+```
+
+### OP Wheel (Manual Intervention)
+
+```bash
+# Rewind to specific block (DANGEROUS - only if you know what you're doing)
+./op-wheel.sh engine set-forkchoice \
+  --unsafe=<block-hash> \
+  --safe=<block-hash> \
+  --finalized=<block-hash> \
+  --engine=http://<client-service>:8551/ \
+  --engine.open=http://<client-service>:8545 \
+  --engine.jwt-secret-path=/jwtsecret
+
+# Nuclear option: finalize latest local block
+./op-wheel-finalize-latest-block.sh <client-service> <node-service>
+```
+
+---
+
+## 11. CometBFT Family (Cosmos, etc.) Specific
+
+### Init Container Issues
+
+```bash
+# CometBFT chains use init.sh inside the container
+# The master script is at scripts/cometbft-common.sh
+
+# Check if init completed
+./logs.sh <config-name> | grep -i "init\|setup\|complete"
+
+# Check the init script
+cat <network>/<chain>/scripts/init.sh
+```
+
+---
+
+## 12. Quick Start Guide
+
+### Starting a Node
+
+```bash
+# 1. Set up environment
+echo "IP=$(curl -s ipinfo.io/ip)" > .env
+echo "DOMAIN=${IP//./-}.traefik.me" >> .env
+echo "MAIL=your-email@example.com" >> .env
+
+# 2. Select which nodes to run
+# Add compose files to COMPOSE_FILE (colon-separated)
+echo "COMPOSE_FILE=base.yml:rpc.yml:ethereum-mainnet-geth-pruned.yml" >> .env
+
+# 3. Start the node
+docker compose up -d
+
+# 4. Verify it's running
+./show-status.sh
+```
+
+### Accessing Your Node
+
+```bash
+# Once running, access via:
+# HTTP: http://<your-domain>/ethereum-mainnet-geth-pruned
+# HTTPS: https://<your-domain>/ethereum-mainnet-geth-pruned
+# WebSocket: wss://<your-domain>/ethereum-mainnet-geth-pruned
+
+# Or locally (if NO_SSL=true):
+# HTTP: http://localhost:<port>
+```
+
+---
+
+## 13. Configuration Reference
+
+### Environment Variables
+
+**Required for most setups:**
+```bash
+IP=203.0.113.42                    # Your public IP
+DOMAIN=203-0-113-42.traefik.me    # Your domain (traefik.me for testing)
+MAIL=your-email@example.com        # For Let's Encrypt SSL
+WHITELIST=0.0.0.0/0               # IP whitelist (0.0.0.0/0 = all)
+```
+
+**Optional:**
+```bash
+NO_SSL=true                       # Disable SSL (testing only)
+CHAINS_SUBNET=192.168.0.0/26      # Docker network subnet
+```
+
+**Chain-specific (examples):**
+```bash
+ETHEREUM_MAINNET_EXECUTION_RPC=https://fallback-rpc.example.com
+ARBITRUM_SEPOLIA_EXECUTION_RPC=https://arb-sepolia-rpc.example.com
+OP_NODE_NETWORK=mainnet
+OP_NODE_L1_RPC_URL=https://l1-rpc.example.com
+```
+
+### Compose File Structure
+
+Each compose file defines one or more services:
+- **client**: Execution layer (Geth, Erigon, Reth, etc.)
+- **node**: Consensus/derivation node (op-node, lighthouse, etc.)
+- **relay**: DA relay (eigenda-proxy, op-alt, etc.)
+- **proxy**: HTTP/WS proxy (nginx, etc.)
+- **database**: External database (Postgres, etc.)
+
+### Volume Naming
+
+Volumes are named after the config:
+```
+<config-name>_<service>_data
+<config-name>_<service>_config
+```
+
+Example: `ethereum-mainnet-geth-pruned_client_data`
+
+---
+
+## 14. Quick Debugging Checklist
+
+Use this checklist when debugging an issue:
+
+- [ ] **Is the container running?** → `./show-running.sh`
+- [ ] **Are there errors in logs?** → `./logs.sh <config> | grep -i error`
+- [ ] **Is the node synced?** → `./sync-status.sh <config>`
+- [ ] **Are peers connected?** → `./peer-count.sh`
+- [ ] **Are resources adequate?** → `./show-ram.sh`, `./show-db-size.sh`
+- [ ] **Is P2P working?** → Check peer count
+- [ ] **Is RPC responding?** → Test with curl
+- [ ] **Is disk space available?** → `df -h /var/lib/docker`
+- [ ] **Is the config file correct?** → `docker compose -f <file>.yml config`
+- [ ] **Are environment variables set?** → Check `.env`
+- [ ] **Is the genesis file correct?** → Check chain ID
+
+---
+
+## 15. When to Escalate
+
+Escalate to a human operator if:
+
+- [ ] Node stuck for > 2 hours with no progress
+- [ ] Repeated `Fatal` or `panic` errors after restart
+- [ ] Database corruption confirmed
+- [ ] Issue affects multiple nodes across different chains
+- [ ] Need to force-push to this repo
+
+---
+
+## 16. File Locations Quick Reference
+
+| What You Need | Where to Find It |
+|---|---|
+| Compose files | Root of this repo (`*.yml`) |
+| Operational scripts | Root of this repo (`*.sh`) |
+| Chain assets | `<network>/<chain>/` or `<stack>/<network>/<settlement>/` |
+| Genesis files | `<stack>/<network>/<settlement>/genesis.json` |
+| Rollup configs | `op/<network>/<settlement>/rollup.json` |
+| Custom Dockerfiles | `<path>/*.Dockerfile` |
+| Init scripts | `<path>/scripts/init.sh` |
+| CometBFT common | `scripts/cometbft-common.sh` |
+| Compose registry | `compose_registry.json` |
+| RPC endpoints | `reference-rpc-endpoint.json` |
+| Environment | `.env` |
+
+---
+
+## 17. Resource Requirements Reference
+
+| Node Type | Disk | RAM | CPU |
+|---|---|---|---|
+| Ethereum pruned | ~500GB | 8GB | 2+ cores |
+| Ethereum archive | ~2TB+ | 16GB+ | 4+ cores |
+| Ethereum archive-trace | ~4TB+ | 32GB+ | 8+ cores |
+| L2 pruned | ~100-500GB | 4-8GB | 2+ cores |
+| L2 archive | ~1-2TB | 8-16GB | 4+ cores |
+
+**Note:** Requirements vary by chain. Check specific chain documentation.
+
+---
+
+*This file is your complete operations and debugging reference. For additional user documentation, see README.md.*

abstract/external-node/abstract-mainnet-external-node-archive.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   abstract-mainnet-archive:
-    image: ${ABSTRACT_EXTERNAL_NODE_IMAGE:-matterlabs/external-node}:${ABSTRACT_MAINNET_EXTERNAL_NODE_VERSION:-v29.17.0}
+    image: ${ABSTRACT_EXTERNAL_NODE_IMAGE:-matterlabs/external-node}:${ABSTRACT_MAINNET_EXTERNAL_NODE_VERSION:-v31.0.0}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

abstract/external-node/abstract-mainnet-external-node-pruned.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   abstract-mainnet:
-    image: ${ABSTRACT_EXTERNAL_NODE_IMAGE:-matterlabs/external-node}:${ABSTRACT_MAINNET_EXTERNAL_NODE_VERSION:-v29.17.0}
+    image: ${ABSTRACT_EXTERNAL_NODE_IMAGE:-matterlabs/external-node}:${ABSTRACT_MAINNET_EXTERNAL_NODE_VERSION:-v31.0.0}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

abstract/external-node/abstract-testnet-external-node-archive.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   abstract-testnet-archive:
-    image: ${ABSTRACT_EXTERNAL_NODE_IMAGE:-matterlabs/external-node}:${ABSTRACT_TESTNET_EXTERNAL_NODE_VERSION:-v29.17.0}
+    image: ${ABSTRACT_EXTERNAL_NODE_IMAGE:-matterlabs/external-node}:${ABSTRACT_TESTNET_EXTERNAL_NODE_VERSION:-v31.0.0}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

abstract/external-node/abstract-testnet-external-node-pruned.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   abstract-testnet:
-    image: ${ABSTRACT_EXTERNAL_NODE_IMAGE:-matterlabs/external-node}:${ABSTRACT_TESTNET_EXTERNAL_NODE_VERSION:-v29.17.0}
+    image: ${ABSTRACT_EXTERNAL_NODE_IMAGE:-matterlabs/external-node}:${ABSTRACT_TESTNET_EXTERNAL_NODE_VERSION:-v31.0.0}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

arb/nitro/apechain-mainnet-nitro-archive-pebble-hash.yml

@@ -73,7 +73,7 @@ services:
       - --node.feed.input.url=wss://apechain.calderachain.xyz/feed
       - --node.sequencer=false
       - --node.staker.enable=false
-      - --parent-chain.connection.url=${ARBITRUM_ONE_EXECUTION_RPC}
+      - --parent-chain.connection.url=https://arb1.arbitrum.io/rpc
       - --persistent.chain=/root/.arbitrum/apechain-mainnet-archive
       - --persistent.db-engine=pebble
       - --ws.addr=0.0.0.0

arb/nitro/apechain-mainnet-nitro-pruned-pebble-path.yml

@@ -73,7 +73,7 @@ services:
       - --node.feed.input.url=wss://apechain.calderachain.xyz/feed
       - --node.sequencer=false
       - --node.staker.enable=false
-      - --parent-chain.connection.url=${ARBITRUM_ONE_EXECUTION_RPC}
+      - --parent-chain.connection.url=https://arb1.arbitrum.io/rpc
       - --persistent.chain=/root/.arbitrum/apechain-mainnet
       - --persistent.db-engine=pebble
       - --ws.addr=0.0.0.0

arb/nitro/plume-mainnet-nitro-archive-leveldb-hash.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   plume-mainnet-archive:
-    image: ${PLUME_NITRO_IMAGE:-offchainlabs/nitro-node}:${PLUME_MAINNET_NITRO_VERSION:-v3.10.1-d7f07be}
+    image: ${PLUME_NITRO_IMAGE:-offchainlabs/nitro-node}:${PLUME_MAINNET_NITRO_VERSION:-v3.11.0-a618155}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

arb/nitro/plume-mainnet-nitro-archive-pebble-hash.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   plume-mainnet-archive:
-    image: ${PLUME_NITRO_IMAGE:-offchainlabs/nitro-node}:${PLUME_MAINNET_NITRO_VERSION:-v3.10.1-d7f07be}
+    image: ${PLUME_NITRO_IMAGE:-offchainlabs/nitro-node}:${PLUME_MAINNET_NITRO_VERSION:-v3.11.0-a618155}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

arb/nitro/plume-mainnet-nitro-pruned-leveldb-hash.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   plume-mainnet:
-    image: ${PLUME_NITRO_IMAGE:-offchainlabs/nitro-node}:${PLUME_MAINNET_NITRO_VERSION:-v3.10.1-d7f07be}
+    image: ${PLUME_NITRO_IMAGE:-offchainlabs/nitro-node}:${PLUME_MAINNET_NITRO_VERSION:-v3.11.0-a618155}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

arb/nitro/plume-mainnet-nitro-pruned-pebble-path.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   plume-mainnet:
-    image: ${PLUME_NITRO_IMAGE:-offchainlabs/nitro-node}:${PLUME_MAINNET_NITRO_VERSION:-v3.10.1-d7f07be}
+    image: ${PLUME_NITRO_IMAGE:-offchainlabs/nitro-node}:${PLUME_MAINNET_NITRO_VERSION:-v3.11.0-a618155}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

arc/arc/arc-testnet-arc-full.yml

@@ -163,6 +163,7 @@ services:
         condition: service_completed_successfully
       arc-testnet:
         condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

berachain/geth/berachain-bepolia-geth-pruned-pebble-path.yml

@@ -112,7 +112,7 @@ services:
       context: ./berachain
       dockerfile: beacon-kit.Dockerfile
       args:
-        BEACONKIT_VERSION: ${BERACHAIN_BEPOLIA_BEACON_KIT_VERSION:-v1.4.0-rc3}
+        BEACONKIT_VERSION: ${BERACHAIN_BEPOLIA_BEACON_KIT_VERSION:-v1.4.1}
         BEACONKIT_IMAGE: ${BERACHAIN_BEPOLIA_BEACON_KIT_IMAGE:-ghcr.io/berachain/beacon-kit}
     ports:
       - 19888:19888

berachain/reth/berachain-bepolia-reth-archive-trace.yml

@@ -61,7 +61,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   berachain-bepolia-reth:
-    image: ${BERACHAIN_RETH_IMAGE:-ghcr.io/berachain/bera-reth}:${BERACHAIN_BEPOLIA_RETH_VERSION:-v1.4.0}
+    image: ${BERACHAIN_RETH_IMAGE:-ghcr.io/berachain/bera-reth}:${BERACHAIN_BEPOLIA_RETH_VERSION:-v1.4.1}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle
@@ -152,7 +152,7 @@ services:
       context: ./berachain
       dockerfile: beacon-kit.Dockerfile
       args:
-        BEACONKIT_VERSION: ${BERACHAIN_BEPOLIA_BEACON_KIT_VERSION:-v1.4.0-rc3}
+        BEACONKIT_VERSION: ${BERACHAIN_BEPOLIA_BEACON_KIT_VERSION:-v1.4.1}
         BEACONKIT_IMAGE: ${BERACHAIN_BEPOLIA_BEACON_KIT_IMAGE:-ghcr.io/berachain/beacon-kit}
     ports:
       - 16347:16347

berachain/reth/berachain-bepolia-reth-pruned-trace.yml

@@ -61,7 +61,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   berachain-bepolia-reth-pruned:
-    image: ${BERACHAIN_RETH_IMAGE:-ghcr.io/berachain/bera-reth}:${BERACHAIN_BEPOLIA_RETH_VERSION:-v1.4.0}
+    image: ${BERACHAIN_RETH_IMAGE:-ghcr.io/berachain/bera-reth}:${BERACHAIN_BEPOLIA_RETH_VERSION:-v1.4.1}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle
@@ -153,7 +153,7 @@ services:
       context: ./berachain
       dockerfile: beacon-kit.Dockerfile
       args:
-        BEACONKIT_VERSION: ${BERACHAIN_BEPOLIA_BEACON_KIT_VERSION:-v1.4.0-rc3}
+        BEACONKIT_VERSION: ${BERACHAIN_BEPOLIA_BEACON_KIT_VERSION:-v1.4.1}
         BEACONKIT_IMAGE: ${BERACHAIN_BEPOLIA_BEACON_KIT_IMAGE:-ghcr.io/berachain/beacon-kit}
     ports:
       - 17274:17274

bsc/bsc/bsc-chapel-bsc-pruned-pebble-path.yml

@@ -74,7 +74,7 @@ services:
       - --metrics.port=6060
       - --nat=extip:${IP}
       - --port=12759
-      - --rpc.gascap=0
+      - --rpc.gascap=600000000
       - --rpc.txfeecap=0
       - --state.scheme=path
       - --syncmode=snap

bsc/bsc/bsc-mainnet-bsc-minimal-pebble-hash.yml

@@ -80,7 +80,7 @@ services:
       - --metrics.port=6060
       - --nat=extip:${IP}
       - --port=12853
-      - --rpc.gascap=0
+      - --rpc.gascap=600000000
       - --rpc.txfeecap=0
       - --state.scheme=hash
       - --syncmode=full

bsc/bsc/bsc-mainnet-bsc-minimal-pebble-path.yml

@@ -80,7 +80,7 @@ services:
       - --metrics.port=6060
       - --nat=extip:${IP}
       - --port=14596
-      - --rpc.gascap=0
+      - --rpc.gascap=600000000
       - --rpc.txfeecap=0
       - --state.scheme=path
       - --syncmode=snap

bsc/bsc/bsc-mainnet-bsc-pruned-pebble-path--fireeth.yml

@@ -75,7 +75,7 @@ services:
       - --metrics.port=6060
       - --nat=extip:${IP}
       - --port=12037
-      - --rpc.gascap=0
+      - --rpc.gascap=600000000
       - --rpc.txfeecap=0
       - --state.scheme=path
       - --syncmode=full

bsc/bsc/bsc-mainnet-bsc-pruned-pebble-path.yml

@@ -74,7 +74,7 @@ services:
       - --metrics.port=6060
       - --nat=extip:${IP}
       - --port=12037
-      - --rpc.gascap=0
+      - --rpc.gascap=600000000
       - --rpc.txfeecap=0
       - --state.scheme=path
       - --syncmode=snap

bsc/reth/bsc-chapel-reth-archive-trace-triedb.yml

@@ -49,7 +49,7 @@ services:
       args:
         LLVM_IMAGE: ${LLVM_IMAGE:-snowstep/llvm}
         LLVM_VERSION: ${LLVM_VERSION:-20250912105042}
-        RETH_VERSION: ${BSC_CHAPEL_RETH_VERSION:-v0.0.6-beta}
+        RETH_VERSION: ${BSC_CHAPEL_RETH_VERSION:-v0.0.6.3}
         RETH_REPO: ${BSC_CHAPEL_RETH_REPO:-https://github.com/bnb-chain/reth-bsc.git}
         ARCH_TARGET: ${ARCH_TARGET:-native}
         PROFILE: ${RETH_BUILD_PROFILE:-maxperf}

bsc/reth/bsc-chapel-reth-archive-trace.yml

@@ -49,7 +49,7 @@ services:
       args:
         LLVM_IMAGE: ${LLVM_IMAGE:-snowstep/llvm}
         LLVM_VERSION: ${LLVM_VERSION:-20250912105042}
-        RETH_VERSION: ${BSC_CHAPEL_RETH_VERSION:-v0.0.6-beta}
+        RETH_VERSION: ${BSC_CHAPEL_RETH_VERSION:-v0.0.6.3}
         RETH_REPO: ${BSC_CHAPEL_RETH_REPO:-https://github.com/bnb-chain/reth-bsc.git}
         ARCH_TARGET: ${ARCH_TARGET:-native}
         PROFILE: ${RETH_BUILD_PROFILE:-maxperf}

bsc/reth/bsc-chapel-reth-pruned-trace-triedb.yml

@@ -49,7 +49,7 @@ services:
       args:
         LLVM_IMAGE: ${LLVM_IMAGE:-snowstep/llvm}
         LLVM_VERSION: ${LLVM_VERSION:-20250912105042}
-        RETH_VERSION: ${BSC_CHAPEL_RETH_VERSION:-v0.0.6-beta}
+        RETH_VERSION: ${BSC_CHAPEL_RETH_VERSION:-v0.0.6.3}
         RETH_REPO: ${BSC_CHAPEL_RETH_REPO:-https://github.com/bnb-chain/reth-bsc.git}
         ARCH_TARGET: ${ARCH_TARGET:-native}
         PROFILE: ${RETH_BUILD_PROFILE:-maxperf}

bsc/reth/bsc-chapel-reth-pruned-trace.yml

@@ -49,7 +49,7 @@ services:
       args:
         LLVM_IMAGE: ${LLVM_IMAGE:-snowstep/llvm}
         LLVM_VERSION: ${LLVM_VERSION:-20250912105042}
-        RETH_VERSION: ${BSC_CHAPEL_RETH_VERSION:-v0.0.6-beta}
+        RETH_VERSION: ${BSC_CHAPEL_RETH_VERSION:-v0.0.6.3}
         RETH_REPO: ${BSC_CHAPEL_RETH_REPO:-https://github.com/bnb-chain/reth-bsc.git}
         ARCH_TARGET: ${ARCH_TARGET:-native}
         PROFILE: ${RETH_BUILD_PROFILE:-maxperf}

bsc/reth/bsc-mainnet-reth-archive-trace-triedb.yml

@@ -49,7 +49,7 @@ services:
       args:
         LLVM_IMAGE: ${LLVM_IMAGE:-snowstep/llvm}
         LLVM_VERSION: ${LLVM_VERSION:-20250912105042}
-        RETH_VERSION: ${BSC_MAINNET_RETH_VERSION:-v0.0.6-beta}
+        RETH_VERSION: ${BSC_MAINNET_RETH_VERSION:-v0.0.6.3}
         RETH_REPO: ${BSC_MAINNET_RETH_REPO:-https://github.com/bnb-chain/reth-bsc.git}
         ARCH_TARGET: ${ARCH_TARGET:-native}
         PROFILE: ${RETH_BUILD_PROFILE:-maxperf}

bsc/reth/bsc-mainnet-reth-archive-trace.yml

@@ -49,7 +49,7 @@ services:
       args:
         LLVM_IMAGE: ${LLVM_IMAGE:-snowstep/llvm}
         LLVM_VERSION: ${LLVM_VERSION:-20250912105042}
-        RETH_VERSION: ${BSC_MAINNET_RETH_VERSION:-v0.0.6-beta}
+        RETH_VERSION: ${BSC_MAINNET_RETH_VERSION:-v0.0.6.3}
         RETH_REPO: ${BSC_MAINNET_RETH_REPO:-https://github.com/bnb-chain/reth-bsc.git}
         ARCH_TARGET: ${ARCH_TARGET:-native}
         PROFILE: ${RETH_BUILD_PROFILE:-maxperf}

bsc/reth/bsc-mainnet-reth-pruned-trace-triedb.yml

@@ -49,7 +49,7 @@ services:
       args:
         LLVM_IMAGE: ${LLVM_IMAGE:-snowstep/llvm}
         LLVM_VERSION: ${LLVM_VERSION:-20250912105042}
-        RETH_VERSION: ${BSC_MAINNET_RETH_VERSION:-v0.0.6-beta}
+        RETH_VERSION: ${BSC_MAINNET_RETH_VERSION:-v0.0.6.3}
         RETH_REPO: ${BSC_MAINNET_RETH_REPO:-https://github.com/bnb-chain/reth-bsc.git}
         ARCH_TARGET: ${ARCH_TARGET:-native}
         PROFILE: ${RETH_BUILD_PROFILE:-maxperf}

bsc/reth/bsc-mainnet-reth-pruned-trace.yml

@@ -49,7 +49,7 @@ services:
       args:
         LLVM_IMAGE: ${LLVM_IMAGE:-snowstep/llvm}
         LLVM_VERSION: ${LLVM_VERSION:-20250912105042}
-        RETH_VERSION: ${BSC_MAINNET_RETH_VERSION:-v0.0.6-beta}
+        RETH_VERSION: ${BSC_MAINNET_RETH_VERSION:-v0.0.6.3}
         RETH_REPO: ${BSC_MAINNET_RETH_REPO:-https://github.com/bnb-chain/reth-bsc.git}
         ARCH_TARGET: ${ARCH_TARGET:-native}
         PROFILE: ${RETH_BUILD_PROFILE:-maxperf}

core/core/core-buffalo-core-pruned-pebble-path.yml

@@ -70,7 +70,7 @@ services:
       - --maxpeers=50
       - --nat=extip:${IP}
       - --port=12384
-      - --rpc.gascap=0
+      - --rpc.gascap=600000000
       - --rpc.txfeecap=0
       - --state.scheme=path
       - --syncmode=snap

core/core/core-mainnet-core-archive-leveldb-hash.yml

@@ -70,7 +70,7 @@ services:
       - --maxpeers=50
       - --nat=extip:${IP}
       - --port=14234
-      - --rpc.gascap=0
+      - --rpc.gascap=600000000
       - --rpc.txfeecap=0
       - --state.scheme=hash
       - --syncmode=full

core/core/core-mainnet-core-pruned-leveldb-hash.yml

@@ -70,7 +70,7 @@ services:
       - --maxpeers=50
       - --nat=extip:${IP}
       - --port=11169
-      - --rpc.gascap=0
+      - --rpc.gascap=600000000
       - --rpc.txfeecap=0
       - --state.scheme=hash
       - --syncmode=full

core/core/core-pigeon-core-pruned-pebble-path.yml

@@ -70,7 +70,7 @@ services:
       - --nat=extip:${IP}
       - --pigeon
       - --port=14478
-      - --rpc.gascap=0
+      - --rpc.gascap=600000000
       - --rpc.txfeecap=0
       - --state.scheme=path
       - --syncmode=snap

cronos-zkevm/external-node/cronos-zkevm-mainnet-external-node-archive.yml

@@ -33,7 +33,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   cronos-zkevm-mainnet-archive:
-    image: ${CRONOS_ZKEVM_EXTERNAL_NODE_IMAGE:-ghcr.io/cronos-labs/external-node}:${CRONOS_ZKEVM_MAINNET_EXTERNAL_NODE_VERSION:-v29.17.0}
+    image: ${CRONOS_ZKEVM_EXTERNAL_NODE_IMAGE:-ghcr.io/cronos-labs/external-node}:${CRONOS_ZKEVM_MAINNET_EXTERNAL_NODE_VERSION:-v31.0.0}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

cronos-zkevm/external-node/cronos-zkevm-mainnet-external-node-pruned.yml

@@ -33,7 +33,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   cronos-zkevm-mainnet:
-    image: ${CRONOS_ZKEVM_EXTERNAL_NODE_IMAGE:-ghcr.io/cronos-labs/external-node}:${CRONOS_ZKEVM_MAINNET_EXTERNAL_NODE_VERSION:-v29.17.0}
+    image: ${CRONOS_ZKEVM_EXTERNAL_NODE_IMAGE:-ghcr.io/cronos-labs/external-node}:${CRONOS_ZKEVM_MAINNET_EXTERNAL_NODE_VERSION:-v31.0.0}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

cronos-zkevm/external-node/cronos-zkevm-testnet-external-node-archive.yml

@@ -33,7 +33,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   cronos-zkevm-testnet-archive:
-    image: ${CRONOS_ZKEVM_EXTERNAL_NODE_IMAGE:-ghcr.io/cronos-labs/external-node}:${CRONOS_ZKEVM_TESTNET_EXTERNAL_NODE_VERSION:-v29.17.0}
+    image: ${CRONOS_ZKEVM_EXTERNAL_NODE_IMAGE:-ghcr.io/cronos-labs/external-node}:${CRONOS_ZKEVM_TESTNET_EXTERNAL_NODE_VERSION:-v31.0.0}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

cronos-zkevm/external-node/cronos-zkevm-testnet-external-node-pruned.yml

@@ -33,7 +33,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   cronos-zkevm-testnet:
-    image: ${CRONOS_ZKEVM_EXTERNAL_NODE_IMAGE:-ghcr.io/cronos-labs/external-node}:${CRONOS_ZKEVM_TESTNET_EXTERNAL_NODE_VERSION:-v29.17.0}
+    image: ${CRONOS_ZKEVM_EXTERNAL_NODE_IMAGE:-ghcr.io/cronos-labs/external-node}:${CRONOS_ZKEVM_TESTNET_EXTERNAL_NODE_VERSION:-v31.0.0}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

erigon3.Dockerfile

@@ -1,6 +1,6 @@
 # syntax = docker/dockerfile:1.2
 ARG REPO=https://github.com/erigontech/erigon.git
-ARG VERSION=v3.0.7
+ARG VERSION=v3.4.4
 ARG COMMIT=${COMMIT:-${VERSION}}
 
 FROM docker.io/library/golang:1.24.1-alpine3.20 AS builder

ethereum/besu/ethereum-mainnet-besu-pruned-bonsai--nimbus.yml

@@ -114,7 +114,7 @@ services:
       - traefik.http.routers.ethereum-mainnet-besu-pruned-bonsai-ws.middlewares=ethereum-mainnet-besu-pruned-bonsai-stripprefix, ipallowlist
 
   ethereum-mainnet-besu-node:
-    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_MAINNET_NIMBUS_VERSION:-multiarch-v26.5.0}
+    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_MAINNET_NIMBUS_VERSION:-multiarch-v26.6.0}
     user: root
     ports:
       - 18205:18205
@@ -137,7 +137,9 @@ services:
       - --web3-url=http://ethereum-mainnet-besu:8551
     restart: unless-stopped
     depends_on:
-      - ethereum-mainnet-besu
+      ethereum-mainnet-besu:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/erigon3/ethereum-hoodi-erigon3-archive-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ethereum-hoodi-erigon3-archive:
-    image: ${ETHEREUM_ERIGON3_IMAGE:-erigontech/erigon}:${ETHEREUM_HOODI_ERIGON3_VERSION:-v3.4.2}
+    image: ${ETHEREUM_ERIGON3_IMAGE:-erigontech/erigon}:${ETHEREUM_HOODI_ERIGON3_VERSION:-v3.4.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

ethereum/erigon3/ethereum-hoodi-erigon3-minimal-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ethereum-hoodi-erigon3-minimal:
-    image: ${ETHEREUM_ERIGON3_IMAGE:-erigontech/erigon}:${ETHEREUM_HOODI_ERIGON3_VERSION:-v3.4.2}
+    image: ${ETHEREUM_ERIGON3_IMAGE:-erigontech/erigon}:${ETHEREUM_HOODI_ERIGON3_VERSION:-v3.4.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

ethereum/erigon3/ethereum-hoodi-erigon3-pruned-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ethereum-hoodi-erigon3:
-    image: ${ETHEREUM_ERIGON3_IMAGE:-erigontech/erigon}:${ETHEREUM_HOODI_ERIGON3_VERSION:-v3.4.2}
+    image: ${ETHEREUM_ERIGON3_IMAGE:-erigontech/erigon}:${ETHEREUM_HOODI_ERIGON3_VERSION:-v3.4.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

ethereum/erigon3/ethereum-mainnet-erigon3-archive-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ethereum-mainnet-erigon3-archive:
-    image: ${ETHEREUM_ERIGON3_IMAGE:-erigontech/erigon}:${ETHEREUM_MAINNET_ERIGON3_VERSION:-v3.4.2}
+    image: ${ETHEREUM_ERIGON3_IMAGE:-erigontech/erigon}:${ETHEREUM_MAINNET_ERIGON3_VERSION:-v3.4.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

ethereum/erigon3/ethereum-mainnet-erigon3-minimal-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ethereum-mainnet-erigon3-minimal:
-    image: ${ETHEREUM_ERIGON3_IMAGE:-erigontech/erigon}:${ETHEREUM_MAINNET_ERIGON3_VERSION:-v3.4.2}
+    image: ${ETHEREUM_ERIGON3_IMAGE:-erigontech/erigon}:${ETHEREUM_MAINNET_ERIGON3_VERSION:-v3.4.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

ethereum/erigon3/ethereum-mainnet-erigon3-pruned-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ethereum-mainnet-erigon3:
-    image: ${ETHEREUM_ERIGON3_IMAGE:-erigontech/erigon}:${ETHEREUM_MAINNET_ERIGON3_VERSION:-v3.4.2}
+    image: ${ETHEREUM_ERIGON3_IMAGE:-erigontech/erigon}:${ETHEREUM_MAINNET_ERIGON3_VERSION:-v3.4.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

ethereum/erigon3/ethereum-sepolia-erigon3-archive-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ethereum-sepolia-erigon3-archive:
-    image: ${ETHEREUM_ERIGON3_IMAGE:-erigontech/erigon}:${ETHEREUM_SEPOLIA_ERIGON3_VERSION:-v3.4.2}
+    image: ${ETHEREUM_ERIGON3_IMAGE:-erigontech/erigon}:${ETHEREUM_SEPOLIA_ERIGON3_VERSION:-v3.4.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

ethereum/erigon3/ethereum-sepolia-erigon3-minimal-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ethereum-sepolia-erigon3-minimal:
-    image: ${ETHEREUM_ERIGON3_IMAGE:-erigontech/erigon}:${ETHEREUM_SEPOLIA_ERIGON3_VERSION:-v3.4.2}
+    image: ${ETHEREUM_ERIGON3_IMAGE:-erigontech/erigon}:${ETHEREUM_SEPOLIA_ERIGON3_VERSION:-v3.4.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

ethereum/erigon3/ethereum-sepolia-erigon3-pruned-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ethereum-sepolia-erigon3:
-    image: ${ETHEREUM_ERIGON3_IMAGE:-erigontech/erigon}:${ETHEREUM_SEPOLIA_ERIGON3_VERSION:-v3.4.2}
+    image: ${ETHEREUM_ERIGON3_IMAGE:-erigontech/erigon}:${ETHEREUM_SEPOLIA_ERIGON3_VERSION:-v3.4.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

ethereum/geth/ethereum-hoodi-geth-pruned-pebble-path--nimbus.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ethereum-hoodi-geth:
-    image: ${ETHEREUM_GETH_IMAGE:-ethereum/client-go}:${ETHEREUM_HOODI_GETH_VERSION:-v1.17.3}
+    image: ${ETHEREUM_GETH_IMAGE:-ethereum/client-go}:${ETHEREUM_HOODI_GETH_VERSION:-v1.17.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle
@@ -103,7 +103,7 @@ services:
       - traefik.http.routers.ethereum-hoodi-geth-pruned-pebble-path.middlewares=ethereum-hoodi-geth-pruned-pebble-path-stripprefix, ipallowlist
 
   ethereum-hoodi-geth-node:
-    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_HOODI_NIMBUS_VERSION:-multiarch-v26.5.0}
+    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_HOODI_NIMBUS_VERSION:-multiarch-v26.6.0}
     user: root
     ports:
       - 16917:16917
@@ -126,7 +126,9 @@ services:
       - --web3-url=http://ethereum-hoodi-geth:8551
     restart: unless-stopped
     depends_on:
-      - ethereum-hoodi-geth
+      ethereum-hoodi-geth:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/geth/ethereum-hoodi-geth-pruned-pebble-path.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ethereum-hoodi-geth:
-    image: ${ETHEREUM_GETH_IMAGE:-ethereum/client-go}:${ETHEREUM_HOODI_GETH_VERSION:-v1.17.3}
+    image: ${ETHEREUM_GETH_IMAGE:-ethereum/client-go}:${ETHEREUM_HOODI_GETH_VERSION:-v1.17.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle
@@ -127,7 +127,9 @@ services:
       - --rpc-host=0.0.0.0
     restart: unless-stopped
     depends_on:
-      - ethereum-hoodi-geth
+      ethereum-hoodi-geth:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/geth/ethereum-mainnet-geth-minimal-pebble-path.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ethereum-mainnet-geth-minimal:
-    image: ${ETHEREUM_GETH_IMAGE:-ethereum/client-go}:${ETHEREUM_MAINNET_GETH_VERSION:-v1.17.3}
+    image: ${ETHEREUM_GETH_IMAGE:-ethereum/client-go}:${ETHEREUM_MAINNET_GETH_VERSION:-v1.17.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle
@@ -131,7 +131,9 @@ services:
       - --rpc-host=0.0.0.0
     restart: unless-stopped
     depends_on:
-      - ethereum-mainnet-geth-minimal
+      ethereum-mainnet-geth-minimal:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/geth/ethereum-mainnet-geth-pruned-leveldb-hash--nimbus--fireeth.yml

@@ -168,7 +168,7 @@ services:
       - traefik.http.routers.ethereum-mainnet-geth-pruned-leveldb-hash-events.middlewares=ipallowlist
 
   ethereum-mainnet-geth-node:
-    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_MAINNET_NIMBUS_VERSION:-multiarch-v26.5.0}
+    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_MAINNET_NIMBUS_VERSION:-multiarch-v26.6.0}
     user: root
     ports:
       - 15455:15455
@@ -191,7 +191,9 @@ services:
       - --web3-url=http://ethereum-mainnet-geth:8551
     restart: unless-stopped
     depends_on:
-      - ethereum-mainnet-geth
+      ethereum-mainnet-geth:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/geth/ethereum-mainnet-geth-pruned-pebble-path--nimbus--fireeth.yml

@@ -168,7 +168,7 @@ services:
       - traefik.http.routers.ethereum-mainnet-geth-pruned-pebble-path-events.middlewares=ipallowlist
 
   ethereum-mainnet-geth-node:
-    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_MAINNET_NIMBUS_VERSION:-multiarch-v26.5.0}
+    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_MAINNET_NIMBUS_VERSION:-multiarch-v26.6.0}
     user: root
     ports:
       - 17023:17023
@@ -191,7 +191,9 @@ services:
       - --web3-url=http://ethereum-mainnet-geth:8551
     restart: unless-stopped
     depends_on:
-      - ethereum-mainnet-geth
+      ethereum-mainnet-geth:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/geth/ethereum-mainnet-geth-pruned-pebble-path--nimbus.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ethereum-mainnet-geth:
-    image: ${ETHEREUM_GETH_IMAGE:-ethereum/client-go}:${ETHEREUM_MAINNET_GETH_VERSION:-v1.17.3}
+    image: ${ETHEREUM_GETH_IMAGE:-ethereum/client-go}:${ETHEREUM_MAINNET_GETH_VERSION:-v1.17.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle
@@ -103,7 +103,7 @@ services:
       - traefik.http.routers.ethereum-mainnet-geth-pruned-pebble-path.middlewares=ethereum-mainnet-geth-pruned-pebble-path-stripprefix, ipallowlist
 
   ethereum-mainnet-geth-node:
-    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_MAINNET_NIMBUS_VERSION:-multiarch-v26.5.0}
+    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_MAINNET_NIMBUS_VERSION:-multiarch-v26.6.0}
     user: root
     ports:
       - 17023:17023
@@ -126,7 +126,9 @@ services:
       - --web3-url=http://ethereum-mainnet-geth:8551
     restart: unless-stopped
     depends_on:
-      - ethereum-mainnet-geth
+      ethereum-mainnet-geth:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/geth/ethereum-mainnet-geth-pruned-pebble-path.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ethereum-mainnet-geth:
-    image: ${ETHEREUM_GETH_IMAGE:-ethereum/client-go}:${ETHEREUM_MAINNET_GETH_VERSION:-v1.17.3}
+    image: ${ETHEREUM_GETH_IMAGE:-ethereum/client-go}:${ETHEREUM_MAINNET_GETH_VERSION:-v1.17.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle
@@ -127,7 +127,9 @@ services:
       - --rpc-host=0.0.0.0
     restart: unless-stopped
     depends_on:
-      - ethereum-mainnet-geth
+      ethereum-mainnet-geth:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/geth/ethereum-sepolia-geth-pruned-pebble-path--nimbus.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ethereum-sepolia-geth:
-    image: ${ETHEREUM_GETH_IMAGE:-ethereum/client-go}:${ETHEREUM_SEPOLIA_GETH_VERSION:-v1.17.3}
+    image: ${ETHEREUM_GETH_IMAGE:-ethereum/client-go}:${ETHEREUM_SEPOLIA_GETH_VERSION:-v1.17.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle
@@ -103,7 +103,7 @@ services:
       - traefik.http.routers.ethereum-sepolia-geth-pruned-pebble-path.middlewares=ethereum-sepolia-geth-pruned-pebble-path-stripprefix, ipallowlist
 
   ethereum-sepolia-geth-node:
-    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_SEPOLIA_NIMBUS_VERSION:-multiarch-v26.5.0}
+    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_SEPOLIA_NIMBUS_VERSION:-multiarch-v26.6.0}
     user: root
     ports:
       - 19710:19710
@@ -126,7 +126,9 @@ services:
       - --web3-url=http://ethereum-sepolia-geth:8551
     restart: unless-stopped
     depends_on:
-      - ethereum-sepolia-geth
+      ethereum-sepolia-geth:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/geth/ethereum-sepolia-geth-pruned-pebble-path.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   ethereum-sepolia-geth:
-    image: ${ETHEREUM_GETH_IMAGE:-ethereum/client-go}:${ETHEREUM_SEPOLIA_GETH_VERSION:-v1.17.3}
+    image: ${ETHEREUM_GETH_IMAGE:-ethereum/client-go}:${ETHEREUM_SEPOLIA_GETH_VERSION:-v1.17.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle
@@ -127,7 +127,9 @@ services:
       - --sepolia
     restart: unless-stopped
     depends_on:
-      - ethereum-sepolia-geth
+      ethereum-sepolia-geth:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/nethermind/ethereum-hoodie-nethermind-pruned-rocksdb-trace--nimbus.yml

@@ -94,7 +94,7 @@ services:
       - traefik.http.routers.ethereum-hoodie-nethermind-pruned-rocksdb-trace.middlewares=ethereum-hoodie-nethermind-pruned-rocksdb-trace-stripprefix, ipallowlist
 
   ethereum-hoodie-nethermind-node:
-    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_HOODIE_NIMBUS_VERSION:-multiarch-v26.5.0}
+    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_HOODIE_NIMBUS_VERSION:-multiarch-v26.6.0}
     user: root
     ports:
       - 16214:16214
@@ -117,7 +117,9 @@ services:
       - --web3-url=http://ethereum-hoodie-nethermind:8551
     restart: unless-stopped
     depends_on:
-      - ethereum-hoodie-nethermind
+      ethereum-hoodie-nethermind:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/nethermind/ethereum-mainnet-nethermind-pruned-rocksdb-trace--nimbus.yml

@@ -94,7 +94,7 @@ services:
       - traefik.http.routers.ethereum-mainnet-nethermind-pruned-rocksdb-trace.middlewares=ethereum-mainnet-nethermind-pruned-rocksdb-trace-stripprefix, ipallowlist
 
   ethereum-mainnet-nethermind-node:
-    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_MAINNET_NIMBUS_VERSION:-multiarch-v26.5.0}
+    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_MAINNET_NIMBUS_VERSION:-multiarch-v26.6.0}
     user: root
     ports:
       - 17065:17065
@@ -117,7 +117,9 @@ services:
       - --web3-url=http://ethereum-mainnet-nethermind:8551
     restart: unless-stopped
     depends_on:
-      - ethereum-mainnet-nethermind
+      ethereum-mainnet-nethermind:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/nethermind/ethereum-sepolia-nethermind-pruned-rocksdb-trace--nimbus.yml

@@ -94,7 +94,7 @@ services:
       - traefik.http.routers.ethereum-sepolia-nethermind-pruned-rocksdb-trace.middlewares=ethereum-sepolia-nethermind-pruned-rocksdb-trace-stripprefix, ipallowlist
 
   ethereum-sepolia-nethermind-node:
-    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_SEPOLIA_NIMBUS_VERSION:-multiarch-v26.5.0}
+    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_SEPOLIA_NIMBUS_VERSION:-multiarch-v26.6.0}
     user: root
     ports:
       - 15835:15835
@@ -117,7 +117,9 @@ services:
       - --web3-url=http://ethereum-sepolia-nethermind:8551
     restart: unless-stopped
     depends_on:
-      - ethereum-sepolia-nethermind
+      ethereum-sepolia-nethermind:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/reth/ethereum-hoodi-reth-archive-trace.yml

@@ -132,7 +132,9 @@ services:
       - --rpc-host=0.0.0.0
     restart: unless-stopped
     depends_on:
-      - ethereum-hoodi-reth
+      ethereum-hoodi-reth:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/reth/ethereum-hoodi-reth-pruned-trace.yml

@@ -133,7 +133,9 @@ services:
       - --rpc-host=0.0.0.0
     restart: unless-stopped
     depends_on:
-      - ethereum-hoodi-reth-pruned
+      ethereum-hoodi-reth-pruned:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/reth/ethereum-mainnet-reth-archive-trace--lighthouse-pruned-blobs.yml

@@ -108,7 +108,7 @@ services:
     shm_size: 2gb
 
   ethereum-mainnet-reth-node:
-    image: ${ETHEREUM_LIGHTHOUSE_IMAGE:-sigp/lighthouse}:${ETHEREUM_MAINNET_LIGHTHOUSE_VERSION:-v8.1.3}
+    image: ${ETHEREUM_LIGHTHOUSE_IMAGE:-sigp/lighthouse}:${ETHEREUM_MAINNET_LIGHTHOUSE_VERSION:-v8.2.0}
     ports:
       - 19563:19563
       - 19563:19563/udp
@@ -137,7 +137,9 @@ services:
       - --validator-monitor-auto
     restart: unless-stopped
     depends_on:
-      - ethereum-mainnet-reth
+      ethereum-mainnet-reth:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/reth/ethereum-mainnet-reth-archive-trace--nimbus.yml

@@ -108,7 +108,7 @@ services:
     shm_size: 2gb
 
   ethereum-mainnet-reth-node:
-    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_MAINNET_NIMBUS_VERSION:-multiarch-v26.5.0}
+    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_MAINNET_NIMBUS_VERSION:-multiarch-v26.6.0}
     user: root
     ports:
       - 19563:19563
@@ -131,7 +131,9 @@ services:
       - --web3-url=http://ethereum-mainnet-reth:8551
     restart: unless-stopped
     depends_on:
-      - ethereum-mainnet-reth
+      ethereum-mainnet-reth:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/reth/ethereum-mainnet-reth-archive-trace.yml

@@ -132,7 +132,9 @@ services:
       - --rpc-host=0.0.0.0
     restart: unless-stopped
     depends_on:
-      - ethereum-mainnet-reth
+      ethereum-mainnet-reth:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/reth/ethereum-mainnet-reth-minimal-trace--blsync.yml

@@ -123,7 +123,7 @@ services:
       - pruning
 
   ethereum-mainnet-reth-minimal-node:
-    image: ${ETHEREUM_BLSYNC_IMAGE:-ethereum/client-go}:${ETHEREUM_MAINNET_BLSYNC_VERSION:-alltools-v1.17.3}
+    image: ${ETHEREUM_BLSYNC_IMAGE:-ethereum/client-go}:${ETHEREUM_MAINNET_BLSYNC_VERSION:-alltools-v1.17.4}
     ports:
       - 19286:19286
       - 19286:19286/udp
@@ -138,7 +138,9 @@ services:
       - --mainnet
     restart: unless-stopped
     depends_on:
-      - ethereum-mainnet-reth-minimal
+      ethereum-mainnet-reth-minimal:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/reth/ethereum-mainnet-reth-minimal-trace--nimbus.yml

@@ -145,7 +145,7 @@ services:
       - pruning
 
   ethereum-mainnet-reth-minimal-node:
-    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_MAINNET_NIMBUS_VERSION:-multiarch-v26.5.0}
+    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_MAINNET_NIMBUS_VERSION:-multiarch-v26.6.0}
     user: root
     ports:
       - 19286:19286
@@ -168,7 +168,9 @@ services:
       - --web3-url=http://ethereum-mainnet-reth-minimal:8551
     restart: unless-stopped
     depends_on:
-      - ethereum-mainnet-reth-minimal
+      ethereum-mainnet-reth-minimal:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/reth/ethereum-mainnet-reth-pruned-trace--lighthouse.yml

@@ -109,7 +109,7 @@ services:
     shm_size: 2gb
 
   ethereum-mainnet-reth-pruned-node:
-    image: ${ETHEREUM_LIGHTHOUSE_IMAGE:-sigp/lighthouse}:${ETHEREUM_MAINNET_LIGHTHOUSE_VERSION:-v8.1.3}
+    image: ${ETHEREUM_LIGHTHOUSE_IMAGE:-sigp/lighthouse}:${ETHEREUM_MAINNET_LIGHTHOUSE_VERSION:-v8.2.0}
     ports:
       - 15150:15150
       - 15150:15150/udp
@@ -136,7 +136,9 @@ services:
       - --validator-monitor-auto
     restart: unless-stopped
     depends_on:
-      - ethereum-mainnet-reth-pruned
+      ethereum-mainnet-reth-pruned:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/reth/ethereum-mainnet-reth-pruned-trace--nimbus.yml

@@ -109,7 +109,7 @@ services:
     shm_size: 2gb
 
   ethereum-mainnet-reth-pruned-node:
-    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_MAINNET_NIMBUS_VERSION:-multiarch-v26.5.0}
+    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_MAINNET_NIMBUS_VERSION:-multiarch-v26.6.0}
     user: root
     ports:
       - 15150:15150
@@ -132,7 +132,9 @@ services:
       - --web3-url=http://ethereum-mainnet-reth-pruned:8551
     restart: unless-stopped
     depends_on:
-      - ethereum-mainnet-reth-pruned
+      ethereum-mainnet-reth-pruned:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/reth/ethereum-mainnet-reth-pruned-trace.yml

@@ -133,7 +133,9 @@ services:
       - --rpc-host=0.0.0.0
     restart: unless-stopped
     depends_on:
-      - ethereum-mainnet-reth-pruned
+      ethereum-mainnet-reth-pruned:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/reth/ethereum-sepolia-reth-archive-trace--nimbus.yml

@@ -108,7 +108,7 @@ services:
     shm_size: 2gb
 
   ethereum-sepolia-reth-node:
-    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_SEPOLIA_NIMBUS_VERSION:-multiarch-v26.5.0}
+    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_SEPOLIA_NIMBUS_VERSION:-multiarch-v26.6.0}
     user: root
     ports:
       - 19330:19330
@@ -131,7 +131,9 @@ services:
       - --web3-url=http://ethereum-sepolia-reth:8551
     restart: unless-stopped
     depends_on:
-      - ethereum-sepolia-reth
+      ethereum-sepolia-reth:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/reth/ethereum-sepolia-reth-archive-trace.yml

@@ -132,7 +132,9 @@ services:
       - --sepolia
     restart: unless-stopped
     depends_on:
-      - ethereum-sepolia-reth
+      ethereum-sepolia-reth:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/reth/ethereum-sepolia-reth-pruned-trace--nimbus.yml

@@ -109,7 +109,7 @@ services:
     shm_size: 2gb
 
   ethereum-sepolia-reth-pruned-node:
-    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_SEPOLIA_NIMBUS_VERSION:-multiarch-v26.5.0}
+    image: ${ETHEREUM_NIMBUS_IMAGE:-statusim/nimbus-eth2}:${ETHEREUM_SEPOLIA_NIMBUS_VERSION:-multiarch-v26.6.0}
     user: root
     ports:
       - 17150:17150
@@ -132,7 +132,9 @@ services:
       - --web3-url=http://ethereum-sepolia-reth-pruned:8551
     restart: unless-stopped
     depends_on:
-      - ethereum-sepolia-reth-pruned
+      ethereum-sepolia-reth-pruned:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

ethereum/reth/ethereum-sepolia-reth-pruned-trace.yml

@@ -133,7 +133,9 @@ services:
       - --sepolia
     restart: unless-stopped
     depends_on:
-      - ethereum-sepolia-reth-pruned
+      ethereum-sepolia-reth-pruned:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

gnosis/erigon3/gnosis-chiado-erigon3-archive-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   gnosis-chiado-erigon3-archive:
-    image: ${GNOSIS_ERIGON3_IMAGE:-erigontech/erigon}:${GNOSIS_CHIADO_ERIGON3_VERSION:-v3.4.2}
+    image: ${GNOSIS_ERIGON3_IMAGE:-erigontech/erigon}:${GNOSIS_CHIADO_ERIGON3_VERSION:-v3.4.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

gnosis/erigon3/gnosis-chiado-erigon3-minimal-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   gnosis-chiado-erigon3-minimal:
-    image: ${GNOSIS_ERIGON3_IMAGE:-erigontech/erigon}:${GNOSIS_CHIADO_ERIGON3_VERSION:-v3.4.2}
+    image: ${GNOSIS_ERIGON3_IMAGE:-erigontech/erigon}:${GNOSIS_CHIADO_ERIGON3_VERSION:-v3.4.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

gnosis/erigon3/gnosis-chiado-erigon3-pruned-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   gnosis-chiado-erigon3:
-    image: ${GNOSIS_ERIGON3_IMAGE:-erigontech/erigon}:${GNOSIS_CHIADO_ERIGON3_VERSION:-v3.4.2}
+    image: ${GNOSIS_ERIGON3_IMAGE:-erigontech/erigon}:${GNOSIS_CHIADO_ERIGON3_VERSION:-v3.4.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

gnosis/erigon3/gnosis-mainnet-erigon3-archive-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   gnosis-mainnet-erigon3-archive:
-    image: ${GNOSIS_ERIGON3_IMAGE:-erigontech/erigon}:${GNOSIS_MAINNET_ERIGON3_VERSION:-v3.4.2}
+    image: ${GNOSIS_ERIGON3_IMAGE:-erigontech/erigon}:${GNOSIS_MAINNET_ERIGON3_VERSION:-v3.4.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

gnosis/erigon3/gnosis-mainnet-erigon3-minimal-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   gnosis-mainnet-erigon3-minimal:
-    image: ${GNOSIS_ERIGON3_IMAGE:-erigontech/erigon}:${GNOSIS_MAINNET_ERIGON3_VERSION:-v3.4.2}
+    image: ${GNOSIS_ERIGON3_IMAGE:-erigontech/erigon}:${GNOSIS_MAINNET_ERIGON3_VERSION:-v3.4.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

gnosis/erigon3/gnosis-mainnet-erigon3-pruned-trace.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   gnosis-mainnet-erigon3:
-    image: ${GNOSIS_ERIGON3_IMAGE:-erigontech/erigon}:${GNOSIS_MAINNET_ERIGON3_VERSION:-v3.4.2}
+    image: ${GNOSIS_ERIGON3_IMAGE:-erigontech/erigon}:${GNOSIS_MAINNET_ERIGON3_VERSION:-v3.4.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

gnosis/nethermind/gnosis-chiado-nethermind-archive-rocksdb-trace.yml

@@ -119,7 +119,9 @@ services:
       - --web3-url=http://gnosis-chiado-nethermind-archive:8551
     restart: unless-stopped
     depends_on:
-      - gnosis-chiado-nethermind-archive
+      gnosis-chiado-nethermind-archive:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

gnosis/nethermind/gnosis-chiado-nethermind-minimal-rocksdb-trace.yml

@@ -122,7 +122,9 @@ services:
       - --web3-url=http://gnosis-chiado-nethermind-minimal:8551
     restart: unless-stopped
     depends_on:
-      - gnosis-chiado-nethermind-minimal
+      gnosis-chiado-nethermind-minimal:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

gnosis/nethermind/gnosis-chiado-nethermind-pruned-rocksdb-trace.yml

@@ -117,7 +117,9 @@ services:
       - --web3-url=http://gnosis-chiado-nethermind:8551
     restart: unless-stopped
     depends_on:
-      - gnosis-chiado-nethermind
+      gnosis-chiado-nethermind:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

gnosis/nethermind/gnosis-mainnet-nethermind-archive-rocksdb-trace.yml

@@ -119,7 +119,9 @@ services:
       - --web3-url=http://gnosis-mainnet-nethermind-archive:8551
     restart: unless-stopped
     depends_on:
-      - gnosis-mainnet-nethermind-archive
+      gnosis-mainnet-nethermind-archive:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

gnosis/nethermind/gnosis-mainnet-nethermind-minimal-rocksdb-trace.yml

@@ -122,7 +122,9 @@ services:
       - --web3-url=http://gnosis-mainnet-nethermind-minimal:8551
     restart: unless-stopped
     depends_on:
-      - gnosis-mainnet-nethermind-minimal
+      gnosis-mainnet-nethermind-minimal:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

gnosis/nethermind/gnosis-mainnet-nethermind-pruned-rocksdb-trace.yml

@@ -117,7 +117,9 @@ services:
       - --web3-url=http://gnosis-mainnet-nethermind:8551
     restart: unless-stopped
     depends_on:
-      - gnosis-mainnet-nethermind
+      gnosis-mainnet-nethermind:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

gnosis/reth/gnosis-chiado-reth-archive-trace.yml

@@ -131,7 +131,9 @@ services:
       - --web3-url=http://gnosis-chiado-reth:8551
     restart: unless-stopped
     depends_on:
-      - gnosis-chiado-reth
+      gnosis-chiado-reth:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

gnosis/reth/gnosis-chiado-reth-pruned-trace.yml

@@ -132,7 +132,9 @@ services:
       - --web3-url=http://gnosis-chiado-reth-pruned:8551
     restart: unless-stopped
     depends_on:
-      - gnosis-chiado-reth-pruned
+      gnosis-chiado-reth-pruned:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

gnosis/reth/gnosis-mainnet-reth-archive-trace.yml

@@ -131,7 +131,9 @@ services:
       - --web3-url=http://gnosis-mainnet-reth:8551
     restart: unless-stopped
     depends_on:
-      - gnosis-mainnet-reth
+      gnosis-mainnet-reth:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

gnosis/reth/gnosis-mainnet-reth-pruned-trace.yml

@@ -132,7 +132,9 @@ services:
       - --web3-url=http://gnosis-mainnet-reth-pruned:8551
     restart: unless-stopped
     depends_on:
-      - gnosis-mainnet-reth-pruned
+      gnosis-mainnet-reth-pruned:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

goat/geth/goat-mainnet-geth-archive-leveldb-hash.yml

@@ -114,7 +114,9 @@ services:
       - --p2p.laddr=0.0.0.0:17891
     restart: unless-stopped
     depends_on:
-      - goat-mainnet-archive
+      goat-mainnet-archive:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

goat/geth/goat-mainnet-geth-pruned-pebble-path.yml

@@ -114,7 +114,9 @@ services:
       - --p2p.laddr=0.0.0.0:15640
     restart: unless-stopped
     depends_on:
-      - goat-mainnet
+      goat-mainnet:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

goat/geth/goat-testnet3-geth-archive-leveldb-hash.yml

@@ -114,7 +114,9 @@ services:
       - --p2p.laddr=0.0.0.0:19461
     restart: unless-stopped
     depends_on:
-      - goat-testnet3-archive
+      goat-testnet3-archive:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

goat/geth/goat-testnet3-geth-pruned-pebble-path.yml

@@ -114,7 +114,9 @@ services:
       - --p2p.laddr=0.0.0.0:18272
     restart: unless-stopped
     depends_on:
-      - goat-testnet3
+      goat-testnet3:
+        condition: service_started
+        restart: true
     networks:
       - chains
     volumes:

immutable-zkevm/geth/immutable-zkevm-mainnet-geth-pruned-pebble-path.yml

@@ -32,7 +32,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   immutable-zkevm-mainnet-geth:
-    image: ${IMMUTABLE_ZKEVM_GETH_IMAGE:-ethereum/client-go}:${IMMUTABLE_ZKEVM_MAINNET_GETH_VERSION:-v1.17.3}
+    image: ${IMMUTABLE_ZKEVM_GETH_IMAGE:-ethereum/client-go}:${IMMUTABLE_ZKEVM_MAINNET_GETH_VERSION:-v1.17.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

immutable-zkevm/geth/immutable-zkevm-testnet-geth-pruned-pebble-path.yml

@@ -32,7 +32,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   immutable-zkevm-testnet-geth:
-    image: ${IMMUTABLE_ZKEVM_GETH_IMAGE:-ethereum/client-go}:${IMMUTABLE_ZKEVM_TESTNET_GETH_VERSION:-v1.17.3}
+    image: ${IMMUTABLE_ZKEVM_GETH_IMAGE:-ethereum/client-go}:${IMMUTABLE_ZKEVM_TESTNET_GETH_VERSION:-v1.17.4}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

lens/external-node/lens-mainnet-external-node-archive.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   lens-mainnet-archive:
-    image: ${LENS_EXTERNAL_NODE_IMAGE:-matterlabs/external-node}:${LENS_MAINNET_EXTERNAL_NODE_VERSION:-v29.17.0}
+    image: ${LENS_EXTERNAL_NODE_IMAGE:-matterlabs/external-node}:${LENS_MAINNET_EXTERNAL_NODE_VERSION:-v31.0.0}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle

lens/external-node/lens-mainnet-external-node-pruned.yml

@@ -30,7 +30,7 @@ x-logging-defaults: &logging-defaults
 
 services:
   lens-mainnet:
-    image: ${LENS_EXTERNAL_NODE_IMAGE:-matterlabs/external-node}:${LENS_MAINNET_EXTERNAL_NODE_VERSION:-v29.17.0}
+    image: ${LENS_EXTERNAL_NODE_IMAGE:-matterlabs/external-node}:${LENS_MAINNET_EXTERNAL_NODE_VERSION:-v31.0.0}
     sysctls:
       # TCP Performance
       net.ipv4.tcp_slow_start_after_idle: 0       # Disable slow start after idle