Sari la conținutul principal

Comenzi pentru nod

Referință pentru comenzile qorechaind utilizate pentru inițializarea, configurarea și operarea unui nod QoreChain.

notă

QoreChain rulează două rețele: mainnet-ul qorechain-vladi (live din 7 iunie 2026; versiunea nodului v3.2.7, aplicată la înălțimea 4.164.600 pe 12 noiembrie 2026 prin propunerea de guvernanță 16; v3.2.6 a fost aplicată la înălțimea 4.020.000 pe 4 noiembrie 2026; v3.2.5 a fost aplicată la înălțimea 3.906.833 pe 29 octombrie 2026, v3.2.4 la înălțimea 3.742.566 pe 23 octombrie 2026, iar v3.2.3 la înălțimea 3.662.051 pe 20 octombrie 2026) și testnet-ul qorechain-diana (versiunea nodului v3.2.8, aplicată la înălțimea 9.929.500 pe 12 noiembrie 2026, după v3.2.7 la înălțimea 9.594.600 pe 6 noiembrie, v3.2.6 la înălțimea 8.970.638 pe 27 octombrie, v3.2.5 la înălțimea 8.890.800 pe 26 octombrie și v3.2.4 la înălțimea 8.337.253 pe 19 octombrie; mainnet-ul nu a aplicat v3.2.8). Transmite --chain-id corespunzător rețelei la care intenționezi să te alături — exemplele de mai jos vizează testnet-ul; folosește --chain-id qorechain-vladi pentru mainnet. Versiunea curentă pentru fiecare rețea este listată în latest.json de pe download.qore.host.

Comenzile de pe această pagină au fost verificate pe binarul de release v3.2.3. Binarul v3.2.4 adaugă comenzi pe care un binar v3.2.3 nu le are (de exemplu stakingtier); ele rulează pe ambele rețele (testnet din 19 octombrie 2026, mainnet din 23 octombrie 2026), iar unde acest manual menționează una dintre ele, o spune. Binarul v3.2.6 (ambele rețele) adaugă încă două comenzi de interogare, query rlconsensus applied-params și last-action (vezi Comenzi de interogare). Tot restul de pe această pagină se comportă la fel pe ambele versiuni.


init​

Inițializează un nod nou cu monikerul dat.

qorechaind init <moniker> --chain-id qorechain-diana
FlagTipDescriere
--chain-idstringIdentificatorul lanțului (transmite-l întotdeauna; dacă lipsește, se creează unul aleatoriu)
--homestringDirectorul home al nodului (implicit: ~/.qorechaind)
--overwriteboolSuprascrie genesis.json existent
--recoverboolFurnizează o frază seed pentru a recupera o cheie existentă în loc să creezi una nouă

Creează structura de directoare sub --home cu config/, data/ și un genesis.json inițial. Pentru un nod de rețea, înlocuiește acel genesis.json cu fișierul genesis al rețelei înainte de pornire (vezi Conectarea la mainnet).

init scrie, de asemenea, ID-ul de lanț EVM al rețelei (9801 pentru qorechain-vladi, 9800 pentru qorechain-diana) în setarea evm-chain-id din app.toml, așa că transmite --chain-id corect.


start​

Pornește nodul și începe sincronizarea sau producerea de blocuri.

qorechaind start [flags]
FlagTipDescriere
--homestringDirectorul home al nodului
--minimum-gas-pricesstringPrețul minim de gas pe care îl acceptă acest nod. Pragul rețelei este 0.1uqor; setează cel puțin această valoare
--pruningstringStrategie de curățare: default, nothing, everything, custom (cu --pruning-keep-recent și --pruning-interval)
--halt-heightuintOprește nodul la această înălțime de bloc
--halt-timeuintOprește nodul la această marcă temporală Unix
--log_levelstringNivel de detaliere a jurnalelor: info, debug, warn, error
--traceboolActivează urmărirea completă a stivei la erori

Un binar compilat din arborele sursă public (build-ul comunității) refuză să pornească pe qorechain-vladi sau qorechain-diana: nu poate verifica semnături post-cuantice și nu poate reda fidel blocurile rețelelor (versiunea de nod v3.2.3 și ulterioare). Folosește binarul de release de pe download.qore.host; vezi Compilarea din sursă.


version​

