From f6479ffd95dac69340a05c0f73aa4eaf85b125d8 Mon Sep 17 00:00:00 2001 From: Lewis Chan Date: Thu, 23 Oct 2025 19:57:35 +0800 Subject: [PATCH 1/2] fix: rephrase meaning of attestations,signature,beacon_block_root(#16503) --- .../content/developers/docs/blocks/index.md | 28 +++++++++---------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/public/content/developers/docs/blocks/index.md b/public/content/developers/docs/blocks/index.md index 28e5bff918a..d8ca7bd8db1 100644 --- a/public/content/developers/docs/blocks/index.md +++ b/public/content/developers/docs/blocks/index.md @@ -56,8 +56,8 @@ The block `body` contains several fields of its own: | `eth1_data` | information about the deposit contract | | `graffiti` | arbitrary data used to tag blocks | | `proposer_slashings` | list of validators to be slashed | -| `attester_slashings` | list of attesters to be slashed | -| `attestations` | list of attestations in favor of the current block | +| `attester_slashings` | list of attesters to be slashed | +| `attestations` | list of attestations made against previous slots | | `deposits` | list of new deposits to the deposit contract | | `voluntary_exits` | list of validators exiting the network | | `sync_aggregate` | subset of validators used to serve light clients | @@ -65,21 +65,21 @@ The block `body` contains several fields of its own: The `attestations` field contains a list of all the attestations in the block. Attestations have their own data type that contains several pieces of data. Each attestation contains: -| Field | Description | -| :----------------- | :---------------------------------------------------------- | -| `aggregation_bits` | a list of which validators participated in this attestation | -| `data` | a container with multiple subfields | -| `signature` | aggregate signature of all attesting validators | +| Field | Description | +| :----------------- | :---------------------------------------------------------- | +| `aggregation_bits` | a list of which validators participated in this attestation | +| `data` | a container with multiple subfields | +| `signature` | aggregate signature of a set of validators against `data` part | The `data` field in the `attestation` contains the following: -| Field | Description | -| :------------------ | :------------------------------------------------------- | -| `slot` | the slot the attestation relates to | -| `index` | indices for attesting validators | -| `beacon_block_root` | the root hash of the Beacon block containing this object | -| `source` | the last justified checkpoint | -| `target` | the latest epoch boundary block | +| Field | Description | +| :------------------ | :------------------------------------------------------- | +| `slot` | the slot the attestation relates to | +| `index` | indices for attesting validators | +| `beacon_block_root` | the root hash of the Beacon block seen as the head of the chain | +| `source` | the last justified checkpoint | +| `target` | the latest epoch boundary block | Executing the transactions in the `execution_payload` updates the global state. All clients re-execute the transactions in the `execution_payload` to ensure the new state matches that in the new block `state_root` field. This is how clients can tell that a new block is valid and safe to add to their blockchain. The `execution payload` itself is an object with several fields. There is also an `execution_payload_header` that contains important summary information about the execution data. These data structures are organized as follows: From 4ee5446761e04b487339d68cc8c26ab717800823 Mon Sep 17 00:00:00 2001 From: Paul Wackerow <54227730+wackerow@users.noreply.github.com> Date: Thu, 23 Oct 2025 12:42:26 -0700 Subject: [PATCH 2/2] chore: auto-format whitespace --- .../content/developers/docs/blocks/index.md | 28 +++++++++---------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/public/content/developers/docs/blocks/index.md b/public/content/developers/docs/blocks/index.md index d8ca7bd8db1..840e8858e64 100644 --- a/public/content/developers/docs/blocks/index.md +++ b/public/content/developers/docs/blocks/index.md @@ -50,23 +50,23 @@ There is a lot of information contained within a block. At the highest level a b The block `body` contains several fields of its own: -| Field | Description | -| :------------------- | :------------------------------------------------- | -| `randao_reveal` | a value used to select the next block proposer | -| `eth1_data` | information about the deposit contract | -| `graffiti` | arbitrary data used to tag blocks | -| `proposer_slashings` | list of validators to be slashed | -| `attester_slashings` | list of attesters to be slashed | -| `attestations` | list of attestations made against previous slots | -| `deposits` | list of new deposits to the deposit contract | -| `voluntary_exits` | list of validators exiting the network | -| `sync_aggregate` | subset of validators used to serve light clients | -| `execution_payload` | transactions passed from the execution client | +| Field | Description | +| :------------------- | :----------------------------------------------- | +| `randao_reveal` | a value used to select the next block proposer | +| `eth1_data` | information about the deposit contract | +| `graffiti` | arbitrary data used to tag blocks | +| `proposer_slashings` | list of validators to be slashed | +| `attester_slashings` | list of attesters to be slashed | +| `attestations` | list of attestations made against previous slots | +| `deposits` | list of new deposits to the deposit contract | +| `voluntary_exits` | list of validators exiting the network | +| `sync_aggregate` | subset of validators used to serve light clients | +| `execution_payload` | transactions passed from the execution client | The `attestations` field contains a list of all the attestations in the block. Attestations have their own data type that contains several pieces of data. Each attestation contains: | Field | Description | -| :----------------- | :---------------------------------------------------------- | +| :----------------- | :------------------------------------------------------------- | | `aggregation_bits` | a list of which validators participated in this attestation | | `data` | a container with multiple subfields | | `signature` | aggregate signature of a set of validators against `data` part | @@ -74,7 +74,7 @@ The `attestations` field contains a list of all the attestations in the block. A The `data` field in the `attestation` contains the following: | Field | Description | -| :------------------ | :------------------------------------------------------- | +| :------------------ | :-------------------------------------------------------------- | | `slot` | the slot the attestation relates to | | `index` | indices for attesting validators | | `beacon_block_root` | the root hash of the Beacon block seen as the head of the chain |