From 8d19a364925ac4a0b45cc223eb9a313e8c4da8b0 Mon Sep 17 00:00:00 2001 From: phrwlk Date: Wed, 7 Jan 2026 16:09:54 +0200 Subject: [PATCH] docs: clarify pending pending_block build_block docs (#20800) --- crates/rpc/rpc-eth-api/src/helpers/pending_block.rs | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/crates/rpc/rpc-eth-api/src/helpers/pending_block.rs b/crates/rpc/rpc-eth-api/src/helpers/pending_block.rs index 830d066a09..3fad2ae01f 100644 --- a/crates/rpc/rpc-eth-api/src/helpers/pending_block.rs +++ b/crates/rpc/rpc-eth-api/src/helpers/pending_block.rs @@ -216,12 +216,13 @@ pub trait LoadPendingBlock: } } - /// Builds a pending block using the configured provider and pool. + /// Builds a locally derived pending block using the configured provider and pool. /// - /// If the origin is the actual pending block, the block is built with withdrawals. + /// This is used when no execution-layer pending block is available and a pending block is + /// derived from the latest canonical header, using the provided parent. /// - /// After Cancun, if the origin is the actual pending block, the block includes the EIP-4788 pre - /// block contract call using the parent beacon block root received from the CL. + /// Withdrawals and any fork-specific behavior (such as EIP-4788 pre-block contract calls) are + /// determined by the EVM environment and chain specification used during construction. fn build_block( &self, parent: &SealedHeader>,