Skip to content

feat: add proposer preferences API spec for Gloas (ePBS)#1

Open
lodekeeper wants to merge 1 commit intomasterfrom
feat/proposer-preferences
Open

feat: add proposer preferences API spec for Gloas (ePBS)#1
lodekeeper wants to merge 1 commit intomasterfrom
feat/proposer-preferences

Conversation

@lodekeeper
Copy link
Owner

Description

Adds beacon-API specification for proposer preferences in Gloas (ePBS), addressing ethereum/beacon-APIs#570 and ethereum/beacon-APIs#435.

New Endpoints

POST /eth/v1/validator/proposer_preferences

  • Purpose: VC submits signed proposer preferences to BN for gossip broadcast
  • Body: SignedProposerPreferences[] (batch for multiple upcoming slots)
  • Replaces: prepareBeaconProposer and registerValidator for Gloas+

GET /eth/v1/beacon/pool/proposer_preferences

  • Purpose: Query the op pool for known proposer preferences
  • Query: Optional slot filter
  • Response: SignedProposerPreferences[]

New Types

  • Gloas.ProposerPreferencesproposal_slot, validator_index, fee_recipient, gas_limit
  • Gloas.SignedProposerPreferences — message + BLS signature

SSE Event

  • proposer_preferences — fired when BN receives valid preferences via gossip or API

Deprecations

  • prepareBeaconProposer — marked deprecated for Gloas+
  • registerValidator — marked deprecated for Gloas+

Spec References

Note: This PR was authored with AI assistance (Claude/GPT via OpenClaw). All changes reviewed for spec compliance.

New endpoints for proposer preferences in Gloas:
- POST /eth/v1/validator/proposer_preferences: VC submits signed preferences for gossip broadcast
- GET /eth/v1/beacon/pool/proposer_preferences: Query op pool for known preferences

New types:
- Gloas.ProposerPreferences: proposal_slot, validator_index, fee_recipient, gas_limit
- Gloas.SignedProposerPreferences: message + BLS signature

Additional changes:
- SSE event 'proposer_preferences' for real-time builder notifications
- Deprecation notices on prepareBeaconProposer and registerValidator for Gloas+
- Updated validator-flow.md with proposer preferences duty description

Addresses: ethereum#570, ethereum#435
Spec ref: consensus-specs/specs/gloas/p2p-interface.md, validator.md
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