lighthouse/book/src
Michael Sproul 775d222299 Enable proposer boost re-orging (#2860)
## Proposed Changes

With proposer boosting implemented (#2822) we have an opportunity to re-org out late blocks.

This PR adds three flags to the BN to control this behaviour:

* `--disable-proposer-reorgs`: turn aggressive 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.

For safety Lighthouse will only attempt a re-org under very specific conditions:

1. The block being proposed is 1 slot after the canonical head, and the canonical head is 1 slot after its parent. i.e. at slot `n + 1` rather than building on the block from slot `n` we build on the block from slot `n - 1`.
2. The current canonical head received less than N% of the committee vote. N should be set depending on the proposer boost fraction itself, the fraction of the network that is believed to be applying it, and the size of the largest entity that could be hoarding votes.
3. The current canonical head arrived after the attestation deadline from our perspective. This condition was only added to support suppression of forkchoiceUpdated messages, but makes intuitive sense.
4. The block is being proposed in the first 2 seconds of the slot. This gives it time to propagate and receive the proposer boost.


## Additional Info

For the initial idea and background, see: https://github.com/ethereum/consensus-specs/pull/2353#issuecomment-950238004

There is also a specification for this feature here: https://github.com/ethereum/consensus-specs/pull/3034

Co-authored-by: Michael Sproul <micsproul@gmail.com>
Co-authored-by: pawan <pawandhananjay@gmail.com>
2022-12-13 09:57:26 +00:00
..
css Make API friendly to block explorers (#702) 2019-12-19 11:45:28 +11:00
js Add support for multiple testnet flags (#1396) 2020-07-29 06:39:29 +00:00
advanced_database.md Reformat tables and add borders (#3377) 2022-07-27 00:51:07 +00:00
advanced_metrics.md Configurable monitoring endpoint frequency (#3530) 2022-09-05 08:29:00 +00:00
advanced_networking.md Book spelling and grammar corrections (#3659) 2022-10-28 03:23:50 +00:00
advanced-datadir.md Fixing a few typos / documentation (#3531) 2022-09-05 04:50:48 +00:00
advanced-pre-releases.md Fix links in docs (#3219) 2022-05-31 06:09:07 +00:00
advanced-release-candidates.md Use "release candidate" in book (#2920) 2022-01-17 06:09:58 +00:00
advanced.md Document the freezer DB space-time trade-off (#808) 2020-01-20 10:01:58 +11:00
api-bn.md Correct typos book (#3099) 2022-03-20 22:48:15 +00:00
api-lighthouse.md Update book with missing Lighthouse endpoints (#3769) 2022-12-09 09:20:10 +00:00
api-vc-auth-header.md Implement standard keystore API (#2736) 2022-01-30 23:22:04 +00:00
api-vc-endpoints.md Add API endpoint to get VC graffiti (#3779) 2022-12-09 09:20:13 +00:00
api-vc-sig-header.md Implement VC API (#1657) 2020-10-02 09:42:19 +00:00
api-vc.md Implement standard keystore API (#2736) 2022-01-30 23:22:04 +00:00
api.md Update book with missing Lighthouse endpoints (#3769) 2022-12-09 09:20:10 +00:00
builders.md Enable proposer boost re-orging (#2860) 2022-12-13 09:57:26 +00:00
checkpoint-sync.md Use generic domain for community checkpoint sync example (#3560) 2022-09-10 01:35:11 +00:00
cli.md Rename Eth1/Eth2 in documents (#3021) 2022-03-02 01:05:08 +00:00
contributing.md [Contribution docs] Add GitPOAP Badge to Display Number of Minted GitPOAPs for Contributors (#3343) 2022-08-09 02:27:04 +00:00
cross-compiling.md Add maxperf build profile (#3608) 2022-09-29 06:13:33 +00:00
database-migrations.md Delete DB schema migrations for v11 and earlier (#3761) 2022-12-02 00:07:43 +00:00
docker.md Fix some typos (#3376) 2022-07-27 00:51:06 +00:00
faq.md Fixing a few typos / documentation (#3531) 2022-09-05 04:50:48 +00:00
graffiti.md Update graffiti.md (#3537) 2022-09-05 08:29:02 +00:00
homebrew.md Document Homebrew package (#2885) 2022-01-08 01:15:07 +00:00
http.md Rename Eth1/Eth2 in documents (#3021) 2022-03-02 01:05:08 +00:00
installation-binaries.md More merge doc updates (#3509) 2022-08-26 21:47:50 +00:00
installation-priorities.md Reformat tables and add borders (#3377) 2022-07-27 00:51:07 +00:00
installation-source.md Add maxperf build profile (#3608) 2022-09-29 06:13:33 +00:00
installation.md More merge doc updates (#3509) 2022-08-26 21:47:50 +00:00
intro.md Add Run a Node guide (#3681) 2022-11-28 10:05:43 +00:00
key-management.md Book spelling and grammar corrections (#3659) 2022-10-28 03:23:50 +00:00
key-recovery.md Rename Eth1/Eth2 in documents (#3021) 2022-03-02 01:05:08 +00:00
late-block-re-orgs.md Enable proposer boost re-orging (#2860) 2022-12-13 09:57:26 +00:00
mainnet-validator.md Fix some typos (#3376) 2022-07-27 00:51:06 +00:00
merge-migration.md Add Run a Node guide (#3681) 2022-11-28 10:05:43 +00:00
pi.md Fix broken links in book (#2912) 2022-01-14 00:38:04 +00:00
redundancy.md Update stale sections of the book (#3671) 2022-11-07 06:48:32 +00:00
run_a_node.md Add Run a Node guide (#3681) 2022-11-28 10:05:43 +00:00
setup.md Libp2p v0.48.0 upgrade (#3547) 2022-09-29 01:50:11 +00:00
slasher.md Modularise slasher backend (#3443) 2022-08-15 01:30:56 +00:00
slashing-protection.md Fix some typos (#3376) 2022-07-27 00:51:06 +00:00
suggested-fee-recipient.md remove strict fee recipient docs (#3551) 2022-09-08 00:06:25 +00:00
SUMMARY.md Enable proposer boost re-orging (#2860) 2022-12-13 09:57:26 +00:00
system-requirements.md Document system requirements (#1934) 2020-11-19 21:23:56 +00:00
testnet-validator.md Rename Eth1/Eth2 in documents (#3021) 2022-03-02 01:05:08 +00:00
validator-create.md Rename Eth1/Eth2 in documents (#3021) 2022-03-02 01:05:08 +00:00
validator-doppelganger.md Rename Eth1/Eth2 in documents (#3021) 2022-03-02 01:05:08 +00:00
validator-import-launchpad.md Fix some typos (#3376) 2022-07-27 00:51:06 +00:00
validator-inclusion.md Rename Eth1/Eth2 in documents (#3021) 2022-03-02 01:05:08 +00:00
validator-management.md Change --testnet flag to --network (#1751) 2020-11-23 23:54:03 +00:00
validator-monitoring.md Configurable monitoring endpoint frequency (#3530) 2022-09-05 08:29:00 +00:00
validator-web3signer.md Add client authentication to Web3Signer validators (#3170) 2022-05-18 23:14:37 +00:00
voluntary-exit.md Correct typos book (#3099) 2022-03-20 22:48:15 +00:00
wallet-create.md Book spelling and grammar corrections (#3659) 2022-10-28 03:23:50 +00:00