🔗 Relais public

Qu'est-ce qu'un relais ?

Le relais est l'équivalent d'un DNS pour Spider. Il fait le pont entre les noms lisibles (adnimi.sp) et les nœuds réels (IP, nodeId).

Relais actuel

https://sp.adnimi.com

Il permet à n'importe quel site Spider d'être accessible depuis n'importe quel navigateur (Chrome, Firefox, Safari...).

Comment ça marche

1. Tu enregistres ton nom : POST /api/register
2. Un visiteur tape https://monnom.sp.adnimi.com/ dans Chrome
3. Nginx reçoit la requête, la passe au relais
4. Le relais cherche "monnom" dans son annuaire
5. Il contacte ton nœud via HRPT
6. Il convertit le HRL en HTML
7. Le visiteur voit ta page comme n'importe quel site web

Enregistrer son nom

Tu dois être joignable depuis Internet. Trois cas :

Cas 1 — Tu as un VPS

curl -X POST https://sp.adnimi.com/api/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "monnom",
    "nodeId": "'$(uslink nodeId)'",
    "host": "1.2.3.4",
    "port": 7777
  }'

Cas 2 — Tu es sur le même réseau que le relais

curl -X POST https://sp.adnimi.com/api/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "monnom",
    "nodeId": "'$(uslink nodeId)'",
    "host": "127.0.0.1",
    "port": 7777
  }'

Cas 3 — Tu es derrière un NAT

Utilise un tunnel :

cloudflared tunnel --url http://localhost:7777
# → te donne une URL comme xxxx.trycloudflare.com
# puis enregistre cette URL comme host

API du relais

Le futur : fédération

Pour rendre Spider vraiment universel, plusieurs relais seront fédérés. Chacun connaîtra les noms des autres. Résultat :

• Aucun point de défaillance unique
• Aucune censure possible
• Chacun peut lancer son relais et rejoindre le réseau

Le protocole de fédération est en cours de conception.