test: add comprehensive test coverage and E2E integration tests

.config/nextest.toml

@@ -0,0 +1,25 @@
+[profile.default]
+# Each integration test opens an MDBX environment. macOS limits concurrent
+# memory-mapped files per process. Cap concurrent tests to avoid ENOMEM (error 12).
+test-threads = 4
+
+[profile.ci]
+# GitHub Actions ubuntu-latest has 4 vCPUs / 16GB RAM.
+# Each E2E test spawns a full reth node (MDBX + tokio runtime + rayon pools).
+# Limit to 2 concurrent tests to avoid MDBX resource exhaustion.
+test-threads = 2
+retries = 2
+fail-fast = false
+
+# E2E integration tests spawn full nodes — each needs exclusive MDBX resources.
+# threads-required = 2 means nextest counts each as needing 2 of the test-threads
+# slots, so only 1 runs at a time on CI (2 slots / 2 required = 1 concurrent).
+[[profile.ci.overrides]]
+filter = "package(morph-node) & binary(it)"
+threads-required = 2
+slow-timeout = { period = "120s", terminate-after = 3 }
+
+# Integration tests are heavier — give them more time
+[[profile.default.overrides]]
+filter = "package(morph-node) & binary(it)"
+slow-timeout = { period = "120s", terminate-after = 3 }

.github/workflows/lint.yml

@@ -54,3 +54,6 @@ jobs:
       - name: Run Clippy
         run: cargo clippy --all --all-targets -- -D warnings
 
+      - name: Run Clippy for feature-gated integration tests
+        run: cargo clippy -p morph-node --test it --features test-utils -- -D warnings
+

.github/workflows/test.yml

@@ -61,3 +61,35 @@ jobs:
       - name: Run doc tests
         run: cargo test --doc --all --verbose
 
+  e2e:
+    name: E2E Tests
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    env:
+      RUST_MIN_STACK: 8388608
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache cargo registry
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-e2e-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-e2e-
+
+      - name: Install nextest
+        uses: taiki-e/install-action@v2
+        with:
+          tool: cargo-nextest
+
+      - name: Run E2E tests
+        run: cargo nextest run --profile ci -p morph-node --test it --features test-utils
+

.gitignore

@@ -4,3 +4,4 @@
 
 CLAUDE.md
 
+.worktrees/

crates/chainspec/src/constants.rs

@@ -49,3 +49,54 @@ pub const L2_MESSAGE_QUEUE_ADDRESS: Address = address!("530000000000000000000000
 ///
 /// This is slot 33, which stores the Merkle root for L2->L1 messages.
 pub const L2_MESSAGE_QUEUE_WITHDRAW_TRIE_ROOT_SLOT: U256 = U256::from_limbs([33, 0, 0, 0]);
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn test_chain_ids_are_distinct() {
+        assert_ne!(MORPH_MAINNET_CHAIN_ID, MORPH_HOODI_CHAIN_ID);
+    }
+
+    #[test]
+    fn test_chain_id_values() {
+        assert_eq!(MORPH_MAINNET_CHAIN_ID, 2818);
+        assert_eq!(MORPH_HOODI_CHAIN_ID, 2910);
+    }
+
+    #[test]
+    fn test_genesis_hashes_are_distinct() {
+        assert_ne!(MORPH_MAINNET_GENESIS_HASH, MORPH_HOODI_GENESIS_HASH);
+        assert_ne!(
+            MORPH_MAINNET_GENESIS_STATE_ROOT,
+            MORPH_HOODI_GENESIS_STATE_ROOT
+        );
+    }
+
+    #[test]
+    fn test_genesis_hashes_are_nonzero() {
+        assert_ne!(MORPH_MAINNET_GENESIS_HASH, B256::ZERO);
+        assert_ne!(MORPH_HOODI_GENESIS_HASH, B256::ZERO);
+        assert_ne!(MORPH_MAINNET_GENESIS_STATE_ROOT, B256::ZERO);
+        assert_ne!(MORPH_HOODI_GENESIS_STATE_ROOT, B256::ZERO);
+    }
+
+    #[test]
+    fn test_l2_message_queue_address() {
+        assert_eq!(
+            L2_MESSAGE_QUEUE_ADDRESS,
+            address!("5300000000000000000000000000000000000001")
+        );
+    }
+
+    #[test]
+    fn test_withdraw_trie_root_slot() {
+        assert_eq!(L2_MESSAGE_QUEUE_WITHDRAW_TRIE_ROOT_SLOT, U256::from(33));
+    }
+
+    #[test]
+    fn test_base_fee() {
+        assert_eq!(MORPH_BASE_FEE, 1_000_000);
+    }
+}