tests@v20.0.0

The first mainnet fixture release from ethereum/execution-specs!

ethereum/execution-spec-tests (EEST) is now fully archived. All test fixture releases are published here going forward.

Release Format Changes

Mainnet releases are tagged tests@vX.Y.Z and ship a single fixtures.tar.gz containing all tests for all forks up to and including the latest mainnet fork. This is the "must pass" set for client mainnet CI, superseding the legacy fixtures_stable / fixtures_develop artifacts:

• X: the fork number the release is up to date with.
• Y: a consensus-breaking spec change targeting fork X.
• Z: non-breaking changes: refactors, new or modified tests.

This release covers Osaka + BPO1 + BPO2 where we mark BPO2 as the 20th mainnet fork. Hence v20.0.0.

Feature releases including devnets, benchmark & zkevm, are tagged separately as tests-<feature>@vX.Y.Z. For further information on feature releases PTAL at #2888, furthermore the updated docs.

Future Releases

tests@v21.0.0 will be the first full Amsterdam mainnet releaes all will tagged for the first Glamsterdam testnet. Expect more regular releases moving forward on a weekly basis iff new tests are added that are relevant to the current mainnet fork, expect v20.0.z bumps as new tests land.

Usage

We recommend using the following methods to download the releases moving forward.

# this release
gh release download tests@v20.0.0 --repo ethereum/execution-specs --pattern '*.tar.gz'

# latest mainnet release, gh cli only (e.g for CI)
LATEST=$(gh release list --repo ethereum/execution-specs --exclude-drafts --limit 100 \
  --json tagName --jq '[.[].tagName | select(startswith("tests@v"))] | first')
gh release download "$LATEST" --repo ethereum/execution-specs --pattern '*.tar.gz'

# for running eels simulators
uv run consume cache --input=latest  # download and cache
uv run consume engine --input=latest  # run simulator (download or use cache)