Le Client du Voyageur

Installation de Radicle, identité cryptographique et premiers pas

Installer Radicle (rad)

Radicle est un outil en ligne de commande appelé rad. C'est ton interface avec le réseau pair-à-pair. Avant toute chose, il faut l'installer sur ta machine.

Sur Linux

La méthode recommandée utilise le script d'installation officiel :

# Méthode 1 : Script d'installation officiel
curl -sSf https://radicle.xyz/install | sh

# Méthode 2 : Via Cargo (si tu as Rust installé)
cargo install radicle-cli

# Vérifie l'installation
rad --version

Le binaire rad est installé dans ~/.radicle/bin/. Assure-toi que ce chemin est dans ton PATH :

# Ajouter au PATH (dans ~/.bashrc ou ~/.zshrc)
export PATH="$HOME/.radicle/bin:$PATH"

Sur macOS

# Via le script officiel
curl -sSf https://radicle.xyz/install | sh

# Ou via Cargo (si tu as Rust installé)
cargo install radicle-cli

# Vérifie l'installation
rad --version

Sur Windows

Radicle est principalement conçu pour Linux et macOS. Sur Windows, tu as deux options :

# Via WSL (Windows Subsystem for Linux) - seule méthode supportée
# Dans un terminal WSL Ubuntu :
curl -sSf https://radicle.xyz/install | sh

Ton identité cryptographique

Sur GitHub, tu as un nom d'utilisateur et un mot de passe. Sur Radicle, c'est différent. Ton identité repose sur la cryptographie - une paire de clés qui prouve que tu es bien toi, sans qu'aucun serveur n'ait besoin de le vérifier.

Créer ton identité avec rad auth

# Créer ton identité Radicle
rad auth

# Tu verras quelque chose comme :
# Initializing your radicle 🌱 identity
# Enter a passphrase (or leave blank):
# Your DID is did:key:z6Mki7...
# You're all set!

La commande rad auth génère :

• Une clé privée (stockée localement dans ~/.radicle/keys/) - c'est ton secret, ne la partage jamais
• Une clé publique - c'est ton identité visible par les autres
• Un DID (Decentralized Identifier) - un identifiant unique au format did:key:z6Mk...

Comprendre les clés ed25519

Radicle utilise le même type de clés que SSH : ed25519. C'est un algorithme de signature numérique moderne, rapide et sûr. Chaque action que tu fais sur Radicle (publier, commenter, proposer un patch) est signée cryptographiquement.

Cela signifie que personne ne peut usurper ton identité - même s'il n'existe aucun serveur central pour vérifier qui est qui.

Le DID - ton identité décentralisée

Le DID (Decentralized Identifier) est un standard du W3C. C'est une manière universelle de s'identifier sans dépendre d'un fournisseur. Ton DID Radicle ressemble à :

did:key:z6Mki7kFMjfQXbB2tRzpR5oSrQFkAuGhUTnKGVzE8pTo6VDB

Ce DID est dérivé mathématiquement de ta clé publique. Il est unique au monde et tu en es le seul propriétaire.

Initialiser un projet Radicle

Radicle ne remplace pas Git - il s'appuie dessus. Tu commences toujours avec un dépôt Git normal, puis tu y ajoutes la couche Radicle.

rad init - transformer un dépôt Git en projet Radicle

# Crée un dépôt Git normal
mkdir mon-projet
cd mon-projet
git init -b main
echo "# Mon Projet" > README.md
git add README.md
git commit -m "Premier commit"

# Initialise Radicle dans ce dépôt
rad init

# Tu verras :
# Initializing radicle 🌱 project in /home/user/mon-projet
# Name: mon-projet
# Description: (optionnel)
# Default branch: main
# Project rad:z2e7R... created.

La commande rad init crée un identifiant de projet unique (le rad:z...). C'est l'équivalent décentralisé d'une URL GitHub. Cet identifiant est permanent et ne changera jamais.

rad inspect - examiner un projet

# Voir les détails du projet
rad inspect

# Affiche :
# Project: mon-projet
# RID: rad:z2e7R...
# Description: ...
# Default branch: main
# Delegates: did:key:z6Mk... (toi)

Le champ Delegates est important : ce sont les personnes autorisées à merger des patches. Quand tu crées un projet, tu en es le seul délégué.

Publier et synchroniser

rad push - publier ton code sur le réseau

# Publie ton dépôt sur le réseau Radicle
rad push

# Le nœud Radicle local annonce ton projet aux pairs
# Les seeds (nœuds toujours en ligne) vont le répliquer

