1  # Abzu Test Documentation
 2  
 3  This directory documents the test suites for each Abzu crate (silo).
 4  
 5  ## Test Silos
 6  
 7  | Crate | Focus | Test Files |
 8  |-------|-------|------------|
 9  | [abzu-dht](./abzu-dht.md) | DHT adversarial & security hardening | `tests/adversarial_tests.rs` |
10  | [abzu-core](./abzu-core.md) | Integration, Circles, messaging | `tests/*.rs` + unit tests |
11  | [abzu-transport](./abzu-transport.md) | Wire protocol, TLS fingerprinting | `tests/*.rs` + unit tests |
12  | [abzu-router](./abzu-router.md) | Multi-hop routing | Unit tests |
13  | [abzu-sdk](./abzu-sdk.md) | High-level API | Unit tests |
14  
15  ## Running Tests
16  
17  ```bash
18  # Full workspace
19  cargo test --workspace
20  
21  # Single crate
22  cargo test -p abzu-dht
23  
24  # Adversarial tests with output
25  cargo test -p abzu-dht adversarial -- --nocapture
26  
27  # TLS profile tests
28  cargo test -p abzu-transport -- tls_profiles --test-threads=1
29  ```
30  
31  ## Current Coverage (Jan 2026)
32  
33  | Crate | Tests | Status |
34  |-------|-------|--------|
35  | abzu-dht | 57 | ✅ Pass |
36  | abzu-core | 50 | ✅ Pass |
37  | abzu-transport | 85 | ✅ Pass |
38  | abzu-router | 8 | ✅ Pass |
39  | abzu-sdk | 2 | ✅ Pass |
40  | **Total** | **202** | **✅ Pass** |
41  
42  ## Security Audit Verification
43  
44  Adversarial stress tests verify hardening from the Jan 2026 audit:
45  
46  - **H1**: Rate limiting (100/min, 10 stores/min)
47  - **H2**: Signature validation (64 bytes)
48  - **H3**: Pending ops limit (1000)
49  - **H4**: Random request IDs
50  - **H5**: Replacement cache TTL (15 min)
51  - **C4**: Response node cap (K=20)
52  - **M4**: Pending ops reaper (120s)
53  - **M5**: Tree coords max (64 bytes)