feat(ci,evm_transition_tool): Add EthereumJS

.github/actions/build-evm-base/action.yaml

@@ -62,3 +62,9 @@ runs:
       with:
         repo: ${{ steps.config-evm-reader.outputs.repo }}
         ref: ${{ steps.config-evm-reader.outputs.ref }}
+    - name: Build the EVM using EthJS action
+      if: steps.config-evm-reader.outputs.impl == 'ethjs'
+      uses: ./.github/actions/build-evm-client/ethjs
+      with:
+        repo: ${{ steps.config-evm-reader.outputs.repo }}
+        ref: ${{ steps.config-evm-reader.outputs.ref }}

.github/actions/build-evm-client/ethjs/action.yml

@@ -0,0 +1,36 @@
+name: 'Build EthereumJS monorepo'
+description: 'Builds the EthereumJS monorepo'
+inputs:
+  repo:
+    description: 'Source repository to use to build EthereumJS'
+    required: true
+    default: 'ethereumjs/ethereumjs-monorepo'
+  ref:
+    description: 'Reference to branch, commit, or tag to use to build EthereumJS'
+    required: true
+    default: 't8ntool'
+runs:
+  using: "composite"
+  steps:
+    - name: Checkout EthereumJS monorepo
+      uses: actions/checkout@v4
+      with:
+        repository: ${{ inputs.repo }}
+        ref: ${{ inputs.ref }}
+        path: ethereumjs
+
+    - name: Setup node
+      uses: actions/setup-node@v4
+      with:
+        node-version: 18
+
+    - name: Build monorepo
+      run: |
+        cd $GITHUB_WORKSPACE/ethereumjs
+        npm ci
+
+    - name: Add t8ntool to $PATH
+      shell: bash
+      run: |
+        echo $GITHUB_WORKSPACE/ethereumjs/packages/vm/test/t8n/ >> $GITHUB_PATH
+        echo $GITHUB_WORKSPACE/ethereumjs/node_modules/.bin >> $GITHUB_PATH

.github/configs/evm-impl.yaml

@@ -6,4 +6,7 @@ evmone:
   x-dist: auto
 besu:
   evm-bin: evmtool
-  x-dist: 0
+  x-dist: 0
+ethjs:
+  evm-bin: ethereumjs-t8ntool.sh
+  x-dist: auto

.github/configs/evm.yaml

@@ -13,4 +13,8 @@ eip7692:
 eip7692-prague:
   impl: besu
   repo: hyperledger/besu
-  ref: main
+  ref: main
+pectra-devnet-3:
+  impl: ethjs
+  repo: ethereumjs/ethereumjs-monorepo
+  ref: t8ntool

.github/configs/feature.yaml

@@ -13,4 +13,8 @@ eip7692:
 eip7692-prague:
   evm-type: eip7692-prague
   fill-params: --fork=PragueEIP7692 ./tests/prague -k "not slow"
+  solc: 0.8.21
+pectra-devnet-3:
+  evm-type: pectra-devnet-3
+  fill-params: --fork=Prague -k "not slow"
   solc: 0.8.21

src/evm_transition_tool/__init__.py

@@ -3,6 +3,7 @@
 """
 
 from .besu import BesuTransitionTool
+from .ethereumjs import EthereumJSTransitionTool
 from .evmone import EvmOneTransitionTool
 from .execution_specs import ExecutionSpecsTransitionTool
 from .geth import GethTransitionTool
@@ -14,6 +15,7 @@
 
 __all__ = (
     "BesuTransitionTool",
+    "EthereumJSTransitionTool",
     "EvmOneTransitionTool",
     "ExecutionSpecsTransitionTool",
     "GethTransitionTool",

src/evm_transition_tool/ethereumjs.py

@@ -0,0 +1,40 @@
+"""
+EthereumJS Transition tool interface.
+"""
+from pathlib import Path
+from re import compile
+from typing import Optional
+
+from ethereum_test_forks import Fork
+
+from .transition_tool import TransitionTool
+
+
+class EthereumJSTransitionTool(TransitionTool):
+    """
+    EthereumJS Transition tool interface wrapper class.
+    """
+
+    default_binary = Path("ethereumjs-t8ntool.sh")
+    detect_binary_pattern = compile(r"^ethereumjs t8n\b")
+    version_flag: str = "--version"
+    t8n_use_stream = False
+
+    binary: Path
+    cached_version: Optional[str] = None
+    trace: bool
+
+    def __init__(
+        self,
+        *,
+        binary: Optional[Path] = None,
+        trace: bool = False,
+    ):
+        super().__init__(binary=binary, trace=trace)
+
+    def is_fork_supported(self, fork: Fork) -> bool:
+        """
+        Returns True if the fork is supported by the tool.
+        Currently, EthereumJS-t8n provides no way to determine supported forks.
+        """
+        return True