Trait multiversx_sc::api::BlockchainApiImpl

pub trait BlockchainApiImpl: ManagedTypeApiImpl {
    // Required methods
    fn get_caller_legacy(&self) -> Address;
    fn get_sc_address_legacy(&self) -> Address;
    fn get_owner_address_legacy(&self) -> Address;
    fn get_shard_of_address_legacy(&self, address: &Address) -> u32;
    fn is_smart_contract_legacy(&self, address: &Address) -> bool;
    fn load_balance_legacy(&self, dest: Self::BigIntHandle, address: &Address);
    fn get_state_root_hash_legacy(&self) -> H256;
    fn get_tx_hash_legacy(&self) -> H256;
    fn get_gas_left(&self) -> u64;
    fn get_block_timestamp(&self) -> u64;
    fn get_block_nonce(&self) -> u64;
    fn get_block_round(&self) -> u64;
    fn get_block_epoch(&self) -> u64;
    fn get_block_random_seed_legacy(&self) -> Box<[u8; 48]>;
    fn get_prev_block_timestamp(&self) -> u64;
    fn get_prev_block_nonce(&self) -> u64;
    fn get_prev_block_round(&self) -> u64;
    fn get_prev_block_epoch(&self) -> u64;
    fn get_prev_block_random_seed_legacy(&self) -> Box<[u8; 48]>;
    fn get_current_esdt_nft_nonce(
        &self,
        address_handle: Self::ManagedBufferHandle,
        token_id_handle: Self::ManagedBufferHandle
    ) -> u64;
    fn load_esdt_balance(
        &self,
        address_handle: Self::ManagedBufferHandle,
        token_id_handle: Self::ManagedBufferHandle,
        nonce: u64,
        dest: Self::BigIntHandle
    );
    fn load_esdt_token_data<M: ManagedTypeApi>(
        &self,
        address: &ManagedAddress<M>,
        token_id: &TokenIdentifier<M>,
        nonce: u64
    ) -> EsdtTokenData<M>;
    fn load_esdt_token_data_unmanaged<M: ManagedTypeApi>(
        &self,
        address: &ManagedAddress<M>,
        token_id: &TokenIdentifier<M>,
        nonce: u64
    ) -> EsdtTokenData<M>;
    fn check_esdt_frozen(
        &self,
        address_handle: Self::ManagedBufferHandle,
        token_id_handle: Self::ManagedBufferHandle,
        nonce: u64
    ) -> bool;
    fn check_esdt_paused(
        &self,
        token_id_handle: Self::ManagedBufferHandle
    ) -> bool;
    fn check_esdt_limited_transfer(
        &self,
        token_id_handle: Self::ManagedBufferHandle
    ) -> bool;
    fn load_esdt_local_roles(
        &self,
        token_id_handle: Self::ManagedBufferHandle
    ) -> EsdtLocalRoleFlags;

    // Provided methods
    fn load_caller_managed(&self, dest: Self::ManagedBufferHandle) { ... }
    fn load_sc_address_managed(&self, dest: Self::ManagedBufferHandle) { ... }
    fn load_owner_address_managed(&self, dest: Self::ManagedBufferHandle) { ... }
    fn get_shard_of_address(
        &self,
        address_handle: Self::ManagedBufferHandle
    ) -> u32 { ... }
    fn is_smart_contract(
        &self,
        address_handle: Self::ManagedBufferHandle
    ) -> bool { ... }
    fn load_balance(
        &self,
        dest: Self::BigIntHandle,
        address_handle: Self::ManagedBufferHandle
    ) { ... }
    fn load_state_root_hash_managed(&self, dest: Self::ManagedBufferHandle) { ... }
    fn load_tx_hash_managed(&self, dest: Self::ManagedBufferHandle) { ... }
    fn load_block_random_seed_managed(&self, dest: Self::ManagedBufferHandle) { ... }
    fn load_prev_block_random_seed_managed(
        &self,
        dest: Self::ManagedBufferHandle
    ) { ... }
}

