rings-measure 0.20.0

Pure local peer credit and reliability algorithms for Rings
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

use serde::Deserialize;
use serde::Serialize;

use crate::PeerRecord;

/// Current serialized measurement snapshot schema version.
pub const MEASUREMENT_SNAPSHOT_VERSION: u16 = 1;

/// One peer entry in a versioned measurement snapshot.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct SnapshotRecord<P> {
    /// Stable peer key supplied by the integrating runtime.
    pub peer: P,
    /// Pure local state associated with the peer.
    pub record: PeerRecord,
}

/// Versioned, deterministic serialization boundary for a measurement ledger.
///
/// Snapshot fields are intentionally public because persisted data is untrusted
/// input. [`crate::MeasurementLedger::from_snapshot`] validates the version,
/// default retained-peer bound, and duplicate identities before constructing
/// live state. Adapters using a custom bound must restore with
/// [`crate::MeasurementLedger::from_snapshot_with_max_records`] so the same
/// resource policy is preserved.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct MeasurementSnapshot<P> {
    /// Schema version used to encode `records`.
    pub schema_version: u16,
    /// Peer records in stable key order when produced by the ledger.
    pub records: Vec<SnapshotRecord<P>>,
}