Skip to content

BitChat v0.3.2 β€” Phase 2: Native Rust Cryptography, Noise XX, LAN/BLE Foundations & Cross-Platform Reliability

Choose a tag to compare

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

BitChat v0.3.2 β€” Phase 2 Production Release: Native Rust Cryptography, Noise XX, LAN/BLE Foundations & Cross-Platform Reliability

BitChat v0.3.2 delivers the Phase 2 architectural migration across Windows and Linux: native Rust implementations of all core cryptographic primitives (ChaCha20-Poly1305 AEAD, Ed25519 signatures, X25519 Diffie-Hellman, HKDF-SHA256, and PBKDF2-HMAC-SHA256) and the complete Noise XX mutual authentication handshake state machine inside bitchat._bitchat_core, with automatic memory zeroization on drop (zeroize) and strict fallback parity with pure-Python reference implementations.

This release also implements the foundational native engines for upcoming stages (wire-speed TCP stream framing, LAN interface scoring, UDP discovery packet validation, BLE manufacturer payload encoding/decoding, and LRU packet deduplication with replay protection), full cross-platform packaging for Windows (Inno Setup 6 + WinGet), Linux (Debian, AppImage, Flatpak, Snap, Fedora KDE, Arch PKGBUILD), and macOS source builds, backed by a comprehensive 1,274-test verification suite.


What's Changed in v0.3.2

Native Rust Cryptography (bitchat._bitchat_core.crypto)

  • ChaCha20-Poly1305 AEAD (rust/bitchat-core/src/crypto.rs): Implemented native IETF ChaCha20-Poly1305 authenticated encryption and decryption (chacha20poly1305_encrypt_raw, chacha20poly1305_decrypt_raw) with hardware SIMD acceleration and automatic authentication tag verification.
  • Ed25519 Dalek Signing & Verification (rust/bitchat-core/src/crypto.rs): Integrated ed25519-dalek 2.2 for batch and single-message signature generation and verification (ed25519_sign_raw, ed25519_verify_raw, RFC 8032 test vectors verified).
  • X25519 Key Agreement & Low-Order Rejection (rust/bitchat-core/src/crypto.rs): Integrated x25519-dalek 2.0 with strict rejection of low-order and all-zero points, preventing small-subgroup attacks in peer key exchanges (x25519_diffie_hellman_raw).
  • HKDF-SHA256 Key Derivation (rust/bitchat-core/src/crypto.rs): Native RFC 5869 Extract-and-Expand key derivation (hkdf_sha256_raw) for Noise handshake chaining and session transport key splitting.
  • PBKDF2-HMAC-SHA256 Identity Protection (rust/bitchat-core/src/crypto.rs): Native PBKDF2 password-based key derivation (pbkdf2_hmac_sha256_raw) for encrypted identity key storage and passphrase protection.
  • Zeroize Memory Security: In-memory secret keys, ephemeral DH secrets, and symmetric cipher states automatically overwrite their memory buffers with zeroes upon deallocation via Rust's zeroize crate (Zeroizing<[u8; 32]>), preventing sensitive cryptographic secrets from lingering in swap or memory dumps.

Native Noise XX Protocol Engine (bitchat._bitchat_core.noise)

  • Noise XX State Machine (rust/bitchat-core/src/noise.rs): Complete 3-message mutual authentication handshake implemented natively (NativeNoiseHandshakeSession), including initiator and responder roles, prologue validation, ephemeral DH key generation, and transition to split bidirectional transport ciphers (send_cipher, recv_cipher).
  • Python Bridge Parity (src/bitchat/crypto/noise.py): Seamless runtime integration where NoiseSession and NoiseHandshakeState transparently delegate handshake step execution to _bitchat_core when available, falling back to pure-Python reference implementation with 100% cryptographic vector equivalence.

Wire Framing, Transports & Networking Foundations

  • TCP Stream Framing (rust/bitchat-core/src/lan.rs, src/bitchat/network/framing.py): Standard 8-byte stream framing with magic prefix b"BC\x01\x00" and 4-byte big-endian payload length. Full cursor-indexed TCP stream parsing and burst throughput acceleration.
  • LAN Discovery & Interface Scoring (rust/bitchat-core/src/lan.rs): Implemented native LAN UDP discovery packet validation and intelligent network interface scoring (NativeInterfaceScorer) prioritizing physical Wi-Fi/Ethernet adapters over virtual WSL, Docker, and VPN bridges.
  • BLE Payload Serialization (rust/bitchat-core/src/ble.rs): Native manufacturer advertising payload encoding/decoding and subscribing buffer drain logic for Bluetooth Low Energy GATT communication.
  • Mesh Routing & Rate Limiting (rust/bitchat-core/src/mesh.rs): Native LRU deduplication with monotonic TTL replay protection, per-peer token-bucket rate limiting, and acknowledgment tracking with retry management.

