Struct PairProof 

pub struct PairProof {
    pub version: u16,
    pub role: String,
    pub key_fingerprint: String,
    pub proven_at: Option<u64>,
    pub rearm_episodes: u32,
    pub last_rearm_at: Option<u64>,
    pub force_rearm: bool,
}

The per-key proof record.

Fields

version: u16

Schema version (absent ⇒ 0 from an older writer).

role: String

The bind role this record belongs to (drone / gs). A box re-profiled to the other role gets a fresh record.

key_fingerprint: String

The blake2b-8 fingerprint of the key’s peer-public half. THE lifetime key: a different fingerprint is a different key and resets everything.

proven_at: Option<u64>

Unix seconds when this fingerprint was last confirmed to carry a link. None ⇒ never proven ⇒ the latch may re-arm.

rearm_episodes: u32

How many re-arm episodes this fingerprint has already consumed.

last_rearm_at: Option<u64>

Unix seconds of the most recent re-arm, so the cooldown is wall-clock and survives a restart.

force_rearm: bool

An operator asked for one re-arm regardless of the latch. Self-clearing: consumed by the next arm.

Implementations

impl PairProof

pub fn fresh(role: &str, fingerprint: &str) -> Self

A never-proven record for role + fingerprint.

pub fn is_proven(&self) -> bool

True once this fingerprint has been confirmed to carry a link at least once. The single fact the never-re-arm-a-healthy-link rule turns on.

pub fn matches(&self, role: &str, fingerprint: &str) -> bool

Whether this record describes the given role + key.

pub fn mark_proven(&mut self, now_unix: u64) -> ProofStamp

Record that the key was observed carrying a link at now_unix. Returns what changed so the caller can skip a needless write (flash) and can announce only the first-ever proof.

pub fn record_rearm(&mut self, now_unix: u64)

Consume one re-arm episode at now_unix: bump the budget, stamp the wall-clock cooldown anchor, and clear any operator force (it is a one-shot).

pub fn to_bytes(&self) -> Vec<u8>

The on-disk body: pretty JSON plus a trailing newline, so an operator can read the latch state with cat.

Trait Implementations

impl Clone for PairProof

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PairProof

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PairProof

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for PairProof

impl PartialEq for PairProof

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for PairProof

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PairProof