tigrcorn-transports 0.3.16.dev13__tar.gz → 0.3.17.dev1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (81) hide show
  1. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/PKG-INFO +3 -3
  2. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/pyproject.toml +3 -3
  3. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/connection/__init__.py +43 -0
  4. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/connection/base.py +361 -0
  5. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/connection/core.py +111 -0
  6. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/connection/decode.py +340 -0
  7. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/connection/imports.py +74 -0
  8. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/connection/loss_api.py +28 -0
  9. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/connection/model.py +224 -0
  10. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/connection/receive.py +330 -0
  11. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/connection/runtime.py +377 -0
  12. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/connection/send.py +387 -0
  13. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/crypto/__init__.py +36 -0
  14. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/crypto/aes.py +134 -0
  15. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/crypto/gcm.py +100 -0
  16. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/crypto/keys.py +118 -0
  17. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/crypto/packets.py +185 -0
  18. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/recovery/__init__.py +14 -0
  19. tigrcorn_transports-0.3.16.dev13/src/tigrcorn_transports/quic/recovery.py → tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/recovery/core.py +10 -59
  20. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/recovery/evidence.py +9 -0
  21. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/recovery/model.py +55 -0
  22. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/security/__init__.py +31 -0
  23. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/security/certification.py +184 -0
  24. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/security/helpers.py +69 -0
  25. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/security/runtime.py +252 -0
  26. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/streams/__init__.py +23 -0
  27. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/streams/codec.py +215 -0
  28. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/streams/constants.py +31 -0
  29. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/streams/frames.py +163 -0
  30. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/streams/labels.py +218 -0
  31. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/streams/manager.py +131 -0
  32. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/quic/streams/state.py +237 -0
  33. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports/registry.py +458 -0
  34. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports.egg-info/PKG-INFO +3 -3
  35. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports.egg-info/SOURCES.txt +30 -4
  36. tigrcorn_transports-0.3.17.dev1/src/tigrcorn_transports.egg-info/requires.txt +2 -0
  37. tigrcorn_transports-0.3.16.dev13/src/tigrcorn_transports/quic/connection.py +0 -2178
  38. tigrcorn_transports-0.3.16.dev13/src/tigrcorn_transports/quic/crypto.py +0 -508
  39. tigrcorn_transports-0.3.16.dev13/src/tigrcorn_transports/quic/streams.py +0 -964
  40. tigrcorn_transports-0.3.16.dev13/src/tigrcorn_transports/registry.py +0 -10
  41. tigrcorn_transports-0.3.16.dev13/src/tigrcorn_transports.egg-info/requires.txt +0 -2
  42. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/LICENSE +0 -0
  43. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/README.md +0 -0
  44. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/setup.cfg +0 -0
  45. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/__init__.py +0 -0
  46. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/base.py +0 -0
  47. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/inproc/__init__.py +0 -0
  48. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/inproc/channel.py +0 -0
  49. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/listeners/__init__.py +0 -0
  50. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/listeners/base.py +0 -0
  51. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/listeners/inproc.py +0 -0
  52. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/listeners/pipe.py +0 -0
  53. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/listeners/registry.py +0 -0
  54. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/listeners/tcp.py +0 -0
  55. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/listeners/udp.py +0 -0
  56. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/listeners/unix.py +0 -0
  57. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/pipe/__init__.py +0 -0
  58. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/pipe/connection.py +0 -0
  59. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/py.typed +0 -0
  60. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/quic/__init__.py +0 -0
  61. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/quic/datagrams.py +0 -0
  62. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/quic/flow.py +0 -0
  63. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/quic/handshake.py +0 -0
  64. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/quic/packets.py +0 -0
  65. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/quic/scheduler.py +0 -0
  66. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/quic/tls_adapter.py +0 -0
  67. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/tcp/__init__.py +0 -0
  68. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/tcp/accept.py +0 -0
  69. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/tcp/connection.py +0 -0
  70. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/tcp/reader.py +0 -0
  71. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/tcp/socketopts.py +0 -0
  72. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/tcp/tls.py +0 -0
  73. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/tcp/writer.py +0 -0
  74. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/udp/__init__.py +0 -0
  75. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/udp/endpoint.py +0 -0
  76. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/udp/packet.py +0 -0
  77. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/udp/socketopts.py +0 -0
  78. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/unix/__init__.py +0 -0
  79. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports/unix/connection.py +0 -0
  80. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports.egg-info/dependency_links.txt +0 -0
  81. {tigrcorn_transports-0.3.16.dev13 → tigrcorn_transports-0.3.17.dev1}/src/tigrcorn_transports.egg-info/top_level.txt +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: tigrcorn-transports
