From 686b4819cb2ced89af8e10e81d4052a24ba8c46f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Tue, 3 Nov 2026 18:34:28 -0300 Subject: [PATCH 01/18] feat(p2p): refuse execution payloads whose block hash is not their header's Rebuild the execution block header from a payload's own fields and reject the message when keccak256(rlp(header)) differs from the claimed block_hash. Runs on pre-gloas beacon_block gossip (bellatrix to fulu), on gloas execution_payload gossip, and on every envelope fetched by root or range. Since engine_newPayloadV2 the Engine API answers a block-hash mismatch with INVALID and a null latestValidHash, indistinguishable from an executed-invalid payload whose last valid ancestor is unknown. Catching the structural case on the consensus side keeps such payloads from being applied to fork choice ahead of the execution client's answer. The header is encoded in ethlambda-p2p rather than through ethrex's BlockHeader, which holds base_fee_per_gas as a u64 where the payload has 256 bits. Each fork is tested against a real block or envelope (Sepolia, Hoodi, mainnet, Plataberget) plus a one-field-changed refusal. This is stricter than the consensus specs' gossip rules, documented in docs/spec_deviations.md and docs/beacon_wire.md. --- Cargo.lock | 1 + .../state_transition/src/beacon/gossip/mod.rs | 5 + crates/net/p2p/Cargo.toml | 3 + crates/net/p2p/src/beacon/envelope_checks.rs | 19 +- crates/net/p2p/src/beacon/mod.rs | 1 + crates/net/p2p/src/beacon/payload_hash.rs | 365 ++++++++++++++++++ .../net/p2p/src/beacon/payload_hash/tests.rs | 233 +++++++++++ .../payload_hash/hoodi_deneb_slot_2003.ssz | Bin 0 -> 22301 bytes .../payload_hash/hoodi_electra_slot_70001.ssz | Bin 0 -> 11608 bytes .../mainnet_fulu_slot_15576000.ssz | Bin 0 -> 71490 bytes ...plataberget_gloas_envelope_slot_593101.ssz | Bin 0 -> 7311 bytes .../sepolia_bellatrix_slot_500000.ssz | Bin 0 -> 2820 bytes .../sepolia_capella_slot_1900000.ssz | Bin 0 -> 2413 bytes crates/net/p2p/src/gossipsub/handler.rs | 25 +- crates/net/p2p/src/metrics.rs | 18 + .../net/p2p/src/req_resp/envelope_client.rs | 8 +- docs/beacon_wire.md | 12 +- docs/spec_deviations.md | 31 ++ 18 files changed, 714 insertions(+), 7 deletions(-) create mode 100644 crates/net/p2p/src/beacon/payload_hash.rs create mode 100644 crates/net/p2p/src/beacon/payload_hash/tests.rs create mode 100644 crates/net/p2p/src/beacon/testdata/payload_hash/hoodi_deneb_slot_2003.ssz create mode 100644 crates/net/p2p/src/beacon/testdata/payload_hash/hoodi_electra_slot_70001.ssz create mode 100644 crates/net/p2p/src/beacon/testdata/payload_hash/mainnet_fulu_slot_15576000.ssz create mode 100644 crates/net/p2p/src/beacon/testdata/payload_hash/plataberget_gloas_envelope_slot_593101.ssz create mode 100644 crates/net/p2p/src/beacon/testdata/payload_hash/sepolia_bellatrix_slot_500000.ssz create mode 100644 crates/net/p2p/src/beacon/testdata/payload_hash/sepolia_capella_slot_1900000.ssz diff --git a/Cargo.lock b/Cargo.lock index 0bec6c9e0..49c56bc1c 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -2116,6 +2116,7 @@ dependencies = [ "ethrex-common", "ethrex-p2p", "ethrex-rlp", + "ethrex-trie", "futures", "hex", "libp2p", diff --git a/crates/blockchain/state_transition/src/beacon/gossip/mod.rs b/crates/blockchain/state_transition/src/beacon/gossip/mod.rs index 701fa705c..1d5019069 100644 --- a/crates/blockchain/state_transition/src/beacon/gossip/mod.rs +++ b/crates/blockchain/state_transition/src/beacon/gossip/mod.rs @@ -321,6 +321,10 @@ pub enum RejectReason { BuilderIndexMismatch, /// A gloas envelope's payload block hash is not its bid's. BlockHashMismatch, + /// An execution payload's `block_hash` is not the hash of the execution + /// block header rebuilt from the payload's own fields. A check stricter + /// than the specification's, run in p2p: see `docs/spec_deviations.md`. + PayloadBlockHashMismatch, /// The root of a gloas envelope's execution requests is not its bid's. ExecutionRequestsRootMismatch, /// A gloas envelope's payload carries more withdrawals than its limit. @@ -384,6 +388,7 @@ impl RejectReason { Self::PayloadInvalid => "payload_invalid", Self::BuilderIndexMismatch => "builder_index_mismatch", Self::BlockHashMismatch => "block_hash_mismatch", + Self::PayloadBlockHashMismatch => "payload_block_hash_mismatch", Self::ExecutionRequestsRootMismatch => "execution_requests_root_mismatch", Self::TooManyWithdrawals => "too_many_withdrawals", Self::PreGloasSlot => "pre_gloas_slot", diff --git a/crates/net/p2p/Cargo.toml b/crates/net/p2p/Cargo.toml index 22154e141..e386426eb 100644 --- a/crates/net/p2p/Cargo.toml +++ b/crates/net/p2p/Cargo.toml @@ -70,6 +70,9 @@ rand = "0.8" # against with nothing in the manifest saying so. ethrex-p2p = { git = "https://github.com/lambdaclass/ethrex", tag = "v25.0.0" } ethrex-rlp = { git = "https://github.com/lambdaclass/ethrex", tag = "v25.0.0" } +# The ordered trie behind a payload's transactions root, which `ethrex-common` +# only builds from decoded transactions, not the raw bytes a payload carries. +ethrex-trie = { git = "https://github.com/lambdaclass/ethrex", tag = "v25.0.0" } ethrex-common = { git = "https://github.com/lambdaclass/ethrex", tag = "v25.0.0" } # `rand` seeds the throwaway signing keys the ENR tests build records with. diff --git a/crates/net/p2p/src/beacon/envelope_checks.rs b/crates/net/p2p/src/beacon/envelope_checks.rs index 5dbbd43de..0690e378b 100644 --- a/crates/net/p2p/src/beacon/envelope_checks.rs +++ b/crates/net/p2p/src/beacon/envelope_checks.rs @@ -33,6 +33,7 @@ use ethlambda_types::beacon::containers::gloas::SignedExecutionPayloadEnvelope; use tracing::{debug, error, warn}; use crate::P2PServer; +use crate::beacon::payload_hash; /// Whether a fetched envelope goes to the chain actor. pub(crate) fn forwards(outcome: &Outcome) -> bool { @@ -48,10 +49,14 @@ fn judge(store: &Store, envelope: &SignedExecutionPayloadEnvelope) -> Outcome { // A fresh, empty cache: a fetched envelope is not a gossip duplicate of // anything, so the cache's one rule never fires. let seen = SeenEnvelopes::new(NonZeroUsize::MIN); - match cheap_checks(&seen, store, envelope) { - Ok(()) => stateful_checks(store, envelope), - Err(outcome) => outcome, + if let Err(outcome) = cheap_checks(&seen, store, envelope) { + return outcome; } + // The same stricter-than-the-specification rule the gossip topic runs. + if let Err(outcome) = payload_hash::reject_envelope_on_mismatch(envelope) { + return outcome; + } + stateful_checks(store, envelope) } /// Run the gossip rules on `envelopes` and send the chain actor the ones that @@ -235,7 +240,13 @@ pub(crate) mod tests { } pub(crate) fn envelope(slot: u64, byte: u8) -> SignedExecutionPayloadEnvelope { - crate::beacon::encoding::test_support::envelope(H256::repeat_byte(byte), slot, H256::ZERO) + // Sealed: the fetched-envelope rules refuse a block hash that is not + // the payload's header's. + payload_hash::seal_envelope(crate::beacon::encoding::test_support::envelope( + H256::repeat_byte(byte), + slot, + H256::ZERO, + )) } #[test] diff --git a/crates/net/p2p/src/beacon/mod.rs b/crates/net/p2p/src/beacon/mod.rs index 33944b4f7..dce6adf2d 100644 --- a/crates/net/p2p/src/beacon/mod.rs +++ b/crates/net/p2p/src/beacon/mod.rs @@ -21,6 +21,7 @@ pub mod envelope_checks; pub mod fork_schedule; pub mod handler; pub mod messages; +pub mod payload_hash; pub mod protocols; pub mod scoring; pub mod subnets; diff --git a/crates/net/p2p/src/beacon/payload_hash.rs b/crates/net/p2p/src/beacon/payload_hash.rs new file mode 100644 index 000000000..b0e33b905 --- /dev/null +++ b/crates/net/p2p/src/beacon/payload_hash.rs @@ -0,0 +1,365 @@ +//! The execution block hash an execution payload claims, checked against the +//! header rebuilt from the payload's own fields. +//! +//! A payload carries its `block_hash` next to the fields that hash is taken +//! over, so a node can recompute it without an execution client: the header is +//! the payload's fields plus the transactions, withdrawals and requests tries, +//! RLP-encoded and keccak-hashed. The Engine API answers a mismatch with +//! `INVALID` and a null `latestValidHash` (execution-apis `shanghai.md`), which +//! is indistinguishable from a payload that executed badly and whose last valid +//! ancestor is unknown. Catching the structural case here keeps such a payload +//! from ever reaching fork choice. It is a rule stricter than the consensus +//! specification's gossip rules; see `docs/spec_deviations.md`. +//! +//! The header's shape per fork: +//! +//! | fork | adds to the header | +//! |-----------|-----------------------------------------------------------| +//! | bellatrix | the London fields, with `base_fee_per_gas` | +//! | capella | `withdrawals_root` | +//! | deneb | `blob_gas_used`, `excess_blob_gas`, `parent_beacon_block_root` | +//! | electra | `requests_hash` (fulu is the same) | +//! | gloas | `block_access_list_hash`, `slot_number` | +//! +//! Fields the execution layer fixes after the merge are constants here: no +//! ommers, difficulty zero, a zero nonce, `prev_randao` in the mix hash slot. +//! The header is encoded here rather than through ethrex's `BlockHeader`, +//! which holds `base_fee_per_gas` as a `u64` where the payload has 256 bits. + +use ethlambda_state_transition::beacon::gossip::{Outcome, RejectReason}; +use ethlambda_state_transition::beacon::stf::{electra, gloas as gloas_stf}; +use ethlambda_types::ShortRoot; +use ethlambda_types::beacon::containers::{SignedBeaconBlock, capella, gloas}; +use ethlambda_types::beacon::primitives::Root; +use ethrex_common::types::requests::{EncodedRequests, compute_requests_hash}; +use ethrex_common::types::{Withdrawal, compute_withdrawals_root}; +use ethrex_common::{Address, Bloom, Bytes, H256, NativeCrypto, U256}; +use ethrex_rlp::encode::RLPEncode; +use ethrex_rlp::structs::Encoder; +use ethrex_trie::Trie; +use tracing::warn; + +use crate::metrics; + +/// `keccak256(rlp([]))`: the ommers hash of every post-merge block. +const EMPTY_OMMERS_HASH: [u8; 32] = [ + 0x1d, 0xcc, 0x4d, 0xe8, 0xde, 0xc7, 0x5d, 0x7a, 0xab, 0x85, 0xb5, 0x67, 0xb6, 0xcc, 0xd4, 0x1a, + 0xd3, 0x12, 0x45, 0x1b, 0x94, 0x8a, 0x74, 0x13, 0xf0, 0xa1, 0x42, 0xfd, 0x40, 0xd4, 0x93, 0x47, +]; + +/// The hash the payload claims against the one its fields give. +#[derive(Debug, Clone, Copy, PartialEq, Eq)] +pub struct HashMismatch { + pub claimed: [u8; 32], + pub computed: [u8; 32], +} + +/// What a payload and its surroundings supply to the header, whatever the fork. +struct Fields<'a> { + parent_hash: [u8; 32], + fee_recipient: [u8; 20], + state_root: [u8; 32], + receipts_root: [u8; 32], + logs_bloom: &'a [u8], + prev_randao: [u8; 32], + block_number: u64, + gas_limit: u64, + gas_used: u64, + timestamp: u64, + extra_data: &'a [u8], + /// 32 little-endian bytes, as SSZ carries it. + base_fee_per_gas: [u8; 32], + claimed_hash: [u8; 32], + transactions: Vec<&'a [u8]>, + /// `None` before capella. + withdrawals: Option<&'a [capella::Withdrawal]>, + /// `None` before deneb. + blob_gas: Option<(u64, u64)>, + /// `None` before deneb. + parent_beacon_block_root: Option<[u8; 32]>, + /// The Engine API's request list; `None` before electra. + requests: Option>>, + /// The payload's block access list bytes and slot number; `None` before gloas. + amsterdam: Option<(&'a [u8], u64)>, +} + +impl Fields<'_> { + /// `keccak256(rlp(header))`. + fn computed_hash(&self) -> [u8; 32] { + // The trie roots are over opaque bytes: a transaction is already + // `type || rlp(tx)` on the wire, so it is never decoded. + let transactions = self + .transactions + .iter() + .enumerate() + .map(|(index, tx)| (index.encode_to_vec(), tx.to_vec())); + let transactions_root = Trie::compute_hash_from_unsorted_iter(transactions, &NativeCrypto); + let withdrawals_root = self.withdrawals.map(|withdrawals| { + let withdrawals: Vec = withdrawals + .iter() + .map(|withdrawal| Withdrawal { + index: withdrawal.index, + validator_index: withdrawal.validator_index, + address: Address::from(withdrawal.address.0), + amount: withdrawal.amount, + }) + .collect(); + compute_withdrawals_root(&withdrawals, &NativeCrypto) + }); + let requests_hash = self.requests.as_ref().map(|requests| { + let requests: Vec = requests + .iter() + .map(|request| EncodedRequests(Bytes::copy_from_slice(request))) + .collect(); + compute_requests_hash(&requests) + }); + // EIP-7928: the header commits to the keccak of the RLP bytes the + // payload carries, whatever they decode to. + let block_access_list_hash = self + .amsterdam + .map(|(bal, _)| H256(ethrex_crypto_keccak(bal))); + let slot_number = self.amsterdam.map(|(_, slot)| slot); + let base_fee_per_gas = U256::from_little_endian(&self.base_fee_per_gas); + + let mut buf = Vec::with_capacity(700); + Encoder::new(&mut buf) + .encode_field(&H256(self.parent_hash)) + .encode_field(&H256(EMPTY_OMMERS_HASH)) + .encode_field(&Address::from(self.fee_recipient)) + .encode_field(&H256(self.state_root)) + .encode_field(&transactions_root) + .encode_field(&H256(self.receipts_root)) + .encode_field(&Bloom::from_slice(self.logs_bloom)) + .encode_field(&U256::zero()) + .encode_field(&self.block_number) + .encode_field(&self.gas_limit) + .encode_field(&self.gas_used) + .encode_field(&self.timestamp) + .encode_field(&Bytes::copy_from_slice(self.extra_data)) + .encode_field(&H256(self.prev_randao)) + .encode_field(&[0u8; 8]) + .encode_field(&base_fee_per_gas) + .encode_optional_field(&withdrawals_root) + .encode_optional_field(&self.blob_gas.map(|(used, _)| used)) + .encode_optional_field(&self.blob_gas.map(|(_, excess)| excess)) + .encode_optional_field(&self.parent_beacon_block_root.map(H256)) + .encode_optional_field(&requests_hash) + .encode_optional_field(&block_access_list_hash) + .encode_optional_field(&slot_number) + .finish(); + ethrex_crypto_keccak(&buf) + } + + fn verify(&self) -> Result<(), HashMismatch> { + let computed = self.computed_hash(); + if computed == self.claimed_hash { + Ok(()) + } else { + Err(HashMismatch { + claimed: self.claimed_hash, + computed, + }) + } + } +} + +fn ethrex_crypto_keccak(data: &[u8]) -> [u8; 32] { + ethrex_common::utils::keccak(data).0 +} + +/// The block's payload hash against its header, for every fork that carries +/// the payload in the block body. +/// +/// A block before bellatrix, a bellatrix block from before the merge (its +/// payload is the empty default), and a gloas block (its payload arrives in a +/// separate envelope) have nothing to check. +pub fn verify_block(block: &SignedBeaconBlock) -> Result<(), HashMismatch> { + match block { + SignedBeaconBlock::Bellatrix(block) => { + let payload = &block.message.body.execution_payload; + if payload.block_hash.0 == [0; 32] && payload.parent_hash.0 == [0; 32] { + return Ok(()); + } + Fields { + parent_hash: payload.parent_hash.0, + fee_recipient: payload.fee_recipient.0, + state_root: payload.state_root.0, + receipts_root: payload.receipts_root.0, + logs_bloom: payload.logs_bloom.as_ref(), + prev_randao: payload.prev_randao.0, + block_number: payload.block_number, + gas_limit: payload.gas_limit, + gas_used: payload.gas_used, + timestamp: payload.timestamp, + extra_data: payload.extra_data.as_ref(), + base_fee_per_gas: payload.base_fee_per_gas.0, + claimed_hash: payload.block_hash.0, + transactions: payload.transactions.iter().map(|tx| &tx[..]).collect(), + withdrawals: None, + blob_gas: None, + parent_beacon_block_root: None, + requests: None, + amsterdam: None, + } + .verify() + } + SignedBeaconBlock::Capella(block) => { + let payload = &block.message.body.execution_payload; + Fields { + parent_hash: payload.parent_hash.0, + fee_recipient: payload.fee_recipient.0, + state_root: payload.state_root.0, + receipts_root: payload.receipts_root.0, + logs_bloom: payload.logs_bloom.as_ref(), + prev_randao: payload.prev_randao.0, + block_number: payload.block_number, + gas_limit: payload.gas_limit, + gas_used: payload.gas_used, + timestamp: payload.timestamp, + extra_data: payload.extra_data.as_ref(), + base_fee_per_gas: payload.base_fee_per_gas.0, + claimed_hash: payload.block_hash.0, + transactions: payload.transactions.iter().map(|tx| &tx[..]).collect(), + withdrawals: Some(payload.withdrawals.as_ref()), + blob_gas: None, + parent_beacon_block_root: None, + requests: None, + amsterdam: None, + } + .verify() + } + // Deneb, and electra and fulu on top of it: one payload container, + // with the requests list the only addition. + SignedBeaconBlock::Deneb(_) + | SignedBeaconBlock::Electra(_) + | SignedBeaconBlock::Fulu(_) => { + let parent_root = match block { + SignedBeaconBlock::Deneb(block) => block.message.parent_root.0, + SignedBeaconBlock::Electra(block) | SignedBeaconBlock::Fulu(block) => { + block.message.parent_root.0 + } + _ => unreachable!("narrowed by the outer match"), + }; + let (payload, requests) = match block { + SignedBeaconBlock::Deneb(block) => (&block.message.body.execution_payload, None), + SignedBeaconBlock::Electra(block) | SignedBeaconBlock::Fulu(block) => ( + &block.message.body.execution_payload, + Some(electra::get_execution_requests_list( + &block.message.body.execution_requests, + )), + ), + _ => unreachable!("narrowed by the outer match"), + }; + Fields { + parent_hash: payload.parent_hash.0, + fee_recipient: payload.fee_recipient.0, + state_root: payload.state_root.0, + receipts_root: payload.receipts_root.0, + logs_bloom: payload.logs_bloom.as_ref(), + prev_randao: payload.prev_randao.0, + block_number: payload.block_number, + gas_limit: payload.gas_limit, + gas_used: payload.gas_used, + timestamp: payload.timestamp, + extra_data: payload.extra_data.as_ref(), + base_fee_per_gas: payload.base_fee_per_gas.0, + claimed_hash: payload.block_hash.0, + transactions: payload.transactions.iter().map(|tx| &tx[..]).collect(), + withdrawals: Some(payload.withdrawals.as_ref()), + blob_gas: Some((payload.blob_gas_used, payload.excess_blob_gas)), + parent_beacon_block_root: Some(parent_root), + requests, + amsterdam: None, + } + .verify() + } + SignedBeaconBlock::Phase0(_) + | SignedBeaconBlock::Altair(_) + | SignedBeaconBlock::Gloas(_) + | SignedBeaconBlock::Lean(_) => Ok(()), + } +} + +/// A gloas envelope's payload hash against its header. +pub fn verify_envelope( + envelope: &gloas::SignedExecutionPayloadEnvelope, +) -> Result<(), HashMismatch> { + let message = &envelope.message; + let payload = &message.payload; + Fields { + parent_hash: payload.parent_hash.0, + fee_recipient: payload.fee_recipient.0, + state_root: payload.state_root.0, + receipts_root: payload.receipts_root.0, + logs_bloom: payload.logs_bloom.as_ref(), + prev_randao: payload.prev_randao.0, + block_number: payload.block_number, + gas_limit: payload.gas_limit, + gas_used: payload.gas_used, + timestamp: payload.timestamp, + extra_data: payload.extra_data.as_ref(), + base_fee_per_gas: payload.base_fee_per_gas.0, + claimed_hash: payload.block_hash.0, + transactions: payload.transactions.iter().map(|tx| &tx[..]).collect(), + withdrawals: Some(payload.withdrawals.as_ref()), + blob_gas: Some((payload.blob_gas_used, payload.excess_blob_gas)), + parent_beacon_block_root: Some(message.parent_beacon_block_root.0), + requests: Some(gloas_stf::get_execution_requests_list( + &message.execution_requests, + )), + amsterdam: Some((payload.block_access_list.as_ref(), payload.slot_number)), + } + .verify() +} + +/// `envelope` with its payload's `block_hash` set to the header's, for tests +/// that build a structurally valid envelope out of arbitrary fields. +#[cfg(test)] +pub(crate) fn seal_envelope( + mut envelope: gloas::SignedExecutionPayloadEnvelope, +) -> gloas::SignedExecutionPayloadEnvelope { + if let Err(mismatch) = verify_envelope(&envelope) { + envelope.message.payload.block_hash = mismatch.computed.into(); + } + envelope +} + +/// [`verify_block`] as a gossip verdict: `Err(Reject)` on a mismatch, counted +/// and logged. +pub(crate) fn reject_block_on_mismatch( + block: &SignedBeaconBlock, + block_root: Root, +) -> Result<(), Outcome> { + verify_block(block).map_err(|mismatch| refuse("block", block.slot(), block_root, mismatch)) +} + +/// [`verify_envelope`] as a verdict, shared by the gossip topic and the +/// fetched-envelope checks. +pub(crate) fn reject_envelope_on_mismatch( + envelope: &gloas::SignedExecutionPayloadEnvelope, +) -> Result<(), Outcome> { + verify_envelope(envelope).map_err(|mismatch| { + refuse( + "envelope", + envelope.message.payload.slot_number, + envelope.message.beacon_block_root, + mismatch, + ) + }) +} + +fn refuse(kind: &str, slot: u64, root: Root, mismatch: HashMismatch) -> Outcome { + metrics::inc_beacon_payload_block_hash_mismatch(kind); + warn!( + kind, + slot, + root = %ShortRoot(&root.0), + claimed = %ShortRoot(&mismatch.claimed), + computed = %ShortRoot(&mismatch.computed), + "Refusing an execution payload whose block hash is not its header's" + ); + Outcome::Reject(RejectReason::PayloadBlockHashMismatch) +} + +#[cfg(test)] +mod tests; diff --git a/crates/net/p2p/src/beacon/payload_hash/tests.rs b/crates/net/p2p/src/beacon/payload_hash/tests.rs new file mode 100644 index 000000000..500be82c8 --- /dev/null +++ b/crates/net/p2p/src/beacon/payload_hash/tests.rs @@ -0,0 +1,233 @@ +//! Every fork the node follows, against a payload taken from a real chain. +//! The vectors are SSZ as the Beacon API served it +//! (`beacon/testdata/payload_hash/`): +//! +//! | fork | chain | object | +//! |-----------|-------------|----------------------| +//! | bellatrix | Sepolia | block, slot 500000 | +//! | capella | Sepolia | block, slot 1900000 | +//! | deneb | Hoodi | block, slot 2003 | +//! | electra | Hoodi | block, slot 70001 | +//! | fulu | mainnet | block, slot 15576000 | +//! | gloas | Plataberget | envelope, slot 593101 | + +use ethlambda_types::beacon::containers::electra; +use ethlambda_types::beacon::fork::ForkName; +use libssz::SszDecode as _; + +use super::*; + +const BELLATRIX: &[u8] = + include_bytes!("../testdata/payload_hash/sepolia_bellatrix_slot_500000.ssz"); +const CAPELLA: &[u8] = include_bytes!("../testdata/payload_hash/sepolia_capella_slot_1900000.ssz"); +const DENEB: &[u8] = include_bytes!("../testdata/payload_hash/hoodi_deneb_slot_2003.ssz"); +const ELECTRA: &[u8] = include_bytes!("../testdata/payload_hash/hoodi_electra_slot_70001.ssz"); +const FULU: &[u8] = include_bytes!("../testdata/payload_hash/mainnet_fulu_slot_15576000.ssz"); +const GLOAS: &[u8] = + include_bytes!("../testdata/payload_hash/plataberget_gloas_envelope_slot_593101.ssz"); + +fn block(fork: ForkName, bytes: &[u8]) -> SignedBeaconBlock { + SignedBeaconBlock::from_ssz(fork, bytes).expect("a real block decodes") +} + +fn envelope() -> gloas::SignedExecutionPayloadEnvelope { + gloas::SignedExecutionPayloadEnvelope::from_ssz_bytes(GLOAS).expect("a real envelope decodes") +} + +fn bellatrix_payload( + block: &mut SignedBeaconBlock, +) -> &mut ethlambda_types::beacon::containers::bellatrix::ExecutionPayload { + let SignedBeaconBlock::Bellatrix(inner) = block else { + panic!("bellatrix"); + }; + &mut inner.message.body.execution_payload +} + +/// An all-zero request: only its presence matters to the requests hash. +fn consolidation() -> electra::ConsolidationRequest { + electra::ConsolidationRequest::from_ssz_bytes(&[0; 116]).expect("a fixed-size container") +} + +fn withdrawal() -> capella::Withdrawal { + capella::Withdrawal::from_ssz_bytes(&[0; 44]).expect("a fixed-size container") +} + +fn assert_refused(result: Result<(), HashMismatch>, what: &str) { + assert!(result.is_err(), "{what}: the hash must no longer match"); +} + +#[test] +fn every_real_payload_matches_its_hash() { + for (fork, bytes) in [ + (ForkName::Bellatrix, BELLATRIX), + (ForkName::Capella, CAPELLA), + (ForkName::Deneb, DENEB), + (ForkName::Electra, ELECTRA), + (ForkName::Fulu, FULU), + ] { + let block = block(fork, bytes); + assert_eq!(verify_block(&block), Ok(()), "{fork:?}"); + } + assert_eq!(verify_envelope(&envelope()), Ok(()), "gloas"); +} + +#[test] +fn the_vectors_exercise_what_each_fork_adds() { + let SignedBeaconBlock::Capella(capella) = block(ForkName::Capella, CAPELLA) else { + panic!("capella"); + }; + assert!( + !capella + .message + .body + .execution_payload + .withdrawals + .is_empty(), + "capella's vector must carry withdrawals" + ); + let SignedBeaconBlock::Fulu(fulu) = block(ForkName::Fulu, FULU) else { + panic!("fulu"); + }; + let SignedBeaconBlock::Bellatrix(bellatrix) = block(ForkName::Bellatrix, BELLATRIX) else { + panic!("bellatrix"); + }; + // Past the merge: a pre-merge block carries the empty default payload. + assert_ne!( + bellatrix.message.body.execution_payload.block_hash.0, + [0; 32] + ); + assert!(!fulu.message.body.execution_payload.transactions.is_empty()); + assert!(!envelope().message.payload.transactions.is_empty()); +} + +#[test] +fn a_changed_bellatrix_field_is_refused() { + let mut changed = block(ForkName::Bellatrix, BELLATRIX); + bellatrix_payload(&mut changed).gas_used += 1; + assert_refused(verify_block(&changed), "gas_used"); + + let mut changed = block(ForkName::Bellatrix, BELLATRIX); + bellatrix_payload(&mut changed).block_hash.0[0] ^= 1; + assert_refused(verify_block(&changed), "block_hash"); +} + +#[test] +fn a_changed_capella_withdrawal_is_refused() { + let mut changed = block(ForkName::Capella, CAPELLA); + let SignedBeaconBlock::Capella(inner) = &mut changed else { + panic!("capella"); + }; + inner.message.body.execution_payload.withdrawals[0].amount += 1; + assert_refused(verify_block(&changed), "withdrawal amount"); +} + +#[test] +fn a_changed_deneb_field_is_refused() { + for what in ["excess_blob_gas", "parent_root", "timestamp"] { + let mut changed = block(ForkName::Deneb, DENEB); + let SignedBeaconBlock::Deneb(inner) = &mut changed else { + panic!("deneb"); + }; + match what { + "excess_blob_gas" => inner.message.body.execution_payload.excess_blob_gas += 1, + // The header commits to the parent beacon block root, which the + // payload does not carry: it comes from the block. + "parent_root" => inner.message.parent_root.0[0] ^= 1, + _ => inner.message.body.execution_payload.timestamp += 1, + } + assert_refused(verify_block(&changed), what); + } +} + +#[test] +fn a_changed_electra_or_fulu_field_is_refused() { + for (fork, bytes) in [(ForkName::Electra, ELECTRA), (ForkName::Fulu, FULU)] { + for what in ["transaction", "parent_root", "request", "extra_data"] { + let mut changed = block(fork, bytes); + let (SignedBeaconBlock::Electra(inner) | SignedBeaconBlock::Fulu(inner)) = &mut changed + else { + panic!("electra or fulu"); + }; + match what { + "transaction" => { + let payload = &mut inner.message.body.execution_payload; + let last = payload.transactions.len() - 1; + let tx = &mut payload.transactions[last]; + let end = tx.len() - 1; + tx[end] ^= 1; + } + "parent_root" => inner.message.parent_root.0[0] ^= 1, + // The requests hash covers a request however empty its + // payload: one more consolidation moves it. + "request" => inner + .message + .body + .execution_requests + .consolidations + .push(consolidation()) + .expect("room for one more request"), + _ => inner + .message + .body + .execution_payload + .extra_data + .push(1) + .expect("room for one more byte"), + } + assert_refused(verify_block(&changed), &format!("{fork:?} {what}")); + } + } +} + +#[test] +fn a_changed_gloas_field_is_refused() { + for what in [ + "slot_number", + "block_access_list", + "parent_beacon_block_root", + "execution_requests", + "withdrawal", + "transaction", + "base_fee_per_gas", + ] { + let mut changed = envelope(); + let message = &mut changed.message; + match what { + "slot_number" => message.payload.slot_number += 1, + "block_access_list" => message.payload.block_access_list.push(0), + "parent_beacon_block_root" => message.parent_beacon_block_root.0[0] ^= 1, + "execution_requests" => message + .execution_requests + .consolidations + .push(consolidation()), + "withdrawal" => message.payload.withdrawals.push(withdrawal()), + "transaction" => { + let last = message.payload.transactions.len() - 1; + let tx = &mut message.payload.transactions[last]; + let end = tx.len() - 1; + tx[end] ^= 1; + } + _ => message.payload.base_fee_per_gas.0[31] ^= 1, + } + assert_refused(verify_envelope(&changed), what); + } +} + +#[test] +fn a_pre_merge_bellatrix_payload_has_nothing_to_check() { + // Before the merge a block carries the empty default payload. + let mut empty = block(ForkName::Bellatrix, BELLATRIX); + let payload = bellatrix_payload(&mut empty); + payload.block_hash = Default::default(); + payload.parent_hash = Default::default(); + assert_eq!(verify_block(&empty), Ok(())); +} + +#[test] +fn a_mismatch_is_a_reject_with_its_own_reason() { + let mut changed = envelope(); + changed.message.payload.gas_used += 1; + let outcome = reject_envelope_on_mismatch(&changed).expect_err("a changed envelope"); + assert_eq!(outcome.labels(), ("reject", "payload_block_hash_mismatch")); + assert!(reject_envelope_on_mismatch(&envelope()).is_ok()); +} diff --git a/crates/net/p2p/src/beacon/testdata/payload_hash/hoodi_deneb_slot_2003.ssz b/crates/net/p2p/src/beacon/testdata/payload_hash/hoodi_deneb_slot_2003.ssz new file mode 100644 index 0000000000000000000000000000000000000000..0520bc7e8cf7f08444f9f1c34cabe7aa8bf03d6e GIT binary patch literal 22301 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 Xt&O3!0h{;@Z0QND-S6N8HMai)3H96R literal 0 HcmV?d00001 diff --git a/crates/net/p2p/src/beacon/testdata/payload_hash/mainnet_fulu_slot_15576000.ssz b/crates/net/p2p/src/beacon/testdata/payload_hash/mainnet_fulu_slot_15576000.ssz new file mode 100644 index 0000000000000000000000000000000000000000..3f2355c3d4cf286ec6c1d44a794f7037fe25839d GIT binary patch literal 71490 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 R%zZ^B!2}QhkB$F3{sUUl literal 0 HcmV?d00001 diff --git a/crates/net/p2p/src/beacon/testdata/payload_hash/sepolia_bellatrix_slot_500000.ssz b/crates/net/p2p/src/beacon/testdata/payload_hash/sepolia_bellatrix_slot_500000.ssz new file mode 100644 index 0000000000000000000000000000000000000000..3f721faeaaa047ca37a6f493635173414d88c28b GIT binary patch literal 2820 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 literal 0 HcmV?d00001 diff --git a/crates/net/p2p/src/gossipsub/handler.rs b/crates/net/p2p/src/gossipsub/handler.rs index d6b90bce0..bc06df996 100644 --- a/crates/net/p2p/src/gossipsub/handler.rs +++ b/crates/net/p2p/src/gossipsub/handler.rs @@ -36,6 +36,7 @@ use super::{ }; use crate::beacon::constants::ATTESTATION_SUBNET_COUNT; use crate::beacon::decode::BeaconGossip; +use crate::beacon::payload_hash; use crate::beacon::verdict::{self, Dispatch, GossipId, Validated}; use crate::beacon::{BeaconWire, decode as beacon_decode, topics as beacon_topics}; use crate::{P2PServer, metrics}; @@ -323,6 +324,11 @@ fn triage_block(server: &P2PServer, wire: &BeaconWire, payload: &[u8]) -> Dispat { return Dispatch::Report(outcome); } + // Stricter than the specification: see `beacon::payload_hash`. After the + // rules that drop most messages, since it hashes every transaction. + if let Err(outcome) = payload_hash::reject_block_on_mismatch(&block, block_root) { + return Dispatch::Report(outcome); + } Dispatch::Validate(Validated::Block { block: Box::new(block), block_root, @@ -529,6 +535,9 @@ fn triage_envelope(server: &P2PServer, payload: &[u8]) -> Dispatch { { return Dispatch::Report(outcome); } + if let Err(outcome) = payload_hash::reject_envelope_on_mismatch(&envelope) { + return Dispatch::Report(outcome); + } Dispatch::Validate(Validated::Envelope(Box::new(envelope))) } @@ -1762,7 +1771,7 @@ mod tests { #[tokio::test] async fn an_envelope_passes_triage_unless_its_key_was_seen() { let mut server = unconnected_beacon_server(Config::mainnet(), 0).await; - let envelope = crate::test_support::envelope(1, 3); + let envelope = payload_hash::seal_envelope(crate::test_support::envelope(1, 3)); let payload = envelope.to_ssz(); assert!(matches!( @@ -1780,6 +1789,20 @@ mod tests { )); } + /// An envelope whose block hash is not its payload header's is rejected + /// in triage, before any state is read, and counted. + #[tokio::test] + async fn an_envelope_with_a_wrong_block_hash_is_rejected_in_triage() { + let server = unconnected_beacon_server(Config::mainnet(), 0).await; + let mut envelope = payload_hash::seal_envelope(crate::test_support::envelope(1, 3)); + envelope.message.payload.gas_used += 1; + + assert!(matches!( + triage_envelope(&server, &envelope.to_ssz()), + Dispatch::Report(Outcome::Reject(RejectReason::PayloadBlockHashMismatch)) + )); + } + /// A payload attestation for a slot before gloas is rejected by the cheap /// checks; mainnet's gloas epoch is not zero, so slot zero is before it. #[tokio::test] diff --git a/crates/net/p2p/src/metrics.rs b/crates/net/p2p/src/metrics.rs index 643300967..a38546377 100644 --- a/crates/net/p2p/src/metrics.rs +++ b/crates/net/p2p/src/metrics.rs @@ -474,6 +474,24 @@ pub fn inc_beacon_gossip_verdict_expired(kind: &str) { .inc(); } +static LEAN_BEACON_PAYLOAD_BLOCK_HASH_MISMATCH_TOTAL: LazyLock = LazyLock::new( + || { + register_int_counter_vec!( + "lean_beacon_payload_block_hash_mismatch_total", + "Execution payloads refused because their block hash is not the hash of the header rebuilt from their fields, by kind (block, envelope)", + &["kind"] + ) + .unwrap() + }, +); + +/// Count one payload refused for a block hash that is not its header's. +pub fn inc_beacon_payload_block_hash_mismatch(kind: &str) { + LEAN_BEACON_PAYLOAD_BLOCK_HASH_MISMATCH_TOTAL + .with_label_values(&[kind]) + .inc(); +} + pub fn inc_beacon_status_digest_mismatch() { LEAN_BEACON_STATUS_DIGEST_MISMATCH_TOTAL.inc(); } diff --git a/crates/net/p2p/src/req_resp/envelope_client.rs b/crates/net/p2p/src/req_resp/envelope_client.rs index 1714ce3dc..e10f16529 100644 --- a/crates/net/p2p/src/req_resp/envelope_client.rs +++ b/crates/net/p2p/src/req_resp/envelope_client.rs @@ -384,7 +384,13 @@ mod tests { use crate::{BACKOFF_MULTIPLIER, ConnectionDirection, INITIAL_BACKOFF_MS, MAX_FETCH_RETRIES}; fn envelope_for(slot: u64, block_root: H256) -> SignedExecutionPayloadEnvelope { - crate::beacon::encoding::test_support::envelope(block_root, slot, H256::ZERO) + // Sealed: the fetched-envelope rules refuse a block hash that is not + // the payload's header's. + crate::beacon::payload_hash::seal_envelope(crate::beacon::encoding::test_support::envelope( + block_root, + slot, + H256::ZERO, + )) } fn fulu_block_at(slot: u64) -> SignedBeaconBlock { diff --git a/docs/beacon_wire.md b/docs/beacon_wire.md index c2138785b..8d3afd997 100644 --- a/docs/beacon_wire.md +++ b/docs/beacon_wire.md @@ -212,6 +212,14 @@ an unbounded progressive bitlist, so one longer than electra's type bound is REJECTed first, reading its length without expanding it, since expanding is what the seen-set check does before any other. +One rule on `beacon_block` (bellatrix to fulu) and `execution_payload` is +stricter than the specification: the payload's `block_hash` must equal the hash +of the execution header rebuilt from the payload's own fields, or the message is +REJECTed (`beacon/payload_hash.rs`; the reason is `payload_block_hash_mismatch`, +and `lean_beacon_payload_block_hash_mismatch_total{kind}` counts it). It runs +after the cheap rules and before the stateful half. See +[spec_deviations.md](./spec_deviations.md#a-payloads-block-hash-must-be-its-headers). + Three deliberate departures from the gloas gossip rules, each for want of state this node does not keep. Where the specification rejects a message whose block failed validation, this node (having no bad-block cache) cannot tell that from @@ -603,7 +611,8 @@ not imported only briefly and in small numbers, so a batch's envelopes must arrive before the next batch's blocks do. Everything fetched goes through the same rules as an `execution_payload` gossip message (`beacon/envelope_checks.rs`) before the actor sees it; a `Queue` verdict is -forwarded too. +forwarded too. That includes the payload block hash rule above, which the +specification does not have. ### Data column sidecars @@ -806,6 +815,7 @@ as a query filter, so a `quic`-only record is invisible to it. | `lean_beacon_gossip_messages_total{topic,result}` | Gossip received, by topic and by `decoded` / `decode_failed` / `decompress_failed` / `unsupported_fork` | | `lean_beacon_gossip_validation_total{kind,outcome,reason}` | Gossip verdicts, now including `beacon_aggregate_and_proof` and `beacon_attestation`; see [metrics.md](./metrics.md#beacon-gossip-validation) | | `lean_beacon_gossip_verdict_expired_total{kind}` | Verdicts that came too late to propagate anything; should stay at zero | +| `lean_beacon_payload_block_hash_mismatch_total{kind}` | Payloads refused because `block_hash` is not the hash of the header rebuilt from their fields, by `block` / `envelope` | | `lean_beacon_status_digest_mismatch_total` | Handshakes seen from another fork digest | | `lean_beacon_fork_digest{digest}` | The digest computed at startup, as a label | | `lean_beacon_aggregate_decode_seconds` | Time spent decoding one aggregate off the wire | diff --git a/docs/spec_deviations.md b/docs/spec_deviations.md index 191be46cd..2eb21418d 100644 --- a/docs/spec_deviations.md +++ b/docs/spec_deviations.md @@ -428,6 +428,37 @@ that the tests compare like with like. - **Equivalence:** each is the specification's answer wherever the specification has one; they differ only where it would have raised. +## A payload's block hash must be its header's + +`beacon_block` (bellatrix to fulu) and `execution_payload` gossip, and every +envelope fetched by root or range, are REJECTed when the payload's `block_hash` +is not `keccak256(rlp(header))` for the execution block header rebuilt from the +payload's own fields. + +- **The specification:** has no such rule. A hash that does not match is the + execution client's to find, when the chain actor hands it the payload. +- **ethlambda:** rebuilds the header in `ethlambda-p2p` + (`beacon/payload_hash.rs`) and refuses the message before the stateful rules + run. The header takes the payload's fields, the transactions and withdrawals + tries, the parent beacon block root (the block's `parent_root`; the + envelope's own field in gloas), the EIP-7685 requests hash (the Engine API's + request list, `get_execution_requests_list`), and in gloas the keccak of the + block access list bytes (EIP-7928) and the slot number (EIP-7843). It is run + per fork against real chain data: see the vector table in the module's tests. + A bellatrix payload that is the empty default (before the merge) is skipped. +- **Why:** since `engine_newPayloadV2` the Engine API answers a block-hash + mismatch with `INVALID` and a null `latestValidHash`, the same answer as for + a payload that executed badly and whose last valid ancestor is unknown. + Applying payloads to fork choice before the execution client answers is only + safe if the structural case cannot get that far. +- **Cost and counter:** one trie over the transactions per accepted-looking + message, after the cheap rules that drop most of them. + `lean_beacon_payload_block_hash_mismatch_total{kind}` counts refusals and a + `warn!` names the slot and root. +- **Equivalence:** a stricter filter, never a looser one: every payload it + refuses is one the execution client would call `INVALID`. Blocks fetched by + `beacon_blocks_by_range/root` are not checked here. + ## The envelope check reads the cached state root `verify_execution_payload_envelope` compares `envelope.beacon_block_root` with From 10a506e5a3b971d292cd978c9727bca5d5c66de6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Wed, 18 Nov 2026 21:44:10 -0300 Subject: [PATCH 02/18] fix(p2p): skip only the default bellatrix payload The pre-merge skip tested two zero hashes, where the specification's is_execution_enabled asks whether the whole payload is the default ExecutionPayload(). bellatrix::ExecutionPayload now implements Default (the all-zero value BeaconBlockBody::empty already built by hand), and verify_block compares against it. A payload with zero hashes over real fields is now checked, and the pre-merge test uses a default payload. --- .../types/src/beacon/containers/bellatrix.rs | 62 ++++++++++--------- crates/net/p2p/src/beacon/payload_hash.rs | 6 +- .../net/p2p/src/beacon/payload_hash/tests.rs | 24 ++++--- 3 files changed, 55 insertions(+), 37 deletions(-) diff --git a/crates/common/types/src/beacon/containers/bellatrix.rs b/crates/common/types/src/beacon/containers/bellatrix.rs index daafe8ca6..72785bde9 100644 --- a/crates/common/types/src/beacon/containers/bellatrix.rs +++ b/crates/common/types/src/beacon/containers/bellatrix.rs @@ -117,6 +117,34 @@ pub struct ExecutionPayload { pub transactions: Transactions, } +/// The specification's `ExecutionPayload()`: every field zero or empty, which +/// is what a bellatrix block proposed before the merge carries. +/// +/// Written out rather than derived because `logs_bloom` is an [`SszVector`], +/// which libssz gives no `Default` (a vector can never validly be empty), so +/// its all-zero value is built at its exact length. +impl Default for ExecutionPayload { + fn default() -> Self { + Self { + parent_hash: ExecutionBlockHash::ZERO, + fee_recipient: ExecutionAddress::ZERO, + state_root: Bytes32::ZERO, + receipts_root: Bytes32::ZERO, + logs_bloom: LogsBloom::try_from(vec![0u8; preset::BYTES_PER_LOGS_BLOOM]) + .expect("BYTES_PER_LOGS_BLOOM zeros fit LogsBloom's exact length"), + prev_randao: Bytes32::ZERO, + block_number: 0, + gas_limit: 0, + gas_used: 0, + timestamp: 0, + extra_data: Default::default(), + base_fee_per_gas: Uint256::ZERO, + block_hash: ExecutionBlockHash::ZERO, + transactions: Default::default(), + } + } +} + /// An [`ExecutionPayload`] with its transaction list replaced by a merkle /// root, so [`BeaconState::latest_execution_payload_header`] can commit to /// the previous payload without the state growing with every transaction @@ -197,17 +225,11 @@ pub struct BeaconBlockBody { } impl BeaconBlockBody { - /// An empty body: no operations of any kind, and an all-zero execution - /// payload. - /// - /// Not `#[derive(Default)]`, unlike phase0's and altair's bodies (which - /// have no execution payload to build): `execution_payload.logs_bloom` is - /// an [`SszVector`], and unlike a list, a vector can never validly be - /// empty, so libssz gives it no `Default` impl. Its all-zero value is - /// built explicitly at its exact length instead, the same construction - /// `state_transition::beacon::upgrade`'s - /// `empty_bellatrix_execution_payload_header` uses for the header shape - /// of the same payload. + /// An empty body: no operations of any kind, and the all-zero execution + /// payload ([`ExecutionPayload`]'s `Default`, what a pre-merge block + /// carries; `state_transition::beacon::upgrade`'s + /// `empty_bellatrix_execution_payload_header` builds the header shape of + /// the same value). pub fn empty() -> Self { Self { randao_reveal: Default::default(), @@ -219,23 +241,7 @@ impl BeaconBlockBody { deposits: Default::default(), voluntary_exits: Default::default(), sync_aggregate: Default::default(), - execution_payload: ExecutionPayload { - parent_hash: ExecutionBlockHash::ZERO, - fee_recipient: ExecutionAddress::ZERO, - state_root: Bytes32::ZERO, - receipts_root: Bytes32::ZERO, - logs_bloom: LogsBloom::try_from(vec![0u8; preset::BYTES_PER_LOGS_BLOOM]) - .expect("BYTES_PER_LOGS_BLOOM zeros fit LogsBloom's exact length"), - prev_randao: Bytes32::ZERO, - block_number: 0, - gas_limit: 0, - gas_used: 0, - timestamp: 0, - extra_data: Default::default(), - base_fee_per_gas: Uint256::ZERO, - block_hash: ExecutionBlockHash::ZERO, - transactions: Default::default(), - }, + execution_payload: ExecutionPayload::default(), } } } diff --git a/crates/net/p2p/src/beacon/payload_hash.rs b/crates/net/p2p/src/beacon/payload_hash.rs index b0e33b905..a3879e544 100644 --- a/crates/net/p2p/src/beacon/payload_hash.rs +++ b/crates/net/p2p/src/beacon/payload_hash.rs @@ -29,7 +29,7 @@ use ethlambda_state_transition::beacon::gossip::{Outcome, RejectReason}; use ethlambda_state_transition::beacon::stf::{electra, gloas as gloas_stf}; use ethlambda_types::ShortRoot; -use ethlambda_types::beacon::containers::{SignedBeaconBlock, capella, gloas}; +use ethlambda_types::beacon::containers::{SignedBeaconBlock, bellatrix, capella, gloas}; use ethlambda_types::beacon::primitives::Root; use ethrex_common::types::requests::{EncodedRequests, compute_requests_hash}; use ethrex_common::types::{Withdrawal, compute_withdrawals_root}; @@ -177,7 +177,9 @@ pub fn verify_block(block: &SignedBeaconBlock) -> Result<(), HashMismatch> { match block { SignedBeaconBlock::Bellatrix(block) => { let payload = &block.message.body.execution_payload; - if payload.block_hash.0 == [0; 32] && payload.parent_hash.0 == [0; 32] { + // The specification's `is_execution_enabled` asks the same of a + // pre-merge block: its payload is the whole default container. + if *payload == bellatrix::ExecutionPayload::default() { return Ok(()); } Fields { diff --git a/crates/net/p2p/src/beacon/payload_hash/tests.rs b/crates/net/p2p/src/beacon/payload_hash/tests.rs index 500be82c8..1950aacf3 100644 --- a/crates/net/p2p/src/beacon/payload_hash/tests.rs +++ b/crates/net/p2p/src/beacon/payload_hash/tests.rs @@ -34,9 +34,7 @@ fn envelope() -> gloas::SignedExecutionPayloadEnvelope { gloas::SignedExecutionPayloadEnvelope::from_ssz_bytes(GLOAS).expect("a real envelope decodes") } -fn bellatrix_payload( - block: &mut SignedBeaconBlock, -) -> &mut ethlambda_types::beacon::containers::bellatrix::ExecutionPayload { +fn bellatrix_payload(block: &mut SignedBeaconBlock) -> &mut bellatrix::ExecutionPayload { let SignedBeaconBlock::Bellatrix(inner) = block else { panic!("bellatrix"); }; @@ -93,8 +91,8 @@ fn the_vectors_exercise_what_each_fork_adds() { }; // Past the merge: a pre-merge block carries the empty default payload. assert_ne!( - bellatrix.message.body.execution_payload.block_hash.0, - [0; 32] + bellatrix.message.body.execution_payload, + bellatrix::ExecutionPayload::default() ); assert!(!fulu.message.body.execution_payload.transactions.is_empty()); assert!(!envelope().message.payload.transactions.is_empty()); @@ -217,10 +215,22 @@ fn a_changed_gloas_field_is_refused() { fn a_pre_merge_bellatrix_payload_has_nothing_to_check() { // Before the merge a block carries the empty default payload. let mut empty = block(ForkName::Bellatrix, BELLATRIX); - let payload = bellatrix_payload(&mut empty); + *bellatrix_payload(&mut empty) = bellatrix::ExecutionPayload::default(); + assert_eq!(verify_block(&empty), Ok(())); +} + +/// The pre-merge skip is the whole default payload, as the specification's +/// `is_execution_enabled` has it, not two zero hashes. +#[test] +fn a_payload_with_zero_hashes_but_other_fields_is_checked() { + let mut zero_hashes = block(ForkName::Bellatrix, BELLATRIX); + let payload = bellatrix_payload(&mut zero_hashes); payload.block_hash = Default::default(); payload.parent_hash = Default::default(); - assert_eq!(verify_block(&empty), Ok(())); + assert_refused( + verify_block(&zero_hashes), + "zero hashes over a real payload", + ); } #[test] From f24dde2df995a60f262aa4ce4185241699e4219c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Wed, 18 Nov 2026 21:45:07 -0300 Subject: [PATCH 03/18] refactor(p2p): one arm per deneb-shaped block, and name keccak256 The deneb/electra/fulu arm of verify_block matched on the block three times, two of them with unreachable!() arms. Deneb and electra/fulu are now their own arms of the one match, sharing a Fields::deneb helper for the payload container they have in common, so nothing is unreachable. ethrex_crypto_keccak read like a crate name; it is keccak256 now. --- crates/net/p2p/src/beacon/payload_hash.rs | 95 +++++++++++------------ 1 file changed, 44 insertions(+), 51 deletions(-) diff --git a/crates/net/p2p/src/beacon/payload_hash.rs b/crates/net/p2p/src/beacon/payload_hash.rs index a3879e544..440877662 100644 --- a/crates/net/p2p/src/beacon/payload_hash.rs +++ b/crates/net/p2p/src/beacon/payload_hash.rs @@ -29,7 +29,7 @@ use ethlambda_state_transition::beacon::gossip::{Outcome, RejectReason}; use ethlambda_state_transition::beacon::stf::{electra, gloas as gloas_stf}; use ethlambda_types::ShortRoot; -use ethlambda_types::beacon::containers::{SignedBeaconBlock, bellatrix, capella, gloas}; +use ethlambda_types::beacon::containers::{SignedBeaconBlock, bellatrix, capella, deneb, gloas}; use ethlambda_types::beacon::primitives::Root; use ethrex_common::types::requests::{EncodedRequests, compute_requests_hash}; use ethrex_common::types::{Withdrawal, compute_withdrawals_root}; @@ -83,7 +83,37 @@ struct Fields<'a> { amsterdam: Option<(&'a [u8], u64)>, } -impl Fields<'_> { +impl<'a> Fields<'a> { + /// The header fields of deneb's payload container, which electra and fulu + /// reuse with the requests list as their only addition. + fn deneb( + payload: &'a deneb::ExecutionPayload, + parent_root: Root, + requests: Option>>, + ) -> Self { + Fields { + parent_hash: payload.parent_hash.0, + fee_recipient: payload.fee_recipient.0, + state_root: payload.state_root.0, + receipts_root: payload.receipts_root.0, + logs_bloom: payload.logs_bloom.as_ref(), + prev_randao: payload.prev_randao.0, + block_number: payload.block_number, + gas_limit: payload.gas_limit, + gas_used: payload.gas_used, + timestamp: payload.timestamp, + extra_data: payload.extra_data.as_ref(), + base_fee_per_gas: payload.base_fee_per_gas.0, + claimed_hash: payload.block_hash.0, + transactions: payload.transactions.iter().map(|tx| &tx[..]).collect(), + withdrawals: Some(payload.withdrawals.as_ref()), + blob_gas: Some((payload.blob_gas_used, payload.excess_blob_gas)), + parent_beacon_block_root: Some(parent_root.0), + requests, + amsterdam: None, + } + } + /// `keccak256(rlp(header))`. fn computed_hash(&self) -> [u8; 32] { // The trie roots are over opaque bytes: a transaction is already @@ -115,9 +145,7 @@ impl Fields<'_> { }); // EIP-7928: the header commits to the keccak of the RLP bytes the // payload carries, whatever they decode to. - let block_access_list_hash = self - .amsterdam - .map(|(bal, _)| H256(ethrex_crypto_keccak(bal))); + let block_access_list_hash = self.amsterdam.map(|(bal, _)| H256(keccak256(bal))); let slot_number = self.amsterdam.map(|(_, slot)| slot); let base_fee_per_gas = U256::from_little_endian(&self.base_fee_per_gas); @@ -147,7 +175,7 @@ impl Fields<'_> { .encode_optional_field(&block_access_list_hash) .encode_optional_field(&slot_number) .finish(); - ethrex_crypto_keccak(&buf) + keccak256(&buf) } fn verify(&self) -> Result<(), HashMismatch> { @@ -163,7 +191,7 @@ impl Fields<'_> { } } -fn ethrex_crypto_keccak(data: &[u8]) -> [u8; 32] { +fn keccak256(data: &[u8]) -> [u8; 32] { ethrex_common::utils::keccak(data).0 } @@ -230,50 +258,15 @@ pub fn verify_block(block: &SignedBeaconBlock) -> Result<(), HashMismatch> { } .verify() } - // Deneb, and electra and fulu on top of it: one payload container, - // with the requests list the only addition. - SignedBeaconBlock::Deneb(_) - | SignedBeaconBlock::Electra(_) - | SignedBeaconBlock::Fulu(_) => { - let parent_root = match block { - SignedBeaconBlock::Deneb(block) => block.message.parent_root.0, - SignedBeaconBlock::Electra(block) | SignedBeaconBlock::Fulu(block) => { - block.message.parent_root.0 - } - _ => unreachable!("narrowed by the outer match"), - }; - let (payload, requests) = match block { - SignedBeaconBlock::Deneb(block) => (&block.message.body.execution_payload, None), - SignedBeaconBlock::Electra(block) | SignedBeaconBlock::Fulu(block) => ( - &block.message.body.execution_payload, - Some(electra::get_execution_requests_list( - &block.message.body.execution_requests, - )), - ), - _ => unreachable!("narrowed by the outer match"), - }; - Fields { - parent_hash: payload.parent_hash.0, - fee_recipient: payload.fee_recipient.0, - state_root: payload.state_root.0, - receipts_root: payload.receipts_root.0, - logs_bloom: payload.logs_bloom.as_ref(), - prev_randao: payload.prev_randao.0, - block_number: payload.block_number, - gas_limit: payload.gas_limit, - gas_used: payload.gas_used, - timestamp: payload.timestamp, - extra_data: payload.extra_data.as_ref(), - base_fee_per_gas: payload.base_fee_per_gas.0, - claimed_hash: payload.block_hash.0, - transactions: payload.transactions.iter().map(|tx| &tx[..]).collect(), - withdrawals: Some(payload.withdrawals.as_ref()), - blob_gas: Some((payload.blob_gas_used, payload.excess_blob_gas)), - parent_beacon_block_root: Some(parent_root), - requests, - amsterdam: None, - } - .verify() + SignedBeaconBlock::Deneb(block) => { + let message = &block.message; + Fields::deneb(&message.body.execution_payload, message.parent_root, None).verify() + } + SignedBeaconBlock::Electra(block) | SignedBeaconBlock::Fulu(block) => { + let message = &block.message; + let requests = electra::get_execution_requests_list(&message.body.execution_requests); + let payload = &message.body.execution_payload; + Fields::deneb(payload, message.parent_root, Some(requests)).verify() } SignedBeaconBlock::Phase0(_) | SignedBeaconBlock::Altair(_) From 5211db69d20e995b0fd66f4af78be6d3b5454721 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Wed, 18 Nov 2026 21:49:50 -0300 Subject: [PATCH 04/18] fix(p2p): check a payload's block hash after its signature, and IGNORE it The rule ran in triage on the P2P actor, before the signature check and outside guarded(), and answered REJECT. Any peer could make the actor build a transaction trie for an unsigned message, and since other clients have no such rule and relay a validly signed block whatever its block_hash, a REJECT scored every honest peer that forwarded one. It now runs at the end of the stateful half, on the blocking thread inside guarded(), and only on a message the topic's rules accepted, so the proposer's (or builder's) signature has verified. A pre-gloas block whose hash does not match is IGNOREd (new IgnoreReason PayloadBlockHashMismatch, replacing the RejectReason): not imported, not relayed, nobody scored. A Queue or Overloaded block is not hashed. Gloas envelopes, from gossip and from fetches, are hashed the same way once accepted but only counted and logged, never refused: the Amsterdam header may still change between devnets, and a wrong encoding would otherwise refuse every payload and stop the node following the chain. The test helpers that sealed envelopes for the old rule are gone again. --- .../state_transition/src/beacon/gossip/mod.rs | 13 +- crates/net/p2p/src/beacon/envelope_checks.rs | 17 +-- crates/net/p2p/src/beacon/payload_hash.rs | 127 +++++++++++------- .../net/p2p/src/beacon/payload_hash/tests.rs | 57 +++++++- crates/net/p2p/src/beacon/verdict.rs | 13 +- crates/net/p2p/src/gossipsub/handler.rs | 27 ++-- crates/net/p2p/src/metrics.rs | 4 +- .../net/p2p/src/req_resp/envelope_client.rs | 8 +- 8 files changed, 170 insertions(+), 96 deletions(-) diff --git a/crates/blockchain/state_transition/src/beacon/gossip/mod.rs b/crates/blockchain/state_transition/src/beacon/gossip/mod.rs index 44a2f037b..1eeed8e62 100644 --- a/crates/blockchain/state_transition/src/beacon/gossip/mod.rs +++ b/crates/blockchain/state_transition/src/beacon/gossip/mod.rs @@ -196,6 +196,13 @@ pub enum IgnoreReason { AlreadyExiting, /// The head state's sync committees cannot answer for the message's period. SyncCommitteeUnavailable, + /// A signed block's execution payload `block_hash` is not the hash of the + /// execution block header rebuilt from the payload's own fields. A rule + /// the specification does not have, run in p2p once the proposer's + /// signature has verified: see `docs/spec_deviations.md`. IGNORE rather + /// than REJECT because other clients forward such a block, and a REJECT + /// would score every honest peer that relayed it. + PayloadBlockHashMismatch, } impl IgnoreReason { @@ -238,6 +245,7 @@ impl IgnoreReason { Self::BeforeFork => "before_fork", Self::AlreadyExiting => "already_exiting", Self::SyncCommitteeUnavailable => "sync_committee_unavailable", + Self::PayloadBlockHashMismatch => "payload_block_hash_mismatch", } } } @@ -321,10 +329,6 @@ pub enum RejectReason { BuilderIndexMismatch, /// A gloas envelope's payload block hash is not its bid's. BlockHashMismatch, - /// An execution payload's `block_hash` is not the hash of the execution - /// block header rebuilt from the payload's own fields. A check stricter - /// than the specification's, run in p2p: see `docs/spec_deviations.md`. - PayloadBlockHashMismatch, /// The root of a gloas envelope's execution requests is not its bid's. ExecutionRequestsRootMismatch, /// A gloas envelope's payload carries more withdrawals than its limit. @@ -388,7 +392,6 @@ impl RejectReason { Self::PayloadInvalid => "payload_invalid", Self::BuilderIndexMismatch => "builder_index_mismatch", Self::BlockHashMismatch => "block_hash_mismatch", - Self::PayloadBlockHashMismatch => "payload_block_hash_mismatch", Self::ExecutionRequestsRootMismatch => "execution_requests_root_mismatch", Self::TooManyWithdrawals => "too_many_withdrawals", Self::PreGloasSlot => "pre_gloas_slot", diff --git a/crates/net/p2p/src/beacon/envelope_checks.rs b/crates/net/p2p/src/beacon/envelope_checks.rs index 0690e378b..689b5913f 100644 --- a/crates/net/p2p/src/beacon/envelope_checks.rs +++ b/crates/net/p2p/src/beacon/envelope_checks.rs @@ -52,11 +52,10 @@ fn judge(store: &Store, envelope: &SignedExecutionPayloadEnvelope) -> Outcome { if let Err(outcome) = cheap_checks(&seen, store, envelope) { return outcome; } - // The same stricter-than-the-specification rule the gossip topic runs. - if let Err(outcome) = payload_hash::reject_envelope_on_mismatch(envelope) { - return outcome; - } - stateful_checks(store, envelope) + // The payload block hash rule the gossip topic runs too, after the + // builder's signature verified. Counted, never refused, for gloas. + let outcome = stateful_checks(store, envelope); + payload_hash::envelope_verdict(outcome, envelope) } /// Run the gossip rules on `envelopes` and send the chain actor the ones that @@ -240,13 +239,7 @@ pub(crate) mod tests { } pub(crate) fn envelope(slot: u64, byte: u8) -> SignedExecutionPayloadEnvelope { - // Sealed: the fetched-envelope rules refuse a block hash that is not - // the payload's header's. - payload_hash::seal_envelope(crate::beacon::encoding::test_support::envelope( - H256::repeat_byte(byte), - slot, - H256::ZERO, - )) + crate::beacon::encoding::test_support::envelope(H256::repeat_byte(byte), slot, H256::ZERO) } #[test] diff --git a/crates/net/p2p/src/beacon/payload_hash.rs b/crates/net/p2p/src/beacon/payload_hash.rs index 440877662..7d8b0b261 100644 --- a/crates/net/p2p/src/beacon/payload_hash.rs +++ b/crates/net/p2p/src/beacon/payload_hash.rs @@ -4,12 +4,31 @@ //! A payload carries its `block_hash` next to the fields that hash is taken //! over, so a node can recompute it without an execution client: the header is //! the payload's fields plus the transactions, withdrawals and requests tries, -//! RLP-encoded and keccak-hashed. The Engine API answers a mismatch with -//! `INVALID` and a null `latestValidHash` (execution-apis `shanghai.md`), which -//! is indistinguishable from a payload that executed badly and whose last valid -//! ancestor is unknown. Catching the structural case here keeps such a payload -//! from ever reaching fork choice. It is a rule stricter than the consensus -//! specification's gossip rules; see `docs/spec_deviations.md`. +//! RLP-encoded and keccak-hashed. +//! +//! The consensus specification has no such gossip rule, and the Engine API +//! already requires the execution client to validate `blockHash` on every +//! `engine_newPayload`, even while syncing (execution-apis `paris.md`). While +//! an import waits for that answer, this finds nothing the execution client +//! would not. What it buys is a gossip block refused before it is imported: +//! once a pre-gloas payload is applied to fork choice before the execution +//! client answers (lambdaclass/ethlambda#773), a block caught here is one that +//! never has to be reverted. See `docs/spec_deviations.md`. +//! +//! Where it runs, and what it answers: +//! +//! - A pre-gloas `beacon_block` from gossip, once its stateful checks answered +//! `Accept` ([`block_verdict`]). That is the one outcome that says the +//! proposer's signature verified, so no unsigned message makes this node +//! build a transaction trie. A mismatch is `IGNORE`, not `REJECT`: other +//! clients have no such rule and forward the block, and a `REJECT` would +//! score every honest peer that relayed it. +//! - A gloas envelope, from gossip or fetched, once its checks answered +//! `Accept` ([`envelope_verdict`]): counted and logged, never refused, until +//! the Amsterdam header is final. +//! - Nothing else. A block fetched by range or root, and a gossip block +//! forwarded under `Queue` or `Ignore(Overloaded)`, reach the chain actor +//! unhashed; the execution client still checks them. //! //! The header's shape per fork: //! @@ -26,7 +45,7 @@ //! The header is encoded here rather than through ethrex's `BlockHeader`, //! which holds `base_fee_per_gas` as a `u64` where the payload has 256 bits. -use ethlambda_state_transition::beacon::gossip::{Outcome, RejectReason}; +use ethlambda_state_transition::beacon::gossip::{IgnoreReason, Outcome}; use ethlambda_state_transition::beacon::stf::{electra, gloas as gloas_stf}; use ethlambda_types::ShortRoot; use ethlambda_types::beacon::containers::{SignedBeaconBlock, bellatrix, capella, deneb, gloas}; @@ -307,53 +326,67 @@ pub fn verify_envelope( .verify() } -/// `envelope` with its payload's `block_hash` set to the header's, for tests -/// that build a structurally valid envelope out of arbitrary fields. -#[cfg(test)] -pub(crate) fn seal_envelope( - mut envelope: gloas::SignedExecutionPayloadEnvelope, -) -> gloas::SignedExecutionPayloadEnvelope { - if let Err(mismatch) = verify_envelope(&envelope) { - envelope.message.payload.block_hash = mismatch.computed.into(); - } - envelope -} - -/// [`verify_block`] as a gossip verdict: `Err(Reject)` on a mismatch, counted -/// and logged. -pub(crate) fn reject_block_on_mismatch( +/// A gossip block's verdict, given the `outcome` its stateful checks answered. +/// +/// Only an `Accept` is hashed: it is the one outcome that says the proposer's +/// signature verified, so only a proposer can make this node build the trie +/// or reach the `warn!`. A mismatch turns it into +/// `Ignore(PayloadBlockHashMismatch)`, which keeps the block from being +/// imported or relayed without scoring the peers that relayed it. Any other +/// outcome passes through unhashed. +pub(crate) fn block_verdict( + outcome: Outcome, block: &SignedBeaconBlock, block_root: Root, -) -> Result<(), Outcome> { - verify_block(block).map_err(|mismatch| refuse("block", block.slot(), block_root, mismatch)) -} - -/// [`verify_envelope`] as a verdict, shared by the gossip topic and the -/// fetched-envelope checks. -pub(crate) fn reject_envelope_on_mismatch( - envelope: &gloas::SignedExecutionPayloadEnvelope, -) -> Result<(), Outcome> { - verify_envelope(envelope).map_err(|mismatch| { - refuse( - "envelope", - envelope.message.payload.slot_number, - envelope.message.beacon_block_root, - mismatch, - ) - }) -} - -fn refuse(kind: &str, slot: u64, root: Root, mismatch: HashMismatch) -> Outcome { - metrics::inc_beacon_payload_block_hash_mismatch(kind); +) -> Outcome { + if outcome != Outcome::Accept { + return outcome; + } + let Err(mismatch) = verify_block(block) else { + return outcome; + }; + metrics::inc_beacon_payload_block_hash_mismatch("block"); + let slot = block.slot(); warn!( - kind, slot, - root = %ShortRoot(&root.0), + block_root = %ShortRoot(&block_root.0), claimed = %ShortRoot(&mismatch.claimed), computed = %ShortRoot(&mismatch.computed), - "Refusing an execution payload whose block hash is not its header's" + "Ignoring a gossip block whose payload block hash is not its header's" ); - Outcome::Reject(RejectReason::PayloadBlockHashMismatch) + Outcome::Ignore(IgnoreReason::PayloadBlockHashMismatch) +} + +/// A gloas envelope's verdict, given the `outcome` its checks answered: always +/// `outcome`, with an `Accept` whose payload hash is not its header's counted +/// and logged. +/// +/// Not refused, unlike a pre-gloas block. The Amsterdam header (EIP-7928's +/// block access list hash, EIP-7843's slot number) is still moving between +/// devnets, and an envelope is judged here on gossip and on fetch alike, so a +/// header this build encodes wrongly would refuse every payload and leave the +/// node unable to follow the chain; a pre-gloas block refused on gossip still +/// comes back by root. The counter says whether the encoding agrees with the +/// chain until the header is final and this can refuse. +pub(crate) fn envelope_verdict( + outcome: Outcome, + envelope: &gloas::SignedExecutionPayloadEnvelope, +) -> Outcome { + if outcome != Outcome::Accept { + return outcome; + } + let _ = verify_envelope(envelope).inspect_err(|mismatch| { + metrics::inc_beacon_payload_block_hash_mismatch("envelope"); + let slot = envelope.message.payload.slot_number; + warn!( + slot, + block_root = %ShortRoot(&envelope.message.beacon_block_root.0), + claimed = %ShortRoot(&mismatch.claimed), + computed = %ShortRoot(&mismatch.computed), + "An envelope's payload block hash is not its header's; not refused before the Amsterdam header is final" + ); + }); + outcome } #[cfg(test)] diff --git a/crates/net/p2p/src/beacon/payload_hash/tests.rs b/crates/net/p2p/src/beacon/payload_hash/tests.rs index 1950aacf3..5ff8297c6 100644 --- a/crates/net/p2p/src/beacon/payload_hash/tests.rs +++ b/crates/net/p2p/src/beacon/payload_hash/tests.rs @@ -11,6 +11,7 @@ //! | fulu | mainnet | block, slot 15576000 | //! | gloas | Plataberget | envelope, slot 593101 | +use ethlambda_state_transition::beacon::gossip::{QueueReason, RejectReason}; use ethlambda_types::beacon::containers::electra; use ethlambda_types::beacon::fork::ForkName; use libssz::SszDecode as _; @@ -41,6 +42,24 @@ fn bellatrix_payload(block: &mut SignedBeaconBlock) -> &mut bellatrix::Execution &mut inner.message.body.execution_payload } +fn fulu_block(block: &mut SignedBeaconBlock) -> &mut electra::SignedBeaconBlock { + let SignedBeaconBlock::Fulu(inner) = block else { + panic!("fulu"); + }; + inner +} + +/// The real fulu block with one header field changed. +fn changed_fulu_block() -> SignedBeaconBlock { + let mut changed = block(ForkName::Fulu, FULU); + fulu_block(&mut changed) + .message + .body + .execution_payload + .gas_used += 1; + changed +} + /// An all-zero request: only its presence matters to the requests hash. fn consolidation() -> electra::ConsolidationRequest { electra::ConsolidationRequest::from_ssz_bytes(&[0; 116]).expect("a fixed-size container") @@ -234,10 +253,40 @@ fn a_payload_with_zero_hashes_but_other_fields_is_checked() { } #[test] -fn a_mismatch_is_a_reject_with_its_own_reason() { +fn a_block_mismatch_is_ignored_once_its_checks_accept() { + let changed = changed_fulu_block(); + let root = Root::ZERO; + let outcome = block_verdict(Outcome::Accept, &changed, root); + // IGNORE, never REJECT: other clients relay such a block. + assert_eq!(outcome.labels(), ("ignore", "payload_block_hash_mismatch")); + assert_eq!( + block_verdict(Outcome::Accept, &block(ForkName::Fulu, FULU), root), + Outcome::Accept + ); +} + +/// Anything but `Accept` passes through unhashed: a queued block may not have +/// had its signature checked yet, and a rejected one is refused already. +#[test] +fn a_block_that_was_not_accepted_keeps_its_verdict() { + let changed = changed_fulu_block(); + for outcome in [ + Outcome::Queue(QueueReason::ParentUnknown), + Outcome::Ignore(IgnoreReason::Overloaded), + Outcome::Reject(RejectReason::BadSignature), + ] { + assert_eq!(block_verdict(outcome, &changed, Root::ZERO), outcome); + } +} + +/// Gloas only counts a mismatch until the Amsterdam header is final: an +/// encoding this build gets wrong must not refuse every payload. +#[test] +fn a_gloas_mismatch_is_counted_but_not_refused() { let mut changed = envelope(); changed.message.payload.gas_used += 1; - let outcome = reject_envelope_on_mismatch(&changed).expect_err("a changed envelope"); - assert_eq!(outcome.labels(), ("reject", "payload_block_hash_mismatch")); - assert!(reject_envelope_on_mismatch(&envelope()).is_ok()); + assert!(verify_envelope(&changed).is_err()); + assert_eq!(envelope_verdict(Outcome::Accept, &changed), Outcome::Accept); + let queued = Outcome::Queue(QueueReason::StateNotCached); + assert_eq!(envelope_verdict(queued, &changed), queued); } diff --git a/crates/net/p2p/src/beacon/verdict.rs b/crates/net/p2p/src/beacon/verdict.rs index ab5651c26..8a9091eee 100644 --- a/crates/net/p2p/src/beacon/verdict.rs +++ b/crates/net/p2p/src/beacon/verdict.rs @@ -40,7 +40,7 @@ use spawned_concurrency::message::Message; use spawned_concurrency::tasks::{Context, Handler}; use tracing::{debug, error, warn}; -use crate::beacon::{builder_market, column_checks}; +use crate::beacon::{builder_market, column_checks, payload_hash}; use crate::gossipsub::operation_kind; use crate::{P2PServer, metrics}; @@ -121,8 +121,12 @@ impl Validated { /// them. fn stateful_checks(&mut self, store: &Store) -> Outcome { match self { + // The payload block hash rule (`payload_hash`), stricter than the + // specification, runs only once the topic's own rules accept, + // that is once the proposer's or builder's signature verified. Self::Block { block, block_root } => { - gossip::block::stateful_checks(store, block, *block_root) + let outcome = gossip::block::stateful_checks(store, block, *block_root); + payload_hash::block_verdict(outcome, block, *block_root) } Self::Column(sidecar) => match &**sidecar { DataColumnSidecar::Fulu(sidecar) => gossip::column::stateful_checks(store, sidecar), @@ -144,7 +148,10 @@ impl Validated { attestation, subnet_id, } => gossip::attestation::stateful_checks(store, attestation, *subnet_id), - Self::Envelope(envelope) => gossip::envelope::stateful_checks(store, envelope), + Self::Envelope(envelope) => { + let outcome = gossip::envelope::stateful_checks(store, envelope); + payload_hash::envelope_verdict(outcome, envelope) + } Self::ExecutionPayloadBid { bid, market } => { gossip::execution_payload_bid::stateful_checks(store, market, bid) } diff --git a/crates/net/p2p/src/gossipsub/handler.rs b/crates/net/p2p/src/gossipsub/handler.rs index bc06df996..3e13f7e5b 100644 --- a/crates/net/p2p/src/gossipsub/handler.rs +++ b/crates/net/p2p/src/gossipsub/handler.rs @@ -36,7 +36,6 @@ use super::{ }; use crate::beacon::constants::ATTESTATION_SUBNET_COUNT; use crate::beacon::decode::BeaconGossip; -use crate::beacon::payload_hash; use crate::beacon::verdict::{self, Dispatch, GossipId, Validated}; use crate::beacon::{BeaconWire, decode as beacon_decode, topics as beacon_topics}; use crate::{P2PServer, metrics}; @@ -324,11 +323,6 @@ fn triage_block(server: &P2PServer, wire: &BeaconWire, payload: &[u8]) -> Dispat { return Dispatch::Report(outcome); } - // Stricter than the specification: see `beacon::payload_hash`. After the - // rules that drop most messages, since it hashes every transaction. - if let Err(outcome) = payload_hash::reject_block_on_mismatch(&block, block_root) { - return Dispatch::Report(outcome); - } Dispatch::Validate(Validated::Block { block: Box::new(block), block_root, @@ -535,9 +529,6 @@ fn triage_envelope(server: &P2PServer, payload: &[u8]) -> Dispatch { { return Dispatch::Report(outcome); } - if let Err(outcome) = payload_hash::reject_envelope_on_mismatch(&envelope) { - return Dispatch::Report(outcome); - } Dispatch::Validate(Validated::Envelope(Box::new(envelope))) } @@ -1771,7 +1762,7 @@ mod tests { #[tokio::test] async fn an_envelope_passes_triage_unless_its_key_was_seen() { let mut server = unconnected_beacon_server(Config::mainnet(), 0).await; - let envelope = payload_hash::seal_envelope(crate::test_support::envelope(1, 3)); + let envelope = crate::test_support::envelope(1, 3); let payload = envelope.to_ssz(); assert!(matches!( @@ -1789,17 +1780,21 @@ mod tests { )); } - /// An envelope whose block hash is not its payload header's is rejected - /// in triage, before any state is read, and counted. + /// Triage never hashes a payload: an envelope whose block hash is not its + /// header's still goes on to the stateful checks, where the payload hash + /// is looked at only after the builder's signature verified. #[tokio::test] - async fn an_envelope_with_a_wrong_block_hash_is_rejected_in_triage() { + async fn a_wrong_payload_block_hash_is_not_judged_in_triage() { let server = unconnected_beacon_server(Config::mainnet(), 0).await; - let mut envelope = payload_hash::seal_envelope(crate::test_support::envelope(1, 3)); - envelope.message.payload.gas_used += 1; + let envelope = crate::test_support::envelope(1, 3); + assert!( + crate::beacon::payload_hash::verify_envelope(&envelope).is_err(), + "the test envelope's block hash is arbitrary" + ); assert!(matches!( triage_envelope(&server, &envelope.to_ssz()), - Dispatch::Report(Outcome::Reject(RejectReason::PayloadBlockHashMismatch)) + Dispatch::Validate(Validated::Envelope(_)) )); } diff --git a/crates/net/p2p/src/metrics.rs b/crates/net/p2p/src/metrics.rs index e79936134..ea11681be 100644 --- a/crates/net/p2p/src/metrics.rs +++ b/crates/net/p2p/src/metrics.rs @@ -478,14 +478,14 @@ static LEAN_BEACON_PAYLOAD_BLOCK_HASH_MISMATCH_TOTAL: LazyLock = || { register_int_counter_vec!( "lean_beacon_payload_block_hash_mismatch_total", - "Execution payloads refused because their block hash is not the hash of the header rebuilt from their fields, by kind (block, envelope)", + "Signed execution payloads whose block hash is not the hash of the header rebuilt from their fields, by kind (block: a gossip block, IGNOREd; envelope: counted, not refused)", &["kind"] ) .unwrap() }, ); -/// Count one payload refused for a block hash that is not its header's. +/// Count one signed payload whose block hash is not its header's. pub fn inc_beacon_payload_block_hash_mismatch(kind: &str) { LEAN_BEACON_PAYLOAD_BLOCK_HASH_MISMATCH_TOTAL .with_label_values(&[kind]) diff --git a/crates/net/p2p/src/req_resp/envelope_client.rs b/crates/net/p2p/src/req_resp/envelope_client.rs index e10f16529..1714ce3dc 100644 --- a/crates/net/p2p/src/req_resp/envelope_client.rs +++ b/crates/net/p2p/src/req_resp/envelope_client.rs @@ -384,13 +384,7 @@ mod tests { use crate::{BACKOFF_MULTIPLIER, ConnectionDirection, INITIAL_BACKOFF_MS, MAX_FETCH_RETRIES}; fn envelope_for(slot: u64, block_root: H256) -> SignedExecutionPayloadEnvelope { - // Sealed: the fetched-envelope rules refuse a block hash that is not - // the payload's header's. - crate::beacon::payload_hash::seal_envelope(crate::beacon::encoding::test_support::envelope( - block_root, - slot, - H256::ZERO, - )) + crate::beacon::encoding::test_support::envelope(block_root, slot, H256::ZERO) } fn fulu_block_at(slot: u64) -> SignedBeaconBlock { From e6abca5cebf5ffe16f759d1bbc94e8fc0df0caee Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Wed, 18 Nov 2026 22:05:33 -0300 Subject: [PATCH 05/18] test(p2p): pin two-byte transaction keys and real requests on mainnet No real-chain vector reached a transactions trie key of two bytes (index 128 and up) or carried any execution request: the electra and fulu blocks had empty requests and the largest had 116 transactions. The fulu vector is now mainnet slot 15684701 (finalized, canonical; the same SSZ bytes from an ethlambda node's Beacon API and from lodestar-mainnet.chainsafe.io): 238 transactions, one withdrawal request and two consolidation requests, and its hash matches. the_vectors_exercise_what_each_fork_adds asserts more than 128 transactions, rlp(128) being 0x81 0x80, and requests of two types; a changed field inside one of its consolidation requests must be refused. The "one more request" mutation pushes a withdrawal request now, since the consolidation list (two at most) is already full in this block. The old fulu vector (slot 15576000, 116 transactions, no requests) covered nothing this one does not, so it is dropped. --- .../net/p2p/src/beacon/payload_hash/tests.rs | 77 ++++++++++++++---- .../mainnet_fulu_slot_15576000.ssz | Bin 71490 -> 0 bytes .../mainnet_fulu_slot_15684701.ssz | Bin 0 -> 114069 bytes 3 files changed, 60 insertions(+), 17 deletions(-) delete mode 100644 crates/net/p2p/src/beacon/testdata/payload_hash/mainnet_fulu_slot_15576000.ssz create mode 100644 crates/net/p2p/src/beacon/testdata/payload_hash/mainnet_fulu_slot_15684701.ssz diff --git a/crates/net/p2p/src/beacon/payload_hash/tests.rs b/crates/net/p2p/src/beacon/payload_hash/tests.rs index 5ff8297c6..fb336a2cf 100644 --- a/crates/net/p2p/src/beacon/payload_hash/tests.rs +++ b/crates/net/p2p/src/beacon/payload_hash/tests.rs @@ -2,14 +2,19 @@ //! The vectors are SSZ as the Beacon API served it //! (`beacon/testdata/payload_hash/`): //! -//! | fork | chain | object | -//! |-----------|-------------|----------------------| -//! | bellatrix | Sepolia | block, slot 500000 | -//! | capella | Sepolia | block, slot 1900000 | -//! | deneb | Hoodi | block, slot 2003 | -//! | electra | Hoodi | block, slot 70001 | -//! | fulu | mainnet | block, slot 15576000 | -//! | gloas | Plataberget | envelope, slot 593101 | +//! | fork | chain | object | carries | +//! |-----------|-------------|-----------------------|----------------------------------------| +//! | bellatrix | Sepolia | block, slot 500000 | | +//! | capella | Sepolia | block, slot 1900000 | withdrawals | +//! | deneb | Hoodi | block, slot 2003 | | +//! | electra | Hoodi | block, slot 70001 | | +//! | fulu | mainnet | block, slot 15684701 | 238 transactions, 3 requests (2 types) | +//! | gloas | Plataberget | envelope, slot 593101 | | +//! +//! The fulu block is finalized and canonical; its bytes are the same from +//! ethlambda's and Lodestar's Beacon API. It carries one withdrawal request +//! and two consolidation requests, so its requests hash is over two request +//! types. use ethlambda_state_transition::beacon::gossip::{QueueReason, RejectReason}; use ethlambda_types::beacon::containers::electra; @@ -23,7 +28,7 @@ const BELLATRIX: &[u8] = const CAPELLA: &[u8] = include_bytes!("../testdata/payload_hash/sepolia_capella_slot_1900000.ssz"); const DENEB: &[u8] = include_bytes!("../testdata/payload_hash/hoodi_deneb_slot_2003.ssz"); const ELECTRA: &[u8] = include_bytes!("../testdata/payload_hash/hoodi_electra_slot_70001.ssz"); -const FULU: &[u8] = include_bytes!("../testdata/payload_hash/mainnet_fulu_slot_15576000.ssz"); +const FULU: &[u8] = include_bytes!("../testdata/payload_hash/mainnet_fulu_slot_15684701.ssz"); const GLOAS: &[u8] = include_bytes!("../testdata/payload_hash/plataberget_gloas_envelope_slot_593101.ssz"); @@ -65,6 +70,12 @@ fn consolidation() -> electra::ConsolidationRequest { electra::ConsolidationRequest::from_ssz_bytes(&[0; 116]).expect("a fixed-size container") } +/// An all-zero withdrawal request, for blocks whose consolidation list (two +/// at most) may already be full. +fn withdrawal_request() -> electra::WithdrawalRequest { + electra::WithdrawalRequest::from_ssz_bytes(&[0; 76]).expect("a fixed-size container") +} + fn withdrawal() -> capella::Withdrawal { capella::Withdrawal::from_ssz_bytes(&[0; 44]).expect("a fixed-size container") } @@ -102,9 +113,6 @@ fn the_vectors_exercise_what_each_fork_adds() { .is_empty(), "capella's vector must carry withdrawals" ); - let SignedBeaconBlock::Fulu(fulu) = block(ForkName::Fulu, FULU) else { - panic!("fulu"); - }; let SignedBeaconBlock::Bellatrix(bellatrix) = block(ForkName::Bellatrix, BELLATRIX) else { panic!("bellatrix"); }; @@ -113,7 +121,27 @@ fn the_vectors_exercise_what_each_fork_adds() { bellatrix.message.body.execution_payload, bellatrix::ExecutionPayload::default() ); - assert!(!fulu.message.body.execution_payload.transactions.is_empty()); + + let mut fulu = block(ForkName::Fulu, FULU); + let fulu = &fulu_block(&mut fulu).message.body; + // The transactions trie keys a transaction by `rlp(index)`: one byte up to + // index 127, two from index 128 (`0x81 0x80`), so the vector needs more + // than 128 transactions to reach a two-byte key. + assert_eq!(128usize.encode_to_vec(), [0x81, 0x80]); + assert!( + fulu.execution_payload.transactions.len() > 128, + "fulu's vector must reach a two-byte transaction key" + ); + // Real requests of more than one type, so the requests hash is over + // several typed entries and not only the empty list's. + let requests = ethlambda_state_transition::beacon::stf::electra::get_execution_requests_list( + &fulu.execution_requests, + ); + assert!( + requests.len() >= 2, + "fulu's vector must carry requests of two types" + ); + assert!(!envelope().message.payload.transactions.is_empty()); } @@ -159,7 +187,13 @@ fn a_changed_deneb_field_is_refused() { #[test] fn a_changed_electra_or_fulu_field_is_refused() { for (fork, bytes) in [(ForkName::Electra, ELECTRA), (ForkName::Fulu, FULU)] { - for what in ["transaction", "parent_root", "request", "extra_data"] { + for what in [ + "transaction", + "parent_root", + "request", + "existing_request", + "extra_data", + ] { let mut changed = block(fork, bytes); let (SignedBeaconBlock::Electra(inner) | SignedBeaconBlock::Fulu(inner)) = &mut changed else { @@ -175,14 +209,23 @@ fn a_changed_electra_or_fulu_field_is_refused() { } "parent_root" => inner.message.parent_root.0[0] ^= 1, // The requests hash covers a request however empty its - // payload: one more consolidation moves it. + // payload: one more withdrawal request moves it. "request" => inner .message .body .execution_requests - .consolidations - .push(consolidation()) + .withdrawals + .push(withdrawal_request()) .expect("room for one more request"), + // A changed field inside a request the block already + // carries; only the fulu vector has one. + "existing_request" => { + let requests = &mut inner.message.body.execution_requests; + if requests.consolidations.is_empty() { + continue; + } + requests.consolidations[0].source_address.0[0] ^= 1; + } _ => inner .message .body diff --git a/crates/net/p2p/src/beacon/testdata/payload_hash/mainnet_fulu_slot_15576000.ssz b/crates/net/p2p/src/beacon/testdata/payload_hash/mainnet_fulu_slot_15576000.ssz deleted file mode 100644 index 3f2355c3d4cf286ec6c1d44a794f7037fe25839d..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 71490 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

