# Protokollentwurf sm-chat-1

Entwurfsstatus, kein unabhängig verifiziertes Protokoll. Implementierung:
`shared/crypto.js`, Relay `server/app.js`, Client `src/app.js`.

Ein offline erzeugter 128-Byte-Zufallscode wird hexadezimal dargestellt und über
HKDF-SHA512 in einen ML-DSA-87-Root-Seed abgeleitet. Der öffentliche Root-Schlüssel
bestimmt eine SHA-256-Kontokennung. Das Root-Zertifikat bindet Benutzername,
Gerätesignierschlüssel und Generation. Der Root-Privatschlüssel wird nach der
Zertifizierung verworfen, der Recovery-Code gehört in ein getrenntes Offline-Backup.

Das aktive Gerät signiert ML-KEM-1024-Einmalschlüssel. Der Relay reserviert einen
öffentlichen Schlüssel je empfangendem Gerät. Falls Einmalschlüssel verbraucht
sind, wird ein signierter Reserveschlüssel verwendet. Der Client erneuert ihn
nach einem Tag bei der nächsten Verbindung und hält noch benötigte Vorgänger.
Mehrfachverwendung dieses Reserveschlüssels bietet weniger Schutz bei einer
späteren Gerätekompromittierung als verworfene Einmalschlüssel. Pro Nachricht entsteht
ein frischer AES-256-Inhaltsschlüssel. Der gesamte Inhalt einschließlich Dateiname,
MIME-Typ, Dateibytes und Gruppenname wird mit AES-GCM verschlüsselt. Pro Empfänger
kapselt ML-KEM ein Geheimnis; HKDF-SHA512 bindet es an Header, Chiffretext-Hash,
Empfänger, Generation und Prekey. Daraus entsteht ein eigener AEAD-Schlüssel zum
Verpacken des Inhaltsschlüssels. Der Absender signiert jede Empfängerhülle. Ab 0.4 ist die Nachrichten-ID die
zufällige, nur einmal verwendbare Sendevormerkung. Dadurch lassen sich alte
Nachrichten nach Empfang nicht mit einer neuen Vormerkung wiederholen; ein
Archiv abgeschlossener Nachrichten-IDs wird nicht benötigt. Clients vor 0.4
müssen zum Senden aktualisiert werden; offene alte Zustellungen bleiben lesbar.

Gruppenmitgliedschaften sind vom Gruppenadmin signierte Zustände mit Epoche und
Hash des Vorgängers. Einladungen pinnen die Root-Kennung des Admins. Der Client
verwirft lokal erkannte ältere Generationen/Epochen. Ein vollständig bösartiger
Server und zurückgesetzte Geräte erfordern weitergehende Analyse; eine universelle
Rollback-Abwehr wird nicht behauptet.

Der Empfänger prüft Signatur, Zertifikate, Gruppe, Frist und Bindungen, entschlüsselt
und speichert den lokalen Vault. Erst danach verwirft er den verwendeten Einmal-Prekey
(Reserveschlüssel bleiben bis zu ihrem Ersatz und dem Ende offener Zustellungen)
und sendet eine authentifizierte Bestätigung. Der Relay entfernt die Empfängerhülle;
nach der letzten Bestätigung entfernt er den gemeinsamen Chiffretext. Abgelaufene
und entfernte Gruppendaten werden ebenfalls verworfen. JS-Garbage-Collection,
Dateisystemkopien und Betriebssystemspeicher erlauben keine Zusage physischer
Sofortvernichtung.

Sichtbare Metadaten: pseudonyme Konten, Schlüssel, Gruppenzugehörigkeiten,
Nachrichtengröße, Zeitpunkt und Frist während offener Zustellungen sowie optionale
Apple-Push-Kennung. Kein Archiv von Zeitpunkten, Empfängern oder Zustellquittungen
nach der letzten Bestätigung bzw. dem Ablauf. Persistente Mitgliedschaften offener
Chats bleiben sichtbar: diese Architektur verbirgt den sozialen Graphen nicht.
Keine inhaltliche Servermoderation. Kontosperren und Meldungen betreffen Metadaten.

ML-KEM-1024 ist ein Parametersatz der NIST-Norm FIPS 203; die App bietet nicht
„1024 Bit Quantensicherheit“. AES-256 und ML-DSA-87 erfüllen andere Aufgaben und
ihre Bit-/Parametersatzbezeichnungen sind nicht gegeneinander austauschbar.

Primärquellen:
- https://csrc.nist.gov/pubs/fips/203/final
- https://csrc.nist.gov/pubs/fips/204/final
- https://www.npmjs.com/package/@noble/post-quantum
