Skip to content

checkpoint sync API specification#279

Merged
tcoratger merged 8 commits intoleanEthereum:mainfrom
ch4r10t33r:main
Jan 13, 2026
Merged

checkpoint sync API specification#279
tcoratger merged 8 commits intoleanEthereum:mainfrom
ch4r10t33r:main

Conversation

@ch4r10t33r
Copy link
Contributor

🗒️ Description

  • Add HTTP API server for checkpoint sync, matching zeam's implementation
  • New /lean/states/finalized endpoint serves finalized state as SSZ binary for fast node bootstrapping
  • New /health endpoint for service health checks
  • Add client utilities for fetching and verifying finalized state from remote nodes

🔗 Related Issues or PRs

✅ Checklist

  • Ran tox checks to avoid unnecessary CI fails:
    uvx tox
  • Considered adding appropriate tests for the changes.
  • Considered updating the online docs in the ./docs/ directory.

@ch4r10t33r ch4r10t33r marked this pull request as draft January 13, 2026 13:43
@ch4r10t33r ch4r10t33r marked this pull request as ready for review January 13, 2026 14:08
Copy link
Collaborator

@tcoratger tcoratger left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just left comments about some simplification to reduce the amount of code but the logic looks reasonable to me.

Copy link
Collaborator

@tcoratger tcoratger left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me, thanks a lot.

@tcoratger tcoratger merged commit 937974c into leanEthereum:main Jan 13, 2026
10 checks passed
@tcoratger tcoratger mentioned this pull request Jan 13, 2026
3 tasks
@unnawut unnawut added this to the pq-devnet-2 milestone Jan 20, 2026
@unnawut unnawut added the specs Scope: Changes to the specifications label Jan 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

specs Scope: Changes to the specifications

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants