Struct StateRoot 

pub struct StateRoot {
    pub hash: [u8; 32],
    pub parent: Option<[u8; 32]>,
    pub hlc: Hlc,
    pub device_id: Uuid,
    pub signature: [u8; 64],
    pub seq: u64,
}

A state root representing a Merkle commitment to the entire cognitive state.

Each update to the knowledge graph produces a new state root, forming a chain of cryptographically verifiable state transitions.

Fields

hash: [u8; 32]

BLAKE3 hash of the Merkle tree root

parent: Option<[u8; 32]>

Hash of the previous state root (None for genesis)

hlc: Hlc

HLC timestamp when this root was created

device_id: Uuid

Device ID that produced this state

signature: [u8; 64]

Ed25519 signature over (hash || parent || hlc || device_id || seq)

seq: u64

Sequence number for ordering (increments per device)

Implementations

impl StateRoot

pub fn new( hash: [u8; 32], parent: Option<[u8; 32]>, hlc: Hlc, device_id: Uuid, seq: u64, ) -> Self

Create a new unsigned state root

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

Get the bytes to be signed.

Layout: hash (32) || parent (32, zeroed if None) || hlc (26) || device_id (16) || seq (8) Total: 114 bytes

pub fn is_genesis(&self) -> bool

Check if this is the genesis (first) state root

pub fn hash_hex(&self) -> String

Get the hash as a hex string

pub fn short_hash(&self) -> String

Get the short hash (first 8 chars) for display

pub fn sign(&mut self, signing_key: &SigningKey)

Sign the state root with the given key.

pub fn verify(&self, verifying_key: &VerifyingKey) -> Result<(), SignatureError>

Verify the state root signature.

Trait Implementations

impl Clone for StateRoot

fn clone(&self) -> StateRoot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StateRoot

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StateRoot

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for StateRoot

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for StateRoot

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for StateRoot

impl StructuralPartialEq for StateRoot