Struct HoprSenderId 

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

Identifier of a single packet sender.

This consists of two parts:

• HoprSenderId::pseudonym of the sender
• HoprSenderId::surb_id is an identifier a single SURB that routes the packet back to the sender.

The surb_id always identifies a single SURB. The instance can be turned into a pseudorandom sequence using HoprSenderId::into_sequence to create identifiers for more SURBs with the same pseudonym.

Implementations

impl HoprSenderId

pub fn new(pseudonym: &SimplePseudonym) -> HoprSenderId

pub fn from_pseudonym_and_id( pseudonym: &SimplePseudonym, id: [u8; 8], ) -> HoprSenderId

pub fn pseudonym(&self) -> SimplePseudonym

pub fn surb_id(&self) -> [u8; 8]

pub fn into_sequence(self) -> impl Iterator<Item = HoprSenderId>

Creates a pseudorandom sequence of IDs.

Each item has the same pseudonym but different surb_id.

The surb_id of the n-th item (n > 1) is computed as Blake3(n || I_prev) where I_prev is the whole n-1-th ID, the n is represented as big-endian and || denotes byte-array concatenation. The first item (n = 1) is always self.

The entropy of the whole pseudorandom sequence is completely given by self (the first item in the sequence). It follows that the next element of the sequence can be computed by just knowing any preceding element; therefore, the sequence is fully predictable once an element is known.

Trait Implementations

impl AsRef<[u8]> for HoprSenderId

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl BytesRepresentable for HoprSenderId

const SIZE: usize = 18usize

Size of the encoded byte array.

fn into_boxed(self) -> Box<[u8]>

Convenience function to copy this type’s binary representation into a Box.

impl Clone for HoprSenderId

fn clone(&self) -> HoprSenderId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HoprSenderId

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HoprSenderId

fn deserialize<__D>( __deserializer: __D, ) -> Result<HoprSenderId, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for HoprSenderId

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

where __H: Hasher,

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 HoprSenderId

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

fn random() -> HoprSenderId

Generates random value of this type using a cryptographically strong RNG.

impl Serialize for HoprSenderId

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<'a> TryFrom<&'a [u8]> for HoprSenderId

type Error = GeneralError

The type returned in the event of a conversion error.

fn try_from( value: &'a [u8], ) -> Result<HoprSenderId, <HoprSenderId as TryFrom<&'a [u8]>>::Error>

Performs the conversion.

impl Copy for HoprSenderId

impl Eq for HoprSenderId

impl StructuralPartialEq for HoprSenderId