Struct Transaction

pub struct Transaction;

Transaction related functionality.

This struct provides ability to interact with transactions.

Implementations

impl Transaction

pub const fn construct( signer_id: AccountId, receiver_id: AccountId, ) -> ConstructTransaction

Constructs a new transaction builder with the given signer and receiver IDs. This pattern is useful for batching actions into a single transaction.

This is the low level interface for constructing transactions. It is designed to be used in scenarios where more control over the transaction process is required.

Example

This example constructs a transaction with a two transfer actions.

use near_api::*;
use near_primitives::transaction::{Action, TransferAction};

let signer = Signer::new(Signer::from_ledger())?;

let transaction_result: near_primitives::views::FinalExecutionOutcomeView = Transaction::construct(
    "sender.near".parse()?,
    "receiver.near".parse()?
)
.add_action(Action::Transfer(
    TransferAction {
        deposit: NearToken::from_near(1).as_yoctonear(),
    },
))
.add_action(Action::Transfer(
    TransferAction {
        deposit: NearToken::from_near(1).as_yoctonear(),
    },
))
.with_signer(signer)
.send_to_mainnet()
.await?;

pub async fn sign_transaction( unsigned_tx: Transaction, signer: Arc<Signer>, ) -> Result<ExecuteSignedTransaction, SignerError>

Signs a transaction with the given signer.

This provides ability to sign custom constructed pre-populated transactions.

Examples

use near_api::*;
use near_primitives::transaction::{Action, TransferAction};

let signer = Signer::new(Signer::from_ledger())?;

let transaction_result: near_primitives::views::FinalExecutionOutcomeView = Transaction::sign_transaction(
    unsigned_tx,
    signer
)
.await?
.send_to_mainnet()
.await?;

Trait Implementations

impl Clone for Transaction

fn clone(&self) -> Transaction

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Transaction

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.