Exécuter un vérificateur Congrid

Installez un nœud Congrid complet et les services de vérification, ou rattachez ces composants à un nœud existant, avec une seule commande interactive. L’installateur officiel prend en charge Linux et macOS, utilise des binaires natifs et ne nécessite pas Docker.

Composants déployés par l’installateur

content-grid-d nœud complet
verifierd service d’exécution des tâches
indexerd service d’indexation des éditeurs
Service vectoriel Chroma
Services systemd sous Linux ou launchd sous macOS

Configuration réseau

Identifiant de chaîne : congrid-main
RPC public : https://congrid.net/rpc
RPC local après installation : tcp://127.0.0.1:26657
Dénomination des frais : ucongrid
Prix du gas conseillé : 0.001ucongrid

Étape 1 — Installer les services natifs de vérification

Sous Linux, exécutez cette commande avec un utilisateur normal disposant de sudo. Sous macOS, utilisez votre utilisateur normal sans sudo. L’installateur télécharge des binaires dont l’intégrité est vérifiée, demande les paramètres dans le terminal et récupère la liste des nœuds d’amorçage en mode complet.

curl -fsSL https://congrid.net/downloads/install.sh | bash

Si content-grid-d fonctionne déjà sur cette machine, installez uniquement Chroma, indexerd et verifierd en mode nœud existant :

curl -fsSL https://congrid.net/downloads/install.sh | bash -s -- --components-only

Ce mode vérifie les points d’accès RPC et gRPC existants, puis utilise un état isolé pour les composants. Il ne remplace, ne configure, n’arrête, ne démarre et ne redémarre pas le nœud existant.

Vous pouvez aussi télécharger et inspecter l’installateur avant de l’exécuter. Relancer la même commande met à jour le logiciel et les services tout en préservant les données de la chaîne, les clés, l’état du vérificateur et les données Chroma.

Protégez la clé du vérificateur : Lors de l’installation, choisissez de créer une clé ou de restaurer une phrase mnémonique existante. Pour une nouvelle clé, l’installateur affiche le chemin de son unique sauvegarde. Placez ce fichier dans un stockage hors ligne sécurisé avant d’approvisionner l’adresse. L’installateur attend ensuite que vous approvisionniez le dépôt et les frais ; cet approvisionnement ne soumet pas automatiquement le dépôt.

Étape 2 — Approvisionner et déposer la garantie

L’installateur affiche l’adresse du vérificateur à la fin. Envoyez suffisamment de ucongrid à cette adresse pour le dépôt et les frais courants, puis soumettez le dépôt depuis le même hôte. Les exemples utilisent le nom de clé par défaut verifier-key; remplacez-le si vous avez choisi un autre nom.

Linux

sudo -u congrid /usr/local/bin/content-grid-d verifier bond 1000000 \
  --denom ucongrid \
  --from verifier-key \
  --home /var/lib/congrid \
  --keyring-backend file \
  --keyring-dir /var/lib/congrid/keyrings/verifier \
  --chain-id congrid-main \
  --node tcp://127.0.0.1:26657 \
  --gas-prices 0.001ucongrid \
  -y

Avec --components-only, utilisez /usr/local/libexec/congrid/content-grid-d-client comme binaire Linux et /var/lib/congrid-components pour --home et le préfixe du chemin du trousseau de clés.

macOS

~/.local/bin/content-grid-d verifier bond 1000000 \
  --denom ucongrid \
  --from verifier-key \
  --home "$HOME/.content-grid" \
  --keyring-backend file \
  --keyring-dir "$HOME/.content-grid/keyrings/verifier" \
  --chain-id congrid-main \
  --node tcp://127.0.0.1:26657 \
  --gas-prices 0.001ucongrid \
  -y

Avec --components-only, utilisez ~/.local/share/congrid/libexec/content-grid-d-client comme binaire macOS et ~/.content-grid-components comme préfixe du répertoire de données et du trousseau de clés.

Étape 3 — Surveiller les services de vérification

Sous Linux, inspectez les quatre services systemd et suivez les journaux du vérificateur. Le mode nœud existant gère uniquement congrid-chroma, congrid-indexer, et congrid-verifier.

sudo systemctl status congrid-node congrid-chroma congrid-indexer congrid-verifier
sudo journalctl -u congrid-verifier -f

Sous macOS, inspectez la tâche launchd et son journal :

launchctl print "gui/$(id -u)/net.congrid.verifier"
tail -f "$HOME/.content-grid/logs/verifier.log"

Les points de contrôle de santé et les requêtes d’affectation sont accessibles localement sur les deux plateformes :

curl -fsS http://127.0.0.1:8000/healthz
curl -fsS http://127.0.0.1:9100/healthz
curl -fsS http://127.0.0.1:9200/healthz

# Linux binary path; use ~/.local/bin/content-grid-d on macOS
/usr/local/bin/content-grid-d verifier assignments <verifier-address> \
  --node tcp://127.0.0.1:26657 \
  --grpc-addr 127.0.0.1:9090 \
  --grpc-insecure \
  --include-finalized -o json

Lorsque l’installateur gère le nœud complet, autorisez les connexions entrantes TCP/26656 pour le réseau P2P.
Déclenchez des alertes en cas d’arrêt de service, de déconnexion RPC, de contrôles échoués ou de tâches en attente.
Conservez un solde suffisant pour les frais de transaction du vérificateur.
Relancez régulièrement l’installateur pour déployer les mises à jour publiées.

Conseil pour les vérificateurs : Gardez le nœud en ligne en permanence. Les contrôles manqués ou inexacts réduisent les récompenses possibles ; l’état du vérificateur est préservé lors des mises à jour et redémarrages.