Struct TupleChain 

pub struct TupleChain { /* private fields */ }

The TupleChain semantic ledger.

Stores five-tuples as a DAG with automatic expiry pruning, SPARQL-inspired semantic queries, and Wyqcc L1 anchoring.

Implementations

impl TupleChain

pub fn new() -> Self

pub fn insert(&mut self, tuple: PrivacyTuple) -> String

Insert a five-tuple into the ledger.

Generates a tuple ID from SHA-256(subject || predicate || expiry).

pub fn query_by_subject(&self, subject: &str, now_ms: u64) -> Vec<&PrivacyTuple>

Query tuples by subject (SPARQL-inspired).

Returns non-expired tuples matching the subject.

pub fn query_by_predicate( &self, predicate: &str, now_ms: u64, ) -> Vec<&PrivacyTuple>

Query tuples by predicate.

pub fn get(&self, id: &str) -> Option<&PrivacyTuple>

Get a tuple by ID.

pub fn prune_expired(&mut self, now_ms: u64) -> usize

Prune expired tuples via ZK proof of expiry.

Returns the number of tuples pruned.

pub fn anchor_all(&mut self) -> String

Anchor all un-anchored tuples to Wyqcc L1.

Returns a Merkle root of all anchor hashes.

pub fn homomorphic_add( &self, id_a: &str, id_b: &str, ) -> Result<Vec<u8>, PrivacyError>

Not actually homomorphic — XORs two object fields byte-for-byte. XOR-ing arbitrary ciphertext bytes does not correspond to addition of the underlying plaintexts under any scheme used elsewhere in this crate (AES-GCM, the real LWE scheme in crate::fhe). Kept for compatibility; do not rely on the result meaning “a + b.”

pub fn active_count(&self, now_ms: u64) -> usize

Returns the total number of active (non-expired) tuples.

pub fn total_count(&self) -> u64

Returns the total number of tuples ever inserted.

Trait Implementations

impl Debug for TupleChain

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

Formats the value using the given formatter.

impl Default for TupleChain

fn default() -> Self

Returns the “default value” for a type.