Files

Siavash Sameni ed8a7ae5aa docs: protocol audit 2026-05-25, update architecture + Obsidian vault

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>

2026-05-25 06:00:17 +04:00

2.3 KiB

Raw Blame History

tags, type

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 for arm64-v8a using cargo-ndk, invoked automatically by Gradle's cargoNdkBuild task.
Single-activity Compose: One CallActivity hosts all UI via Jetpack Compose with CallViewModel as the state holder.

2.3 KiB Raw Blame History