Skip to content
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

Jump to bottom

Merge transition delay #38

Merged
merged 4 commits into from
Jul 28, 2022
Merged

Merge transition delay #38

Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
8fbf839
run `doctoc`
ralexstokes Jul 7, 2022
3dd3c87
add note about delaying use of builder network through Merge
ralexstokes Jul 7, 2022
831bd73
add `EIP` to allowed wordlist for spellcheck
ralexstokes Jul 7, 2022
df9533d
Remove additional delay to further reduce complexity
ralexstokes Jul 18, 2022
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
15 changes: 11 additions & 4 deletions specs/validator.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@
- [Relation to local block building](#relation-to-local-block-building)
- [How to avoid slashing](#how-to-avoid-slashing)
- [Proposer slashing](#proposer-slashing)
- [Responsibilites during the Merge transition](#responsibilites-during-the-merge-transition)

<!-- END doctoc generated TOC please keep comment here to allow auto update -->

Expand All @@ -45,6 +46,7 @@ and by extension the [Bellatrix consensus specs][bellatrix-specs].
| - | - | - |
| `EPOCHS_PER_VALIDATOR_REGISTRATION_SUBMISSION` | 1 | epoch(s)|
| `BUILDER_PROPOSAL_DELAY_TOLERANCE` | 1 | second(s) |
| `MERGE_DELAY` | 16 | epoch(s) |

## Validator registration

Expand Down Expand Up @@ -148,10 +150,14 @@ network.

## Responsibilites during the Merge transition

Honest validators will not utilize the external builder network until after the transition from the proof-of-work chain
to the proof-of-stake beacon chain has been finalized by the proof-of-stake validators. This requirement is in place
to reduce the overall technical complexity of the Merge. Concretely this means a honest validator client will not use
any of the builder APIs or run any builder software until the Merge has finalized.
Honest validators will not utilize the external builder network during the transition from proof-of-work to
proof-of-stake. This requirement is in place to reduce the overall technical complexity of the Merge.

Concretely, honest validators **MUST** wait until `MERGE_DELAY` epochs after the transition has been finalized before
they can start querying the external builder network. See [EIP-3675](eip-3675) for further details about the transition
process itself.

* NOTE: if the merge transition happens in epoch N and is finalized in epoch N+2, then proposers **MUST** not use the external builder network until epoch N + 2 + `MERGE_DELAY`.

[builder-spec]: ./builder.md
[builder-spec-apis]: ./builder.md#endpoints
Expand All @@ -161,3 +167,4 @@ any of the builder APIs or run any builder software until the Merge has finalize
[beacon-node-apis]: https://ethereum.github.io/beacon-APIs
[bellatrix-specs]: https://github.com/ethereum/consensus-specs/blob/dev/specs/bellatrix
[bellatrix-validator-specs]: https://github.com/ethereum/consensus-specs/blob/dev/specs/bellatrix/validator.md
[eip-3675]: https://eips.ethereum.org/EIPS/eip-3675
1 change: 1 addition & 0 deletions wordlist.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,3 +24,4 @@ validators
validator's
vc
wei
EIP