sigil-http3 / treeREADME.md
sigil-http3
Experimental server HTTP/3 and WebTransport for Sigil. The library provides bounded HTTP/3 framing, static QPACK, stream transport, request validation, and WebTransport session routing over sigil-quic.
Status
Early development. Frame and SETTINGS codecs, bounded Huffman decoding, request HEADERS/DATA/trailers, control streams, concurrent server streams, CONNECT/session routing, capsules, and stream/DATAGRAM echo are implemented. The browser driver targets the legacy draft02 WebTransport profile. This is not a general HTTP/3 client/server or an implementation of the latest WebTransport draft. Dynamic QPACK is unsupported. Phone reachability and migration across real networks remain experimental; loopback checks do not establish either. Independent security review is needed before production use.
Dependency
Add this entry to your package.sgl dependencies, then run sigil deps install:
(from-git url: "codeberg:sigil/sigil-http3" branch: "master")The manifest pins the accompanying sigil-quic and sigil-nat revisions. The endpoint adapter needs IPv4/IPv6-aware UDP support: udp-socket families and socket-normalize-address. This support is not in a released Sigil yet and is planned for an upcoming release. Codec use does not establish endpoint availability.
Usage
Encode and decode a DATA frame without opening a connection:
(import (sigil http3 frame))
(let* ((wire (encode-h3-frame 0 #u8(104 105)))
(frame (decode-h3-frame wire)))
(display (vector-ref frame 0)) ; => 0 (DATA)
(vector-ref frame 1)) ; => #u8(104 105)(sigil http3 connection) attaches server stream handling to a QUIC engine. (sigil http3 webtransport router) emits application commands for CONNECT sessions and associated streams. See the router contract, browser profile, and bounded echo lifecycle.
Tests
From a checkout, prepare the exact companion sources, then run the Sigil suite:
bash scripts/prepare-quic.sh
bash scripts/prepare-nat-dependency.sh
sigil deps install
sigil test --report
cd tools/interop
sigil deps install
sigil test --reportThe preparation scripts accept a local repository or Git URL as their first argument. HTTP3_QUIC_SOURCE and HTTP3_NAT_SOURCE override the defaults. The codec and interop suites have 123 cases combined; endpoint integration checks need the socket-capable runtime described above.
With Node.js 20 or later, OpenSSL and loopback UDP/HTTPS available:
bash scripts/phantom-lifecycle-check.sh
node --test test/test-punch-prime.mjs test/test-continuous-punch-window.mjs
node --test tools/port-mapping/test-codecs.mjsThe retained phantom- script names are compatibility names. A Linux host with a C toolchain runs builds; browser probes additionally need Chrome. Live helpers use explicit host, interface, origin and input-directory settings; see tool configuration. Browser, phone and public-network checks are separate from the offline suite.
License
BSD-3-Clause. See LICENSE. Generated QPACK/Huffman tables retain their RFC source attribution in the source files.