SecureBitChat/securebit-chat
1
0
Fork 0
Code Issues Pull Requests Actions 21 Packages Projects Releases Wiki Activity

feat(descriptor): SBQ2 connection descriptor format; release v5.8.0

Browse Source 
The SB1 invitation runs 2000-2400 characters and needs QR version 38-40, past
the point where a single code is scannable, so the app falls back to an
animated multi-frame QR. SBQ2 is a fixed binary layout carrying only what
brings up DTLS -- ICE credentials, certificate fingerprint, candidates -- with
the SDP rebuilt from a template by a strict serializer. Measured on real Chrome
and Firefox SDP across four network profiles: 98-149 bytes, QR version 6-8.

Key material is meant to move to the DataChannel, bound by a commitment in the
descriptor. That half does not exist yet, so nothing calls this module: the
format is landed for review and freeze, not wired into the connection path.
doc/DESCRIPTOR-SBQ2.md records the gate on phase 3.

The decoder is a parser of hostile input: fixed offsets, explicit lengths,
deny-by-default on reserved values and unknown TLV extension types, trailing
bytes rejected, ICE credentials alphabet-checked so a CRLF cannot reach the
serializer. No compression -- DEFLATE adds bytes on this payload, and dropping
it removes the decompression-bomb surface with it.

Candidate pruning keeps coverage before count: one candidate per (family, type,
transport) survives before any surplus, so an IPv6-only or UDP-blocked path
cannot be pruned away by a v4-first sort.

