Version0.1.0Verifiednot yet verifiedLicenseBSD-3-Clause

sigil-http3

Experimental server HTTP/3 and WebTransport spike

Report a bug or suggest a feature
Clone

git clone https://git.usesigil.org/sigil/sigil-http3.git

Readme

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)
Read the rest

(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 --report

The 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.mjs

The 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.

Source

Browse the latest source

One page per file, and every line has a permalink.

Recent commitsAtom
25 Octcommit
25 Octcommit
19 Octcommit
19 Octcommit
19 Octcommit
19 Octcommit
19 Octcommit
19 Octcommit
19 Octcommit
19 Octcommit
19 Octcommit
19 Octcommit
19 Octcommit
19 Octcommit
19 Octcommit
19 Octcommit
18 Octcommit
18 Octcommit
18 Octcommit
18 Octcommit

The last 20 commits keep a page here. Everything older lives in the clone.