feat(ev-dev): part 5 – add interactive TUI dashboard

Cargo.toml

@@ -23,94 +23,94 @@ repository = "https://github.com/evstack/ev-reth"
 authors = ["Evolve Stack Contributors"]
 
 [workspace.dependencies]
-# Reth dependencies - Using v2.1.0 stable
-reth-chainspec = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-cli = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-cli-util = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-rpc-eth-api = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-tracing-otlp = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-node-api = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-node-builder = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-errors = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-trie-db = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-trie-common = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-rpc-eth-types = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
+# Reth dependencies - Using v2.2.0 stable
+reth-chainspec = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-cli = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-cli-util = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-rpc-eth-api = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-tracing-otlp = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-node-api = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-node-builder = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-errors = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-trie-db = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-trie-common = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-rpc-eth-types = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
 reth-primitives-traits = { version = "0.3.0", default-features = false }
-reth-provider = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-storage-api = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-tracing = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-transaction-pool = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0", default-features = false }
-reth-network = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-network-types = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-chain-state = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-db-api = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-ethereum = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-ethereum-cli = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-basic-payload-builder = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-engine-local = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-engine-primitives = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-ethereum-payload-builder = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-ethereum-primitives = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0", features = ["serde", "reth-codec"] }
-reth-e2e-test-utils = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0", default-features = false }
-reth-evm = { git = "https://github.com/paradigmxyz/reth.git", default-features = false, tag = "v2.1.0" }
-reth-evm-ethereum = { git = "https://github.com/paradigmxyz/reth.git", default-features = false, tag = "v2.1.0" }
-reth-execution-types = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-node-core = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-node-types = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-payload-builder = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-payload-builder-primitives = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-payload-primitives = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-ethereum-forks = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-revm = { git = "https://github.com/paradigmxyz/reth.git", default-features = false, tag = "v2.1.0" }
-reth-rpc-api = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-rpc-builder = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-rpc-engine-api = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-rpc = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
-reth-rpc-convert = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0" }
+reth-provider = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-storage-api = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-tracing = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-transaction-pool = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0", default-features = false }
+reth-network = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-network-types = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-chain-state = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-db-api = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-ethereum = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-ethereum-cli = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-basic-payload-builder = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-engine-local = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-engine-primitives = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-ethereum-payload-builder = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-ethereum-primitives = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0", features = ["serde", "reth-codec"] }
+reth-e2e-test-utils = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0", default-features = false }
+reth-evm = { git = "https://github.com/paradigmxyz/reth.git", default-features = false, tag = "v2.2.0" }
+reth-evm-ethereum = { git = "https://github.com/paradigmxyz/reth.git", default-features = false, tag = "v2.2.0" }
+reth-execution-types = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-node-core = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-node-types = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-payload-builder = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-payload-builder-primitives = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-payload-primitives = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-ethereum-forks = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-revm = { git = "https://github.com/paradigmxyz/reth.git", default-features = false, tag = "v2.2.0" }
+reth-rpc-api = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-rpc-builder = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-rpc-engine-api = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-rpc = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
+reth-rpc-convert = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0" }
 reth-codecs = { version = "0.3.1", default-features = false }
 
 ev-revm = { path = "crates/ev-revm" }
 ev-primitives = { path = "crates/ev-primitives" }
 
 
 # Consensus dependencies
-reth-consensus = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0", default-features = false }
-reth-consensus-common = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0", default-features = false }
-reth-ethereum-consensus = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0", default-features = false }
+reth-consensus = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0", default-features = false }
+reth-consensus-common = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0", default-features = false }
+reth-ethereum-consensus = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0", default-features = false }
 
 # Test dependencies
-reth-testing-utils = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0", default-features = false }
-reth-db = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0", default-features = false }
-reth-tasks = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.1.0", default-features = false }
+reth-testing-utils = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0", default-features = false }
+reth-db = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0", default-features = false }
+reth-tasks = { git = "https://github.com/paradigmxyz/reth.git", tag = "v2.2.0", default-features = false }
 
 revm = { version = "38.0.0", default-features = false }
 
