feat: Charon by sugh01 · Pull Request #1062 · ethpandaops/ethereum-package

sugh01 · 2025-06-11T16:10:59Z

This PR implements Charon distributed validator support in the Kurtosis Ethereum package.

Validators supported

Lighthouse
Lodestar
Teku
Nimbus
Prysm

Configuration

participants:
  - vc_type: charon
    vc_image: obolnetwork/charon:latest
    charon_node_count: 4
    charon_params:
      charon_vc: teku   # Any of: lighthouse, lodestar, teku, nimbus, prysm
      charon_vc_image: consensys/teku:latest  # validator client image

Core Component

charon_launcher.star

barnabasbusa · 2025-06-19T09:06:29Z

can you add charon details to the readme too?

sugh01 · 2025-08-08T09:41:44Z

can you add charon details to the readme too?

Added @barnabasbusa

…ckage

Charon DV monitoring (local scraping of all Charon nodes/VCs) is kept; only the remote_write feature and the personal prometheus-package fork import are removed, so this branch depends solely on the upstream kurtosis-tech/prometheus-package. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Adds the optional Prometheus remote_write feature on top of the cleaned charon branch: prometheus_params gains remote_write_url/token/relabel_configs (generic, inert unless a URL is set) and the prometheus import is pinned to the fork branch that implements remote_write. The Charon example documents the Charon-specific relabel rules. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

barnabasbusa · 2026-06-24T15:13:51Z

