Struct TransactionBuilder 

pub struct TransactionBuilder { /* private fields */ }

A builder for constructing transactions.

Example

use aptos_sdk::transaction::{TransactionBuilder, EntryFunction};
use aptos_sdk::types::{AccountAddress, ChainId};

let payload = EntryFunction::apt_transfer(
    AccountAddress::from_hex("0x123").unwrap(),
    1000,
).unwrap();

let txn = TransactionBuilder::new()
    .sender(AccountAddress::ONE)
    .sequence_number(0)
    .payload(payload.into())
    .chain_id(ChainId::testnet())
    .build()
    .unwrap();

Implementations

impl TransactionBuilder

pub fn new() -> Self

Creates a new transaction builder with default values.

pub fn sender(self, sender: AccountAddress) -> Self

Sets the sender address.

pub fn sequence_number(self, sequence_number: u64) -> Self

Sets the sequence number.

pub fn payload(self, payload: TransactionPayload) -> Self

Sets the transaction payload.

pub fn max_gas_amount(self, max_gas_amount: u64) -> Self

Sets the maximum gas amount.

pub fn gas_unit_price(self, gas_unit_price: u64) -> Self

Sets the gas unit price in octas.

pub fn expiration_timestamp_secs(self, expiration_timestamp_secs: u64) -> Self

Sets the expiration timestamp in seconds since Unix epoch.

pub fn expiration_from_now(self, seconds: u64) -> Self

Sets the expiration time relative to now.

Uses saturating arithmetic to handle edge cases like system time going backwards.

pub fn chain_id(self, chain_id: ChainId) -> Self

Sets the chain ID.

pub fn build(self) -> AptosResult<RawTransaction>

Builds the raw transaction.

Errors

Returns an error if any required field is missing:

• sender is required
• sequence_number is required
• payload is required
• chain_id is required

pub fn build_and_sign<A: Account>( self, account: &A, ) -> AptosResult<SignedTransaction>

Available on crate feature ed25519 only.

Builds and signs the transaction with the given account.

Errors

Returns an error if the transaction cannot be built or signed.

Trait Implementations

impl Clone for TransactionBuilder

fn clone(&self) -> TransactionBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TransactionBuilder

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

Formats the value using the given formatter.

impl Default for TransactionBuilder

fn default() -> Self

Returns the “default value” for a type.