Trait TrackingCopyExt

pub trait TrackingCopyExt<R> {
    type Error;

    // Required methods
    fn read_account_key(
        &mut self,
        account_hash: AccountHash,
    ) -> Result<Key, Self::Error>;
    fn get_block_time(&self) -> Result<Option<BlockTime>, Self::Error>;
    fn get_balance_hold_config(
        &self,
        hold_kind: BalanceHoldAddrTag,
    ) -> Result<Option<(BlockTime, HoldBalanceHandling, u64)>, Self::Error>;
    fn get_purse_balance_key(&self, purse_key: Key) -> Result<Key, Self::Error>;
    fn get_balance_hold_addresses(
        &self,
        purse_addr: URefAddr,
    ) -> Result<Vec<BalanceHoldAddr>, Self::Error>;
    fn get_total_balance(&self, key: Key) -> Result<Motes, Self::Error>;
    fn get_available_balance(
        &mut self,
        balance_key: Key,
    ) -> Result<Motes, Self::Error>;
    fn get_purse_balance_key_with_proof(
        &self,
        purse_key: Key,
    ) -> Result<(Key, TrieMerkleProof<Key, StoredValue>), Self::Error>;
    fn get_total_balance_with_proof(
        &self,
        balance_key: Key,
    ) -> Result<(U512, TrieMerkleProof<Key, StoredValue>), Self::Error>;
    fn clear_expired_balance_holds(
        &mut self,
        purse_addr: URefAddr,
        filter: Vec<(BalanceHoldAddrTag, HoldsEpoch)>,
    ) -> Result<(), Self::Error>;
    fn get_balance_holds(
        &mut self,
        purse_addr: URefAddr,
        block_time: BlockTime,
        interval: u64,
    ) -> Result<BTreeMap<BlockTime, BalanceHolds>, Self::Error>;
    fn get_balance_holds_with_proof(
        &self,
        purse_addr: URefAddr,
    ) -> Result<BTreeMap<BlockTime, BalanceHoldsWithProof>, Self::Error>;
    fn get_message_topics(
        &self,
        entity_addr: EntityAddr,
    ) -> Result<MessageTopics, Self::Error>;
    fn get_named_keys(
        &self,
        entity_addr: EntityAddr,
    ) -> Result<NamedKeys, Self::Error>;
    fn get_v1_entry_points(
        &self,
        entity_addr: EntityAddr,
    ) -> Result<EntryPoints, Self::Error>;
    fn get_package(
        &mut self,
        package_hash: HashAddr,
    ) -> Result<Package, Self::Error>;
    fn get_contract(
        &mut self,
        contract_hash: ContractHash,
    ) -> Result<Contract, Self::Error>;
    fn get_system_entity_registry(
        &self,
    ) -> Result<SystemHashRegistry, Self::Error>;
    fn get_checksum_registry(
        &mut self,
    ) -> Result<Option<ChecksumRegistry>, Self::Error>;
    fn get_byte_code(
        &mut self,
        byte_code_hash: ByteCodeHash,
    ) -> Result<ByteCode, Self::Error>;
}

Higher-level operations on the state via a TrackingCopy.

Required Associated Types

type Error

The type for the returned errors.

Required Methods

fn read_account_key( &mut self, account_hash: AccountHash, ) -> Result<Key, Self::Error>

Reads the entity key for a given account hash.

fn get_block_time(&self) -> Result<Option<BlockTime>, Self::Error>

Returns block time associated with checked out root hash.

fn get_balance_hold_config( &self, hold_kind: BalanceHoldAddrTag, ) -> Result<Option<(BlockTime, HoldBalanceHandling, u64)>, Self::Error>

Returns balance hold configuration settings for imputed kind of balance hold.

fn get_purse_balance_key(&self, purse_key: Key) -> Result<Key, Self::Error>

Gets the purse balance key for a given purse.

fn get_balance_hold_addresses( &self, purse_addr: URefAddr, ) -> Result<Vec<BalanceHoldAddr>, Self::Error>

Gets the balance hold keys for the imputed purse (if any).

fn get_total_balance(&self, key: Key) -> Result<Motes, Self::Error>

Returns total balance.

fn get_available_balance( &mut self, balance_key: Key, ) -> Result<Motes, Self::Error>

Returns the available balance, considering any holds from holds_epoch to now.

fn get_purse_balance_key_with_proof( &self, purse_key: Key, ) -> Result<(Key, TrieMerkleProof<Key, StoredValue>), Self::Error>

Gets the purse balance key for a given purse and provides a Merkle proof.

fn get_total_balance_with_proof( &self, balance_key: Key, ) -> Result<(U512, TrieMerkleProof<Key, StoredValue>), Self::Error>

Gets the balance at a given balance key and provides a Merkle proof.

fn clear_expired_balance_holds( &mut self, purse_addr: URefAddr, filter: Vec<(BalanceHoldAddrTag, HoldsEpoch)>, ) -> Result<(), Self::Error>

Clear expired balance holds.

fn get_balance_holds( &mut self, purse_addr: URefAddr, block_time: BlockTime, interval: u64, ) -> Result<BTreeMap<BlockTime, BalanceHolds>, Self::Error>

Gets the balance holds for a given balance, without Merkle proofs.

fn get_balance_holds_with_proof( &self, purse_addr: URefAddr, ) -> Result<BTreeMap<BlockTime, BalanceHoldsWithProof>, Self::Error>

Gets the balance holds for a given balance, with Merkle proofs.

fn get_message_topics( &self, entity_addr: EntityAddr, ) -> Result<MessageTopics, Self::Error>

Returns the collection of message topics (if any) for a given HashAddr.

fn get_named_keys( &self, entity_addr: EntityAddr, ) -> Result<NamedKeys, Self::Error>

Returns the collection of named keys for a given AddressableEntity.

fn get_v1_entry_points( &self, entity_addr: EntityAddr, ) -> Result<EntryPoints, Self::Error>

Returns the collection of entry points for a given AddresableEntity.

fn get_package( &mut self, package_hash: HashAddr, ) -> Result<Package, Self::Error>

Gets a package by hash.

fn get_contract( &mut self, contract_hash: ContractHash, ) -> Result<Contract, Self::Error>

Get a Contract record.

fn get_system_entity_registry(&self) -> Result<SystemHashRegistry, Self::Error>

Gets the system entity registry.

fn get_checksum_registry( &mut self, ) -> Result<Option<ChecksumRegistry>, Self::Error>

Gets the system checksum registry.

fn get_byte_code( &mut self, byte_code_hash: ByteCodeHash, ) -> Result<ByteCode, Self::Error>

Gets byte code by hash.

Implementors

impl<R> TrackingCopyExt<R> for TrackingCopy<R>

where R: StateReader<Key, StoredValue, Error = Error>,

type Error = Error