dignifiedquire
bfa8b43975
Previously, receiving PATH_ABANDON for the only remaining path was rejected with `ClosePathError::LastOpenPath`, killing the connection via `TransportError::NO_VIABLE_PATH` without accepting the abandon or sending a reciprocal PATH_ABANDON. Per draft-ietf-quic-multipath-21 Section 3.4, PATH_ABANDON is non-optional: the endpoint MUST accept it and send a reciprocal. When it's the last path, the spec says SHOULD send CONNECTION_CLOSE, but a client MAY open a new path instead. Changes: - `close_path_inner` now accepts both locally- and remote-initiated abandon of the last path (previously blocked both) - Remote CIDs are preserved for last-path abandon so PATH_ABANDON can be sent on the abandoned path itself - New `ConnTimer::NoViablePath` grace timer (~1 PTO) starts when the last path is abandoned. If a new path is opened within the grace period (cancelled in `ensure_path`), the connection survives. Otherwise CONNECTION_CLOSE is sent when the timer fires. - Frame handler no longer returns transport error for last-path abandon - Updated `path_close_last_path` test: closing last path now succeeds and triggers connection close
noq
General purpose implementation of the QUIC transport
protocol in pure
Rust. Noq is built as an async-friendly API in the noq crate on top
of a sans-io protocol library in noq-proto.
Noq started out as a fork of the excellent Quinn project. The main focus of development has been towards adding support for more QUIC (draft) extensions:
Features
- Easy to use futures-based async API.
- Client and server server functionality.
- 0-RTT and 0.5-RTT data support.
- Ordered and unordered stream reads.
- Custom and zero-length connection identifiers.
- Fully pluggable crypto API with a Rustls implementation using ring or aws-lc-rs provided by default for convenience.
- Broad platform support, including Linux, Windows, macOS, android, iOS and wasm.
Standards
The noq library aims to be correct implementation of various QUIC standards:
- Supports the core QUIC specifications:
- RFC 8999 - Version-Independent Properties of QUIC.
- RFC 9000 - QUIC: A UDP-Based Multiplexed and Secure Transport.
- [RFC 9001 - Using TLS to Secure QUIC].
- RFC 9002 - QUIC Loss Detection and Congestion Control.
- The standardised QUIC extensions:
- Draft extensions:
- qlog: Structured Logging for Network Protocols.
- QUIC Multipath.
- With experimental qlog support.
- QUIC Address Discovery (QAD).
- Using QUIC to traverse NATs (QNT).
Getting started
Examples at https://github.com/n0-computer/noq/blob/main/noq/examples
$ cargo run --example server ./
$ cargo run --example client https://localhost:4433/Cargo.toml
This launches an HTTP 0.9 server over the QUIC transport on the loopback address serving the current working directory, with the client fetching ./Cargo.toml. By default, the server generates a self-signed certificate and stores it to disk, where the client will automatically find and trust it.
License
Copyright 2025 The quinn developers Copyright 2025 N0, INC.
This project is licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.