AtlatestRepositorysigil-http3

sigil-http3 / tree / testtest-webtransport-wire.sgl

1(import (sigil test)
2 (sigil quic bytes)
3 (sigil quic wire)
4 (sigil http3 error)
5 (sigil http3 webtransport wire))
6
7(define (wt-wire-code thunk)
8 (guard (exn ((h3-error? exn) (h3-error-code exn)) (else (raise exn)))
9 (thunk)
10 #f))
12(define (wt-capsule type payload)
13 (bytes-append (encode-varint type) (encode-varint (bytevector-length payload)) payload))
15(test-group "WebTransport wire controls"
16 (test "stream prefixes use session IDs without a frame length"
17 (assert-equal #u8(64 65 0) (encode-webtransport-prefix 0 #f))
18 (assert-equal #u8(64 84 4) (encode-webtransport-prefix 4 #t))
19 (assert-equal '#(webtransport 4 3) (decode-webtransport-prefix #u8(64 84 4 7 8) #t))
20 (assert-equal '#(webtransport 0 3) (decode-webtransport-prefix #u8(64 65 0 255) #f)))
22 (test "partial prefixes and other stream types remain distinguishable"
23 (for-each
24 (lambda (bytes) (assert-false (decode-webtransport-prefix bytes #f)))
25 '(#u8() #u8(64) #u8(64 65) #u8(64 65 192)))
26 (assert-equal '#(other 1 1) (decode-webtransport-prefix #u8(1 3 0 0 0) #f))
27 (assert-equal '#(other 84 2) (decode-webtransport-prefix #u8(64 84 0) #f)))
29 (test "session IDs require the correct QUIC initiator and direction"
30 (for-each
31 (lambda (id)
32 (assert-false (webtransport-session-id? id))
33 (assert-equal #x108 (wt-wire-code (lambda () (encode-webtransport-prefix id #f)))))
34 (list -4 1 2 3 4.0 (+ quic-varint-maximum 1)))
35 (assert-equal #x108
36 (wt-wire-code (lambda () (decode-webtransport-prefix #u8(64 65 2) #f))))
37 (let ((maximum (- quic-varint-maximum 3)))
38 (assert-true (webtransport-session-id? maximum))
39 (assert-equal maximum
40 (vector-ref (decode-webtransport-prefix (encode-webtransport-prefix maximum #t) #t) 1))))
42 (test "HTTP datagrams use quarter stream IDs and allow empty payloads"
43 (assert-equal #u8(1 7 8) (encode-webtransport-datagram 4 #u8(7 8)))
44 (assert-equal '#(4 #u8(7 8)) (decode-webtransport-datagram #u8(1 7 8)))
45 (assert-equal '#(0 #u8()) (decode-webtransport-datagram #u8(0)))
46 (assert-equal '#(4 #u8(9)) (decode-webtransport-datagram #u8(64 1 9)))
47 (let ((maximum (- quic-varint-maximum 3)))
48 (assert-equal maximum
49 (vector-ref (decode-webtransport-datagram (encode-webtransport-datagram maximum #u8())) 0))))
51 (test "truncated and overflowing datagram prefixes are H3_DATAGRAM_ERROR"
52 (for-each
53 (lambda (bytes)
54 (assert-equal #x33 (wt-wire-code (lambda () (decode-webtransport-datagram bytes)))))
55 (list #u8() #u8(64) #u8(192 0 0)
56 (encode-varint (+ (quotient quic-varint-maximum 4) 1)))))
58 (test "datagram limits include the HTTP prefix"
59 (assert-equal webtransport-datagram-limit
60 (bytevector-length (encode-webtransport-datagram 0 (make-bytevector 1023 7))))
61 (assert-equal #x107
62 (wt-wire-code (lambda () (encode-webtransport-datagram 0 (make-bytevector 1024 7)))))
63 (assert-equal #x107
64 (wt-wire-code (lambda () (decode-webtransport-datagram (make-bytevector 1025 0))))))
66 (test "close wire fixture uses a uint32 code and UTF-8 octets"
67 (let* ((state (make-webtransport-capsules))
68 (close (encode-webtransport-close #x01020304 #u8(226 130 172))))
69 (assert-equal #u8(104 67 7 1 2 3 4 226 130 172) close)
70 (assert-equal (list (vector 'close #x01020304 #u8(226 130 172)) (vector 'end))
71 (webtransport-capsules-input! state close #t))
72 (assert-true (webtransport-capsules-closed? state))))
74 (test "bytewise fragments preserve close state and wait for FIN"
75 (let* ((state (make-webtransport-capsules))
76 (close (encode-webtransport-close 4294967295 #u8(240 159 152 128))))
77 (do ((index 0 (+ index 1))) ((= index (- (bytevector-length close) 1)))
78 (assert-equal '()
79 (webtransport-capsules-input! state (bytevector-copy close index (+ index 1)) #f)))
80 (assert-equal (list (vector 'close 4294967295 #u8(240 159 152 128)))
81 (webtransport-capsules-input! state (bytevector-copy close (- (bytevector-length close) 1)) #f))
82 (assert-equal (list (vector 'end)) (webtransport-capsules-input! state #u8() #t))
83 (assert-error (webtransport-capsules-input! state #u8() #f))))
85 (test "capsule types are independent of HTTP frame restrictions"
86 (let ((state (make-webtransport-capsules)))
87 (assert-equal (list (vector 'drain) (vector 'datagram #u8(1 2)) (vector 'datagram #u8()))
88 (webtransport-capsules-input! state
89 (bytes-append #u8(2 0) (encode-webtransport-drain)
90 (encode-webtransport-datagram-capsule #u8(1 2)) #u8(0 0)) #f))))
92 (test "unknown capsule values skip across reads without losing following controls"
93 (let ((state (make-webtransport-capsules)))
94 (assert-equal '()
95 (webtransport-capsules-input! state (bytes-append #u8(2) (encode-varint 5000)) #f))
96 (assert-equal '() (webtransport-capsules-input! state (make-bytevector 4096 1) #f))
97 (assert-equal (list (vector 'drain))
98 (webtransport-capsules-input! state
99 (bytes-append (make-bytevector 904 1) (encode-webtransport-drain)) #f)))
100 (let ((state (make-webtransport-capsules)))
101 (assert-equal '()
102 (webtransport-capsules-input! state (bytes-append #u8(2) (encode-varint quic-varint-maximum)) #f))
103 (do ((index 0 (+ index 1))) ((= index 20))
104 (assert-equal '() (webtransport-capsules-input! state (make-bytevector 4096 1) #f)))
105 (assert-equal #x10e
106 (wt-wire-code (lambda () (webtransport-capsules-input! state #u8() #t))))))
108 (test "clean CONNECT FIN is a normal close"
109 (assert-equal (list (vector 'close 0 #u8()) (vector 'end))
110 (webtransport-capsules-input! (make-webtransport-capsules) #u8() #t)))
112 (test "partial headers and payloads at FIN are malformed messages"
113 (for-each
114 (lambda (bytes)
115 (assert-equal #x10e
116 (wt-wire-code (lambda () (webtransport-capsules-input! (make-webtransport-capsules) bytes #t)))))
117 '(#u8(64) #u8(2) #u8(2 5 1 2) #u8(104 67 4 0 0))))
119 (test "CLOSE must be last even across input calls"
120 (let ((close (encode-webtransport-close 0 #u8())))
121 (assert-equal #x10e
122 (wt-wire-code
123 (lambda ()
124 (webtransport-capsules-input! (make-webtransport-capsules)
125 (bytes-append close #u8(2 0)) #f))))
126 (let ((state (make-webtransport-capsules)))
127 (webtransport-capsules-input! state close #f)
128 (assert-equal #x10e
129 (wt-wire-code (lambda () (webtransport-capsules-input! state #u8(2 0) #f)))))))
131 (test "close and drain sizes fail as soon as the header completes"
132 (for-each
133 (lambda (bytes)
134 (assert-equal #x10e
135 (wt-wire-code (lambda () (webtransport-capsules-input! (make-webtransport-capsules) bytes #f)))))
136 (list #u8(104 67 3) (bytes-append #u8(104 67) (encode-varint 1029))
137 (bytes-append (encode-varint #x78ae) #u8(1)))))
139 (test "strict UTF-8 rejects overlong, surrogate, truncated and out-of-range reasons"
140 (for-each
141 (lambda (reason)
142 (assert-error (encode-webtransport-close 0 reason))
143 (assert-equal #x10e
144 (wt-wire-code
145 (lambda ()
146 (webtransport-capsules-input! (make-webtransport-capsules)
147 (wt-capsule #x2843 (bytes-append #u8(0 0 0 0) reason)) #f)))))
148 '(#u8(128) #u8(192 128) #u8(224 128 128) #u8(237 160 128)
149 #u8(240 128 128 128) #u8(244 144 128 128) #u8(245 128 128 128) #u8(226 130)))
150 (for-each
151 (lambda (reason)
152 (assert-equal 1
153 (length (webtransport-capsules-input! (make-webtransport-capsules)
154 (encode-webtransport-close 0 reason) #f))))
155 '(#u8() #u8(0 127) #u8(194 128) #u8(223 191) #u8(224 160 128)
156 #u8(237 159 191) #u8(239 191 191) #u8(240 144 128 128) #u8(244 143 191 191))))
158 (test "close bounds and uint32 endpoints are enforced"
159 (assert-equal 1
160 (length (webtransport-capsules-input! (make-webtransport-capsules)
161 (encode-webtransport-close 0 (make-bytevector 1024 65)) #f)))
162 (assert-error (encode-webtransport-close -1 #u8()))
163 (assert-error (encode-webtransport-close 4294967296 #u8()))
164 (assert-error (encode-webtransport-close 0 (make-bytevector 1025 65))))
166 (test "capsule input, datagram payload and work budgets are independent"
167 (assert-error
168 (webtransport-capsules-input! (make-webtransport-capsules) (make-bytevector 4097 0) #f))
169 (assert-equal #x107
170 (wt-wire-code
171 (lambda ()
172 (webtransport-capsules-input! (make-webtransport-capsules)
173 (bytes-append #u8(0) (encode-varint 1025)) #f))))
174 (assert-equal #x107
175 (wt-wire-code
176 (lambda ()
177 (webtransport-capsules-input! (make-webtransport-capsules)
178 (apply bytes-append (make-list 257 #u8(2 0))) #f))))))