Passa al contenuto principale

Comandi del nodo

Riferimento per i comandi qorechaind usati per inizializzare, configurare e gestire un nodo QoreChain.

nota

QoreChain gestisce due reti: la mainnet qorechain-vladi (attiva dal 7 giugno 2026; release del nodo v3.2.7, applicata all'altezza 4.164.600 il 12 novembre 2026 dalla proposta di governance 16; la v3.2.6 è stata applicata all'altezza 4.020.000 il 4 novembre 2026; la v3.2.5 è stata applicata all'altezza 3.906.833 il 29 ottobre 2026, la v3.2.4 all'altezza 3.742.566 il 23 ottobre 2026 e la v3.2.3 all'altezza 3.662.051 il 20 ottobre 2026) e la testnet qorechain-diana (release del nodo v3.2.8, applicata all'altezza 9.929.500 il 12 novembre 2026, dopo la v3.2.7 all'altezza 9.594.600 il 6 novembre, la v3.2.6 all'altezza 8.970.638 il 27 ottobre, la v3.2.5 all'altezza 8.890.800 il 26 ottobre e la v3.2.4 all'altezza 8.337.253 il 19 ottobre; la mainnet non ha applicato la v3.2.8). Passa il --chain-id appropriato per la rete a cui vuoi collegarti — gli esempi seguenti fanno riferimento alla testnet; usa --chain-id qorechain-vladi per la mainnet. La release attuale di ciascuna rete è indicata in latest.json su download.qore.host.

I comandi di questa pagina sono stati verificati con il binario della release v3.2.3. Il binario v3.2.4 aggiunge comandi che un binario v3.2.3 non ha (per esempio stakingtier); funzionano su entrambe le reti (testnet dal 19 ottobre 2026, mainnet dal 23 ottobre 2026), e dove questo manuale ne cita uno lo indica. Il binario v3.2.6 (su entrambe le reti) aggiunge altri due comandi di query, query rlconsensus applied-params e last-action (vedi Comandi di query). Tutto il resto di questa pagina si comporta allo stesso modo su entrambe le release.


init​

Inizializza un nuovo nodo con il moniker indicato.

qorechaind init <moniker> --chain-id qorechain-diana
FlagTipoDescrizione
--chain-idstringIdentificatore della chain (indicalo sempre; se omesso ne viene creato uno casuale)
--homestringDirectory home del nodo (predefinita: ~/.qorechaind)
--overwriteboolSovrascrive il genesis.json esistente
--recoverboolFornisce una seed phrase per recuperare una chiave esistente invece di crearne una

Crea la struttura di directory sotto --home con config/, data/ e un genesis.json iniziale. Per un nodo di rete, sostituisci questo genesis.json con il file di genesis della rete prima di avviare il nodo (vedi Connessione alla mainnet).

init scrive inoltre l'ID di chain EVM della rete (9801 per qorechain-vladi, 9800 per qorechain-diana) nell'impostazione evm-chain-id di app.toml, quindi passa il --chain-id corretto.


start​

Avvia il nodo e inizia la sincronizzazione o la produzione dei blocchi.

qorechaind start [flags]
FlagTipoDescrizione
--homestringDirectory home del nodo
--minimum-gas-pricesstringPrezzo minimo del gas accettato da questo nodo. Il minimo della rete è 0.1uqor; imposta almeno questo valore
--pruningstringStrategia di pruning: default, nothing, everything, custom (con --pruning-keep-recent e --pruning-interval)
--halt-heightuintFerma il nodo a questa altezza di blocco
--halt-timeuintFerma il nodo a questo timestamp Unix
--log_levelstringLivello di verbosità dei log: info, debug, warn, error
--traceboolAbilita lo stack trace completo in caso di errori

Un binario compilato dall'albero dei sorgenti pubblico (la build della community) rifiuta di avviarsi su qorechain-vladi o qorechain-diana: non può verificare le firme post-quantistiche e non può rieseguire fedelmente i blocchi delle reti (release del nodo v3.2.3 e successive). Usa il binario di release da download.qore.host; vedi Compilazione dal sorgente.


version​

qorechaind version non riporta il numero di release sui binari di release: stampa una riga vuota, e version --long non aggiunge dettagli di build. Non fare affidamento su di esso per distinguere le release. Per confermare cosa stai eseguendo:

  • Confronta lo SHA-256 dell'archivio scaricato con binary.sha256 nel manifest della rete prima di estrarlo (e conserva quell'archivio, o il suo checksum, come registrazione di ciò che hai installato).
  • Chiedi alla chain quali upgrade ha applicato: GET /cosmos/upgrade/v1beta1/applied_plan/<upgrade_name> restituisce l'altezza a cui un upgrade è stato applicato, oppure 0 se non è stato applicato.
