Skip to content

Add per-validator builder configuration API - #9864

Open
jimmygchen wants to merge 11 commits into
stack/ethDreamer/gloas-builder-api-stacked/migrate-validator-client-gloas-builder-api-gloas--aeeaf620from
codex/feat-per-validator-builder-config
Open

Add per-validator builder configuration API#9864
jimmygchen wants to merge 11 commits into
stack/ethDreamer/gloas-builder-api-stacked/migrate-validator-client-gloas-builder-api-gloas--aeeaf620from
codex/feat-per-validator-builder-config

Conversation

@jimmygchen

@jimmygchen jimmygchen commented Aug 19, 2026

Copy link
Copy Markdown
Member

Description

Adds the per-validator builder configuration endpoints from ethereum/keymanager-APIs#88.

  • GET /eth/v1/validator/{pubkey}/builder_config returns the configuration in use for the validator.
  • POST /eth/v1/validator/{pubkey}/builder_config replaces and persists the full configuration on a per-validator basis. It does not merge with the previous entry.
  • DELETE /eth/v1/validator/{pubkey}/builder_config removes the stored entry, so the validator inherits the global configuration again.

The API stores per-validator entries under validator_configs in builder_definitions.yml.

Changes made by POST and DELETE apply to subsequent builder preference publication and Gloas block production without a restart.

Closes #9796

Additional Info

This PR is stacked on #9807 and should be reviewed after it.

@jimmygchen jimmygchen added ready-for-review The code is ready for review HTTP-API builder API gloas val-client Relates to the validator client binary and removed builder API labels Aug 19, 2026
@eserilev eserilev mentioned this pull request Aug 19, 2026
@ethDreamer
ethDreamer requested a review from jxs as a code owner August 19, 2026 19:31
@mergify

mergify Bot commented Aug 19, 2026

Copy link
Copy Markdown

This pull request has merge conflicts. Could you please resolve them @jimmygchen? 🙏

@mergify mergify Bot added waiting-on-author The reviewer has suggested changes and awaits thier implementation. and removed ready-for-review The code is ready for review labels Aug 19, 2026
@jimmygchen
jimmygchen force-pushed the codex/feat-per-validator-builder-config branch from f0f272a to c3f6c06 Compare August 21, 2026 06:35
@mergify mergify Bot added ready-for-review The code is ready for review and removed waiting-on-author The reviewer has suggested changes and awaits thier implementation. labels Aug 21, 2026
@mergify

mergify Bot commented Aug 21, 2026

Copy link
Copy Markdown

This pull request has merge conflicts. Could you please resolve them @jimmygchen? 🙏

@mergify mergify Bot added waiting-on-author The reviewer has suggested changes and awaits thier implementation. and removed ready-for-review The code is ready for review labels Aug 21, 2026
@jimmygchen
jimmygchen force-pushed the codex/feat-per-validator-builder-config branch from c3f6c06 to 3c16568 Compare August 21, 2026 15:07
@chong-he chong-he added the under-review A reviewer has only partially completed a review. label Aug 24, 2026
@jimmygchen
jimmygchen force-pushed the codex/feat-per-validator-builder-config branch from 3c16568 to d4866c8 Compare August 26, 2026 00:41
@mergify mergify Bot added ready-for-review The code is ready for review and removed waiting-on-author The reviewer has suggested changes and awaits thier implementation. labels Aug 26, 2026
@mergify

mergify Bot commented Aug 26, 2026

Copy link
Copy Markdown

This pull request has merge conflicts. Could you please resolve them @jimmygchen? 🙏

@mergify mergify Bot added waiting-on-author The reviewer has suggested changes and awaits thier implementation. and removed ready-for-review The code is ready for review labels Aug 26, 2026

@chong-he chong-he left a comment

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 have go through the PR and tested the endpoint manually and they look great. Just some minor comments and a bug found by Codex

Comment thread common/warp_utils/src/reject.rs
Comment thread validator_client/builder_store/src/builder_definitions.rs
Comment thread validator_client/builder_store/src/builder_definitions.rs
Comment thread validator_client/builder_store/src/lib.rs Outdated
Comment thread validator_client/builder_store/src/builder_definitions.rs
Comment thread validator_client/builder_store/src/builder_definitions.rs Outdated
@jimmygchen
jimmygchen force-pushed the codex/feat-per-validator-builder-config branch from d4866c8 to 023488e Compare August 27, 2026 01:47
@jimmygchen jimmygchen added ready-for-review The code is ready for review and removed waiting-on-author The reviewer has suggested changes and awaits thier implementation. labels Aug 27, 2026

@chong-he chong-he left a comment

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.

Looks great, tested and the endpoints are all working

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

gloas HTTP-API ready-for-review The code is ready for review under-review A reviewer has only partially completed a review. val-client Relates to the validator client binary

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants