Skip to content

BitChat v0.3.4 β€” Phase 3: Native Rust BLE Transport, Noise XX Interop & UI Stability

Latest

Choose a tag to compare

@github-actions github-actions released this 19 Nov 17:20
· 2 commits to main since this release

BitChat v0.3.4 β€” Phase 3 Production Release: Native Rust BLE Transport, Noise XX Interoperability, Live Bluetooth Diagnostics & UI Stability

BitChat v0.3.4 delivers the Phase 3 engineering milestone across Windows, Linux, and macOS: a modular native Rust BLE transport stack (rust/bitchat-core/src/ble/) targeting Windows WinRT (windows 0.58), Linux BlueZ D-Bus (zbus 5), and macOS CoreBluetooth capability probing; decoupled Windows GATT server & companion manufacturer advertisement handling; reference bitchat-tui (107a13c) binary DM payload interoperability in Rust; live asynchronous Bluetooth Settings diagnostics with canonical BitChat UUIDs; and mouse-click navigation jitter elimination across the Textual TUI.


What's Changed in v0.3.4

Native Rust BLE Transport Architecture

  • Modular Rust BLE Transport (rust/bitchat-core/src/ble/): Replaced the single-file BLE helper stub (ble.rs) with modular Rust ownership (types.rs, advertisement.rs, connection.rs, manager.rs, windows_winrt.rs, linux_bluez.rs, macos_corebt.rs) executing platform OS BLE operations off Python's GIL (py.allow_threads) with bounded event/write queues, early-notification buffering, ATT MTU chunking, and secret-redacted diagnostic traces.
  • Native Windows WinRT Backend (windows_winrt.rs): Implements real Rust WinRT BluetoothAdapter/Radio probing, BluetoothLEAdvertisementWatcher central scanning, BluetoothLEDevice/GattSession GATT client operations, and GattServiceProvider + decoupled optional BluetoothLEAdvertisementPublisher peripheral hosting.
  • Native Linux BlueZ D-Bus Backend (linux_bluez.rs): Implements pure-Rust BlueZ D-Bus (zbus 5) adapter/capability probing, central discovery/GATT client, and exported ObjectManager/GattService1/GattCharacteristic1/LEAdvertisement1 peripheral hosting with manufacturer-data fallback.
  • Truthful macOS Backend (macos_corebt.rs): Reports live macOS Bluetooth controller status while honestly declaring CoreBluetooth Peripheral mode as unimplemented.

BLE Reliability & Reference bitchat-tui Noise XX Interoperability

  • Decoupled Windows GATT Provider & Companion Advertisement (src/bitchat/ble/server.py, windows_winrt.rs): Fixed the critical coupling bug where a companion manufacturer BluetoothLEAdvertisementPublisher failure tore down an already-working GattServiceProvider and GattLocalCharacteristic; GATT and discovery advertisement statuses are now tracked and reported independently.
  • bitchat-tui (107a13c) Binary DM Payload Decoding (rust/bitchat-core/src/engine.rs, src/bitchat/app/session_coordinator.py): Added native Rust decode_chat_payload_raw and encode_bitchat_message_payload_raw supporting plain UTF-8, [0x04] || UTF-8, [0x04] || binary BitchatMessage, bare binary BitchatMessage, and nested BitchatPacket(Message) payloads while preserving strict fail-closed Noise XX authentication and nonce-0 replay rejection.
  • Strict Scanner Peer-ID & GATT Property Validation (src/bitchat/ble/scanner.py, gatt.py, advertisement.rs): Enforced full 8-byte (16-hex-char) non-zero, non-broadcast peer IDs for BLE service data (eliminating truncated 12/14-char IDs) and strict notify + write/write-without-response GATT characteristic validation with hyphen/case-insensitive UUID normalization.

