Add per-validator builder configuration API - #9864
Merged
Merged
Conversation
jimmygchen
added
ready-for-review
Closed
|
This pull request has merge conflicts. Could you please resolve them @jimmygchen? 🙏 |
mergify
Bot
added
waiting-on-author
jimmygchen
force-pushed
the
codex/feat-per-validator-builder-config
branch
from
August 21, 2026 06:35
f0f272a to
c3f6c06
Compare
mergify
Bot
added
ready-for-review
|
This pull request has merge conflicts. Could you please resolve them @jimmygchen? 🙏 |
mergify
Bot
added
waiting-on-author
jimmygchen
force-pushed
the
codex/feat-per-validator-builder-config
branch
from
August 21, 2026 15:07
c3f6c06 to
3c16568
Compare
chong-he
added
the
under-review
jimmygchen
force-pushed
the
codex/feat-per-validator-builder-config
branch
from
August 26, 2026 00:41
3c16568 to
d4866c8
Compare
Base automatically changed from
stack/ethDreamer/gloas-builder-api-stacked/migrate-validator-client-gloas-builder-api-gloas--aeeaf620
to
unstable
September 18, 2026 01:17
|
Queued — the merge queue status continues in this comment ↓. |
jimmygchen
added
ready-for-review
Changes: Derive default auth data from the lowercase ASCII hostname. Preserve explicit auth bytes across signing and keymanager configuration. Cover URL spelling, IPv6, override and API response behavior.
|
Some required checks have failed. Could you please take a look @jimmygchen? 🙏 |
mergify
Bot
added
waiting-on-author
Changes: Use recognised wording in the builder configuration guide. Add the specification term punycode to the spelling dictionary.
mergify
Bot
added
ready-for-review
Merge Queue Status
This pull request spent 30 minutes 34 seconds in the queue, including 29 minutes 10 seconds running CI. Required conditions to merge
|
8 tasks
SamAg19
pushed a commit
to SamAg19/lighthouse
that referenced
this pull request
Sep 18, 2026
## Description Adds the per-validator builder configuration endpoints from [ethereum/keymanager-APIs#88](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. When `auth_data` is omitted, global and per-validator builder configurations use the builder URL's lowercase ASCII hostname, following [ethereum/builder-specs#168](ethereum/builder-specs#168), [ethereum/beacon-APIs#642](ethereum/beacon-APIs#642) and [ethereum/keymanager-APIs#94](ethereum/keymanager-APIs#94). URLs with and without a trailing slash produce the same auth data. Closes sigp#9796 Closes sigp#10076 Co-authored-by: Mark Mackey <mark@sigmaprime.io>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Adds the per-validator builder configuration endpoints from ethereum/keymanager-APIs#88.
GET /eth/v1/validator/{pubkey}/builder_configreturns the configuration in use for the validator.POST /eth/v1/validator/{pubkey}/builder_configreplaces and persists the full configuration on a per-validator basis. It does not merge with the previous entry.DELETE /eth/v1/validator/{pubkey}/builder_configremoves the stored entry, so the validator inherits the global configuration again.The API stores per-validator entries under
validator_configsinbuilder_definitions.yml.Changes made by
POSTandDELETEapply to subsequent builder preference publication and Gloas block production without a restart.When
auth_datais omitted, global and per-validator builder configurations use the builder URL's lowercase ASCII hostname, following ethereum/builder-specs#168, ethereum/beacon-APIs#642 and ethereum/keymanager-APIs#94. URLs with and without a trailing slash produce the same auth data.Closes #9796
Closes #10076