Built-in networks can't start from genesis without --checkpoint-sync-url

Open
#823 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 6 days

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
35/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
rust

Research direction

Start with docs/checkpoint_sync.md and trace the CheckpointSyncError::BeaconGenesisSync path for built-in networks and loaded network directories. Check whether beacon nodes range-sync forward after a peer's Status, as the issue suggests, before deciding between a genesis anchor and documenting the refusal. Done means choosing and implementing a supported behavior, with validation against the built-in genesis time and validators root if an anchor is added.

Written by the indexing model from the issue text.

Description

Summary

On a fresh data directory, ethlambda beacon --network mainnet|sepolia|hoodi|plataberget without --checkpoint-sync-url aborts at startup with CheckpointSyncError::BeaconGenesisSync. The built-in networks have no genesis-sync path, because the binary doesn't embed their genesis states (about 5 MB for mainnet, 150 MB for Hoodi). A loaded network directory falls back to its own genesis.ssz instead. See docs/checkpoint_sync.md.

Where it shows up

ethereum-package with checkpoint_sync_enabled: false on a public network: the ethlambda node exits at startup. In that case the package passes Lighthouse --allow-insecure-genesis-sync --ignore-ws-check, so Lighthouse syncs from genesis behind an explicit opt-in. ethpandaops/ethereum-package#1515 doesn't guard against this combination yet.

Options

  1. An opt-in genesis anchor for the built-in networks, like Lighthouse's flag: load the genesis state from a path or URL (for example --genesis-state <path|url>), and check it against the built-in genesis_time and genesis_validators_root the same way a checkpoint anchor is checked.
  2. Keep refusing, and make that the documented answer. ethereum-package#1515 would then reject checkpoint_sync_enabled: false with ethlambda on a public network in input_parser, with a clear message.

docs/checkpoint_sync.md explains the refusal by saying the follower "imports nothing past its anchor", so a genesis anchor would stay parked at slot 0. The beacon node now range-syncs forward after a peer's Status, so that reason may be out of date. It's worth re-checking before choosing.

Dominant language
Rust
Stars
86
Forks
34
Avg merge
9d 20h
Merged PRs (30d)
77

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from lambdaclass/ethlambda

All issues in lambdaclass/ethlambda

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.