Struct DataContractCache 

pub struct DataContractCache { /* private fields */ }

DataContract cache that handles both global and block data

Implementations

impl DataContractCache

pub fn new( global_cache_max_capacity: u64, block_cache_max_capacity: u64, ) -> Self

Create a new DataContract cache instance

pub fn insert( &self, fetch_info: Arc<DataContractFetchInfo>, is_block_cache: bool, )

Inserts DataContract to block cache otherwise to goes to global cache

The insert is skipped if the cache already holds the same contract at a higher version. Contract versions increase strictly monotonically — the data contract update transition enforces new == old + 1, and system contract migrations bump the version — so an insert carrying a lower version is always a delayed writer racing a newer copy in, never fresh information. CONSENSUS-CRITICAL: a read-only query thread fetches from committed state without a transaction and populates the global cache from what it read. If such a thread reads a contract, gets descheduled while block execution rewrites that contract, and performs its insert after the block cache is promoted, an unconditional insert would clobber the newer contract with the stale one — and block execution would then serialize documents against a different contract than a node whose cache was cold, producing a different app hash from the same block. The check-and-insert is atomic per key via moka’s compute API, so there is no window between the version comparison and the write. Same-version inserts still overwrite: re-inserting an identical contract with a freshly calculated fee is the normal cache-hit fee path.

pub fn get( &self, contract_id: [u8; 32], is_block_cache: bool, ) -> Option<Arc<DataContractFetchInfo>>

Tries to get a data contract from block cache if present if block cache doesn’t have the contract then it tries get the contract from global cache

pub fn remove(&self, contract_id: [u8; 32])

Remove contract from both block and global cache

pub fn merge_and_clear_block_cache(&self)

Move block cache to global cache

pub fn clear_block_cache(&self)

Clear block cache

pub fn clear(&self)

Clear cache