v1.3.0 - 2025-03-26
This is Charon's first Electra-ready version. Feedback is welcome and appreciated, please use github issues or discord if you have trouble with this release.
As well as supporting the Electra hardfork, some notable user-facing features shipping in this release include:
- Charon's
--nicknameflag, which allows operators to set human readable nicknames in monitoring. These aim to make identifying operators more convenient. - Charon's
--fallback-beacon-nodesflag, which allows operators to specify backup beacon nodes used when primaries fail, rather than using multiple BNs as primaries at all times. - Charon's
--beacon-node-headersflag, which allows operators to attach HTTP headers to requests to their beacon node(s), enabling header based auth and HTTP Basic auth on beacon nodes.
Read the rest of the release notes for more:
Features
- Electra compatibility #3468 #3466 #3473 #3482 #3487 #3491 #3501 #3514 #3520 #3525 #3536 #3539
- Consensus abstraction #3301 #3313 #3307 #3318 #3327 #3416
- Nicknames #3428 #3467 #3533 #3556
- Fallback beacon nodes #3342 #3459 #3534 #3538 #3511
- Beacon node extra headers #3449 #3515
- Add new consensus round time #3440 #3470
- Check proposal data against consensus one #3292
- Add custom target gas limit in cluster lock v1.10 #3456
- Add Hoodi network #3587
Bugfixes
- Broadcast all exits when not all are activated #3489
- Refresh active validators by slot instead of by head #3500
- Fix loaded keys ordering #3524
Misc
- Add warnings for block proposal v1 and v2 endpoints #3431
- Log latency on BN requests if above 1s #3417
- Function names in comment #3513
- Add more granular buckets for some metrics #3570
Docs
Infra
- Automate PR for releases #3407, #3438
- Dispatch only for specific tags #3411
- Allow golangci-lint parallel on .pre-commit #3455
- Add chown for gitlab runner #3441
- Update GitHub Actions #3490
- Fix tag latest with strict rule #3492 #3494 #3495 #3497
- Add electra branch tag #3499
- Update build-push-deploy-promrated #3437
- Update golangci-lint name rule #3535
- Add renovate #3529 #3549
Tests
- Fix nightly test #3343
- Fix compose files #3397
- Fix TestSyncFlow #3410
- Bump compose tool components #3409
Compatibility Matrix
This release of Charon is backwards compatible with Charon v1.0, v1.1, v1.2.
The below matrix details a combination of beacon node (consensus layer) + validator clients and their corresponding versions the DV Labs team have tested with this Charon release. More validator and consensus client will be added to this list as they are supported in our automated testing framework.
Legend
- ✅: All duties succeed in testing
- 🟡: All duties succeed in testing, except non-penalised aggregation duties
- 🟠: Duties may fail for this combination
- 🔴: One or more duties fails consistently
| Validator 👉 Consensus 👇 | Teku v25.3.0 | Lighthouse v7.0.0-beta4 | Lodestar v1.28.1 | Nimbus v25.3.1 | Prysm v5.3.1 | Remarks |
|---|---|---|---|---|---|---|
| Teku v25.3.0 | ✅ | 🟡 | ✅ | ✅ | 🟠 | Teku beacon node needs the --validators-graffiti-client-append-format=DISABLED flag in order to produce blocks properly. Teku validator client is only failing aggregation duties 50% of the time, which are not directly penalised but impact network density at high scale.
|
| Lighthouse v7.0.0-beta4 | ✅ | 🟡 | ✅ | ✅ | ✅ | Lighthouse validator client is only failing aggregation duties, which are not directly penalised but impact network density at high scale.
|
| Lodestar v1.28.1 | ✅ | 🟡 | ✅ | ✅ | 🟠 | |
| Nimbus v25.3.1 | ✅ | 🟡 | ✅ | ✅ | 🟠 | |
| Prysm v5.3.1 | ✅ | 🟡 | ✅ | ✅ | ✅ | Prysm validator client is failing aggregation duties 50% of the time, which are not directly penalised but impact network density at high scale. In some combinations rare failures of attestation and proposal duties were observed (0-2% per epoch).
|
Full Changelog: v1.2.0..v1.3.0
What's Changed
- app: generic consensus debugger by @pinebit in #3301
- cmd: print consensus protocols by @pinebit in #3313
- *: removing mutable config by @pinebit in #3307
- *: cluster definition v1.9 by @pinebit in #3318
- testutil/integration: fix nightly test behavior by @gsora in #3343
- *: consensus abstraction by @pinebit in #3327
- docs: fix typos in documentation files by @cypherpepe in #3364
- testutil: fixed compose files by @pinebit in #3397
- *: automate PR for release CDVN and CDVC by @apham0001 in #3407
- *: bumped libp2p to v0.37.2 by @pinebit in #3408
- dkg: fixing TestSyncFlow by @pinebit in #3410
- testutil: bumped compose tool components by @pinebit in #3409
- build(deps): Bump golang.org/x/sync from 0.9.0 to 0.10.0 by @dependabot in #3401
- build(deps): Bump golang.org/x/crypto from 0.29.0 to 0.30.0 by @dependabot in #3403
- build(deps): Bump golang.org/x/tools from 0.27.0 to 0.28.0 by @dependabot in #3404
- build(deps): Bump github.com/holiman/uint256 from 1.3.1 to 1.3.2 by @dependabot in #3412
- build(deps): Bump golang.org/x/crypto from 0.30.0 to 0.31.0 by @dependabot in #3415
- build(deps): Bump golang from 1.23.3-alpine to 1.23.4-alpine in /testutil/promrated by @dependabot in #3399
- build(deps): Bump golang from 1.23.3-bookworm to 1.23.4-bookworm by @dependabot in #3398
- build(deps): Bump github.com/attestantio/go-builder-client from 0.5.1 to 0.5.2 by @dependabot in #3413
- core/consensus: fixed instance_io race by @pinebit in #3416
- *: add condition to trigger dispatch only for specific tags by @apham0001 in #3411
- *: bump linter v1.62.2 by @KaloyanTanev in #3418
- app/eth2wrap: fallback beacon nodes by @gsora in #3342
- *: bump protobuf to 1.36.2 by @KaloyanTanev in #3439
- build(deps): Bump go.opentelemetry.io/otel/trace from 1.32.0 to 1.33.0 by @dependabot in #3420
- build(deps): Bump go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp from 0.57.0 to 0.58.0 by @dependabot in #3421
- build(deps): Bump google.golang.org/protobuf from 1.35.2 to 1.36.2 by @dependabot in #3442
- build(deps): Bump go.opentelemetry.io/otel/exporters/stdout/stdouttrace from 1.32.0 to 1.33.0 by @dependabot in #3423
- build(deps): Bump golang.org/x/tools from 0.28.0 to 0.29.0 by @dependabot in #3443
- app/peerinfo: add nickname field to peerinfo protocol by @DiogoSantoss in #3428
- core/validatorapi: v1/v2 endpoints warning by @pinebit in #3431
- app: eth2wrap latency logging by @KaloyanTanev in #3417
- *: bump linter to 1.63.4 by @KaloyanTanev in #3444
- build: allow golangci-lint parallel on .pre-commit by @KaloyanTanev in #3455
- fix: chown -R runner:docker 001 folder by @apham0001 in #3441
- docs: contributing discord channel by @KaloyanTanev in #3452
- build(deps): Bump github.com/showwin/speedtest-go from 1.7.9 to 1.7.10 by @dependabot in #3445
- build(deps): Bump golang.org/x/time from 0.8.0 to 0.9.0 by @dependabot in #3446
- build(deps): Bump sigp/lighthouse from v6.0.0 to v6.0.1 in /testutil/compose/static/lighthouse by @dependabot in #3426
- build(deps): Bump chainsafe/lodestar from v1.23.1 to v1.24.0 in /testutil/compose/static/lodestar by @dependabot in #3433
- build(deps): Bump github.com/attestantio/go-builder-client from 0.5.2 to 0.5.3 by @dependabot in #3451
- core/consensus: add new consensus round timer by @DiogoSantoss in #3440
- build(deps): Bump github.com/bufbuild/buf from 1.35.1 to 1.49.0 by @dependabot in #3447
- *: trigger dispatch for LCDVN and Launchpad by @apham0001 in #3438
- *: bumped protoc to fix pre-commit by @pinebit in #3465
- app/eth2wrap: add support for extra headers by @DiogoSantoss in #3449
- app/peerinfo: fix race condition on storing nicknames by @DiogoSantoss in #3467
- docs: improved contributing.md by @pinebit in #3463
- core/consensus: change exponential timer for linear timer by @DiogoSantoss in #3470
- build(deps): Bump google.golang.org/protobuf from 1.36.2 to 1.36.3 by @dependabot in #3460
- build(deps): Bump chainsafe/lodestar from v1.24.0 to v1.25.0 in /testutil/compose/static/lodestar by @dependabot in #3461
- build(deps): Bump golang from 1.23.4-bookworm to 1.23.5-bookworm by @dependabot in #3471
- build(deps): Bump golang from 1.23.4-alpine to 1.23.5-alpine in /testutil/promrated by @dependabot in #3472
- build(deps): Bump go.opentelemetry.io/otel/trace from 1.33.0 to 1.34.0 by @dependabot in #3474
- build(deps): Bump github.com/bufbuild/buf from 1.49.0 to 1.50.0 by @dependabot in #3476
- build(deps): Bump go.opentelemetry.io/otel/exporters/stdout/stdouttrace from 1.33.0 to 1.34.0 by @dependabot in #3475
- *: add custom target gas limit in cluster lock v1.10 by @KaloyanTanev in #3456
- build(deps): Bump go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp from 0.58.0 to 0.59.0 by @dependabot in #3478
- app/eth2wrap: add CLI support for fallback beacon node by @DiogoSantoss in #3459
- build(deps): Bump github.com/jonboulle/clockwork from 0.4.0 to 0.5.0 by @dependabot in #3448
- *: bumped protoc to fix pre-commit by @DiogoSantoss in #3485
- build(deps): Bump google.golang.org/protobuf from 1.36.4-0.20250116160514-2005adbe0cf6 to 1.36.4 by @dependabot in #3483
- *: update github actions by @apham0001 in #3490
- cmd: fetch and broadcast all when not all are activated by @KaloyanTanev in #3489
- build(deps): Bump github.com/spf13/pflag from 1.0.5 to 1.0.6 by @dependabot in #3488
- *: fix tag latest with strict rule by @apham0001 in #3492
- fix: tag latest with startsWith by @apham0001 in #3494
- fix: change type raw to semver to tag latest by @apham0001 in #3495
- fix: latest with startsWith and github.ref by @apham0001 in #3497
- feat: add electra branch support for build and push by @apham0001 in #3499
- ci: optimize Docker build workflow and update actions by @DeVikingMark in #3437
- build(deps): Bump golang from 1.23.5-bookworm to 1.23.6-bookworm by @dependabot in #3502
- build(deps): Bump chainsafe/lodestar from v1.25.0 to v1.26.0 in /testutil/compose/static/lodestar by @dependabot in #3503
- build(deps): Bump golang from 1.23.5-alpine to 1.23.6-alpine in /testutil/promrated by @dependabot in #3504
- build(deps): Bump golang.org/x/time from 0.9.0 to 0.10.0 by @dependabot in #3505
- build(deps): Bump golang.org/x/sync from 0.10.0 to 0.11.0 by @dependabot in #3507
- build(deps): Bump golang.org/x/term from 0.28.0 to 0.29.0 by @dependabot in #3506
- build(deps): Bump google.golang.org/protobuf from 1.36.4 to 1.36.5 by @dependabot in #3512
- app: add headers to httpwrap by @KaloyanTanev in #3515
- app/eth2wrap: fix faulty fallback test by @DiogoSantoss in #3511
- fix: refresh validator by slot instead of by head by @DiogoSantoss in #3500
- ci: update golangci-lint name rule by @DiogoSantoss in #3535
- app/peerinfo: reduce nickname mapping logs by @DiogoSantoss in #3533
- eth2util: fix beacon node headers validation/parsing by @DiogoSantoss in #3534
- *: add renovate.json by @apham0001 in #3529
- cmd: fixed loaded keys ordering by @pinebit in #3524
- build(deps): Bump golang.org/x/crypto from 0.32.0 to 0.33.0 by @dependabot in #3521
- build(deps): Bump golang.org/x/tools from 0.29.0 to 0.30.0 by @dependabot in #3523
- build(deps): Bump golang from 1.23.6-bookworm to 1.24.0-bookworm by @dependabot in #3526
- build(deps): Bump chainsafe/lodestar from v1.26.0 to v1.27.0 in /testutil/compose/static/lodestar by @dependabot in #3527
- build(deps): Bump golang from 1.23.6-alpine to 1.24.0-alpine in /testutil/promrated by @dependabot in #3528
- feat: add fallback beacon node metric by @DiogoSantoss in #3538
- build(deps): Bump github.com/prometheus/client_golang from 1.20.5 to 1.21.0 by @dependabot in #3537
- build(deps): Bump github.com/spf13/cobra from 1.8.1 to 1.9.1 by @dependabot in #3531
- feat: skip Renovate PRs during verification by @apham0001 in #3549
- build(deps): Bump github.com/herumi/bls-eth-go-binary from 1.36.1 to 1.36.4 by @dependabot in #3532
- root: update LICENSE by @maximevtush in #3508
- *: fix some function names in comment by @sjtucoder in #3513
- chore(deps): update codecov/codecov-action action to v3.1.6 by @renovate in #3540
- chore(deps): update actions/cache action to v4 - autoclosed by @renovate in #3541
- chore(deps): update actions/github-script action to v7 by @renovate in #3543
- chore(deps): update actions/setup-go action to v5 by @renovate in #3544
- chore(deps): update docker/metadata-action action to v5 by @renovate in #3548
- chore(deps): update codecov/codecov-action action to v5 by @renovate in #3545
- chore(deps): update github/codeql-action action to v3 by @renovate in #3552
- chore(deps): update docker/build-push-action action to v6 by @renovate in #3546
- chore(deps): update docker/login-action action to v3 by @renovate in #3547
- chore(deps): update docker/setup-buildx-action action to v3 by @renovate in #3550
- chore(deps): update peter-evans/repository-dispatch action to v3 by @renovate in #3553
- chore(deps): update softprops/action-gh-release action to v2 by @renovate in #3555
- chore(deps): update pre-commit/action action to v3 by @renovate in #3554
- chore(deps): update docker/setup-qemu-action action to v3 by @renovate in #3551
- build(deps): Bump github.com/decred/dcrd/dcrec/secp256k1/v4 from 4.3.0 to 4.4.0 by @dependabot in #3557
- app: add nickname label to metrics by @DiogoSantoss in #3556
- *: electra by @KaloyanTanev in #3558
- build(deps): Bump chainsafe/lodestar from v1.27.0 to v1.27.1 in /testutil/compose/static/lodestar by @dependabot in #3561
- app: v1.3-rc1 by @KaloyanTanev in #3566
New Contributors
- @cypherpepe made their first contribution in #3364
- @DiogoSantoss made their first contribution in #3428
- @DeVikingMark made their first contribution in #3437
- @maximevtush made their first contribution in #3508
- @sjtucoder made their first contribution in #3513
- @renovate made their first contribution in #3540
Full Changelog: v1.2.0...v1.3.0