Struct SessionId 

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

The type of a session identifier, commonly used by protocols to achieve UC security in the CRS model. It should be unique for each protocol execution. We make it be random by:

• Sampling an original Session ID via a distributed protocol (or via local sampling in tests).
• Refreshing it upon each protocol execution by mixig it with the protocol transcript.

Implementations

impl SessionId

pub fn refresh(&mut self)

Refreshes the session ID on its own.

pub fn refresh_with<T: AsRef<[u8]> + ?Sized>(&mut self, tag: &T)

Refreshes the session ID.

pub fn refresh_from<T: Transcript>(&mut self, transcript: &mut T)

Refreshes the session ID by extracting randomness from a given transcript.

Trait Implementations

impl AsMut<Array<u8, <<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>, B0> as Mul<UInt<UInt<UTerm, B1>, B0>>>::Output as Div<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>>>::Output>> for SessionId

fn as_mut(&mut self) -> &mut Array<u8, CollisionResistanceBytes>

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

impl AsRef<[u8]> for SessionId

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

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

impl AsRef<Array<u8, <<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>, B0> as Mul<UInt<UInt<UTerm, B1>, B0>>>::Output as Div<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>>>::Output>> for SessionId

fn as_ref(&self) -> &Array<u8, CollisionResistanceBytes>

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

impl Clone for SessionId

fn clone(&self) -> SessionId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionId

Available on neither crate feature dev.

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

Formats the value using the given formatter.

impl Default for SessionId

fn default() -> SessionId

Returns the “default value” for a type.

impl DeriveRng for SessionId

fn derive_new(&self, tag: &[u8]) -> Self

Derive new Seed from the current object

fn derive_new_rng(&self, tag: &[u8]) -> ChaCha12Rng

Initializes a ChaCha12 RNG with the session ID as a seed.

fn derive_new_custom_rng<Rng>(&self, tag: &[u8]) -> Rng

where Rng: CryptoRngCore + SeedableRng,

Derive a new seed using the tag and initialize a Rng

fn derive_rng(&self) -> ChaCha12Rng

Initializes a ChaCha12 RNG with the session ID as a seed.

fn derive_custom_rng<Rng>(&self) -> Rng

where Rng: CryptoRngCore + SeedableRng,

Initializes an RNG with the current seed. This is useful for generating random values that are consistent across protocol runs.

impl<'de> Deserialize<'de> for SessionId

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for SessionId

Available on neither crate feature dev.

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

Formats the value using the given formatter.

impl<'sid> From<&'sid SessionId> for &'sid [u8; 32]

fn from(session_id: &'sid SessionId) -> &'sid [u8; 32]

Converts to this type from the input type.

impl From<&SessionId> for [u8; 16]

fn from(session_id: &SessionId) -> [u8; 16]

Converts to this type from the input type.

impl From<&SessionId> for GenericArray<u8, U16>

fn from(session_id: &SessionId) -> GenericArray<u8, U16>

Converts to this type from the input type.

impl From<&SessionId> for u32

fn from(session_id: &SessionId) -> u32

Converts to this type from the input type.

impl From<Array<u8, <<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>, B0> as Mul<UInt<UInt<UTerm, B1>, B0>>>::Output as Div<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>>>::Output>> for SessionId

fn from(value: Digest) -> Self

Converts to this type from the input type.

impl From<SessionId> for [u8; 32]

fn from(session_id: SessionId) -> [u8; 32]

Converts to this type from the input type.

impl<'__deriveMoreLifetime> IntoIterator for &'__deriveMoreLifetime SessionId

where &'__deriveMoreLifetime Array<u8, CollisionResistanceBytes>: IntoIterator,

type Item = <&'__deriveMoreLifetime Array<u8, <<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>, B0> as Mul<UInt<UInt<UTerm, B1>, B0>>>::Output as Div<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>>>::Output> as IntoIterator>::Item

The type of the elements being iterated over.

type IntoIter = <&'__deriveMoreLifetime Array<u8, <<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>, B0> as Mul<UInt<UInt<UTerm, B1>, B0>>>::Output as Div<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>>>::Output> as IntoIterator>::IntoIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'__deriveMoreLifetime> IntoIterator for &'__deriveMoreLifetime mut SessionId

where &'__deriveMoreLifetime mut Array<u8, CollisionResistanceBytes>: IntoIterator,

type Item = <&'__deriveMoreLifetime mut Array<u8, <<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>, B0> as Mul<UInt<UInt<UTerm, B1>, B0>>>::Output as Div<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>>>::Output> as IntoIterator>::Item

The type of the elements being iterated over.

type IntoIter = <&'__deriveMoreLifetime mut Array<u8, <<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>, B0> as Mul<UInt<UInt<UTerm, B1>, B0>>>::Output as Div<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>>>::Output> as IntoIterator>::IntoIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoIterator for SessionId

where Array<u8, CollisionResistanceBytes>: IntoIterator,

type Item = <Array<u8, <<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>, B0> as Mul<UInt<UInt<UTerm, B1>, B0>>>::Output as Div<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>>>::Output> as IntoIterator>::Item

The type of the elements being iterated over.

type IntoIter = <Array<u8, <<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>, B0> as Mul<UInt<UInt<UTerm, B1>, B0>>>::Output as Div<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>>>::Output> as IntoIterator>::IntoIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for SessionId

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for SessionId

impl StructuralPartialEq for SessionId