Struct ledger_mob::tx::TransactionHandle

pub struct TransactionHandle<T: Device> { /* private fields */ }

Handle to a hardware wallet configured for transaction execution

See DeviceHandle::transaction to create a TransactionHandle

Implementations

impl<T: Device> TransactionHandle<T>

pub async fn key_image( &self, subaddress_index: u64, tx_out_public_key: &TxOutPublic ) -> Result<KeyImage, Error>

Asynchronously compute key image for a given subaddress and tx_out_public_key.

See [KeyImageComputer] for the public blocking API

impl<T: Device> TransactionHandle<T>

pub async fn memo_sign( &self, sender_subaddress_index: u64, tx_public_key: &TxOutPublic, target_subaddress: PublicSubaddress, memo_type: &[u8; 2], memo_data_sans_hmac: &[u8; 48] ) -> Result<[u8; 16], Error>

Asynchronously compute the HMAC signature for the provided memo and target address.

See [MemoHmacSigner] for the public blocking API.

impl<T: Device> TransactionHandle<T>

pub async fn ring_sign( &self, _message: &[u8], signable_ring: &SignableInputRing, pseudo_output_blinding: Scalar ) -> Result<RingMLSAG, Error>

Asynchronously execute a ring signing operation on ledger hardware.

See [RingSigner] trait for public / blocking API

impl<T: Device> TransactionHandle<T>

pub async fn view_subaddress(&self, index: u64) -> Result<ViewSubaddress, Error>

Asynchronously fetch a view subaddress by subaddress index, inheriting the account index from the transaction context.

See [Subaddress] trait for public (blocking) API

impl<T: Device + Send> TransactionHandle<T>

pub async fn set_tx_summary( &mut self, block_version: BlockVersion, message: &[u8], summary: &TxSummary, unblinding: &TxSummaryUnblindingData ) -> Result<(), Error>

Load tx summary for signing operation, alternative to set_message for block versions > 3

impl<T: Device + Send> TransactionHandle<T>

pub async fn new( info: TxConfig, transport: Arc<Mutex<T>> ) -> Result<Self, Error>

Initialise a new transaction over the provided device

pub async fn set_message(&mut self, m: &[u8]) -> Result<(), Error>

Set message for transaction

pub async fn await_approval(&mut self, timeout_s: u32) -> Result<(), Error>

Await on-device transaction approval

pub async fn complete(self) -> Result<(), Error>

Signal transaction completion

Trait Implementations

impl<T: Device + Send> Device for TransactionHandle<T>

Exchange impl on transaction context

fn request<'a, 'b, 'life0, 'async_trait, RESP>( &'life0 mut self, request: impl 'async_trait + ApduReq<'a> + Send, buff: &'b mut [u8], timeout: Duration ) -> Pin<Box<dyn Future<Output = Result<RESP, Error>> + Send + 'async_trait>>where RESP: 'async_trait + ApduBase<'b>, Self: 'async_trait, 'a: 'async_trait, 'b: 'async_trait, 'life0: 'async_trait,

Helper for executing transactions with the device

fn app_info<'life0, 'async_trait>( &'life0 mut self, timeout: Duration ) -> Pin<Box<dyn Future<Output = Result<AppInfo, Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Self: Send + 'async_trait,

Fetch application information

fn device_info<'life0, 'async_trait>( &'life0 mut self, timeout: Duration ) -> Pin<Box<dyn Future<Output = Result<DeviceInfo, Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Self: Send + 'async_trait,

Fetch device information

impl<T: Device> KeyImageComputer for TransactionHandle<T>

Sync [KeyImageComputer] implementation for TransactionHandle

Note: this MUST be called from a tokio context

fn compute_key_image( &self, subaddress_index: u64, tx_out_public_key: &TxOutPublic ) -> Result<KeyImage, Self::Error>

Compute key image for a given subaddress and tx_out_public_key

type Error = Error

[KeyImageComputer] error

impl<T: Device> MemoHmacSigner for TransactionHandle<T>

Sync [MemoHmacSigner] implementation for TransactionHandle

Note: this MUST be called from a tokio context

fn compute_memo_hmac_sig( &self, sender_subaddress_index: u64, tx_public_key: &TxOutPublic, target_subaddress: PublicSubaddress, memo_type: &[u8; 2], memo_data_sans_hmac: &[u8; 48] ) -> Result<[u8; 16], Self::Error>

Compute the HMAC signature for the provided memo and target address

type Error = Error

[MemoHmacSigner] error

impl<T: Device> RingSigner for TransactionHandle<T>

Sync [RingSigner] implementation for TransactionHandle

Note: this MUST be called from a tokio context

fn sign( &self, message: &[u8], signable_ring: &SignableInputRing, pseudo_output_blinding: Scalar, _rng: &mut dyn CryptoRngCore ) -> Result<RingMLSAG, SignerError>

Execute ring signing operation on ledger hw

impl<T: Device> Subaddress for TransactionHandle<T>

Sync [Subaddress] implementation for TransactionHandle

Note: this MUST be called from a tokio context

fn subaddress(&self, index: u64) -> Self::Output

Fetch view subaddress by subaddress index, inheriting the account index from the transaction context.

type Output = Result<ViewSubaddress, Error>

Subaddress type