Adding Gloas changes by usmansaleem · Pull Request #28 · ethereum/remote-signing-api

usmansaleem · 2026-05-06T04:45:14Z

Summary

Adds five new signing types for the upcoming Gloas fork (Glamsterdam). These are client-agnostic spec additions intended for any consensus client (Teku, Lighthouse, Lodestar, Nimbus, Prysm) interacting with a remote signer such as Web3Signer.

Type	Domain	Signer role
`EXECUTION_PAYLOAD_BID`	`DOMAIN_BEACON_BUILDER` (0x0B000000)	Builder
`EXECUTION_PAYLOAD_ENVELOPE`	`DOMAIN_BEACON_BUILDER` (0x0B000000)	Builder
`PAYLOAD_ATTESTATION_MESSAGE`	`DOMAIN_PTC_ATTESTER` (0x0C000000)	PTC attester
`PROPOSER_PREFERENCES`	`DOMAIN_PROPOSER_PREFERENCES` (0x0D000000)	Proposer
`BUILDER_REQUEST_AUTH`	`DOMAIN_BUILDER_REQUEST_AUTH` (0x0B000001)	Proposer

Request shape

All five payloads are fork-versioned, following the existing BLOCK_V2 / AGGREGATE_AND_PROOF_V2 pattern:

{
  "type": "EXECUTION_PAYLOAD_BID",
  "fork_info": { ... },
  "execution_payload_bid": {
    "version": "GLOAS",
    "data": { ... }
  }
}

BUILDER_REQUEST_AUTH is the exception on fork_info: like VALIDATOR_REGISTRATION, it is signed with compute_domain(DOMAIN_BUILDER_REQUEST_AUTH) (genesis fork version, zero genesis_validators_root), so fork_info is not required. It is still version-wrapped.

Schema additions

ExecutionPayloadBidGloas (12 fields, incl. execution_requests_root)
ExecutionPayloadEnvelopeGloas (payload, execution_requests, builder_index, beacon_block_root, parent_beacon_block_root)
ExecutionPayloadGloas (Deneb shape + block_access_list, slot_number)
ExecutionRequestsGloas (deposits, withdrawals, consolidations, builder_deposits, builder_exits)
PayloadAttestationDataGloas (4 fields)
ProposerPreferencesGloas (dependent_root, proposal_slot, validator_index, fee_recipient, target_gas_limit)
BuilderRequestAuthGloas (data, slot)
BlockRequestGloas, AggregateAndProofRequestGloas — GLOAS added to BLOCK_V2 and AGGREGATE_AND_PROOF_V2 (JSON shapes unchanged from Fulu; only SSZ encoding differs)

/sign endpoint's oneOf + discriminator mapping is extended with the five new types; a request example is provided for each, plus BLOCK_V2 (GLOAS) and AGGREGATE_AND_PROOF_V2 (GLOAS).

Tracks #23.

⚠️ Subject to change

Field shapes mirror the current consensus-specs gloas/ and builder-specs gloas/ containers. Other client teams should review and push back on:

Field names / casing.
Whether PROPOSER_PREFERENCES belongs in the spec at this layer or is something proposers handle locally.
Whether BUILDER_REQUEST_AUTH is scoped/named correctly against the current builder-specs (Gloas) BuilderRequestAuth/SignedBuilderRequestAuth containers.

Spec is published as draft and will be revised once cross-client consensus is reached.

Review history

@james-prysm / @JasonVranek: added BUILDER_REQUEST_AUTH per builder-specs#165 / beacon-APIs#630; synced ProposerPreferences / ExecutionPayloadEnvelope with spec.
@nflaig: all new payloads now version-wrapped for forward compatibility (8742bd7).
@james-prysm: execution_requests is now fully typed (ExecutionRequestsGloas); BLOCK_V2 and AGGREGATE_AND_PROOF_V2 accept GLOAS (8742bd7).

Note: the version/data wrapper was a breaking change relative to the earlier draft validated in Consensys-Incorporated/web3signer#1192 — that implementation has been updated to match (web3signer@27431fbc, web3signer@5670340b).

Test plan

