bornera-rustls 0.0.1-rc.4

Bounded rustls transports and socket-free TLS sessions for Bornera owners.
Documentation

Model

Bornera reserves bounded capacity before a protocol adapter prepares a frame, then takes ownership only when the complete frame is committed:

reserve -> prepare -> commit -> drive -> complete or recover

The production owner runs many connection slots through one selector. The same selector-free policy can also run under deterministic simulation.

Crates

Crate Purpose
bornera Shared-selector production ownership for native transports
bornera-core Sans-I/O admission, framing, deadlines, delivery, and recovery policy
bornera-rustls Bounded rustls client transport and socket-free server session
bornera-sim Unpublished deterministic trace replay and generated properties

The crates remain version-locked during pre-alpha. The rustls server session is socket-free in ownership, source, and operation. It is not yet isolated from the production client stack in the crate dependency graph.

Start

[dependencies]
bornera = "=0.0.1-rc.4"
bornera-core = "=0.0.1-rc.4"
calandria = { version = "=0.0.1-rc.2", features = ["std"] }

Run the embedded production example from a checkout:

cargo run -p bornera --example embedded --locked --offline

See the dedicated-owner example for the thread-owned hosting model and the architecture guide for TLS setup and integration boundaries.

Guarantees

  • Admission is bounded before ownership transfers.
  • Accepted work completes exactly once or transfers through explicit recovery.
  • Delivery certainty is intentionally limited to NotSent and PossiblySent.
  • Connection generations and epochs fence stale work.
  • Protocol semantics, routing, retries, DNS, and address selection stay with the caller.

Documentation

Qualification

zcheck

The canonical gate covers architecture, formatting, Clippy, rustdoc, tests, package contents, and packaged-crate smoke compilation. Bornera requires Rust 1.88 or newer; the full evidence matrix is documented in qualification.

License

Apache-2.0. See LICENSE.