1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
# QSSH Documentation
This directory contains extended documentation for QSSH.
## Documentation Structure
### `/architecture/`
Technical architecture and design documents:
- `quantum-osi-model.md` - How QSSH fits in the OSI model with quantum enhancements
- `protocol-design.md` - Detailed protocol specification and message formats
- `quantum-architecture.md` - Overall quantum security architecture
- `p2p-implementation.md` - Peer-to-peer networking design
### `/implementation/`
Implementation status and requirements:
- `implementation-status.md` - Current implementation progress and QKD optional status
- `kirq-operator-requirements.md` - Requirements for KIRQ network operators
- `falcon-redesign.md` - Falcon algorithm implementation notes
### `/security/`
Security analysis and advisories:
- `security-analysis.md` - Comprehensive security analysis
- `qkd-tls-vulnerability.md` - QKD API security considerations
### `/whitepaper/`
Academic whitepaper and diagrams:
- `QSSH_Whitepaper.pdf` - Full academic paper
- `QSSH_WHITEPAPER.md` - Markdown version
- `diagrams/` - Architecture and protocol diagrams
### `/`
- `SPECIFICATION.md` - Complete protocol specification
- `README.md` - This file
## For Developers
Start with:
1. The main [README.md](../README.md) for overview
2. [architecture/protocol-design.md](architecture/protocol-design.md) for protocol details
3. [SPECIFICATION.md](SPECIFICATION.md) for implementation requirements
## For Security Researchers
See:
1. [security/security-analysis.md](security/security-analysis.md) for threat model
2. [SECURITY.md](SECURITY.md) for vulnerability reporting
3. [whitepaper/QSSH_Whitepaper.pdf](whitepaper/QSSH_Whitepaper.pdf) for academic analysis