Skip to content

Make builders non-validating staked actors #4

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

Merged
shane-moore merged 2 commits into from
Feb 3, 2026
Merged

Make builders non-validating staked actors #4

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e12bf98
Make builders non-validating staked actors
nflaig Jan 26, 2026
97f582f
Apply suggestion from @nflaig
nflaig Jan 27, 2026
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
2 changes: 1 addition & 1 deletion apis/validator/execution_payload_bid.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ get:
InvalidBuilderIndex:
value:
code: 400
message: "Builder index does not correspond to a registered builder validator"
message: "Builder index does not correspond to a registered builder"
"404":
description: "Execution payload bid not available for the requested slot and builder"
content:
Expand Down
2 changes: 1 addition & 1 deletion apis/validator/execution_payload_envelope.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ get:
- name: builder_index
in: path
required: true
description: "Validator index of the builder from which the execution payload envelope is requested. For self-building, it will be the proposer's validator index."
description: "Index of the builder from which the execution payload envelope is requested. For self-building, it will be `BUILDER_INDEX_SELF_BUILD`."
schema:
$ref: "../../beacon-node-oapi.yaml#/components/schemas/Uint64"
responses:
Expand Down
5 changes: 3 additions & 2 deletions validator-flow.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -76,8 +76,9 @@ If reorg is detected, ask for new PTC duties and proceed from 1..

### Builder (Optional)

Post-Gloas fork, validators may optionally act as builders to submit execution payload bids for block inclusion.
This requires registering with builder-specific withdrawal credentials (`BUILDER_WITHDRAWAL_PREFIX`).
Post-Gloas fork, builders are separate non-validating staked actors that submit execution payload bids for block inclusion.
Builders register by depositing with builder-specific withdrawal credentials (`BUILDER_WITHDRAWAL_PREFIX`) and are tracked
in the beacon state's builder registry.

Building:
1. [Fetch ExecutionPayloadBid](#/Validator/getExecutionPayloadBid) from beacon node for the current or next slot's proposer to include.
Expand Down