This document contains the consensus-layer networking specification for ePBS.
The specification of these changes continues in the same format as the network specifications of previous upgrades, and assumes them as pre-requisite.
Some gossip meshes are upgraded in the fork of ePBS to support upgraded types.
Topics follow the same specification as in prior upgrades.
The beacon_block
topic is modified to also support block with bid and new topics are added per table below.
The derivation of the message-id
remains stable.
The new topics along with the type of the data
field of a gossipsub message are given in this table:
Name | Message Type |
---|---|
builder_bid |
SignedBuilderBid |
execution_payload |
ExecutionPayload |
execution_attestation |
ExecutionAttestation [New in ePBS] |
ePBS introduces new global topics for blob sidecars.
beacon_block
The type of the payload of this topic changes to the (modified) SignedBeaconBlockWithBid
found in ePBS spec. Specifically, this type changes with the replacement of SignedBuilderBid
to the inner BeaconBlockBody
.
In addition to the gossip validations for this topic from prior specifications, the following validations MUST pass before forwarding the signed_beacon_block
on the network. Alias block = signed_beacon_block.message
, signed_bid = block.body.signed_builder_bid
, bid = signed_bid.message
, header = bid.header
.
New validation:
header.timestamp == compute_timestamp_at_slot(state, block.slot)
.signed_bid.signature
, is valid with respect to the bid.pubkey
.execution_payload
This topic is used to propagate execution payload.
The following validations MUST pass before forwarding the execution_payload
on the network, assuming the alias payload = execution_payload
:
execution_attestation
This topic is used to propagate signed execution attestation.
The following validations MUST pass before forwarding the execution_attestation
on the network, assuming the alias data = execution_attestation.data
:
data.slot
is within the last ATTESTATION_PROPAGATION_SLOT_RANGE
slots (within a MAXIMUM_GOSSIP_CLOCK_DISPARITY allowance) – i.e. data.slot + ATTESTATION_PROPAGATION_SLOT_RANGE >= current_slot >= data.slot
(a client MAY queue future attestations for processing at the appropriate slot).get_execution_committee(state, data.slot)
data.execution_hash
) has been seen (via both gossip and non-gossip sources) (a client MAY queue execution attestations for processing once payload is retrieved).execution_attestation
is valid.builder_bid
This topic is used to propagate signed builder bids.
The following validations MUST pass before forwarding the signed_builder_bid
on the network, assuming the alias bid = signed_builder_bid.message
:
bid.pubkey
, exists in state.bid.value
, is less than builder's balance in state.header.timestamp == compute_timestamp_at_slot(state, current_slot + 1)
.signed_bid.signature
, is valid with respect to the bid.pubkey
.See gossip transition details found in the Altair document for
details on how to handle transitioning gossip topics for this upgrade.
Protocol ID: /eth2/beacon_chain/req/execution_payload_by_hash/1/
The <context-bytes>
field is calculated as context = compute_fork_digest(fork_version, genesis_validators_root)
:
fork_version |
Chunk SSZ type |
---|---|
EPBS_FORK_VERSION |
epbs.EXECUTION_PAYLOAD |
Request Content:
Response Content:
TODO: Add