Skip to content

Conversation

@bharath-123
Copy link
Collaborator

@bharath-123 bharath-123 commented Nov 28, 2025

This PR begins work and discussions on the builder-spec for ePBS for off-protocol builders. This PR defines the interfaces between proposer and off-protocol relays/builders

ePBS introduces the following protocol upgrades:

  1. Enshrining of builders into the protocol by allowing them to stake collateral(used for trustless payments)
  2. Decoupling BeaconBlock validation and ExecutionPayload validation.

A high level description of the design is available at: https://hackmd.io/SecxqKCKTTCQE0NA9AMBnA

We introduce 3 new APIs(we have room for bikeshedding these names):

  1. getExecutionPayloadBid: GET /eth/v1/builder/execution_payload_bid/{slot}/{parent_hash}/{pubkey}
    This API is called by the proposer to the builder/relay. The builder/relay returns an execution payload bid along with payload root, execution_requests root.

  2. submitSignedBeaconBlock: POST /eth/v1/builder/beacon_block
    This API is called by the proposer to the builder/relay when the proposer commits to the bid received from getExecutionPayloadBid. The proposer sends the signed beacon block with the execution payload embedded to it. The relay returns a blinded execution payload envelope for the proposer to sign.

We might want to move type definitions of BlindedExecutionPayloadEnvelope and SignedBlindedExecutionPayloadEnvelope to beacon-apis repo.

Closes: #137

@bharath-123 bharath-123 changed the title Builder API updates for Glamsterdam Off-Protocol Builder API updates for Glamsterdam Dec 3, 2025
@bharath-123 bharath-123 changed the title Off-Protocol Builder API updates for Glamsterdam Builder API updates for Glamsterdam Dec 3, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Evaluate how Builder-API is going to change with ePBS

2 participants