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))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-each24
(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-each31
(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 #x10836
(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 maximum40
(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 maximum49
(vector-ref (decode-webtransport-datagram (encode-webtransport-datagram maximum #u8())) 0))))51
(test "truncated and overflowing datagram prefixes are H3_DATAGRAM_ERROR"52
(for-each53
(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-limit60
(bytevector-length (encode-webtransport-datagram 0 (make-bytevector 1023 7))))61
(assert-equal #x10762
(wt-wire-code (lambda () (encode-webtransport-datagram 0 (make-bytevector 1024 7)))))63
(assert-equal #x10764
(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! state89
(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! state99
(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 #x10e106
(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-each114
(lambda (bytes)115
(assert-equal #x10e116
(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 #x10e122
(wt-wire-code123
(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 #x10e129
(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-each133
(lambda (bytes)134
(assert-equal #x10e135
(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-each141
(lambda (reason)142
(assert-error (encode-webtransport-close 0 reason))143
(assert-equal #x10e144
(wt-wire-code145
(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-each151
(lambda (reason)152
(assert-equal 1153
(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 1160
(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-error168
(webtransport-capsules-input! (make-webtransport-capsules) (make-bytevector 4097 0) #f))169
(assert-equal #x107170
(wt-wire-code171
(lambda ()172
(webtransport-capsules-input! (make-webtransport-capsules)173
(bytes-append #u8(0) (encode-varint 1025)) #f))))174
(assert-equal #x107175
(wt-wire-code176
(lambda ()177
(webtransport-capsules-input! (make-webtransport-capsules)178
(apply bytes-append (make-list 257 #u8(2 0))) #f))))))