Struct FunctionCallTransaction

pub struct FunctionCallTransaction<'a> { /* private fields */ }

Implementations

impl FunctionCallTransaction<'_>

pub fn args(self, args: Vec<u8>) -> Self

Provide the arguments for the call. These args are serialized bytes from either a JSON or Borsh serializable set of arguments. To use the more specific versions with better quality of life, use args_json or args_borsh.

pub fn args_json<U: Serialize>(self, args: U) -> Self

Similar to args, specify an argument that is JSON serializable and can be accepted by the equivalent contract. Recommend to use something like serde_json::json! macro to easily serialize the arguments.

pub fn args_borsh<U: BorshSerialize>(self, args: U) -> Self

Similar to args, specify an argument that is borsh serializable and can be accepted by the equivalent contract.

pub fn deposit(self, deposit: NearToken) -> Self

Specify the amount of tokens to be deposited where deposit is the amount of tokens in yocto near.

pub fn gas(self, gas: NearGas) -> Self

Specify the amount of gas to be used.

pub fn max_gas(self) -> Self

Use the maximum amount of gas possible to perform this function call into the contract.

impl FunctionCallTransaction<'_>

pub async fn transact(self) -> Result<ExecutionFinalResult>

Process the transaction, and return the result of the execution.

pub async fn transact_async(self) -> Result<AsyncTransactionStatus>

Send the transaction to the network to be processed. This will be done asynchronously without waiting for the transaction to complete. This returns us a [TransactionStatus] for which we can call into [status] and/or .await to retrieve info about whether the transaction has been completed or not. Note that .await will wait till completion of the transaction.

pub fn retry_exponential(self, base_millis: u64, max_retries: usize) -> Self

Retry this transactions if it fails. This will retry the transaction with exponential backoff. This cannot be used in combination with

pub fn retry( self, strategy: impl Iterator<Item = Duration> + Send + Sync + 'static, ) -> Self

Retry this transactions if it fails. This will retry the transaction with the provided retry strategy.

pub fn wait_until(self, wait_until: TxExecutionStatus) -> Self

Specifies the status to wait until the transaction reaches in the network. The default value is TxExecutionStatus::ExecutedOptimistic if not specified by this function.