Skip to main content

Module fabric

Module fabric 

Source
Expand description

Capability-scoped connection fabric (CSCP, draft-webcivics-cscp-00).

Applications call [connect]. The fabric admits intent, resolves a private contact, excludes prohibited paths, then scores the remainder. CSCP is a control protocol. This crate does not implement QUIC, MASQUE, or a new cipher.

Re-exports§

pub use carrier::CarrierKind;
pub use carrier::PathClass;
pub use connect::connect;
pub use connect::ConnectHandle;
pub use connect::DriveOutcome;
pub use connect::Fabric;
pub use contact::ContactDescriptor;
pub use contact::LocatorKind;
pub use evidence::ObserverKind;
pub use evidence::PathEvidence;
pub use evidence::TransportWitness;
pub use intent::ConnectionIntent;
pub use intent::PeerId;
pub use intent::ProtectionPolicy;
pub use intent::Purpose;
pub use intent::PurposeClass;
pub use kernel::FabricError;
pub use kernel::FabricState;
pub use kernel::Kernel;
pub use kernel::KernelEffect;
pub use kernel::KernelEvent;
pub use lease::CustodyLease;
pub use lease::RelayLease;
pub use mailbox::PrivateMailbox;
pub use receipt::OpReceipt;
pub use receipt::ReceiptStatus;
pub use select::exclude_then_rank;
pub use select::RankedPath;
pub use session::SessionReady;
pub use wire::connect_from_wire;
pub use wire::encode_connect_request;
pub use wire::CscpError;
pub use wire::RejectReason;

Modules§

capsule
RFC 9297-style HTTP Datagram capsule framing for CSCP bytes.
carrier
Path classes and carrier kinds. Adding a carrier must not enlarge disclosure.
connect
connect(peer, purpose, protection, budget) — the application surface.
contact
Private contact descriptor. Discovery, not traversal, and not concealment.
evidence
Path evidence. Successful validation is not a public constructor.
experiments
Named falsifiable experiments from the fabric design §7.
intent
Connection intent: who, why, under which constraints. Not reachability.
kernel
Bounded fabric kernel. Same admitted inputs produce the same effects.
lease
Relay leases and custody leases are distinct commitments.
lease_protocol
Apply CSCP RelayLease bytes. Custody cannot forward. Relay-only cannot export observations.
mailbox
Invitation-scoped private mailbox. Not a public DHT.
outcome
ConnectAccept / ConnectReject from kernel + local evidence.
receipt
Durable operation receipts. A relay write is not a commit.
receipt_store
CRC-backed CSCP receipts. Truncation fails closed. Not a live path.
relay
Local bound-UDP relay. Topology of two outbound clients; not MASQUE HTTP/3.
select
Exclude prohibited paths, then rank remaining evidence. Never the reverse.
session
SessionReady exists only after verified path evidence and a live grant.
wire
CSCP v1 TLV helpers. draft-webcivics-cscp-00 §4.