Protokoll v2: binäre Frames statt JSON (inkompatibel) #32

Merged
jochen merged 4 commits from feat/binary-wire-format into master 2026-11-11 09:39:52 +00:00
Collaborator

Fixes #12

Änderung

Bisher war jeder Frame ein JSON-Envelope, in dem das mDNS-Paket als Zahlen-Array stand. Dadurch war ein Frame 3–4× so groß wie das Paket. Neu (src/protocol.rs):

frame  = length:u32 body                 (big-endian)
body   = type:u8 (0x01 = packet) origin_site:u32 path_len:u8 path:u32*path_len mdns_packet
  • Fester Overhead: 6 Byte Header plus 4 Byte pro Site im Pfad. Bei zwei Standorten sind das 10 Byte. Das Paket selbst wird unverändert übertragen.
  • Das Typ-Byte lässt Platz für spätere Frame-Arten. Ein unbekannter Typ wird als Fehler gemeldet.
  • matched_service ist entfernt (war immer leer).
  • PROTOCOL_VERSION ist jetzt 2.

Inkompatibel: Der Handshake lehnt v1-Peers ab. Beide Seiten melden dann protocol version mismatch: this side speaks v2, peer v1. Bis beide Standorte aktualisiert sind, wird zwischen ihnen nichts weitergeleitet. Die Verbindungsversuche laufen mit Backoff bis 30 s weiter, danach verbindet es sich von selbst. Die README hat einen neuen Abschnitt „Protocol versions“.

Tests

  • Unit-Tests:
    • Kodierung genau wie dokumentiert;
    • Roundtrip;
    • fehlerhafte Frames (leer, unbekannter Typ einschließlich eines v1-JSON-Frames, abgeschnittener Header, abgeschnittener Pfad);
    • Pfad mit mehr als 255 Einträgen;
    • mehrere Frames über einen Stream.
  • E2E auf ifb0/ifb1 mit PSK: v2↔v2 kommt an, beide Seiten authenticated.
  • E2E gemischt: alter v1-Build auf der einen, v2 auf der anderen Seite → sauberer Versionsfehler auf beiden Seiten, nichts kommt an.
  • fmt, clippy, 48 Tests.

Danach

Merge, dann beide Standorte aktualisieren. Danach kann v0.1.0 getaggt werden.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp

Fixes #12 ## Änderung Bisher war jeder Frame ein JSON-Envelope, in dem das mDNS-Paket als Zahlen-Array stand. Dadurch war ein Frame 3–4× so groß wie das Paket. Neu (`src/protocol.rs`): ``` frame = length:u32 body (big-endian) body = type:u8 (0x01 = packet) origin_site:u32 path_len:u8 path:u32*path_len mdns_packet ``` - Fester Overhead: 6 Byte Header plus 4 Byte pro Site im Pfad. Bei zwei Standorten sind das 10 Byte. Das Paket selbst wird unverändert übertragen. - Das Typ-Byte lässt Platz für spätere Frame-Arten. Ein unbekannter Typ wird als Fehler gemeldet. - `matched_service` ist entfernt (war immer leer). - `PROTOCOL_VERSION` ist jetzt 2. **Inkompatibel:** Der Handshake lehnt v1-Peers ab. Beide Seiten melden dann `protocol version mismatch: this side speaks v2, peer v1`. Bis beide Standorte aktualisiert sind, wird zwischen ihnen nichts weitergeleitet. Die Verbindungsversuche laufen mit Backoff bis 30 s weiter, danach verbindet es sich von selbst. Die README hat einen neuen Abschnitt „Protocol versions“. ## Tests - Unit-Tests: - Kodierung genau wie dokumentiert; - Roundtrip; - fehlerhafte Frames (leer, unbekannter Typ einschließlich eines v1-JSON-Frames, abgeschnittener Header, abgeschnittener Pfad); - Pfad mit mehr als 255 Einträgen; - mehrere Frames über einen Stream. - E2E auf ifb0/ifb1 mit PSK: v2↔v2 kommt an, beide Seiten `authenticated`. - E2E gemischt: alter v1-Build auf der einen, v2 auf der anderen Seite → sauberer Versionsfehler auf beiden Seiten, nichts kommt an. - fmt, clippy, 48 Tests. ## Danach Merge, dann beide Standorte aktualisieren. Danach kann v0.1.0 getaggt werden. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
protocol v2: binary frames instead of JSON envelopes (#12)
Some checks failed
ci / rust (push) Has been cancelled
a67bbc5592
Frames carried the mDNS packet as a JSON array of numbers, 3-4 times
its size. Version 2 sends a fixed binary header and the packet
verbatim:

  frame  = length:u32 body
  body   = type:u8 (0x01 = packet) origin_site:u32 path_len:u8
           path:u32*path_len mdns_packet

The unused matched_service field is gone. PROTOCOL_VERSION is now 2,
so a v1 peer is rejected in the handshake with "protocol version
mismatch: this side speaks v2, peer v1" on both sides.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
handshake: protocol version 2 (#12)
Some checks failed
ci / rust (push) Has been cancelled
d5479b0b86
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
README: binary frames, protocol versions (#12)
Some checks failed
ci / rust (push) Failing after 1m10s
ci / rust (pull_request) Failing after 1m12s
build-freebsd / freebsd (pull_request) Successful in 3m1s
build-freebsd / release (pull_request) Has been skipped
39404bd1f7
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
protocol: decode path without chunks_exact (clippy 1.99)
All checks were successful
build-freebsd / freebsd (pull_request) Successful in 2m58s
build-freebsd / release (pull_request) Has been skipped
ci / rust (push) Successful in 3m40s
ci / rust (pull_request) Successful in 3m37s
473029d6a8
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
jochen approved these changes 2026-11-11 09:39:44 +00:00
jochen merged commit 4c368f19cb into master 2026-11-11 09:39:52 +00:00
jochen deleted branch feat/binary-wire-format 2026-11-11 09:39:52 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
jochen/mdns-bridge!32
No description provided.