Enum HandshakeError 

pub enum HandshakeError {
    UnexpectedFrame,
    UnsupportedVersion,
    Malformed,
    ProfileMismatch,
    KeyPurposeReuse,
    PeerIdentityMismatch {
        expected: [u8; 32],
        derived: [u8; 32],
    },
    PuzzleInvalid,
    ProofInvalid,
    Refused(RefusalCode),
    InvalidStationSession,
    SessionProofInvalid,
    SessionProofMissing,
    SessionProofRate,
    V4HelloToV5Connect,
    ExporterUnavailable,
    Binding(BindingError),
    Key(KeyError),
}

The handshake’s close reasons, named as macula names them. A binding or status statement that fails its check closes with its BindingError.

Variants

UnexpectedFrame

A frame of another type than the one expected next.

UnsupportedVersion

A frame of another version than 4.

Malformed

A frame that does not decode exactly, or a carried key or proof of the wrong form.

ProfileMismatch

A challenge that names another profile.

KeyPurposeReuse

A key that would serve two purposes: a CONNECT key that shares a half with its identity key, or a key found in the leaf.

PeerIdentityMismatch

A station whose node_id is not the one dialed.

Fields

expected: [u8; 32]

derived: [u8; 32]

PuzzleInvalid

A client whose node_id does not meet the puzzle.

ProofInvalid

A CONNECT proof that does not verify.

Refused(RefusalCode)

A HELLO that refuses the connection, with its code.

InvalidStationSession

A station session with a puzzle difficulty the design does not have.

SessionProofInvalid

A v5 HELLO whose session proof does not verify under the station’s identity key over this session.

SessionProofMissing

A v5 HELLO that accepts without a session proof.

SessionProofRate

A station past its session proof budget.

V4HelloToV5Connect

A v4 HELLO that accepts a v5 CONNECT: never taken as a v4 connection.

ExporterUnavailable

A v5 session whose TLS exporter gave no value.

Binding(BindingError)

A binding or status statement that did not verify.

Key(KeyError)

A key that could not sign, or randomness that could not be drawn.

Trait Implementations

impl Clone for HandshakeError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HandshakeError

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

Formats the value using the given formatter.

impl Display for HandshakeError

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

Formats the value using the given formatter.

impl Eq for HandshakeError

impl Error for HandshakeError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<BindingError> for HandshakeError

fn from(e: BindingError) -> Self

Converts to this type from the input type.

impl From<HandshakeError> for LinkError

fn from(e: HandshakeError) -> Self

Converts to this type from the input type.

impl PartialEq for HandshakeError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for HandshakeError