Skip to content

Add more context to Late Block Re-orgs #7592

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jun 14, 2025
Merged

Add more context to Late Block Re-orgs #7592

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a6d4293
Add more context to Late Block Re-orgs
diegomrsantos Jun 12, 2025
f9680a5
address review
diegomrsantos Jun 13, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions book/src/advanced_re-orgs.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Copy link
Member

@michaelsproul michaelsproul Jun 13, 2025

Choose a reason for hiding this comment

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

I think the last sentence makes it too obvious that the paragraph above was written by a different author 😅 . I think we could could remove the "Since v3.4.0 Lighthouse will opportunistically re-org late blocks when proposing" paragraph altogether, and re-phrase (or remove) this sentence?

Copy link
Member Author

@diegomrsantos diegomrsantos Jun 13, 2025

Choose a reason for hiding this comment

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

I removed the last sentence.


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.
Expand Down