Struct OracleL2ChainProvider

pub struct OracleL2ChainProvider<T: CommsClient> { /* private fields */ }

The oracle-backed L2 chain provider for the client program.

Implementations

impl<T: CommsClient> OracleL2ChainProvider<T>

pub const fn new( l2_head: B256, rollup_config: Arc<RollupConfig>, oracle: Arc<T>, ) -> Self

Creates a new OracleL2ChainProvider with the given boot information and oracle client.

pub fn set_chain_id(&mut self, chain_id: Option<u64>)

Sets the L2 chain ID to use for the provider’s hints.

pub fn set_cursor(&mut self, cursor: Arc<RwLock<PipelineCursor>>)

Updates the derivation pipeline cursor

pub async fn l2_safe_head(&self) -> Result<B256, OracleProviderError>

Fetches the latest known safe head block hash according to the derivation pipeline cursor or uses the initial l2_head value if no cursor is set.

Trait Implementations

impl<T: CommsClient + Send + Sync> BatchValidationProvider for OracleL2ChainProvider<T>

type Error = OracleProviderError

The error type for the BatchValidationProvider.

fn l2_block_info_by_number<'life0, 'async_trait>( &'life0 mut self, number: u64, ) -> Pin<Box<dyn Future<Output = Result<L2BlockInfo, Self::Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns the L2BlockInfo given a block number.

fn block_by_number<'life0, 'async_trait>( &'life0 mut self, number: u64, ) -> Pin<Box<dyn Future<Output = Result<OpBlock, Self::Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns the OpBlock for a given number.

impl<T: Clone + CommsClient> Clone for OracleL2ChainProvider<T>

fn clone(&self) -> OracleL2ChainProvider<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug + CommsClient> Debug for OracleL2ChainProvider<T>

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

Formats the value using the given formatter.

impl<T: CommsClient + Send + Sync> L2ChainProvider for OracleL2ChainProvider<T>

type Error = OracleProviderError

The error type for the L2ChainProvider.

fn system_config_by_number<'life0, 'async_trait>( &'life0 mut self, number: u64, rollup_config: Arc<RollupConfig>, ) -> Pin<Box<dyn Future<Output = Result<SystemConfig, <Self as L2ChainProvider>::Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns the SystemConfig by L2 number.

impl<T: CommsClient> TrieDBProvider for OracleL2ChainProvider<T>

fn bytecode_by_hash(&self, hash: B256) -> Result<Bytes, OracleProviderError>

Fetches the preimage of the bytecode hash provided.

fn header_by_hash(&self, hash: B256) -> Result<Header, OracleProviderError>

Fetches the preimage of Header hash provided.

impl<T: CommsClient> TrieHinter for OracleL2ChainProvider<T>

type Error = OracleProviderError

The error type for hinting trie node preimages.

fn hint_trie_node(&self, hash: B256) -> Result<(), Self::Error>

Hints the host to fetch the trie node preimage by hash.

fn hint_account_proof( &self, address: Address, block_number: u64, ) -> Result<(), Self::Error>

Hints the host to fetch the trie node preimages on the path to the given address.

fn hint_storage_proof( &self, address: Address, slot: U256, block_number: u64, ) -> Result<(), Self::Error>

Hints the host to fetch the trie node preimages on the path to the storage slot within the given account’s storage trie.

fn hint_execution_witness( &self, parent_hash: B256, op_payload_attributes: &OpPayloadAttributes, ) -> Result<(), Self::Error>

Hints the host to fetch the execution witness for the OpPayloadAttributes applied on top of the parent block’s state.

impl<T: CommsClient> TrieProvider for OracleL2ChainProvider<T>

type Error = OracleProviderError

The error type for fetching trie node preimages.

fn trie_node_by_hash(&self, key: B256) -> Result<TrieNode, OracleProviderError>

Fetches the preimage for the given trie node hash.