Skip to content

v1.0.0-pre.1

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 10 Nov 15:28
· 5 commits to master since this release
7181ca9

Rings v1.0.0-pre.1 — 1.0 Pre-Release Candidate

Rings v1.0.0-pre.1 completes the full 1.0 Milestone engineering and verification sweep across rings-core, rings-transport, rings-node, rings-dns-relay, rings-gateway, rings-rpc, and rings-measure (v1.0.0-pre.0..v1.0.0-pre.1).

Highlights

1. Onion Kleisli Pipelines (Phase 2b — #834, #1246)

  • Client-Sealed Operation Loops: Circuits are now constructed as Kleisli pipelines (OnionInvokePipeline) over registered intermediate operation symbols (OnionInvokeDescriptor / OnionInvokeShape) in addition to terminal exit sessions.
  • Guard-Closed Multi-Hop Routing: Added OnionPipelineRouteCandidates and select_onion_pipeline_route_from_candidates with entry-guard closure, pairwise-distinct intermediate hops, and deterministic RouteEntropy injection.
  • End-to-End Pipeline Session Driver: Added OnionPipelineClient and Processor::open_onion_pipeline to drive multi-hop invoke pipelines over client-supplied SURBs.

2. DHT Routing, Non-Transitive Connectivity & Relay Custody (#1202, #1219, #1221, #1222, #1223 — #1237–#1240)

  • Final Admission & Destination Binding (#1219): Bound relay.destination to transaction.destination and enforced final admission checks across all locally terminated and redirected frames.
  • Passive Bridge Routing & Predecessor Hygiene (#1221): Eliminated passive bridge routing blackholes, isolated topology::find_successor ownership from bridged hints, and pruned stale predecessors on stabilization.
  • Relay Custody & Handoff Convergence (#1202): Added retry for lost custody declarations, bound handoff cleanup acknowledgements (SyncedEntryAck) to custody incarnation counters, and keyed inbox consumption by full transaction identity.
  • Swarm & Delegation Lifecycle (#1222, #1223): Released send_connection_offer pending slots on error, corrected candidate dial backoff accounting, cancelled superseded finger leases on glare rebind, and preserved previous-generation onion hop decryption keys across in-process delegation renewal.

3. Storage, CRDT Provenance & Crash Recovery (#1203, #1212, #1220, #1225 — #1235, #1236, #1244, #1247)

  • Authenticated EntryKind::Data CRDT Provenance (#1220): Added EntryOperationProof binding every CRDT register write, extend, and tombstone to a verified writer signature; scoped tombstones and horizon floors by actor; implemented fair water-filling of unique values across actors.
  • Batch & Transaction Atomicity (#1225): Enforced IdbStorage::put_batch capacity/order invariants, net-delta byte budget accounting in FileStore::store_batch, and single-transaction access_clock persistence.
  • CarrierStore & DNS Relay Journal Recovery (#1203, #1212): Staged CarrierStore recovery accounting to prevent retry double-charging, reconciled uncertain commits, retried failed DNS relay announcement withdrawals, and truncated torn journal tails on startup.

4. Transport & Session Progress (#1090, #1199, #1200, #1201, #1224, #1226, #1231 — #1233, #1241–#1243, #1245, #1248, #1251)

  • Upstream webrtc 0.17.3 Upgrade (#1090, #1251): Upgraded webrtc and webrtc-sctp to 0.17.3 (incorporating webrtc-rs/webrtc#941 batched SCTP packet dispatch) and removed the local vendor/webrtc-sctp patch.
  • Native WebRTC Close Serialization (#1199): Prevented Failed callback deadlocks and serialized NativePhysicalCloseWitness completion.
  • Onion Session & Extension I/O Progress (#1200, #1201): Prevented TCP pump/driver queue deadlocks, bounded blocked exit and extension TCP writes with per-operation timeouts, aborted dropped browser HTTPS fetches via AbortController, keyed UDP relay flows by listener, and bounded namespace link-fact queues.
  • Onion Admission & Entry Guards (#1224): Fixed OnionAdmissionState live-slot co-location eviction, bounded SlotRoster capacity, and enforced the 1-in-K entry guard gate.
  • Node Shutdown & Async Lock Hygiene (#1226, #1231): Hardened extension transition_gate re-entrancy, bounded mail/provider/processor shutdown, drained TUN gateway and bridge duplex backpressure, and eliminated long-held async locks across I/O paths.

5. Deterministic Capabilities & Formal Stateright Verification (#1206, #1227, #1230 — #1234, #1249, #1250)

  • Injected Clock & SharedRng Capabilities (#1230): Injected deterministic clock and RNG capabilities across rings-core protocol handlers and rings-node onion session drivers.
  • Exhaustive Stateright Model Suite (#1227): Added formal Stateright models for onion circuit admission (test_admission_model), session ordering & SURB pool (test_session_order_model), exit quota & outbox lanes (test_exit_and_lanes_model), multi-round storage repair & handoff crash (repair_model), and service lease readiness (test_lease_and_readiness_model).
  • Pre-1.0 Contract Hardening (#1206): Enforced topological crate publish order, deserialization-time DelegateeKey signature verification, and FFI/RPC contract hygiene.

Installation

curl -fsSL https://rings.rs/install.sh | sh -s -- --version v1.0.0-pre.1