Struct SessionId 

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

A completed session’s channel binding — hiss’s type, re-exported.

[RATIFIED 2026/08/15 — ruling 89] SessionId is hiss::noise::SessionId and not a slither wrapper: hiss derives it from the handshake hash, both peers of a session produce the same value, and it is a public channel-binding value meant for out-of-band comparison — logging it, or a short-authentication-string check between peers. A slither wrapper would be a type that must be kept equal to hiss’s by hand, for no gain.

Its Eq is not constant-time

By hiss’s deliberate choice. It carries no secret material and must not be used to compare one: reaching for it as a session token or an authentication comparison is the mistake this paragraph exists to prevent.

Read it off a live connection with Connection::session_id. Unique identifier for a Noise session, derived from the handshake hash.

Both peers in a completed handshake produce the same SessionId.

Equality is not constant-time

The derived PartialEq/Eq compare the raw bytes with the standard slice comparison, which short-circuits on the first differing byte and is therefore not constant-time. This is acceptable because a SessionId is a public channel-binding value: it is meant to be compared out-of-band — e.g. as a short-authentication-string check between peers — and carries no secret material. Do not use this type (or its equality) to compare secrets; reach for a constant-time comparison there instead.

Implementations

impl SessionId

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

The raw bytes of this session identifier.

Trait Implementations

impl AsRef<[u8]> for SessionId

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

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

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

Formats the value using the given formatter.

impl Display for SessionId

Renders the session id as lowercase hex.

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

Formats the value using the given formatter.

impl Eq for SessionId

impl From<Vec<u8>> for SessionId

fn from(bytes: Vec<u8>) -> SessionId

Converts to this type from the input type.

impl Hash for SessionId

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 SessionId

fn eq(&self, other: &SessionId) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for SessionId