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.