Skip to content

Produce block v4 with payload#580

Open
shane-moore wants to merge 21 commits into
ethereum:masterfrom
shane-moore:produce-block-v4-with-payload
Open

Produce block v4 with payload#580
shane-moore wants to merge 21 commits into
ethereum:masterfrom
shane-moore:produce-block-v4-with-payload

Conversation

@shane-moore
Copy link
Copy Markdown
Contributor

@shane-moore shane-moore commented Feb 12, 2026

Introduces the block production and execution payload envelope endpoints for post-Gloas (ePBS) forks. These were separated out from #552 to be discussed and reviewed independently. Prior discussion in PR 552 thread and shane-moore/beacon-APIs#2 as well.

New endpoints:

  • GET /eth/v4/validator/blocks/{slot} — Post-Gloas block production endpoint (produceBlockV4).
    Supports an include_payload query parameter that controls whether the execution payload envelope and blobs are returned inline (stateless multi-BN operation) or cached by the beacon node for separate retrieval (stateful single-BN operation).
  • GET /eth/v1/validator/execution_payload_envelope/{slot} — Fetch the cached execution payload envelope for the current
    proposer's self-built payload. Only available for the current slot; returns 404 for past slots or when no envelope has been cached. Used in stateful mode.
  • POST /eth/v1/beacon/execution_payload_envelope — Publish a signed execution payload envelope to the network.

Open Questions

@nflaig nflaig added the Gloas api's needed in Gloas fork. label Feb 12, 2026
- Validator
- ValidatorRequiredApi
parameters:
- name: slot
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

while implementing this, I noticed the slot alone is not definitive enough (eg. in case of forks), we should consider also passing the beacon_block_root 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.

hm, what do you think about making it optional to pass beacon_block_root like in 0c45859? pretty sure the VC already computes the block's tree hash root during signing, so passing it here should be straightforward

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Yes, we do already compute the block root on the vc side. I am not a big fan of optional parameters, so I'd rather have it as required or remove it if it's not needed, so far it makes our implementation simpler, maybe get more feedback from others who already implemented the apis

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.

I feel you, perhaps @eserilev @tersec @StefanBratanov or others from your teams have some thoughts 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.

@nflaig, thought more about this. made beacon_block_root a required field in 5413e57 since just passing the slot alone isn't sufficient under potential fork equivocations. open to feedback if folks have a different stance on this

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.

Yes, prefer required to optional fields.

This comment was marked as spam.

This comment was marked as spam.

description: "Slot for which the execution payload envelope is requested."
schema:
$ref: "../../beacon-node-oapi.yaml#/components/schemas/Uint64"
- name: builder_index
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.

Will this endpoint be used for all builders outside of self building? I think the pipeline might endup being very different which makes me question if we would ever be caching more than just the current slot's payload envelope. terence asked this internally and I didn't have a good answer.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

this endpoint is only meant for self-building if you are the proposer or the "act as a builder" mode where you build the payload for another proposer