# 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​

Interroga il nodo in esecuzione per conoscerne lo stato attuale, inclusi lo stato di sincronizzazione, l'altezza dell'ultimo blocco e le informazioni sul consenso.

qorechaind status
FlagTipoDescrizione
--nodestringEndpoint RPC (predefinito: tcp://localhost:26657)

Restituisce un JSON con le sezioni node_info, sync_info e validator_info.


client configuration​

Non esiste un sottocomando config. I valori predefiniti del client (chain-id, keyring-backend, output, node) vengono letti da <home>/config/client.toml; modifica quel file oppure passa il flag a ogni comando (--chain-id, --keyring-backend, --output, --node).


keys​

Gestisce il keyring locale per la firma delle transazioni.

Aggiungere una nuova chiave​

qorechaind keys add <name> [flags]
FlagTipoDescrizione
--keyring-backendstringBackend: os, file, kwallet, pass, test, memory
--key-typestringAlgoritmo della chiave: secp256k1 (predefinito) o eth_secp256k1
--coin-typeuint32Coin type HD (predefinito 118)
--recoverboolRecupera la chiave da mnemonic
--multisigstringElenco separato da virgole delle chiavi per il multisig
--multisig-thresholduintNumero minimo di firme richieste

Elencare tutte le chiavi​

qorechaind keys list --keyring-backend <backend>

Mostrare i dettagli di una chiave​

qorechaind keys show <name> [flags]
FlagTipoDescrizione
--bechstringFormato di output: acc, val, cons
--addressboolMostra solo l'indirizzo
--pubkeyboolMostra solo la chiave pubblica

Eliminare una chiave​

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

Esportare una chiave (cifrata con armor)​

qorechaind keys export <name>

Importare una chiave​

qorechaind keys import <name> <keyfile>

genesis​

Gestisce il file di genesis.

Aggiungere un account di genesis​

qorechaind genesis add-genesis-account <address> <coins> [flags]
FlagTipoDescrizione
--vesting-amountstringImporto in vesting
--vesting-start-timeintData di inizio vesting (timestamp Unix)
--vesting-end-timeintData di fine vesting (timestamp Unix)

Creare una transazione di genesis​

qorechaind genesis gentx <key-name> <stake-amount> [flags]
FlagTipoDescrizione
--chain-idstringIdentificatore della chain
--monikerstringMoniker del validatore
--commission-ratestringTasso di commissione iniziale
--commission-max-ratestringTasso di commissione massimo

Raccogliere le transazioni di genesis​

qorechaind genesis collect-gentxs

Altri sottocomandi di genesis: bulk-add-genesis-account e migrate.

Convalidare il file di genesis​

qorechaind genesis validate

Motore di consenso​

Questi sottocomandi interagiscono con il livello del motore di consenso di QoreChain.

Mostrare la chiave del validatore​

qorechaind comet show-validator

Restituisce la chiave pubblica di consenso in formato JSON. Utile per verificare l'identità del validatore.

Mostrare l'ID del nodo​

qorechaind comet show-node-id

Restituisce l'identificatore P2P del nodo (codificato in esadecimale). Utile per la configurazione dei peer persistenti.


export​

Esporta lo stato attuale della chain come file JSON di genesis. Utile per gli upgrade della chain o per gli snapshot.

qorechaind export [flags]
FlagTipoDescrizione
--for-zero-heightboolPrepara l'esportazione per riavviare all'altezza 0
--heightintEsporta lo stato a un'altezza di blocco specifica
--homestringDirectory home del nodo
--output-documentstringScrive l'esportazione in questo file invece che su STDOUT
--modules-to-exportstringsElenco separato da virgole dei moduli da esportare (predefinito: tutti)
--jail-allowed-addrsstringsIndirizzi operatore dei validatori in jail da rimettere in attività

rollback​

Riporta indietro lo stato della chain di un blocco. Utile per il recupero da un errore di consenso.

qorechaind rollback [flags]
FlagTipoDescrizione
--hardboolRimuove anche l'ultimo blocco dal block store
--homestringDirectory home del nodo

Questo comando riporta indietro sia lo stato dell'applicazione sia lo stato del consenso. Usalo con cautela: l'operazione non può essere annullata.