Struct LabelledWallet 

pub struct LabelledWallet<'a> {
    pub wallet: &'a mut Wallet,
    pub labels: &'a mut LabelChangeset,
}

A wrapper around a BDK Wallet and a LabelChangeset that provides BIP-329 functionality.

This struct enables direct manipulation of wallet labels while holding mutable references to both the underlying wallet state and the current label changeset.

Fields

wallet: &'a mut Wallet

A mutable reference to the underlying BDK wallet.

labels: &'a mut LabelChangeset

A mutable reference to the current in-memory label state.

Implementations

impl LabelledWallet<'_>

pub fn persist<P: LabelPersister>( &mut self, persister: &mut P, ) -> Result<(), Error>

Flushes only the labels changed since the last successful persist to the provided database persister.

Trait Implementations

impl Bip329 for LabelledWallet<'_>

fn add_label( &mut self, target: impl Into<LabelTarget>, label_text: impl Into<String>, ) -> Result<Label, Error>

Adds a new human-readable label to a specified target (e.g., Address, Txid).

fn import_labels<R: BufRead>( &mut self, reader: R, strategy: MergeStrategy, ) -> Result<(), Error>

Imports labels from a BIP-329 compliant JSONL stream and merges them with the current state.

fn export_labels<W: Write>(&self, writer: W) -> Result<(), Error>

Exports the current label state deterministically to a writable stream in BIP-329 JSONL format.