feat(l1): add interactive REPL

Cargo.toml

@@ -23,6 +23,7 @@ members = [
   "crates/vm/levm",
   "crates/vm/levm/runner",
   "crates/common/config",
+  "tooling/repl",
   "test",
 ]
 exclude = ["crates/vm/levm/bench/revm_comparison"]
@@ -74,6 +75,7 @@ ethrex-guest-program = { path = "./crates/guest-program" }
 ethrex-storage-rollup = { path = "./crates/l2/storage" }
 ethrex = { path = "./cmd/ethrex" }
 ethrex-l2-rpc = { path = "./crates/l2/networking/rpc" }
+ethrex-repl = { path = "./tooling/repl" }
 
 tracing = { version = "0.1", features = ["log"] }
 tracing-subscriber = { version = "0.3.0", features = ["env-filter"] }

cmd/ethrex/Cargo.toml

@@ -20,6 +20,7 @@ ethrex-l2-common = { workspace = true, optional = true }
 ethrex-l2-rpc = { workspace = true, optional = true }
 ethrex-metrics = { path = "../../crates/blockchain/metrics" }
 ethrex-p2p.workspace = true
+ethrex-repl.workspace = true
 ethrex-prover = { workspace = true, optional = true, features = ["l2"] }
 ethrex-rlp.workspace = true
 ethrex-rpc.workspace = true

cmd/ethrex/cli.rs

@@ -454,6 +454,20 @@ pub enum Subcommand {
         )]
         genesis_path: PathBuf,
     },
+    #[command(name = "repl", about = "Interactive REPL for Ethereum JSON-RPC")]
+    Repl {
+        /// JSON-RPC endpoint URL
+        #[arg(short = 'e', long, default_value = "http://localhost:8545")]
+        endpoint: String,
+
+        /// Path to command history file
+        #[arg(long, default_value = "~/.ethrex/history")]
+        history_file: String,
+
+        /// Execute a single command and exit
+        #[arg(short = 'x', long)]
+        execute: Option<String>,
+    },
     #[cfg(feature = "l2")]
     #[command(name = "l2")]
     L2(crate::l2::L2Command),
@@ -532,6 +546,13 @@ impl Subcommand {
                 let state_root = genesis.compute_state_root();
                 println!("{state_root:#x}");
             }
+            Subcommand::Repl {
+                endpoint,
+                history_file,
+                execute,
+            } => {
+                ethrex_repl::run(endpoint, history_file, execute).await;
+            }
             #[cfg(feature = "l2")]
             Subcommand::L2(command) => command.run().await?,
         }