-# Alloy dependencies (aligned to reth v2.1.0)
-alloy = { version = "2.0.0", features = [
+# Alloy dependencies (aligned to reth v2.2.0)
+alloy = { version = "2.0.4", features = [
   "contract",
   "providers",
   "provider-http",
   "signers",
   "reqwest-rustls-tls",
 ], default-features = false }
-alloy-evm = { version = "0.33.0", default-features = false }
-alloy-eips = { version = "2.0.0", default-features = false }
-alloy-network = { version = "2.0.0", default-features = false }
-alloy-provider = { version = "2.0.0", default-features = false }
-alloy-rpc-client = { version = "2.0.0", default-features = false }
-alloy-rpc-types = { version = "2.0.0", default-features = false }
-alloy-json-rpc = { version = "2.0.0", default-features = false }
-alloy-rpc-types-eth = { version = "2.0.0", default-features = false }
-alloy-rpc-types-engine = { version = "2.0.0", default-features = false }
-alloy-signer = { version = "2.0.0", default-features = false }
-alloy-signer-local = { version = "2.0.0", features = ["mnemonic"] }
-alloy-serde = { version = "2.0.0", default-features = false }
+alloy-evm = { version = "0.34.0", default-features = false }
+alloy-eips = { version = "2.0.4", default-features = false }
+alloy-network = { version = "2.0.4", default-features = false }
+alloy-provider = { version = "2.0.4", default-features = false }
+alloy-rpc-client = { version = "2.0.4", default-features = false }
+alloy-rpc-types = { version = "2.0.4", default-features = false }
+alloy-json-rpc = { version = "2.0.4", default-features = false }
+alloy-rpc-types-eth = { version = "2.0.4", default-features = false }
+alloy-rpc-types-engine = { version = "2.0.4", default-features = false }
+alloy-signer = { version = "2.0.4", default-features = false }
+alloy-signer-local = { version = "2.0.4", features = ["mnemonic"] }
+alloy-serde = { version = "2.0.4", default-features = false }
 alloy-primitives = { version = "1.5.6", default-features = false }
-alloy-consensus = { version = "2.0.0", default-features = false }
-alloy-consensus-any = { version = "2.0.0", default-features = false }
+alloy-consensus = { version = "2.0.4", default-features = false }
+alloy-consensus-any = { version = "2.0.4", default-features = false }
 alloy-rlp = { version = "0.3.13", default-features = false }
-alloy-genesis = { version = "2.0.0", default-features = false }
-alloy-rpc-types-txpool = { version = "2.0.0", default-features = false }
+alloy-genesis = { version = "2.0.4", default-features = false }
+alloy-rpc-types-txpool = { version = "2.0.4", default-features = false }
 alloy-sol-types = { version = "1.5.6", default-features = false }
 
 # Utility dependencies
@@ -124,7 +124,7 @@ nybbles = "0.4.8"
 # Core dependencies
 eyre = "0.6"
 tracing = "0.1"
-tokio = { version = "1.51", features = ["full"] }
+tokio = { version = "1.52", features = ["full"] }
 serde = { version = "=1.0.228", default-features = false, features = [
   "derive",
 ] }

bin/ev-deployer/README.md

@@ -16,13 +16,12 @@ Both modes read the same TOML config. The `address` field in each contract secti
 ## Quick Start
 
 ```bash
-# 1. Generate a config pre-populated for your chain
-ev-deployer init --chain-id 42170 --permit2 --output deploy.toml
+# Genesis: embed contracts into the chain's genesis state
+ev-deployer init genesis --chain-id 42170 --permit2 --deterministic-deployer --output genesis.toml
+ev-deployer genesis --config genesis.toml --merge-into genesis.json --output genesis-out.json
 
-# 2a. Genesis mode: embed into genesis state
-ev-deployer genesis --config deploy.toml --merge-into genesis.json --output genesis-out.json
-
-# 2b. Deploy mode: deploy to a live chain
+# Deploy: deploy contracts to a running chain via CREATE2
+ev-deployer init deploy --chain-id 42170 --permit2 --output deploy.toml
 ev-deployer deploy \
     --config deploy.toml \
     --rpc-url http://localhost:8545 \
@@ -40,31 +39,55 @@ The binary is output to `target/release/ev-deployer`.
 
 ## Commands
 
-### `init`
+### `init genesis`
 
-Generate a starter config file.
+Generate a starter config for **genesis mode** (contracts embedded at chain start). Includes `address` fields for each contract.
 
 ```bash
 # Bare template (all contracts commented out)
-ev-deployer init
+ev-deployer init genesis
 
-# Pre-populated with chain ID, Permit2, and deterministic deployer
-ev-deployer init --chain-id 42170 --permit2 --deterministic-deployer
+# Pre-populated with Permit2 and deterministic deployer
+ev-deployer init genesis --chain-id 42170 --permit2 --deterministic-deployer
 
 # Full config with all contracts
-ev-deployer init \
+ev-deployer init genesis \
     --chain-id 42170 \
     --permit2 \
+    --deterministic-deployer \
     --admin-proxy-owner 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 \
-    --output deploy.toml
+    --output genesis.toml
 ```
 
 | Flag | Description |
 |------|-------------|
 | `--output <PATH>` | Write to file instead of stdout |
 | `--chain-id <ID>` | Set the chain ID (defaults to 0) |
 | `--permit2` | Enable Permit2 with its canonical address |
-| `--deterministic-deployer` | Enable the deterministic deployer (Nick's factory) with its canonical address |
+| `--deterministic-deployer` | Enable the deterministic deployer (Nick's factory) |
+| `--admin-proxy-owner <ADDR>` | Enable AdminProxy with the given owner |
+
+### `init deploy`
+
+Generate a starter config for **deploy mode** (contracts deployed via CREATE2 to a running chain). No `address` fields — addresses are computed deterministically. The deterministic deployer is not included in the config since it cannot be deployed via CREATE2 (it must already exist on-chain).
+
+```bash
+# Config with Permit2
+ev-deployer init deploy --chain-id 42170 --permit2
+
+# Full config
+ev-deployer init deploy \
+    --chain-id 42170 \
+    --permit2 \
+    --admin-proxy-owner 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 \
+    --output deploy.toml
+```
+
+| Flag | Description |
+|------|-------------|
+| `--output <PATH>` | Write to file instead of stdout |
+| `--chain-id <ID>` | Set the chain ID (defaults to 0) |
+| `--permit2` | Enable Permit2 |
 | `--admin-proxy-owner <ADDR>` | Enable AdminProxy with the given owner |
 
 ### `genesis`
@@ -114,15 +137,17 @@ ev-deployer deploy \
 The deploy pipeline:
 
 1. Connects to the RPC and verifies the chain ID matches the config.
-2. Checks that the deterministic deployer (`0x4e59b44847b379578588920ca78fbf26c0b4956c`) exists on-chain.
+2. Checks that the [deterministic deployer](https://github.com/Arachnid/deterministic-deployment-proxy) (`0x4e59b44847b379578588920ca78fbf26c0b4956c`) exists on-chain.
 3. Deploys each configured contract via CREATE2.
 4. Verifies that the on-chain bytecode matches the expected bytecode (including patched immutables).
 
-The `address` field in the config is **ignored** in deploy mode — addresses come from the CREATE2 computation.
+Permit2 is deployed using the [canonical Uniswap salt](https://github.com/Uniswap/permit2/blob/main/script/DeployPermit2.s.sol), so it lands at its well-known address `0x000000000022D473030F116dDEE9F6B43aC78BA3` on any chain.
+
+> **Using with ev-dev**: The deterministic deployer can be included in the ev-dev genesis via `ev-deployer init genesis --deterministic-deployer`, so `ev-deployer deploy` works against ev-dev. See the [ev-dev README](../ev-dev/README.md#live-contract-deployment-create2) for examples.
 
 #### State file and resumability
 
-The `--state` file tracks deployment progress. On first run it generates a random CREATE2 salt and records which contracts have been deployed. If the process is interrupted, re-running with the same state file resumes where it left off.
+The `--state` file tracks deployment progress and records which contracts have been deployed. If the process is interrupted, re-running with the same state file resumes where it left off. Contracts with well-known salts (e.g. Permit2) use their canonical salt; others use a random salt generated on first run.
 
 Immutability rules protect against accidental misconfiguration on resume:
 

bin/ev-deployer/src/contracts/permit2.rs

@@ -73,6 +73,14 @@ pub(crate) const HASHED_NAME: B256 = B256::new(hex!(
     "9ac997416e8ff9d2ff6bebeb7149f65cdae5e32e2b90440b566bb3044041d36a"
 ));
 
+/// The CREATE2 salt used by Uniswap to deploy Permit2 at its canonical address
+/// (`0x000000000022D473030F116dDEE9F6B43aC78BA3`) via Nick's factory.
+///
+/// Source: <https://github.com/Uniswap/permit2/blob/main/script/DeployPermit2.s.sol>
+pub(crate) const PERMIT2_CANONICAL_SALT: B256 = B256::new(hex!(
+    "0000000000000000000000000000000000000000d3af2663da51c10215000000"
+));
+
 /// Build the expected runtime bytecode for a Permit2 deployed at `address` on `chain_id`.
 /// Used by the deploy pipeline to verify on-chain bytecode matches.
 pub(crate) fn expected_runtime_bytecode(chain_id: u64, address: Address) -> Vec<u8> {

bin/ev-deployer/src/deploy/create2.rs

@@ -62,6 +62,16 @@ mod tests {
         assert_ne!(addr1, addr2);
     }
 
+    #[test]
+    fn permit2_canonical_salt_produces_canonical_address() {
+        use crate::contracts::permit2::{PERMIT2_CANONICAL_SALT, PERMIT2_INITCODE};
+        let addr = compute_address(PERMIT2_CANONICAL_SALT, PERMIT2_INITCODE);
+        let expected: Address = "0x000000000022D473030F116dDEE9F6B43aC78BA3"
+            .parse()
+            .unwrap();
+        assert_eq!(addr, expected);
+    }
+
     #[test]
     fn factory_calldata_format() {
         let salt = B256::with_last_byte(0x42);

bin/ev-deployer/src/deploy/mod.rs

@@ -1,3 +1,5 @@
+//! On-chain deployment pipeline: CREATE2 addressing, state tracking, and orchestration.
+
 pub mod create2;
 pub mod deployer;
 pub mod pipeline;