Spec lints (spectral, 0 errors) and bundles (swagger-cli)
Cross-client review — Lodestar ✅ (@nflaig), Prysm ✅ (@james-prysm); Teku, Lighthouse, Nimbus outstanding
Field name alignment with EIP/CL spec PRs for ePBS
Re-validate against updated Web3Signer implementation (feat: add GLOAS (Glamsterdam) signing support Consensys-Incorporated/web3signer#1192) — wrapper shape and doc fixes synced (27431fbc, 5670340b)

Adds four new signing types for the Glamsterdam (ePBS) fork: - EXECUTION_PAYLOAD_BID — signed by builders (DOMAIN_BEACON_BUILDER, 0x0B000000) - EXECUTION_PAYLOAD_ENVELOPE — signed by builders (DOMAIN_BEACON_BUILDER) - PAYLOAD_ATTESTATION_MESSAGE — signed by PTC attesters (DOMAIN_PTC_ATTESTER, 0x0C000000) - PROPOSER_PREFERENCES — signed by proposers (DOMAIN_PROPOSER_PREFERENCES, 0x0D000000) Adds matching data schemas (ExecutionPayloadBid, ExecutionPayloadEnvelope, ExecutionPayloadGloas, PayloadAttestationData, ProposerPreferences) and wires the new wrappers into the sign endpoint's oneOf + discriminator mapping. Tracks ethereum#23.

james-prysm · 2026-08-14T21:49:15Z

we need to update here, instead of bid it needs to be request auth due to ethereum/beacon-APIs#630

JasonVranek · 2026-08-20T14:31:56Z

Raising from ACDC today ~ the updated builder spec introduces a new proposer-signed RequestAuth -> SignedRequestAuth which is signed over DOMAIN_REQUEST_AUTH = 0x0B000001

@james-prysm

- ProposerPreferences: add dependent_root, rename gas_limit to target_gas_limit (Teku ProposerPreferencesSchema, teku/pull/11xxx). - ExecutionPayloadEnvelope: add parent_beacon_block_root (Teku ExecutionPayloadEnvelopeSchema). - execution_requests: note builder_deposits/builder_exits (EIP-8282, Gloas execution-requests additions). - Add BuilderRequestAuth/BuilderRequestAuthSigning + BUILDER_REQUEST_AUTH signing type: proposer-signed request-auth message for authenticating per-request builder-API calls, per builder-specs (Gloas), domain DOMAIN_BUILDER_REQUEST_AUTH (0x0B000001). Addresses review feedback from @james-prysm and @JasonVranek on this PR: the original draft only covered a builder-signed bid/envelope; the updated builder-specs/beacon-APIs/keymanager-APIs trio (builder-specs#165, beacon-APIs#630, keymanager-APIs#88) also requires the proposer to sign a BuilderRequestAuth to authenticate itself to a builder, separate from and prior to any bid.

…estAuth Same rationale as web3signer@0da4d26a: state the genesis-domain mechanic directly instead of comparing to the unrelated, deprecated ValidatorRegistrationV1 flow.

… 4-space convention)

james-prysm · 2026-08-27T15:38:49Z

block_v2 should support gloas too ( right now only fulu)

Address review feedback on Glamsterdam signing types: - Wrap all five new payloads in a version-discriminated request ({version: GLOAS, data}) matching BLOCK_V2 / AGGREGATE_AND_PROOF_V2, so future forks can evolve shapes without new type identifiers. - Replace untyped execution_requests object with ExecutionRequestsGloas (deposits, withdrawals, consolidations, builder_deposits, builder_exits). - Add GLOAS variant to BLOCK_V2 and AGGREGATE_AND_PROOF_V2. - Add request examples for every new type and the GLOAS variants. - Normalise byte-type descriptions to existing Bytes<N>/SSZ hexadecimal convention.

james-prysm

looks good to me I think

actually hold on might have some feedback, still reviewing

james-prysm

never mind actually I think this is ok

**What type of PR is this?** Feature **What does this PR do? Why is it needed?** adds the following types to web3signer | Type | Domain | Signer role | |---|---|---| | `EXECUTION_PAYLOAD_ENVELOPE` | `DOMAIN_BEACON_BUILDER` (0x0B000000) | Builder | | `PAYLOAD_ATTESTATION_MESSAGE` | `DOMAIN_PTC_ATTESTER` (0x0C000000) | PTC attester | | `PROPOSER_PREFERENCES` | `DOMAIN_PROPOSER_PREFERENCES` (0x0D000000) | Proposer | | `BUILDER_REQUEST_AUTH` | `DOMAIN_BUILDER_REQUEST_AUTH` (0x0B000001) | Proposer | **Which issues(s) does this PR fix?** implements ethereum/remote-signing-api#28 **Other notes for review** **Acknowledgements** - [x] I have read [CONTRIBUTING.md](https://github.com/prysmaticlabs/prysm/blob/develop/CONTRIBUTING.md). - [x] I have included a uniquely named [changelog fragment file](https://github.com/prysmaticlabs/prysm/blob/develop/CONTRIBUTING.md#maintaining-changelogmd). - [x] I have added a description with sufficient context for reviewers to understand this PR. - [ ] I have tested that my changes work as expected and I added a testing plan to the PR description (if applicable).

nflaig

LGTM, just some minor comments

…t example - Drop 'Glamsterdam'/ePBS/EIP references from schema descriptions in favor of 'Gloas', per nflaig review comments. - ExecutionPayloadEnvelopeGloas description now covers proposer self-builds in addition to builder-signed envelopes. - Remove spec-history note from ExecutionPayloadGloas description. - Recompute the AGGREGATE_AND_PROOF_V2 (GLOAS) example signingRoot; it previously matched the Fulu/Electra value verbatim, which is inaccurate due to Gloas's progressive container SSZ encoding. Verified against Teku's AttestationGloasSchema via a throwaway acceptance test in web3signer.

rolfyone

LGTM

…0071) Aligns the external signer client with the Glamsterdam additions to the remote signing api (ethereum/remote-signing-api#28). All new gloas payloads are `version`-wrapped like `BLOCK_V2` and `AGGREGATE_AND_PROOF_V2`, and the PTC signing type is named after the message the validator produces, consistent with `ATTESTATION` and `SYNC_COMMITTEE_MESSAGE` which also carry only the signed data. - rename `PAYLOAD_ATTESTATION` to `PAYLOAD_ATTESTATION_MESSAGE`, body key `payload_attestation_message` - wrap `execution_payload_envelope`, `payload_attestation_message`, `proposer_preferences` and `builder_request_auth` in `{version, data}`, version is the fork at the message slot - add web3signer e2e cases for the four signing types, skipped until the test image supports gloas The same request shapes are implemented in Consensys-Incorporated/web3signer#1192.

usmansaleem added 3 commits May 6, 2026 14:44

Inline Withdrawal field types in ExecutionPayloadGloas

463f55e

Bump spec version to v1.4.0 for Glamsterdam additions

a48d96f

james-prysm mentioned this pull request May 27, 2026

remote signer gloas OffchainLabs/prysm#16852

Merged

4 tasks

ensi321 mentioned this pull request Jul 13, 2026

Add Lodestar EIP-7732 builder proposal eth-protocol-fellows/cohort-seven#161

Merged

wemeetagain mentioned this pull request Jul 21, 2026

Add generic, batch, and distributed signing profiles #29

Draft

parithosh mentioned this pull request Aug 20, 2026

All Core Devs - Consensus (ACDC) #185, August 20 2026 ethereum/pm#2187

Closed

4 tasks

usmansaleem added 3 commits August 25, 2026 14:43

docs: drop misleading ValidatorRegistrationV1 analogy for BuilderRequ…

87923cb

…estAuth Same rationale as web3signer@0da4d26a: state the genesis-domain mechanic directly instead of comparing to the unrelated, deprecated ValidatorRegistrationV1 flow.

chore: fix inconsistent enum-item indentation (2 spaces vs the file's…

9718ec5

… 4-space convention)

nflaig reviewed Aug 25, 2026

View reviewed changes

Comment thread signing/schemas.yaml

james-prysm reviewed Aug 27, 2026

View reviewed changes

Comment thread signing/schemas.yaml Outdated

usmansaleem linked an issue Sep 2, 2026 that may be closed by this pull request

Gloas Signing Support #23

Open

3 tasks

usmansaleem requested review from james-prysm and nflaig September 2, 2026 23:10

usmansaleem marked this pull request as ready for review September 2, 2026 23:10

usmansaleem mentioned this pull request Sep 3, 2026

feat: add GLOAS (Glamsterdam) signing support Consensys-Incorporated/web3signer#1192

Open

7 tasks

james-prysm previously approved these changes Sep 3, 2026

View reviewed changes

james-prysm approved these changes Sep 3, 2026

View reviewed changes

nflaig mentioned this pull request Sep 12, 2026

fix: align gloas external signer requests with remote signing api ChainSafe/lodestar#10071

Merged

nflaig approved these changes Sep 12, 2026

View reviewed changes

Comment thread signing/schemas.yaml Outdated

Comment thread signing/paths/sign.yaml Outdated

nflaig reviewed Sep 12, 2026

View reviewed changes

Comment thread signing/schemas.yaml Outdated

Comment thread signing/schemas.yaml Outdated

krisoshea-eth mentioned this pull request Sep 12, 2026

[DEFERRED] Remote signer and multiple Builder keys krisoshea-eth/lodestar#39

Open

4 tasks

usmansaleem changed the title ~~Adding Glamsterdam changes~~ Adding Gloas changes Sep 14, 2026

Update upcoming spec link in index.html

8ece34b

rolfyone approved these changes Sep 14, 2026

View reviewed changes

Navigation Menu

Uh oh!

Adding Gloas changes - #28

Adding Gloas changes#28
usmansaleem wants to merge 9 commits into
ethereum:mainfrom
usmansaleem:glamsterdam_changes

usmansaleem commented May 6, 2026 •

edited

Loading

Uh oh!

james-prysm commented Aug 14, 2026 •

edited

Loading

Uh oh!

JasonVranek commented Aug 20, 2026

Uh oh!

Uh oh!

james-prysm commented Aug 27, 2026

Uh oh!

Uh oh!

james-prysm left a comment

Uh oh!

james-prysm left a comment

Uh oh!

nflaig left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

rolfyone left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Uh oh!

Conversation

usmansaleem commented May 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Request shape

Schema additions

⚠️ Subject to change

Review history

Test plan

Uh oh!

james-prysm commented Aug 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

JasonVranek commented Aug 20, 2026

Uh oh!

Uh oh!

james-prysm commented Aug 27, 2026

Uh oh!

Uh oh!

james-prysm left a comment

Choose a reason for hiding this comment

Uh oh!

james-prysm left a comment

Choose a reason for hiding this comment

Uh oh!

nflaig left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

rolfyone left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

usmansaleem commented May 6, 2026 •

edited

Loading

james-prysm commented Aug 14, 2026 •

edited

Loading