3
- Version: 0.3.16.dev13
3
+ Version: 0.3.17.dev1
4
4
  Summary: TCP, UDP, Unix socket, pipe, in-process, listener, and QUIC transport primitives for the Tigrcorn server stack.
5
5
  Author-email: Jacob Stewart <jacob@swarmauri.com>
6
6
  License: Apache License
@@ -186,8 +186,8 @@ Classifier: Typing :: Typed
186
186
  Requires-Python: <3.15,>=3.10
187
187
  Description-Content-Type: text/markdown
188
188
  License-File: LICENSE
189
- Requires-Dist: tigrcorn-core==0.3.16.dev13
190
- Requires-Dist: tigrcorn-config==0.3.16.dev13
189
+ Requires-Dist: tigrcorn-core==0.3.17.dev1
190
+ Requires-Dist: tigrcorn-config==0.3.17.dev1
191
191
  Dynamic: license-file
192
192
 
193
193
  <div align="center">
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "tigrcorn-transports"
7
- version = "0.3.16.dev13"
7
+ version = "0.3.17.dev1"
8
8
  description = "TCP, UDP, Unix socket, pipe, in-process, listener, and QUIC transport primitives for the Tigrcorn server stack."
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10,<3.15"
@@ -29,8 +29,8 @@ classifiers = [
29
29
  "Typing :: Typed",
30
30
  ]
31
31
  dependencies = [
32
- "tigrcorn-core==0.3.16.dev13",
33
- "tigrcorn-config==0.3.16.dev13",
32
+ "tigrcorn-core==0.3.17.dev1",
33
+ "tigrcorn-config==0.3.17.dev1",
34
34
  ]
35
35
 
36
36
  [tool.setuptools]
