Struct Connection 

pub struct Connection { /* private fields */ }

Per-peer state machine for one FCP connection attempt.

Implementations

impl Connection

pub fn new( federation: FederationId, attempt: AttemptId, local: EndpointIdentity, remote: EndpointIdentity, ) -> Result<Self, Error>

Creates an idle connection pinned to one federation, attempt and complete remote identity.

pub const fn federation(&self) -> FederationId

Returns the federation namespace pinned for this attempt.

pub const fn attempt(&self) -> AttemptId

Returns the application-provided attempt identifier pinned for this connection.

pub const fn local_endpoint(&self) -> EndpointIdentity

Returns the complete local FCP endpoint identity pinned for this connection.

pub const fn remote_endpoint(&self) -> EndpointIdentity

Returns the complete remote FCP endpoint identity pinned for this connection.

pub const fn phase(&self) -> Phase

Returns the current lifecycle state.

pub fn begin_offer<S: EndpointSigner>( &mut self, signer: &S, binding: WebRtcBinding, description: Vec<u8>, ) -> Result<Vec<Action>, Error>

Starts a local offer from Idle.

pub fn answer<S: EndpointSigner>( &mut self, signer: &S, binding: WebRtcBinding, description: Vec<u8>, ) -> Result<Action, Error>

Answers one accepted remote offer.

pub fn candidate<S: EndpointSigner>( &self, signer: &S, sequence: u32, candidate: Vec<u8>, ) -> Result<Action, Error>

Creates a candidate bound to the active negotiation.

pub fn cfr_control<S: EndpointSigner>( &self, signer: &S, payload: Vec<u8>, ) -> Result<Action, Error>

Emits one bounded raw CFR control envelope after WebRTC connection is established.

pub fn close<S: EndpointSigner>( &mut self, signer: &S, reason: CloseCode, ) -> Result<Action, Error>

Emits a local close and closes the core attempt.

pub fn receive(&mut self, envelope: Envelope) -> Result<Vec<Action>, Error>

Processes a received envelope only after exact binding and signature validation.

pub fn transport_connected(&mut self) -> Result<Vec<Action>, Error>

Records that the platform adapter reached a connected WebRTC control channel.

pub fn transport_failed(&mut self) -> Result<(), Error>

Records a local platform failure and stops this attempt without manufacturing a remote close.

Trait Implementations

impl Debug for Connection

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

Formats the value using the given formatter.