Contrairement à git push qui envoie vers un serveur précis, rad push publie sur le réseau de pairs. Il n'y a pas de destination unique - ton code est disponible pour tous ceux qui sont connectés.

rad sync - synchroniser avec les pairs

# Synchronise avec les pairs connectés (envoie et récupère les mises à jour)
rad sync

rad sync est l'équivalent d'un git fetch décentralisé. Il contacte les pairs connectés et échange les dernières modifications. La récupération (fetch) est incluse par défaut.

Cloner un projet avec rad clone

# Cloner un projet Radicle
rad clone rad:z2e7RaGkMUjH3dMhiKd5dm2E3pCXA

# Le clone :
# 1. Contacte les pairs et seeds qui hébergent ce projet
# 2. Télécharge le dépôt Git
# 3. Configure automatiquement les remotes Radicle

L'identifiant rad:z... remplace l'URL GitHub. Tu peux le partager par n'importe quel canal - email, messagerie, QR code. Tant qu'un nœud connecté possède le projet, tu peux le cloner.

Les Patches - Pull Requests décentralisées

Sur GitHub, tu crées une Pull Request pour proposer des modifications. Sur Radicle, l'équivalent s'appelle un Patch. Même concept, mais sans serveur central.

Créer un patch

# 1. Crée une branche et fais tes modifications
git switch -c ma-fonctionnalite
echo "Nouvelle fonctionnalité" >> README.md
git add README.md
git commit -m "Ajouter une fonctionnalité"

# 2. Propose un patch
rad patch create

# Tu seras invité à entrer :
# - Un titre pour le patch
# - Une description (optionnelle)
# Le patch est signé avec ta clé et publié sur le réseau

Lister et consulter les patches

# Lister tous les patches du projet
rad patch list

# Affiche :
# ID       TITLE                    AUTHOR            STATUS
# abc123   Ajouter une fonctionnal  did:key:z6Mk...   open

# Voir les détails d'un patch
rad patch show abc123

Commenter un patch

# Ajouter un commentaire à un patch
rad patch comment abc123 --message "Bonne idée, mais peux-tu ajouter des tests ?"

Merger un patch

# Si tu es un delegate du projet, tu peux merger
rad patch merge abc123

# Le patch est fusionné dans la branche par défaut
# L'action est signée et propagée sur le réseau

Fermer un patch sans merger

# Fermer un patch (rejeté ou abandonné)
rad patch close abc123

Les Issues décentralisées

Radicle propose aussi un système d'issues intégré - pas besoin d'un tracker externe.

Créer une issue

# Créer une issue
rad issue create --title "Bug : le fichier de config ne se charge pas" \
                 --description "Quand on lance l'application sans config.yaml, elle plante au lieu d'utiliser les valeurs par défaut."

Lister et gérer les issues

# Lister les issues ouvertes
rad issue list

# Commenter une issue
rad issue comment <issue-id> --message "Je reproduis le bug sur Linux."

# Fermer une issue
rad issue close <issue-id>

# Rouvrir une issue (changer son état)
rad issue state <issue-id> open

Comme les patches, les issues sont stockées dans les données Radicle du dépôt. Elles voyagent avec le code, de pair en pair.

Comparaison - GitHub vs Radicle

Exercice pratique - Premiers pas avec rad

# Crée ton identité Radicle
rad auth

# Note ton DID quelque part - c'est ton identité

# Crée un nouveau dépôt
mkdir atelier-voyageur
cd atelier-voyageur
git init -b main

# Crée un premier fichier
echo "# Atelier du Voyageur" > README.md
echo "Mon premier projet Radicle." >> README.md
git add README.md
git commit -m "Initialisation du projet"

# Initialise Radicle
rad init

# Vérifie les détails du projet
rad inspect

# Note l'identifiant du projet (RID : rad:z...)

# Crée une branche de travail
git switch -c amelioration-readme

# Modifie le README
echo "" >> README.md
echo "## Fonctionnalités" >> README.md
echo "- Collaboration pair-à-pair" >> README.md
echo "- Identité cryptographique" >> README.md

git add README.md
git commit -m "Ajouter la section fonctionnalités"

# Propose un patch
rad patch create

# Liste tes patches
rad patch list

# Reviens sur main et merge le patch
git switch main
rad patch merge <id-du-patch>

# Crée une issue de test
rad issue create --title "Ajouter un fichier CONTRIBUTING" \
                 --description "Il faudrait expliquer comment contribuer au projet."

# Liste les issues
rad issue list

Récapitulatif des commandes