Zum Hauptinhalt springen

Node-Befehle

Referenz für qorechaind-Befehle zum Initialisieren, Konfigurieren und Betreiben eines QoreChain-Node.

hinweis

QoreChain betreibt zwei Netzwerke: das qorechain-vladi-Mainnet (live seit dem 7. Juni 2026; Node-Version v3.2.7, angewendet bei Höhe 4.164.600 am 12. November 2026 durch den Governance-Vorschlag 16; v3.2.6 wurde bei Höhe 4.020.000 am 4. November 2026 angewendet; v3.2.5 wurde bei Höhe 3.906.833 am 29. Oktober 2026, v3.2.4 bei Höhe 3.742.566 am 23. Oktober 2026 und v3.2.3 bei Höhe 3.662.051 am 20. Oktober 2026 angewendet) und das qorechain-diana-Testnet (Node-Version v3.2.8, angewendet bei Höhe 9.929.500 am 12. November 2026, nach v3.2.7 bei Höhe 9.594.600 am 6. November, v3.2.6 bei Höhe 8.970.638 am 27. Oktober, v3.2.5 bei Höhe 8.890.800 am 26. Oktober und v3.2.4 bei Höhe 8.337.253 am 19. Oktober; das Mainnet hat v3.2.8 nicht angewendet). Übergeben Sie die passende --chain-id für das Netzwerk, dem Sie beitreten möchten — die folgenden Beispiele zielen auf das Testnet ab; verwenden Sie --chain-id qorechain-vladi für das Mainnet. Die aktuelle Version jedes Netzwerks ist in latest.json unter download.qore.host aufgeführt.

Die Befehle auf dieser Seite wurden gegen die Release-Binary v3.2.3 geprüft. Die v3.2.4-Binary enthält Befehle, die eine v3.2.3-Binary nicht hat (zum Beispiel stakingtier); sie laufen auf beiden Netzwerken (Testnet seit dem 19. Oktober 2026, Mainnet seit dem 23. Oktober 2026), und wo dieses Handbuch einen solchen erwähnt, wird das angegeben. Die v3.2.6-Binary (beide Netzwerke) fügt zwei weitere Abfragebefehle hinzu, query rlconsensus applied-params und last-action (siehe Abfragebefehle). Alles Übrige auf dieser Seite verhält sich in beiden Releases gleich.


init​

Initialisiert einen neuen Node mit dem angegebenen Moniker.

qorechaind init <moniker> --chain-id qorechain-diana
FlagTypBeschreibung
--chain-idstringChain-Kennung (immer angeben; ohne Angabe wird eine zufällige erzeugt)
--homestringNode-Home-Verzeichnis (Standard: ~/.qorechaind)
--overwriteboolVorhandene genesis.json überschreiben
--recoverboolEine Seed-Phrase angeben, um einen vorhandenen Schlüssel wiederherzustellen, statt einen neuen zu erzeugen

Erstellt die Verzeichnisstruktur unter --home mit config/, data/ und einer initialen genesis.json. Ersetzen Sie bei einem Netzwerk-Node diese genesis.json vor dem Start durch die Genesis-Datei des Netzwerks (siehe Mit dem Mainnet verbinden).

init schreibt außerdem die EVM-Chain-ID des Netzwerks (9801 für qorechain-vladi, 9800 für qorechain-diana) in die Einstellung evm-chain-id der app.toml; übergeben Sie daher die richtige --chain-id.


start​

Startet den Node und beginnt mit der Synchronisierung bzw. der Blockerzeugung.

qorechaind start [flags]
FlagTypBeschreibung
--homestringNode-Home-Verzeichnis
--minimum-gas-pricesstringMinimaler Gas-Preis, den dieser Node akzeptiert. Die Untergrenze des Netzwerks liegt bei 0.1uqor; setzen Sie mindestens diesen Wert
--pruningstringPruning-Strategie: default, nothing, everything, custom (mit --pruning-keep-recent und --pruning-interval)
--halt-heightuintNode bei dieser Blockhöhe anhalten
--halt-timeuintNode zu diesem Unix-Zeitstempel anhalten
--log_levelstringLog-Ausführlichkeit: info, debug, warn, error
--traceboolVollständigen Stack-Trace bei Fehlern aktivieren

Eine aus dem öffentlichen Quellbaum gebaute Binary (der Community-Build) weigert sich, auf qorechain-vladi oder qorechain-diana zu starten: Sie kann Post-Quanten-Signaturen nicht verifizieren und die Blöcke der Netzwerke nicht originalgetreu nachspielen (Node-Version v3.2.3 und später). Verwenden Sie die Release-Binary von download.qore.host; siehe Aus dem Quellcode bauen.


version​

qorechaind version meldet bei den Release-Binaries die Versionsnummer nicht: Es gibt eine leere Zeile aus, und version --long fügt keine Build-Details hinzu. Verlassen Sie sich nicht darauf, um Releases zu unterscheiden. So bestätigen Sie, was Sie betreiben:

  • Vergleichen Sie vor dem Entpacken den SHA-256 des heruntergeladenen Archivs mit binary.sha256 im Manifest des Netzwerks (und bewahren Sie dieses Archiv oder dessen Prüfsumme als Nachweis dessen auf, was Sie installiert haben).
  • Fragen Sie die Chain, welche Upgrades sie angewendet hat: GET /cosmos/upgrade/v1beta1/applied_plan/<upgrade_name> liefert die Höhe, bei der ein Upgrade angewendet wurde, oder 0, falls es nicht angewendet wurde.
