DocumentationFAIRE TOURNER UN NŒUD DE FÉDÉRATION

FAIRE TOURNER UN NŒUD DE FÉDÉRATION

Exploitez un nœud souverain.

Un nœud de fédération participe au gossip d’immunité inter-appareils sans jamais voir de données utilisateur brutes. Facultatif — mais plus il y a de nœuds, plus le réseau est décentralisé.

01

Ce que fait un nœud

Un nœud reçoit des diffusions de motifs hachés depuis les appareils de sa région, exécute le protocole de quorum avec les nœuds pairs et rediffuse les motifs confirmés à ses appareils connectés. Il ne reçoit ni ne stocke jamais rien qui identifie un utilisateur.

Vie privée par construction
La couche de protocole ne transporte que des hachages SHA-256 et de larges tranches régionales. Il n’existe aucun chemin de code permettant à un nœud de recevoir une IP, un e-mail ou une coordonnée GPS. C’est imposé par un test automatisé qui fait échouer la build si la frontière est franchie.
02

Exigences matérielles

Un nœud est un démon Rust plus une instance PostgreSQL 16. Minimum :

  • 4 vCPU, 16 Go de RAM, 200 Go de SSD
  • Connectivité fiable, port public accessible (8443 par défaut)
  • YubiHSM 2 ou équivalent pour la clé d’identité de pair (recommandé)
  • Synchronisé en temps (NTP) — le protocole de quorum est sensible à la dérive d’horloge
03

Installer

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

Cérémonie de la clé d’identité de pair

La clé d’identité de pair du nœud signe chaque diffusion qu’il émet. Générez-la à l’intérieur du YubiHSM lors d’une cérémonie d’officiers M-of-N. Trois officiers, deux sur trois pour signer de nouvelles clés. Documentez la cérémonie dans votre journal interne.

shell/opt/lydos-fed/bin/lydos-fed key generate --hsm yubihsm \
  --slot 1 --label fed-peer-2026.06 \
  --officers 2-of-3
Avertissement clé chaude
Ne générez pas cette clé sur un poste de travail. La moitié privée ne doit jamais apparaître dans une mémoire de processus que vous ne contrôlez pas. Le HSM l’impose.
05

Rejoindre le registre de pairs

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

Le registre signe votre entrée et la rediffuse. Les autres nœuds vous contacteront et complèteront la poignée de main. L’intégration typique prend 10 à 30 minutes.

06

Surveillance

Le démon expose des métriques Prometheus sur /metrics et un instantané de santé JSON sur /health. Branchez-le sur votre tableau de bord existant ou interrogez-le directement.

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

Sauvegarde et restauration

Le volume PostgreSQL est le seul composant à état que vous devez sauvegarder. Les clés vivent dans le HSM et ne sont reconstituables que par cérémonie. La configuration du démon est reproductible depuis /etc/lydos-fed.

La restauration est rapide
Un nœud frais rejoint la fédération, demande aux pairs la tête de chaîne actuelle et se met à jour. Le plus long rattrapage que nous ayons observé en production est de 18 minutes, du démarrage à froid à l’entrée en quorum.