Struct Transaction

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

A builder-like object that will allow specifying various actions to be performed in a single transaction. For details on each of the actions, find them in NEAR transactions.

All actions are performed on the account specified by receiver_id.

Implementations

impl<'a> Transaction<'a>

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

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.

impl Transaction<'_>

pub fn add_key(self, pk: PublicKey, ak: AccessKey) -> Self

Adds a key to the receiver_id’s account, where the public key can be used later to delete the same key.

pub fn call(self, function: Function) -> Self

Call into the receiver_id’s contract with the specific function arguments.

pub fn create_account(self) -> Self

Create a new account with the account id being receiver_id.

pub fn delete_account(self, beneficiary_id: &AccountId) -> Self

Deletes the receiver_id’s account. The beneficiary specified by beneficiary_id will receive the funds of the account deleted.

pub fn delete_key(self, pk: PublicKey) -> Self

Deletes a key from the receiver_id’s account, where the public key is associated with the access key to be deleted.

pub fn deploy(self, code: &[u8]) -> Self

Deploy contract code or WASM bytes to the receiver_id’s account.

pub fn stake(self, stake: NearToken, pk: PublicKey) -> Self

An action which stakes the signer’s tokens and setups a validator public key.

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

Transfer deposit amount from signer’s account into receiver_id’s account.

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.

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.