Skip to content

feat(consume): initial implementation of enginex #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
danceratopz wants to merge 4 commits into from
Closed

feat(consume): initial implementation of enginex #1

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
9a390db
feat(consume): initial sequential implementation of enginex
danceratopz Nov 26, 2025
202b543
feat(consume): enable dist=loadgroup by default for enginex
danceratopz Nov 27, 2025
8bdf8d4
chore(docs): update for simulator prefix rename (eest->eels)
danceratopz Nov 27, 2025
e47a3cc
feat(docs): add basic enginex doc overview to running tests
danceratopz Nov 27, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/running_tests/consume/exceptions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ uv run consume engine --disable-strict-exception-matching=nimbus-el
Enable verbose client output:

```bash
./hive --sim ethereum/eest/consume-engine \
./hive --sim ethereum/eels/consume-engine \
--docker.output \
--sim.loglevel 5
```
Expand Down
4 changes: 2 additions & 2 deletions docs/running_tests/execute/hive.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,12 @@

Tests can be executed on a local hive-controlled single-client network by running the `execute hive` command.

## The `eest/execute-blobs` Simulator
## The `eels/execute-blobs` Simulator

The `blob_transaction_test` execute test spec sends blob transactions to a running client in order to verify its `engine_getBlobsVX` endpoint behavior. These tests can be run using:

```bash
./hive --client besu --client-file ./configs/osaka.yaml --sim ethereum/eest/execute-blobs
./hive --client besu --client-file ./configs/osaka.yaml --sim ethereum/eels/execute-blobs
```

See [Hive](../hive/index.md) for help installing and configuring Hive.
Expand Down
6 changes: 3 additions & 3 deletions docs/running_tests/hive/client_config.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -102,17 +102,17 @@ cp -r /path/to/your/go-ethereum ./clients/go-ethereum/go-ethereum-local
Force rebuild base images:

```bash
./hive --docker.pull --sim ethereum/eest/consume-engine
./hive --docker.pull --sim ethereum/eels/consume-engine
```

Force rebuild specific client:

```bash
./hive --docker.nocache "clients/go-ethereum" --sim ethereum/eest/consume-engine
./hive --docker.nocache "clients/go-ethereum" --sim ethereum/eels/consume-engine
```

Show the docker container build output:

