Struct BlockchainWrapper

pub struct BlockchainWrapper<A>
where
    A: BlockchainApi + ManagedTypeApi + ErrorApi,
{ /* private fields */ }

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.

Implementations

impl<A> BlockchainWrapper<A>

where A: BlockchainApi + ManagedTypeApi + ErrorApi,

pub fn new() -> Self

pub fn get_caller_legacy(&self) -> Address

👎Deprecated since 0.41.0: Please use method get_caller instead.

pub fn get_caller(&self) -> ManagedAddress<A>

pub fn get_sc_address_legacy(&self) -> Address

👎Deprecated since 0.41.0: Please use method get_sc_address instead.

pub fn get_sc_address(&self) -> ManagedAddress<A>

pub fn get_owner_address(&self) -> ManagedAddress<A>

pub fn check_caller_is_owner(&self)

pub fn check_caller_is_user_account(&self)

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

👎Deprecated since 0.41.0: Please use method get_shard_of_address instead.

pub fn get_shard_of_address(&self, address: &ManagedAddress<A>) -> u32

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

👎Deprecated since 0.41.0: Please use method is_smart_contract instead.

pub fn is_smart_contract(&self, address: &ManagedAddress<A>) -> bool

pub fn get_balance_legacy(&self, address: &Address) -> BigUint<A>

👎Deprecated since 0.41.0: Please use method get_balance instead.

pub fn get_balance(&self, address: &ManagedAddress<A>) -> BigUint<A>

pub fn get_code_metadata(&self, address: &ManagedAddress<A>) -> CodeMetadata

pub fn is_builtin_function(&self, function_name: &ManagedBuffer<A>) -> bool

pub fn get_sc_balance( &self, token: &EgldOrEsdtTokenIdentifier<A>, nonce: u64, ) -> BigUint<A>

pub fn get_state_root_hash_legacy(&self) -> H256

👎Deprecated since 0.41.0: Please use method get_state_root_hash instead.

pub fn get_state_root_hash(&self) -> ManagedByteArray<A, 32>

pub fn get_tx_hash_legacy(&self) -> H256

👎Deprecated since 0.41.0: Please use method get_tx_hash instead.

pub fn get_tx_hash(&self) -> ManagedByteArray<A, 32>

pub fn get_gas_left(&self) -> u64

pub fn get_block_timestamp(&self) -> u64

pub fn get_block_nonce(&self) -> u64

pub fn get_block_round(&self) -> u64

pub fn get_block_epoch(&self) -> u64

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

👎Deprecated since 0.41.0: Please use method get_block_random_seed instead.

pub fn get_block_random_seed(&self) -> ManagedByteArray<A, 48>

pub fn get_prev_block_timestamp(&self) -> u64

pub fn get_prev_block_nonce(&self) -> u64

pub fn get_prev_block_round(&self) -> u64

pub fn get_prev_block_epoch(&self) -> u64

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

👎Deprecated since 0.41.0: Please use method get_prev_block_random_seed instead.

pub fn get_prev_block_random_seed(&self) -> ManagedByteArray<A, 48>

pub fn get_current_esdt_nft_nonce( &self, address: &ManagedAddress<A>, token_id: &TokenIdentifier<A>, ) -> u64

pub fn get_esdt_balance( &self, address: &ManagedAddress<A>, token_id: &TokenIdentifier<A>, nonce: u64, ) -> BigUint<A>

pub fn get_esdt_token_data( &self, address: &ManagedAddress<A>, token_id: &TokenIdentifier<A>, nonce: u64, ) -> EsdtTokenData<A>

pub fn get_back_transfers(&self) -> BackTransfers<A>

Retrieves back-transfers from the VM, after a contract call.

Works after:

• synchronous calls
• asynchronous calls too, in callbacks.

pub fn get_token_attributes<T: TopDecode>( &self, token_id: &TokenIdentifier<A>, token_nonce: u64, ) -> T

Retrieves and deserializes token attributes from the SC account, with given token identifier and nonce.

pub fn is_esdt_frozen( &self, address: &ManagedAddress<A>, token_id: &TokenIdentifier<A>, nonce: u64, ) -> bool

pub fn is_esdt_paused(&self, token_id: &TokenIdentifier<A>) -> bool

pub fn is_esdt_limited_transfer(&self, token_id: &TokenIdentifier<A>) -> bool

pub fn get_esdt_local_roles( &self, token_id: &TokenIdentifier<A>, ) -> EsdtLocalRoleFlags

impl<A> BlockchainWrapper<A>

where A: BlockchainApi + StorageReadApi + ManagedTypeApi + ErrorApi,

pub fn get_cumulated_validator_rewards(&self) -> BigUint<A>

Retrieves validator rewards, as set by the protocol.

Trait Implementations

impl<A> Default for BlockchainWrapper<A>

where A: BlockchainApi + ManagedTypeApi + ErrorApi + Default,

fn default() -> BlockchainWrapper<A>

Returns the “default value” for a type.