Struct CachingDatabase 

pub struct CachingDatabase { /* private fields */ }

A database wrapper that caches state lookups for parallel pre-warming.

This enables parallel warming workers to share cached data, and allows the sequential execution phase to reuse warmed state. Reduces redundant database/trie lookups when multiple transactions touch the same accounts.

Thread-safe via RwLock - optimized for read-heavy concurrent access.

This caching database is inspired by reth’s overlay/proof worker cache.

Implementations

impl CachingDatabase

pub fn new(inner: Arc<dyn Database>, precompile_cache_enabled: bool) -> Self

Trait Implementations

impl Database for CachingDatabase

fn get_account_state( &self, address: Address, ) -> Result<AccountState, DatabaseError>

fn get_storage_value( &self, address: Address, key: H256, ) -> Result<U256, DatabaseError>

fn get_block_hash(&self, block_number: u64) -> Result<H256, DatabaseError>

fn get_chain_config(&self) -> Result<ChainConfig, DatabaseError>

fn get_account_code(&self, code_hash: H256) -> Result<Code, DatabaseError>

fn get_code_metadata( &self, code_hash: H256, ) -> Result<CodeMetadata, DatabaseError>

fn precompile_cache(&self) -> Option<&PrecompileCache>

Access the precompile cache, if available at this database layer.

fn prefetch_accounts(&self, addresses: &[Address]) -> Result<(), DatabaseError>

Prefetch a batch of accounts into the cache. Default: sequential fallback.

fn prefetch_storage( &self, keys: &[(Address, H256)], ) -> Result<(), DatabaseError>

Prefetch a batch of storage slots into the cache. Default: sequential fallback.