# Automatischer Tor-Fallback – 0.6-Kandidat

Die Android-App versucht zunächst HTTPS. Schlägt eine Leseanfrage durch einen
Netzwerkfehler oder Timeout fehl oder antwortet ein Gateway mit 502/503/504,
wechselt sie auf den fest eingebauten eigenen v3-Onion-Zugang. Nach dem Wechsel
bleibt die Sitzung auf Tor; es gibt keine wiederholten direkten Verbindungstests.
Ein neuer App-Prozess beginnt wieder mit HTTPS.

Der Dienst bleibt derselbe: `chat.horst-fahrt.de` und
`ijzavx2bs6nhvcxsmefk5jpwqrih3faajxvzkicvlu2iquc3kkcconqd.onion` führen zum
HORST-Relay. Das hilft bei einer blockierten normalen Verbindung, nicht bei einem
ausgeschalteten oder defekten Relay. Es gibt keinen dezentralen Fremdserver.

## Daten und Verhalten

- Tor Android 0.4.9.14, Guardian Project, feste Maven-Version; nur eigenes Ziel.
- Loopback-SOCKS, keine LAN-Freigabe, kein Tor-Relay und keine Exit-Funktion.
- Onion-Ziel wird über SOCKS aufgelöst. Keine DNS-Auflösung der Onion-Adresse.
- Kein automatischer Start beim Booten und keine permanente Benachrichtigung.
  Tor läuft nur während der Nutzung; beim Verlassen der App werden Anfragen
  abgebrochen und die Bindung zum Tor-Dienst beendet.
- Die bestehende Ende-zu-Ende-Verschlüsselung und das Konto bleiben unverändert.
  Anmeldung, Nachrichten, Fotos, Dateien und Audio verwenden dieselbe API-Route.
- Während Tor aktiv ist, ersetzt die bestehende Vordergrund-Abfrage den
  direkten WebSocket. FCM/APNs bleiben separate Push-Dienste; deren Zustellung
  wird durch Tor nicht garantiert und kann ebenfalls blockiert sein.
- Keine Tor-Anfrageprotokolle, Cookies oder Antwort-Caches. Tor benötigt eigene
  Verzeichnis-/Guard-Daten für den Betrieb; das sind keine Chat-Inhalte.
- Autorisierungsfehler (401/403), Rate Limits (429) und Anwendungsfehler lösen
  keinen Wechsel aus. Umleitungen werden nicht verfolgt.
- Ein verlorener Schreibaufruf wird nicht blind auf dem zweiten Weg wiederholt.
  Ein fehlender Empfangsbeleg beweist nicht, dass die Aktion nicht ausgeführt
  wurde. Die vorhandene Nachrichten-Ausgangsvormerkung behält ihre IDs.

Ein normaler Webbrowser kann Tor nicht selbst starten. Die PC-Weboberfläche ist
über den Onion-Zugang im Tor-Browser nutzbar. Tor kann seinerseits blockiert sein;
Bridges und Pluggable Transports sind in diesem Kandidaten nicht eingebunden.

## Prüfungen und iOS

Sechs zusätzliche Tests prüfen Umschaltung, Sitzungstreue, Abbruch, HTTP-Fehler und
Schutz vor doppeltem Ausführen. Der Android-Instrumentierungstest muss den echten
Onion-Aufruf nachweisen; allein diese Unit-Tests sind kein Verbindungsnachweis.

Für den nächsten ohnehin gemieteten Mac ist eine native iOS-Integration vor
Archivierung/Einreichung vorgesehen. Verifizierte Herstellergrundlage:
`iCepa/Tor.framework` Tag `v409.14.1`, CocoaPod `Tor` Version `409.14.1`, Tor
0.4.9.14. Das Podspec pinnt das Framework mit SHA256
`823d98fcafd8eba089f31b32989ad70e15a0e8a1b5709bc0d5941fb09ef1b625`.
Die vorhandene Capacitor-SPM-Integration ist zu erhalten; Tor/CocoaPods separat
im App-Workspace integrieren oder einen geprüften lokalen SPM-Wrapper bauen.

Der iOS-Adapter muss dieselbe SMTor-Schnittstelle (`request`, `cancel`, `stop`),
Ziel-/Pfadbeschränkung, Antwortgröße, Umleitungssperre, Vordergrundbindung und
Timeouts erfüllen. NSURLSession muss eine kurzlebige SOCKS-Konfiguration ohne
Cookies/Caches verwenden. Nur der eigene Onion-Host darf eine HTTP-Ausnahme
bekommen; keine globale ATS-Abschaltung. Tor über ControlPort `SIGNAL HALT`
beenden; bloßes `Thread.cancel()` beendet den Tor-Kern nicht. Unix-ControlSocket
im kurzen privaten temporären Verzeichnis halten und Cookies authentifizieren.

Vor Freigabe: Simulator-Build, Geräte-Build, HTTPS-Ausfall bei weiterlaufendem
Onion-Dienst, Empfang/Versand von Testdateien, Abbruch bei PIN-Sperre und Rückkehr
aus dem Hintergrund prüfen. iOS-Tor ist derzeit noch nicht implementiert oder
gebaut. Einreichung darf dies nicht als bereits unterstützte Funktion bewerben.
