# 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

feat: add support for custom assertoor images & use assertoor image with verkle support for verkle chains (#483)

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


##
[1.3.0](https://github.com/kurtosis-tech/ethereum-package/compare/1.2.0...1.3.0)
(2024-01-22)


### Features

* add assertoor to additional toolings
([#419](https://github.com/kurtosis-tech/ethereum-package/issues/419))
([76dde3ed](https://github.com/kurtosis-tech/ethereum-package/commit/76dde3ed421da0d7f8ba16f46565b07019be76c0))
* add devnets support
([#384](https://github.com/kurtosis-tech/ethereum-package/issues/384))
([2bae0993](https://github.com/kurtosis-tech/ethereum-package/commit/2bae09931ed1cdcfe499efaae420c981dabcea62))
* add pitfalls for persistent storage as a warning
([#441](https://github.com/kurtosis-tech/ethereum-package/issues/441))
([69da8f04](https://github.com/kurtosis-tech/ethereum-package/commit/69da8f04fcfd5ce19365bd89ca73c13cbc40d76a))
* add support for testnets
([#437](https://github.com/kurtosis-tech/ethereum-package/issues/437))
([5584cc84](https://github.com/kurtosis-tech/ethereum-package/commit/5584cc84c50ca9845c544810fb8331ec8fcdcbc8))
* Add Xatu Sentry
([#466](https://github.com/kurtosis-tech/ethereum-package/issues/466))
([b9523cb7](https://github.com/kurtosis-tech/ethereum-package/commit/b9523cb7083be78c96bb88a7ca86d142cb0eec1d))
* enable checkpoint sync for devnets
([#448](https://github.com/kurtosis-tech/ethereum-package/issues/448))
([b367cfe8](https://github.com/kurtosis-tech/ethereum-package/commit/b367cfe875900bdc8aa70dc8b1d8aebdbcf81593))
* enable persistence
([#422](https://github.com/kurtosis-tech/ethereum-package/issues/422))
([8d400566](https://github.com/kurtosis-tech/ethereum-package/commit/8d400566aa54132dccaa7ff129adc12e547907a0))
* enable syncing ephemery
([#459](https://github.com/kurtosis-tech/ethereum-package/issues/459))
([f8289cb4](https://github.com/kurtosis-tech/ethereum-package/commit/f8289cb49f68dd488635d2313c007ee7c2f4dbf3))
* enable syncing shadowforks
([#457](https://github.com/kurtosis-tech/ethereum-package/issues/457))
([313a5869](https://github.com/kurtosis-tech/ethereum-package/commit/313a586965efa6739e8d4055f1263a89d48ff499))


### Bug Fixes

* add CL genesis delay to final genesis time
([#469](https://github.com/kurtosis-tech/ethereum-package/issues/469))
([e36027b9](https://github.com/kurtosis-tech/ethereum-package/commit/e36027b91de0ae8943012ffd6ba776142d2e2d78))
* add prysm-multiarch upstream image
([#451](https://github.com/kurtosis-tech/ethereum-package/issues/451))
([6feba237](https://github.com/kurtosis-tech/ethereum-package/commit/6feba237fbdfae021402ceeec89baa75df6d83d5))
* added supprot for boot enr file
([#456](https://github.com/kurtosis-tech/ethereum-package/issues/456))
([fd26e5c3](https://github.com/kurtosis-tech/ethereum-package/commit/fd26e5c31609b48e1d6718f72d295a27a7d84a49))
* bump max mem limit for nimbus on holesky
([#439](https://github.com/kurtosis-tech/ethereum-package/issues/439))
([fb847876](https://github.com/kurtosis-tech/ethereum-package/commit/fb84787694faa86872828b92529f51e6c9ac7d44))
* dora template fix
([#452](https://github.com/kurtosis-tech/ethereum-package/issues/452))
([f9243ea8](https://github.com/kurtosis-tech/ethereum-package/commit/f9243ea8cdec8a0145206831c9c043269c80e863))
* enable ws for geth
([#446](https://github.com/kurtosis-tech/ethereum-package/issues/446))
([d5bf4515](https://github.com/kurtosis-tech/ethereum-package/commit/d5bf45150dc09432bb84b366d2deda8c6036afea))
* erigon chain should be set to dev
([#447](https://github.com/kurtosis-tech/ethereum-package/issues/447))
([1f40d840](https://github.com/kurtosis-tech/ethereum-package/commit/1f40d8402666310cad81066852110aa20627471b))
* erigon command arg
([#454](https://github.com/kurtosis-tech/ethereum-package/issues/454))
([5ae56a17](https://github.com/kurtosis-tech/ethereum-package/commit/5ae56a17773122827b074963dee40a43a00478ea))
* fix typo
([#440](https://github.com/kurtosis-tech/ethereum-package/issues/440))
([933a3133](https://github.com/kurtosis-tech/ethereum-package/commit/933a3133bf9b1fe96ea3c537b26c3c8ced0a35e3))
* guid fix for besu/teku/erigon/nimbus
([#443](https://github.com/kurtosis-tech/ethereum-package/issues/443))
([2283464b](https://github.com/kurtosis-tech/ethereum-package/commit/2283464b614b0ade4aa98fccd842e8e4b23e188a))
* increase db size for geth
([#453](https://github.com/kurtosis-tech/ethereum-package/issues/453))
([0c679985](https://github.com/kurtosis-tech/ethereum-package/commit/0c67998567a4ab60dd0355b734076ee47b988326))
* logging bug
([#462](https://github.com/kurtosis-tech/ethereum-package/issues/462))
([f6098a15](https://github.com/kurtosis-tech/ethereum-package/commit/f6098a1572923655426f25eab936b7a0b9fbc116))
* parallel key generation
([#423](https://github.com/kurtosis-tech/ethereum-package/issues/423))
([060fd8fb](https://github.com/kurtosis-tech/ethereum-package/commit/060fd8fb3ed8e12be895a43912787313c1ad4a5f))
* re-add networkid
([#464](https://github.com/kurtosis-tech/ethereum-package/issues/464))
([4d96409c](https://github.com/kurtosis-tech/ethereum-package/commit/4d96409cdbd1a367fc1e924cb9183eadce4eeae7))
* typo
([#445](https://github.com/kurtosis-tech/ethereum-package/issues/445))
([e61c58a8](https://github.com/kurtosis-tech/ethereum-package/commit/e61c58a8c2944cbf2699bd75d25a2e63d8e0621c))
* Update nethermind to expose host on 0.0.0.0
([#467](https://github.com/kurtosis-tech/ethereum-package/issues/467))
([0bd29dd7](https://github.com/kurtosis-tech/ethereum-package/commit/0bd29dd7d61dae77b7820f79d46e8a52e74267c2))
* use all enrs for nimbus via bootstrap file
([#450](https://github.com/kurtosis-tech/ethereum-package/issues/450))
([bb5a0c1b](https://github.com/kurtosis-tech/ethereum-package/commit/bb5a0c1b5b051b23b185cfd366a2dfed3f44d903))

---
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>

Adds support for [Xatu](https://github.com/ethpandaops/xatu) in Sentry
mode. Similarly to Ethereum Metrics Exporter, Xatu Sentry can be enabled
globally, or per client pair.

Note: This PR only enables "Sentry". Xatu Server/Clickhouse etc will
need to run outside of Kurtosis for this to be useful.

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