+participants:
+  # EL
+  - el_type: geth
+    el_image: ethereum/client-go:latest
+    # CL
+    cl_type: lighthouse
+    cl_image: sigp/lighthouse:latest-unstable
+    supernode: false
+    use_separate_vc: true
+    # Validator
+    vc_type: charon
+    vc_image: obolnetwork/charon:latest
+    charon_node_count: 4
+    charon_params:
+      charon_vc: teku
+      charon_vc_image: consensys/teku:latest
+    validator_count: null
+    use_remote_signer: false
+  - el_type: geth
+    el_image: ethereum/client-go:latest
+    # CL
+    cl_type: lighthouse
+    cl_image: sigp/lighthouse:latest-unstable
+    supernode: false
+    use_separate_vc: true
+    # Validator
+    vc_type: lighthouse
+    vc_image: sigp/lighthouse:latest-unstable
+    use_remote_signer: false
+  - el_type: geth
+    el_image: ethereum/client-go:latest
+    # CL
+    cl_type: lighthouse
+    cl_image: sigp/lighthouse:latest-unstable
+    supernode: false
+    use_separate_vc: true
+    # Validator
+    vc_type: lighthouse
+    vc_image: sigp/lighthouse:latest-unstable
+    use_remote_signer: false
+network_params:
+  network: kurtosis
+  network_id: "3151908"
+  deposit_contract_address: "0x00000000219ab540356cBB839Cbe05303d7705Fa"
+  seconds_per_slot: 12
+  num_validator_keys_per_node: 64
+  preregistered_validator_keys_mnemonic:
+    "giant issue aisle success illegal bike spike
+    question tent bar rely arctic volcano long crawl hungry vocal artwork sniff fantasy
+    very lucky have athlete"
+  preregistered_validator_count: 0
+  genesis_delay: 20
+  genesis_gaslimit: 30000000
+  max_per_epoch_activation_churn_limit: 8
+  churn_limit_quotient: 65536
+  ejection_balance: 16000000000
+  eth1_follow_distance: 2048
+  min_validator_withdrawability_delay: 256
+  shard_committee_period: 256
+  deneb_fork_epoch: 0
+  electra_fork_epoch: 0
+  fulu_fork_epoch: 18446744073709551615
+  network_sync_base_url: https://snapshots.ethpandaops.io/
+  force_snapshot_sync: false
+  samples_per_slot: 8
+  custody_requirement: 4
+  max_blobs_per_block_electra: 9
+  target_blobs_per_block_electra: 6
+  base_fee_update_fraction_electra: 5007716
+  additional_preloaded_contracts: {}
+  devnet_repo: ethpandaops
+  prefunded_accounts: {}
+additional_services: []
+dora_params:
+  image: ""
+tx_fuzz_params:
+  tx_fuzz_extra_args: []
+spamoor_params:
+  min_cpu: 100
+  max_cpu: 1000
+  min_mem: 20
+  max_mem: 300
+  extra_args: []
+prometheus_params:
+  storage_tsdb_retention_time: "1d"
+  storage_tsdb_retention_size: "512MB"
+  min_cpu: 10
+  max_cpu: 1000
+  min_mem: 128
+  max_mem: 2048
+grafana_params:
+  additional_dashboards: []
+  min_cpu: 10
+  max_cpu: 1000
+  min_mem: 128
+  max_mem: 2048
+assertoor_params:
+  image: ""
+  run_stability_check: false
+  run_block_proposal_check: false
+  run_transaction_test: false
+  run_blob_transaction_test: false
+  run_opcodes_transaction_test: false
+  run_lifecycle_test: false
+  tests: []
+wait_for_finalization: false
+global_log_level: info
+snooper_enabled: false
+ethereum_metrics_exporter_enabled: false
+parallel_keystore_generation: false
+disable_peer_scoring: false
+persistent: false
+mev_type: null
+mev_params:
+  mev_relay_image: ethpandaops/mev-boost-relay:main
+  mev_builder_image: ethpandaops/flashbots-builder:main
+  mev_builder_cl_image: sigp/lighthouse:latest
+  mev_boost_image: ethpandaops/mev-boost:develop
+  mev_boost_args: ["mev-boost", "--relay-check"]
+  mev_relay_api_extra_args: []
+  mev_relay_housekeeper_extra_args: []
+  mev_relay_website_extra_args: []
+  mev_builder_extra_args: []
+  mev_builder_prometheus_config:
+    scrape_interval: 15s
+    labels: {}
+  custom_flood_params:
+    interval_between_transactions: 1
+xatu_sentry_enabled: false
+xatu_sentry_params:
+  xatu_sentry_image: ethpandaops/xatu-sentry
+  xatu_server_addr: localhost:8000
+  xatu_server_tls: false
+  xatu_server_headers: {}
+  beacon_subscriptions:
+    - attestation
+    - block
+    - chain_reorg
+    - finalized_checkpoint
+    - head
+    - voluntary_exit
+    - contribution_and_proof
+    - blob_sidecar
+apache_port: 40000
+global_tolerations: []
+global_node_selectors: {}
+keymanager_enabled: false
+checkpoint_sync_enabled: false
+checkpoint_sync_url: ""
+ethereum_genesis_generator_params:
+  image: ethpandaops/ethereum-genesis-generator:4.0.4
+port_publisher:
+  nat_exit_ip: KURTOSIS_IP_ADDR_PLACEHOLDER
+  el:
+    enabled: false
+    public_port_start: 32000
+  cl:
+    enabled: false
+    public_port_start: 33000
+  vc:
+    enabled: false
+    public_port_start: 34000
+  remote_signer:
+    enabled: false
+    public_port_start: 35000
+  additional_services:
+    enabled: false
+    public_port_start: 36000


This seems to be the same as :

Suggested change

participants:

# EL

- el_type: geth

el_image: ethereum/client-go:latest

# CL

cl_type: lighthouse

cl_image: sigp/lighthouse:latest-unstable

supernode: false

use_separate_vc: true

# Validator

vc_type: charon

vc_image: obolnetwork/charon:latest

charon_node_count: 4

charon_params:

charon_vc: teku

charon_vc_image: consensys/teku:latest

validator_count: null

use_remote_signer: false

- el_type: geth

el_image: ethereum/client-go:latest

# CL

cl_type: lighthouse

cl_image: sigp/lighthouse:latest-unstable

supernode: false

use_separate_vc: true

# Validator

vc_type: lighthouse

vc_image: sigp/lighthouse:latest-unstable

use_remote_signer: false

- el_type: geth

el_image: ethereum/client-go:latest

# CL

cl_type: lighthouse

cl_image: sigp/lighthouse:latest-unstable

supernode: false

use_separate_vc: true

# Validator

vc_type: lighthouse

vc_image: sigp/lighthouse:latest-unstable

