Node-Befehle
Referenz für qorechaind-Befehle zum Initialisieren, Konfigurieren und Betreiben eines QoreChain-Node.
QoreChain betreibt zwei Netzwerke: das qorechain-vladi-Mainnet (live seit 7. Juni 2026 auf Chain-Version v3.1.97) und das qorechain-diana-Testnet. Ü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.
init
Initialisiert einen neuen Node mit dem angegebenen Moniker.
qorechaind init <moniker> --chain-id qorechain-diana
| Flag | Typ | Beschreibung |
|---|---|---|
--chain-id | string | Chain-Kennung (erforderlich) |
--home | string | Node-Home-Verzeichnis (Standard: ~/.qorechaind) |
--overwrite | bool | Vorhandene Genesis- und Konfigurationsdateien überschreiben |
Erstellt die Verzeichnisstruktur unter --home mit config/, data/ und einer initialen genesis.json.
start
Startet den Node und beginnt mit der Synchronisierung bzw. der Blockerzeugung.
qorechaind start [flags]
| Flag | Typ | Beschreibung |
|---|---|---|
--home | string | Node-Home-Verzeichnis |
--minimum-gas-prices | string | Minimal akzeptierte Gas-Preise (z. B. 0.001uqor) |
--pruning | string | Pruning-Strategie: default, nothing, everything |
--halt-height | uint | Node bei dieser Blockhöhe anhalten |
--halt-time | uint | Node zu diesem Unix-Zeitstempel anhalten |
--log_level | string | Log-Ausführlichkeit: info, debug, warn, error |
--trace | bool | Vollständigen Stack-Trace bei Fehlern aktivieren |
version
Gibt die Version der qorechaind-Binary sowie Build-Informationen aus.
qorechaind version
Verwenden Sie --long für erweiterte Build-Details einschließlich Go-Version, Commit-Hash und Build-Tags:
qorechaind version --long
status
Fragt den laufenden Node nach seinem aktuellen Status ab, einschließlich Sync-Status, aktueller Blockhöhe und Konsens-Informationen.
qorechaind status
| Flag | Typ | Beschreibung |
|---|---|---|
--node | string | RPC-Endpunkt (Standard: tcp://localhost:26657) |
Liefert JSON mit den Abschnitten node_info, sync_info und validator_info.
config
Liest oder schreibt Werte in der Node-Konfiguration.
Einen Konfigurationswert setzen
qorechaind config set <key> <value>
Einen Konfigurationswert abrufen
qorechaind config get <key>
Gängige Konfigurationsschlüssel sind unter anderem chain-id, keyring-backend, output und node.
keys
Verwaltet den lokalen Keyring zum Signieren von Transaktionen.
Einen neuen Schlüssel hinzufügen
qorechaind keys add <name> [flags]
| Flag | Typ | Beschreibung |
|---|---|---|
--keyring-backend | string | Backend: os, file, test |
--algo | string | Schlüsselalgorithmus: secp256k1 (Standard), ed25519 |
--recover | bool | Schlüssel aus Mnemonic wiederherstellen |
--multisig | string | Kommagetrennte Liste von Schlüsseln für Multisig |
--multisig-threshold | uint | Minimal erforderliche Anzahl an Signaturen |
Alle Schlüssel auflisten
qorechaind keys list --keyring-backend <backend>
Schlüsseldetails anzeigen
qorechaind keys show <name> [flags]
| Flag | Typ | Beschreibung |
|---|---|---|
--bech | string | Ausgabeformat: acc, val, cons |
--address | bool | Nur die Adresse anzeigen |
--pubkey | bool | Nur 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]
| Flag | Typ | Beschreibung |
|---|---|---|
--vesting-amount | string | Vesting-Betrag |
--vesting-end-time | int | Vesting-Endzeitpunkt (Unix-Zeitstempel) |
Eine Genesis-Transaktion erstellen
qorechaind genesis gentx <key-name> <stake-amount> [flags]
| Flag | Typ | Beschreibung |
|---|---|---|
--chain-id | string | Chain-Kennung |
--moniker | string | Validator-Moniker |
--commission-rate | string | Anfängliche Kommissionsrate |
--commission-max-rate | string | Maximale Kommissionsrate |
Genesis-Transaktionen sammeln
qorechaind genesis collect-gentxs
Die Genesis-Datei validieren
qorechaind genesis validate-genesis
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]
| Flag | Typ | Beschreibung |
|---|---|---|
--for-zero-height | bool | Export für einen Neustart bei Höhe 0 vorbereiten |
--height | int | Zustand bei einer bestimmten Blockhöhe exportieren |
--home | string | Node-Home-Verzeichnis |
rollback
Setzt den Chain-Zustand um einen Block zurück. Nützlich zur Wiederherstellung nach einem Konsensfehler.
qorechaind rollback [flags]
| Flag | Typ | Beschreibung |
|---|---|---|
--hard | bool | Entfernt zusätzlich den letzten Block aus dem Block-Store |
--home | string | Node-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.