Skip to content

Reflect recent update to gloas specs #607

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ensi321 wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Reflect recent update to gloas specs #607

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f7e2e1a
Sync Gloas schemas with consensus-specs v1.7.0-alpha.9
ensi321 May 18, 2026
90c549b
Address review feedback
ensi321 May 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions beacon-node-oapi.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -449,6 +449,8 @@ components:
$ref: "./types/gloas/execution_payload_bid.yaml#/Gloas/ExecutionPayloadBid"
Gloas.SignedExecutionPayloadBid:
$ref: "./types/gloas/execution_payload_bid.yaml#/Gloas/SignedExecutionPayloadBid"
Gloas.ExecutionPayload:
$ref: "./types/gloas/execution_payload.yaml#/Gloas/ExecutionPayload"
Gloas.ExecutionPayloadEnvelope:
$ref: "./types/gloas/execution_payload_envelope.yaml#/Gloas/ExecutionPayloadEnvelope"
Gloas.SignedExecutionPayloadEnvelope:
Expand Down
6 changes: 4 additions & 2 deletions types/gloas/block.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
Gloas:
BeaconBlockBody:
type: object
description: "The [`BeaconBlockBody`](https://github.com/ethereum/consensus-specs/blob/v1.7.0-alpha.2/specs/gloas/beacon-chain.md#beaconblockbody) object from the CL Gloas spec."
required: [randao_reveal, eth1_data, graffiti, proposer_slashings, attester_slashings, attestations, deposits, voluntary_exits, sync_aggregate, bls_to_execution_changes, signed_execution_payload_bid, payload_attestations]
description: "The [`BeaconBlockBody`](https://github.com/ethereum/consensus-specs/blob/v1.7.0-alpha.8/specs/gloas/beacon-chain.md#beaconblockbody) object from the CL Gloas spec."
Copy link
Copy Markdown
Member

@nflaig nflaig May 27, 2026 •
edited
Loading

Choose a reason for hiding this comment

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

I think it would be good if we can bump all spec references to v1.7.0-alpha.8 that currently reference an older alpha.x release

required: [randao_reveal, eth1_data, graffiti, proposer_slashings, attester_slashings, attestations, deposits, voluntary_exits, sync_aggregate, bls_to_execution_changes, signed_execution_payload_bid, payload_attestations, parent_execution_requests]
properties:
randao_reveal:
$ref: "../primitive.yaml#/Signature"
Expand Down Expand Up @@ -46,6 +46,8 @@ Gloas:
$ref: "./payload_attestation.yaml#/Gloas/PayloadAttestation"
minItems: 0
maxItems: 4
parent_execution_requests:
$ref: "../electra/execution_requests.yaml#/Electra/ExecutionRequests"

BeaconBlock:
description: "The [`BeaconBlock`](https://github.com/ethereum/consensus-specs/blob/v1.5.0/specs/phase0/beacon-chain.md#beaconblock) object from the CL Gloas spec."
Expand Down
15 changes: 15 additions & 0 deletions types/gloas/execution_payload.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
Gloas:
ExecutionPayload:
description: "The [`ExecutionPayload`](https://github.com/ethereum/consensus-specs/blob/v1.7.0-alpha.8/specs/gloas/beacon-chain.md#executionpayload) object from the CL Gloas spec."
allOf:
- $ref: "../deneb/execution_payload.yaml#/Deneb/ExecutionPayload"
- type: object
required: [block_access_list, slot_number]
properties:
block_access_list:
type: string
format: hex
description: "RLP encoded `BlockAccessList` as defined in [EIP-7928]"
Copy link
Copy Markdown
Member

@nflaig nflaig May 27, 2026 •
edited
Loading

Choose a reason for hiding this comment

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

is this supposed to have a link to the EIP?

Suggested change
description: "RLP encoded `BlockAccessList` as defined in [EIP-7928]"
description: "RLP encoded `BlockAccessList` as defined in [EIP-7928](https://eips.ethereum.org/EIPS/eip-7928)"

pattern: "^0x[a-fA-F0-9]{0,2147483648}$"
Copy link
Copy Markdown
Member

@nflaig nflaig May 27, 2026

Choose a reason for hiding this comment

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

might be good to also add an example above pattern

eg. example: "0xe5e494abcf8e0d4e9587369b2301d0790347320302cc09c0c0cac90187b1a2bc2ec50000c0c0"

