Struct FlashblockRef 

pub struct FlashblockRef {

    pub provider: ProviderRef,
    pub payload_id: Option<FixedBytes<8>>,
    pub index: Option<u64>,
    pub block_number: u64,
    pub content_hash: B256,
    pub partial_block_hash: Option<B256>,
    pub parent_hash: Option<B256>,
    pub state_root: Option<B256>,
    pub transactions_root: Option<B256>,
    pub transaction_hashes: Vec<B256>,
    pub timestamp: Option<u64>,
    pub base_fee_per_gas: Option<u64>,
    pub beneficiary: Option<Address>,
    pub prevrandao: Option<B256>,
    pub gas_limit: Option<u64>,
}

Identity of one cumulative pre-confirmed Flashblock snapshot.

Fields

provider: ProviderRef

Provider session that supplied this snapshot.

payload_id: Option<FixedBytes<8>>

Sequencer payload id shared by every Flashblock in the full block.

Some provider wire shapes omit this indexed-payload identifier.

index: Option<u64>

Zero-based Flashblock index, when exposed by the endpoint.

block_number: u64

Pending block number represented by this cumulative snapshot.

content_hash: B256

Provider-generation-scoped commitment to this exact cumulative view.

This is deliberately not a canonical or provider-reported block hash. It remains non-zero even when a pending endpoint uses the zero hash placeholder permitted by the Flashblocks specification.

partial_block_hash: Option<B256>

Non-placeholder partial block hash reported by the provider, when any.

parent_hash: Option<B256>

Canonical parent of the pending block, when exposed.

state_root: Option<B256>

State root after this cumulative snapshot, when exposed.

transactions_root: Option<B256>

Transaction-trie root committed by a cumulative block-shaped preview.

transaction_hashes: Vec<B256>

Ordered cumulative transaction membership for this preview.

timestamp: Option<u64>

Pending block timestamp, when exposed.

base_fee_per_gas: Option<u64>

Pending EIP-1559 base fee, when exposed.

beneficiary: Option<Address>

Pending block beneficiary / fee recipient, when exposed.

prevrandao: Option<B256>

Pending block randomness value, when exposed.

gas_limit: Option<u64>

Pending block gas limit, when exposed.

Implementations

impl FlashblockRef

pub const fn block_ref(&self) -> BlockRef

Convert the pre-confirmed identity into the block metadata used by ordinary log routing. The hash is the provider-generation-scoped content_hash, never a canonical block hash, and must not advance canonical coverage.

pub fn contains_transaction(&self, transaction_hash: &B256) -> bool

Whether the cumulative preview contains transaction_hash.

Trait Implementations

impl Clone for FlashblockRef

fn clone(&self) -> FlashblockRef

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FlashblockRef

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FlashblockRef

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for FlashblockRef

impl Hash for FlashblockRef

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for FlashblockRef

fn eq(&self, other: &FlashblockRef) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for FlashblockRef

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for FlashblockRef