Struct multiversx_sc::contract_base::SendWrapper

pub struct SendWrapper<A>where
    A: CallTypeApi + StorageReadApi + BlockchainApi,{ /* private fields */ }

API that groups methods that either send EGLD or ESDT, or that call other contracts.

Implementations

impl<A> SendWrapper<A>where A: CallTypeApi + StorageReadApi + BlockchainApi,

pub fn esdt_system_sc_proxy(&self) -> ESDTSystemSmartContractProxy<A>

pub fn contract_call<R>( &self, to: ManagedAddress<A>, endpoint_name: ManagedBuffer<A> ) -> ContractCallNoPayment<A, R>

pub fn direct_egld(&self, to: &ManagedAddress<A>, amount: &BigUint<A>)

Sends EGLD to a given address, directly. Used especially for sending EGLD to regular accounts.

pub fn direct_non_zero_egld(&self, to: &ManagedAddress<A>, amount: &BigUint<A>)

pub fn direct( &self, to: &ManagedAddress<A>, token: &EgldOrEsdtTokenIdentifier<A>, nonce: u64, amount: &BigUint<A> )

Sends either EGLD, ESDT or NFT to the target address, depending on the token identifier and nonce

pub fn direct_esdt_with_gas_limit<D>( &self, to: &ManagedAddress<A>, token_identifier: &TokenIdentifier<A>, nonce: u64, amount: &BigUint<A>, gas: u64, endpoint_name: D, arguments: &[ManagedBuffer<A>] )where D: Into<ManagedBuffer<A>>,

pub fn direct_esdt( &self, to: &ManagedAddress<A>, token_identifier: &TokenIdentifier<A>, nonce: u64, amount: &BigUint<A> )

pub fn direct_non_zero_esdt_payment( &self, to: &ManagedAddress<A>, payment: &EsdtTokenPayment<A> )

pub fn direct_with_gas_limit<D>( &self, to: &ManagedAddress<A>, token: &EgldOrEsdtTokenIdentifier<A>, nonce: u64, amount: &BigUint<A>, gas: u64, endpoint_name: D, arguments: &[ManagedBuffer<A>] )where D: Into<ManagedBuffer<A>>,

pub fn direct_multi( &self, to: &ManagedAddress<A>, payments: &ManagedVec<A, EsdtTokenPayment<A>> )

pub fn transfer_esdt_via_async_call( &self, to: ManagedAddress<A>, token: TokenIdentifier<A>, nonce: u64, amount: BigUint<A> ) -> !

Performs a simple ESDT/NFT transfer, but via async call.
As with any async call, this immediately terminates the execution of the current call.
So only use as the last call in your endpoint.
If you want to perform multiple transfers, use self.send().transfer_multiple_esdt_via_async_call() instead.
Note that EGLD can NOT be transfered with this function.

pub fn transfer_multiple_esdt_via_async_call( &self, to: ManagedAddress<A>, payments: ManagedVec<A, EsdtTokenPayment<A>> ) -> !

pub fn claim_developer_rewards( &self, child_sc_address: ManagedAddress<A> ) -> ContractCallNoPayment<A, ()>

pub fn change_owner_address( &self, child_sc_address: ManagedAddress<A>, new_owner: &ManagedAddress<A> ) -> ContractCallNoPayment<A, ()>

Sends a synchronous call to change a smart contract address.

pub fn call_local_esdt_built_in_function( &self, gas: u64, endpoint_name: &ManagedBuffer<A>, arg_buffer: &ManagedArgBuffer<A> ) -> ManagedVec<A, ManagedBuffer<A>>

Allows synchronously calling a local function by name. Execution is resumed afterwards. You should never have to call this function directly. Use the other specific methods instead.

pub fn esdt_local_mint( &self, token: &TokenIdentifier<A>, nonce: u64, amount: &BigUint<A> )

Allows synchronous minting of ESDT/SFT (depending on nonce). Execution is resumed afterwards. Note that the SC must have the ESDTLocalMint or ESDTNftAddQuantity roles set, or this will fail with “action is not allowed” For SFTs, you must use self.send().esdt_nft_create() before adding additional quantity. This function cannot be used for NFTs.

pub fn esdt_local_burn( &self, token: &TokenIdentifier<A>, nonce: u64, amount: &BigUint<A> )

Allows synchronous burning of ESDT/SFT/NFT (depending on nonce). Execution is resumed afterwards. Note that the SC must have the ESDTLocalBurn or ESDTNftBurn roles set, or this will fail with “action is not allowed”

pub fn esdt_local_burn_multi( &self, payments: &ManagedVec<A, EsdtTokenPayment<A>> )

Allows burning of multiple ESDT tokens at once.

Will execute a synchronous call to the appropriate burn builtin function for each.

pub fn esdt_nft_create<T: TopEncode>( &self, token: &TokenIdentifier<A>, amount: &BigUint<A>, name: &ManagedBuffer<A>, royalties: &BigUint<A>, hash: &ManagedBuffer<A>, attributes: &T, uris: &ManagedVec<A, ManagedBuffer<A>> ) -> u64

Creates a new NFT token of a certain type (determined by token_identifier).
attributes can be any serializable custom struct.
This is a built-in function, so the smart contract execution is resumed after. Must have ESDTNftCreate role set, or this will fail with “action is not allowed”. Returns the nonce of the newly created NFT.

pub fn esdt_nft_create_compact<T: TopEncode>( &self, token: &TokenIdentifier<A>, amount: &BigUint<A>, attributes: &T ) -> u64

pub fn esdt_nft_create_compact_named<T: TopEncode>( &self, token: &TokenIdentifier<A>, amount: &BigUint<A>, name: &ManagedBuffer<A>, attributes: &T ) -> u64

pub fn sell_nft( &self, nft_id: &TokenIdentifier<A>, nft_nonce: u64, nft_amount: &BigUint<A>, buyer: &ManagedAddress<A>, payment_token: &EgldOrEsdtTokenIdentifier<A>, payment_nonce: u64, payment_amount: &BigUint<A> ) -> BigUint<A>

Sends the NFTs to the buyer address and calculates and sends the required royalties to the NFT creator. Returns the payment amount left after sending royalties.

pub fn nft_add_uri( &self, token_id: &TokenIdentifier<A>, nft_nonce: u64, new_uri: ManagedBuffer<A> )

pub fn nft_add_multiple_uri( &self, token_id: &TokenIdentifier<A>, nft_nonce: u64, new_uris: &ManagedVec<A, ManagedBuffer<A>> )

pub fn nft_update_attributes<T: TopEncode>( &self, token_id: &TokenIdentifier<A>, nft_nonce: u64, new_attributes: &T )

Trait Implementations

impl<A> Default for SendWrapper<A>where A: CallTypeApi + StorageReadApi + BlockchainApi + Default,

fn default() -> SendWrapper<A>

Returns the “default value” for a type.