# 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​

Fragt den laufenden Node nach seinem aktuellen Status ab, einschließlich Sync-Status, aktueller Blockhöhe und Konsens-Informationen.

qorechaind status
FlagTypBeschreibung
--nodestringRPC-Endpunkt (Standard: tcp://localhost:26657)

Liefert JSON mit den Abschnitten node_info, sync_info und validator_info.


client configuration​

Es gibt keinen Unterbefehl config. Client-Standardwerte (chain-id, keyring-backend, output, node) werden aus <home>/config/client.toml gelesen; bearbeiten Sie diese Datei oder übergeben Sie das Flag bei jedem Befehl (--chain-id, --keyring-backend, --output, --node).


keys​

Verwaltet den lokalen Keyring zum Signieren von Transaktionen.

Einen neuen Schlüssel hinzufügen​

qorechaind keys add <name> [flags]
FlagTypBeschreibung
--keyring-backendstringBackend: os, file, kwallet, pass, test, memory
--key-typestringSchlüsselalgorithmus: secp256k1 (Standard) oder eth_secp256k1
--coin-typeuint32HD-Coin-Type (Standard 118)
--recoverboolSchlüssel aus Mnemonic wiederherstellen
--multisigstringKommagetrennte Liste von Schlüsseln für Multisig
--multisig-thresholduintMinimal erforderliche Anzahl an Signaturen

Alle Schlüssel auflisten​

qorechaind keys list --keyring-backend <backend>

Schlüsseldetails anzeigen​

qorechaind keys show <name> [flags]
FlagTypBeschreibung
--bechstringAusgabeformat: acc, val, cons
--addressboolNur die Adresse anzeigen
--pubkeyboolNur den öffentlichen Schlüssel anzeigen

Einen Schlüssel löschen​

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

Einen Schlüssel exportieren (Armor-verschlüsselt)​

qorechaind keys export <name>

Einen Schlüssel importieren​

qorechaind keys import <name> <keyfile>

genesis​

Verwaltet die Genesis-Datei.

Ein Genesis-Konto hinzufügen​

qorechaind genesis add-genesis-account <address> <coins> [flags]
FlagTypBeschreibung
--vesting-amountstringVesting-Betrag
--vesting-start-timeintVesting-Startzeitpunkt (Unix-Zeitstempel)
--vesting-end-timeintVesting-Endzeitpunkt (Unix-Zeitstempel)

Eine Genesis-Transaktion erstellen​

qorechaind genesis gentx <key-name> <stake-amount> [flags]
FlagTypBeschreibung
--chain-idstringChain-Kennung
--monikerstringValidator-Moniker
--commission-ratestringAnfängliche Kommissionsrate
--commission-max-ratestringMaximale Kommissionsrate

Genesis-Transaktionen sammeln​

qorechaind genesis collect-gentxs

Weitere genesis-Unterbefehle: bulk-add-genesis-account und migrate.

Die Genesis-Datei validieren​

qorechaind genesis validate

Consensus Engine​

Diese Unterbefehle interagieren mit der QoreChain-Consensus-Engine-Schicht.

Validator-Schlüssel anzeigen​

qorechaind comet show-validator

Gibt den öffentlichen Konsensschlüssel im JSON-Format aus. Wird zur Überprüfung der Validator-Identität verwendet.

Node-ID anzeigen​

qorechaind comet show-node-id

Gibt den P2P-Node-Identifikator (hex-kodiert) aus. Wird für die Konfiguration persistenter Peers verwendet.


export​

Exportiert den aktuellen Chain-Zustand als JSON-Genesis-Datei. Nützlich für Chain-Upgrades oder Snapshots.

qorechaind export [flags]
FlagTypBeschreibung
--for-zero-heightboolExport für einen Neustart bei Höhe 0 vorbereiten
--heightintZustand bei einer bestimmten Blockhöhe exportieren
--homestringNode-Home-Verzeichnis
--output-documentstringDen Export in diese Datei statt nach STDOUT schreiben
--modules-to-exportstringsKommagetrennte Liste der zu exportierenden Module (Standard: alle)
--jail-allowed-addrsstringsOperator-Adressen gejailter Validatoren, die aus dem Jail entlassen werden sollen

rollback​

Setzt den Chain-Zustand um einen Block zurück. Nützlich zur Wiederherstellung nach einem Konsensfehler.

qorechaind rollback [flags]
FlagTypBeschreibung
--hardboolEntfernt zusätzlich den letzten Block aus dem Block-Store
--homestringNode-Home-Verzeichnis

Dieser Befehl setzt sowohl den Anwendungszustand als auch den Konsenszustand zurück. Mit Vorsicht verwenden, da dies nicht rückgängig gemacht werden kann.