pub struct PeerHintClearResult {
pub cleared: usize,
pub forgotten: Vec<String>,
}Expand description
Result of Request::PeerHintClear (#140).
Fields§
§cleared: usizeHow many hints were removed. A b64u: user_id names EVERY device of that person and the
racing dial path attaches a hint for each, so clearing “the” hint would leave the pairing
still addressing from stored state while reporting success. Every device is cleared, and the
count says how many actually had one.
0 means nothing was stored — already the state this verb produces, so a no-op, not an error.
forgotten: Vec<String>The raw hints removed, verbatim, in the order the devices resolved.
This is the undo, and since 0.52.2 it is the ONLY one. There is no peer_hint_set, and
on the pairing this verb targets the hint may never be rewritten on its own: every writer
now stores only what a connection OBSERVED, and all of them decline to store anything for a
relay-only connection — which is the defining property of a stuck pair. Re-pairing no longer
reliably restores it either: the ceremony writes a hint only if it observes a direct path,
and on a pair that cannot punch it does not. Keep this value.
Trait Implementations§
Source§impl Clone for PeerHintClearResult
impl Clone for PeerHintClearResult
Source§fn clone(&self) -> PeerHintClearResult
fn clone(&self) -> PeerHintClearResult
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read more