Struct Exit

pub struct Exit { /* private fields */ }

Handles the process of ongoing VTXO exits.

Implementations

impl Exit

pub async fn get_exit_status( &self, vtxo_id: VtxoId, include_history: bool, include_transactions: bool, ) -> Result<Option<ExitTransactionStatus>, ExitError>

Returns the unilateral exit status for a given VTXO, if any.

Parameters

• vtxo_id: The ID of the VTXO to check.
• include_history: Whether to include the full state machine history of the exit
• include_transactions: Whether to include the full set of transactions related to the exit.

pub fn get_exit_vtxo(&self, vtxo_id: VtxoId) -> Option<&ExitVtxo>

Returns a reference to the tracked ExitVtxo if it exists.

pub fn get_exit_vtxos(&self) -> &Vec<ExitVtxo>

Returns all known unilateral exits in this wallet.

pub fn has_pending_exits(&self) -> bool

True if there are any unilateral exits which have been started but are not yet claimable.

pub fn pending_total(&self) -> Amount

Returns the total amount of all VTXOs requiring more txs to be confirmed

pub async fn all_claimable_at_height(&self) -> Option<BlockHeight>

Returns the earliest block height at which all tracked exits will be claimable

pub async fn start_exit_for_entire_wallet(&mut self) -> Result<()>

Starts the unilateral exit process for the entire wallet (all eligible VTXOs).

It does not block until completion, you must use Exit::progress_exits to advance each exit.

It’s recommended to sync the wallet, by using something like Wallet::maintenance being doing this.

pub async fn start_exit_for_vtxos<'a>( &mut self, vtxos: &[impl Borrow<Vtxo>], ) -> Result<()>

Starts the unilateral exit process for the given VTXOs.

It does not block until completion, you must use Exit::progress_exits to advance each exit.

It’s recommended to sync the wallet, by using something like Wallet::maintenance being doing this.

pub async fn progress_exits( &mut self, wallet: &Wallet, onchain: &mut dyn ExitUnilaterally, fee_rate_override: Option<FeeRate>, ) -> Result<Option<Vec<ExitProgressStatus>>>

Iterates over each registered VTXO and attempts to progress their unilateral exit. Note that Exit::sync or Exit::sync_no_progress should be called before calling this method.

Parameters

• onchain is used to build the CPFP transaction package we use to broadcast the unilateral exit transaction
• fee_rate_override sets the desired fee-rate in sats/kvB to use broadcasting exit transactions. Note that due to rules imposed by the network with regard to RBF fee bumping, replaced transactions may have a higher fee rate than you specify here.

Returns

The exit status of each VTXO being exited which has also not yet been spent

pub async fn sync( &mut self, wallet: &Wallet, onchain: &mut dyn ExitUnilaterally, ) -> Result<()>

For use when syncing. Pending exits will be initialized, the network status of each ExitTransactionPackage will be updated, and finally, any unilateral exits that are waiting for network updates will be progressed.

pub async fn sync_no_progress( &mut self, onchain: &dyn ExitUnilaterally, ) -> Result<()>

For use when syncing. Initializes pending exits and syncs any confirmed or broadcast child transactions. This differs from Exit::sync in that it doesn’t update the ExitState of a unilateral exit. This must be done manually by calling Exit::progress_exits. This permits the use of a read-only reference to the onchain wallet.

pub fn list_claimable(&self) -> Vec<&ExitVtxo>

Lists all exits that are claimable

pub async fn sign_exit_claim_inputs( &self, psbt: &mut Psbt, wallet: &Wallet, ) -> Result<()>

Sign any inputs of the PSBT that is an exit claim input

Can take the result PSBT of bdk_wallet::TxBuilder::finish on which crate::onchain::TxBuilderExt::add_exit_claim_inputs has been used

Note: This doesn’t mark the exit output as spent, it’s up to the caller to do that, or it will be done once the transaction is seen in the network

pub async fn drain_exits<'a>( &self, inputs: &[impl Borrow<ExitVtxo>], wallet: &Wallet, address: Address, fee_rate_override: Option<FeeRate>, ) -> Result<Psbt, ExitError>

Builds a PSBT that drains the provided claimable unilateral exits to the given address.

• inputs: Claimable unilateral exits.
• wallet: The bark wallet containing the keys needed to spend the unilateral exits.
• address: Destination address for the claim.
• fee_rate_override: Optional fee rate to use.

Returns a PSBT ready to be broadcast.