Struct StateIntegrity 

pub struct StateIntegrity {
    pub current_hash: [u8; 32],
    pub sequence_number: u64,
    pub genesis_validators_root: Option<[u8; 32]>,
}

State integrity tracker

Maintains a hash chain of all signing decisions to detect rollback attacks

Fields

current_hash: [u8; 32]

Current state hash (hash of all decisions up to now)

sequence_number: u64

Sequence number of the last recorded decision

genesis_validators_root: Option<[u8; 32]>

Genesis validators root (locked on first signing request)

Implementations

impl StateIntegrity

pub fn new() -> Self

Create a new state integrity tracker

pub fn from_checkpoint( hash: [u8; 32], sequence: u64, genesis_root: Option<[u8; 32]>, ) -> Self

Create from a checkpoint

pub fn set_genesis_validators_root( &mut self, root: [u8; 32], ) -> Result<(), IntegrityError>

Lock the genesis validators root (can only be set once)

pub fn record_decision( &mut self, record: &DecisionRecord, ) -> Result<[u8; 32], IntegrityError>

Record a new decision and update the hash chain

Returns the new state hash after recording

pub fn prepare_record( &self, validator_pubkey: [u8; 48], request_type: SigningType, decision: PolicyDecision, signing_root: [u8; 32], ) -> DecisionRecord

Create a decision record with proper sequencing

pub fn prepare_record_with_context( &self, validator_pubkey: [u8; 48], request_type: SigningType, decision: PolicyDecision, signing_root: [u8; 32], signing_context: SigningContext, ) -> DecisionRecord

Create a decision record with proper sequencing and signing context

pub fn verify_records<'a, I>(&self, records: I) -> Result<(), IntegrityError>

where I: IntoIterator<Item = &'a DecisionRecord>,

Verify a sequence of records against expected hash chain

Trait Implementations

impl Clone for StateIntegrity

fn clone(&self) -> StateIntegrity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StateIntegrity

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

Formats the value using the given formatter.

impl Default for StateIntegrity

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for StateIntegrity

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for StateIntegrity

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

where __S: Serializer,

Serialize this value into the given Serde serializer.