Struct PhantomConfig 

#[non_exhaustive]
pub struct PhantomConfig {
    pub keepalive_interval: Duration,
    pub session_timeout: Duration,
    pub max_packet_size: u32,
    pub send_buffer_size: u32,
    pub recv_buffer_size: u32,
    pub session_cache_capacity: u32,
    pub session_ticket_lifetime: Duration,
    pub auto_fallback: bool,
    pub fallback_loss_threshold: u8,
    pub fallback_failure_threshold: u32,
    pub connect_timeout: Duration,
    pub upgrade_delay: Duration,
}

Available on crate feature std only.

Tunable parameters for a Phantom session / listener, exported across the UniFFI boundary as a plain record.

NOTE: this is a stable FFI config surface, but the core does not yet read most of these fields on the live data path — PhantomConfig is currently re-exported and FFI-exported only. The auto_fallback / fallback_* / upgrade_delay fields in particular describe the legacy multi-leg fallback model; transport-leg fallback / aggregation was deliberately dropped in favour of single-path connection migration, so those knobs are presently inert. Treat the presets below as documented intent, not as behaviour the core enforces today.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

keepalive_interval: Duration

Interval between keep-alive pings

session_timeout: Duration

Session inactivity timeout

max_packet_size: u32

Maximum packet size (MTU)

send_buffer_size: u32

Send buffer size in packets

recv_buffer_size: u32

Receive buffer size in packets

session_cache_capacity: u32

Maximum tickets in session cache

session_ticket_lifetime: Duration

Lifetime of a session ticket

auto_fallback: bool

Enable automatic transport fallback (legacy multi-leg model; inert — see the struct-level note).

fallback_loss_threshold: u8

Packet loss percentage to trigger fallback (legacy multi-leg model; inert).

fallback_failure_threshold: u32

Connection failures to trigger fallback (legacy multi-leg model; inert).

connect_timeout: Duration

Timeout for connection attempts

upgrade_delay: Duration

Delay before attempting to upgrade transport (legacy multi-leg model; inert).

Implementations

impl PhantomConfig

pub fn mobile() -> Self

Optimized for mobile devices (LTE/Wi-Fi transitions, power saving)

pub fn server() -> Self

Optimized for servers (high throughput, static IP)

pub fn iot() -> Self

Optimized for IoT devices (extremely low memory, slow networks)

Trait Implementations

impl Clone for PhantomConfig

fn clone(&self) -> PhantomConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<UT> ConvertError<UT> for PhantomConfig

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

impl Debug for PhantomConfig

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

Formats the value using the given formatter.

impl Default for PhantomConfig

fn default() -> Self

Returns the “default value” for a type.

impl<UT> FfiConverter<UT> for PhantomConfig

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 PhantomConfig

type FfiType = <PhantomConfig 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 PhantomConfig

type LiftType = PhantomConfig

impl<UT> LiftReturn<UT> for PhantomConfig

type ReturnType = <PhantomConfig 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 PhantomConfig

type FfiType = <PhantomConfig 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 PhantomConfig

fn lower_error(obj: Self) -> RustBuffer

Lower this value for scaffolding function return

impl<UT> LowerReturn<UT> for PhantomConfig

type ReturnType = <PhantomConfig 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<UT> TypeId<UT> for PhantomConfig

const TYPE_ID_META: MetadataBuffer