🤖 I have created a release *beep* *boop*
---


##
[2.1.0](https://github.com/kurtosis-tech/ethereum-package/compare/2.0.0...2.1.0)
(2024-03-28)


### Features

* add beacon snooper
([#520](https://github.com/kurtosis-tech/ethereum-package/issues/520))
([7e361913](https://github.com/kurtosis-tech/ethereum-package/commit/7e361913c754ddf37eaf2cf3ad4a93aed8770899))
* add BN<>CL compatibility matrix to readme
([#519](https://github.com/kurtosis-tech/ethereum-package/issues/519))
([177beeb9](https://github.com/kurtosis-tech/ethereum-package/commit/177beeb9b46f61b3dd3dc3009ff2abf9b576c569))
* add grandine
([#517](https://github.com/kurtosis-tech/ethereum-package/issues/517))
([3ac4d2a4](https://github.com/kurtosis-tech/ethereum-package/commit/3ac4d2a4fae1c33ff658f0f43657a09522348127))
* enable preset to be set, mainnet/minimal
([#524](https://github.com/kurtosis-tech/ethereum-package/issues/524))
([f6e1b136](https://github.com/kurtosis-tech/ethereum-package/commit/f6e1b136ef6b884e540c1289b8acc2b4d359e6ce))
* make deneb genesis default
([#518](https://github.com/kurtosis-tech/ethereum-package/issues/518))
([49509b9e](https://github.com/kurtosis-tech/ethereum-package/commit/49509b9ecb8b00d361e4119ee053ba86c366619e))
* make keymanager optional
([#523](https://github.com/kurtosis-tech/ethereum-package/issues/523))
([969012c3](https://github.com/kurtosis-tech/ethereum-package/commit/969012c3b504be1c475bd583675857d0605ed430))
* update verkle genesis + add besu support to verkle testing
([#512](https://github.com/kurtosis-tech/ethereum-package/issues/512))
([0615cd1b](https://github.com/kurtosis-tech/ethereum-package/commit/0615cd1b4466d8f63e3adb721d97ee768211114f))


### Bug Fixes

* architecture.md
([#514](https://github.com/kurtosis-tech/ethereum-package/issues/514))
([f0ec4f07](https://github.com/kurtosis-tech/ethereum-package/commit/f0ec4f076837b282a8972bd2211a0522ed67a06b))
* blobscan network name
([#516](https://github.com/kurtosis-tech/ethereum-package/issues/516))
([83c2a559](https://github.com/kurtosis-tech/ethereum-package/commit/83c2a5592445c0efc10ab418d87ab2ecd4d10cf4))
* **blobscan:** update healthcheck endpoint
([#513](https://github.com/kurtosis-tech/ethereum-package/issues/513))
([8b2fc61f](https://github.com/kurtosis-tech/ethereum-package/commit/8b2fc61f77b53642441d3bd0bdeea89b2a2d35eb))
* separate vc
([#526](https://github.com/kurtosis-tech/ethereum-package/issues/526))
([baa04e91](https://github.com/kurtosis-tech/ethereum-package/commit/baa04e9118f39b10ed7d867eec164483c6fd807d))
* Updated Readme with VCs supported by Grandine BN
([#527](https://github.com/kurtosis-tech/ethereum-package/issues/527))
([9cbe0b36](https://github.com/kurtosis-tech/ethereum-package/commit/9cbe0b368205f70ee274d9c0c57f634f9621e6d7))
* use correct dora & assertoor images
([#522](https://github.com/kurtosis-tech/ethereum-package/issues/522))
([2a8d73ab](https://github.com/kurtosis-tech/ethereum-package/commit/2a8d73aba35bf26bfcd474036bac32c4f5713e35))
* use new validator names in assertoor config
([#521](https://github.com/kurtosis-tech/ethereum-package/issues/521))
([f595eb9a](https://github.com/kurtosis-tech/ethereum-package/commit/f595eb9a75e8c2147d530d1a70e6ccb9f3542257))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Co-authored-by: Gyanendra Mishra <anomaly.the@gmail.com>

This config with mixed Grandine BN <> Lighthouse VC, Grandine BN <> Teku
VC passes:

```
participants:
  - el_type: erigon
    cl_type: grandine
    cl_image: grandine:local
    use_separate_vc: true
    vc_type: lighthouse
    vc_image: sigp/lighthouse:latest
  - el_type: geth
    cl_type: grandine
    cl_image: grandine:local
    use_separate_vc: true
    vc_type: teku
    vc_image: consensys/teku:latest
  - el_type: reth
    cl_type: grandine
    cl_image: grandine:local
    use_separate_vc: true
    vc_type: lighthouse
    vc_image: sigp/lighthouse:latest
    count: 1
network_params:
  deneb_fork_epoch: 1
  min_validator_withdrawability_delay: 1
  shard_committee_period: 1
  num_validator_keys_per_node: 250
launch_additional_services: true
additional_services:
  - dora
  - assertoor
#snooper_enabled: true
disable_peer_scoring: true
assertoor_params:
  image: "ethpandaops/assertoor:master"
  run_stability_check: false
  run_block_proposal_check: false
  tests:
    - https://raw.githubusercontent.com/ethpandaops/assertoor-test/master/assertoor-tests/stability-check.yaml
    - https://raw.githubusercontent.com/ethpandaops/assertoor-test/master/assertoor-tests/block-proposal-check.yaml
    - https://raw.githubusercontent.com/ethpandaops/assertoor-test/master/assertoor-tests/eoa-transactions-test.yaml
    - https://raw.githubusercontent.com/ethpandaops/assertoor-test/master/assertoor-tests/all-opcodes-test.yaml
    - https://raw.githubusercontent.com/ethpandaops/assertoor-test/master/assertoor-tests/validator-withdrawal-test.yaml
    - https://raw.githubusercontent.com/ethpandaops/assertoor-test/master/assertoor-tests/validator-exit-test.yaml
    - https://raw.githubusercontent.com/ethpandaops/assertoor-test/master/assertoor-tests/validator-slashing-test.yaml
    - https://raw.githubusercontent.com/ethpandaops/assertoor-test/master/assertoor-tests/dencun-opcodes-test.yaml
    - https://raw.githubusercontent.com/ethpandaops/assertoor-test/master/assertoor-tests/blob-transactions-test.yaml
 ```

Verkle support has been dropped from the package.
Dora & Assertoor were using custom images to support verkle, these
images are now accidentally used, as electra_fork_epoch is set to 500
now by default.

assertoor config still had a few names in old format, this replaces them
with the new format

🤖 I have created a release *beep* *boop*
---


##
[2.0.0](https://github.com/kurtosis-tech/ethereum-package/compare/1.4.0...2.0.0)
(2024-03-08)


### ⚠ BREAKING CHANGES

* participant_network & rename participant fields.
([#508](https://github.com/kurtosis-tech/ethereum-package/issues/508))
* add node selectors features
([#491](https://github.com/kurtosis-tech/ethereum-package/issues/491))

### Features

* add keymanager to all validator processes
([#502](https://github.com/kurtosis-tech/ethereum-package/issues/502))
([836eda4e](https://github.com/kurtosis-tech/ethereum-package/commit/836eda4eed3776dd406d354343655c0ff8b9d2b6))
* add nimbus-eth1
([#496](https://github.com/kurtosis-tech/ethereum-package/issues/496))
([d5997292](https://github.com/kurtosis-tech/ethereum-package/commit/d599729295aa3274d23e4e8e99b56288cde3fc04))
* add node selectors features
([#491](https://github.com/kurtosis-tech/ethereum-package/issues/491))
([316d42fb](https://github.com/kurtosis-tech/ethereum-package/commit/316d42fbaeb2d7bc1d580823a6c70b1c2dfe3746))
* allow more detailed additional test configurations in assertoor_params
([#498](https://github.com/kurtosis-tech/ethereum-package/issues/498))
([fe2de7e5](https://github.com/kurtosis-tech/ethereum-package/commit/fe2de7e5a5e2446ebb0a0b191f5aa6783e132426))
* enable api in assertoor config
([#495](https://github.com/kurtosis-tech/ethereum-package/issues/495))
([9ceae9c7](https://github.com/kurtosis-tech/ethereum-package/commit/9ceae9c74405db4e1ab6e02de541577d078434ae))
* enable dencun-genesis
([#500](https://github.com/kurtosis-tech/ethereum-package/issues/500))
([beb764fb](https://github.com/kurtosis-tech/ethereum-package/commit/beb764fb9a18fcb09cb7d3d9ee48e4826595512d))
* make snapshot url configurable
([#507](https://github.com/kurtosis-tech/ethereum-package/issues/507))
([6fa04751](https://github.com/kurtosis-tech/ethereum-package/commit/6fa04751cd1277a4870dc45144e15ffa5d637b93))
* parameterize mev-boost args
([#400](https://github.com/kurtosis-tech/ethereum-package/issues/400))
([e48483a1](https://github.com/kurtosis-tech/ethereum-package/commit/e48483a130ba227dafd0d0fd9ee66c6cecc3bfce))
* separate validator clients from CL clients
([#497](https://github.com/kurtosis-tech/ethereum-package/issues/497))
([90da2c33](https://github.com/kurtosis-tech/ethereum-package/commit/90da2c33a77b4a0ac620ae665899963256a1ae0a))


### Bug Fixes

* fix end index in validator ranges file
([#509](https://github.com/kurtosis-tech/ethereum-package/issues/509))
([da55be84](https://github.com/kurtosis-tech/ethereum-package/commit/da55be84861e93ce777076e545abee35ff2d51ce))
* lh vc flag logic
([#506](https://github.com/kurtosis-tech/ethereum-package/issues/506))
([bc5e725e](https://github.com/kurtosis-tech/ethereum-package/commit/bc5e725edf8c917d409e6de6ce838797ad166173))
* nimbus-eth1 advertise proper extip
([#501](https://github.com/kurtosis-tech/ethereum-package/issues/501))
([1d5a7792](https://github.com/kurtosis-tech/ethereum-package/commit/1d5a7792c8175d1fc85e424b5ddf60baec551821))
* README global node selector
([#504](https://github.com/kurtosis-tech/ethereum-package/issues/504))
([f9343a29](https://github.com/kurtosis-tech/ethereum-package/commit/f9343a2914456196e1209336c426b6ad44958428))
* use the cl as the default validator image if none are defined
([#503](https://github.com/kurtosis-tech/ethereum-package/issues/503))
([181dd04c](https://github.com/kurtosis-tech/ethereum-package/commit/181dd04c2db17c58cb9370b0d24e12e4c191a13d))


### Code Refactoring

* participant_network & rename participant fields.
([#508](https://github.com/kurtosis-tech/ethereum-package/issues/508))
([fab341b1](https://github.com/kurtosis-tech/ethereum-package/commit/fab341b158329b9e8c2b590dc63127dfd1d2495f))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

# Important!
There are many participant fields that have been renamed to be more
consistent with the rest of the package. The following fields have been
renamed:
### EL Flags
```
el_client_type -> el_type
el_client_image -> el_image
el_client_log_level -> el_log_level
el_client_volume_size -> el_volume_size
```
### CL Flags
```
cl_client_type -> cl_type
cl_client_image -> cl_image
cl_client_volume_size -> cl_volume_size
cl_client_log_level -> cl_log_level
beacon_extra_params -> cl_extra_params
beacon_extra_labels -> cl_extra_labels
bn_min_cpu -> cl_min_cpu
bn_max_cpu -> cl_max_cpu
bn_min_mem -> cl_min_mem
bn_max_mem -> cl_max_mem
use_separate_validator_client -> use_separate_vc
```
### Validator flags
```
validator_client_type -> vc_type
validator_tolerations -> vc_tolerations
validator_client_image -> vc_image
validator_extra_params -> vc_extra_params
validator_extra_labels -> vc_extra_labels
v_min_cpu -> vc_min_cpu
v_max_cpu -> vc_max_cpu
v_min_mem -> vc_min_mem
v_max_mem -> vc_max_mem
```
### Global flags
```
global_client_log_level -> global_log_level
```


Once this PR is merged, the old names will no longer work, and you will
have to bulk rename all your yaml files.

A rename.sh bash script is added, which can be used to do bulk `find and
replace` operations.
```bash
rename.sh yourFile.yaml
```

---------
Co-authored-by: Gyanendra Mishra <anomaly.the@gmail.com>

The ranges.yaml currently looks like this:
```
0-250: cl-1-lighthouse-geth
250-500: cl-2-prysm-reth
500-750: cl-3-lodestar-besu
```

but the end index should be inclusive:
```
0-249: cl-1-lighthouse-geth
250-499: cl-2-prysm-reth
500-749: cl-3-lodestar-besu
```

This PR ensures that the validator image will be the same as CL image
(if one is defined) and only fallback to the default validator image if
there is no validator image nor beacon image is defined.

Co-authored-by: eth2353 <70237279+eth2353@users.noreply.github.com>

Separates the validator clients more cleanly from the CL clients. This
then allows the use of different combinations of CL/VC clients, e.g.
Teku VC with Lodestar CL. The only VC that doesn't work with different
beacon nodes is Prysm at the moment.

The `use_separate_validator_client` flag defaults to false for CL
clients that can run validators in the same process as the CL
(preserving the way the `cl_split_mode_enabled` worked before this PR).

I believe this can be quite useful to test different VC<->CL
combinations for compatibility.

---------
Co-authored-by: Barnabas Busa <busa.barnabas@gmail.com>

This adds the ability do use complex objects that are passed through to
the assertoor config in json format.
It allows defining assertoor tests like this via the kurtosis params:
```
assertoor_params:
  run_stability_check: false
  run_block_proposal_check: true
  tests:
    - file: https://raw.githubusercontent.com/ethpandaops/assertoor-test/master/assertoor-tests/block-proposal-check.yaml
      timeout: 2h
      config:
        someCustomTestConfig: "some value"
```

The old way to specify the link to the test only is still supported:
```
assertoor_params:
  run_stability_check: false
  run_block_proposal_check: true
  tests:
    - "https://raw.githubusercontent.com/ethpandaops/assertoor-test/master/assertoor-tests/block-proposal-check.yaml"
```

Effectively both formats can be used.


The downstream implementation is unfortunately not super nice 😅
It embeds the test configs as json objects within the yaml
configuration.
This works fine as yaml inherits the json syntax.

Adds 2 new fields to the config file under the mev_params field:
mev_boost_image: <The mev-boost image, default is flashbots/mev-boost>
mev_boost_args: <The args of mev-boost. The default params are
["mev-boost", "--relay-check"]>

The behaviour is such that, `mev-boost-args` overrides all the args of
mev-boost. No extra params are added.

Resolves https://github.com/kurtosis-tech/ethereum-package/issues/289

---------
Co-authored-by: Barnabas Busa <busa.barnabas@gmail.com>
Co-authored-by: franjoespejo <franjoespejo@gmail.com>
Co-authored-by: Gyanendra Mishra <anomaly.the@gmail.com>
Co-authored-by: Sam Calder-Mason <sam.calder-mason@ethereum.org>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: pk910 <github@pk910.de>
Co-authored-by: Parithosh Jayanthi <parithosh.jayanthi@ethereum.org>
Co-authored-by: franjoespejo <franjosepejo@github.com>
Co-authored-by: Anton <anton@northernforest.nl>

enable new assertoor api for easier integration with other tools

Co-authored-by: pk910 <github@pk910.de>
Co-authored-by: parithosh <parithosh.jayanthi@ethereum.org>
Co-authored-by: Gyanendra Mishra <anomaly.the@gmail.com>

🤖 I have created a release *beep* *boop*
---


##
[1.4.0](https://github.com/kurtosis-tech/ethereum-package/compare/1.3.0...1.4.0)
(2024-02-09)


### Features

* Add suave-enabled geth support
([#489](https://github.com/kurtosis-tech/ethereum-package/issues/489))
([631eaf3e](https://github.com/kurtosis-tech/ethereum-package/commit/631eaf3e621c90d5b546a1c005d8e31e06263aa4))
* add support for custom assertoor images & use assertoor image with
verkle support for verkle chains
([#483](https://github.com/kurtosis-tech/ethereum-package/issues/483))
([2d8a143f](https://github.com/kurtosis-tech/ethereum-package/commit/2d8a143f753eaa3ec13abe4ebbb57bf82548b3fb))
* add verkle-gen-devnet-3
([#487](https://github.com/kurtosis-tech/ethereum-package/issues/487))
([1e543e87](https://github.com/kurtosis-tech/ethereum-package/commit/1e543e873c06e86a6448f8e88c53fb1bde35338e))
* blockscout support with sc verification
([#481](https://github.com/kurtosis-tech/ethereum-package/issues/481))
([b3418cf1](https://github.com/kurtosis-tech/ethereum-package/commit/b3418cf1545378d4b412966b9c33f650141aec04))
* enable custom resource limit per network
([#471](https://github.com/kurtosis-tech/ethereum-package/issues/471))
([5db6611a](https://github.com/kurtosis-tech/ethereum-package/commit/5db6611ab831a92212a21859b42a911cd12bce0c))
* enable shadowforking
([#475](https://github.com/kurtosis-tech/ethereum-package/issues/475))
([b788b18e](https://github.com/kurtosis-tech/ethereum-package/commit/b788b18eead00622ab960a4853c8e24b09c16a26))
* improve built-in assertoor tests
([#488](https://github.com/kurtosis-tech/ethereum-package/issues/488))
([d5966991](https://github.com/kurtosis-tech/ethereum-package/commit/d5966991653ad48094cf71d3c01612349a651877))
* we no longer need 4788 deployer
([#485](https://github.com/kurtosis-tech/ethereum-package/issues/485))
([abdfc2c3](https://github.com/kurtosis-tech/ethereum-package/commit/abdfc2c3e73550069c2fbe0df5202f7f227a00cd))


### Bug Fixes

* add more prefund addresses for verkle-gen
([#482](https://github.com/kurtosis-tech/ethereum-package/issues/482))
([01868fcb](https://github.com/kurtosis-tech/ethereum-package/commit/01868fcb604852cf66474fc9de9a53a7b87b7bc3))
* bump verkle genesis generator
([#486](https://github.com/kurtosis-tech/ethereum-package/issues/486))
([79dc5e19](https://github.com/kurtosis-tech/ethereum-package/commit/79dc5e19713d3f898f6255394290497d016f32d5))
* use latest stable image for assertoor
([#484](https://github.com/kurtosis-tech/ethereum-package/issues/484))
([bbe0b16e](https://github.com/kurtosis-tech/ethereum-package/commit/bbe0b16e948fc50f51273e2f0ab91503603e9fc9))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Co-authored-by: pk910 <github@pk910.de>
Co-authored-by: parithosh <parithosh.jayanthi@ethereum.org>

Very minor addition to enable running suave-enabled geth (a.k.a.
`suave-execution-geth`) instead of the stock geths.

Improves the built-in assertoor tests to make them more resilient
against non-critical failures.

addresses #372

---------
Co-authored-by: franjoespejo <franjosepejo@github.com>

go-verkle depns changes, we need this bump to be compatible for the
current verkle tests