Interface to be used by the actual smart contract code.

Note: contracts and the api are not mutable. They simply pass on/retrieve data to/from the protocol. When mocking the blockchain state, we use the Rc/RefCell pattern to isolate mock state mutability from the contract interface.

Required Methods

fn get_caller_legacy(&self) -> Address

fn get_sc_address_legacy(&self) -> Address

fn get_owner_address_legacy(&self) -> Address

fn get_shard_of_address_legacy(&self, address: &Address) -> u32

fn is_smart_contract_legacy(&self, address: &Address) -> bool

fn load_balance_legacy(&self, dest: Self::BigIntHandle, address: &Address)

fn get_state_root_hash_legacy(&self) -> H256

fn get_tx_hash_legacy(&self) -> H256

fn get_gas_left(&self) -> u64

fn get_block_timestamp(&self) -> u64

fn get_block_nonce(&self) -> u64

fn get_block_round(&self) -> u64

fn get_block_epoch(&self) -> u64

fn get_block_random_seed_legacy(&self) -> Box<[u8; 48]>

fn get_prev_block_timestamp(&self) -> u64

fn get_prev_block_nonce(&self) -> u64

fn get_prev_block_round(&self) -> u64

fn get_prev_block_epoch(&self) -> u64

fn get_prev_block_random_seed_legacy(&self) -> Box<[u8; 48]>

fn get_current_esdt_nft_nonce( &self, address_handle: Self::ManagedBufferHandle, token_id_handle: Self::ManagedBufferHandle ) -> u64

fn load_esdt_balance( &self, address_handle: Self::ManagedBufferHandle, token_id_handle: Self::ManagedBufferHandle, nonce: u64, dest: Self::BigIntHandle )

fn load_esdt_token_data<M: ManagedTypeApi>( &self, address: &ManagedAddress<M>, token_id: &TokenIdentifier<M>, nonce: u64 ) -> EsdtTokenData<M>

fn load_esdt_token_data_unmanaged<M: ManagedTypeApi>( &self, address: &ManagedAddress<M>, token_id: &TokenIdentifier<M>, nonce: u64 ) -> EsdtTokenData<M>

👎Deprecated since 0.31.0: Only used for limited backwards compatibility tests. Never use! Use load_esdt_token_data instead.

fn check_esdt_frozen( &self, address_handle: Self::ManagedBufferHandle, token_id_handle: Self::ManagedBufferHandle, nonce: u64 ) -> bool

fn check_esdt_paused(&self, token_id_handle: Self::ManagedBufferHandle) -> bool

fn check_esdt_limited_transfer( &self, token_id_handle: Self::ManagedBufferHandle ) -> bool

fn load_esdt_local_roles( &self, token_id_handle: Self::ManagedBufferHandle ) -> EsdtLocalRoleFlags

Provided Methods

fn load_caller_managed(&self, dest: Self::ManagedBufferHandle)

fn load_sc_address_managed(&self, dest: Self::ManagedBufferHandle)

fn load_owner_address_managed(&self, dest: Self::ManagedBufferHandle)

fn get_shard_of_address(&self, address_handle: Self::ManagedBufferHandle) -> u32

fn is_smart_contract(&self, address_handle: Self::ManagedBufferHandle) -> bool

fn load_balance( &self, dest: Self::BigIntHandle, address_handle: Self::ManagedBufferHandle )

fn load_state_root_hash_managed(&self, dest: Self::ManagedBufferHandle)

fn load_tx_hash_managed(&self, dest: Self::ManagedBufferHandle)

fn load_block_random_seed_managed(&self, dest: Self::ManagedBufferHandle)

fn load_prev_block_random_seed_managed(&self, dest: Self::ManagedBufferHandle)

Implementors

impl BlockchainApiImpl for UncallableApi