Warstwa P2P

Co oznacza P2P w Phantom

W Phantom nie istnieje centralny serwer wiadomości. Każde urządzenie jest jednocześnie klientem i małym serwerem ukrytym za adresem .onion. Gdy piszesz do kontaktu, aplikacja nie wysyła treści do chmury ani kolejki pośredniej — zestawia połączenie bezpośrednio z urządzeniem rozmówcy przez sieć Tor.

Warstwa P2P odpowiada za logikę rozmowy: znalezienie kontaktu po adresie .onion, zestawienie sesji, utrzymanie połączenia, potwierdzanie odbioru i ponawianie wysyłki, jeśli druga strona jest chwilowo niedostępna.

Trzy warstwy połączenia

Najprościej: Phantom buduje rozmowę z trzech niezależnych warstw. Każda ma inne zadanie i inną granicę odpowiedzialności.

Jak wygląda zestawienie sesji

Gdy dodajesz kontakt przez QR albo ręcznie wpisany adres, Phantom zapisuje adres .onion i próbuje zestawić bezpośrednią sesję. Nie pyta żadnego katalogu użytkowników, bo taki katalog nie istnieje.

1. Użytkownik A zna adres .onion użytkownika B

   Adres pochodzi z QR, linku zaproszenia albo ręcznego wpisania. To wystarcza, żeby rozpocząć próbę połączenia.

2. Phantom buduje obwód Tor

   Aplikacja łączy się z lokalnym proxy SOCKS5 Tora, a Tor znajduje Hidden Service odbiorcy przez mechanizm introduction points i rendezvous point.

3. Urządzenia wykonują handshake

   Po otwarciu kanału aplikacje wymieniają minimalne informacje protokołu: wersję, identyfikator kontaktu, klucze sesji i parametry szyfrowania.

4. Rozmowa przechodzi w tryb aktywny

   Od tego momentu wiadomości, potwierdzenia odbioru i status online płyną bezpośrednio między urządzeniami.

Telefon A
  → Tor SOCKS5 (127.0.0.1:9050)
  → obwód Tor A
  → Rendezvous Point
  ← obwód Tor B
  ← Hidden Service telefonu B
  ← lokalny listener Phantom (127.0.0.1:8080)

Format logiczny wiadomości

Warstwa P2P nie musi znać tekstu wiadomości. Dla niej wiadomość to zaszyfrowany obiekt z metadanymi technicznymi potrzebnymi do dostarczenia i uporządkowania rozmowy.

{
  "type": "message",
  "conversation_id": "local-contact-id",
  "message_id": "01J9Y7...",
  "sent_at": 1730914200,
  "payload": "<zaszyfrowany blob E2E>",
  "ack_required": true
}

payload jest szyfrowany end-to-end. Pola techniczne służą do deduplikacji, sortowania i potwierdzania dostarczenia. Jeśli ten sam pakiet dotrze drugi raz po ponowieniu wysyłki, aplikacja rozpoznaje message_id i nie pokazuje duplikatu w rozmowie.

Potwierdzenia i ponawianie

W klasycznym komunikatorze serwer pełni rolę bufora: przyjmuje wiadomość, przechowuje ją i oddaje odbiorcy później. W Phantom ten mechanizm jest lokalny i ograniczony do urządzeń rozmówców.

Obecność i status kontaktu

Status online w Phantom nie pochodzi z serwera obecności. Aplikacja ocenia go na podstawie realnej osiągalności kontaktu przez Tor i ostatniej aktywnej sesji.

Przykład

online
  → istnieje aktywna sesja P2P
  → ostatni ping/pong wrócił poprawnie
  → kanał Tor nadal jest dostępny

offline
  → nie udało się zestawić kanału
  → ostatnia sesja wygasła
  → wiadomości trafiają do lokalnej kolejki nadawcy

To dlatego zielona kropka przy kontakcie oznacza coś konkretnego: nie "serwer widział użytkownika minutę temu", tylko "aplikacja może teraz rozmawiać z tym węzłem przez Tor".

Dlaczego nie ma serwera pośredniczącego

Serwer centralny jest wygodny, ale tworzy stały punkt obserwacji. Nawet gdy treść jest szyfrowana, serwer może widzieć kto z kim rozmawia, kiedy, jak często i z jakiego adresu IP. Phantom usuwa ten punkt z architektury.

Granice warstwy P2P

P2P nie rozwiązuje wszystkiego. Ta warstwa odpowiada za transport między urządzeniami, ale nie zastępuje higieny bezpieczeństwa, ochrony urządzenia ani świadomego zarządzania tożsamością.