Skip to content

BitChat v0.2.0

Choose a tag to compare

@github-actions github-actions released this 31 Oct 10:31
· 71 commits to main since this release

BitChat v0.2.0 — Cross-Platform Reliability, Hardening & Windows 2.0 Release

BitChat v0.2.0 is a major milestone release delivering enterprise-grade reliability, memory leak protections, multi-hop mesh routing, framed LAN concurrency, dual Windows & Linux parity, and the new Windows Installer 2.0 distribution architecture.


Highlights & Key Features

  • Equal Windows & Linux First-Class Support: Complete platform abstraction layer unifying Windows (WinRT BLE, %LOCALAPPDATA%\BitChat, Inno Setup) and Linux (BlueZ D-Bus v5.2+, XDG/~/.bitchat, Debian/AppImage/Flatpak).
  • Windows Installer 2.0: High-DPI installer compiled with Inno Setup 6, featuring custom branded framed iconography (bitchat.ico), Start Menu integration, PATH registration, optional background service startup (--startup install), and silent install switches.
  • Dynamic Mesh Routing & Unicast Relaying: Real-time routing table tracking with route learning, next-hop resolution, TTL decrementing, and relay jitter to prevent RF packet collision.
  • Adversarial Mesh Rate Limiter: Peer packet rate throttling with automatic pruning under high-volume flood attacks, eliminating memory exhaustion vulnerabilities.
  • Fragment Bounds & Defensive Hardening: Strict index and total validation preventing out-of-bounds assembly corruption, fragment limit enforcement, and monotonic stale assembly cache expiration.
  • LAN TCP Framing & Connection Deduplication: Bidirectional socket deduplication preventing connection collisions, asynchronous drain lock serialization preventing socket buffer corruption, and framed message boundaries.
  • Noise Protocol Handshake Resiliency: Graceful error handling and state transition cleanup for failed or timed-out Noise XX cryptographic handshakes.

Platform Distributables & Verification Hashes

Platform Package File Size SHA-256 Checksum
Windows x64 BitChat-0.2.0-windows-x64.exe 17.8 MB 13b50563619a7b73590314e0963ed10ac75aa4b085786fa7374292d833953d34
Linux (AppImage) BitChat-0.2.0-x86_64.AppImage 20.7 MB e14507dd720247dabab05bd2a5ba976c3c283988e3a4c5f6f56f812f8adb8134
Debian / Ubuntu bitchat_0.2.0_amd64.deb 18.3 MB 2e37fbf217ab0ba27e1deb62d036e64140726dca5a1c1c88ae84cdd35d35157c
Python Wheel bitchat-0.2.0-py3-none-any.whl 191 KB c6815a969be240ba1e002444f60693d2e2a2a61615da053d73ac8e1c7a1341f7
Source Archive bitchat-0.2.0.tar.gz 1.7 MB 9602824c1d70538cd71d5dbc10a8eed00d40d2519265a9e38f2dc0ab152c3576
Microsoft WinGet Java-Mx.BitChat.yaml 1.4 KB 7127516ff8def8801216dfe9150563e8a71f568684efc177607182893a8c49d4

Verified Test & Quality Matrix

  • Unit & System Tests: 877 passing tests across Windows and Linux (pytest).
  • Static Type Checking: 0 errors, 0 warnings with pyright (dual-platform analyzed on Windows and Linux targets).
  • Code Formatting & Linting: 100% compliant with ruff check and ruff format.
  • CI/CD Parity: Dual-runner test matrix running on windows-latest and ubuntu-latest with Python 3.12 and 3.13.

Known Limitations

  • Hardware BLE Dependency: Real BLE advertising requires hardware adapter support (WinRT Bluetooth LE on Windows 10/11 or BlueZ 5.50+ on Linux). Virtual machines or headless environments without Bluetooth adapters automatically operate in LAN/TCP or simulated transport mode.
  • Windows SmartScreen Notice: Unsigned installer binaries will prompt the standard Windows Defender SmartScreen advisory until EV code signing certificate thumbprint is configured.