Repository navigation
BitChat v0.3.2 β Phase 2: Native Rust Cryptography, Noise XX, LAN/BLE Foundations & Cross-Platform Reliability
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): Integrateded25519-dalek 2.2for 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): Integratedx25519-dalek 2.0with 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
zeroizecrate (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 whereNoiseSessionandNoiseHandshakeStatetransparently delegate handshake step execution to_bitchat_corewhen 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 prefixb"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 monikerbitchat-rustpy. - Linux Packages: Debian
.debpackage with systemd/D-Bus integration, universal standaloneAppImage, Flatpak bundle manifest (io.github.java_mx.bitchat.metainfo.xml), Snapcraft recipe, Fedora KDE setup documentation, and Arch Linux AURPKGBUILD. - 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) andreleases.jsonwith 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, anddocs/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