qorechaind version nu raportează numărul versiunii pe binarele de release: afișează o linie goală, iar version --long nu adaugă detalii de build. Nu te baza pe el pentru a deosebi versiunile. Pentru a confirma ce rulezi:

  • Compară SHA-256 al arhivei descărcate cu binary.sha256 din manifestul rețelei înainte de a o extrage (și păstrează acea arhivă, sau suma ei de control, ca evidență a ceea ce ai instalat).
  • Întreabă lanțul ce upgrade-uri a aplicat: GET /cosmos/upgrade/v1beta1/applied_plan/<upgrade_name> returnează înălțimea la care a fost aplicat un upgrade, sau 0 dacă nu a fost aplicat.
# 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​

Interoghează nodul în execuție pentru starea sa curentă, inclusiv starea de sincronizare, ultima înălțime de bloc și informațiile de consens.

qorechaind status
FlagTipDescriere
--nodestringEndpoint RPC (implicit: tcp://localhost:26657)

Returnează JSON cu secțiunile node_info, sync_info și validator_info.


client configuration​

Nu există o subcomandă config. Valorile implicite ale clientului (chain-id, keyring-backend, output, node) sunt citite din <home>/config/client.toml; editează acel fișier sau transmite flag-ul la fiecare comandă (--chain-id, --keyring-backend, --output, --node).


keys​

Gestionează keyring-ul local pentru semnarea tranzacțiilor.

Adăugarea unei chei noi​

qorechaind keys add <name> [flags]
FlagTipDescriere
--keyring-backendstringBackend: os, file, kwallet, pass, test, memory
--key-typestringAlgoritmul cheii: secp256k1 (implicit) sau eth_secp256k1
--coin-typeuint32Tipul de monedă HD (implicit 118)
--recoverboolRecuperează cheia din mnemonic
--multisigstringListă de chei separate prin virgulă pentru multisig
--multisig-thresholduintNumărul minim de semnături necesare

Listarea tuturor cheilor​

qorechaind keys list --keyring-backend <backend>

Afișarea detaliilor unei chei​

qorechaind keys show <name> [flags]
FlagTipDescriere
--bechstringFormat de ieșire: acc, val, cons
--addressboolAfișează doar adresa
--pubkeyboolAfișează doar cheia publică

Ștergerea unei chei​

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

Exportarea unei chei (criptată cu armor)​

qorechaind keys export <name>

Importarea unei chei​

qorechaind keys import <name> <keyfile>

genesis​

Gestionează fișierul genesis.

Adăugarea unui cont genesis​

qorechaind genesis add-genesis-account <address> <coins> [flags]
FlagTipDescriere
--vesting-amountstringSuma de vesting
--vesting-start-timeintTimpul de începere a vesting-ului (marcă temporală Unix)
--vesting-end-timeintTimpul de încheiere a vesting-ului (marcă temporală Unix)

Crearea unei tranzacții genesis​

qorechaind genesis gentx <key-name> <stake-amount> [flags]
FlagTipDescriere
--chain-idstringIdentificatorul lanțului
--monikerstringMonikerul validatorului
--commission-ratestringRata de comision inițială
--commission-max-ratestringRata maximă de comision

Colectarea tranzacțiilor genesis​

qorechaind genesis collect-gentxs

Alte subcomenzi genesis: bulk-add-genesis-account și migrate.

Validarea fișierului genesis​

qorechaind genesis validate

Motorul de consens​

Aceste subcomenzi interacționează cu stratul Motorului de consens QoreChain.

Afișarea cheii de validator​

qorechaind comet show-validator

Afișează cheia publică de consens în format JSON. Folosită pentru a verifica identitatea validatorului.

Afișarea ID-ului nodului​

qorechaind comet show-node-id

Afișează identificatorul de nod P2P (codificat hexazecimal). Folosit pentru configurarea peer-ilor persistenți.


export​

Exportă starea curentă a lanțului ca fișier genesis JSON. Util pentru upgrade-uri de lanț sau snapshot-uri.

qorechaind export [flags]
FlagTipDescriere
--for-zero-heightboolPregătește exportul pentru repornire la înălțimea 0
--heightintExportă starea la o anumită înălțime de bloc
--homestringDirectorul home al nodului
--output-documentstringScrie exportul în acest fișier în loc de STDOUT
--modules-to-exportstringsListă de module de exportat, separate prin virgulă (implicit: toate)
--jail-allowed-addrsstringsAdresele operatorilor validatorilor aflați în jail care vor fi scoși din jail

rollback​

Revine starea lanțului cu un bloc. Util pentru recuperarea în urma unui eșec de consens.

qorechaind rollback [flags]
FlagTipDescriere
--hardboolElimină și ultimul bloc din block store
--homestringDirectorul home al nodului

Această comandă revine atât starea aplicației, cât și starea de consens. Folosește cu atenție, deoarece nu poate fi anulată.