Home

SIAR System Architecture & Technical Wiki

SIAR: Secure, Interoperable, Autonomous & Resilient Peer-to-Peer Communication Platform. Built in Rust for mobile, desktop, headless daemons, and embedded Linux nodes.

Welcome to the SIAR System Architecture Wiki. This knowledge portal contains 60 comprehensive technical specifications covering all aspects of SIAR's low-level cryptographic protocols, delay-tolerant mesh networking, distributed storage, audio DSP pipelines, cross-platform client architecture, and user experience design.

---

⚡ Quick Navigation Matrix

Domain	Parts	Key Focus Areas
I. Foundation & Extensions	01, 07, 21, 22, 23, 24	Extensibility, WASM plugins, capability negotiation, interop suites
II. Identity & Security	02, 28	Multi-device key trees, MLS / Double Ratchet, forward secrecy, audit logs
III. Mesh & Transports	03, 11, 12, 13, 14, 15	Iroh QUIC, BLE, Wi-Fi Direct, LoRa, relays, multipath link bonding
IV. DTN & Emergency Mesh	06, 17	Store-carry-forward bundle routing, hop limits, SOS priority mesh
V. Storage & Event Log	04, 05, 09, 32, 33	Append-only outbox, chunked blob sync, SQLite/Redb, Tantivy search
VI. Realtime Media & Audio	25, 26, 29	Low-latency audio/video calls, zero-copy surfaces, Rust DSP (AEC, NS, AGC)
VII. Ephemeral & Presence	30, 31	Ephemeral presence, typing indicators, unified push wake & background delivery
VIII. Native Daemons & FFI	16, 19, 20, 27	Headless daemons, C-ABI bindings, embedded Linux, Android NDK packaging
IX. Testing & Diagnostics	08, 10, 18	Backpressure queues, AFL++/libFuzzer harnesses, live path visualizer
X. UI/UX Architecture	UI/UX 01 – UI/UX 27	Desktop Dioxus, Android Jetpack Compose, design tokens, responsive layouts

---

🎯 Role-Based Reading Paths

Depending on your engineering focus, we recommend following these reading paths:

🛡️ 1. Cryptography & Security Architects

1. 02 — Multi-Device Identity & Trust Model
2. 28 — Production Security, E2EE, Key Management & Privacy
3. 15 — Out-of-Band QR & NFC Bootstrap Pairing
4. UI/UX 15 — Security Center, Devices, Keys & Recovery

📡 2. Mesh Networking & Protocol Engineers

1. 01 — Protocol Extension System Architecture
2. 03 — Transport & Routing Policy Engine
3. 06 — DTN Store-Carry-Forward & Bundle Forwarding
4. 12 — Multipath Networking & Link Aggregation
5. 14 — Proximity Abstraction (BLE, Wi-Fi Direct, LoRa)
6. 17 — Emergency Priority Classes & Critical Alert Mesh

💾 3. Storage, Database & Sync Engineers

1. 04 — Offline Event Log & Sync Engine
2. 05 — Robust File & Blob Subsystem
3. 09 — Crash Recovery & State Integrity
4. 32 — Search, Indexing & Local Privacy Retrieval
5. 33 — Backup, Restore, Export & Long-Term Archival

📞 4. Realtime Media & Audio DSP Engineers

1. 29 — Realtime Calls & Media Session Protocol
2. 26 — Rust-First Audio DSP (AEC, NS, AGC, Resampling)
3. 25 — Android Direct Surface Zero-Copy Media
4. UI/UX 07 — Calls & Realtime Media UX

📱 5. UI/UX & Frontend Engineers (Desktop / Mobile)

1. UI/UX 01 — Product UX Foundation & Cross-Platform Interaction
2. UI/UX 02 — Desktop Dioxus App Shell & Navigation
3. UI/UX 03 — Android Jetpack Compose App Shell & Lifecycle
4. UI/UX 22 — Design System, Tokens, Typography & Motion
5. UI/UX 23 — Responsive & Adaptive Layouts

---

💡 Reading & Keyboard Shortcuts

This interactive wiki is powered by mdBook. You can use the following shortcuts from any page:

• s or / — Focus the Full-Text Search Bar
• ← / → — Navigate to Previous / Next Chapter
• t — Open the Theme Selector (Navy, Coal, Ayu, Rust, Light)
• c — Copy Code Blocks
• Toggle sidebar button in the top left for clean reading on mobile and tablet devices.

---

🏛️ Core Architectural Tenets

   ┌─────────────────────────────────────────────────────────┐
   │                     SIAR Core Engine                    │
   ├───────────────────┬───────────────────┬─────────────────┤
   │  Zero Monolith    │  Offline-First    │ Zero Trust      │
   │  WASM & Plugins   │  DTN Store-Carry  │ Multi-Device    │
   │  Extensible ABI   │  Append-Only Log  │ End-to-End Enc  │
   └───────────────────┴───────────────────┴─────────────────┘

1. Transport Neutrality: Iroh QUIC as primary transport, with pluggable support for BLE, Wi-Fi Direct, LoRa, TCP relays, and custom radio layers.
2. Zero Centralization Requirement: Every node can act as an autonomous router, storage node, or relay without depending on centralized servers.
3. Rust Memory & Concurrency Safety: The entire core engine and DSP pipeline is implemented in pure, zero-cost-abstraction Rust.