builders that produce payloads outside of the beacon node would get their own endpoint which would be under the /builder namespace (at least that's how I am thinking about it right now)

it should be sufficient to only cache the current slot as you consume the cache within the same slot, maybe if that's the case my comment here #580 (comment) is also not needed but I feel like the block root is useful to specify, not just the slot

Copy link
Copy Markdown
Member

@nflaig nflaig Feb 19, 2026

Choose a reason for hiding this comment

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

After thinking about it more, maybe we keep the current apis under /validator to be only used by proposers, which means we can remove builder_index here as it's only used for self-building

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.

makes sense, removed builder_index in 0c45859

Copy link
Copy Markdown
Member

@nflaig nflaig Mar 31, 2026

Choose a reason for hiding this comment

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

so looks like we might wanna use this for builders too if the validator "acts as a builder"

worth revisiting if we wanna re-add the builder_index here

Edit:

we might be fine, I think it's worth to wait until someone actually implement the "act as a builder" flow e2e, I rather tend towards not mixing up apis required by validators and builders too much

see discord for conversation about this

Comment thread apis/validator/execution_payload_envelope.yaml Outdated
nflaig added a commit to ChainSafe/lodestar that referenced this pull request Feb 20, 2026
Notable changes
- implement epbs stateful block production (self-build only)
  - `GET /eth/v4/validator/blocks/{slot}` added
- `GET
/eth/v1/validator/execution_payload_envelope/{slot}/{beacon_block_root}`
added
  - `POST /eth/v1/beacon/execution_payload_envelope` added
  - `POST /eth/v2/beacon/blocks` updated
- implement envelope state root computation
- update block production cache for gloas (includes state root)
- add validator block production flow for gloas
- add envelope signing to validator store / remote signer
- data column sidecar changes required to wire up new gloas type
- update beacon-api spec to `v5.0.0-alpha.0`

see ethereum/beacon-APIs#580 for reference
Comment thread apis/validator/block.v4.yaml Outdated
Comment on lines +76 to +78
* if `exec_node_payload_value >= builder_boost_factor * (builder_payload_value // 100)`,
then return a full (unblinded) block containing the execution node payload.
* otherwise, return a blinded block containing the builder payload header.
Copy link
Copy Markdown
Contributor

@bharath-123 bharath-123 Feb 23, 2026

Choose a reason for hiding this comment

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

I don't think this applies with gloas anymore. Regardless of whether we self-build or fetch a bid from a builder. We will get back a SignedExecutionPayloadBid in the beacon block. In the case of the builder, the envelope won't be available with the validator.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

this needs to be rephrased for gloas, I think I brought that up in the other PR as well

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.

made minimal changes to the description to remove the blinded/unblinded references in 8bf9080

agreed builder_boost_factor needs to be rethought for gloas. we discussed briefly in the old PR here and briefly in the discord

I also found this builder-specs PR defining how BN can set preferences between external bids/p2p bis/VC bids

The question is whether we want to be able to override these BN preferences via the VC. I'm sure the answer is yes, and the question becomes "how"?

Would we want to modify the validator registrations endpoint to signal a VC's per builder bid boost preferences similar to as proposed in the builder spec PR? Pretty sure this POST fires every epoch or when one of the values change

This could replace builder_boost_factor for example

Open to other ideas as well

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Would we want to modify the validator registrations endpoint to signal a VC's per builder bid boost preferences similar to as proposed in the builder spec PR? Pretty sure this POST fires every epoch or when one of the values change

We want to get rid of this endpoint, by default, there won't be any registrations or builder preferences submitted to the beacon node, we only submit proposer preferences.

I left a comment related to this here #580 (comment). In my opinion, the beacon-api spec should have no notion of per builder configuration. The builder_boost_factor is still useful for the validator client to signal to the beacon node how it should decide on whether to self-build or pick a bid from the p2p pool, and the bid from the p2p pool is simply the one with the highest value.

Copy link
Copy Markdown
Contributor Author

@shane-moore shane-moore May 27, 2026

Choose a reason for hiding this comment

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

agree on keeping builder_boost_factor and not introducing per-builder config in the beacon-api. but i'm not sure the pre-Gloas formula carries over cleanly

pre-Gloas, the BN got exec_node_payload_value from its paired EL and compared it against builder_payload_value

in Gloas the bid's value field is the builder→proposer payment, and the spec mandates that self-builds set bid.value to zero. so if we keep the formula local_bid_value >= builder_boost_factor * (external_bid_value // 100) using bid value fields:

  • factor=0 → returns local (0 ≥ 0)
  • factor=100 → returns external (0 ≥ external_value is false)
  • factor=2**64-1 → returns external

100 and 2**64-1 seem to collapse to the same meaning

do we still expect the BN to somehow make factor=100 (profit max) meaningful? if yes, the formula stays but we should say so explicitly. if no, maybe we switch builder_boost_factor to a boolean like prefer_local=true|false

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

just to clarify this, we wanna compare the local payload value vs. the builder bid (the highest bid we have, could even include bids from api), the changes to builder_boost_factor description should be minimal, it isn't really different from what we do today, let me know @shane-moore if that clears things up

Copy link
Copy Markdown
Contributor Author

@shane-moore shane-moore May 28, 2026

Choose a reason for hiding this comment

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

thanks, that clears it up. Done in 4114350. Preconditions now read "has at least one viable builder ExecutionPayloadBid available" as to cover p2p and builder api derived bids. Open to any other tweaks!

Comment thread apis/validator/block.v4.yaml Outdated

Servers should use saturating arithmetic or another technique to ensure that large values of
the `builder_boost_factor` do not trigger overflows or errors. If this parameter is
provided and the beacon node is not configured with a builder then the beacon node MUST
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 guess with ePBS, the beacon node is always configured with a builder as it listens to the builder bids on the gossip topic anyways.

Copy link
Copy Markdown
Member

@nflaig nflaig Feb 24, 2026

Choose a reason for hiding this comment

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

not necessarily, we currently have an option to only produce local blocks which I intend to keep, but the default behavior will likely change with gloas to either use bid from p2p or build local, there are still valid reasons to force the node to build a local block, eg. builders censoring, which especially until FOCIL is shipped requires local blocks or a really sophisticated logic in clients to filter out bids from censoring builders

description: |
Instructs the beacon node to broadcast a signed execution payload envelope to the network,
to be gossiped for payload validation. A success response (20x) indicates
that the envelope passed gossip validation and was successfully broadcast onto the network.
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.

In publishBlockV2 we return 202 if block passed gossip validation but failed integration.

Are we doing something similar for publishExecutionPayloadEnvelope?

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 guess from another angle to think about this is we broadcast the payload regardless the result of the payload integration, or we integrate first, if it goes well, we then gossip?

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.

We probably want to propagate the envelope as quickly as possible, so ideally:

  1. Apply gossip validation
  2. Broadcast
  3. Run process_execution_payload and import to DB

If (1) fails, we 400. If (3) fails we should probably 202 just like for blocks.


I was hoping we could avoid the nastiness of broadcast_validation for envelopes, but I think there might actually be an unbundling attack (background) for envelopes now:

I think there is an unbundling attack something like:

  1. Malicious proposer publishes block A at slot N committing to bidA and payloadA, where bidA comes from an external builder (could be P2P or otherwise).
  2. Malicious proposer publishes block B (slashable) at slot N committing to bidB and payload payloadB. They will be slashed at the next slot.
  3. Builder for bidA starts to publish payloadA. Even on beacon nodes that have seen the equivocating block, the payload will PASS gossip validation as long as block A was imported.
  4. Proposer publishes payloadB for block B. Envelope gossip validation passes for payloadB because it is signed by a different builder from payloadA.
  5. Result: either A or B could become head, depending on timing. If B wins, the builder of A has revealed potentially valuable information, which could be worth the proposer slashing themselves for (they could use it for a self-build in the next slot).

Proposed fixes:

  1. We could put the burden on the builder to check for block equivocations prior to revealing their payload (no API/spec changes).
  2. We could add a gossip condition to reject envelopes for slashable blocks.
  3. We could add a broadcast_validation=equivocation flag (like we have for pre-Gloas blocks) to check that the envelope's block is not an equivocation. This flag would likely be used by all builders when interacting with their BNs.
  4. We could make the block equivocation check a default part of the API (same as broadcast_validation=equivocation from fix 3, but no flag required and no ability to opt-out).

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.

based off the discord convo, seems like a broadcast_validation flag is warranted. I built it out in b9b6fc6 to use same BroadcastValidation schema as produceBlocksV2 since all the possible values seem to make sense for envelopes as well, but lmk if have some other thoughts on it

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'm just catching up on the discussions here, but I think the broadcast_validation flag and its values make sense to me.

If im understanding correctly, the broadcast_validation =consensus_and_equivocation value on the publish_block endpoint will no longer be useful for unbundling protection? Probably no harm to keep it though.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

If im understanding correctly, the broadcast_validation =consensus_and_equivocation value on the publish_block endpoint will no longer be useful for unbundling protection?

no, it's not needed for this anymore, we could discuss if we wanna deprecate broadcast_validation on publishBlockV2, but might still be useful to have basic checks before publishing the block

@james-prysm james-prysm mentioned this pull request Mar 12, 2026
4 tasks
lodekeeper pushed a commit to lodekeeper/lodestar that referenced this pull request Mar 13, 2026
Notable changes
- implement epbs stateful block production (self-build only)
  - `GET /eth/v4/validator/blocks/{slot}` added
- `GET
/eth/v1/validator/execution_payload_envelope/{slot}/{beacon_block_root}`
added
  - `POST /eth/v1/beacon/execution_payload_envelope` added
  - `POST /eth/v2/beacon/blocks` updated
- implement envelope state root computation
- update block production cache for gloas (includes state root)
- add validator block production flow for gloas
- add envelope signing to validator store / remote signer
- data column sidecar changes required to wire up new gloas type
- update beacon-api spec to `v5.0.0-alpha.0`

see ethereum/beacon-APIs#580 for reference
github-merge-queue Bot pushed a commit to OffchainLabs/prysm that referenced this pull request Apr 10, 2026
**What type of PR is this?**

Feature

**What does this PR do? Why is it needed?**

implements the new GET /eth/v4/validator/blocks/{slot} endpoint, we
don't hook up the validator client to use it yet for post gloas in this
pr.

**Which issues(s) does this PR fix?**

Fixes ethereum/beacon-APIs#580

**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.
- [x] I have tested that my changes work as expected and I added a
testing plan to the PR description (if applicable).
github-merge-queue Bot pushed a commit to OffchainLabs/prysm that referenced this pull request Apr 14, 2026
**What type of PR is this?**

Feature

**What does this PR do? Why is it needed?**

implements the new GET /eth/v4/validator/blocks/{slot} endpoint, we
don't hook up the validator client to use it yet for post gloas in this
pr.

**Which issues(s) does this PR fix?**

Fixes ethereum/beacon-APIs#580

**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.
- [x] I have tested that my changes work as expected and I added a
testing plan to the PR description (if applicable).
@bharath-123
Copy link
Copy Markdown
Contributor

is this sorted now?

this pr could be merged as is imo. not sure if others think otherwise. my lingering question in #580 (comment) is about what to do with builder_boost_factor going forward since it doesn't make sense as is, but it probably doesn't make sense to spec it out in beacon api spec yet until builder api spec for how boosting certain builder's bid will work, i.e. ethereum/builder-specs#144. I could make a follow-up gh issue for this if preferable

builder_boost_factor probably needs to be rethought with ePBS. We probably need a builder_boost for p2p and builder-api bids or sth like that?

I think builder-specific flags like builder_boost, min_bid etc can be specified in the builder-specs. The community did want some standardization of these flags. I can update ethereum/builder-specs#144 to include all the necessary flags and I think the builder-specs is probably the right place to keep these builder based configurations.

"200":
description: "Successful response"
headers:
Eth-Consensus-Version:
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.

we don't need this header on a get request right?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

the header is in the response, and from what I can see, it's needed

- $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Gloas.SignedExecutionPayloadEnvelope"
application/octet-stream:
schema:
description: "SSZ serialized `SignedExecutionPayloadEnvelopeContents` or `SignedExecutionPayloadEnvelope` bytes. Use Content-Type header to specify this format"
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.

how are you checking which one was passed the contents of the payload envelope , i'm checking ssz offsets right now, but wondering if it makes sense to just add something in the header to separate the two

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.

how are you checking which one was passed the contents of the payload envelope , i'm checking ssz offsets right now, but wondering if it makes sense to just add something in the header to separate the two

Yea Lodestar ran into the same problem. I think we should have Eth-Blob-Data-Included or something to distinguish the two.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

We can either have a separate endpoint or add a header to differentiate both, ideally for the local stateful flow we just wanna pass a blinded execution payload envelope around to get the most out of it as passing the transactions around is not useful. If we go with BlindedExecutionPayloadEnvelope we could also nicely reuse the existing Eth-Execution-Payload-Blinded header 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.

an idea of how we could do the BlindedExecutionPayloadEnvelope and reuse Eth-Execution-Payload-Blinded header to differentiate shane-moore#10

description: |
Instructs the beacon node to broadcast a signed execution payload envelope to the network,
to be gossiped for payload validation. A success response (20x) indicates
that the envelope passed gossip validation and was successfully broadcast onto the network.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

If im understanding correctly, the broadcast_validation =consensus_and_equivocation value on the publish_block endpoint will no longer be useful for unbundling protection?

no, it's not needed for this anymore, we could discuss if we wanna deprecate broadcast_validation on publishBlockV2, but might still be useful to have basic checks before publishing the block

- $ref: "../../../beacon-node-oapi.yaml#/components/schemas/Gloas.SignedExecutionPayloadEnvelope"
application/octet-stream:
schema:
description: "SSZ serialized `SignedExecutionPayloadEnvelopeContents` or `SignedExecutionPayloadEnvelope` bytes. Use Content-Type header to specify this format"
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

We can either have a separate endpoint or add a header to differentiate both, ideally for the local stateful flow we just wanna pass a blinded execution payload envelope around to get the most out of it as passing the transactions around is not useful. If we go with BlindedExecutionPayloadEnvelope we could also nicely reuse the existing Eth-Execution-Payload-Blinded header here

enum: [gloas]
example: "gloas"
data:
$ref: "../../beacon-node-oapi.yaml#/components/schemas/Gloas.ExecutionPayloadEnvelope"
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I would be in favor of just returning a BlindedExecutionPayloadEnvelope here, that's the minimal object we need to pass to the validator client to sign over

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.

agreed, done in shane-moore#10

schema:
type: boolean
default: true
- name: builder_boost_factor
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@bharath-123 if a client doesn't have builders configured via api, we don't wanna submit builder preferences at all, so moving boost factor and other parameters there seem wrong to me, we need a way for the validator to signal this to the beacon node. And I don't think the beacon api should be concerned about off protocol builders or per builder configs

Comment thread apis/validator/execution_payload_envelope.yaml
@shane-moore
Copy link
Copy Markdown
Contributor Author

just pushed b613dde: the envelope's payload was still referencing Deneb.ExecutionPayload, missing block_access_list (EIP-7928) and slot_number (EIP-7843). new Gloas.ExecutionPayload adds them.

Per nflaig's review on ethereum#580 (r3310098827). Reroutes the endpoint to
/eth/v1/validator/execution_payload_envelope/{slot}/{beacon_block_root}.
shane-moore added a commit to shane-moore/beacon-APIs that referenced this pull request May 28, 2026
Per ethereum#580 (r3310000141). Drops the `blinded` query
param, drops the Eth-Execution-Payload-Blinded response header and the
execution_payload_blinded JSON field. The endpoint now returns only the
blinded form, which is the minimal object the validator client needs to
sign over.
@nflaig
Copy link
Copy Markdown
Member

nflaig commented May 28, 2026

just pushed b613dde: the envelope's payload was still referencing Deneb.ExecutionPayload, missing block_access_list (EIP-7928) and slot_number (EIP-7843). new Gloas.ExecutionPayload adds them.

we've just merged #607 which was already reviewed and had more updates for alpha.8, you will need to resolve conflicts here .. sorry

…with-payload

# Conflicts:
#	types/gloas/execution_payload.yaml
#	types/primitive.yaml
shane-moore added a commit to shane-moore/beacon-APIs that referenced this pull request May 28, 2026
Per ethereum#580 (r3310000141). Drops the `blinded` query
param, drops the Eth-Execution-Payload-Blinded response header and the
execution_payload_blinded JSON field. The endpoint now returns only the
blinded form, which is the minimal object the validator client needs to
sign over.
Comment thread apis/validator/block.v4.yaml Outdated
Per ethereum#580 review (nflaig, r3318956546 + r3318786779).
Description tweaks only; formula and semantics unchanged from V3:
- Terminology: "local bid" / "external builder payload" → "local execution
  node payload" / "builder bid"
- Preconditions: drop "is connected to a builder, deems it safe..." in
  favor of "has at least one viable builder ExecutionPayloadBid available"
  (covers p2p, beacon API, and builder integration sources)
- Formula bullet: add "for the highest builder bid known to the beacon
  node" (per nflaig: "the highest bid we have, could even include bids
  from api")
- builder_payload_value and exec_node_payload_value kept verbatim
Comment thread beacon-node-oapi.yaml Outdated
Comment thread beacon-node-oapi.yaml Outdated
james-prysm added a commit to OffchainLabs/prysm that referenced this pull request May 28, 2026
Completes 3fed1ee, which missed two occurrences that still tripped the
spellcheck CI (DVs is not in wordlist.txt):
- types/gloas/execution_payload_envelope.yaml
- validator-flow.md

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
shane-moore and others added 2 commits June 1, 2026 14:51
…with-payload

Resolve execution_payload path conflicts from ethereum#613 (pluralized endpoint paths): take master's plural forms for the already-merged ethereum#552 endpoints (execution_payload_bids, execution_payload_envelopes/{block_id}). The two new ethereum#580 envelope endpoints (POST execution_payload_envelope and validator GET execution_payload_envelope) are kept as-is here and pluralized in the follow-up commit.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Rename the two new envelope paths added by this PR to plural, matching the beacon-APIs collection convention (blocks, blinded_blocks, blobs) and ethereum#613, per nflaig review (r3337188903):
- POST /eth/v1/beacon/execution_payload_envelopes
- GET /eth/v1/validator/execution_payload_envelopes/{slot}/{beacon_block_root}

$ref filenames are left unchanged; only the URL path keys, the CHANGES.md entries, and the block.v4 cross-reference change. The execution_payload_bid event name stays singular.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
shane-moore added a commit to shane-moore/beacon-APIs that referenced this pull request Jun 1, 2026
Per ethereum#580 (r3310000141). Drops the `blinded` query
param, drops the Eth-Execution-Payload-Blinded response header and the
execution_payload_blinded JSON field. The endpoint now returns only the
blinded form, which is the minimal object the validator client needs to
sign over.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Gloas api's needed in Gloas fork.

Projects

None yet

Development

Successfully merging this pull request may close these issues.