DocumentatieDRAAI EEN FEDERATIE-NODE

DRAAI EEN FEDERATIE-NODE

Beheer een soevereine node.

Een federatie-node neemt deel aan cross-device immuniteitsgossip zonder ooit ruwe gebruikersdata te zien. Optioneel — maar hoe meer nodes, hoe meer gedecentraliseerd het netwerk.

01

Wat een node doet

Een node ontvangt gehashte-patroon-broadcasts van toestellen in zijn regio, draait het quorum-protocol met peer-nodes en herzendt bevestigde patronen naar zijn verbonden toestellen. Ze ontvangt of bewaart nooit iets dat een gebruiker identificeert.

Privacy by construction
De protocollaag draagt uitsluitend SHA-256-hashes en brede regio-buckets. Er is geen codepad waarlangs een node een IP, een e-mail of een GPS-coördinaat kan ontvangen. Dat wordt afgedwongen door een geautomatiseerde test die de build laat falen als de grens wordt geschonden.
02

Hardwarevereisten

Een node is een Rust-daemon plus een PostgreSQL 16-instantie. Minimaal:

  • 4 vCPU, 16 GB RAM, 200 GB SSD
  • Betrouwbare connectiviteit, publiek bereikbare poort (standaard 8443)
  • YubiHSM 2 of gelijkwaardig voor de peer-identity-sleutel (aanbevolen)
  • Tijd-gesynchroniseerd (NTP) — het quorum-protocol is gevoelig voor klokafwijking
03

Installeren

shell# 1. PostgreSQL 16 (skipped if you already have one)
sudo apt-get install -y postgresql-16

# 2. The federation daemon
curl -L -o lydos-fed-2026.06.r1.tar.gz \
  https://git.lydos.ailydian.com/lydos/sovereign-federation/releases/2026.06.r1/lydos-fed.tar.gz
curl -L -o release.manifest.json \
  https://git.lydos.ailydian.com/lydos/sovereign-federation/releases/2026.06.r1/release.manifest.json

# 3. Verify the bundle (the same protocol as the phone image)
./verify-bundle.sh --bundle lydos-fed-2026.06.r1.tar.gz --manifest release.manifest.json
# expects: signatures 3 / 3, hash match

# 4. Install
sudo tar -xzf lydos-fed-2026.06.r1.tar.gz -C /opt/lydos-fed
sudo /opt/lydos-fed/install.sh
04

Peer-identity-sleutelceremonie

De peer-identity-sleutel van de node tekent elke broadcast die ze uitzendt. Genereer hem binnen de YubiHSM onder een M-of-N-officierenceremonie. Drie officieren, twee-van-drie om nieuwe sleutels te tekenen. Documenteer de ceremonie in je interne log.

shell/opt/lydos-fed/bin/lydos-fed key generate --hsm yubihsm \
  --slot 1 --label fed-peer-2026.06 \
  --officers 2-of-3
Waarschuwing hete sleutel
Genereer deze sleutel niet op een workstation. De privé-helft mag nooit verschijnen in enig procesgeheugen dat je niet beheert. De HSM dwingt dit af.
05

Sluit je aan bij het peer-register

shell# Submit your node's public identity to the registry
/opt/lydos-fed/bin/lydos-fed join \
  --registry https://registry.lydos.ailydian.com \
  --pubkey-path /opt/lydos-fed/keys/fed-peer-2026.06.pub

Het register tekent je entry en herzendt het. Andere nodes nemen contact op en voltooien de handshake. Een typische onboarding duurt 10–30 minuten.

06

Monitoring

De daemon stelt Prometheus-metrieken beschikbaar op /metrics en een JSON-gezondheidsmomentopname op /health. Haak het in je bestaande dashboard of bevraag het rechtstreeks.

shellcurl https://your-node.example/health
# {
#   "version": "2026.06.r1",
#   "peers_online": "11/11",
#   "quorum": "ok",
#   "audit_chain_head": "3571a6c8…",
#   "uptime_seconds": 123456
# }
07

Back-up en herstel

Het PostgreSQL-volume is de enige stateful component die je moet back-uppen. De sleutels leven in de HSM en zijn alleen via ceremonie reconstrueerbaar. De daemon-configuratie is reproduceerbaar uit /etc/lydos-fed.

Herstellen gaat snel
Een verse node sluit zich aan bij de federatie, vraagt peers om de huidige ketenkop en loopt bij. De langste inhaalslag die we in productie hebben gezien, is 18 minuten van koude start tot in-quorum.