Struct DedupKey 

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

An idempotent-append deduplication key: a 64-byte SHA3-512 digest that is a deterministic function of (namespace, payload).

An ingest pipeline keys in-flight and recently-committed records by their DedupKey; a re-submission (network retry, at-least-once delivery, a client replaying a request) produces the same key and can be dropped before it double-appends. The key is post-quantum (SHA3-512), domain-separated, and namespace-scoped, so keys never collide across namespaces or across the two derivation modes.

Two derivations are offered:

• DedupKey::from_record keys on the content itself (the canonical leaf bytes). Identical content in the same namespace is the same record.
• DedupKey::from_token keys on a client-supplied idempotency token (e.g. a request UUID). Use this when the same logical submission may carry non-identical bytes (timestamps, nonces) yet must append at most once.

The key is opaque; compare keys for equality or use DedupKey::as_bytes / DedupKey::to_hex as a storage index.

Implementations

impl DedupKey

pub fn from_record(namespace: &Namespace, payload: &[u8]) -> Self

Derive a content-addressed dedup key from a namespace and the canonical record bytes: SHA3-512_ctx("…/content/v1", lp(ns) || lp(payload)).

pub fn from_token(namespace: &Namespace, token: &[u8]) -> Self

Derive a dedup key from a namespace and a client-supplied idempotency token: SHA3-512_ctx("…/token/v1", lp(ns) || lp(token)).

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

The raw 64-byte key.

pub fn to_hex(&self) -> String

The key as lowercase hex (128 chars) — a convenient storage-index form.

Trait Implementations

impl Clone for DedupKey

fn clone(&self) -> DedupKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DedupKey

impl Debug for DedupKey

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

Formats the value using the given formatter.

impl Eq for DedupKey

impl Hash for DedupKey

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 DedupKey

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