1  # Abzu Technical Deep Dive
 2  
 3  > **Audience**: Trusted technical reviewers with systems programming background
 4  
 5  This folder contains detailed technical documentation for the Abzu sovereign mesh protocol. Unlike the main project README or white paper, these documents prioritize implementation details over marketing language.
 6  
 7  ## Contents
 8  
 9  | Document | Purpose |
10  |----------|---------|
11  | [TECHNICAL_DEEP_DIVE.md](./TECHNICAL_DEEP_DIVE.md) | Comprehensive architecture, algorithms, and test evidence |
12  | [TECHNICAL_DEEP_DIVE.pdf](./TECHNICAL_DEEP_DIVE.pdf) | PDF version for offline sharing |
13  
14  ## What This Document Covers
15  
16  1. **Problem Statement** - What Abzu defends against (and what it doesn't)
17  2. **Design Philosophy** - Sovereign IP, zero-trust, tiered security
18  3. **Layer Architecture** - All 6 crates and their responsibilities
19  4. **Core Implementation** - Node, Switchboard, ContentStore
20  5. **Transport Security** - FakeTLS, PFS key exchange, cover traffic
21  6. **Routing Algorithms** - Spanning tree coordinates, path building
22  7. **Trust Circles** - Group messaging with policy-based OpSec
23  8. **Testing Methodology** - 180+ tests including stress and fuzzing
24  9. **Performance Characteristics** - Throughput and overhead data
25  10. **Known Limitations** - Honest assessment of current gaps
26  
27  ## Key Statistics
28  
29  - **~9,544** lines of Rust
30  - **180+** tests (unit, integration, stress, property-based)
31  - **6** crates with clear separation of concerns
32  - **456** lines of concurrency stress tests
33  - **183** lines of property-based fuzzing tests
34  
35  ## Usage
36  
37  For maximum effect, share this alongside the [audit documentation](../audit/) which provides per-crate breakdowns with Triad analysis ratings.