Struct PreCachedDB 

pub struct PreCachedDB {
    pub inner: Arc<RwLock<PreCachedDBInner>>,
}

Fields

inner: Arc<RwLock<PreCachedDBInner>>

Cached inner data

inner encapsulates PreCachedDBInner using RwLock for safe concurrent read or exclusive write access to the data and Arc for shared ownership of the lock across threads.

Implementations

impl PreCachedDB

pub fn new() -> Result<Self, PreCachedDBError>

Create a new PreCachedDB instance

pub fn update( &self, account_updates: Vec<AccountUpdate>, block: Option<BlockHeader>, ) -> Result<(), PreCachedDBError>

pub fn get_storage(&self, address: &Address, index: &U256) -> Option<U256>

Retrieves the storage value at the specified index for the given account, if it exists.

If the account exists in the storage, the storage value at the specified index is returned as a reference. Temp storage takes priority over permanent storage. If the account does not exist, None is returned.

Arguments

• address: A reference to the address of the account to retrieve the storage value from.
• index: A reference to the index of the storage value to retrieve.

Returns

Returns an Option containing a reference to the storage value if it exists, otherwise returns None.

pub fn update_state( &mut self, updates: &HashMap<Address, StateUpdate>, block: BlockHeader, ) -> Result<HashMap<Address, StateUpdate>, PreCachedDBError>

Update the simulation state.

This method modifies the current state of the simulation by applying the provided updates to the accounts in the smart contract storage. These changes correspond to a particular block in the blockchain.

Arguments

• new_state: A struct containing all the state changes for a particular block.

pub fn block_number(&self) -> Result<Option<u64>, PreCachedDBError>

If block is set, returns the number. Otherwise returns None.

pub fn clear(&self) -> Result<(), PreCachedDBError>

Clear all state from the database.

Trait Implementations

impl Clone for PreCachedDB

fn clone(&self) -> PreCachedDB

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl DatabaseRef for PreCachedDB

fn basic_ref( &self, address: Address, ) -> Result<Option<AccountInfo>, Self::Error>

Retrieves basic information about an account.

This function retrieves the basic account information for the specified address.

Arguments

• address: The address of the account to retrieve the information for.

Returns

Returns a Result containing the account information or an error if the account is not found.

fn storage_ref( &self, address: Address, index: U256, ) -> Result<U256, Self::Error>

Retrieves the storage value at the specified address and index.

Arguments

• address: The address of the contract to retrieve the storage value from.
• index: The index of the storage value to retrieve.

Returns

Returns a Result containing the storage value if it exists.

Errors

Returns an error if the storage value is not found.

fn block_hash_ref(&self, _number: u64) -> Result<B256, Self::Error>

If block header is set, returns the hash. Otherwise, returns a zero hash.

type Error = PreCachedDBError

The database error type.

fn code_by_hash_ref(&self, code_hash: B256) -> Result<Bytecode, Self::Error>

Gets account code by its hash.

impl Debug for PreCachedDB

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

Formats the value using the given formatter.

impl EngineDatabaseInterface for PreCachedDB

fn init_account( &self, address: Address, account: AccountInfo, permanent_storage: Option<HashMap<U256, U256>>, _mocked: bool, ) -> Result<(), <Self as EngineDatabaseInterface>::Error>

Sets up a single account

Full control over setting up an accounts. Allows to set up EOAs as well as smart contracts.

Arguments

• address - Address of the account
• account - The account information
• permanent_storage - Storage to init the account with, this storage can only be updated manually

fn clear_temp_storage( &mut self, ) -> Result<(), <Self as EngineDatabaseInterface>::Error>

Deprecated in TychoDB

type Error = PreCachedDBError

fn get_current_block(&self) -> Option<BlockHeader>

Gets the block header that this database is operating at.