Bluetooth Diagnostics & TUI Mouse Navigation Stability

  • Live Bluetooth Settings Diagnostics (src/bitchat/tui/screens/settings.py, src/bitchat/transport/bluetooth.py): Replaced the incorrect hardcoded 0000fee0-0000-1000-8000-00805f9b34fb UUID and falsely hardcoded "Active / Scanning" Central status with live asynchronous hardware & transport telemetry, canonical BitChat Service (F47B5E2D-4A9E-4C5A-9B3F-8E1D2C3A4B5C) and Characteristic (A1B2C3D4-E5F6-4A5B-8C9D-0E1F2A3B4C5D) UUIDs, zero blank diagnostic boxes, and an explicit Refresh Bluetooth Information button with safe worker cancellation.
  • Eliminated Mouse Navigation Jitter & Screen Fluctuation (status_bar.py, app.py, screens/*.py): Fixed StatusBar.on_button_pressed triple-firing every action click (ActionTriggered + direct app.action_* call + bubbled Button.Pressed), added event.stop() across all screen button handlers, wrapped multi-layer screen pops in batch_update(), and deduplicated PeersScreen.refresh_peer_list() table rows to eliminate periodic DataTable rebuild flicker.
  • Homepage Preservation: Both the application Home Screen (src/bitchat/tui/screens/home.py) and the official website homepage (website/index.html) were preserved with zero changes.

Downloadable Release Assets & SHA-256 Checksums

Asset Platform / Format Size SHA-256
BitChat-0.3.4-windows-x64.exe Windows x64 Inno Setup Installer 17.85 MB 87E534E94D5BA73C08352D34B29D594B82174BE77AEA3EF9584B3E881FDE8C92
bitchat_0.3.4_amd64.deb Debian / Ubuntu (amd64) 19.03 MB 134BDD43EBAA09E4E484D8A47CF367F156ABB84E2B188E91EAECAE3D2BB729D9
BitChat-0.3.4-x86_64.AppImage Linux Universal AppImage (x86_64) 21.72 MB C0A8BC6011D7D83ADA7C555DFE177B3AC58A7EC375A00ACBAAF0060033015E5B
bitchat-0.3.4-cp312-abi3-win_amd64.whl Python 3.12+ ABI3 Wheel (Windows x64) 1.10 MB CDDEFBBB753297EEB7AE22F94D64AD4EC10470267B94CE73D40F329738853172
bitchat-0.3.4-cp312-abi3-linux_x86_64.whl Python 3.12+ ABI3 Wheel (Linux x86_64) 1.99 MB 00914AE4C94C71E41ED01B00B7C6336DB8DEAE53F30BE2A33583AAB3385E9A7C
bitchat-0.3.4-cp312-abi3-macosx_11_0_arm64.whl Python 3.12+ ABI3 Wheel (macOS Apple Silicon arm64) 1018.44 KB 13EB946701A1249419CAD88C9F5E9C991201028746A8E3633922FF2DF6BDA621
bitchat-0.3.4.tar.gz Universal Source Distribution (Python + Rust) 358.15 KB 4405983582827382FC20DB0FB84391A8DC2E500ACD2243B673FED703D8584D7E
Java-Mx.BitChat.yaml Windows Package Manager (WinGet) Singleton Manifest 1.63 KB EE77C62BA13E61B8B953B234EF08909D6D3963EF28808BD75EABA3561B3389F1

Install or Upgrade

  • Windows (WinGet): winget upgrade --id Java-Mx.BitChat --exact (or fresh install: winget install bitchat-rustpy) β€” preserves ~/.bitchat/ identity and settings across upgrades.
  • Ubuntu / Debian: sudo apt install ./bitchat_0.3.4_amd64.deb
  • Fedora / Universal Linux: chmod +x BitChat-0.3.4-x86_64.AppImage && ./BitChat-0.3.4-x86_64.AppImage
  • macOS (Apple Silicon arm64): pip install bitchat-0.3.4-cp312-abi3-macosx_11_0_arm64.whl (LAN & Offline supported; BLE Peripheral not yet implemented on macOS)

Full Verification & Hardware Audit

See PHASE-3-IMPLEMENTATION-AND-VERIFICATION-REPORT.md and CHANGELOG.md.