Struct DeterministicGraph 

pub struct DeterministicGraph { /* private fields */ }

A deterministic, thread-safe RDF graph wrapper around Oxigraph’s Store. Ensures deterministic sorting of quads and reproducible state hashing.

Implementations

impl DeterministicGraph

pub fn new() -> Result<Self, GraphError>

Create a new empty deterministic graph.

Errors

Returns GraphError if the underlying Oxigraph store cannot be initialized.

pub fn insert_quad(&self, quad: &Quad) -> Result<(), GraphError>

Insert a quad directly into the graph.

Errors

Returns GraphError if the quad insertion fails.

pub fn remove_quad(&self, quad: &Quad) -> Result<(), GraphError>

Remove a quad directly from the graph.

Errors

Returns GraphError if the quad removal fails.

pub fn contains_quad(&self, quad: &Quad) -> Result<bool, GraphError>

Checks if the graph contains a specific quad.

Errors

Returns GraphError if the lookup fails.

pub fn query(&self, query_str: &str) -> Result<QueryResults<'_>, GraphError>

Evaluate a SPARQL query against the graph.

Errors

Returns GraphError if query parsing or evaluation fails.

pub fn all_quads(&self) -> Result<Vec<Quad>, GraphError>

Retrieve all quads in the graph.

Errors

Returns GraphError if reading from the store fails.

pub fn parse_nquad(nquad: &str) -> Result<Quad, GraphError>

Parses an N-Quad string into an Oxigraph Quad.

Errors

Returns GraphError::Serialization if parsing fails.

pub fn state_hash(&self) -> Result<[u8; 32], GraphError>

Computes a deterministic blake3 hash of the entire graph state.

Errors

Returns GraphError if reading quads fails.

pub fn apply_delta( &self, delta: &RdfDelta, hooks: &[KnowledgeHook], ) -> Result<TransitionReceipt, GraphError>

Applies an RdfDelta to the graph, runs validation hooks, and returns a TransitionReceipt.

If any validation hook fails, the changes are rolled back to preserve consistency.

Errors

Returns GraphError if application, validation, or rollback fails.

Trait Implementations

impl Clone for DeterministicGraph

fn clone(&self) -> DeterministicGraph

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for DeterministicGraph

fn default() -> Self

Returns the “default value” for a type.