gnosis/lighthouse
1
0
Fork 0
mirror of https://github.com/sigp/lighthouse.git synced 2026-05-30 04:37:13 +00:00
Code Issues Packages Projects Releases Wiki Activity

Deprecate some reorg-related CLI flags and read from spec (#9177)

Browse Source 
- #9123


  


Co-Authored-By: Tan Chee Keong <tanck@sigmaprime.io>

Co-Authored-By: chonghe <44791194+chong-he@users.noreply.github.com>
This commit is contained in:
chonghe
2026-05-25 10:11:27 +08:00
committed by GitHub
parent b5d44bff36
commit 9b961960c4
16 changed files with 141 additions and 253 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
book/src/advanced_re-orgs.md
View File

@@ -14,14 +14,6 @@ attestations and transactions that can be included.
There are three flags which control the re-orging behaviour:
* `--disable-proposer-reorgs`: turn re-orging off (it's on by default).
* `--proposer-reorg-threshold N`: attempt to orphan blocks with less than N% of the committee vote. If this parameter isn't set then N defaults to 20% when the feature is enabled.
* `--proposer-reorg-epochs-since-finalization N`: only attempt to re-org late blocks when the number of epochs since finalization is less than or equal to N. The default is 2 epochs,
meaning re-orgs will only be attempted when the chain is finalizing optimally.
* `--proposer-reorg-cutoff T`: only attempt to re-org late blocks when the proposal is being made
before T milliseconds into the slot. Delays between the validator client and the beacon node can
cause some blocks to be requested later than the start of the slot, which makes them more likely
to fail. The default cutoff is 1000ms on mainnet, which gives blocks 3000ms to be signed and
propagated before the attestation deadline at 4000ms.
* `--proposer-reorg-disallowed-offsets N1,N2,N3...`: Prohibit Lighthouse from attempting to reorg at
specific offsets in each epoch. A disallowed offset `N` prevents reorging blocks from being
proposed at any `slot` such that `slot % SLOTS_PER_EPOCH == N`. The value to this flag is a

14
book/src/help_bn.md
View File

@@ -306,10 +306,7 @@ Options:
values are useful for ensuring the EL is given ample notice. Default:
1/3 of a slot.
--proposer-reorg-cutoff <MILLISECONDS>
Maximum delay after the start of the slot at which to propose a
reorging block. Lower values can prevent failed reorgs by ensuring the
block has ample time to propagate and be processed by the network. The
default is 1/12th of a slot (1 second on mainnet)
DEPRECATED. This flag has no effect.
--proposer-reorg-disallowed-offsets <N1,N2,...>
Comma-separated list of integer offsets which can be used to avoid
proposing reorging blocks at certain slots. An offset of N means that
@@ -318,14 +315,11 @@ Options:
avoided. Any offsets supplied with this flag will impose additional
restrictions.
--proposer-reorg-epochs-since-finalization <EPOCHS>
Maximum number of epochs since finalization at which proposer reorgs
are allowed. Default: 2
DEPRECATED. This flag has no effect.
--proposer-reorg-parent-threshold <PERCENT>
Percentage of parent vote weight above which to attempt a proposer
reorg. Default: 160%
DEPRECATED. This flag has no effect.
--proposer-reorg-threshold <PERCENT>
Percentage of head vote weight below which to attempt a proposer
reorg. Default: 20%
DEPRECATED. This flag has no effect.
--prune-blobs <BOOLEAN>
Prune blobs from Lighthouse's database when they are older than the
data data availability boundary relative to the current epoch.