Validator Registration
This guide details how to interact with the /eth/v1/builder/validators endpoint, including optional authentication and customising validator preferences.
NB: If your client does not support add custom headers. Please contact us and we can manually enable the below features for your validators.
Optional Authentication with the x-api-key
Header
x-api-key
HeaderUsers can obtain an api key from us and Authenticate via the x-api-key
header. Validators registered with a valid authentication header will automatically skip any sleeps before get_payload
is returned.
Example:
Customizing Validator Preferences with the x-preferences
Header
x-preferences
HeaderUsers can customize preferences for validators by including the x-preferences
header with a JSON string of their settings.
Preferences include:
filtering:
A string indicating which filtering policy to use ("regional" or "global").trusted_builders
: Specify a list of builders whose blocks are accepted.header_delay
: If set to false, will disable any relay-level delays for theget_header
response.gossip_blobs
: Setting this to true enables gossiping of blobs before payload validation, reducing orphaned slots and enhancing
Example:
Default Preferences
In the absence of the x-preferences
header, the following defaults apply:
Filtering:
"global"
(no filtering).Header Delay:
true
(relay-levelget_header
delays enabled).Trusted Builders:
no default
(if you do not want to enforce any Trusted Builder rules, omit this key).Gossip Blobs: false (blobs will be published after the block as been validated).
Specifying a single preference (e.g., {"header_delay": false}
) overrides only that setting, with others remaining at their default values.
Last updated