Struct ObjectId 

pub struct ObjectId(/* private fields */);

A 256-bit BLAKE3 content hash serving as the immutable identity of a Knowledge Object.

oid = BLAKE3(canonical_serialization(payload + edges + embeddings))

Properties:

• Deterministic: Same content always produces the same OID.
• Collision-resistant: 256-bit output makes collisions computationally infeasible.
• Structural deduplication: Identical objects share the same OID.
• Content verification: Recomputing the hash detects corruption or tampering.

The OID is computed over the canonical byte representation (sorted keys, normalized floats) to ensure deterministic hashing regardless of insertion order.

Implementations

impl ObjectId

pub const NIL: Self

A zero/nil OID, used as a sentinel for “no parent” in provenance chains.

pub fn from_bytes(bytes: [u8; 32]) -> Self

Create an OID from a raw 32-byte hash.

pub fn from_content(content: &[u8]) -> Self

Compute the OID from canonical content bytes using BLAKE3.

pub fn as_bytes(&self) -> &[u8; 32]

The raw 32 bytes of the OID.

pub fn to_hex(&self) -> String

Hex-encoded OID string (64 characters).

pub fn from_hex(s: &str) -> Result<Self, ObjectIdError>

Parse an OID from a 64-character hex string.

pub fn is_nil(&self) -> bool

Check if this is the nil/zero OID.

Trait Implementations

impl Clone for ObjectId

fn clone(&self) -> ObjectId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ObjectId

impl Debug for ObjectId

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ObjectId

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ObjectId

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

Formats the value using the given formatter.

impl Eq for ObjectId

impl Hash for ObjectId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ObjectId

fn eq(&self, other: &ObjectId) -> 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 ObjectId

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ObjectId