Cross-Platform Packaging & Release Metadata

  • Windows Standalone Setup Wizard 2.0 (packaging/windows/bitchat.iss): Standalone Inno Setup 6 installer bundling Python runtime, precompiled _bitchat_core.pyd, Textual TUI, terms/privacy acceptance screens, user-scope default installation, and Windows Start Menu / uninstaller integration.
  • WinGet Manifests (manifests/j/Java-Mx/BitChat/0.3.2/): Official multi-file manifests (Java-Mx.BitChat.yaml, Java-Mx.BitChat.installer.yaml, Java-Mx.BitChat.locale.en-US.yaml) and singleton manifest validated against Windows Package Manager schemas with moniker bitchat-rustpy.
  • Linux Packages: Debian .deb package with systemd/D-Bus integration, universal standalone AppImage, Flatpak bundle manifest (io.github.java_mx.bitchat.metainfo.xml), Snapcraft recipe, Fedora KDE setup documentation, and Arch Linux AUR PKGBUILD.
  • macOS Documentation: Clarified Tier 2 source distribution and documented Apple CoreBluetooth permission prompt boundaries.

Official Website & Documentation

  • Official Portal Deployed (website/): Full synchronization of all pages (index.html, downloads.html, roadmap.html, about.html, security.html, privacy.html, terms.html, sitemap.xml) and releases.json with verified SHA-256 checksums and real asset download links.
  • Documentation Synchronization: Updated README.md, CHANGELOG.md, docs/ARCHITECTURE.md, docs/DOWNLOAD.md, docs/INDEX.md, docs/RELEASE_PROCESS.md, docs/REQUIREMENTS.md, docs/ROADMAP.md, docs/protocol/COMPATIBILITY.md, docs/security/CRYPTOGRAPHY.md, and docs/security/NOISE.md.

Downloadable Release Assets

Asset Name Platform / Target SHA-256 Checksum Description
BitChat-0.3.2-windows-x64.exe Windows 10/11 (x64) 61FB2A5E882CF6CF8D59AA6916C174CBD12C5C4DA4077A98880FC860908410B4 Self-contained Windows Inno Setup installer bundling Python runtime, _bitchat_core.pyd, Textual TUI, and complete uninstaller
BitChat-0.3.2-windows-x64.exe.sha256 Checksum 870B52AB2BEA05D490880540FD4753FB9EBC6B99B1A1BBC24D8D8CBE570BD680 SHA-256 verification file for Windows installer
bitchat_0.3.2_amd64.deb Debian / Ubuntu (amd64) 85BFDB6BCDBB54B8C054D7ED580C4F4736D1205173550794D6BE88C314CEE329 Native Debian package with compiled Rust core, system PATH integration, desktop shortcut, and BlueZ D-Bus permissions
bitchat_0.3.2_amd64.deb.sha256 Checksum DE43D252F8D3AD12FE7CBA795602A94918114A8108A2910BE88F249FBA7B8994 SHA-256 verification file for Debian package
BitChat-0.3.2-x86_64.AppImage Linux (Universal x86_64) E561B1095C9058E5BBD08A797D1E7CC226D5A3ADB0B9C54ABA1EAF1AE3CC8EEA Self-contained portable Linux AppImage with compiled Rust core, requiring no system installation
BitChat-0.3.2-x86_64.AppImage.sha256 Checksum E4B87D565920CCC0738EF29789E023DF0A82FB8A34FBE6340403D8653CE34F46 SHA-256 verification file for AppImage
bitchat-0.3.2-cp312-abi3-win_amd64.whl Python 3.12+ (Windows x64) 8F4D207F30896C6E3C123D58B96124DB33AFE566C0B428634337B7BE311CD910 Precompiled Windows ABI3 binary wheel with native _bitchat_core.pyd extension
bitchat-0.3.2-cp312-abi3-win_amd64.whl.sha256 Checksum 36A1A0A5EBB0E722324F6B0D9095B6AD2D43F3D91E4F029B0A8843932A630A53 SHA-256 verification file for Windows wheel
bitchat-0.3.2-cp312-abi3-linux_x86_64.whl Python 3.12+ (Linux x86_64) D1B723D02791686635F7609090E42C706F25D6E14BE5276F1638A6ECECEBFD4B Precompiled Linux ABI3 binary wheel with native _bitchat_core.so extension
bitchat-0.3.2-cp312-abi3-linux_x86_64.whl.sha256 Checksum F5ABB55268B52A6D9FD9D774C464A7C547A8492E51042B6848D6B2444A867517 SHA-256 verification file for Linux wheel
bitchat-0.3.2.tar.gz Source Distribution 8DAB5F6C34ACD8FCDB1341A42A1E1945871EDC729604966DABCE5E114F42B53D Complete Python + Rust (maturin / pyo3) source distribution archive
bitchat-0.3.2.tar.gz.sha256 Checksum 3729460181B2626B8514D00BA26A53DE57E604AE8B639C6127D246592ED2CBB6 SHA-256 verification file for source distribution
Java-Mx.BitChat.yaml Windows Package Manager 4C54763A25C74CEE7F8486320859364C6EB04114912DD6AE51751F5B8E797B82 Official Microsoft WinGet package manifest for winget install bitchat-rustpy

Full Changelog: v0.3.1...v0.3.2