Struct Snid 

#[repr(transparent)]
pub struct Snid(pub [u8; 16]);

Tuple Fields

0: [u8; 16]

Implementations

impl Snid

pub fn new() -> Self

Generates a new SNID with ~3.7ns latency. This is the universal paradigm for fast ID generation.

pub fn try_new() -> Result<Self, Error>

Attempts to generate a new SNID without panicking on OS RNG failure.

pub fn new_fast() -> Self

Generates a new SNID with lock-free per-P state. Deprecated: Use new() instead.

pub fn new_with(opts: Options) -> Self

Generates a configured ID using options. This is the universal paradigm for configured ID generation.

pub fn uuidv7() -> Self

Generates a SNID with RFC 9562 UUIDv7-compatible bytes.

pub fn new_spatial(_lat: f64, _lng: f64) -> Self

Generates a spatial ID from lat/lng coordinates. This is the universal paradigm for spatial ID generation.

pub fn batch(count: usize) -> Vec<Self>

Generates a batch of IDs efficiently. This is the universal paradigm for batch generation.

pub fn try_batch(count: usize) -> Result<Vec<Self>, Error>

Attempts to generate a batch of IDs without panicking on OS RNG failure.

pub fn fill_slice(out: &mut [Self])

Fills an existing ID slice in place.

This is the lowest-allocation generation API for callers that own their buffers, such as network send paths, database ingest loops, and arenas.

pub fn fill_bytes(out: &mut [u8]) -> usize

Fills a byte buffer with raw SNID bytes and returns the number of IDs written.

Only complete 16-byte slots are written; trailing bytes are ignored.

pub fn append_binary_batch(count: usize, out: &mut Vec<u8>)

Appends count raw 16-byte SNIDs to an existing byte buffer.

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

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

pub fn write_uuid_string(&self, out: &mut [u8; 36])

Writes the standard hyphenated UUID text form into out.

pub fn to_uuid_string(&self) -> String

Returns the standard hyphenated UUID text form.

pub fn from_uuid_string(value: &str) -> Result<Self, Error>

Parses a standard hyphenated UUID string into a SNID.

Only UUIDv7 values are accepted.

pub fn from_hex(hex_value: &str) -> Result<Self, Error>

pub fn canonical_atom(atom: &str) -> Option<&'static str>

pub fn to_wire(self, atom: &str) -> Result<String, Error>

pub fn write_wire<'a>( self, atom: &str, out: &'a mut [u8; 28], ) -> Result<&'a str, Error>

Writes a wire-format ID (ATOM:payload) into a stack-provided buffer.

The output buffer must be at least 28 bytes for canonical three-byte atoms.

pub fn append_wire(self, atom: &str, out: &mut Vec<u8>) -> Result<(), Error>

Appends wire-format bytes into an existing buffer without allocating.

pub fn to_wire_default(self) -> String

Formats an ID using the default wire format with “MAT:” atom. This is the universal paradigm for serialization (default atom). Note: Use the Display trait instead via format!(“{}”, id)

pub fn with_atom(self, atom: &str) -> String

Formats an ID with a custom atom. This is the universal paradigm for serialization (override atom).

pub fn to_base32(self) -> String

Formats an ID using Crockford Base32 encoding. This is case-insensitive and excludes ambiguous characters (I, L, O).

pub fn write_base32(self, out: &mut [u8; 27]) -> &str

Writes Crockford Base32 text into out and returns the written slice.

pub fn append_base32(self, out: &mut Vec<u8>)

pub fn new_safe() -> Self

Generates a public-safe ID with time-blurring and pure CSPRNG entropy. This is the “One ID” solution for database PK + public API use. Time-blurring: Truncates timestamp to nearest second (instead of millisecond) Pure CSPRNG: Fills 74 bits with cryptographic randomness (no monotonic counter) Performance: ~40-50ns (vs 5ns for new())

pub fn try_new_safe() -> Result<Self, Error>

Attempts to generate a public-safe ID without panicking on OS RNG failure.

pub fn parse_wire(value: &str) -> Result<(Self, String), Error>

pub fn parse(value: &str) -> Result<Self, Error>

Parses a wire string and returns the ID. This is the universal paradigm for parsing wire strings.

pub fn parse_uuid(value: &str) -> Result<Self, Error>

Parses a UUID string and returns the ID. This is the universal paradigm for parsing UUID strings.

pub fn timestamp_millis(self) -> i64

pub fn to_tensor_words(self) -> (i64, i64)

pub fn sequence(self) -> u16

pub fn machine_or_shard(self) -> u32

pub fn time_bin(self, resolution_millis: i64) -> i64

pub fn is_ghosted(self) -> bool

pub fn with_ghost_bit(self, enabled: bool) -> Self

pub fn from_hash_with_timestamp(unix_millis: u64, hash: &[u8]) -> Self

pub fn h3_cell(self) -> Option<u64>

pub fn from_spatial_parts(cell: u64, entropy: u64) -> Self

pub fn h3_feature_vector(self) -> Vec<u64>

impl Snid

pub fn to_llm_format(self, atom: &str) -> Result<LlmFormatV1, Error>

pub fn to_llm_format_v2(self, atom: &str) -> Result<LlmFormatV2, Error>

Trait Implementations

impl Clone for Snid

fn clone(&self) -> Snid

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Snid

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

Formats the value using the given formatter.

impl Default for Snid

fn default() -> Self

Returns the “default value” for a type.

impl Display for Snid

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

Formats the value using the given formatter.

impl FromStr for Snid

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for Snid

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 Ord for Snid

fn cmp(&self, other: &Snid) -> 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 PartialEq for Snid

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

fn partial_cmp(&self, other: &Snid) -> 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 Copy for Snid

impl Eq for Snid

impl StructuralPartialEq for Snid