Merge forks/osaka into mainnet

.github/ISSUE_TEMPLATE/eip-tracker.md

@@ -0,0 +1,58 @@
+---
+name: EIP Implementation Tracker
+about: Track specification and testing progress for an EIP
+title: 'EIP-<eip-number> Implementation Tracker'
+labels: A-spec-specs, A-spec-tests, C-eip, C-test
+assignees: ''
+
+---
+
+## [EIP-<eip-number>](https://eips.ethereum.org/EIPS/eip-<eip-number>)
+
+### Target Fork
+
+**<fork>**
+
+### Instructions
+
+- [ ] Assign issue to EIP specification and testing owner(s).
+
+> [!IMPORTANT]
+> A specifications specialist and a testing specialist should ideally share ownership of the EIP.
+
+- [ ] Add the issue to the target fork milestone if applicable (i.e., the EIP is at least in the [CFI stage](https://eips.ethereum.org/EIPS/eip-7723#considered-for-inclusion)).
+
+#### Guidance for Marking Items Complete
+
+An item should only be checked off once the EIP is considered *stable*. In this context, stable means:
+
+- No major issues or ambiguities are still being uncovered in the specification or tests.
+- There are no open discussion points awaiting resolution.
+- Client implementations have been consistently passing the tests for at least a week.
+
+It is ultimately up to the owners' discretion to decide when an item should be marked as complete, using this guidance as the basis for that decision.
+
+In exceptional cases, an EIP may require changes after some items have been marked complete or even after the entire issue has been completed and closed. This can happen, for example, when significant design optimizations are identified and agreed upon in ACD, or when critical security issues surface and require updates to the specification or tests.
+
+When this occurs, owners should either unmark the relevant checkboxes if the issue is still open, or create a new tracking issue for the modifications if the original issue had already been closed.
+
+### Specification + Testing Status
+
+- [ ] Testing complexity assessed and documented.
+- [ ] Specification implementation merged to `eips/<fork>/eip-<eip-number>` *(skip if the fork branch merge below is already complete)*.
+- [ ] Specification updates merged to the corresponding `forks/<fork>` branch.
+- [ ] EIP updates proposed in case of architectural choices surfaced during implementation.
+- [ ] Required testing framework modifications implemented.
+- [ ] Test suite implemented.
+- [ ] Full code coverage for all changes.
+- [ ] No regressions or failures in tests from prior forks (including static tests).
+- [ ] [Testing checklist](https://github.com/ethereum/execution-specs/blob/HEAD/docs/writing_tests/checklist_templates/eip_testing_checklist_template.md) complete.
+- [ ] Hardening session completed.
+- [ ] Benchmarking tests written and results documented.
+- [ ] Ran tests using `execute` to ensure compatibility, and marked specific tests to be skipped when they cannot be executed on live networks.
+- [ ] Added Mainnet-marked tests ([example test](https://github.com/ethereum/execution-specs/blob/2a6f9ee98ba7c0d04c7d523a0ea0ee8a98a5c418/tests/osaka/eip7939_count_leading_zeros/test_eip_mainnet.py)).
+
+### Process Status
+
+- [ ] Hive tests passing on at least two implementations.
+- [ ] EIP included in a devnet.

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,9 +1,25 @@
-### What was wrong?
+## 🗒️ Description
+<!-- Brief description of the changes introduced by this PR -->
+<!-- Don't submit this PR if it could expose a mainnet bug, see SECURITY.md in the repo root for details -->
 
-Related to Issue #
+## 🔗 Related Issues or PRs
+<!-- Reference any related issues using the GitHub issue number (e.g., Fixes #123). Default is N/A. -->
+N/A.
 
-### How was it fixed?
+## ✅ Checklist
+<!-- Please check off all required items. For those that don't apply remove them accordingly. -->
 
+- [ ] All: Ran fast `tox` checks to avoid unnecessary CI fails, see also [Code Standards](https://eest.ethereum.org/main/getting_started/code_standards/) and [Enabling Pre-commit Checks](https://eest.ethereum.org/main/dev/precommit/):
+    ```console
+    uvx tox -e static
+    ```
+- [ ] All: PR title adheres to the [repo standard](https://eest.ethereum.org/main/getting_started/contributing/?h=contri#commit-messages-issue-and-pr-titles) - it will be used as the squash commit message and should start `type(scope):`.
+- [ ] All: Considered adding an entry to [CHANGELOG.md](/ethereum/execution-spec-tests/blob/main/docs/CHANGELOG.md).
+- [ ] All: Considered updating the online docs in the [./docs/](/ethereum/execution-spec-tests/blob/main/docs/) directory.
+- [ ] All: Set appropriate labels for the changes (only maintainers can apply labels).
+- [ ] Tests: Ran `mkdocs serve` locally and verified the auto-generated docs for new tests in the [Test Case Reference](https://eest.ethereum.org/main/tests/) are correctly formatted.
+- [ ] Tests: For PRs implementing a missed test case, update the [post-mortem document](/ethereum/execution-spec-tests/blob/main/docs/writing_tests/post_mortems.md) to add an entry the list.
+- [ ] Ported Tests: All converted JSON/YML tests from [ethereum/tests](/ethereum/tests) or [tests/static](/ethereum/execution-spec-tests/blob/main/tests/static) have been assigned `@ported_from` marker.
 
 #### Cute Animal Picture
 

.github/actions/build-benchmark-genesis/action.yaml

@@ -0,0 +1,69 @@
+name: Build Benchmark Genesis Asset
+description: Generate benchmark_genesis.tar.gz from benchmark fixtures using Hive
+inputs:
+  fixtures_path:
+    description: "Path to the benchmark fixtures tarball"
+    required: true
+outputs:
+  genesis_tarball:
+    description: "Path to the generated benchmark_genesis.tar.gz"
+    value: ${{ steps.create-tarball.outputs.path }}
+runs:
+  using: "composite"
+  steps:
+    - name: Checkout Hive
+      uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      with:
+        repository: ethereum/hive
+        ref: master
+        path: hive
+
+    - name: Setup Go for Hive
+      uses: actions/setup-go@d35c59abb061a4a6fb18e82ac0862c26744d6ab5 # v5.5.0
+      with:
+        go-version: ">=1.24"
+        cache-dependency-path: hive/go.sum
+
+    - name: Build Hive
+      shell: bash
+      run: |
+        cd hive
+        go build .
+
+    - name: Extract benchmark fixtures
+      shell: bash
+      run: |
+        echo "Extracting fixtures from ${{ inputs.fixtures_path }}"
+        tar -xzf "${{ inputs.fixtures_path }}"
+        echo "Fixtures extracted successfully"
+
+    - name: Start Hive in dev mode
+      id: start-hive
+      uses: ./.github/actions/start-hive-dev
+      with:
+        clients: besu,go-ethereum,nethermind
+        client-file: .github/configs/hive/latest.yaml
+        hive-path: hive
+
+    - name: Extract genesis configs
+      shell: bash
+      env:
+        HIVE_SIMULATOR: ${{ steps.start-hive.outputs.hive-url }}
+      run: |
+        echo "Running extract_config for benchmark fixtures..."
+        uv run extract_config \
+          --fixture fixtures/blockchain_tests_engine_x/pre_alloc/ \
+          --output genesis/ \
+          --hive-url $HIVE_SIMULATOR
+
+        echo "Genesis configs extracted successfully"
+        ls -la genesis/
+
+    - name: Create benchmark_genesis.tar.gz
+      id: create-tarball
+      shell: bash
+      run: |
+        tar czf benchmark_genesis.tar.gz genesis/
+        echo "Created benchmark_genesis.tar.gz"
+        ls -lh benchmark_genesis.tar.gz
+        echo "path=benchmark_genesis.tar.gz" >> "$GITHUB_OUTPUT"

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

@@ -0,0 +1,76 @@
+name: 'Build EVM'
+description: 'Resolves and builds the requested EVM binary by name'
+inputs:
+  type:
+    description: 'Type of EVM binary to build'
+    required: true
+    default: 'main'
+outputs:
+  impl:
+    description: "Implementation of EVM binary to build"
+    value: ${{ steps.config-evm-reader.outputs.impl }}
+  repo:
+    description: "Repository to use to build the EVM binary"
+    value: ${{ steps.config-evm-reader.outputs.repo }}
+  ref:
+    description: "Reference to branch, commit, or tag to use to build the EVM binary"
+    value: ${{ steps.config-evm-reader.outputs.ref }}
+  evm-bin:
+    description: "Binary name of the evm tool to use"
+    value: ${{ steps.config-evm-impl-config-reader.outputs.evm-bin }}
+  x-dist:
+    description: "Binary name of the evm tool to use"
+    value: ${{ steps.config-evm-impl-config-reader.outputs.x-dist }}
+runs:
+  using: "composite"
+  steps:
+    - name: Get the selected EVM version from the .github/configs/evm.yaml
+      id: config-evm-reader
+      shell: bash
+      run: |
+        awk "/^${{ inputs.type }}:/{flag=1; next} /^[[:alnum:]]/{flag=0} flag" ./.github/configs/evm.yaml \
+        | sed 's/ //g' | sed 's/:/=/g' >> "$GITHUB_OUTPUT"
+    - name: Get the EVM implementation configuration from .github/configs/evm-impl-config.yaml
+      id: config-evm-impl-config-reader
+      shell: bash
+      run: |
+        awk "/^${{ steps.config-evm-reader.outputs.impl }}:/{flag=1; next} /^[[:alnum:]]/{flag=0} flag" ./.github/configs/evm-impl.yaml \
+        | sed 's/ //g' | sed 's/:/=/g' >> "$GITHUB_OUTPUT"
+    - name: Print Variables for the selected EVM type
+      shell: bash
+      run: |
+        echo "Implementation: ${{ steps.config-evm-reader.outputs.impl }}"
+        echo "Repository: ${{ steps.config-evm-reader.outputs.repo }}"
+        echo "Reference: ${{ steps.config-evm-reader.outputs.ref }}"
+        echo "EVM Binary: ${{ steps.config-evm-impl-config-reader.outputs.evm-bin }}"
+        echo "X-Dist parameter: ${{ steps.config-evm-impl-config-reader.outputs.x-dist }}"
+    - name: Skip building for EELS
+      if: steps.config-evm-reader.outputs.impl == 'eels'
+      shell: bash
+      run: echo "Skipping build for EELS"
+    - name: Build the EVM using Geth action
+      if: steps.config-evm-reader.outputs.impl == 'geth'
+      uses: ./.github/actions/build-evm-client/geth
+      with:
+        repo: ${{ steps.config-evm-reader.outputs.repo }}
+        ref: ${{ steps.config-evm-reader.outputs.ref }}
+    - name: Build the EVM using EVMONE action
+      if: steps.config-evm-reader.outputs.impl == 'evmone'
+      uses: ./.github/actions/build-evm-client/evmone
+      with:
+        repo: ${{ steps.config-evm-reader.outputs.repo }}
+        ref: ${{ steps.config-evm-reader.outputs.ref }}
+        # `targets` in the evm.yaml must be an inline array to not interfere with `config-evm-reader`'s parsing
+        targets: ${{ join(fromJSON(steps.config-evm-reader.outputs.targets), ' ') }}
+    - name: Build the EVM using Besu action
+      if: steps.config-evm-reader.outputs.impl == 'besu'
+      uses: ./.github/actions/build-evm-client/besu
+      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/besu/action.yaml

@@ -0,0 +1,40 @@
+name: 'Build Besu EVM'
+description: 'Builds the Besu EVM binary'
+inputs:
+  repo:
+    description: 'Source repository to use to build the EVM binary'
+    required: true
+    default: 'hyperledger/besu'
+  ref:
+    description: 'Reference to branch, commit, or tag to use to build the EVM binary'
+    required: true
+    default: 'main'
+  java:
+    description: 'Java version to use to build Besu'
+    required: false
+    default: '21'
+  java-distro:
+    description: 'Java distribution to use to build Besu'
+    required: false
+    default: 'temurin'
+runs:
+  using: "composite"
+  steps:
+    - name: Checkout Besu
+      uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+      with:
+        repository: ${{ inputs.repo }}
+        ref: ${{ inputs.ref }}
+        path: besu
+    - name: Setup Java
+      uses: actions/setup-java@3a4f6e1af504cf6a31855fa899c6aa5355ba6c12
+      with:
+        java-version: ${{ inputs.java }}
+        distribution: ${{ inputs.java-distro }}
+        cache: 'gradle'
+    - name: Build evm cmd
+      shell: bash
+      run: |
+        cd $GITHUB_WORKSPACE/besu
+        ./gradlew installDist
+        echo $GITHUB_WORKSPACE/besu/build/install/besu/bin/ >> $GITHUB_PATH

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

@@ -0,0 +1,37 @@
+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: 'master'
+runs:
+  using: "composite"
+  steps:
+    - name: Checkout EthereumJS monorepo
+      uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+      with:
+        repository: ${{ inputs.repo }}
+        ref: ${{ inputs.ref }}
+        path: ethereumjs
+
+    - name: Setup node
+      uses: actions/setup-node@cdca7365b2dadb8aad0a33bc7601856ffabcc48e
+      with:
+        node-version: 18
+
+    - name: Build monorepo
+      shell: bash
+      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/actions/build-evm-client/evmone/action.yaml

@@ -0,0 +1,77 @@
+name: 'Build evmone EVM'
+description: 'Builds the evmone EVM binary'
+inputs:
+  repo:
+    description: 'Source repository to use to build the EVM binary'
+    required: true
+    default: 'ethereum/evmone'
+  ref:
+    description: 'Reference to branch, commit, or tag to use to build the EVM binary'
+    required: true
+    default: 'master'
+  targets:
+    description: 'Which targets to build from evmone repo'
+    required: false
+    default: 'all'
+runs:
+  using: "composite"
+  steps:
+    - name: Get latest evmone commit
+      id: evmone-sha
+      shell: bash
+      run: |
+        SHA=$(git ls-remote https://github.com/${{ inputs.repo }}.git refs/heads/${{ inputs.ref }} | cut -f1)
+        echo "sha=$SHA" >> $GITHUB_OUTPUT
+        echo "Latest evmone commit: $SHA"
+    - name: Prepare cache target dir
+      shell: bash
+      run: mkdir -p "$GITHUB_WORKSPACE/evmone/build"
+    - name: Restore build cache
+      id: cache-restore
+      uses: actions/cache/restore@0057852bfaa89a56745cba8c7296529d2fc39830
+      with:
+        path: |
+          ${{ github.workspace }}/evmone/build
+        key: evmone-build-targets=${{ inputs.targets }}-sha=${{ steps.evmone-sha.outputs.sha }}
+        restore-keys: |
+          evmone-build-targets=${{ inputs.targets }}-
+    - name: Checkout evmone
+      if: steps.cache-restore.outputs.cache-hit != 'true'
+      uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+      with:
+        repository: ${{ inputs.repo }}
+        ref: ${{ steps.evmone-sha.outputs.sha }}
+        path: evmone
+        submodules: true
+    - name: Setup cmake
+      if: steps.cache-restore.outputs.cache-hit != 'true'
+      uses: jwlawson/actions-setup-cmake@802fa1a2c4e212495c05bf94dba2704a92a472be
+      with:
+        cmake-version: '3.x'
+    - name: "Install GMP Linux"
+      if: runner.os == 'Linux' && steps.cache-restore.outputs.cache-hit != 'true'
+      shell: bash
+      run: sudo apt-get -q update && sudo apt-get -qy install libgmp-dev
+    - name: Install GMP macOS
+      if: runner.os == 'macOS' && steps.cache-restore.outputs.cache-hit != 'true'
+      shell: bash
+      run: |
+        brew update && brew install gmp
+    - name: Build evmone binary
+      if: steps.cache-restore.outputs.cache-hit != 'true'
+      shell: bash
+      run: |
+        mkdir -p $GITHUB_WORKSPACE/bin
+        cd $GITHUB_WORKSPACE/evmone
+        cmake -S . -B build -DEVMONE_TESTING=ON -DEVMONE_PRECOMPILES_SILKPRE=1
+        cmake --build build --parallel --target ${{ inputs.targets }}
+    - name: Add evmone bin to PATH
+      shell: bash
+      run: echo $GITHUB_WORKSPACE/evmone/build/bin/ >> $GITHUB_PATH
+    - name: Save build cache
+      if: steps.cache-restore.outputs.cache-hit != 'true'
+      uses: actions/cache/save@0057852bfaa89a56745cba8c7296529d2fc39830
+      with:
+        path: |
+          ${{ github.workspace }}/evmone/build
+        key: evmone-build-targets=${{ inputs.targets }}-sha=${{ steps.evmone-sha.outputs.sha }}