Repository navigation
Release 2.2.0: transport: air (one-way radio broadcast) - #9
Merged
Merged
Conversation
Adds `transport: air` (docs/AIR.md): every module carried over a one-way, lossy broadcast bearer such as wfb-ng's udp_direct_tx/rx, to any number of receivers that never transmit. The DYL1 envelopes and module handlers are unchanged; air replaces lidi underneath them. - src/air: DYB1 packets with truncated HMAC-SHA256 tags; HKDF-SHA256 keys from dyode.key; ChaCha20-Poly1305 chunks under a per-boot key; sealed manifest; RaptorQ block per chunk. - Carousel: balanced interleave windows, at least 8 manifest symbols per pass, K(1+r) fresh repair symbols per later pass, pass_gap spacing, per-module carousel (passes / until / latest). - Receiver: newest-boot rule with sortable boots, saved done table, expiry, chunks opened before the manifest, .part + bitmap resume, limits; delivery through envelope::Parser. - Config (transport, air:, carousel), check, lidi-config, firewall-rules, systemd unit without BindsTo for air, counters. - Tests: unit, plus tests/air.rs over a lossy loopback relay (bursts and fades, restart resume, replay after restart, new boot, poisoned symbols). - Version 2.2.0, dated CHANGELOG (includes dyode probe), docs. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018Q4FHhHAFgBUCsPf3UW67z
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Release 2.2.0:
transport: air, the one-way radio broadcast from the broadcast-mode design sketch (phases 1–2: codec + carousel over UDP), with all 13 review corrections applied. Scope agreed: runs over wfb-ng's UDP ports; config file only (wizard unchanged); API phase 2 moves to 2.3.0.udp_direct_tx/udp_direct_rx, FEC off) to any number of receivers that never transmit. DYL1 envelopes and module handlers are unchanged; air replaces lidi underneath. The one-way guarantee still comes from a wired diode in front of the radio box (docs/AIR.md).src/air/sender.rs):pass_gaptime diversity (corr. 13), per-modulecarousel: passes | until | latest;air.max_mbps.src/air/receiver.rs):.part+ bitmap resume across restarts;latestobjects dropped;envelope::Parser.transport:,air:and per-modulecarouselconfig, with validation (symbol size vs wfb-ng's 4045-byte MTU, RaptorQ's 56403-symbol limit);Uplinkcarries lidi or air;dyode checkprints the real file rate (corr. 3), plus air checks;dyode lidi-configprints the air parameters;firewall-rulesair variant;BindsTo=for air (insystemd-unit, the unit check and the wizard's unit writer);air_*counters.dyode probeitems); openapiinfo.version; docs/AIR.md, README, ARCHITECTURE, CAVEATS, config.example.yaml.raptorq2 andring0.17. Both were already in the lock via lidi and rustls, so nothing new to vendor.Deviations from the sketch (documented in docs/AIR.md)
Test plan
cargo fmt --check,cargo clippy --all-targets -D warnings(default and--no-default-features)cargo test: 82 unit tests (11 new for air plus config, firewall) andtests/air.rs, run 6× locally without a failure:.partresume, under an insider's poisoned symbols (bad-seal counter asserted);dyode out+dyode inwithtransport: air. A 7 MB file and a small file arrived identical in 5 s; the status channel and the transport hash matched; no warnings.max_mbps: 2000: 200 MB arrived identical in 5.5 s (~290 Mbit/s of file).tools/check_release.sh v2.2.0passes.v2.2.0to run release.yml (offline bundles, installs in 8 clean systems)dyode probeover wfb-ng, then air.Generated by Claude Code