ed8a7ae5aa
Audit: - docs/AUDIT-2026-05-25.md: full protocol audit covering 8 findings (4 critical, 2 high, 5 medium, 4 low) with code references and fix effort estimates - vault/Audit/Tasks.md: Obsidian Tasks plugin file tracking all audit items with priorities, due dates, and per-step checklists Architecture docs updated for Wire format v2 and Wave 5/6 features: - ARCHITECTURE.md: adds wzp-video to dependency graph and project structure; wire format updated to v2 (16B header, 5B MiniHeader); relay concurrency section corrected (DashMap+RwLock is current, not a future optimization); test count 571→702; Android note - PROGRESS.md: Wave 5 and Wave 6 sections appended; test count 372→702; current status and open blockers as of 2026-05-25 - ROAD-TO-VIDEO.md: implementation status table inserted (✅/🟡/🔴/🔲 per phase); 6-step critical path to first video call - WZP-SPEC.md: MediaHeader updated to v2 (16B byte-aligned); MiniHeader updated to 5B with seq_delta; codec IDs 9-12 added (H.264/H.265/AV1); version negotiation section added Obsidian vault (vault/): - 114 files across Architecture/, PRDs/, Reports/, Android/, Reference/, Audit/ with YAML frontmatter - 00 - Home.md index note with wiki links - .obsidian/app.json config Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
tags, type
| tags | type | ||
|---|---|---|---|
|
reference |
WarzonePhone Android Client
The WZP Android client is a native VoIP application built with Kotlin/Jetpack Compose on top of a Rust audio engine. It connects to WZP relay servers over QUIC, providing encrypted voice calls with adaptive quality, forward error correction, and acoustic echo cancellation.
Quick Start
- Build:
cd android && ./gradlew assembleRelease(requires NDK 26.1, cargo-ndk) - Install:
adb install app/build/outputs/apk/release/app-release.apk - Run: Open "WZ Phone", tap CALL to connect to the hardcoded relay
- Relay: Must be running at the configured address (default
172.16.81.125:4433)
Current State (April 2025)
| Feature | Status |
|---|---|
| QUIC transport to relay | Working |
| Crypto handshake (X25519 + Ed25519) | Working |
| Opus 24k encoding/decoding | Working |
| Oboe audio I/O (48kHz mono) | Working |
| AEC / AGC signal processing | Working |
| RaptorQ FEC | Wired (repair symbols not sent yet) |
| Jitter buffer | Working |
| Adaptive quality switching | Codec-ready, not network-driven yet |
| Authentication (featherChat) | Skipped (relay has no --auth-url) |
| Media encryption (ChaCha20-Poly1305) | Session derived but not applied to packets |
| Foreground service / wake locks | Implemented, not started from UI |
Documentation Index
- Architecture - System design, data flow diagrams, thread model
- Build Guide - Build environment setup, dependencies, signing
- Debugging - Crash diagnosis, logcat filters, common issues
- Maintenance - Code map, dependency management, upgrade paths
- Roadmap - Planned work and known gaps
Key Design Decisions
- Rust native engine: All audio processing, codecs, FEC, crypto, and networking run in Rust. Kotlin is UI-only.
- Lock-free audio: SPSC ring buffers with atomic ordering between Oboe C++ callbacks and the Rust codec thread. No mutexes in the audio path.
- cargo-ndk: The native library (
libwzp_android.so) is cross-compiled forarm64-v8ausing cargo-ndk, invoked automatically by Gradle'scargoNdkBuildtask. - Single-activity Compose: One
CallActivityhosts all UI via Jetpack Compose withCallViewModelas the state holder.