Enum FailureClass
#[non_exhaustive]pub enum FailureClass {
Transient,
Split,
Park,
Stop,
Reseed,
}Expand description
The remedy a failure calls for. One of five, the fifth added by SY-32.
#[non_exhaustive], so outside this crate a match needs a wildcard arm and
a sixth class is not a breaking change. The price is that a runner decides
what an unknown class means; that is #244’s, with the rest of what a runner
does per class.
There is no class for a refusal on the content of the log — a conflicting fact, a violated condition — because SY-33 forbids that refusal. A peer that wants one has found a violation, not a fifth remedy.
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
Transient
The exchange failed and the same exchange can succeed later: retry, with jittered and capped backoff.
Split
The batch is over a limit the peer has, and its events are not: halve the batch and retry.
Park
This event can never land on this peer, as VT-25’s ExceedsStoreLimit
says: hold it, report it, and carry on with the rest.
Stop
Authorisation or configuration: halt this edge and report it.
Reseed
The far side can no longer resume this edge: it has forgotten history the edge’s token has not reached (SY-32). Retrying fails the same way for ever, and pulling from the start would converge on a strict subset in silence. Halt the edge and report the gap; an operator either re-seeds this side from a peer that still holds the history, or accepts the gap explicitly.
Declared last, so the four before it keep their discriminants.