use_remote_signer: false

network_params:

network: kurtosis

network_id: "3151908"

deposit_contract_address: "0x00000000219ab540356cBB839Cbe05303d7705Fa"

seconds_per_slot: 12

num_validator_keys_per_node: 64

preregistered_validator_keys_mnemonic:

"giant issue aisle success illegal bike spike

question tent bar rely arctic volcano long crawl hungry vocal artwork sniff fantasy

very lucky have athlete"

preregistered_validator_count: 0

genesis_delay: 20

genesis_gaslimit: 30000000

max_per_epoch_activation_churn_limit: 8

churn_limit_quotient: 65536

ejection_balance: 16000000000

eth1_follow_distance: 2048

min_validator_withdrawability_delay: 256

shard_committee_period: 256

deneb_fork_epoch: 0

electra_fork_epoch: 0

fulu_fork_epoch: 18446744073709551615

network_sync_base_url: https://snapshots.ethpandaops.io/

force_snapshot_sync: false

samples_per_slot: 8

custody_requirement: 4

max_blobs_per_block_electra: 9

target_blobs_per_block_electra: 6

base_fee_update_fraction_electra: 5007716

additional_preloaded_contracts: {}

devnet_repo: ethpandaops

prefunded_accounts: {}

additional_services: []

dora_params:

image: ""

tx_fuzz_params:

tx_fuzz_extra_args: []

spamoor_params:

min_cpu: 100

max_cpu: 1000

min_mem: 20

max_mem: 300

extra_args: []

prometheus_params:

storage_tsdb_retention_time: "1d"

storage_tsdb_retention_size: "512MB"

min_cpu: 10

max_cpu: 1000

min_mem: 128

max_mem: 2048

grafana_params:

additional_dashboards: []

min_cpu: 10

max_cpu: 1000

min_mem: 128

max_mem: 2048

assertoor_params:

image: ""

run_stability_check: false

run_block_proposal_check: false

run_transaction_test: false

run_blob_transaction_test: false

run_opcodes_transaction_test: false

run_lifecycle_test: false

tests: []

wait_for_finalization: false

global_log_level: info

snooper_enabled: false

ethereum_metrics_exporter_enabled: false

parallel_keystore_generation: false

disable_peer_scoring: false

persistent: false

mev_type: null

mev_params:

mev_relay_image: ethpandaops/mev-boost-relay:main

mev_builder_image: ethpandaops/flashbots-builder:main

mev_builder_cl_image: sigp/lighthouse:latest

mev_boost_image: ethpandaops/mev-boost:develop

mev_boost_args: ["mev-boost", "--relay-check"]

mev_relay_api_extra_args: []

mev_relay_housekeeper_extra_args: []

mev_relay_website_extra_args: []

mev_builder_extra_args: []

mev_builder_prometheus_config:

scrape_interval: 15s

labels: {}

custom_flood_params:

interval_between_transactions: 1

xatu_sentry_enabled: false

xatu_sentry_params:

xatu_sentry_image: ethpandaops/xatu-sentry

xatu_server_addr: localhost:8000

xatu_server_tls: false

xatu_server_headers: {}

beacon_subscriptions:

- attestation

- block

- chain_reorg

- finalized_checkpoint

- head

- voluntary_exit

- contribution_and_proof

- blob_sidecar

apache_port: 40000

global_tolerations: []

global_node_selectors: {}

keymanager_enabled: false

checkpoint_sync_enabled: false

checkpoint_sync_url: ""

ethereum_genesis_generator_params:

image: ethpandaops/ethereum-genesis-generator:4.0.4

port_publisher:

nat_exit_ip: KURTOSIS_IP_ADDR_PLACEHOLDER

el:

enabled: false

public_port_start: 32000

cl:

enabled: false

public_port_start: 33000

vc:

enabled: false

public_port_start: 34000

remote_signer:

enabled: false

public_port_start: 35000

additional_services:

enabled: false

public_port_start: 36000

participants:

- el_type: geth

cl_type: lighthouse

vc_type: charon

vc_image: obolnetwork/charon:latest

charon_node_count: 4

charon_params:

charon_vc: teku

charon_vc_image: consensys/teku:latest

validator_count: null

use_remote_signer: false

- el_type: geth

cl_type: lighthouse

count: 2

feat: add remote write via KaloyanTanev/prometheus-package fork

Charon writes split-key password files as 0400/root. Non-root VC images (teku, lodestar) could not read the password files nor create teku .lock files. chmod the converter output so they are accessible. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

A Charon distributed validator shares the same validator pubkeys across all cluster nodes (threshold signing). Nimbus VC enables doppelganger detection by default: at startup it watches ~2 epochs for its validators attesting elsewhere as an anti-slashing check. Because the cluster as a whole attests those pubkeys, each Nimbus VC sees its own validators live on the network and self-terminates at the epoch-1 boundary (FATAL, exit 127) -- taking down every VC in the DV and leaving Charon reporting 'VC not connected'. Add --doppelganger-detection=false in the distributed branch only; standalone Nimbus VCs keep it enabled.

sugh01 changed the title ~~Charon~~ feat :Charon Jun 11, 2025

sugh01 changed the title ~~feat :Charon~~ feat: Charon Jun 11, 2025

aly-obol approved these changes Jun 16, 2025

View reviewed changes

sugh01 added 15 commits June 16, 2026 18:28

bootstrap charon launcher

38abf76

adds charon key formatter service

96e44b5

removes redundant code

6c883c9

Persists charon cluster artefacts

bf90e5f

adds charon service, the feature is still broken

658f009

adds an experimental charon:local to debug run

2df8c98

adds lighthouse vc integration with Charon

4bb5837

adds lodestar and teku vc

e4cb57a

adds nimbus vc

bff3886

adds prysm vc

ff6acec

replaces hard coded values with constants

92f5c12

replaces hard coded values with constants

24e022f

uses charon_oparams field to configure charon VCs

36586e4

removes unused files

4150572

adds readme

fa0376b

KaloyanTanev force-pushed the charon branch from 8a14d75 to fa0376b Compare June 16, 2026 15:33

KaloyanTanev added 9 commits June 17, 2026 12:19

Change from ethpandaops to ObolNetwork

0b0ff27

Various fixes after rebase

ed3ca90

Default to 4 charon nodes

7488a41

Gate the DV path

709f925

Spin up own relay; fix metrics; cleanup unused calls

5239d4e

Various charon updates; add vouch VC

318b6b5

Add remote write option to Prometheus

b830840

Don't launch Vouch outside of DVs

902261c

Test remote write with changes in the original prometheus kurtosis pa…

6c441d4

…ckage

KaloyanTanev and others added 7 commits June 24, 2026 15:49

Fix prometheus metrics

d1d0318

Revert unrelated formatting

df92bec

Fix linting

8fb6f53

Fix linting

40d5c08

Merge branch 'main' into charon

75be305

barnabasbusa reviewed Jun 24, 2026

View reviewed changes

KaloyanTanev and others added 6 commits June 25, 2026 12:22

Reuse pre-existing VC modules; add Vouch VC module

087e3ee

Move Charon key formatting to the generator

1b18387

Merge pull request #2 from ObolNetwork/charon-remote-write

94515b8

feat: add remote write via KaloyanTanev/prometheus-package fork

Increase max threads Teku VC can keep to Charon to 50

7e22a12

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: Charon - #1062

feat: Charon#1062
sugh01 wants to merge 37 commits into
ethpandaops:mainfrom
ObolNetwork:charon

sugh01 commented Jun 11, 2025 •

edited

Loading

Uh oh!

barnabasbusa commented Jun 19, 2025

Uh oh!

sugh01 commented Aug 8, 2025

Uh oh!

barnabasbusa Jun 24, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Uh oh!

Conversation

sugh01 commented Jun 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

This PR implements Charon distributed validator support in the Kurtosis Ethereum package.

Validators supported

Configuration

Core Component

Uh oh!

barnabasbusa commented Jun 19, 2025

Uh oh!

sugh01 commented Aug 8, 2025

Uh oh!

barnabasbusa Jun 24, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

sugh01 commented Jun 11, 2025 •

edited

Loading