Aller au contenu principal

Commandes de nœud

Référence des commandes qorechaind utilisées pour initialiser, configurer et faire fonctionner un nœud QoreChain.

remarque

QoreChain exploite deux réseaux : le mainnet qorechain-vladi (en service depuis le 7 juin 2026 ; version du nœud v3.2.7, appliquée à la hauteur 4 164 600 le 12 novembre 2026 par la proposition de gouvernance 16 ; la v3.2.6 a été appliquée à la hauteur 4 020 000 le 4 novembre 2026 ; la v3.2.5 a été appliquée à la hauteur 3 906 833 le 29 octobre 2026, la v3.2.4 à la hauteur 3 742 566 le 23 octobre 2026 et la v3.2.3 à la hauteur 3 662 051 le 20 octobre 2026) et le testnet qorechain-diana (version du nœud v3.2.8, appliquée à la hauteur 9 929 500 le 12 novembre 2026, après la v3.2.7 à la hauteur 9 594 600 le 6 novembre, la v3.2.6 à la hauteur 8 970 638 le 27 octobre, la v3.2.5 à la hauteur 8 890 800 le 26 octobre et la v3.2.4 à la hauteur 8 337 253 le 19 octobre ; le mainnet n'a pas appliqué la v3.2.8). Indiquez le --chain-id correspondant au réseau que vous souhaitez rejoindre — les exemples ci-dessous ciblent le testnet ; utilisez --chain-id qorechain-vladi pour le mainnet. La version actuelle de chaque réseau est indiquée dans latest.json sur download.qore.host.

Les commandes de cette page ont été vérifiées avec le binaire de la version v3.2.3. Le binaire v3.2.4 ajoute des commandes qu'un binaire v3.2.3 n'a pas (par exemple stakingtier) ; elles fonctionnent sur les deux réseaux (testnet depuis le 19 octobre 2026, mainnet depuis le 23 octobre 2026), et lorsque ce manuel en mentionne une, il l'indique. Le binaire v3.2.6 (les deux réseaux) ajoute deux commandes de requête supplémentaires, query rlconsensus applied-params et last-action (voir Commandes de requête). Tout le reste de cette page se comporte de la même façon sur les deux versions.


init​

Initialise un nouveau nœud avec le moniker donné.

qorechaind init <moniker> --chain-id qorechain-diana
FlagTypeDescription
--chain-idstringIdentifiant de la chaîne (à toujours indiquer ; un identifiant aléatoire est créé s'il est omis)
--homestringRépertoire home du nœud (par défaut : ~/.qorechaind)
--overwriteboolÉcrase le genesis.json existant
--recoverboolFournit une phrase mnémonique pour récupérer une clé existante au lieu d'en créer une

Crée l'arborescence de répertoires sous --home avec config/, data/, et un genesis.json initial. Pour un nœud de réseau, remplacez ce genesis.json par le fichier genesis du réseau avant le démarrage (voir Connexion au mainnet).

init écrit également l'identifiant de chaîne EVM du réseau (9801 pour qorechain-vladi, 9800 pour qorechain-diana) dans le paramètre evm-chain-id de app.toml ; indiquez donc le bon --chain-id.


start​

Démarre le nœud et commence la synchronisation ou la production de blocs.

qorechaind start [flags]
FlagTypeDescription
--homestringRépertoire home du nœud
--minimum-gas-pricesstringPrix de gas minimum accepté par ce nœud. Le plancher du réseau est 0.1uqor ; indiquez au moins cette valeur
--pruningstringStratégie d'élagage : default, nothing, everything, custom (avec --pruning-keep-recent et --pruning-interval)
--halt-heightuintArrête le nœud à cette hauteur de bloc
--halt-timeuintArrête le nœud à cet horodatage Unix
--log_levelstringVerbosité des journaux : info, debug, warn, error
--traceboolActive la trace de pile complète en cas d'erreur

Un binaire compilé à partir de l'arborescence de sources publique (la version communautaire) refuse de démarrer sur qorechain-vladi ou qorechain-diana : il ne peut pas vérifier les signatures post-quantiques et ne peut pas rejouer fidèlement les blocs des réseaux (version de nœud v3.2.3 et ultérieures). Utilisez le binaire de la version publiée sur download.qore.host ; voir Compilation depuis les sources.


version​

qorechaind version ne renvoie pas le numéro de version sur les binaires publiés : elle affiche une ligne vide, et version --long n'ajoute aucun détail de build. Ne vous y fiez pas pour distinguer les versions. Pour confirmer ce que vous exécutez :

  • Comparez le SHA-256 de l'archive téléchargée avec binary.sha256 dans le manifeste du réseau avant de l'extraire (et conservez cette archive, ou son empreinte, comme trace de ce que vous avez installé).
  • Demandez à la chaîne quelles mises à niveau elle a appliquées : GET /cosmos/upgrade/v1beta1/applied_plan/<upgrade_name> renvoie la hauteur à laquelle une mise à niveau a été appliquée, ou 0 si elle ne l'a pas été.
# archive checksum, as published
curl -s https://download.qore.host/mainnet/latest.json | jq -r '.version, .binary.sha256'
# has v3.2.3 / v3.2.4 / v3.2.5 / v3.2.6 / v3.2.7 been applied on mainnet, and at which height? (a name that was not applied returns {"height":"0"})
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.3 # {"height":"3662051"}
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.4 # {"height":"3742566"}
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.6 # {"height":"4020000"}
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.7 # {"height":"4164600"}

status​

Interroge le nœud en cours d'exécution sur son état actuel, incluant l'état de synchronisation, la dernière hauteur de bloc et les informations de consensus.

qorechaind status
FlagTypeDescription
--nodestringPoint de terminaison RPC (par défaut : tcp://localhost:26657)

Renvoie du JSON avec les sections node_info, sync_info et validator_info.


client configuration​

Il n'existe pas de sous-commande config. Les valeurs par défaut du client (chain-id, keyring-backend, output, node) sont lues depuis <home>/config/client.toml ; modifiez ce fichier, ou passez le flag à chaque commande (--chain-id, --keyring-backend, --output, --node).


keys​

Gère le trousseau de clés local pour signer les transactions.

Ajouter une nouvelle clé​

qorechaind keys add <name> [flags]
FlagTypeDescription
--keyring-backendstringBackend : os, file, kwallet, pass, test, memory
--key-typestringAlgorithme de clé : secp256k1 (par défaut) ou eth_secp256k1
--coin-typeuint32Coin type HD (par défaut 118)
--recoverboolRécupère la clé à partir d'une phrase mnémonique
--multisigstringListe de clés séparées par des virgules pour le multisig
--multisig-thresholduintNombre minimum de signatures requises

Lister toutes les clés​

qorechaind keys list --keyring-backend <backend>

Afficher les détails d'une clé​

qorechaind keys show <name> [flags]
FlagTypeDescription
--bechstringFormat de sortie : acc, val, cons
--addressboolAffiche uniquement l'adresse
--pubkeyboolAffiche uniquement la clé publique

Supprimer une clé​

qorechaind keys delete <name> --keyring-backend <backend>

Exporter une clé (chiffrée par armor)​

qorechaind keys export <name>

Importer une clé​

qorechaind keys import <name> <keyfile>

genesis​

Gère le fichier genesis.

Ajouter un compte genesis​

qorechaind genesis add-genesis-account <address> <coins> [flags]
FlagTypeDescription
--vesting-amountstringMontant de vesting
--vesting-start-timeintDate de début de vesting (horodatage Unix)
--vesting-end-timeintDate de fin de vesting (horodatage Unix)

Créer une transaction genesis​

qorechaind genesis gentx <key-name> <stake-amount> [flags]
FlagTypeDescription
--chain-idstringIdentifiant de la chaîne
--monikerstringMoniker du validateur
--commission-ratestringTaux de commission initial
--commission-max-ratestringTaux de commission maximum

Collecter les transactions genesis​

qorechaind genesis collect-gentxs

Autres sous-commandes de genesis : bulk-add-genesis-account et migrate.

Valider le fichier genesis​

qorechaind genesis validate

Moteur de consensus​

Ces sous-commandes interagissent avec la couche du moteur de consensus de QoreChain.

Afficher la clé du validateur​

qorechaind comet show-validator

Affiche la clé publique de consensus au format JSON. Utilisée pour vérifier l'identité du validateur.

Afficher l'identifiant du nœud​

qorechaind comet show-node-id

Affiche l'identifiant P2P du nœud (encodé en hexadécimal). Utilisé pour la configuration des pairs persistants.


export​

Exporte l'état actuel de la chaîne sous forme de fichier genesis JSON. Utile pour les mises à niveau de chaîne ou les instantanés.

qorechaind export [flags]
FlagTypeDescription
--for-zero-heightboolPrépare l'export pour un redémarrage à la hauteur 0
--heightintExporte l'état à une hauteur de bloc spécifique
--homestringRépertoire home du nœud
--output-documentstringÉcrit l'export dans ce fichier au lieu de STDOUT
--modules-to-exportstringsListe de modules à exporter, séparés par des virgules (par défaut : tous)
--jail-allowed-addrsstringsAdresses opérateur des validateurs emprisonnés à libérer

rollback​

Fait revenir l'état de la chaîne d'un bloc en arrière. Utile pour se remettre d'un échec de consensus.

qorechaind rollback [flags]
FlagTypeDescription
--hardboolSupprime également le dernier bloc du magasin de blocs
--homestringRépertoire home du nœud

Cette commande fait revenir en arrière à la fois l'état de l'application et l'état du consensus. À utiliser avec prudence, car elle ne peut pas être annulée.