Skip to content

Use hostname for auth data and default max_execution_payment to 0 - #11303

Merged
StefanBratanov merged 6 commits into
Consensys-Incorporated:masterfrom
StefanBratanov:hostname_auth_data
Sep 19, 2026
Merged

StefanBratanov merged 6 commits into
Consensys-Incorporated:masterfrom
StefanBratanov:hostname_auth_data

Conversation

@StefanBratanov

@StefanBratanov StefanBratanov commented Sep 18, 2026 •

Copy link
Copy Markdown
Contributor

PR Description

As per ethereum/builder-specs#168, we need to use hostname for auth data, also defaulting max_execution_payment to 0 after a discussion with other clients, added CLI option to modify that.

Fixed Issue(s)

N/A

Documentation

  • I thought about documentation and added the doc-change-required label to this PR if updates are required.

Changelog

  • I thought about adding a changelog entry, and added one if I deemed necessary.

Note

Medium Risk
Changes builder bid authentication and default bid valuation semantics for Gloas proposers; misconfigured auth host normalization could break builder auth interoperability.

Overview
Aligns Gloas builder auth and bid valuation with updated builder-specs: builder request auth now signs normalized hostname bytes (lowercase ASCII, punycode IDN, RFC 5952 IPv6) instead of the full URL, with per-host caching in BuilderConfigProvider.

max_execution_payment defaults to 0 (trustless bid value only) instead of the removed spec constant UInt64.MAX_VALUE. Operators can set it via hidden CLI --Xbuilder-max-execution-payment, plumbed through ValidatorConfig into each BuilderEntry.

--Xbuilder-urls parsing rejects URLs without a valid host. Tests cover CLI wiring and auth-data normalization cases.

Reviewed by Cursor Bugbot for commit 075a1ce. Bugbot is set up for automated code reviews on this repo. Configure here.

@cursor cursor Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Stale Bugbot comment from a previous run.

paramLabel = "<uint64>",
showDefaultValue = CommandLine.Help.Visibility.ALWAYS,
description =
"The maximum execution layer payment (in Gwei) that counts when a builder's bid is valued",

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.

I'd highlight what 0 means here

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.

good point!

Arguments.of("https://user:pw@builder.example.com/", "builder.example.com"),
Arguments.of("https://10.0.0.5:18550/eth/v1/builder", "10.0.0.5"),
Arguments.of("https://[0:0:0:0:0:0:0:1]:8443/", "[::1]"),
Arguments.of("https://[2001:db8::192.0.2.1]/", "[2001:db8::c000:201]"));

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.

I'd add punycode example also

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.

Actually that was a good catch, it caused issues with the current code, all fixed

@cursor cursor Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Stale Bugbot comment from a previous run.

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit a949b81. Configure here.

@zilm13 zilm13 left a comment

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.

LGTM

@StefanBratanov
StefanBratanov enabled auto-merge (squash) September 19, 2026 18:26
@StefanBratanov
StefanBratanov merged commit 0ed1bfa into Consensys-Incorporated:master Sep 19, 2026
93 checks passed
@github-actions github-actions Bot locked and limited conversation to collaborators Sep 19, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants