From 3a5657750793a8f67556713835d2a4dd18594b12 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Tue, 20 Jan 2026 18:42:01 -0300 Subject: [PATCH 1/4] docs: collapse the completed roadmap into a summary --- README.md | 40 +++++++++++----------------------------- 1 file changed, 11 insertions(+), 29 deletions(-) diff --git a/README.md b/README.md index 0540340..d5c0fe5 100644 --- a/README.md +++ b/README.md @@ -59,38 +59,20 @@ The following links, repos, companies and projects have been important in the de If we forgot to include anyone, please file an issue so we can add you. We always strive to reference the inspirations and code we use, but as an organization with multiple people, mistakes can happen, and someone might forget to include a reference. -## Roadmap - -The initial project setup and integration with [lean-quickstart](https://github.com/blockblaz/lean-quickstart) are complete. - -### Listen for new blocks - -This milestone focuses on connecting to other clients and listening for new blocks through gossipsub. - -- Connect to other peers via libp2p ✅ -- Respond to STATUS messages from other peers ✅ -- Listen for new blocks in gossipsub ✅ +## Current Status -### Compute current chain state +The client implements the core features of a Lean Ethereum consensus client: -This milestone focuses on computing the chain state from the gossiped by peers received. +- **Networking** — libp2p peer connections, STATUS message handling, gossipsub for blocks and attestations +- **State management** — genesis state generation, state transition function, block processing +- **Fork choice** — 3SF-mini fork choice rule implementation with attestation-based head selection +- **Validator duties** — attestation production and broadcasting, block building -- Generate initial state from genesis configuration ✅ -- Implement state transition function ✅ -- Transition state on each new block ✅ +Additional features: -### Apply fork-choice rule +- [leanMetrics](docs/metrics.md) support for monitoring and observability +- [lean-quickstart](https://github.com/blockblaz/lean-quickstart) integration for easier devnet running -This milestone focuses on choosing the head of the chain based on gossiped attestations. - -- Listen for attestations in gossipsub ✅ -- Implement fork-choice rule ✅ -- Apply fork-choice rule based on received attestations ✅ - -### Produce blocks and attestations - -This milestone focuses on performing the duties of a validator. +## Roadmap -- Produce and broadcast attestations on each slot ✅ -- Compute current proposer for each slot ✅ -- Build and broadcast new blocks when proposing ✅ +_TBD_ From bc33aa92c9ecd3a61b58633d039a39725ec40ca1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Tue, 20 Jan 2026 18:46:31 -0300 Subject: [PATCH 2/4] docs: mention pq-devnet-1 support --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index d5c0fe5..a021d27 100644 --- a/README.md +++ b/README.md @@ -73,6 +73,10 @@ Additional features: - [leanMetrics](docs/metrics.md) support for monitoring and observability - [lean-quickstart](https://github.com/blockblaz/lean-quickstart) integration for easier devnet running +### pq-devnet-1 + +We support the [pq-devnet-1 spec](https://github.com/leanEthereum/pm/blob/main/breakout-rooms/leanConsensus/pq-interop/pq-devnet-1.md). A dedicated git branch and docker tag `devnet1` are available for this version. + ## Roadmap _TBD_ From 81d20e5a607589ce4609a46c74c4b9c419ed7983 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Tue, 20 Jan 2026 18:46:49 -0300 Subject: [PATCH 3/4] docs: link metrics/README.md from docs/metrics.md --- docs/metrics.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/metrics.md b/docs/metrics.md index a944d82..21b8a5e 100644 --- a/docs/metrics.md +++ b/docs/metrics.md @@ -2,6 +2,8 @@ We collect various metrics and serve them via a Prometheus-compatible HTTP endpoint at `http://:/metrics` (default: `http://127.0.0.1:5054/metrics`). +We provide a ready-to-use Grafana + Prometheus monitoring stack in the [`metrics/`](../metrics/) directory. It includes pre-configured dashboards from the [leanMetrics](https://github.com/leanEthereum/leanMetrics) repository for visualizing the metrics described below. See the [metrics README](../metrics/README.md) for setup instructions. + The exposed metrics follow [the leanMetrics specification](https://github.com/leanEthereum/leanMetrics/blob/3b32b300cca5ed7a7a2b3f142273fae9dbc171bf/metrics.md), with some metrics not yet implemented. We have a full list of implemented metrics below, with a checkbox indicating whether each metric is currently supported or not. ## Node Info Metrics From 1090e73acfd66e21efdf1265ce9931275c07590f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Tue, 20 Jan 2026 19:05:08 -0300 Subject: [PATCH 4/4] docs: change roadmap for feature list --- README.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index a021d27..3655ffd 100644 --- a/README.md +++ b/README.md @@ -77,6 +77,13 @@ Additional features: We support the [pq-devnet-1 spec](https://github.com/leanEthereum/pm/blob/main/breakout-rooms/leanConsensus/pq-interop/pq-devnet-1.md). A dedicated git branch and docker tag `devnet1` are available for this version. -## Roadmap +## Incoming features -_TBD_ +Some features we are looking to implement in the near future, in order of priority: + +- [pq-devnet-2](https://github.com/leanEthereum/pm/blob/main/breakout-rooms/leanConsensus/pq-interop/pq-devnet-2.md) support: signature aggregation with leanMultisig +- Data persistence: DB-backed Store +- Historical syncing from genesis for existing devnets +- Checkpoint sync for long-lived networks +- Observability: more metrics from leanMetrics and better logs +- RPC endpoints for chain data consumption