Skip to content

Add per-validator builder configuration API - #9862

Closed
jimmygchen wants to merge 2 commits into
sigp:stack/ethDreamer/gloas-builder-api-stacked/migrate-validator-client-gloas-builder-api-gloas--aeeaf620from
jimmygchen:codex/feat-per-validator-builder-config
Closed

Add per-validator builder configuration API#9862
jimmygchen wants to merge 2 commits into
sigp:stack/ethDreamer/gloas-builder-api-stacked/migrate-validator-client-gloas-builder-api-gloas--aeeaf620from
jimmygchen: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. This is the method and replacement behavior defined by [WIP] Tree hash #88; 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.

POST {} is useful after builders: []: it restores global inheritance but keeps an empty per-validator entry. DELETE restores the same runtime behavior and removes the entry.

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 closed this Aug 19, 2026
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.

1 participant