A self made implementation of QUIC Version 1 in Rust following RFC 9000 and 9001, accompanied by my bachelors thesis. For now, this is purely a research project and in no way intended for commercial use!
This repository contains my bachelor thesis from Heinrich-Heine Universität Düsseldorf, Germany. It has the title "Development Of A Minimal QUIC Implementation In Rust: An Introduction To Next Generation Networking", is written in english, and covers the design and connection mechanics of QUIC as well as details of my implementation as of the submit date. The rendered pdf can be found in the document subdirectory. It may also be helpful to those who simply want to get started with QUIC without using the RFCs directly.
The QUIC library is still in a very early development stage and a majority of the features required for any kind of meaningful use are not yet implemented. As I lack the resources of the likes of Amazon, Cloudflare and co, development may only progress slowly. The following features are implemented:
- QUIC 1-RTT handshake
- QUIC stream implementation
- Async socket io
- Full TLS 1.3 integration using rustls
- Server API for easy integration with HTTP/3 or other application protocols
The current implementation works with quinn's example client implementation as described in the Run section. The handshake is completed successfully and the client-initiated bidirectional stream is successfully proccessed on my side. An answer is successfully sent. The required certificate to accept a connection from quinn's client can be found in their repo.
Though it may seem to work fine, the core library and its async wrapper lack many of the features required for any kind of robust communication. Currently in development are:
- Async wrapper for core quic library
- Congestion control with loss detection and retransmissions
- Flow control
- Client API implementation
The top level server API design (Client API coming sometime in the future) is heavily inspired by Amazons QUIC API design.
I am also only learning the deep ends of Rust through this project so dont expect top-notch Rust code.
Feel free to open a pull request or report an issue. All contributions are welcome!
Building requires a recent version of rustc (>=1.80.0):
# Clone & Build
$ git clone https://github.com/ilumary/taurus.git
$ cd taurus/project/ && cargo buildNote Windows can't be officially supported. Rust should work cross platform though.
Currently the Client API is not yet implemented. Therefore one has to use an external QUIC implementation to act as Client. I recommend quinn. The local server implementation can be found in main.rs.
# Start the server
~/taurus/project/ $ cargo run# Start client
~/quinn/ $ cargo run --example client https://localhost:4433/Cargo.tomlTaurus uses the following open source packages:
ilumary - Me
MIT