feat: --debug.etherscan for fake consensus client

Cargo.toml

@@ -18,6 +18,8 @@ members = [
     "crates/consensus/beacon/",
     "crates/consensus/common/",
     "crates/consensus/consensus/",
+    "crates/consensus/debug-client/",
+    "crates/ethereum-forks/",
     "crates/e2e-test-utils/",
     "crates/engine-primitives/",
     "crates/errors/",
@@ -246,6 +248,7 @@ reth-codecs-derive = { path = "crates/storage/codecs/derive" }
 reth-config = { path = "crates/config" }
 reth-consensus = { path = "crates/consensus/consensus" }
 reth-consensus-common = { path = "crates/consensus/common" }
+reth-consensus-debug-client = { path = "crates/consensus/debug-client" }
 reth-db = { path = "crates/storage/db", default-features = false }
 reth-db-api = { path = "crates/storage/db-api" }
 reth-db-common = { path = "crates/storage/db-common" }

book/cli/reth/node.md

@@ -463,6 +463,12 @@ Debug:
       --debug.max-block <MAX_BLOCK>
           Runs the sync only up to the specified block
 
+      --debug.etherscan [<ETHERSCAN_API_URL>]
+          Runs a fake consensus client that advances the chain using recent block hashes on Etherscan. If specified, requires an `ETHERSCAN_API_KEY` environment variable
+
+      --debug.rpc-consensus-ws <RPC_CONSENSUS_WS>
+          Runs a fake consensus client using blocks fetched from an RPC `WebSocket` endpoint
+
       --debug.skip-fcu <SKIP_FCU>
           If provided, the engine will skip `n` consecutive FCUs
 

crates/consensus/debug-client/Cargo.toml

@@ -0,0 +1,34 @@
+[package]
+name = "reth-consensus-debug-client"
+version.workspace = true
+edition.workspace = true
+rust-version.workspace = true
+license.workspace = true
+homepage.workspace = true
+repository.workspace = true
+
+[lints]
+workspace = true
+
+[dependencies]
+# reth
+reth-node-api.workspace = true
+reth-node-core.workspace = true
+reth-rpc-api.workspace = true
+reth-rpc-types.workspace = true
+reth-rpc-builder.workspace = true
+reth-tracing.workspace = true
+
+# ethereum
+alloy-consensus = { workspace = true, features = ["serde"] }
+alloy-eips.workspace = true
+alloy-provider = { workspace = true, features = ["ws"] }
+
+auto_impl.workspace = true
+futures.workspace = true
+eyre.workspace = true
+reqwest = { workspace = true, features = ["rustls-tls", "json"] }
+serde = { workspace = true, features = ["derive"] }
+tokio = { workspace = true, features = ["time"] }
+
+ringbuffer = "0.15.0"