```bash
./hive --docker.buildoutput --sim ethereum/eest/consume-engine
./hive --docker.buildoutput --sim ethereum/eels/consume-engine
```
14 changes: 7 additions & 7 deletions docs/running_tests/hive/common_options.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ While they may be omitted, it's recommended to specify the `fixtures` and `branc
For example, this runs "stable" fixtures from the v4.3.0 [latest stable release](../releases.md#standard-releases) and builds the simulator at the v4.3.0 tag:

```bash
./hive --sim ethereum/eest/consume-engine \
./hive --sim ethereum/eels/consume-engine \
--sim.buildarg fixtures=stable@v4.3.0 \
--sim.buildarg branch=v4.3.0 \
--client go-ethereum
Expand All @@ -20,15 +20,15 @@ For example, this runs "stable" fixtures from the v4.3.0 [latest stable release]
Run a subset of tests by filtering tests using `--sim.limit=<regex>` to perform a regular expression match against test IDs:

```bash
./hive --sim ethereum/eest/consume-engine --sim.limit ".*eip4844.*"
./hive --sim ethereum/eels/consume-engine --sim.limit ".*eip4844.*"
```

### Collect Only/Dry-Run

The `collectonly:` prefix can be used to inspect which tests would match an expression (dry-run), `--docker.output` must be specified to see the simulator's collection result:

```bash
./hive --sim ethereum/eest/consume-engine \
./hive --sim ethereum/eels/consume-engine \
--sim.buildarg fixtures=stable@v4.3.0 \
--sim.buildarg branch=v4.3.0 \
--docker.output \
Expand All @@ -40,7 +40,7 @@ The `collectonly:` prefix can be used to inspect which tests would match an expr
The `id:` prefix can be used to select a single test via its ID (this will automatically escape any special characters in the test case ID):

```console
./hive --sim ethereum/eest/consume-engine \
./hive --sim ethereum/eels/consume-engine \
--sim.buildarg fixtures=stable@v4.3.0 \
--sim.buildarg branch=v4.3.0 \
--docker.output \
Expand All @@ -52,21 +52,21 @@ The `id:` prefix can be used to select a single test via its ID (this will autom
To run multiple tests in parallel, use `--sim.parallelism`:

```bash
./hive --sim ethereum/eest/consume-rlp --sim.parallelism 4
./hive --sim ethereum/eels/consume-rlp --sim.parallelism 4
```

### Output Options

See hive log output in the console:

```bash
./hive --sim ethereum/eest/consume-engine --sim.loglevel 5
./hive --sim ethereum/eels/consume-engine --sim.loglevel 5
```

### Container Issues

Increase client timeout:

```bash
./hive --client.checktimelimit=180s --sim ethereum/eest/consume-engine
./hive --client.checktimelimit=180s --sim ethereum/eels/consume-engine
```
6 changes: 3 additions & 3 deletions docs/running_tests/hive/dev_mode.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ The following section details the setup and usage of option 3.

### EEST Docker Development Image

Within the [`eest/`](https://github.com/ethereum/hive/tree/master/simulators/ethereum/eest) directory of hive, a new dockerfile must be created: `Dockerfile.dev`, with the following contents:
Within the [`eels/`](https://github.com/ethereum/hive/tree/master/simulators/ethereum/eest) directory of hive, a new dockerfile must be created: `Dockerfile.dev`, with the following contents:

```docker
FROM ghcr.io/astral-sh/uv:python3.12-bookworm-slim
Expand All @@ -83,7 +83,7 @@ ENTRYPOINT ["/bin/bash"]

This dockerfile will be our entry point for running EEST commands.

### `eest/` Hive Directory Structure
### `eels/` Hive Directory Structure

```tree
├── eest
Expand Down Expand Up @@ -111,7 +111,7 @@ This dockerfile will be our entry point for running EEST commands.
3. In a separate terminal session, build the EEST development image:

```bash
cd simulators/ethereum/eest/
cd simulators/ethereum/eels/
docker build -t macos-consume-dev -f Dockerfile.dev .
```

Expand Down
6 changes: 3 additions & 3 deletions docs/running_tests/releases.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,10 +7,10 @@
| Format | Consumed by the client | Location in `.tar.gz` release |
| -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| [State Tests](./test_formats/state_test.md) | - directly via a `statetest`-like command<br/> (e.g., [go-ethereum/cmd/evm/staterunner.go](https://github.com/ethereum/go-ethereum/blob/4bb097b7ffc32256791e55ff16ca50ef83c4609b/cmd/evm/staterunner.go)) | `./fixtures/state_tests/` |
| [Blockchain Tests](./test_formats/blockchain_test.md) | - directly via a `blocktest`-like command<br/> (e.g., [go-ethereum/cmd/evm/blockrunner.go](https://github.com/ethereum/go-ethereum/blob/4bb097b7ffc32256791e55ff16ca50ef83c4609b/cmd/evm/blockrunner.go))</br>- using the [RLPeest/consume-rlp Simulator](./running.md#rlp) via block import | `./fixtures/blockchain_tests/` |
| [Blockchain Engine Tests](./test_formats/blockchain_test_engine.md) | - using the [eest/consume-engine Simulator](./running.md#engine) and the Engine API | `./fixtures/blockchain_tests_engine/` |
| [Blockchain Tests](./test_formats/blockchain_test.md) | - directly via a `blocktest`-like command<br/> (e.g., [go-ethereum/cmd/evm/blockrunner.go](https://github.com/ethereum/go-ethereum/blob/4bb097b7ffc32256791e55ff16ca50ef83c4609b/cmd/evm/blockrunner.go))</br>- using the [eels/consume-rlp Simulator](./running.md#rlp) via block import | `./fixtures/blockchain_tests/` |
| [Blockchain Engine Tests](./test_formats/blockchain_test_engine.md) | - using the [eels/consume-engine Simulator](./running.md#engine) and the Engine API | `./fixtures/blockchain_tests_engine/` |
| [Transaction Tests](./test_formats/transaction_test.md) | - using a new simulator coming soon | None; executed directly from Python source,</br>using a release tag |
| Blob Transaction Tests | - using the [eest/execute-blobs Simulator](./execute/hive.md#the-eestexecute-blobs-simulator) and | None; executed directly from Python source,</br>using a release tag |
| Blob Transaction Tests | - using the [eels/execute-blobs Simulator](./execute/hive.md#the-eelsexecute-blobs-simulator) and | None; executed directly from Python source,</br>using a release tag |

## Release URLs and Tarballs

Expand Down
Loading
Loading