syncsynchalt/illustrated-quic

The Illustrated QUIC Connection: Every byte explained

The Illustrated QUIC Connection

Published at https://quic.xargs.org

• site/: page source for the finished product
• server/main.c: server code
• client/main.c: client code
• quiche/: patch of Cloudflare Quiche / BoringSSL that removes any random aspects of the documented connection
• captures/: PCAP and keylog files

See also https://github.com/syncsynchalt/illustrated-tls13 for a similar TLS version of this project.

Build instructions

If you'd like a working example that reproduces the exact handshake documented on the site:

git clone https://github.com/syncsynchalt/illustrated-quic.git
cd illustrated-quic/
cd quiche/
make
cd ../server/
make
cd ../client/
make

Then open two terminals and run ./server in the server/ subdir and ./client in the client/ subdir.

This has been shown to work on macOS 12 and only has a few easy-to-find dependencies: gcc or clang, rust, cmake, make, patch.

illustrated-quic's Issues

chinese translation

Hi, I am a web developer from China. What you wrote was very helpful to me, so I translated these contents from your site. Hope this can influence more people.

You can find the source code on github and see the translated content on github-page.

If there are any copyright or other related issues, please advise me!

Client Initial Keys Calc errors

should be client_secret.

Invalid header protection value

If my math is correct, I think that the encoded packet header byte on the last frame (UDP Datagram 8 - Close connection) at [https://quic.xargs.org/#server-application-packet-2] is incorrect. Packet header byte 54 should be 44.