Struct TransactionBuilder 

pub struct TransactionBuilder { /* private fields */ }

Transaction builder for creating cross-chain transactions

Implementations

impl TransactionBuilder

pub fn new() -> Self

Create a new transaction builder

pub fn from_substrate_account(self, address: impl Into<String>) -> Self

Set the sender address (Substrate)

Security Note: This method does not validate the address format. Use from_substrate_account_checked() for validated input, or call .build_validated() instead of .build() to validate all addresses before building the transaction.

pub fn from_substrate_account_checked( self, address: impl Into<String>, ) -> Result<Self>

Set the sender address (Substrate) with immediate validation

This validates the SS58 format and checksum immediately. Returns an error if the address is invalid.

pub fn from_evm_address(self, address: impl Into<String>) -> Self

Set the sender address (EVM)

Security Note: This method does not validate the address format. Use from_evm_address_checked() for validated input, or call .build_validated() instead of .build() to validate all addresses before building the transaction.

pub fn from_evm_address_checked( self, address: impl Into<String>, ) -> Result<Self>

Set the sender address (EVM) with immediate validation

This validates the EVM format and EIP-55 checksum immediately. Returns an error if the address is invalid.

pub fn from(self, address: Address) -> Self

Set the sender address

pub fn to_evm_address(self, address: impl Into<String>) -> Self

Set the recipient address (EVM)

Security Note: This method does not validate the address format. Use to_evm_address_checked() for validated input, or call .build_validated() instead of .build() to validate all addresses before building the transaction.

pub fn to_evm_address_checked(self, address: impl Into<String>) -> Result<Self>

Set the recipient address (EVM) with immediate validation

This validates the EVM format and EIP-55 checksum immediately. Returns an error if the address is invalid.

pub fn to_substrate_account(self, address: impl Into<String>) -> Self

Set the recipient address (Substrate)

Security Note: This method does not validate the address format. Use to_substrate_account_checked() for validated input, or call .build_validated() instead of .build() to validate all addresses before building the transaction.

pub fn to_substrate_account_checked( self, address: impl Into<String>, ) -> Result<Self>

Set the recipient address (Substrate) with immediate validation

This validates the SS58 format and checksum immediately. Returns an error if the address is invalid.

pub fn to(self, address: Address) -> Self

Set the recipient address

pub fn amount(self, amount: u128) -> Self

Set the transfer amount

pub fn on_chain(self, chain: Chain) -> Self

Set the source chain

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

Set transaction data/payload

pub fn with_gas_limit(self, limit: u64) -> Self

Set gas limit

pub fn with_nonce(self, nonce: u64) -> Self

Set transaction nonce (for uniqueness and replay protection)

pub fn build(self) -> Result<Transaction>

Build the transaction

Trait Implementations

impl Default for TransactionBuilder

fn default() -> Self

Returns the “default value” for a type.