From a6d4293f91c79555688528c29bf6a5c9853b57dc Mon Sep 17 00:00:00 2001 From: diego Date: Thu, 12 Jun 2025 11:01:19 +0200 Subject: [PATCH 1/2] Add more context to Late Block Re-orgs --- book/src/advanced_re-orgs.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/book/src/advanced_re-orgs.md b/book/src/advanced_re-orgs.md index fca156bda3f..b0e55ef1ecb 100644 --- a/book/src/advanced_re-orgs.md +++ b/book/src/advanced_re-orgs.md @@ -2,6 +2,10 @@ Since v3.4.0 Lighthouse will opportunistically re-org late blocks when proposing. +When Lighthouse is about to propose a new block, it quickly checks whether the block from the previous slot landed so late that hardly anyone attested to it. +If that late block looks weak enough, Lighthouse may decide to “re-org” it away: instead of building on it, Lighthouse builds its new block on the grand-parent block, turning the late block into an orphan. +Because Lighthouse only does this when the opportunity presents itself and the odds of success are good, the code calls the behaviour “opportunistically re-organising late blocks when proposing. + This feature is intended to disincentivise late blocks and improve network health. Proposing a re-orging block is also more profitable for the proposer because it increases the number of attestations and transactions that can be included. From f9680a5fab28264dbfcfebd6f2732e7fdcc5a00f Mon Sep 17 00:00:00 2001 From: diego Date: Fri, 13 Jun 2025 10:08:08 +0200 Subject: [PATCH 2/2] address review --- book/src/advanced_re-orgs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/book/src/advanced_re-orgs.md b/book/src/advanced_re-orgs.md index b0e55ef1ecb..3a31778786d 100644 --- a/book/src/advanced_re-orgs.md +++ b/book/src/advanced_re-orgs.md @@ -4,7 +4,6 @@ Since v3.4.0 Lighthouse will opportunistically re-org late blocks when proposing When Lighthouse is about to propose a new block, it quickly checks whether the block from the previous slot landed so late that hardly anyone attested to it. If that late block looks weak enough, Lighthouse may decide to “re-org” it away: instead of building on it, Lighthouse builds its new block on the grand-parent block, turning the late block into an orphan. -Because Lighthouse only does this when the opportunity presents itself and the odds of success are good, the code calls the behaviour “opportunistically re-organising late blocks when proposing. This feature is intended to disincentivise late blocks and improve network health. Proposing a re-orging block is also more profitable for the proposer because it increases the number of