feat(evm): bump reth to v2.4.0 and support revmc JIT execution

.github/scripts/install_llvm.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+set -eo pipefail
+
+os=${1:?usage: install_llvm.sh <ubuntu> [version]}
+version=${2:-22}
+script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+case "$os" in
+    ubuntu)
+        sudo "$script_dir/install_llvm_ubuntu.sh" "$version"
+        ;;
+    *)
+        echo "unsupported OS: $os" >&2
+        exit 1
+        ;;
+esac

.github/scripts/install_llvm_ubuntu.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+set -eo pipefail
+
+version=${1:-22}
+bins=(clang llvm-config lld ld.lld FileCheck)
+
+# The official installer needs this package on Debian bookworm but not on newer distributions.
+apt-get update -qq
+apt-get install -y --no-install-recommends \
+    lsb-release wget gnupg ca-certificates
+apt-get install -y --no-install-recommends software-properties-common 2>/dev/null || true
+
+llvm_installer=$(mktemp)
+wget -qO "$llvm_installer" https://apt.llvm.org/llvm.sh
+# Pin the upstream installer so CI and Docker builds fail loudly when it changes; review the new
+# script before updating this hash.
+echo "9474ecd78b52aba6e923976b1e9773f5613027cc7e237b9956986cb536e02a36  $llvm_installer" | sha256sum -c -
+chmod +x "$llvm_installer"
+"$llvm_installer" "$version" all
+rm -f "$llvm_installer"
+
+for bin in "${bins[@]}"; do
+    if ! command -v "$bin-$version" &>/dev/null; then
+        echo "Error: $bin-$version not found after install" >&2
+        exit 1
+    fi
+    ln -fs "$(command -v "$bin-$version")" "/usr/bin/$bin"
+done
+
+echo "LLVM $version installed:"
+llvm-config --version

.github/workflows/ci.yml

@@ -16,11 +16,12 @@ jobs:
     name: test
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: rui314/setup-mold@v1
+      - run: .github/scripts/install_llvm.sh ubuntu
       - uses: dtolnay/rust-toolchain@master
         with:
-          toolchain: 1.94.0
+          toolchain: 1.95.0
       - uses: Swatinem/rust-cache@v2
         with:
           cache-on-failure: true
@@ -40,7 +41,7 @@ jobs:
       - uses: rui314/setup-mold@v1
       - uses: dtolnay/rust-toolchain@master
         with:
-          toolchain: 1.94.0
+          toolchain: 1.95.0
           components: rustfmt
       - uses: extractions/setup-just@v2
         with:
@@ -54,9 +55,10 @@ jobs:
     steps:
       - uses: actions/checkout@v5
       - uses: rui314/setup-mold@v1
+      - run: .github/scripts/install_llvm.sh ubuntu
       - uses: dtolnay/rust-toolchain@master
         with:
-          toolchain: 1.94.0
+          toolchain: 1.95.0
           components: clippy
       - uses: Swatinem/rust-cache@v2
         with:
@@ -65,3 +67,31 @@ jobs:
         with:
           just-version: 1.5.0
       - run: just clippy
+
+  check-no-jit:
+    name: check (no default features)
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v5
+      - uses: rui314/setup-mold@v1
+      # LLVM is deliberately not installed: this proves the interpreter-only build stays free
+      # of the LLVM toolchain dependency.
+      - uses: dtolnay/rust-toolchain@master
+        with:
+          toolchain: 1.95.0
+      - uses: Swatinem/rust-cache@v2
+        with:
+          cache-on-failure: true
+      - run: cargo check --locked -p alethia-reth-bin --no-default-features
+
+  llvm-arm64:
+    name: llvm install (linux/arm64)
+    runs-on: ubuntu-24.04-arm
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v5
+      # Guards the Docker build on ARM64 hosts: apt.llvm.org omits arm64 packages for some
+      # Debian releases (bookworm has no arm64 LLVM 22), which only surfaces when installing
+      # on an ARM64 machine. Runs the same installer inside the Docker base distribution.
+      - run: docker run --rm -v "$PWD/.github/scripts:/scripts:ro" debian:trixie /scripts/install_llvm_ubuntu.sh

CLAUDE.md

@@ -8,8 +8,9 @@ Alethia-Reth is a Rust execution client for the Taiko protocol, built atop Parad
 
 ## Key Technologies
 
-- Language: Rust (`1.93.1` toolchain via `rust-toolchain.toml` / `justfile`)
-- Framework: Reth v2.0.0 APIs (`reth_node_builder`, `reth_rpc`, `reth_engine_primitives`, etc.)
+- Language: Rust (`1.95.0` toolchain via `rust-toolchain.toml` / `justfile`)
+- Framework: Reth v2.4.0 APIs (`reth_node_builder`, `reth_rpc`, `reth_engine_primitives`, etc.)
+- Optional revmc JIT execution (`jit` feature, on by default in the binary; needs LLVM 22)
 - Target protocol: Taiko rollup networks
 - Build & dependency manager: Cargo + `just`
 
@@ -25,7 +26,7 @@ Alethia-Reth is a Rust execution client for the Taiko protocol, built atop Parad
     ├── cli            CLI wrapper (`TaikoCli`)
     ├── consensus      Beacon consensus extensions
     ├── db             Taiko-specific tables & codecs
-    ├── evm            EVM config, handlers, execution helpers
+    ├── evm            EVM config, handlers, execution helpers, revmc JIT integration
     ├── payload        Payload builder service
     ├── primitives     Shared types (engine, payload attributes)
     ├── rpc            Taiko RPC (eth / engine / auth)