From 8fbf8395ea8f6e160f1dec539b33aa2292e80855 Mon Sep 17 00:00:00 2001 From: Alex Stokes Date: Thu, 7 Jul 2022 16:23:14 -0500 Subject: [PATCH 1/4] run `doctoc` --- specs/validator.md | 1 + 1 file changed, 1 insertion(+) diff --git a/specs/validator.md b/specs/validator.md index 7240ca5..37c119a 100644 --- a/specs/validator.md +++ b/specs/validator.md @@ -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) From 3dd3c87f84242bb60ab04c1b7492d8e153a5ef33 Mon Sep 17 00:00:00 2001 From: Alex Stokes Date: Thu, 7 Jul 2022 16:30:37 -0500 Subject: [PATCH 2/4] add note about delaying use of builder network through Merge --- specs/validator.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/specs/validator.md b/specs/validator.md index 37c119a..ef00c5d 100644 --- a/specs/validator.md +++ b/specs/validator.md @@ -46,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 @@ -149,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 @@ -162,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 From 831bd736d1a1fcf3f5a495801b6a00822d193944 Mon Sep 17 00:00:00 2001 From: Alex Stokes Date: Thu, 7 Jul 2022 16:34:47 -0500 Subject: [PATCH 3/4] add `EIP` to allowed wordlist for spellcheck --- wordlist.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/wordlist.txt b/wordlist.txt index 136669a..3d41c38 100644 --- a/wordlist.txt +++ b/wordlist.txt @@ -24,3 +24,4 @@ validators validator's vc wei +EIP From df9533d996b60472093836e9e225f7b37ea29c21 Mon Sep 17 00:00:00 2001 From: Alex Stokes Date: Mon, 18 Jul 2022 11:31:29 -0600 Subject: [PATCH 4/4] Remove additional delay to further reduce complexity --- specs/validator.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/specs/validator.md b/specs/validator.md index ef00c5d..c12dfd9 100644 --- a/specs/validator.md +++ b/specs/validator.md @@ -46,7 +46,6 @@ 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 @@ -153,12 +152,10 @@ network. 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 +Concretely, honest validators **MUST** wait until 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 [register-validator-with-builder]: https://ethereum.github.io/builder-specs/#/Builder/registerValidator