Tests cover round-trip against captured Chrome and Firefox SDP, IPv6 and NAT64
addresses, ICE-TCP candidates, the TLV area, clock skew, one-shot binding and
SAS transcript coverage.
This commit is contained in:
lockbitchat
2026-08-06 11:54:05 -04:00
parent 3212138a0d
commit 6e82cfcae2
14 changed files with 1765 additions and 37 deletions
Download Patch File Download Diff File Expand all files Collapse all files
index.html
+22 -22
View File
@@ -24,7 +24,7 @@
<!-- PWA Manifest -->
<link rel="manifest" href="./manifest.json">
<link rel="icon" type="image/x-icon" href="./logo/favicon.ico?v=1785988424571">
<link rel="icon" type="image/x-icon" href="./logo/favicon.ico?v=1786031423211">
<!-- PWA Meta Tags -->
<meta name="mobile-web-app-capable" content="yes">
@@ -90,7 +90,7 @@
<link rel="apple-touch-startup-image" media="screen and (device-width: 744px) and (device-height: 1133px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="./logo/splash/splash_screens/8.3__iPad_Mini_portrait.png">
<!-- Apple Touch Icons -->
<link rel="apple-touch-icon" href="./logo/icon-180x180.png?v=1785988424571">
<link rel="apple-touch-icon" href="./logo/icon-180x180.png?v=1786031423211">
<link rel="apple-touch-icon" sizes="57x57" href="./logo/icon-57x57.png">
<link rel="apple-touch-icon" sizes="60x60" href="./logo/icon-60x60.png">
<link rel="apple-touch-icon" sizes="72x72" href="./logo/icon-72x72.png">
@@ -99,7 +99,7 @@
<link rel="apple-touch-icon" sizes="120x120" href="./logo/icon-120x120.png">
<link rel="apple-touch-icon" sizes="144x144" href="./logo/icon-144x144.png">
<link rel="apple-touch-icon" sizes="152x152" href="./logo/icon-152x152.png">
<link rel="apple-touch-icon" sizes="180x180" href="./logo/icon-180x180.png?v=1785988424571">
<link rel="apple-touch-icon" sizes="180x180" href="./logo/icon-180x180.png?v=1786031423211">
<!-- Microsoft Tiles -->
<meta name="msapplication-TileColor" content="#ff6b35">
@@ -183,7 +183,7 @@
<!-- Render-blocking JS is deferred: classic deferred scripts and module scripts
both execute in document order after parsing, so React still runs before the
app modules below, but the parser / first paint is no longer blocked. -->
<script defer src="config/ice-servers.js?v=1785988424571"></script>
<script defer src="config/ice-servers.js?v=1786031423211"></script>
<script defer src="libs/react/react.production.min.js"></script>
<script defer src="libs/react-dom/react-dom.production.min.js"></script>
<!-- Prism syntax highlighting (vendored, offline). Tokenizes code as TEXT only —
@@ -191,8 +191,8 @@
Its CSS is loaded async via load-async-css.js (not paint-critical). -->
<script defer src="libs/prism/prism.js"></script>
<!-- Critical, paint-defining CSS stays render-blocking (avoids FOUC / layout shift). -->
<link rel="stylesheet" href="assets/tailwind.css?v=1785988424571">
<link rel="icon" type="image/x-icon" href="/logo/favicon.ico?v=1785988424571">
<link rel="stylesheet" href="assets/tailwind.css?v=1786031423211">
<link rel="icon" type="image/x-icon" href="/logo/favicon.ico?v=1786031423211">
<!-- Preload only the fonts needed for first paint. fa-solid covers the bulk of UI
icons; fa-regular/fa-brands are loaded on demand by their CSS (rarely on the
first screen). Inter latin 400/700 cover body text and headings/buttons. -->
@@ -200,31 +200,31 @@
<link rel="preload" href="/assets/fonts/inter/files/inter-latin-400.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/assets/fonts/inter/files/inter-latin-700.woff2" as="font" type="font/woff2" crossorigin>
<link rel="stylesheet" href="/assets/fonts/inter/inter.css">
<link rel="stylesheet" href="src/styles/main.css?v=1785988424571">
<link rel="stylesheet" href="src/styles/animations.css?v=1785988424571">
<link rel="stylesheet" href="src/styles/components.css?v=1785988424571">
<link rel="stylesheet" href="src/styles/main.css?v=1786031423211">
<link rel="stylesheet" href="src/styles/animations.css?v=1786031423211">
<link rel="stylesheet" href="src/styles/components.css?v=1786031423211">
<!-- Non-critical CSS (FontAwesome ~102KB, Prism) loaded async — no longer blocks paint. -->
<script defer src="src/scripts/load-async-css.js?v=1785988424571"></script>
<script defer src="src/scripts/load-async-css.js?v=1786031423211"></script>
<noscript>
<link rel="stylesheet" href="/assets/fontawesome/css/all.min.css">
<link rel="stylesheet" href="libs/prism/prism.css">
</noscript>
<script defer src="src/scripts/fa-check.js?v=1785988424571"></script>
<script defer src="src/scripts/fa-check.js?v=1786031423211"></script>
<!-- Update Manager - система принудительного обновления -->
<script defer src="src/utils/updateManager.js?v=1785988424571"></script>
<script type="module" src="src/components/UpdateChecker.jsx?v=1785988424571"></script>
<script type="module" src="dist/qr-local.js?v=1785988424571"></script>
<script type="module" src="src/components/QRScanner.js?v=1785988424571"></script>
<script defer src="src/utils/updateManager.js?v=1786031423211"></script>
<script type="module" src="src/components/UpdateChecker.jsx?v=1786031423211"></script>
<script type="module" src="dist/qr-local.js?v=1786031423211"></script>
<script type="module" src="src/components/QRScanner.js?v=1786031423211"></script>
</head>
<body>
<div id="root"></div>
<script type="module" src="dist/app-boot.js?v=1785988424571"></script>
<script type="module" src="dist/app.js?v=1785988424571"></script>
<script type="module" src="dist/app-boot.js?v=1786031423211"></script>
<script type="module" src="dist/app.js?v=1786031423211"></script>
<script defer src="src/scripts/pwa-register.js?v=1785988424571"></script>
<script src="./src/pwa/install-prompt.js?v=1785988424571" type="module"></script>
<script src="./src/pwa/pwa-manager.js?v=1785988424571" type="module"></script>
<script defer src="./src/scripts/pwa-offline-test.js?v=1785988424571"></script>
<link rel="stylesheet" href="./src/styles/pwa.css?v=1785988424571">
<script defer src="src/scripts/pwa-register.js?v=1786031423211"></script>
<script src="./src/pwa/install-prompt.js?v=1786031423211" type="module"></script>
<script src="./src/pwa/pwa-manager.js?v=1786031423211" type="module"></script>
<script defer src="./src/scripts/pwa-offline-test.js?v=1786031423211"></script>
<link rel="stylesheet" href="./src/styles/pwa.css?v=1786031423211">
</body>
</html>