Skip to content

v1.0.0-pre.6

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 19 Nov 08:48
f48965b

1.0.0-pre.6 - 2026-11-19

Highlights

  • Full-Stack TURN-over-TCP for UDP-Blocked Networks (#1286, #1287, #1289)

    • rings-turn TCP + UDP Dual Listener: rings-turn now listens on TCP alongside UDP on the configured TURN bind addresses, framing RFC 5389 STUN messages and RFC 5766 ChannelData over stream connections with bounded concurrency and per-frame timeouts.
    • Native WebRTC TURN-over-TCP Client Bridge: Added a local UDP-to-TCP/TLS TURN relay bridge in rings-transport (native-webrtc) supporting turn:host:port?transport=tcp and turns:host:port. In environments where OS UDP sockets are blocked, prepare_native_ice_config transparently provisions a VNet with RTCIceTransportPolicy::Relay.
    • 4-Phase Bridge Lifecycle & Outbound Drain Barrier: The bridge follows a formally verified Active -> Quiescing -> Draining -> Cancelled lifecycle that locally rejects bare gather_candidates_srflx STUN Binding probes with 400 Bad Request (preventing bogus TCP-backed srflx candidates and 5s gather stalls), drops inbound ChannelData during teardown quiescence, flushes queued outbound DTLS close_notify and TURN Refresh(0) frames before cancellation, and retires half-closed TCP sessions immediately on read EOF.
  • Browser-to-Seed Direct HTTP WebRTC Handshake & NAT Traversal (#1288, #1290)

    • Deferred Responder Remote ICE Candidate Injection: native-webrtc's webrtc_answer_offer strips remote a=candidate: lines before set_remote_description, generates and gathers the local Answer SDP first, and injects the remote candidates via add_ice_candidate right before returning the HTTP response—preventing responder STUN checks from hitting the browser's NAT before the browser receives the Answer SDP.
    • Scoped Unrouted Container-Bridge Filter for NAT 1:1 IPs: When external_ip activates set_nat_1to1_ips, native-webrtc filters out host-side unrouted container bridge interfaces (docker*, veth*, virbr*, cni*, flannel*, cali*, and 12-hex-digit br-<id>) so 1:1 NAT host candidates are not duplicated onto dead bridge sockets, while preserving container-internal eth0, system bridges (br0, br-lan), and WireGuard (wg0).
  • Universal IceCandidateTier Semilattice Settle Law (#1288, #1289, #1290)

    • Browser ICE gathering (web-sys-webrtc) is now governed by the pure IceGatherState transition algebra over IceCandidateTier (Host < Reflexive < Relay): the 300 ms quiet-window settle timer is armed iff candidate_tier >= target_tier, ensuring non-trickle SDP never finalizes a host-only description while configured STUN (Reflexive) or TURN (Relay) candidates are still pending, and resets its epoch on every subsequent candidate arrival.
  • Formal Verification & Mutant Refutation (#1289, #1290)

    • Added exhaustive stateright model checkers and mutant refutation suites for IceGatherState (test_ice_gather_model), TurnBridgePhase (test_turn_tcp_model, 7 mutants refuted), and the PeerConnectionLifecycle × Handshake product automaton (test_lifecycle_model, 38,416 paths verified).

Published Crates (crates.io)

All 15 workspace crates are published at 1.0.0-pre.6:
rings-aez, rings-codec, rings-core, rings-derive, rings-dns-relay, rings-gateway, rings-measure, rings-network-policy, rings-node, rings-rpc, rings-runtime, rings-transport, rings-tui, rings-turn, rings-webview.

Full Changelog: https://github.com/RingsNetwork/rings/compare/v1.0.0-pre.5..v1.0.0-pre.6