pub enum DuplicityKind {
SameEpochFork,
BelowWatermarkFork,
HigherEpochFork,
}Expand description
Which of the three fork shapes tripped duplicity detection. B4 (#888) can use this to grade the operator response; all three are equally fail-closed here.
§Authentication of the divergent record (#961)
These verdicts are classified from the candidate’s own epoch and
recomputed H512 against the persisted watermark — B1 is deliberately NOT
run first. It cannot be: validating a candidate at epoch <= watermark.epoch
needs its committing predecessor (the accepted record at epoch - 1), which
R6 watermark-only persistence does not retain, and re-accepting a
caller-supplied predecessor for that purpose is exactly the forgeable input
#961 removed (the pre-#961 “B1-valid” property was validated against a
caller-forged ChainState, i.e. hollow). A duplicity verdict is therefore an
unauthenticated divergence indication — evidence that something
presented a record diverging from the accepted history, not proof the
identity holder signed it. The admission decision itself is unaffected
(fail-closed either way); alarm consumers (B4/#888) must treat alarms as
pointers for investigation, not as attributable equivocation proof.
Variants§
SameEpochFork
A record at epoch == watermark.epoch with a different record digest
than the one accepted at that epoch — an equivocation indication (two
records at the same epoch).
BelowWatermarkFork
A record at epoch < watermark.epoch: a branch reaching an epoch the
client has already passed. We hold only the high-watermark, so this is
never preferred over it and never silently dropped — it fails closed.
HigherEpochFork
A record at epoch > watermark.epoch that chains through a
predecessor other than the watermark head — a higher-epoch record on the
attacker’s fork rather than the client’s accepted history (design #879
§7.2, the “never select max epoch” case). Caught at the advance-path
anchor (#961): the presented predecessor record does not hash to the
watermark, so the candidate’s higher epoch cannot chain through the
accepted head — and B1 never runs against the foreign head’s commitments.
Trait Implementations§
Source§impl Clone for DuplicityKind
impl Clone for DuplicityKind
Source§fn clone(&self) -> DuplicityKind
fn clone(&self) -> DuplicityKind
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read moreSource§impl Debug for DuplicityKind
impl Debug for DuplicityKind
Source§impl PartialEq for DuplicityKind
impl PartialEq for DuplicityKind
Source§fn eq(&self, other: &DuplicityKind) -> bool
fn eq(&self, other: &DuplicityKind) -> bool
self and other values to be equal, and is used by ==.impl Copy for DuplicityKind
impl Eq for DuplicityKind
impl StructuralPartialEq for DuplicityKind
Auto Trait Implementations§
impl Freeze for DuplicityKind
impl RefUnwindSafe for DuplicityKind
impl Send for DuplicityKind
impl Sync for DuplicityKind
impl Unpin for DuplicityKind
impl UnsafeUnpin for DuplicityKind
impl UnwindSafe for DuplicityKind
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key and return true if they are equal.§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more