Struct LabelChangeset 

pub struct LabelChangeset { /* private fields */ }

An in-memory, deterministic collection of BIP-329 wallet labels.

Backed by a BTreeMap, this structure ensures $O(\log n)$ deduplication and guarantees that labels are deterministically sorted by their reference key. This prevents noisy diffs when exporting to version-controlled JSONL files.

Implementations

impl LabelChangeset

pub fn new() -> Self

Creates a new, empty LabelChangeset.

pub fn insert(&mut self, label: Label)

Inserts a new label into the changeset making its ref staged. If a label with the same reference already exists, it is overwritten.

pub fn remove(&mut self, target: &LabelRef) -> Option<Label>

Removes the label associated with the given target reference, returning it if it existed.

pub fn get(&self, target: &LabelRef) -> Option<&Label>

Retrieves a reference to the label associated with the given target.

pub fn is_empty(&self) -> bool

Returns true if the changeset contains no labels.

pub fn len(&self) -> usize

Returns the total number of labels in the changeset.

pub fn iter(&self) -> impl Iterator<Item = &Label>

Returns an iterator over the labels, yielded in deterministic order based on their reference.

pub fn merge(&mut self, incoming: LabelChangeset, strategy: MergeStrategy)

Merges an incoming LabelChangeset into the current one, resolving conflicts based on the provided MergeStrategy.

pub fn diff(&self) -> LabelChangeset

Returns the unpersisted diff of the changeset.

pub fn clear_staged(&mut self)

Clears the staged label refs

pub fn has_staged_changes(&self) -> bool

Checks and returns true if there are changes staged

Trait Implementations

impl Clone for LabelChangeset

fn clone(&self) -> LabelChangeset

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LabelChangeset

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for LabelChangeset

fn default() -> LabelChangeset

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for LabelChangeset

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for LabelChangeset

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.