Skip to content

Remove blinded execution payload envelope - #11091

Open
gfukushima wants to merge 11 commits into
Consensys:masterfrom
gfukushima:remove-BlindedExecutionPayloadEnvelope
Open

Remove blinded execution payload envelope#11091
gfukushima wants to merge 11 commits into
Consensys:masterfrom
gfukushima:remove-BlindedExecutionPayloadEnvelope

Conversation

@gfukushima

@gfukushima gfukushima commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

PR Description

Remove the blinded version of execution payload envelope following the change in the beacon api ethereum/beacon-APIs#624
We now use Eth-Blob-Data-Included to distinguish the request body of publishExecutionPayloadEnvelope

Fixed Issue(s)

Fixes #11044

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 the validator–beacon publish contract and Gloas gossip timing (payload blocked until sidecars are buildable), which can affect multi-node block production and blob availability.

Overview
Aligns Gloas execution payload publication with the updated beacon-APIs model: blinded envelopes and unblind-from-cache are removed, and publishExecutionPayloadEnvelope is split by Eth-Blob-Data-Included instead of Eth-Execution-Payload-Blinded.

Stateless (true): body is SignedExecutionPayloadEnvelopeContents (envelope plus blobs/KZG proofs). Stateful (false): body is SignedExecutionPayloadEnvelope; the node builds data column sidecars from cached getPayload data, with DataColumnSidecarCreationException when cache is missing or the payload root does not match (messages are returned to clients as rejections).

ExecutionPayloadPublisherGloas now runs broadcast validation in parallel with sidecar creation but gossip only after both succeed; if sidecars cannot be built but the block has no blob commitments, it still publishes the envelope with empty sidecars. Remote validator clients send the signed envelope directly with Eth-Blob-Data-Included: false (no auto-blind). OpenAPI drops blinded envelope schemas; produceBlockV4 treats include_payload as a required query parameter.

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

…nvelope from PostExecutionPayloadEnvelope, and add `Eth-Blob-Data-Included` header to distiguish between ExecutionPayloadEnvelopeContents and ExecutionPayloadEnvelope when parsing request body

Signed-off-by: Gabriel Fukushima <gabrielfukushima@gmail.com>

@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 and found 1 potential issue.

Fix All in Cursor

Reviewed by Cursor Bugbot for commit 045ebea. Configure here.

Signed-off-by: Gabriel Fukushima <gabrielfukushima@gmail.com>
final SignedBlindedExecutionPayloadEnvelope signedBlindedExecutionPayload,
final Optional<BroadcastValidationLevel> broadcastValidationLevel) {
return SafeFuture.<SignedExecutionPayloadEnvelope>of(
return SafeFuture.<List<DataColumnSidecar>>of(

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.

Should we abort the entire publish if we can't reconstruct blobs for it? Looks like previously we would still accept the valid signed envelope, and now we won't.

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.

looking into this, I think you're right, not having or being able to reconstruct should be reason enough to stop the publishing of the execution payload.

…atch with the signed execution payload envelope

Signed-off-by: Gabriel Fukushima <gabrielfukushima@gmail.com>
…sidecars

Signed-off-by: Gabriel Fukushima <gabrielfukushima@gmail.com>
# Conflicts:
#	data/beaconrestapi/src/integration-test/resources/tech/pegasys/teku/beaconrestapi/beacon/paths/_eth_v4_validator_blocks_{slot}.json
Signed-off-by: Gabriel Fukushima <gabrielfukushima@gmail.com>
…d reject a payload mismatch

Signed-off-by: Gabriel Fukushima <gabrielfukushima@gmail.com>
…velope' into remove-BlindedExecutionPayloadEnvelope
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.

[beacon api] remove BlindedExecutionPayloadEnvelope in gloas

2 participants