Struct fuel_core::database::vm_database::VmDatabase

pub struct VmDatabase { /* private fields */ }

Used to store metadata relevant during the execution of a transaction

Implementations

impl VmDatabase

pub fn new<T>( database: Database, header: &ConsensusHeader<T>, coinbase: Address ) -> Self

pub fn database_mut(&mut self) -> &mut Database

Trait Implementations

impl Clone for VmDatabase

fn clone(&self) -> VmDatabase

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for VmDatabase

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

Formats the value using the given formatter.

impl Default for VmDatabase

fn default() -> Self

Returns the “default value” for a type.

impl InterpreterStorage for VmDatabase

type DataError = Error

Error implementation for reasons unspecified in the protocol.

fn block_height(&self) -> Result<u32, Self::DataError>

Provide the current block height in which the transactions should be executed.

fn timestamp(&self, height: u32) -> Result<Word, Self::DataError>

Return the timestamp of a given block

fn block_hash(&self, block_height: u32) -> Result<Bytes32, Self::DataError>

Provide the block hash from a given height.

fn coinbase(&self) -> Result<Address, Self::DataError>

Provide the coinbase address for the VM instructions implementation.

fn merkle_contract_state_range( &self, contract_id: &ContractId, start_key: &Bytes32, range: Word ) -> Result<Vec<Option<Cow<'_, Bytes32>>>, Self::DataError>

Fetch a range of values from a key-value mapping in a contract storage. Returns the full range requested using optional values in case a requested slot is unset.

fn merkle_contract_state_insert_range( &mut self, contract_id: &ContractId, start_key: &Bytes32, values: &[Bytes32] ) -> Result<Option<()>, Self::DataError>

Insert a range of key-value mappings into contract storage. Returns None if any of the keys in the range were previously unset.

fn merkle_contract_state_remove_range( &mut self, contract_id: &ContractId, start_key: &Bytes32, range: Word ) -> Result<Option<()>, Self::DataError>

Remove a range of key-values from contract storage. Returns None if any of the keys in the range were already unset.

fn deploy_contract( &mut self, salt: &Salt, slots: &[StorageSlot], contract: &Contract ) -> Result<(), Self::DataError>

Deploy a contract into the storage

fn deploy_contract_with_id( &mut self, salt: &Salt, slots: &[StorageSlot], contract: &Contract, root: &Bytes32, id: &ContractId ) -> Result<(), Self::DataError>

Deploy a contract into the storage with contract id

fn storage_contract( &self, id: &ContractId ) -> Result<Option<Cow<'_, Contract>>, Self::DataError>

Fetch a previously inserted contract code from the chain state for a given contract.

fn storage_contract_insert( &mut self, id: &ContractId, contract: &Contract ) -> Result<Option<Contract>, Self::DataError>

Append a contract to the chain, provided its identifier.

fn storage_contract_exists( &self, id: &ContractId ) -> Result<bool, Self::DataError>

Check if a provided contract exists in the chain.

fn storage_contract_root( &self, id: &ContractId ) -> Result<Option<Cow<'_, (Salt, Bytes32)>>, Self::DataError>

Fetch a previously inserted salt+root tuple from the chain state for a given contract.

fn storage_contract_root_insert( &mut self, id: &ContractId, salt: &Salt, root: &Bytes32 ) -> Result<Option<(Salt, Bytes32)>, Self::DataError>

Append the salt+root of a contract that was appended to the chain.

fn merkle_contract_state( &self, id: &ContractId, key: &Bytes32 ) -> Result<Option<Cow<'_, Bytes32>>, Self::DataError>

Fetch the value form a key-value mapping in a contract storage.

fn merkle_contract_state_insert( &mut self, contract: &ContractId, key: &Bytes32, value: &Bytes32 ) -> Result<Option<Bytes32>, Self::DataError>

Insert a key-value mapping in a contract storage.

fn merkle_contract_state_remove( &mut self, contract: &ContractId, key: &Bytes32 ) -> Result<Option<Bytes32>, Self::DataError>

Remove a key-value mapping from a contract storage.

fn merkle_contract_asset_id_balance( &self, id: &ContractId, asset_id: &AssetId ) -> Result<Option<u64>, Self::DataError>

Fetch the balance of an asset ID in a contract storage.

fn merkle_contract_asset_id_balance_insert( &mut self, contract: &ContractId, asset_id: &AssetId, value: u64 ) -> Result<Option<u64>, Self::DataError>

Update the balance of an asset ID in a contract storage.

impl<K, M: Mappable> MerkleRootStorage<K, M> for VmDatabasewhere Database: MerkleRootStorage<K, M, Error = StorageError>,

fn root(&self, key: &K) -> Result<MerkleRoot, Self::Error>

Return the merkle root of the stored Type in the storage.

impl<M: Mappable> StorageInspect<M> for VmDatabasewhere Database: StorageInspect<M, Error = StorageError>,

type Error = Error

fn get( &self, key: &M::Key ) -> Result<Option<Cow<'_, M::OwnedValue>>, Self::Error>

Retrieve Cow<Value> such as Key->Value.

fn contains_key(&self, key: &M::Key) -> Result<bool, Self::Error>

Return true if there is a Key mapping to a value in the storage.

impl<M: Mappable> StorageMutate<M> for VmDatabasewhere Database: StorageMutate<M, Error = StorageError>,

fn insert( &mut self, key: &M::Key, value: &M::Value ) -> Result<Option<M::OwnedValue>, Self::Error>

Append Key->Value mapping to the storage.

fn remove(&mut self, key: &M::Key) -> Result<Option<M::OwnedValue>, Self::Error>

Remove Key->Value mapping from the storage.