Struct Wallet

pub struct Wallet<W: Deref + MaybeSync + MaybeSend, L: Deref + MaybeSync + MaybeSend>
where
    W::Target: WalletSource + MaybeSend,
    L::Target: Logger + MaybeSend,
{ /* private fields */ }

A wrapper over WalletSource that implements CoinSelectionSource by preferring UTXOs that would avoid conflicting double spends. If not enough UTXOs are available to do so, conflicting double spends may happen.

For a synchronous version of this wrapper, see sync::WalletSync.

This is not exported to bindings users as async is only supported in Rust.

Implementations

impl<W: Deref + MaybeSync + MaybeSend, L: Deref + MaybeSync + MaybeSend> Wallet<W, L>

where W::Target: WalletSource + MaybeSend, L::Target: Logger + MaybeSend,

pub fn new(source: W, logger: L) -> Self

Returns a new instance backed by the given WalletSource that serves as an implementation of CoinSelectionSource.

Trait Implementations

impl<W: Deref + MaybeSync + MaybeSend, L: Deref + MaybeSync + MaybeSend> CoinSelectionSource for Wallet<W, L>

where W::Target: WalletSource + MaybeSend + MaybeSync, L::Target: Logger + MaybeSend + MaybeSync,

fn select_confirmed_utxos<'a>( &'a self, claim_id: ClaimId, must_spend: Vec<Input>, must_pay_to: &'a [TxOut], target_feerate_sat_per_1000_weight: u32, max_tx_weight: u64, ) -> AsyncResult<'a, CoinSelection, ()>

Performs coin selection of a set of UTXOs, with at least 1 confirmation each, that are available to spend. Implementations are free to pick their coin selection algorithm of choice, as long as the following requirements are met:

fn sign_psbt<'a>(&'a self, psbt: Psbt) -> AsyncResult<'a, Transaction, ()>

Signs and provides the full witness for all inputs within the transaction known to the trait (i.e., any provided via CoinSelectionSource::select_confirmed_utxos).