feat(payload): expose built payload block access list (#23860)

Author: mattsse

crates/ethereum/engine-primitives/src/payload.rs

@@ -242,6 +242,10 @@ impl<N: NodePrimitives> BuiltPayload for EthBuiltPayload<N> {
         self.fees
     }
 
+    fn block_access_list(&self) -> Option<&Bytes> {
+        self.block_access_list.as_ref()
+    }
+
     fn requests(&self) -> Option<Requests> {
         self.requests.clone()
     }

crates/payload/basic/src/stack.rs

@@ -3,7 +3,7 @@ use crate::{
     PayloadConfig,
 };
 
-use alloy_primitives::{B256, U256};
+use alloy_primitives::{Bytes, B256, U256};
 use reth_payload_builder::PayloadId;
 use reth_payload_primitives::{BuiltPayload, PayloadAttributes};
 use reth_primitives_traits::{NodePrimitives, SealedBlock};
@@ -135,6 +135,13 @@ where
         }
     }
 
+    fn block_access_list(&self) -> Option<&Bytes> {
+        match self {
+            Self::Left(l) => l.block_access_list(),
+            Self::Right(r) => r.block_access_list(),
+        }
+    }
+
     fn requests(&self) -> Option<Requests> {
         match self {
             Self::Left(l) => l.requests(),

crates/payload/primitives/src/traits.rs

@@ -3,7 +3,7 @@
 use crate::PayloadBuilderError;
 use alloc::{boxed::Box, sync::Arc, vec::Vec};
 use alloy_eips::{eip4895::Withdrawal, eip7685::Requests};
-use alloy_primitives::{B256, U256};
+use alloy_primitives::{Bytes, B256, U256};
 use alloy_rlp::Encodable;
 use alloy_rpc_types_engine::{PayloadAttributes as EthPayloadAttributes, PayloadId};
 use core::fmt;
@@ -81,6 +81,13 @@ pub trait BuiltPayload: Send + Sync + fmt::Debug {
     /// Returns the total fees collected from all transactions in this block.
     fn fees(&self) -> U256;
 
+    /// Returns the EIP-7928 block access list included in this payload.
+    ///
+    /// Returns `None` for payloads that do not carry a block access list.
+    fn block_access_list(&self) -> Option<&Bytes> {
+        None
+    }
+
     /// Returns the complete execution result including state updates.
     ///
     /// Returns `None` if execution data is not available or not tracked.