Skip to content

README.md

Latest commit

 

History

History
212 lines (163 loc) · 5.65 KB

README.md

File metadata and controls

212 lines (163 loc) · 5.65 KB
Raw

Archipel - Secure Offline P2P

Implémentation complète du protocole Archipel en Node.js:

  • découverte P2P sans Internet (UDP multicast)
  • tunnel chiffré pair-à-pair (X25519 + XChaCha20-Poly1305)
  • authentification sans CA (TOFU / Web of Trust)
  • messages chiffrés
  • transfert fichiers par chunks avec vérification SHA-256
  • CLI opérationnelle + site web local de supervision

1) Architecture

Chaque nœud exécute:

  • un serveur TCP (données chiffrées)
  • un module de découverte UDP multicast
  • une table de pairs + réputation
  • un moteur de transfert par chunks
  • une API locale HTTP + dashboard web
Node A <--- UDP HELLO ---> Node B
Node A <=== TCP chiffré ===> Node B

2) Cryptographie utilisée

  • Identité nœud: Ed25519
  • Échange de clés de session: X25519 (ephemeral)
  • Chiffrement transport: XChaCha20-Poly1305
  • Intégrité paquet Archipel: HMAC-SHA256
  • Intégrité chunks/fichiers: SHA-256

3) Installation

cd /home/vianekisdead/api-assassins
npm install

3.1) Workflow équipe (commits/push structurés)

Pour synchroniser souvent sans faire de faux commits:

# une seule tentative (test + commit/push si changements)
npm run team:sync:once

# boucle auto toutes les 30 secondes (commit/push seulement si changements)
npm run team:autosync

# boucle auto + tests avant chaque commit
npm run team:autosync:test

Options avancées:

bash scripts/team-autosync.sh --interval 45 --run-tests --branch main --remote origin

Le script:

  • ne commit/push que s'il y a de vrais changements
  • fait git pull --rebase --autostash avant commit
  • saute le push si les tests échouent (mode --run-tests)

4) Démarrer un nœud

node src/cli.js start --port 7777 --admin-port 8787 [--no-ai] [--ad-hoc]

Dashboard web:

Par défaut, les données du nœud sont stockées dans:

  • .archipel/node-<port>

5) Commandes CLI (alignées Sprint 4)

node src/cli.js status --admin-port 8787
node src/cli.js peers --admin-port 8787
node src/cli.js hello --admin-port 8787
node src/cli.js msg <node_id> "Hello" --admin-port 8787
node src/cli.js send <node_id> /tmp/fichier.bin --admin-port 8787
node src/cli.js ai "propose une réponse simple" --admin-port 8787
node src/cli.js ai-status --admin-port 8787
node src/cli.js key-revoke --admin-port 8787
node src/cli.js receive --admin-port 8787
node src/cli.js download <file_id> --admin-port 8787
node src/cli.js trust <node_id> --admin-port 8787
node src/cli.js stop --admin-port 8787

6) Démo rapide (2 nœuds)

Terminal A:

node src/cli.js start --port 7777 --admin-port 8787 --data-dir /tmp/arch-a

Terminal B:

node src/cli.js start --port 7778 --admin-port 8788 --data-dir /tmp/arch-b

Puis:

node src/cli.js status --admin-port 8787
node src/cli.js status --admin-port 8788
node src/cli.js peers --admin-port 8787

Envoyer message A -> B:

node src/cli.js msg <NODE_ID_B> "salut" --admin-port 8787

Envoyer fichier A -> B:

node src/cli.js send <NODE_ID_B> /tmp/arch-e2e.bin --admin-port 8787
node src/cli.js receive --admin-port 8788
node src/cli.js download <FILE_ID> --admin-port 8788

Mode ad-hoc (sans multicast, pair manuel):

Terminal A:

node src/cli.js start --port 7777 --admin-port 8787 --ad-hoc --data-dir /tmp/arch-a

Terminal B:

node src/cli.js start --port 7778 --admin-port 8788 --ad-hoc --data-dir /tmp/arch-b

Puis ajouter les peers manuellement et forcer HELLO:

node src/cli.js peer-add <NODE_ID_B> 192.168.1.20:7778 --admin-port 8787
node src/cli.js peer-add <NODE_ID_A> 192.168.1.10:7777 --admin-port 8788
node src/cli.js hello --admin-port 8787
node src/cli.js hello --admin-port 8788

7) Structure projet

src/
  protocol/      format paquet Archipel v1
  crypto/        identité + key exchange + AEAD
  network/       discovery multicast + frames + secure channel
  node/          runtime principal du nœud
  admin/         API locale HTTP
  cli.js         commandes utilisateur
apps/web/        site web local (dashboard + actions)

8) Notes importantes

  • Pas de serveur central.
  • Fonctionne en LAN local sans Internet.
  • Le chat P2P reste offline; Gemini est optionnel via l’API locale.
  • Pour forcer le mode offline IA: lancer avec --no-ai (ou ARCHIPEL_NO_AI=1).
  • Pour forcer la découverte ad-hoc (sans multicast): lancer avec --ad-hoc (ou ARCHIPEL_ADHOC=1).
  • Pour lancer plusieurs nœuds sur la même machine: utiliser des --data-dir et ports différents.

9) Intégration Gemini (optionnelle)

Configurer la clé API dans l'environnement:

export GEMINI_API_KEY="ta_cle_api"
export GEMINI_MODEL="gemini-2.0-flash"

Ou via fichier local .env (chargé automatiquement par src/cli.js et src/index.js):

GEMINI_API_KEY=ta_cle_api
GEMINI_MODEL=gemini-2.0-flash

Puis démarrer le nœud:

node src/cli.js start --port 7777 --admin-port 8787

Endpoints Gemini disponibles:

  • GET /api/ai/status -> état config + mode --no-ai
  • POST /api/ai/generate -> génération texte
  • POST /api/security/revoke-key -> prépare une nouvelle clé locale (redémarrage requis)
  • GET /api/trust-store -> empreintes et niveaux de confiance

Exemple:

curl -s -X POST http://127.0.0.1:8787/api/ai/generate \
  -H "content-type: application/json" \
  -d '{"prompt":"Réponds en français simple: bonjour"}'

Dans l'interface web, bouton Réponse IA dans la zone de message:

  • lit le contexte récent de conversation
  • génère un brouillon Gemini
  • remplit le champ message automatiquement

Commandes chat UI:

  • /ask ... -> génère une réponse IA (si IA activée)
  • @archipel-ai ... -> même comportement