ShieldController class

Constructors

ShieldController()

Properties

hashCode → int
The hash code for this object.
no setterinherited
ref → Ref
The Ref associated with this notifier.
no setterinherited
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
state ↔ ShieldState
The value currently exposed by this notifier.
getter/setter pairinherited
stateOrNull → ShieldState?
The value currently exposed by this Notifier.
no setterinherited

Methods

build() → ShieldState
Initialize a Notifier.
confirm() → Future<void>
Sign + broadcast the shield (the SECOND half) — consumes the one-shot token by id, the SAME send path a payment uses. A per-tx broadcast failure is DATA, not a throw, so it lands as "saved for retry"; a thrown typed error routes per classifyShieldSendFailure — once the spend started, only a kind singleStepSendErrorPrecedesPersistence accepts; anything else lands on ShieldOutcomeUnknown (R13). On a money-moving outcome the cold balance is invalidated so the transparent line updates promptly.
listenSelf(void listener(ShieldState? previous, ShieldState next), {void onError(Object error, StackTrace stackTrace)?}) → RemoveListener
Listens to changes on the value exposed by this provider.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
prepare() → Future<void>
Propose the shield (the FIRST half) — DETERMINISTIC, LOCAL (no keys/proofs/ network). On a shieldable balance → ShieldReady with the confirmable numbers; on null → ShieldNothingToShield (below the threshold, honest no-op); on a typed failure → ShieldUnavailable.
reset() → void
Reset to idle — called on sheet entry so a prior terminal result never lingers into a new shield. A NO-OP while a step is in flight ( review F1): re-opening the sheet mid-submit RE-ATTACHES to the running flow — clobbering the transient would make the identity guards swallow the landing outcome.
runBuild() → WhenComplete?
Executes Notifier.build.
inherited
toString() → String
A string representation of this object.
inherited
updateShouldNotify(ShieldState previous, ShieldState next) → bool
A method invoked when the state exposed by this Notifier changes. It compares the previous and new value, and return whether listeners should be notified.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited