Struct Key

pub struct Key { /* private fields */ }

DHT key type with proper Kademlia distance calculation

Implementations

impl Key

pub fn new(data: &[u8]) -> Self

Create a new key from raw data

pub fn from_hash(hash: [u8; 32]) -> Self

Create a key from existing hash

pub fn random() -> Self

Create a random key

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

Get key as bytes

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

Get raw 32-byte hash (by value) for integrations

pub fn to_hex(&self) -> String

Get key as hex string

pub fn distance(&self, other: &Key) -> Key

Calculate XOR distance between two keys (Kademlia distance metric)

pub fn leading_zeros(&self) -> u32

Get the bit length of the distance (number of leading zeros)

pub fn bucket_index(&self, local_id: &Key) -> usize

Get bucket index for this key relative to local node

impl Key

pub fn from_inbox_id(inbox_id: &str) -> Self

Create a key for inbox metadata

pub fn from_inbox_index(inbox_id: &str) -> Self

Create a key for inbox message index

pub fn from_inbox_message(inbox_id: &str, message_id: &str) -> Self

Create a key for a specific message in an inbox

Trait Implementations

impl Clone for Key

fn clone(&self) -> Key

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Key

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Key

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Key

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

Formats the value using the given formatter.

impl Hash for Key

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 Key

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Validate for Key

fn validate(&self, ctx: &ValidationContext) -> Result<()>

Validate the object with the given context

impl Eq for Key

impl StructuralPartialEq for Key