Struct StableId 

pub struct StableId<Kind: StableIdKind> { /* private fields */ }

A 16-byte stable identifier, parameterized by role tag.

Construct via StableId::new_v7 for fresh IDs or StableId::from_bytes to rehydrate from canonical-encoded form.

Two StableId values with different role tags are distinct types and cannot be compared or converted without an explicit crossing.

Implementations

impl<Kind: StableIdKind> StableId<Kind>

pub fn new_v7() -> Self

Generate a fresh UUIDv7 stable ID.

Uses the uuid crate’s Uuid::now_v7(), which combines the current Unix timestamp (48 bits, millisecond resolution) with 74 bits of CSPRNG entropy. See RFC 9562.

pub const fn from_bytes_raw(bytes: [u8; 16]) -> Self

Construct from an explicit 16-byte array. The bytes are not validated beyond their length - any 128-bit value is accepted. Callers who want UUID shape validation should use StableId::parse_uuid.

pub fn from_bytes(bytes: &[u8]) -> Result<Self, IdError>

Construct from a byte slice of length 16, validating the length.

Errors

Returns IdError::StableIdLength if bytes.len() != 16.

pub fn parse_uuid(s: &str) -> Result<Self, IdError>

Parse from a canonical UUID string (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).

Errors

Returns IdError::StableIdParse if s is not a valid UUID.

pub const fn from_random_bytes(bytes: [u8; 16]) -> Self

Construct from 16 random bytes without UUID structure. Useful when the caller has already generated cryptographically random bytes and does not need UUIDv7’s time ordering. The value will not validate as a UUIDv7 but will still function as a stable ID in mnem.

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

Borrow as a byte slice.

pub const fn into_bytes(self) -> [u8; 16]

Consume and return the underlying 16 bytes.

pub fn to_uuid_string(&self) -> String

Render as a lowercase hyphenated UUID string.

Trait Implementations

impl<Kind: Clone + StableIdKind> Clone for StableId<Kind>

fn clone(&self) -> StableId<Kind>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Kind: StableIdKind> Debug for StableId<Kind>

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

Formats the value using the given formatter.

impl<'de, Kind: StableIdKind> Deserialize<'de> for StableId<Kind>

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl<Kind: StableIdKind> Display for StableId<Kind>

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

Formats the value using the given formatter.

impl From<StableId<ChangeTag>> for ProllyKey

fn from(v: ChangeId) -> Self

Converts to this type from the input type.

impl From<StableId<EdgeTag>> for ProllyKey

fn from(v: EdgeId) -> Self

Converts to this type from the input type.

impl From<StableId<NodeTag>> for ProllyKey

fn from(v: NodeId) -> Self

Converts to this type from the input type.

impl<Kind: Hash + StableIdKind> Hash for StableId<Kind>

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<Kind: Ord + StableIdKind> Ord for StableId<Kind>

fn cmp(&self, other: &StableId<Kind>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<Kind: PartialEq + StableIdKind> PartialEq for StableId<Kind>

fn eq(&self, other: &StableId<Kind>) -> 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<Kind: PartialOrd + StableIdKind> PartialOrd for StableId<Kind>

fn partial_cmp(&self, other: &StableId<Kind>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<Kind: StableIdKind> Serialize for StableId<Kind>

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl<Kind: Copy + StableIdKind> Copy for StableId<Kind>

impl<Kind: Eq + StableIdKind> Eq for StableId<Kind>

impl<Kind: StableIdKind> StructuralPartialEq for StableId<Kind>