slot_number:
$ref: "../primitive.yaml#/Uint64"
14 changes: 8 additions & 6 deletions types/gloas/execution_payload_bid.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
Gloas:
ExecutionPayloadBid:
type: object
description: "The [`ExecutionPayloadBid`](https://github.com/ethereum/consensus-specs/blob/v1.7.0-alpha.2/specs/gloas/beacon-chain.md#executionpayloadbid) object from the CL Gloas spec."
required: [parent_block_hash, parent_block_root, block_hash, prev_randao, fee_recipient, gas_limit, builder_index, slot, value, execution_payment, blob_kzg_commitments]
description: "The [`ExecutionPayloadBid`](https://github.com/ethereum/consensus-specs/blob/v1.7.0-alpha.8/specs/gloas/beacon-chain.md#executionpayloadbid) object from the CL Gloas spec."
required: [parent_block_hash, parent_block_root, block_hash, prev_randao, fee_recipient, gas_limit, builder_index, slot, value, execution_payment, blob_kzg_commitments, execution_requests_root]
properties:
parent_block_hash:
$ref: "../primitive.yaml#/Root"
$ref: "../primitive.yaml#/Hash32"
parent_block_root:
$ref: "../primitive.yaml#/Root"
block_hash:
$ref: "../primitive.yaml#/Root"
$ref: "../primitive.yaml#/Hash32"
prev_randao:
$ref: "../primitive.yaml#/Root"
$ref: "../primitive.yaml#/Bytes32"
fee_recipient:
$ref: "../primitive.yaml#/ExecutionAddress"
gas_limit:
Expand All @@ -28,10 +28,12 @@ Gloas:
type: array
items:
$ref: '../primitive.yaml#/KZGCommitment'
execution_requests_root:
$ref: "../primitive.yaml#/Root"

SignedExecutionPayloadBid:
type: object
description: "The [`SignedExecutionPayloadBid`](https://github.com/ethereum/consensus-specs/blob/v1.7.0-alpha.2/specs/gloas/beacon-chain.md#signedexecutionpayloadbid) object from the CL Gloas spec."
description: "The [`SignedExecutionPayloadBid`](https://github.com/ethereum/consensus-specs/blob/v1.7.0-alpha.8/specs/gloas/beacon-chain.md#signedexecutionpayloadbid) object from the CL Gloas spec."
required: [message, signature]
properties:
message:
Expand Down
6 changes: 3 additions & 3 deletions types/gloas/execution_payload_envelope.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
Gloas:
ExecutionPayloadEnvelope:
type: object
description: "The [`ExecutionPayloadEnvelope`](https://github.com/ethereum/consensus-specs/blob/v1.7.0-alpha.7/specs/gloas/beacon-chain.md#executionpayloadenvelope) object from the CL Gloas spec."
description: "The [`ExecutionPayloadEnvelope`](https://github.com/ethereum/consensus-specs/blob/v1.7.0-alpha.8/specs/gloas/beacon-chain.md#executionpayloadenvelope) object from the CL Gloas spec."
required: [payload, execution_requests, builder_index, beacon_block_root, parent_beacon_block_root]
properties:
payload:
$ref: "../deneb/execution_payload.yaml#/Deneb/ExecutionPayload"
$ref: "./execution_payload.yaml#/Gloas/ExecutionPayload"
execution_requests:
$ref: "../electra/execution_requests.yaml#/Electra/ExecutionRequests"
builder_index:
Expand All @@ -20,7 +20,7 @@ Gloas:

SignedExecutionPayloadEnvelope:
type: object
description: "The [`SignedExecutionPayloadEnvelope`](https://github.com/ethereum/consensus-specs/blob/v1.7.0-alpha.7/specs/gloas/beacon-chain.md#signedexecutionpayloadenvelope) object from the CL Gloas spec."
description: "The [`SignedExecutionPayloadEnvelope`](https://github.com/ethereum/consensus-specs/blob/v1.7.0-alpha.8/specs/gloas/beacon-chain.md#signedexecutionpayloadenvelope) object from the CL Gloas spec."
required: [message, signature]
properties:
message:
Expand Down
6 changes: 6 additions & 0 deletions types/primitive.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,12 @@ Root:
example: "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
pattern: "^0x[a-fA-F0-9]{64}$"

Hash32:
Copy link
Copy Markdown
Contributor Author

@ensi321 ensi321 May 18, 2026

Choose a reason for hiding this comment

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

I am not sure if we want this, or we can just use Byte32. I think it is nice to have a separate Hash32 type for EL related fields in CL.

But I also see block_hash in ExecutionPayloadCommon being Root.

Copy link
Copy Markdown
Contributor

@rolfyone rolfyone May 25, 2026

Choose a reason for hiding this comment

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

its differentiated in the spec, so it might make it cleaner to have hash32 defined here too. fair call imo.

Copy link
Copy Markdown
Member

@nflaig nflaig May 26, 2026

Choose a reason for hiding this comment

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

I am fine with adding Hash32 but should make sure it's used consistently across the board, and not just gloas types, a separate PR for this might be better

type: string
format: hex
example: "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
pattern: "^0x[a-fA-F0-9]{64}$"

Bytes32:
type: string
format: hex
Expand Down
1 change: 1 addition & 0 deletions wordlist.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,3 +45,4 @@ ptc
PtcDuty
produceBlockV
stateful
RLP
Loading