Expand description
Transport-agnostic FCP federation connection-control core.
Applications use Connection to bind one WebRTC negotiation attempt to a
federation and endpoint keys. The core neither parses SDP/ICE nor CFR
payloads; platform adapters and the CFR bridge own those separate concerns.
Structs§
- Attempt
Id - A fresh application-provided connection-attempt ID.
- Close
Code - A forward-compatible application close code carried in a signed FCP close envelope.
- Connection
- Per-peer state machine for one FCP connection attempt.
- Control
Channel Config - Fixed FCP data-channel configuration that platform adapters must enforce.
- Endpoint
Identity - An immutable FCP endpoint identity.
- Endpoint
Key - An Ed25519 endpoint key used to authenticate FCP envelopes.
- Envelope
- A verified or to-be-signed FCP envelope.
- Envelope
Id - An envelope id derived from the complete canonical signed bytes.
- Federation
Configuration - Immutable federation policy snapshot published by its selected authority.
- Federation
Id - A federation routing namespace.
- Federation
Member - Explicit association between a CFR participant identity and an FCP endpoint identity.
- Signed
Federation Configuration - A federation configuration signed by its configured authority identity.
- Signing
Identity - An implementation-owned signing identity with both required private keys.
- WebRtc
Binding - A digest binding an exact engine description and its DTLS fingerprint.
Enums§
- Action
- An action emitted by the core for an untrusted transport or platform adapter.
- Body
- The kind-specific canonical FCP body.
- Error
- FCP parse, validation and state-machine failure.
- Kind
- FCP envelope kind.
- Phase
- Connection lifecycle state.
Constants§
- CONTROL_
CHANNEL - Required FCP data-channel configuration.
- FCP_
WIRE_ MARKER - Stable FCP wire marker.
- FCP_
WIRE_ VERSION - Current FCP wire version.
- FEDERATION_
CONFIG_ MARKER - Stable marker for a signed FCP federation configuration.
- FEDERATION_
CONFIG_ VERSION - Current signed federation configuration format version.
- MAX_
CANDIDATE_ BYTES - Maximum opaque ICE-candidate length.
- MAX_
CFR_ CONTROL_ BYTES - Maximum carried CFR control payload length.
- MAX_
DESCRIPTION_ BYTES - Maximum opaque offer or answer description length.
- MAX_
ENVELOPE_ BYTES - Maximum complete FCP envelope length, including two endpoint identities and signatures.
- MAX_
FEDERATION_ MEMBERS - Maximum members in one configuration snapshot.
- MAX_
SEEN_ ENVELOPES - Maximum deduplicated accepted envelopes retained per connection attempt.
- ML_
DSA_ 65_ PUBLIC_ KEY_ BYTES - FIPS 204 ML-DSA-65 encoded public-key width.
- ML_
DSA_ 65_ SIGNATURE_ BYTES - FIPS 204 ML-DSA-65 encoded signature width.
- PROTOCOL_
ID - Stable FCP data-channel subprotocol identifier.
Traits§
- Endpoint
Signer - An endpoint capable of producing both mandatory FCP signatures.