Enum ConnectionState 

#[non_exhaustive]
#[repr(u8)]
pub enum ConnectionState {
    Connecting = 0,
    ClassicalReady = 1,
    PqcUpgrading = 2,
    PqcReady = 3,
    Connected = 4,
    Failed = 5,
    Closed = 6,
    Migrating = 7,
    Dead = 8,
}

Available on crate feature std only.

Connection state for PhantomSession.

The session is usable from the moment it’s created — sends are queued until the handshake completes.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Connecting = 0

Connection initiated, handshake pending

ClassicalReady = 1

Classical (X25519) channel established — data flows

PqcUpgrading = 2

PQC upgrade in progress

PqcReady = 3

Full hybrid PQC protection active

Connected = 4

Fully connected and operational

Failed = 5

Connection failed

Closed = 6

Gracefully closed

Migrating = 7

The active path went silent (liveness lost); the session is held alive (keys retained, outbound buffered) awaiting a migrate() or the path’s return. The embedder reacts by calling migrate() (Phase 4 / P4.3).

Dead = 8

The session is dead: the path stayed down past the migration idle-timeout with no recovery. Terminal — recv() errors instead of hanging (P4.3).

Implementations

impl ConnectionState

pub fn is_data_ready(&self) -> bool

Whether data can flow (classical or better). Migrating counts as ready: the keep-alive window still accepts send() (buffered + retransmitted until the path recovers), so the embedder’s send path doesn’t error mid-migration.

Trait Implementations

impl Clone for ConnectionState

fn clone(&self) -> ConnectionState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<UT> ConvertError<UT> for ConnectionState

fn try_convert_unexpected_callback_error( e: UnexpectedUniFFICallbackError, ) -> Result<Self>

impl Copy for ConnectionState

impl Debug for ConnectionState

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

Formats the value using the given formatter.

impl Eq for ConnectionState

impl<UT> FfiConverter<UT> for ConnectionState

const TYPE_ID_META: MetadataBuffer

Type ID metadata, serialized into a MetadataBuffer.

type FfiType = RustBuffer

The low-level type used for passing values of this type over the FFI.

fn lower(v: Self) -> RustBuffer

Lower a rust value of the target type, into an FFI value of type Self::FfiType.

fn try_lift(buf: RustBuffer) -> Result<Self>

Lift a rust value of the target type, from an FFI value of type Self::FfiType.

fn write(obj: Self, buf: &mut Vec<u8>)

Write a rust value into a buffer, to send over the FFI in serialized form.

fn try_read(buf: &mut &[u8]) -> Result<Self>

Read a rust value from a buffer, received over the FFI in serialized form.

impl<UT> Lift<UT> for ConnectionState

type FfiType = <ConnectionState as FfiConverter<UT>>::FfiType

fn try_lift(v: Self::FfiType) -> Result<Self>

fn try_read(buf: &mut &[u8]) -> Result<Self>

fn try_lift_from_rust_buffer(v: RustBuffer) -> Result<Self, Error>

Convenience method

impl<UT> LiftRef<UT> for ConnectionState

type LiftType = ConnectionState

impl<UT> LiftReturn<UT> for ConnectionState

type ReturnType = <ConnectionState as Lift<UT>>::FfiType

FFI return type for trait interfaces

fn try_lift_successful_return(v: Self::ReturnType) -> Result<Self>

Lift a successfully returned value from a trait interface

fn lift_foreign_return( ffi_return: Self::ReturnType, call_status: RustCallStatus, ) -> Self

Lift a foreign returned value from a trait interface

fn lift_error(_buf: RustBuffer) -> Self

Lift a Rust value for a callback interface method error result

fn handle_callback_unexpected_error(e: UnexpectedUniFFICallbackError) -> Self

Lift a Rust value for an unexpected callback interface error

impl<UT> Lower<UT> for ConnectionState

type FfiType = <ConnectionState as FfiConverter<UT>>::FfiType

fn lower(obj: Self) -> Self::FfiType

fn write(obj: Self, buf: &mut Vec<u8>)

fn lower_into_rust_buffer(obj: Self) -> RustBuffer

Convenience method

impl<UT> LowerError<UT> for ConnectionState

fn lower_error(obj: Self) -> RustBuffer

Lower this value for scaffolding function return

impl<UT> LowerReturn<UT> for ConnectionState

type ReturnType = <ConnectionState as Lower<UT>>::FfiType

The type that should be returned by scaffolding functions for this type.

fn lower_return(v: Self) -> Result<Self::ReturnType, RustCallError>

Lower the return value from an scaffolding call

fn handle_failed_lift( error: LiftArgsError, ) -> Result<Self::ReturnType, RustCallError>

Lower the return value for failed argument lifts

impl PartialEq for ConnectionState

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

impl<UT> TypeId<UT> for ConnectionState

const TYPE_ID_META: MetadataBuffer