Skip to content

Add builder_pending_withdrawals and builder_pending_payments endpoints - #655

Open
markolazic01 wants to merge 2 commits into
ethereum:masterfrom
markolazic01:add-builder-pending-endpoints
Open

markolazic01 wants to merge 2 commits into
ethereum:masterfrom
markolazic01:add-builder-pending-endpoints

Conversation

@markolazic01

Copy link
Copy Markdown
Contributor

Motivation

Make a staked builder's unsettled payments accessible to the builder and external viewers.

Description

Closes #636

Adds two endpoints to read the Gloas builder payment fields from a given state:

  • GET /eth/v1/beacon/states/{state_id}/builder_pending_withdrawals
  • GET /eth/v1/beacon/states/{state_id}/builder_pending_payments

Both return the state field as is, following the pending_* and proposer_lookahead endpoints, with JSON and SSZ responses and a 400 for pre-Gloas states. The item types BuilderPendingWithdrawal and BuilderPendingPayment already exist in types/gloas/builder.yaml and remain unchanged.

@markolazic01
markolazic01 marked this pull request as ready for review September 24, 2026 12:57
Comment thread CHANGES.md
Comment on lines +11 to +12
| [#655](https://github.com/ethereum/beacon-APIs/pull/655) `GET /eth/v1/beacon/states/{state_id}/builder_pending_withdrawals` added | | | | | |
| [#655](https://github.com/ethereum/beacon-APIs/pull/655) `GET /eth/v1/beacon/states/{state_id}/builder_pending_payments` added | | | | | |

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am gonna sort the changelog before the release but we should add entries to the bottom, sorted by pr number but it's always a bit annoying right now with merge conflicts, so keeping it here now it fine

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

got it, I was not sure if I should put them to the top or the bottom

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

after the release can explore #579 or other solutions, ideally we want a solution that is easy to understand for someone that puts up a pr and also doesn't cause merge conflicts between prs

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I saw that one, I can spend some time on that if you'd like.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

rather low prio right now, we can resolve this after the release

Comment thread beacon-node-oapi.yaml
/eth/v1/beacon/states/{state_id}/builder_pending_withdrawals:
$ref: "./apis/beacon/states/builder_pending_withdrawals.yaml"
/eth/v1/beacon/states/{state_id}/builder_pending_payments:
$ref: "./apis/beacon/states/builder_pending_payments.yaml"

@chong-he chong-he Sep 25, 2026 •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we want to add Gloas.BuilderPendingPayment and Gloas.BuilderPendingWithdrawal under components: schema:?
(some lines below in this same file)

I see that previous PR added the type in the components and schema section, for example: https://github.com/ethereum/beacon-APIs/pull/512/files#diff-962ea34dc6ec0e65d4e1d6c8682e97c547e6e0d2f1168925210ff7ee47ef6ce0R437-R438

This branch has not been deployed

No deployments
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.

Gloas: Add endpoint for builder_pending_withdrawals, builder_pending_payments

3 participants