@@ -0,0 +1,43 @@
1
+ from __future__ import annotations
2
+
3
+ from .core import QuicConnection
4
+ from .model import (
5
+ PACKET_SPACE_APPLICATION,
6
+ PACKET_SPACE_HANDSHAKE,
7
+ PACKET_SPACE_INITIAL,
8
+ PACKET_SPACE_ZERO_RTT,
9
+ QUIC_CONNECTION_STATE_TRANSITION_TABLE,
10
+ QUIC_FLOW_CONTROL_EVIDENCE_MAP,
11
+ QUIC_TRANSPORT_ERROR_MATRIX,
12
+ TRANSPORT_ERROR_APPLICATION_ERROR,
13
+ TRANSPORT_ERROR_INTERNAL_ERROR,
14
+ TRANSPORT_ERROR_INVALID_TOKEN,
15
+ TRANSPORT_ERROR_NO_ERROR,
16
+ TRANSPORT_ERROR_PROTOCOL_VIOLATION,
17
+ TRANSPORT_ERROR_TRANSPORT_PARAMETER,
18
+ QuicEvent,
19
+ flow_control_evidence_map,
20
+ quic_connection_state_table,
21
+ quic_transport_error_matrix,
22
+ )
23
+
24
+ __all__ = [
25
+ "PACKET_SPACE_APPLICATION",
26
+ "PACKET_SPACE_HANDSHAKE",
27
+ "PACKET_SPACE_INITIAL",
28
+ "PACKET_SPACE_ZERO_RTT",
29
+ "QUIC_CONNECTION_STATE_TRANSITION_TABLE",
30
+ "QUIC_FLOW_CONTROL_EVIDENCE_MAP",
31
+ "QUIC_TRANSPORT_ERROR_MATRIX",
32
+ "QuicConnection",
33
+ "QuicEvent",
34
+ "TRANSPORT_ERROR_APPLICATION_ERROR",
35
+ "TRANSPORT_ERROR_INTERNAL_ERROR",
36
+ "TRANSPORT_ERROR_INVALID_TOKEN",
37
+ "TRANSPORT_ERROR_NO_ERROR",
38
+ "TRANSPORT_ERROR_PROTOCOL_VIOLATION",
39
+ "TRANSPORT_ERROR_TRANSPORT_PARAMETER",
40
+ "flow_control_evidence_map",
41
+ "quic_connection_state_table",
42
+ "quic_transport_error_matrix",
43
+ ]
@@ -0,0 +1,361 @@
1
+ from __future__ import annotations
2
+
3
+ from .imports import *
4
+
5
+ class QuicConnectionBaseMixin:
6
+ @property
7
+ def peer_new_tokens(self) -> tuple[bytes, ...]:
8
+ return tuple(self._peer_new_tokens)
9
+
10
+ @property
11
+ def peer_preferred_address(self) -> bytes | None:
12
+ return self._peer_preferred_address
13
+
14
+ @property
15
+ def _send_1rtt_keys(self) -> QuicPacketProtectionKeys:
16
+ return self.client_1rtt_keys if self.is_client else self.server_1rtt_keys
17
+
18
+ @property
19
+ def _recv_1rtt_keys(self) -> QuicPacketProtectionKeys:
20
+ return self.server_1rtt_keys if self.is_client else self.client_1rtt_keys
21
+
22
+ def _space_state(self, packet_space: str) -> _PacketSpaceState:
23
+ normalized = PACKET_SPACE_APPLICATION if packet_space == PACKET_SPACE_ZERO_RTT else packet_space
24
+ if normalized not in self._packet_spaces:
25
+ self._packet_spaces[normalized] = _PacketSpaceState(name=normalized)
26
+ return self._packet_spaces[normalized]
27
+
28
+ def _recovery_space(self, packet_space: str) -> str:
29
+ return PACKET_SPACE_APPLICATION if packet_space == PACKET_SPACE_ZERO_RTT else packet_space
30
+
31
+ def _path_key_for_addr(self, addr: tuple[str, int] | None) -> Any:
32
+ return _DEFAULT_PATH_KEY if addr is None else addr
33
+
34
+ def _path_state(self, path_key: Any) -> _PathRuntime:
35
+ state = self._path_states.get(path_key)
36
+ if state is None:
37
+ addr = None if path_key == _DEFAULT_PATH_KEY else path_key
38
+ state = _PathRuntime(key=path_key, addr=addr, recovery=QuicLossRecovery(max_datagram_size=self.max_datagram_size))
39
+ if self.peer_transport_parameters is not None:
40
+ state.recovery.rtt.max_ack_delay = self.recovery.rtt.max_ack_delay
41
+ self._path_states[path_key] = state
42
+ return state
43
+
44
+ def _activate_path(self, path_key: Any) -> _PathRuntime:
45
+ state = self._path_state(path_key)
46
+ self._active_path_key = path_key
47
+ self.recovery = state.recovery
48
+ self.congestion.bytes_in_flight = self.recovery.bytes_in_flight
49
+ self.congestion.congestion_window = self.recovery.congestion_window
50
+ self.congestion.ssthresh = self.recovery.ssthresh
51
+ return state
52
+
53
+ def _refresh_congestion_snapshot(self, recovery: QuicLossRecovery | None = None) -> None:
54
+ target = self.recovery if recovery is None else recovery
55
+ if target is self.recovery:
56
+ self.congestion.bytes_in_flight = target.bytes_in_flight
57
+ self.congestion.congestion_window = target.congestion_window
58
+ self.congestion.ssthresh = target.ssthresh
59
+
60
+ def _register_datagram_packets(self, datagram: bytes, packet_refs: list[tuple[str, int]]) -> None:
61
+ if packet_refs:
62
+ self._wire_datagram_packets[datagram] = list(packet_refs)
63
+
64
+ def _packet_refs_for_datagram(self, datagram: bytes) -> list[tuple[str, int]]:
65
+ refs = self._wire_datagram_packets.get(datagram)
66
+ if refs is not None:
67
+ return list(refs)
68
+ try:
69
+ packets = split_coalesced_packets(datagram, destination_connection_id_length=max(len(self.local_cid), 1))
70
+ except ProtocolError:
71
+ return []
72
+ resolved: list[tuple[str, int]] = []
73
+ for packet in packets:
74
+ packet_refs = self._wire_datagram_packets.get(packet)
75
+ if packet_refs is None:
76
+ continue
77
+ resolved.extend(packet_refs)
78
+ if resolved:
79
+ self._wire_datagram_packets[datagram] = list(resolved)
80
+ return resolved
81
+
82
+ def _sync_packet_number_snapshot(self) -> None:
83
+ self.packet_numbers.initial_send = self._packet_spaces[PACKET_SPACE_INITIAL].send
84
+ self.packet_numbers.handshake_send = self._packet_spaces[PACKET_SPACE_HANDSHAKE].send
85
+ self.packet_numbers.application_send = self._packet_spaces[PACKET_SPACE_APPLICATION].send
86
+ self.packet_numbers.initial_largest_received = self._packet_spaces[PACKET_SPACE_INITIAL].largest_received
87
+ self.packet_numbers.handshake_largest_received = self._packet_spaces[PACKET_SPACE_HANDSHAKE].largest_received
88
+ self.packet_numbers.application_largest_received = self._packet_spaces[PACKET_SPACE_APPLICATION].largest_received
89
+
90
+ def _issue_address_token(
91
+ self,
92
+ *,
93
+ purpose: int,
94
+ addr: tuple[str, int] | None,
95
+ original_destination_connection_id: bytes = b'',
96
+ retry_source_connection_id: bytes = b'',
97
+ ) -> bytes:
98
+ address_bytes = _serialize_address(addr)
99
+ if len(original_destination_connection_id) > 255 or len(retry_source_connection_id) > 255:
100
+ raise ValueError('connection ids are too large to encode in a QUIC token')
101
+ body = bytearray()
102
+ body.append(_TOKEN_FORMAT_VERSION)
103
+ body.append(purpose)
104
+ body.extend(_current_time_ms().to_bytes(8, 'big'))
105
+ body.extend(len(address_bytes).to_bytes(2, 'big'))
106
+ body.extend(address_bytes)
107
+ body.append(len(original_destination_connection_id))
108
+ body.extend(original_destination_connection_id)
109
+ body.append(len(retry_source_connection_id))
110
+ body.extend(retry_source_connection_id)
111
+ mac = hmac.new(self._token_secret, bytes(body), hashlib.sha256).digest()[:_TOKEN_MAC_LENGTH]
112
+ return bytes(body) + mac
113
+
114
+ def _validate_address_token(
115
+ self,
116
+ token: bytes,
117
+ *,
118
+ addr: tuple[str, int] | None,
119
+ expected_purpose: int | None = None,
120
+ ) -> _TokenInfo | None:
121
+ minimum = 1 + 1 + 8 + 2 + 1 + 1 + _TOKEN_MAC_LENGTH
122
+ if len(token) < minimum:
123
+ return None
124
+ body, mac = token[:-_TOKEN_MAC_LENGTH], token[-_TOKEN_MAC_LENGTH:]
125
+ expected_mac = hmac.new(self._token_secret, body, hashlib.sha256).digest()[:_TOKEN_MAC_LENGTH]
126
+ if not hmac.compare_digest(mac, expected_mac):
127
+ return None
128
+ offset = 0
129
+ format_version = body[offset]
130
+ offset += 1
131
+ if format_version != _TOKEN_FORMAT_VERSION:
132
+ return None
133
+ purpose = body[offset]
134
+ offset += 1
135
+ if expected_purpose is not None and purpose != expected_purpose:
136
+ return None
137
+ if offset + 8 > len(body):
138
+ return None
139
+ issued_at_ms = int.from_bytes(body[offset:offset + 8], 'big')
140
+ offset += 8
141
+ if offset + 2 > len(body):
142
+ return None
143
+ address_length = int.from_bytes(body[offset:offset + 2], 'big')
144
+ offset += 2
145
+ end = offset + address_length
146
+ if end > len(body):
147
+ return None
148
+ address_bytes = body[offset:end]
149
+ offset = end
150
+ if offset >= len(body):
151
+ return None
152
+ original_length = body[offset]
153
+ offset += 1
154
+ end = offset + original_length
155
+ if end > len(body):
156
+ return None
157
+ original_destination_connection_id = body[offset:end]
158
+ offset = end
159
+ if offset >= len(body):
160
+ return None
161
+ retry_length = body[offset]
162
+ offset += 1
163
+ end = offset + retry_length
164
+ if end != len(body):
165
+ return None
166
+ retry_source_connection_id = body[offset:end]
167
+ if addr is not None and address_bytes and address_bytes != _serialize_address(addr):
168
+ return None
169
+ now_ms = _current_time_ms()
170
+ if issued_at_ms > now_ms + 60_000:
171
+ return None
172
+ lifetime_ms = self.retry_token_lifetime_ms if purpose == _TOKEN_PURPOSE_RETRY else self.new_token_lifetime_ms
173
+ if now_ms - issued_at_ms > lifetime_ms:
174
+ return None
175
+ address = _parse_serialized_address(address_bytes) if address_bytes else None
176
+ return _TokenInfo(
177
+ purpose=purpose,
178
+ issued_at_ms=issued_at_ms,
179
+ address=address,
180
+ original_destination_connection_id=original_destination_connection_id,
181
+ retry_source_connection_id=retry_source_connection_id,
182
+ )
183
+
184
+ def _update_local_transport_parameters(self) -> None:
185
+ if self.handshake_driver is None:
186
+ return
187
+ transport_parameters = self.handshake_driver.transport_parameters
188
+ transport_parameters.initial_source_connection_id = self.local_cid
189
+ if self.is_client:
190
+ transport_parameters.original_destination_connection_id = None
191
+ transport_parameters.preferred_address = None
192
+ transport_parameters.retry_source_connection_id = None
193
+ transport_parameters.stateless_reset_token = None
194
+ else:
195
+ if transport_parameters.stateless_reset_token is None:
196
+ transport_parameters.stateless_reset_token = derive_secret(self.local_cid + self.secret, b'stateless-reset', length=16)
197
+ if self._original_destination_connection_id is not None:
198
+ transport_parameters.original_destination_connection_id = self._original_destination_connection_id
199
+ if self._retry_source_connection_id is not None:
200
+ transport_parameters.retry_source_connection_id = self._retry_source_connection_id
201
+ self.local_transport_parameters = transport_parameters
202
+ self.streams.configure_local_initial_limits(
203
+ bidirectional=transport_parameters.max_streams_bidi,
204
+ unidirectional=transport_parameters.max_streams_uni,
205
+ )
206
+ self.flow.configure_local_initial_limits(
207
+ max_data=transport_parameters.max_data,
208
+ max_stream_data_bidi_local=transport_parameters.max_stream_data_bidi_local,
209
+ max_stream_data_bidi_remote=transport_parameters.max_stream_data_bidi_remote,
210
+ max_stream_data_uni=transport_parameters.max_stream_data_uni,
211
+ )
212
+
213
+ def _derive_tls_packet_protection_keys(self, secret: bytes, *, stage: str) -> QuicPacketProtectionKeys:
214
+ if self.handshake_driver is None:
215
+ return derive_quic_packet_protection_keys(secret)
216
+ parameters = self.handshake_driver.packet_protection_parameters(stage=stage)
217
+ return derive_quic_packet_protection_keys(
218
+ secret,
219
+ key_length=parameters.key_length,
220
+ iv_length=parameters.iv_length,
221
+ hp_length=parameters.hp_length,
222
+ hash_name=parameters.hash_name,
223
+ )
224
+
225
+ def _tls_hash_name(self) -> str:
226
+ if self.handshake_driver is None:
227
+ return 'sha256'
228
+ return self.handshake_driver.cipher_parameters.hash_name
229
+
230
+ def _refresh_tls_key_material(self) -> None:
231
+ if self.handshake_driver is None:
232
+ return
233
+ self._update_local_transport_parameters()
234
+ client_early_secret = getattr(self.handshake_driver, '_client_early_secret', None)
235
+ if client_early_secret is not None and self.client_0rtt_keys is None:
236
+ self.client_0rtt_keys = self._derive_tls_packet_protection_keys(client_early_secret, stage='0rtt')
237
+ client_handshake_secret = getattr(self.handshake_driver, '_client_handshake_secret', None)
238
+ server_handshake_secret = getattr(self.handshake_driver, '_server_handshake_secret', None)
239
+ if client_handshake_secret is not None and server_handshake_secret is not None and not self._handshake_traffic_installed:
240
+ self._client_handshake_secret = client_handshake_secret
241
+ self._server_handshake_secret = server_handshake_secret
242
+ self.client_handshake_keys = self._derive_tls_packet_protection_keys(client_handshake_secret, stage='handshake')
243
+ self.server_handshake_keys = self._derive_tls_packet_protection_keys(server_handshake_secret, stage='handshake')
244
+ self._handshake_traffic_installed = True
245
+ traffic_secrets = self.handshake_driver.traffic_secrets
246
+ if traffic_secrets is None or self._application_traffic_installed:
247
+ return
248
+ self._client_handshake_secret = traffic_secrets.client_handshake_secret
249
+ self._server_handshake_secret = traffic_secrets.server_handshake_secret
250
+ self.client_handshake_keys = self._derive_tls_packet_protection_keys(traffic_secrets.client_handshake_secret, stage='handshake')
251
+ self.server_handshake_keys = self._derive_tls_packet_protection_keys(traffic_secrets.server_handshake_secret, stage='handshake')
252
+ if traffic_secrets.client_early_secret is not None:
253
+ self.client_0rtt_keys = self._derive_tls_packet_protection_keys(traffic_secrets.client_early_secret, stage='0rtt')
254
+ self._client_application_secret = traffic_secrets.client_application_secret
255
+ self._server_application_secret = traffic_secrets.server_application_secret
256
+ self.client_1rtt_keys = self._derive_tls_packet_protection_keys(traffic_secrets.client_application_secret, stage='application')
257
+ self.server_1rtt_keys = self._derive_tls_packet_protection_keys(traffic_secrets.server_application_secret, stage='application')
258
+ self._application_traffic_installed = True
259
+
260
+ def _apply_peer_transport_parameters(self) -> None:
261
+ if self.handshake_driver is None or self.handshake_driver.peer_transport_parameters is None:
262
+ return
263
+ peer = self.handshake_driver.peer_transport_parameters
264
+ if self.is_client:
265
+ if self._original_destination_connection_id is not None and peer.original_destination_connection_id != self._original_destination_connection_id:
266
+ raise ProtocolError('server original_destination_connection_id transport parameter mismatch')
267
+ if self._first_server_source_connection_id is not None and peer.initial_source_connection_id != self._first_server_source_connection_id:
268
+ raise ProtocolError('server initial_source_connection_id transport parameter mismatch')
269
+ if self._received_retry:
270
+ if peer.retry_source_connection_id != self._retry_source_connection_id:
271
+ raise ProtocolError('server retry_source_connection_id transport parameter mismatch')
272
+ elif peer.retry_source_connection_id is not None:
273
+ raise ProtocolError('server sent retry_source_connection_id without using Retry')
274
+ else:
275
+ if peer.original_destination_connection_id is not None:
276
+ raise ProtocolError('client sent forbidden original_destination_connection_id transport parameter')
277
+ if peer.preferred_address is not None:
278
+ raise ProtocolError('client sent forbidden preferred_address transport parameter')
279
+ if peer.retry_source_connection_id is not None:
280
+ raise ProtocolError('client sent forbidden retry_source_connection_id transport parameter')
281
+ if peer.stateless_reset_token is not None:
282
+ raise ProtocolError('client sent forbidden stateless_reset_token transport parameter')
283
+ if self._peer_initial_source_connection_id is not None and peer.initial_source_connection_id != self._peer_initial_source_connection_id:
284
+ raise ProtocolError('client initial_source_connection_id transport parameter mismatch')
285
+ self.peer_transport_parameters = peer
286
+ self.local_transport_parameters = self.handshake_driver.transport_parameters
287
+ ack_delay_exponent = peer.ack_delay_exponent if peer.ack_delay_exponent >= 0 else 3
288
+ max_ack_delay = max(peer.max_ack_delay, 0) / 1000.0
289
+ for path in self._path_states.values():
290
+ path.recovery.rtt.max_ack_delay = max_ack_delay
291
+ self._peer_active_connection_id_limit = peer.active_connection_id_limit
292
+ self._peer_default_stream_window = peer.max_stream_data_bidi_remote
293
+ self.flow.configure_peer_initial_limits(
294
+ max_data=peer.max_data,
295
+ max_stream_data_bidi_local=peer.max_stream_data_bidi_local,
296
+ max_stream_data_bidi_remote=peer.max_stream_data_bidi_remote,
297
+ max_stream_data_uni=peer.max_stream_data_uni,
298
+ )
299
+ self.streams.configure_peer_initial_limits(
300
+ bidirectional=peer.max_streams_bidi,
301
+ unidirectional=peer.max_streams_uni,
302
+ )
303
+ self._peer_preferred_address = peer.preferred_address
304
+ self._ack_delay_exponent = ack_delay_exponent
305
+ self._update_runtime_timers()
306
+
307
+ def _initial_keys(self, *, destination_connection_id: bytes | None = None) -> tuple[QuicPacketProtectionKeys, QuicPacketProtectionKeys]:
308
+ if destination_connection_id is not None:
309
+ connection_id = destination_connection_id
310
+ elif self.is_client:
311
+ connection_id = self.remote_cid or self._original_destination_connection_id or self.local_cid
312
+ else:
313
+ connection_id = self._retry_source_connection_id or self.local_cid or self._original_destination_connection_id or self.remote_cid
314
+ return derive_initial_packet_protection_keys(connection_id)
315
+
316
+ def _recv_initial_keys(self, packet: QuicLongHeaderPacket) -> tuple[QuicPacketProtectionKeys, QuicPacketProtectionKeys]:
317
+ if self.is_client:
318
+ connection_id = self.remote_cid or self._retry_source_connection_id or self._original_destination_connection_id or packet.source_connection_id
319
+ else:
320
+ connection_id = packet.destination_connection_id
321
+ return derive_initial_packet_protection_keys(connection_id)
322
+
323
+ def _send_handshake_keys(self) -> QuicPacketProtectionKeys:
324
+ self._refresh_tls_key_material()
325
+ keys = self.client_handshake_keys if self.is_client else self.server_handshake_keys
326
+ if keys is None:
327
+ raise ProtocolError('handshake packet protection keys are not available')
328
+ return keys
329
+
330
+ def _recv_handshake_keys(self) -> QuicPacketProtectionKeys:
331
+ self._refresh_tls_key_material()
332
+ keys = self.server_handshake_keys if self.is_client else self.client_handshake_keys
333
+ if keys is None:
334
+ raise ProtocolError('handshake packet protection keys are not available')
335
+ return keys
336
+
337
+ def _send_0rtt_keys(self) -> QuicPacketProtectionKeys:
338
+ self._refresh_tls_key_material()
339
+ if not self.is_client:
340
+ raise ProtocolError('only clients can send 0-RTT packets')
341
+ if self.client_0rtt_keys is None:
342
+ raise ProtocolError('0-RTT packet protection keys are not available')
343
+ return self.client_0rtt_keys
344
+
345
+ def _recv_0rtt_keys(self) -> QuicPacketProtectionKeys:
346
+ self._refresh_tls_key_material()
347
+ if self.client_0rtt_keys is None:
348
+ raise ProtocolError('0-RTT packet protection keys are not available')
349
+ return self.client_0rtt_keys
350
+
351
+ def _promote_key_update(self) -> None:
352
+ hash_name = self._tls_hash_name()
353
+ self._client_application_secret = update_quic_secret(self._client_application_secret, hash_name=hash_name)
354
+ self._server_application_secret = update_quic_secret(self._server_application_secret, hash_name=hash_name)
355
+ self.client_1rtt_keys = self._derive_tls_packet_protection_keys(self._client_application_secret, stage='application')
356
+ self.server_1rtt_keys = self._derive_tls_packet_protection_keys(self._server_application_secret, stage='application')
357
+
358
+ def initiate_key_update(self) -> None:
359
+ self._promote_key_update()
360
+ self._send_key_phase ^= 1
361
+ self._recv_key_phase = self._send_key_phase
@@ -0,0 +1,111 @@
1
+ from __future__ import annotations
2
+
3
+ from .imports import *
4
+ from .base import QuicConnectionBaseMixin
5
+ from .decode import QuicConnectionDecodeMixin
6
+ from .loss_api import QuicConnectionLossApiMixin
7
+ from .receive import QuicConnectionReceiveMixin
8
+ from .runtime import QuicConnectionRuntimeMixin
9
+ from .send import QuicConnectionSendMixin
10
+
11
+ class QuicConnection(
12
+ QuicConnectionReceiveMixin,
13
+ QuicConnectionDecodeMixin,
14
+ QuicConnectionSendMixin,
15
+ QuicConnectionRuntimeMixin,
16
+ QuicConnectionLossApiMixin,
17
+ QuicConnectionBaseMixin,
18
+ ):
19
+ def __init__(
20
+ self,
21
+ *,
22
+ is_client: bool = False,
23
+ version: int = 1,
24
+ secret: bytes | None = None,
25
+ local_cid: bytes | None = None,
26
+ remote_cid: bytes | None = None,
27
+ supported_versions: Sequence[int] | None = None,
28
+ require_retry: bool = False,
29
+ retry_token_lifetime_ms: int = 10_000,
30
+ new_token_lifetime_ms: int = 7 * 24 * 60 * 60 * 1000,
31
+ max_datagram_size: int = 1200,
32
+ ) -> None:
33
+ self.is_client = is_client
34
+ self.version = version
35
+ self.supported_versions = tuple(dict.fromkeys(tuple(supported_versions or (version,)) + (version,)))
36
+ self.local_cid = generate_connection_id() if local_cid is None else local_cid
37
+ self.remote_cid = generate_connection_id() if (is_client and remote_cid is None) else remote_cid
38
+ self.secret = secret or derive_secret(self.local_cid, b'tigrcorn-quic')
39
+ self.max_datagram_size = max(max_datagram_size, 1200)
40
+ self.require_retry = require_retry
41
+ self.retry_token_lifetime_ms = retry_token_lifetime_ms
42
+ self.new_token_lifetime_ms = new_token_lifetime_ms
43
+ self._packet_spaces: dict[str, _PacketSpaceState] = {
44
+ PACKET_SPACE_INITIAL: _PacketSpaceState(name=PACKET_SPACE_INITIAL),
45
+ PACKET_SPACE_HANDSHAKE: _PacketSpaceState(name=PACKET_SPACE_HANDSHAKE),
46
+ PACKET_SPACE_APPLICATION: _PacketSpaceState(name=PACKET_SPACE_APPLICATION),
47
+ }
48
+ self.packet_numbers = _QuicPacketNumberSpaces()
49
+ self._client_application_secret = derive_secret(self.secret, b'client 1rtt')
50
+ self._server_application_secret = derive_secret(self.secret, b'server 1rtt')
51
+ self.client_1rtt_keys = derive_quic_packet_protection_keys(self._client_application_secret)
52
+ self.server_1rtt_keys = derive_quic_packet_protection_keys(self._server_application_secret)
53
+ self._client_handshake_secret: bytes | None = None
54
+ self._server_handshake_secret: bytes | None = None
55
+ self.client_handshake_keys: QuicPacketProtectionKeys | None = None
56
+ self.server_handshake_keys: QuicPacketProtectionKeys | None = None
57
+ self.client_0rtt_keys: QuicPacketProtectionKeys | None = None
58
+ self._handshake_traffic_installed = False
59
+ self._application_traffic_installed = False
60
+ self._send_key_phase = 0
61
+ self._recv_key_phase = 0
62
+ self.state = 'new'
63
+ self.flow = QuicFlowControl(local_is_client=is_client)
64
+ self.streams = QuicStreamManager(local_is_client=is_client)
65
+ self.last_acked = -1
66
+ self.congestion = _CongestionState()
67
+ self._path_states: dict[Any, _PathRuntime] = {
68
+ _DEFAULT_PATH_KEY: _PathRuntime(
69
+ key=_DEFAULT_PATH_KEY,
70
+ addr=None,
71
+ recovery=QuicLossRecovery(max_datagram_size=self.max_datagram_size),
72
+ )
73
+ }
74
+ self._active_path_key: Any = _DEFAULT_PATH_KEY
75
+ self.recovery = self._path_states[_DEFAULT_PATH_KEY].recovery
76
+ self._timer_wheel = QuicTimerWheel()
77
+ self._sent_packets: dict[tuple[str, int], _SentPacketMeta] = {}
78
+ self._wire_datagram_packets: dict[bytes, list[tuple[str, int]]] = {}
79
+ self._scheduled_specs: list[_ScheduledFrameSpec] = []
80
+ self.path_challenges: set[bytes] = set()
81
+ self.retire_connection_ids: list[int] = []
82
+ self.handshake_driver: QuicTlsHandshakeDriver | None = None
83
+ self._pending_handshake_datagrams: list[bytes] = []
84
+ self._pending_auto_resets: list[tuple[int, int]] = []
85
+ self.bytes_received = 0
86
+ self.bytes_sent = 0
87
+ self.address_validated = is_client
88
+ self.connection_id_sequence = 0
89
+ self.issued_connection_ids: dict[int, tuple[bytes, bytes]] = {}
90
+ self.peer_connection_ids: dict[int, tuple[bytes, bytes]] = {}
91
+ self.peer_transport_parameters: TransportParameters | None = None
92
+ self.local_transport_parameters: TransportParameters | None = None
93
+ self._peer_active_connection_id_limit = 4
94
+ self._peer_default_stream_window = 65_535
95
+ self._handshake_done_sent = False
96
+ self._peer_new_tokens: list[bytes] = []
97
+ self._token_secret = derive_secret(self.secret, b'quic-address-token', length=32)
98
+ self._original_destination_connection_id: bytes | None = self.remote_cid if is_client else None
99
+ self._peer_initial_source_connection_id: bytes | None = None
100
+ self._first_server_source_connection_id: bytes | None = None
101
+ self._retry_source_connection_id: bytes | None = None
102
+ self._retry_token: bytes = b''
103
+ self._received_retry = False
104
+ self._sent_retry = False
105
+ self._peer_preferred_address: bytes | None = None
106
+ self._path_addr: tuple[str, int] | None = None
107
+ self._ack_delay_exponent = 3
108
+ self.packets_lost_total = 0
109
+ self.pto_expirations_total = 0
110
+ self._sync_packet_number_snapshot()
111
+