Guide du validateur
Ce que font les validateurs, ce que le réseau leur crédite, et comment entretenir, déplacer et retirer un nœud validateur.
Le rôle
Que fait un validateur ?
Il exécute un nœud Bigfoot en mode validateur, qui confirme et finalise l’enregistrement partagé du réseau avec les autres validateurs. Un validateur ne fait que valider : il ne stocke ni ne relaie les enregistrements.
De quoi ai-je besoin ?
Une machine Linux exécutant Ubuntu 24.04 LTS, sur x86-64 ou ARM64, avec une adresse publique. La Bigfoot CLI, que vous utilisez pour créer votre clé, fonctionne sous Linux et macOS, sur ARM64 comme sur x86-64. Un validateur ne peut partager ni une machine ni une adresse publique avec un nœud de stockage ; en IPv6, le même réseau /64 compte comme la même adresse.
Que reçoit un validateur ?
Chaque nouvelle publication et chaque réponse paient des frais de service, et le réseau crédite 5 % de ces frais, à parts égales, aux validateurs dont les signatures l’ont finalisée. Les autres tâches de validation ne donnent pas lieu à des crédits, pas plus que l’appartenance au réseau à elle seule. Frais et crédits explique les frais de service.
Comment candidater ?
Créez une clé avec la Bigfoot CLI et signez votre candidature avec celle-ci : bigfoot-node sign-application --role validator --email ADDRESS --thumbprint T, où ADDRESS est l’adresse e-mail utilisée pour votre candidature. La commande affiche un jeton de candidature sur une seule ligne, qui ne fonctionne que pour ce rôle et cette adresse e-mail, et uniquement tant qu’il est récent. Collez le jeton dans le formulaire de la page des validateurs ; le site vérifie sa signature et en extrait votre empreinte. Les membres de la gouvernance décident par vote.
Comment attribuer son rôle à ma clé ?
bigfoot-node create-key laisse le rôle d’une clé non attribué, et bigfoot-node init --mode validator refuse un répertoire qui ne contient aucune clé de validateur. Une fois admis, conservez une copie protégée de la clé avec bigfoot-node export-key --id N --out FILE --passphrase-file FILE, où --out désigne un nouveau fichier pour la copie et --passphrase-file désigne un fichier contenant sa phrase secrète. Ensuite, sur la machine du validateur et dans le répertoire que son nœud utilisera, enregistrez la copie avec bigfoot-node import --key FILE --role validator, qui demande cette phrase secrète. Utilisez des chemins absolus.
Que se passe-t-il après mon approbation ?
Commencez par attribuer à votre clé son rôle de validateur, comme indiqué ci-dessus. Démarrez ensuite un nœud en mode validateur : bigfoot-node init --mode validator --endpoint HOST:PORT, puis bigfoot-node start. Lors de son premier démarrage, le nœud prouve qu’il détient la clé, qu’il dispose d’un nœud de stockage actif sur une autre adresse pour confirmer son adresse, et rejoint les validateurs. Ce nœud de stockage est choisi automatiquement.
Transporteur, pas conservateur
Est-ce que je choisis ce que mon validateur accepte ?
Non. En exécutant le logiciel de nœud sans modification, votre validateur valide ce que les règles du réseau autorisent : vous ne choisissez, ne modifiez et ne supprimez aucun enregistrement. Modifier le logiciel pour sélectionner, modifier ou supprimer des enregistrements vous fait passer de validateur à conservateur : vous décideriez de ce que le réseau conserve et seriez responsable de ces décisions. Toute faute avérée est enregistrée, et les membres de la gouvernance peuvent voter pour retirer un validateur.
Quelles lois s’appliquent à moi ?
Les opérateurs sont responsables des lois qui s’appliquent à eux là où ils exécutent un validateur. Ce guide ne constitue pas un avis juridique.
Exécuter un validateur
Mon validateur doit-il rester en ligne ?
Oui. Le réseau ne finalise de nouveaux enregistrements que lorsque plus des deux tiers de ses validateurs signent. Avec quatre validateurs, l’un d’eux peut être hors ligne ; si un deuxième tombe en panne, le réseau cesse de finaliser jusqu’à leur retour.
Comment le mettre hors ligne pour maintenance ?
Exécutez d’abord bigfoot-node maintenance on, puis bigfoot-node stop. maintenance on vérifie que les autres validateurs peuvent continuer à finaliser sans le vôtre et vous demande de confirmer, mais ne fait qu’activer un indicateur de maintenance : il n’arrête pas le nœud. Tant que l’indicateur est activé, le nœud ne démarre pas et ne prépare pas les mises à niveau planifiées. Lorsque vous avez terminé, exécutez bigfoot-node maintenance off, puis bigfoot-node start.
Comment les mises à niveau sont-elles gérées ?
Les mises à niveau planifiées du protocole s’installent automatiquement à la hauteur définie par le réseau. bigfoot-node status affiche toute mise à niveau préparée ou planifiée, et chaque commande affiche un avis lorsqu’une version vous attend. Cette version s’installe lorsque vous exécutez bigfoot-node update.
Que se passe-t-il en cas de problème ?
Une faute avérée d’un validateur est enregistrée, mais n’est pas sanctionnée automatiquement. Le retrait d’un validateur nécessite toujours un vote de gouvernance.
Puis-je déplacer mon validateur vers un nouveau matériel ?
Oui, sans approbation. Arrêtez le nœud, exécutez bigfoot-node backup --out DIR, déplacez la sauvegarde vers la nouvelle machine, exécutez-y bigfoot-node restore --from DIR, puis démarrez-la. N’exécutez jamais l’ancienne et la nouvelle machine en même temps.
Comment remplacer ma clé de validateur ?
Arrêtez le nœud et exécutez bigfoot-node rotate-key --thumbprint T sur sa machine. Cette commande remplace simultanément votre clé de validateur et la clé de signature du nœud, et votre adhésion se poursuit avec la nouvelle clé.
Se retirer
Comment cesser d’être validateur ?
Exécutez bigfoot-node decommission sur la machine du validateur et confirmez. Quitter l’ensemble des validateurs nécessite un vote de gouvernance, alors la commande indique qu’elle attend cette étape : demandez à un membre de la gouvernance de parrainer votre retrait. Laissez le nœud fonctionner jusqu’à la prise d’effet du retrait, puis arrêtez-le et exécutez de nouveau bigfoot-node decommission pour retirer ses clés.
Un retrait peut-il être retardé ?
Oui. Le réseau conserve toujours au moins quatre validateurs ; un retrait qui en laisserait moins, ou qui empêcherait le réseau de finaliser, ne peut prendre effet avant l’arrivée d’autres validateurs.
Que devient mon historique ?
Le retrait laisse une trace permanente sur le réseau, et vos validations passées restent attribuées à votre identité. Votre clé ne peut pas rejoindre à nouveau le réseau. Pour valider de nouveau, candidatez avec une nouvelle clé.
Vous cherchez autre chose ?
Consultez l’aide des produits, explorez Comprendre ou recherchez un terme dans le Glossaire. Vous pouvez aussi nous contacter pour poser une question.