Skip to main content

MigrationLegReport

Struct MigrationLegReport

pub struct MigrationLegReport {
    pub settle_txid: Option<Txid>,
    pub migrated: Vec<MigrationVtxoRef>,
    pub deferred: Vec<MigrationVtxoRef>,
    pub oversized: Vec<MigrationVtxoRef>,
    pub skipped: Option<MigrationSkipReason>,
    pub error: Option<String>,
}

Expand description

Outcome of one Client::migrate_deprecated_signer_vtxos leg.

Each leg owns its full sizing pipeline and reports independently — a failure or skip in one leg never suppresses the other. The pipeline is:

inputs whose individual amount exceeds the server’s per-output ceiling (vtxo_max_amount) are split out as Self::oversized — they can never form a <= ceiling output and must exit unilaterally;
the remainder is selected highest-value-first, bounded by both MAX_VTXOS_PER_SETTLEMENT and a running aggregate within the ceiling — the overflow lands in Self::deferred for a later cycle;
if the selected aggregate is below the dust floor, the leg is Self::skipped and nothing is submitted.

Fields§

§settle_txid: Option<Txid>

The settlement TXID, when this leg submitted a batch. None on skip.

§migrated: Vec<MigrationVtxoRef>

Inputs submitted in this leg’s settlement; empty on skip.

§deferred: Vec<MigrationVtxoRef>

Migratable inputs deferred to a later cycle by this leg’s count or amount caps.

§oversized: Vec<MigrationVtxoRef>

Inputs whose value alone exceeds the per-output ceiling; they require a unilateral exit and never migrate cooperatively.

§skipped: Option<MigrationSkipReason>

Why this leg submitted nothing; None when a settlement was attempted.

§error: Option<String>

The settlement error, if this leg’s settle_vtxos call failed. Set independently of the other leg — a failure here does not prevent the other leg from running.

Implementations§

impl MigrationLegReport

pub fn failed(&self) -> bool

Whether this leg attempted settlement and failed.

Trait Implementations§

impl Clone for MigrationLegReport

fn clone(&self) -> MigrationLegReport

Returns a duplicate of the value. Read more

1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more

impl Debug for MigrationLegReport

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

impl Freeze for MigrationLegReport

impl RefUnwindSafe for MigrationLegReport

impl Send for MigrationLegReport

impl Sync for MigrationLegReport

impl Unpin for MigrationLegReport

impl UnsafeUnpin for MigrationLegReport

impl UnwindSafe for MigrationLegReport

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> AnyExt for T
where T: Any + ?Sized,

fn downcast_ref<T>(this: &Self) -> Option<&T>
where T: Any,

Attempts to downcast this to T behind reference

fn downcast_mut<T>(this: &mut Self) -> Option<&mut T>
where T: Any,

Attempts to downcast this to T behind mutable reference

fn downcast_rc<T>(this: Rc<Self>) -> Result<Rc<T>, Rc<Self>>
where T: Any,

Attempts to downcast this to T behind Rc pointer

fn downcast_arc<T>(this: Arc<Self>) -> Result<Arc<T>, Arc<Self>>
where T: Any,

Attempts to downcast this to T behind Arc pointer

fn downcast_box<T>(this: Box<Self>) -> Result<Box<T>, Box<Self>>
where T: Any,

Attempts to downcast this to T behind Box pointer

fn downcast_move<T>(this: Self) -> Option<T>
where T: Any, Self: Sized,

Attempts to downcast owned Self to T, useful only in generic context as a workaround for specialization

impl<T> AsDebug for T
where T: Debug,

fn as_debug(&self) -> &dyn Debug

Returns self as a &dyn Debug trait object.

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

impl<T> CloneToUninit for T
where T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)

Performs copy-assignment from self to dest. Read more

impl<T, X> CoerceTo<T> for X
where T: CoerceFrom<X> + ?Sized,

fn coerce_rc_to(self: Rc<X>) -> Rc<T>

fn coerce_box_to(self: Box<X>) -> Box<T>

fn coerce_ref_to(&self) -> &T

fn coerce_mut_to(&mut self) -> &mut T

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> FromRef<T> for T
where T: Clone,

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> IntoRequest<T> for T

fn into_request(self) -> Request<T>

Wrap the input message T in a tonic::Request

impl<L> LayerExt<L> for L

fn named_layer<S>(&self, service: S) -> Layered<<L as Layer<S>>::Service, S>
where L: Layer<S>,

Applies the layer to a service and wraps it in Layered.

impl<T> PolicyExt for T
where T: ?Sized,

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

impl<T> ToOwned for T
where T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more