VbK-y%$gSJB)@A&A<{!=3riPToJc?pjst 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 O2v&Z?(fEJs^Zx+aVohZL literal 0 HcmV?d00001 From 926a6cdada793468ae9af692ce510b35e1108ee9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Wed, 18 Nov 2026 21:54:16 -0300 Subject: [PATCH 06/18] test(p2p): time verify_block on the mainnet vector and at the size limit An ignored test that prints how long verify_block takes, copies included: on the real fulu vector, and on that block refilled to the 10 MiB gossip limit three ways (the most transactions the list allows, transactions of the vector's mean size, and one transaction). Run with cargo test -p ethlambda-p2p --profile release-fast --lib \ payload_hash::tests::verify_block_cost -- --ignored --nocapture --test-threads=1 --- .../net/p2p/src/beacon/payload_hash/tests.rs | 98 +++++++++++++++++++ 1 file changed, 98 insertions(+) diff --git a/crates/net/p2p/src/beacon/payload_hash/tests.rs b/crates/net/p2p/src/beacon/payload_hash/tests.rs index fb336a2cf..879616809 100644 --- a/crates/net/p2p/src/beacon/payload_hash/tests.rs +++ b/crates/net/p2p/src/beacon/payload_hash/tests.rs @@ -333,3 +333,101 @@ fn a_gloas_mismatch_is_counted_but_not_refused() { let queued = Outcome::Queue(QueueReason::StateNotCached); assert_eq!(envelope_verdict(queued, &changed), queued); } + +/// Not a check: how long [`verify_block`] takes, copies included, on the real +/// fulu vector and on fulu blocks filled to the gossip size limit. `#[ignore]`d +/// because it only prints. +/// +/// ```text +/// cargo test -p ethlambda-p2p --profile release-fast --lib \ +/// payload_hash::tests::verify_block_cost -- --ignored --nocapture --test-threads=1 +/// ``` +#[test] +#[ignore = "benchmark: prints how long verify_block takes"] +fn verify_block_cost() { + use std::hint::black_box; + use std::time::{Duration, Instant}; + + use ethlambda_types::beacon::containers::bellatrix::{Transaction, Transactions}; + use ethlambda_types::beacon::preset; + + use crate::req_resp::MAX_PAYLOAD_SIZE; + + fn time(label: &str, block: &SignedBeaconBlock, runs: u32) { + let SignedBeaconBlock::Fulu(inner) = block else { + panic!("fulu"); + }; + let transactions = inner.message.body.execution_payload.transactions.len(); + let bytes = block.to_ssz().len(); + assert!(bytes <= MAX_PAYLOAD_SIZE, "{label}: over the gossip limit"); + let _ = black_box(verify_block(black_box(block))); + let mut fastest = Duration::MAX; + let mut total = Duration::ZERO; + for _ in 0..runs { + let start = Instant::now(); + let _ = black_box(verify_block(black_box(block))); + let elapsed = start.elapsed(); + fastest = fastest.min(elapsed); + total += elapsed; + } + println!( + "verify_block_cost {label}: {transactions} transactions, {bytes} SSZ bytes, \ + mean {:?}, min {fastest:?} over {runs} runs", + total / runs + ); + } + + /// The fulu vector with its transactions replaced by `count` of `len` + /// bytes each. + fn filled(count: usize, len: usize) -> SignedBeaconBlock { + let mut filled = block(ForkName::Fulu, FULU); + let transactions: Vec = (0..count) + .map(|index| { + let mut tx = vec![0x02u8; len]; + let tail = (index as u32).to_le_bytes(); + let keep = len.min(tail.len()); + tx[len - keep..].copy_from_slice(&tail[..keep]); + Transaction::try_from(tx).expect("within MAX_BYTES_PER_TRANSACTION") + }) + .collect(); + fulu_block(&mut filled) + .message + .body + .execution_payload + .transactions = + Transactions::try_from(transactions).expect("within MAX_TRANSACTIONS_PER_PAYLOAD"); + filled + } + + let real = block(ForkName::Fulu, FULU); + time("mainnet vector", &real, 200); + + // What the block takes besides its transactions; each transaction adds + // its bytes and a four-byte offset. + let empty = filled(0, 0); + let room = MAX_PAYLOAD_SIZE - empty.to_ssz().len(); + + // As many transactions as the list allows, as small as the room leaves: + // the most trie insertions a block at the limit can ask for. + let count = preset::MAX_TRANSACTIONS_PER_PAYLOAD; + time( + "limit, most transactions", + &filled(count, room / count - 4), + 5, + ); + + // The mainnet vector's mean transaction size. + let SignedBeaconBlock::Fulu(inner) = &real else { + panic!("fulu"); + }; + let real_transactions = &inner.message.body.execution_payload.transactions; + let mean = real_transactions.iter().map(|tx| tx.len()).sum::() / real_transactions.len(); + time( + "limit, mainnet-sized transactions", + &filled(room / (mean + 4), mean), + 10, + ); + + // One transaction holding the whole room: keccak over ten megabytes. + time("limit, one transaction", &filled(1, room - 4), 10); +} From 063105b98f6f077e000cfa1d655428404b95450d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Wed, 18 Nov 2026 21:58:26 -0300 Subject: [PATCH 07/18] docs: describe the payload block hash rule as what it is spec_deviations.md said applying payloads to fork choice early "is only safe if the structural case cannot get that far", which does not hold: blocks fetched by range or root are not checked, the early import has its own revert path, and the Engine API already requires the execution client to validate blockHash on every newPayload, even while syncing. The section now says that, and that the rule saves the early import a revert for gossip blocks. It also covers where the rule now runs (after the signature, IGNORE, gloas counted only), what is not covered, and the measured cost. beacon_wire.md (both passages and the metric row) and the reason list in metrics.md follow. --- docs/beacon_wire.md | 23 +++++++----- docs/metrics.md | 5 ++- docs/spec_deviations.md | 80 ++++++++++++++++++++++++++++------------- 3 files changed, 74 insertions(+), 34 deletions(-) diff --git a/docs/beacon_wire.md b/docs/beacon_wire.md index 545f74267..7c458e7de 100644 --- a/docs/beacon_wire.md +++ b/docs/beacon_wire.md @@ -212,12 +212,17 @@ an unbounded progressive bitlist, so one longer than electra's type bound is REJECTed first, reading its length without expanding it, since expanding is what the seen-set check does before any other. -One rule on `beacon_block` (bellatrix to fulu) and `execution_payload` is -stricter than the specification: the payload's `block_hash` must equal the hash -of the execution header rebuilt from the payload's own fields, or the message is -REJECTed (`beacon/payload_hash.rs`; the reason is `payload_block_hash_mismatch`, -and `lean_beacon_payload_block_hash_mismatch_total{kind}` counts it). It runs -after the cheap rules and before the stateful half. See +One rule on `beacon_block` (bellatrix to fulu) is stricter than the +specification: the payload's `block_hash` must equal the hash of the execution +header rebuilt from the payload's own fields, or the block is IGNOREd +(`beacon/payload_hash.rs`; the reason is `payload_block_hash_mismatch`, and +`lean_beacon_payload_block_hash_mismatch_total{kind}` counts it). It runs at the +end of the stateful half, on a block the topic's rules accepted, so only a block +whose proposer signature verified is hashed. IGNORE rather than REJECT, since +other clients have no such rule and relay the block. A block answered `Queue` +or forwarded under `Overloaded` is not hashed. `execution_payload` envelopes +are hashed the same way once accepted, but a mismatch is only counted and +logged until the Amsterdam header is final. See [spec_deviations.md](./spec_deviations.md#a-payloads-block-hash-must-be-its-headers). Three deliberate departures from the gloas gossip rules, each for want of state @@ -649,8 +654,8 @@ not imported only briefly and in small numbers, so a batch's envelopes must arrive before the next batch's blocks do. Everything fetched goes through the same rules as an `execution_payload` gossip message (`beacon/envelope_checks.rs`) before the actor sees it; a `Queue` verdict is -forwarded too. That includes the payload block hash rule above, which the -specification does not have. +forwarded too. An accepted one also has its payload block hash checked, as +above, which counts a mismatch without refusing the envelope. ### Data column sidecars @@ -853,7 +858,7 @@ as a query filter, so a `quic`-only record is invisible to it. | `lean_beacon_gossip_messages_total{topic,result}` | Gossip received, by topic and by `decoded` / `decode_failed` / `decompress_failed` / `unsupported_fork` | | `lean_beacon_gossip_validation_total{kind,outcome,reason}` | Gossip verdicts, now including `beacon_aggregate_and_proof` and `beacon_attestation`; see [metrics.md](./metrics.md#beacon-gossip-validation) | | `lean_beacon_gossip_verdict_expired_total{kind}` | Verdicts that came too late to propagate anything; should stay at zero | -| `lean_beacon_payload_block_hash_mismatch_total{kind}` | Payloads refused because `block_hash` is not the hash of the header rebuilt from their fields, by `block` / `envelope` | +| `lean_beacon_payload_block_hash_mismatch_total{kind}` | Signed payloads whose `block_hash` is not the hash of the header rebuilt from their fields: `block` (a gossip block, IGNOREd) / `envelope` (counted, not refused) | | `lean_beacon_status_digest_mismatch_total` | Handshakes seen from another fork digest | | `lean_beacon_fork_digest{digest}` | The digest computed at startup, as a label | | `lean_beacon_aggregate_decode_seconds` | Time spent decoding one aggregate off the wire | diff --git a/docs/metrics.md b/docs/metrics.md index c9264b677..1ef86f4de 100644 --- a/docs/metrics.md +++ b/docs/metrics.md @@ -426,7 +426,10 @@ and `subcommittee_index` (contribution only) on the reject side; they reuse `not_current_slot`, `already_seen`, `covered_bits`, `no_participants`, `not_aggregator`, `not_in_committee`, `unknown_validator`, `selection_proof`, `aggregator_signature`, `aggregate_signature`, `wrong_subnet` and -`bad_signature`. `already_seen`, `overloaded` and `unsupported_fork` are shared with the +`bad_signature`. `beacon_block` adds `payload_block_hash_mismatch` on the ignore +side, a rule the specification does not have (see +[spec_deviations.md](./spec_deviations.md#a-payloads-block-hash-must-be-its-headers)). +`already_seen`, `overloaded` and `unsupported_fork` are shared with the other topics: `unsupported_fork` is an ignore reason for a message of a fork this build has no gossip rules for, so an honest peer past the fork epoch is not scored as a bad decoder. Gloas blocks, data columns, aggregates and attestations diff --git a/docs/spec_deviations.md b/docs/spec_deviations.md index 313efc1dd..0366dd4ad 100644 --- a/docs/spec_deviations.md +++ b/docs/spec_deviations.md @@ -528,34 +528,66 @@ that the tests compare like with like. ## A payload's block hash must be its header's -`beacon_block` (bellatrix to fulu) and `execution_payload` gossip, and every -envelope fetched by root or range, are REJECTed when the payload's `block_hash` -is not `keccak256(rlp(header))` for the execution block header rebuilt from the -payload's own fields. +A `beacon_block` gossip message (bellatrix to fulu) whose payload `block_hash` +is not `keccak256(rlp(header))`, for the execution block header rebuilt from the +payload's own fields, is IGNOREd once the topic's own rules have accepted it. +Gloas envelopes, from gossip or fetched, are checked the same way but only +counted. - **The specification:** has no such rule. A hash that does not match is the execution client's to find, when the chain actor hands it the payload. - **ethlambda:** rebuilds the header in `ethlambda-p2p` - (`beacon/payload_hash.rs`) and refuses the message before the stateful rules - run. The header takes the payload's fields, the transactions and withdrawals - tries, the parent beacon block root (the block's `parent_root`; the - envelope's own field in gloas), the EIP-7685 requests hash (the Engine API's - request list, `get_execution_requests_list`), and in gloas the keccak of the - block access list bytes (EIP-7928) and the slot number (EIP-7843). It is run - per fork against real chain data: see the vector table in the module's tests. - A bellatrix payload that is the empty default (before the merge) is skipped. -- **Why:** since `engine_newPayloadV2` the Engine API answers a block-hash - mismatch with `INVALID` and a null `latestValidHash`, the same answer as for - a payload that executed badly and whose last valid ancestor is unknown. - Applying payloads to fork choice before the execution client answers is only - safe if the structural case cannot get that far. -- **Cost and counter:** one trie over the transactions per accepted-looking - message, after the cheap rules that drop most of them. - `lean_beacon_payload_block_hash_mismatch_total{kind}` counts refusals and a - `warn!` names the slot and root. -- **Equivalence:** a stricter filter, never a looser one: every payload it - refuses is one the execution client would call `INVALID`. Blocks fetched by - `beacon_blocks_by_range/root` are not checked here. + (`beacon/payload_hash.rs`) at the end of the stateful half, and only for a + message those rules answered `Accept`, so the proposer's (or the builder's) + signature has verified: an unsigned message never makes the node build a + transaction trie. The header takes the payload's fields, the transactions + and withdrawals tries, the parent beacon block root (the block's + `parent_root`; the envelope's own field in gloas), the EIP-7685 requests hash + (the Engine API's request list, `get_execution_requests_list`), and in gloas + the keccak of the block access list bytes (EIP-7928) and the slot number + (EIP-7843). It is run per fork against real chain data, including a mainnet + block with more than 128 transactions and requests of two types: see the + vector table in the module's tests. A bellatrix payload that is the whole empty + default (before the merge, the specification's `is_execution_enabled`) is + skipped. +- **IGNORE, not REJECT:** other clients have no such rule and relay a validly + signed block whatever its `block_hash`, so a REJECT would count an invalid + delivery against every honest peer that forwarded one, and a proposer + publishing such blocks could drive those peers toward the graylist, + isolating only this node. IGNORE keeps the block from being imported or + relayed from gossip without scoring anyone. +- **Gloas is counted, not refused:** the Amsterdam header (the block access + list hash, the slot number) may still change between devnets, and envelopes + are judged on gossip and on fetch alike, so an encoding this build gets wrong + would refuse every payload and leave the node unable to follow the chain. + Refusing waits until the header is final. +- **Why:** the Engine API already requires the execution client to validate + `blockHash` on every `engine_newPayload`, even while syncing (execution-apis + `paris.md`), so while an import waits for that answer this finds nothing the + execution client would not. It exists for the early fork-choice import being + worked on in lambdaclass/ethlambda#773, which applies a payload before the + execution client answers and reverts it on `INVALID`: a gossip block caught + here saves that path a revert. +- **Not covered:** a block fetched by `beacon_blocks_by_range/root`, and a + gossip block answered `Queue` or forwarded under `Ignore(Overloaded)`, reach + the chain actor unhashed. The execution client still checks them. +- **Cost and counter:** one transactions trie plus the RLP and keccak of the + header, on the blocking validation thread and inside its permit + (`gossip_validation_permits` on gossip, `column_check_permits` for a fetched + envelope). Measured with the `#[ignore]`d + `payload_hash::tests::verify_block_cost` (`release-fast`, Apple M3 Pro, load + average about 20 on 11 cores; reruns under a load near 100 were up to five + times slower): about 0.24 ms on the mainnet vector (238 transactions, + 114 kB). At the 10 MiB gossip limit: 11 ms for one transaction, 19 ms for + 14,882 transactions of about 700 bytes (a mainnet block's mean size), and + 0.6 s for the worst case, 1,048,576 five-byte transactions (the most the + list allows). Only a block whose proposer signature verified can ask for + that. + `lean_beacon_payload_block_hash_mismatch_total{kind}` counts mismatches + (`block` IGNOREd, `envelope` counted only) and a `warn!` names the slot and + root. +- **Equivalence:** a stricter filter, never a looser one: every block it + ignores carries a payload the execution client would call `INVALID`. ## The envelope check reads the cached state root From b0d2c77b3fcfb7046a8f8ebf2ad9bfe2640d9e5f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Thu, 19 Nov 2026 13:09:32 -0300 Subject: [PATCH 08/18] test(p2p): pin that a payload hash mismatch is not imported from gossip The tests checked only the Outcome a mismatched block gets. The verdict handler's body moves into conclude() so a test can run the actor's own path: Ignore(PayloadBlockHashMismatch) is neither relayed nor handed to the chain actor, while an accepted block through the same path is. Ignore(Overloaded) is still the one ignore that forwards a block, and only from spawn_stateful_checks, when no permit was free. --- crates/net/p2p/src/beacon/verdict.rs | 54 +++++++++++++++++++++++++--- 1 file changed, 49 insertions(+), 5 deletions(-) diff --git a/crates/net/p2p/src/beacon/verdict.rs b/crates/net/p2p/src/beacon/verdict.rs index 8a9091eee..10f4e89f9 100644 --- a/crates/net/p2p/src/beacon/verdict.rs +++ b/crates/net/p2p/src/beacon/verdict.rs @@ -560,11 +560,18 @@ impl Handler for P2PServer { outcome, object, } = msg; - let outcome = settle(self, outcome, &object); - let received_at = id.received_at; - if report(self, id, outcome) { - object.forward(self, received_at, outcome); - } + conclude(self, id, outcome, object); + } +} + +/// What the actor does with a blocking task's verdict: settle it against the +/// seen cache, report it to gossipsub, and hand the object on only when the +/// outcome allows it ([`disposition`]). +fn conclude(server: &mut P2PServer, id: GossipId, outcome: Outcome, object: Validated) { + let outcome = settle(server, outcome, &object); + let received_at = id.received_at; + if report(server, id, outcome) { + object.forward(server, received_at, outcome); } } @@ -950,6 +957,43 @@ mod tests { ); } + /// A block whose payload block hash is not its header's ends in + /// `Ignore(PayloadBlockHashMismatch)`, which neither relays it nor hands + /// it to the chain actor. `Ignore(Overloaded)` is the one ignore that + /// still forwards a block, and only from `spawn_stateful_checks`, when no + /// permit was free and no check ran. + #[tokio::test] + async fn a_block_with_a_mismatched_payload_hash_is_not_imported_from_gossip() { + let mut server = unconnected_beacon_server(Config::mainnet(), 0).await; + let chain = Arc::new(RecordingChain::default()); + server.blockchain = Some(chain.clone()); + let id = |byte: u8| GossipId { + message_id: MessageId::new(&[byte]), + propagation_source: PeerId::random(), + received_at: Instant::now(), + kind: "beacon_block", + }; + let block = |slot| Validated::Block { + block: Box::new(fulu_block(slot, 1)), + block_root: Root::repeat_byte(slot as u8), + }; + + let mismatch = Outcome::Ignore(IgnoreReason::PayloadBlockHashMismatch); + assert!(matches!( + disposition(mismatch), + (MessageAcceptance::Ignore, false) + )); + conclude(&mut server, id(1), mismatch, block(5)); + assert!(chain.announcements.lock().unwrap().is_empty()); + + // The same path does forward an accepted block. + conclude(&mut server, id(2), Outcome::Accept, block(6)); + assert_eq!( + *chain.announcements.lock().unwrap(), + [BlockAnnouncement::Announce] + ); + } + #[tokio::test] async fn an_overloaded_aggregate_is_not_forwarded() { let mut server = unconnected_beacon_server(Config::mainnet(), 0).await; From 75680284fa724eee5cd7f7781d151922a2fd7299 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Thu, 19 Nov 2026 13:09:33 -0300 Subject: [PATCH 09/18] test(p2p): pin the empty transactions, requests and withdrawals roots Two real vectors already cover the empty cases: the Hoodi deneb block has no transactions and the Hoodi electra block has no requests, and both hashes match. the_vectors_exercise_what_each_fork_adds now asserts both, and the vector table says so. No vector has an empty withdrawals list, so a unit test pins its root to the empty trie root. Also note why Bloom::from_slice cannot panic on the logs bloom. --- crates/net/p2p/src/beacon/payload_hash.rs | 3 ++ .../net/p2p/src/beacon/payload_hash/tests.rs | 37 ++++++++++++++++++- 2 files changed, 38 insertions(+), 2 deletions(-) diff --git a/crates/net/p2p/src/beacon/payload_hash.rs b/crates/net/p2p/src/beacon/payload_hash.rs index 7d8b0b261..4c9af6337 100644 --- a/crates/net/p2p/src/beacon/payload_hash.rs +++ b/crates/net/p2p/src/beacon/payload_hash.rs @@ -79,6 +79,9 @@ struct Fields<'a> { fee_recipient: [u8; 20], state_root: [u8; 32], receipts_root: [u8; 32], + /// Always 256 bytes: every fork's `logs_bloom` is a fixed-length + /// `ByteVector[256]`, which is what lets `Bloom::from_slice` (it panics on + /// any other length) take it. logs_bloom: &'a [u8], prev_randao: [u8; 32], block_number: u64, diff --git a/crates/net/p2p/src/beacon/payload_hash/tests.rs b/crates/net/p2p/src/beacon/payload_hash/tests.rs index 879616809..1044fa975 100644 --- a/crates/net/p2p/src/beacon/payload_hash/tests.rs +++ b/crates/net/p2p/src/beacon/payload_hash/tests.rs @@ -6,8 +6,8 @@ //! |-----------|-------------|-----------------------|----------------------------------------| //! | bellatrix | Sepolia | block, slot 500000 | | //! | capella | Sepolia | block, slot 1900000 | withdrawals | -//! | deneb | Hoodi | block, slot 2003 | | -//! | electra | Hoodi | block, slot 70001 | | +//! | deneb | Hoodi | block, slot 2003 | no transactions | +//! | electra | Hoodi | block, slot 70001 | no requests | //! | fulu | mainnet | block, slot 15684701 | 238 transactions, 3 requests (2 types) | //! | gloas | Plataberget | envelope, slot 593101 | | //! @@ -142,9 +142,42 @@ fn the_vectors_exercise_what_each_fork_adds() { "fulu's vector must carry requests of two types" ); + // The empty cases on real blocks: deneb's has no transactions, so its + // hash covers the empty transactions trie, and electra's has no requests, + // so its hash covers the requests hash of an empty list. + let SignedBeaconBlock::Deneb(deneb) = block(ForkName::Deneb, DENEB) else { + panic!("deneb"); + }; + assert!(deneb.message.body.execution_payload.transactions.is_empty()); + let SignedBeaconBlock::Electra(electra_block) = block(ForkName::Electra, ELECTRA) else { + panic!("electra"); + }; + let requests = ethlambda_state_transition::beacon::stf::electra::get_execution_requests_list( + &electra_block.message.body.execution_requests, + ); + assert!( + requests.is_empty(), + "electra's vector must carry no requests" + ); + assert!(!envelope().message.payload.transactions.is_empty()); } +/// No vector has an empty withdrawals list (every one from capella on carries +/// 16), so the empty withdrawals root is pinned against the execution layer's +/// empty trie root, `keccak256(rlp(""))`, instead. +#[test] +fn an_empty_withdrawals_list_has_the_empty_trie_root() { + let empty_trie_root = + hex::decode("56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421") + .expect("hex"); + assert_eq!(keccak256(&[0x80]).to_vec(), empty_trie_root); + assert_eq!( + compute_withdrawals_root(&[], &NativeCrypto).0.to_vec(), + empty_trie_root + ); +} + #[test] fn a_changed_bellatrix_field_is_refused() { let mut changed = block(ForkName::Bellatrix, BELLATRIX); From 57197a271886c9bae5813435224a18b8fd420177 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Thu, 19 Nov 2026 13:09:33 -0300 Subject: [PATCH 10/18] docs: say an ignored block can come back by root, and qualify equivalence A block the payload hash rule IGNOREd on gossip is fetched by root, and imported unhashed, once a child names it as its parent, so for that block the early import's revert is delayed rather than saved. The equivalence claim holds only while this header encoding is the execution layer's, which the real-chain vectors pin per fork. --- docs/spec_deviations.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/spec_deviations.md b/docs/spec_deviations.md index 0366dd4ad..1b66739b8 100644 --- a/docs/spec_deviations.md +++ b/docs/spec_deviations.md @@ -570,7 +570,10 @@ counted. here saves that path a revert. - **Not covered:** a block fetched by `beacon_blocks_by_range/root`, and a gossip block answered `Queue` or forwarded under `Ignore(Overloaded)`, reach - the chain actor unhashed. The execution client still checks them. + the chain actor unhashed. The execution client still checks them. That + includes a block this rule IGNOREd on gossip: if a child arrives naming it + as its parent, it is fetched by root and imported unhashed, so for that block + the early import's revert is delayed rather than saved. - **Cost and counter:** one transactions trie plus the RLP and keccak of the header, on the blocking validation thread and inside its permit (`gossip_validation_permits` on gossip, `column_check_permits` for a fetched @@ -586,8 +589,11 @@ counted. `lean_beacon_payload_block_hash_mismatch_total{kind}` counts mismatches (`block` IGNOREd, `envelope` counted only) and a `warn!` names the slot and root. -- **Equivalence:** a stricter filter, never a looser one: every block it - ignores carries a payload the execution client would call `INVALID`. +- **Equivalence:** a stricter filter, never a looser one, as long as this + header encoding is the execution layer's: every block it ignores then + carries a payload the execution client would call `INVALID`. The real-chain + vectors are what pin the encoding per fork, and gloas only counts a mismatch + because its header is not final yet. ## The envelope check reads the cached state root From 2b2d2e3a05e6a7190c38f7b408e2604940d2d844 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Thu, 19 Nov 2026 13:27:43 -0300 Subject: [PATCH 11/18] fix(p2p): mark a block ignored for its payload hash as seen settle() recorded a block's slot and proposer only on Accept, so a block IGNOREd for its payload block hash left the key open: the same proposer could send any number of signed blocks for that slot, and each one went through the stateful checks, signature included, and was hashed in full. Before the rule, the cheap checks IGNOREd every block after the first. Such a block passed every rule the specification has, signature included, so it is the specification's "first block with a valid signature" for its slot and proposer. settle() now records it too, and a_payload_hash_mismatch_marks_its_slot_and_proposer_seen checks that the cheap checks then IGNORE another block for the key (it fails without the fix). --- crates/net/p2p/src/beacon/verdict.rs | 52 +++++++++++++++++++++++++--- 1 file changed, 47 insertions(+), 5 deletions(-) diff --git a/crates/net/p2p/src/beacon/verdict.rs b/crates/net/p2p/src/beacon/verdict.rs index 10f4e89f9..103dcbe7f 100644 --- a/crates/net/p2p/src/beacon/verdict.rs +++ b/crates/net/p2p/src/beacon/verdict.rs @@ -544,12 +544,24 @@ impl Message for GossipVerdict { /// validation on separate blocking threads at once, and only the first /// `Accept` to reach the actor stands, which is the specification's "first /// valid". Any other outcome passes through unrecorded, since only an Accept -/// is a candidate for the seen cache in the first place. +/// is a candidate for the seen cache in the first place, with one exception. +/// +/// A block IGNOREd for its payload block hash passed every rule the +/// specification has, signature included, so it is the specification's "first +/// block with a valid signature" for its slot and proposer, and is recorded +/// too. Otherwise a proposer could send any number of signed blocks for one +/// slot, each verified and hashed in full, where the cheap checks would IGNORE +/// every one after the first. fn settle(server: &mut P2PServer, outcome: Outcome, object: &Validated) -> Outcome { - if outcome == Outcome::Accept && !object.record_seen(server) { - Outcome::Ignore(IgnoreReason::AlreadySeen) - } else { - outcome + match outcome { + Outcome::Accept if !object.record_seen(server) => { + Outcome::Ignore(IgnoreReason::AlreadySeen) + } + Outcome::Ignore(IgnoreReason::PayloadBlockHashMismatch) => { + object.record_seen(server); + outcome + } + _ => outcome, } } @@ -957,6 +969,36 @@ mod tests { ); } + /// A block IGNOREd for its payload hash had a valid signature, so its slot + /// and proposer are marked seen: another block for them is IGNOREd by the + /// cheap checks, before any signature or hash work, and a later `Accept` + /// for them is `AlreadySeen`. + #[tokio::test] + async fn a_payload_hash_mismatch_marks_its_slot_and_proposer_seen() { + let mut server = unconnected_beacon_server(Config::mainnet(), 0).await; + let block = |root: u8| Validated::Block { + block: Box::new(fulu_block(5, 1)), + block_root: Root::repeat_byte(root), + }; + let mismatch = Outcome::Ignore(IgnoreReason::PayloadBlockHashMismatch); + + assert_eq!(settle(&mut server, mismatch, &block(1)), mismatch); + + let now_ms = std::time::SystemTime::now() + .duration_since(std::time::UNIX_EPOCH) + .expect("after the epoch") + .as_millis() as u64; + let second = fulu_block(5, 1); + assert_eq!( + gossip::block::cheap_checks(&server.seen_blocks, &server.store, &second, now_ms), + Err(Outcome::Ignore(IgnoreReason::AlreadySeen)) + ); + assert_eq!( + settle(&mut server, Outcome::Accept, &block(2)), + Outcome::Ignore(IgnoreReason::AlreadySeen) + ); + } + /// A block whose payload block hash is not its header's ends in /// `Ignore(PayloadBlockHashMismatch)`, which neither relays it nor hands /// it to the chain actor. `Ignore(Overloaded)` is the one ignore that From 46fa59f522b2f072b6a94b2eb3ed7f1382756159 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Thu, 19 Nov 2026 13:27:44 -0300 Subject: [PATCH 12/18] fix(p2p): assert the header's optional fields only extend its tail An absent optional field writes nothing in the RLP, so a field present after an absent earlier one would land in the earlier one's place and give a wrong hash. Forks only add to the tail, which every Fields today follows; computed_hash now debug-asserts it, and a test builds a Fields with requests but no blob gas to check the assertion fires. Also say why each transaction is copied. --- crates/net/p2p/src/beacon/payload_hash.rs | 17 ++++++++++++++++- .../net/p2p/src/beacon/payload_hash/tests.rs | 18 ++++++++++++++++++ 2 files changed, 34 insertions(+), 1 deletion(-) diff --git a/crates/net/p2p/src/beacon/payload_hash.rs b/crates/net/p2p/src/beacon/payload_hash.rs index 4c9af6337..5d383823c 100644 --- a/crates/net/p2p/src/beacon/payload_hash.rs +++ b/crates/net/p2p/src/beacon/payload_hash.rs @@ -139,7 +139,8 @@ impl<'a> Fields<'a> { /// `keccak256(rlp(header))`. fn computed_hash(&self) -> [u8; 32] { // The trie roots are over opaque bytes: a transaction is already - // `type || rlp(tx)` on the wire, so it is never decoded. + // `type || rlp(tx)` on the wire, so it is never decoded. It is + // copied, since ethrex's trie takes owned values. let transactions = self .transactions .iter() @@ -170,6 +171,20 @@ impl<'a> Fields<'a> { let block_access_list_hash = self.amsterdam.map(|(bal, _)| H256(keccak256(bal))); let slot_number = self.amsterdam.map(|(_, slot)| slot); let base_fee_per_gas = U256::from_little_endian(&self.base_fee_per_gas); + // An absent optional field writes nothing, so a later fork's field + // after an absent earlier one would land in the earlier one's place. + // Forks only ever add to the header's tail. + let tail = [ + withdrawals_root.is_some(), + self.blob_gas.is_some(), + self.parent_beacon_block_root.is_some(), + requests_hash.is_some(), + self.amsterdam.is_some(), + ]; + debug_assert!( + tail.windows(2).all(|pair| pair[0] || !pair[1]), + "a header field is present after an absent earlier one: {tail:?}" + ); let mut buf = Vec::with_capacity(700); Encoder::new(&mut buf) diff --git a/crates/net/p2p/src/beacon/payload_hash/tests.rs b/crates/net/p2p/src/beacon/payload_hash/tests.rs index 1044fa975..f969d2f99 100644 --- a/crates/net/p2p/src/beacon/payload_hash/tests.rs +++ b/crates/net/p2p/src/beacon/payload_hash/tests.rs @@ -178,6 +178,24 @@ fn an_empty_withdrawals_list_has_the_empty_trie_root() { ); } +/// An absent optional header field writes nothing, so a present one after it +/// would shift into its place: `computed_hash` asserts the fields a fork adds +/// only ever extend the header's tail. +#[test] +#[cfg(debug_assertions)] +#[should_panic(expected = "a header field is present after an absent earlier one")] +fn a_header_field_after_an_absent_one_is_caught() { + let block = block(ForkName::Electra, ELECTRA); + let SignedBeaconBlock::Electra(inner) = &block else { + panic!("electra"); + }; + let message = &inner.message; + let payload = &message.body.execution_payload; + let mut fields = Fields::deneb(payload, message.parent_root, Some(Vec::new())); + fields.blob_gas = None; + let _ = fields.computed_hash(); +} + #[test] fn a_changed_bellatrix_field_is_refused() { let mut changed = block(ForkName::Bellatrix, BELLATRIX); From adc00e2c91d693a61f321063cd03a0ebfd8c5212 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Thu, 19 Nov 2026 13:27:44 -0300 Subject: [PATCH 13/18] docs: say what the payload hash rule changes before the early import The rationale names the early fork-choice import as what the rule saves a revert for. That import has not landed, so until it does there is no revert to save; what the rule changes today is that such a block is neither relayed nor handed to the chain actor from gossip. --- docs/spec_deviations.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/spec_deviations.md b/docs/spec_deviations.md index 1b66739b8..0363cb63a 100644 --- a/docs/spec_deviations.md +++ b/docs/spec_deviations.md @@ -567,7 +567,11 @@ counted. execution client would not. It exists for the early fork-choice import being worked on in lambdaclass/ethlambda#773, which applies a payload before the execution client answers and reverts it on `INVALID`: a gossip block caught - here saves that path a revert. + here saves that path a revert. Until that lands there is no revert to save: + what the rule changes is that such a block is neither relayed (an `Accept` + verdict comes before the execution client is asked) nor handed to the chain + actor from gossip, whose import would have failed on the execution client's + answer anyway. - **Not covered:** a block fetched by `beacon_blocks_by_range/root`, and a gossip block answered `Queue` or forwarded under `Ignore(Overloaded)`, reach the chain actor unhashed. The execution client still checks them. That From d38e7865af776c54a72a6343d30a186f045d804c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Thu, 19 Nov 2026 17:03:56 -0300 Subject: [PATCH 14/18] fix(p2p): report a mismatch that lost the seen race as already seen settle() recorded a block ignored for its payload hash but dropped record_seen's answer, so a second such block for a slot and proposer already recorded (two checked at once) was still reported as payload_block_hash_mismatch. It is now AlreadySeen, the same as a second Accept, and a_payload_hash_mismatch_marks_its_slot_and_proposer_seen covers it. --- crates/net/p2p/src/beacon/verdict.rs | 31 ++++++++++++++++------------ 1 file changed, 18 insertions(+), 13 deletions(-) diff --git a/crates/net/p2p/src/beacon/verdict.rs b/crates/net/p2p/src/beacon/verdict.rs index 103dcbe7f..1963e0cee 100644 --- a/crates/net/p2p/src/beacon/verdict.rs +++ b/crates/net/p2p/src/beacon/verdict.rs @@ -549,19 +549,19 @@ impl Message for GossipVerdict { /// A block IGNOREd for its payload block hash passed every rule the /// specification has, signature included, so it is the specification's "first /// block with a valid signature" for its slot and proposer, and is recorded -/// too. Otherwise a proposer could send any number of signed blocks for one -/// slot, each verified and hashed in full, where the cheap checks would IGNORE -/// every one after the first. +/// too, as `AlreadySeen` when another one got there first. Otherwise a +/// proposer could send any number of signed blocks for one slot, each +/// verified and hashed in full, where the cheap checks would IGNORE every one +/// after the first. fn settle(server: &mut P2PServer, outcome: Outcome, object: &Validated) -> Outcome { - match outcome { - Outcome::Accept if !object.record_seen(server) => { - Outcome::Ignore(IgnoreReason::AlreadySeen) - } - Outcome::Ignore(IgnoreReason::PayloadBlockHashMismatch) => { - object.record_seen(server); - outcome - } - _ => outcome, + let seen_candidate = matches!( + outcome, + Outcome::Accept | Outcome::Ignore(IgnoreReason::PayloadBlockHashMismatch) + ); + if seen_candidate && !object.record_seen(server) { + Outcome::Ignore(IgnoreReason::AlreadySeen) + } else { + outcome } } @@ -972,7 +972,8 @@ mod tests { /// A block IGNOREd for its payload hash had a valid signature, so its slot /// and proposer are marked seen: another block for them is IGNOREd by the /// cheap checks, before any signature or hash work, and a later `Accept` - /// for them is `AlreadySeen`. + /// for them is `AlreadySeen`. So is a later mismatch, which was checked + /// concurrently and lost the race to the first. #[tokio::test] async fn a_payload_hash_mismatch_marks_its_slot_and_proposer_seen() { let mut server = unconnected_beacon_server(Config::mainnet(), 0).await; @@ -997,6 +998,10 @@ mod tests { settle(&mut server, Outcome::Accept, &block(2)), Outcome::Ignore(IgnoreReason::AlreadySeen) ); + assert_eq!( + settle(&mut server, mismatch, &block(3)), + Outcome::Ignore(IgnoreReason::AlreadySeen) + ); } /// A block whose payload block hash is not its header's ends in From a726ddddefc38c97dcfd42c2ab4bb9ed21eb3283 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Thu, 19 Nov 2026 17:03:56 -0300 Subject: [PATCH 15/18] refactor(p2p): keep the payload hash checks crate-private verify_block, verify_envelope and HashMismatch were pub, though only the p2p crate's own verdict code calls them. --- crates/net/p2p/src/beacon/payload_hash.rs | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/crates/net/p2p/src/beacon/payload_hash.rs b/crates/net/p2p/src/beacon/payload_hash.rs index 5d383823c..211bd8a52 100644 --- a/crates/net/p2p/src/beacon/payload_hash.rs +++ b/crates/net/p2p/src/beacon/payload_hash.rs @@ -68,9 +68,9 @@ const EMPTY_OMMERS_HASH: [u8; 32] = [ /// The hash the payload claims against the one its fields give. #[derive(Debug, Clone, Copy, PartialEq, Eq)] -pub struct HashMismatch { - pub claimed: [u8; 32], - pub computed: [u8; 32], +pub(crate) struct HashMismatch { + pub(crate) claimed: [u8; 32], + pub(crate) computed: [u8; 32], } /// What a payload and its surroundings supply to the header, whatever the fork. @@ -238,7 +238,7 @@ fn keccak256(data: &[u8]) -> [u8; 32] { /// A block before bellatrix, a bellatrix block from before the merge (its /// payload is the empty default), and a gloas block (its payload arrives in a /// separate envelope) have nothing to check. -pub fn verify_block(block: &SignedBeaconBlock) -> Result<(), HashMismatch> { +pub(crate) fn verify_block(block: &SignedBeaconBlock) -> Result<(), HashMismatch> { match block { SignedBeaconBlock::Bellatrix(block) => { let payload = &block.message.body.execution_payload; @@ -313,7 +313,7 @@ pub fn verify_block(block: &SignedBeaconBlock) -> Result<(), HashMismatch> { } /// A gloas envelope's payload hash against its header. -pub fn verify_envelope( +pub(crate) fn verify_envelope( envelope: &gloas::SignedExecutionPayloadEnvelope, ) -> Result<(), HashMismatch> { let message = &envelope.message; From e1f1b2ce5fc02a392943935cf942e372e0d08381 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Thu, 19 Nov 2026 17:03:56 -0300 Subject: [PATCH 16/18] docs: bound the payload hash cost for concurrent equivocations The seen cache stops another block for a slot and proposer once the first verdict reaches the p2p actor, not while blocks are still being checked. A proposer publishing several signed equivocations at once has each one hashed until then, up to the 128 validation permits. The cost bullet now says so, and that the signature check has the same window. --- docs/spec_deviations.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/spec_deviations.md b/docs/spec_deviations.md index 0363cb63a..088be8a92 100644 --- a/docs/spec_deviations.md +++ b/docs/spec_deviations.md @@ -589,7 +589,13 @@ counted. 14,882 transactions of about 700 bytes (a mainnet block's mean size), and 0.6 s for the worst case, 1,048,576 five-byte transactions (the most the list allows). Only a block whose proposer signature verified can ask for - that. + that, and once its verdict reaches the p2p actor its slot and proposer are + marked seen, so the cheap checks IGNORE any other block for them. Blocks + already in validation are not covered: a proposer that publishes several + signed equivocations at once has each hashed until the first verdict lands, + up to the 128 `gossip_validation_permits` at a time (a message arriving with + none free is forwarded unhashed under `Overloaded`). The signature check has + the same window; only its per-block cost is smaller. `lean_beacon_payload_block_hash_mismatch_total{kind}` counts mismatches (`block` IGNOREd, `envelope` counted only) and a `warn!` names the slot and root. From 8e0d90d3c4079af4bd0acf47b05aa41c32914703 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Thu, 19 Nov 2026 17:15:41 -0300 Subject: [PATCH 17/18] fix(p2p): log fetched envelope mismatches at debug, name the proposer MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit envelope_verdict warned on every mismatch, fetched envelopes included, so if the Amsterdam header moved, range sync would warn once per envelope of every batch. It now takes the envelope's source: a gossip envelope still warns and a fetched one logs at debug, and the counter counts both as before. A block's mismatch warning also names its proposer, the one party a signed mismatch is attributable to. A comment at the gloas header fields says what pins their order (a real Platåberget envelope) and that it needs re-checking against the final EIPs before a mismatch is refused. --- crates/net/p2p/src/beacon/envelope_checks.rs | 4 +- crates/net/p2p/src/beacon/payload_hash.rs | 49 ++++++++++++++++--- .../net/p2p/src/beacon/payload_hash/tests.rs | 9 ++-- crates/net/p2p/src/beacon/verdict.rs | 5 +- 4 files changed, 52 insertions(+), 15 deletions(-) diff --git a/crates/net/p2p/src/beacon/envelope_checks.rs b/crates/net/p2p/src/beacon/envelope_checks.rs index 689b5913f..a2cab4154 100644 --- a/crates/net/p2p/src/beacon/envelope_checks.rs +++ b/crates/net/p2p/src/beacon/envelope_checks.rs @@ -33,7 +33,7 @@ use ethlambda_types::beacon::containers::gloas::SignedExecutionPayloadEnvelope; use tracing::{debug, error, warn}; use crate::P2PServer; -use crate::beacon::payload_hash; +use crate::beacon::payload_hash::{self, EnvelopeSource}; /// Whether a fetched envelope goes to the chain actor. pub(crate) fn forwards(outcome: &Outcome) -> bool { @@ -55,7 +55,7 @@ fn judge(store: &Store, envelope: &SignedExecutionPayloadEnvelope) -> Outcome { // The payload block hash rule the gossip topic runs too, after the // builder's signature verified. Counted, never refused, for gloas. let outcome = stateful_checks(store, envelope); - payload_hash::envelope_verdict(outcome, envelope) + payload_hash::envelope_verdict(outcome, envelope, EnvelopeSource::Fetch) } /// Run the gossip rules on `envelopes` and send the chain actor the ones that diff --git a/crates/net/p2p/src/beacon/payload_hash.rs b/crates/net/p2p/src/beacon/payload_hash.rs index 211bd8a52..c98a8a4ba 100644 --- a/crates/net/p2p/src/beacon/payload_hash.rs +++ b/crates/net/p2p/src/beacon/payload_hash.rs @@ -56,7 +56,7 @@ use ethrex_common::{Address, Bloom, Bytes, H256, NativeCrypto, U256}; use ethrex_rlp::encode::RLPEncode; use ethrex_rlp::structs::Encoder; use ethrex_trie::Trie; -use tracing::warn; +use tracing::{debug, warn}; use crate::metrics; @@ -209,6 +209,11 @@ impl<'a> Fields<'a> { .encode_optional_field(&self.blob_gas.map(|(_, excess)| excess)) .encode_optional_field(&self.parent_beacon_block_root.map(H256)) .encode_optional_field(&requests_hash) + // Gloas (Amsterdam): the order of these two, and the fields + // themselves, are pinned only by a real Platåberget envelope + // (`plataberget_gloas_envelope_slot_593101.ssz`). Re-check both + // against the final EIP-7928 and EIP-7843 header before a + // mismatch is refused (lambdaclass/ethlambda#818). .encode_optional_field(&block_access_list_hash) .encode_optional_field(&slot_number) .finish(); @@ -365,8 +370,10 @@ pub(crate) fn block_verdict( }; metrics::inc_beacon_payload_block_hash_mismatch("block"); let slot = block.slot(); + let proposer = block.proposer_index(); warn!( slot, + proposer, block_root = %ShortRoot(&block_root.0), claimed = %ShortRoot(&mismatch.claimed), computed = %ShortRoot(&mismatch.computed), @@ -386,9 +393,14 @@ pub(crate) fn block_verdict( /// node unable to follow the chain; a pre-gloas block refused on gossip still /// comes back by root. The counter says whether the encoding agrees with the /// chain until the header is final and this can refuse. +/// +/// A mismatch is logged at `warn` for a gossip envelope and at `debug` for a +/// fetched one: if the header did move, range sync would otherwise warn once +/// per envelope of every batch, and the counter already counts them all. pub(crate) fn envelope_verdict( outcome: Outcome, envelope: &gloas::SignedExecutionPayloadEnvelope, + source: EnvelopeSource, ) -> Outcome { if outcome != Outcome::Accept { return outcome; @@ -396,16 +408,37 @@ pub(crate) fn envelope_verdict( let _ = verify_envelope(envelope).inspect_err(|mismatch| { metrics::inc_beacon_payload_block_hash_mismatch("envelope"); let slot = envelope.message.payload.slot_number; - warn!( - slot, - block_root = %ShortRoot(&envelope.message.beacon_block_root.0), - claimed = %ShortRoot(&mismatch.claimed), - computed = %ShortRoot(&mismatch.computed), - "An envelope's payload block hash is not its header's; not refused before the Amsterdam header is final" - ); + let block_root = ShortRoot(&envelope.message.beacon_block_root.0); + let claimed = ShortRoot(&mismatch.claimed); + let computed = ShortRoot(&mismatch.computed); + match source { + EnvelopeSource::Gossip => warn!( + slot, + %block_root, + %claimed, + %computed, + "An envelope's payload block hash is not its header's; not refused before the Amsterdam header is final" + ), + EnvelopeSource::Fetch => debug!( + slot, + %block_root, + %claimed, + %computed, + "A fetched envelope's payload block hash is not its header's; not refused before the Amsterdam header is final" + ), + } }); outcome } +/// Where an envelope judged by [`envelope_verdict`] came from. +#[derive(Debug, Clone, Copy, PartialEq, Eq)] +pub(crate) enum EnvelopeSource { + /// The `execution_payload` gossip topic. + Gossip, + /// An `execution_payload_envelopes_by_{range,root}` answer. + Fetch, +} + #[cfg(test)] mod tests; diff --git a/crates/net/p2p/src/beacon/payload_hash/tests.rs b/crates/net/p2p/src/beacon/payload_hash/tests.rs index f969d2f99..aec6209df 100644 --- a/crates/net/p2p/src/beacon/payload_hash/tests.rs +++ b/crates/net/p2p/src/beacon/payload_hash/tests.rs @@ -380,9 +380,12 @@ fn a_gloas_mismatch_is_counted_but_not_refused() { let mut changed = envelope(); changed.message.payload.gas_used += 1; assert!(verify_envelope(&changed).is_err()); - assert_eq!(envelope_verdict(Outcome::Accept, &changed), Outcome::Accept); - let queued = Outcome::Queue(QueueReason::StateNotCached); - assert_eq!(envelope_verdict(queued, &changed), queued); + for source in [EnvelopeSource::Gossip, EnvelopeSource::Fetch] { + let accepted = envelope_verdict(Outcome::Accept, &changed, source); + assert_eq!(accepted, Outcome::Accept, "{source:?}"); + let queued = Outcome::Queue(QueueReason::StateNotCached); + assert_eq!(envelope_verdict(queued, &changed, source), queued); + } } /// Not a check: how long [`verify_block`] takes, copies included, on the real diff --git a/crates/net/p2p/src/beacon/verdict.rs b/crates/net/p2p/src/beacon/verdict.rs index 1963e0cee..f2b327a0b 100644 --- a/crates/net/p2p/src/beacon/verdict.rs +++ b/crates/net/p2p/src/beacon/verdict.rs @@ -40,7 +40,8 @@ use spawned_concurrency::message::Message; use spawned_concurrency::tasks::{Context, Handler}; use tracing::{debug, error, warn}; -use crate::beacon::{builder_market, column_checks, payload_hash}; +use crate::beacon::payload_hash::{self, EnvelopeSource}; +use crate::beacon::{builder_market, column_checks}; use crate::gossipsub::operation_kind; use crate::{P2PServer, metrics}; @@ -150,7 +151,7 @@ impl Validated { } => gossip::attestation::stateful_checks(store, attestation, *subnet_id), Self::Envelope(envelope) => { let outcome = gossip::envelope::stateful_checks(store, envelope); - payload_hash::envelope_verdict(outcome, envelope) + payload_hash::envelope_verdict(outcome, envelope, EnvelopeSource::Gossip) } Self::ExecutionPayloadBid { bid, market } => { gossip::execution_payload_bid::stateful_checks(store, market, bid) From 17b4e41e0416057b418dbce22f6053799d3427ff Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1s=20Gr=C3=BCner?= <47506558+MegaRedHand@users.noreply.github.com> Date: Thu, 19 Nov 2026 17:15:41 -0300 Subject: [PATCH 18/18] docs: say which topics share the payload hash's permit pool The cost bullet gave the 128 gossip_validation_permits as the bound on concurrent hashing without saying what else draws from them. It is data columns and envelopes only; the attestation, sync committee and builder topics have pools of their own. The bullet also says what each log line names, and that fetched envelopes log at debug. --- docs/spec_deviations.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/spec_deviations.md b/docs/spec_deviations.md index 088be8a92..9dae49a59 100644 --- a/docs/spec_deviations.md +++ b/docs/spec_deviations.md @@ -594,11 +594,15 @@ counted. already in validation are not covered: a proposer that publishes several signed equivocations at once has each hashed until the first verdict lands, up to the 128 `gossip_validation_permits` at a time (a message arriving with - none free is forwarded unhashed under `Overloaded`). The signature check has - the same window; only its per-block cost is smaller. + none free is forwarded unhashed under `Overloaded`). That pool is shared with + data columns and envelopes only: the attestation, sync committee and builder + topics have pools of their own. The signature check has the same window; + only its per-block cost is smaller. `lean_beacon_payload_block_hash_mismatch_total{kind}` counts mismatches - (`block` IGNOREd, `envelope` counted only) and a `warn!` names the slot and - root. + (`block` IGNOREd, `envelope` counted only). A `warn!` names the slot, + proposer and root of a block, and the slot and root of a gossip envelope; a + fetched envelope's mismatch is logged at `debug`, so a sync does not log one + per envelope. - **Equivalence:** a stricter filter, never a looser one, as long as this header encoding is the execution layer's: every block it ignores then carries a payload the execution client would call `INVALID`. The real-chain