Skip to content

Commit 164f1d8

Browse files
committed
epbs related copy changes
1 parent 3064374 commit 164f1d8

File tree

6 files changed

+16
-10
lines changed

6 files changed

+16
-10
lines changed

apis/beacon/blocks/blocks.v2.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ post:
1111
The beacon node is also expected to integrate the block into the state, but may broadcast it
1212
before doing so, so as to aid timely delivery of the block. Should the block fail full
1313
validation, a separate success response code (202) is used to indicate that the block was
14-
successfully broadcast but failed integration. After Deneb and before Gloas, this additionally instructs
14+
successfully broadcast but failed integration. For Deneb/Electra/Fulu, this additionally instructs
1515
the beacon node to broadcast all given blobs. The broadcast behaviour may be adjusted via the
1616
`broadcast_validation` query parameter.
1717
parameters:

apis/beacon/execution_payload/bid.yaml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@ post:
22
operationId: publishExecutionPayloadBid
33
summary: Publish signed execution payload bid
44
description: |
5-
Instructs the beacon node to broadcast a signed execution payload bid to the beacon network,
6-
to be gossiped for potential inclusion in block building. A success response indicates
5+
Instructs the beacon node to broadcast a signed execution payload bid to the network,
6+
to be gossiped for potential inclusion in block building. A success response (20x) indicates
77
that the bid passed gossip validation and was successfully broadcast onto the network.
88
tags:
99
- Beacon

apis/beacon/execution_payload/envelope.yaml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,12 @@ post:
22
operationId: publishExecutionPayloadEnvelope
33
summary: Publish signed execution payload envelope
44
description: |
5-
Instructs the beacon node to broadcast a signed execution payload envelope to the beacon network,
5+
Instructs the beacon node to broadcast a signed execution payload envelope to the network,
66
to be gossiped for payload validation. A success response (20x) indicates
77
that the envelope passed gossip validation and was successfully broadcast onto the network.
88
tags:
99
- Beacon
10+
- ValidatorRequiredApi
1011
requestBody:
1112
description: "The `SignedExecutionPayloadEnvelope` object to be broadcast."
1213
required: true

apis/validator/block.v4.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
get:
22
tags:
3-
- ValidatorRequiredApi
43
- Validator
4+
- ValidatorRequiredApi
55
operationId: "produceBlockV4"
66
summary: "Produce a new block, without signature."
77
description: |

apis/validator/execution_payload_envelope.yaml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ get:
77
either as json or as bytes serialized by SSZ.
88
tags:
99
- Validator
10+
- ValidatorRequiredApi
1011
parameters:
1112
- name: slot
1213
in: path

validator-flow.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,9 @@ On start of every epoch, validator should [fetch proposer duties](#/Validator/ge
1515
Result is array of objects, each containing proposer pubkey and slot at which he is suppose to propose.
1616

1717
If proposing block, then at immediate start of slot:
18-
1. [Ask Beacon Node for BeaconBlock object](#/Validator/produceBlock)
18+
1. Ask Beacon Node for BeaconBlock object:
19+
- Pre-Gloas forks: [produceBlockV3](#/Validator/produceBlockV3)
20+
- Post-Gloas fork: [produceBlockV4](#/Validator/produceBlockV4)
1921
2. Sign block
2022
3. [Submit SignedBeaconBlock](#/ValidatorRequiredApi/publishBlock) (BeaconBlock + signature)
2123

@@ -36,13 +38,15 @@ Attesting:
3638
been assigned to. If any validators in the committee are aggregators,
3739
set `is_aggregator` to `True`,
3840
2. Wait for new BeaconBlock for the assigned slot (either stream updates or poll)
39-
- Max wait: `SECONDS_PER_SLOT / 4` seconds into the assigned slot
41+
- Pre-Gloas forks: Max wait `SECONDS_PER_SLOT / 3` seconds into the assigned slot
42+
- Post-Gloas forks: Max wait `SECONDS_PER_SLOT / 4` seconds into the assigned slot
4043
3. [Fetch AttestationData](#/ValidatorRequiredApi/produceAttestationData)
4144
4. [Submit Attestation](#/ValidatorRequiredApi/submitPoolAttestations) (AttestationData + aggregation bits)
4245
- Aggregation bits are `Bitlist` with length of committee (received in AttesterDuty)
4346
with bit on position `validator_committee_index` (see AttesterDuty) set to true
4447
5. If aggregator:
45-
- Wait for `SECONDS_PER_SLOT / 2` seconds into the assigned slot
48+
- Pre-Gloas forks: Wait for `SECONDS_PER_SLOT * 2 / 3` seconds into the assigned slot
49+
- Post-Gloas forks: Wait for `SECONDS_PER_SLOT / 2` seconds into the assigned slot
4650
- [Fetch aggregated Attestation](#/ValidatorRequiredApi/getAggregatedAttestation) from Beacon Node you've subscribed to your subnet
4751
- [Publish SignedAggregateAndProofs](#/ValidatorRequiredApi/publishAggregateAndProofs)
4852

@@ -51,7 +55,7 @@ If reorg is detected, ask for new attester duties and proceed from 1..
5155

5256
### PTC Attesting
5357

54-
On start of every epoch, validator should [fetch PTC duties](#/Validator/getPtcDuties) for epoch + 1.
58+
On start of every epoch beginning with the Gloas fork, validator should [fetch PTC duties](#/Validator/getPtcDuties) for epoch + 1.
5559
Result are array of objects with validator index and assigned slot for payload timeliness committee participation.
5660

5761
PTC Attesting:
@@ -68,7 +72,7 @@ If reorg is detected, ask for new PTC duties and proceed from 1..
6872

6973
### Builder (Optional)
7074

71-
Validators may optionally act as builders to submit execution payload bids for block inclusion.
75+
Post-Gloas fork, validators may optionally act as builders to submit execution payload bids for block inclusion.
7276
This requires registering with builder-specific withdrawal credentials (`BUILDER_WITHDRAWAL_PREFIX`).
7377

7478
Building:

0 commit comments

Comments
 (0)