Comenzi pentru nod
Referință pentru comenzile qorechaind utilizate pentru inițializarea, configurarea și operarea unui nod QoreChain.
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
| Flag | Tip | Descriere |
|---|---|---|
--chain-id | string | Identificatorul lanțului (transmite-l întotdeauna; dacă lipsește, se creează unul aleatoriu) |
--home | string | Directorul home al nodului (implicit: ~/.qorechaind) |
--overwrite | bool | Suprascrie genesis.json existent |
--recover | bool | Furnizează 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]
| Flag | Tip | Descriere |
|---|---|---|
--home | string | Directorul home al nodului |
--minimum-gas-prices | string | Prețul minim de gas pe care îl acceptă acest nod. Pragul rețelei este 0.1uqor; setează cel puțin această valoare |
--pruning | string | Strategie de curățare: default, nothing, everything, custom (cu --pruning-keep-recent și --pruning-interval) |
--halt-height | uint | Oprește nodul la această înălțime de bloc |
--halt-time | uint | Oprește nodul la această marcă temporală Unix |
--log_level | string | Nivel de detaliere a jurnalelor: info, debug, warn, error |
--trace | bool | Activează 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.sha256din 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, sau0dacă 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
| Flag | Tip | Descriere |
|---|---|---|
--node | string | Endpoint 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]
| Flag | Tip | Descriere |
|---|---|---|
--keyring-backend | string | Backend: os, file, kwallet, pass, test, memory |
--key-type | string | Algoritmul cheii: secp256k1 (implicit) sau eth_secp256k1 |
--coin-type | uint32 | Tipul de monedă HD (implicit 118) |
--recover | bool | Recuperează cheia din mnemonic |
--multisig | string | Listă de chei separate prin virgulă pentru multisig |
--multisig-threshold | uint | Numă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]
| Flag | Tip | Descriere |
|---|---|---|
--bech | string | Format de ieșire: acc, val, cons |
--address | bool | Afișează doar adresa |
--pubkey | bool | Afiș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]
| Flag | Tip | Descriere |
|---|---|---|
--vesting-amount | string | Suma de vesting |
--vesting-start-time | int | Timpul de începere a vesting-ului (marcă temporală Unix) |
--vesting-end-time | int | Timpul de încheiere a vesting-ului (marcă temporală Unix) |
Crearea unei tranzacții genesis
qorechaind genesis gentx <key-name> <stake-amount> [flags]
| Flag | Tip | Descriere |
|---|---|---|
--chain-id | string | Identificatorul lanțului |
--moniker | string | Monikerul validatorului |
--commission-rate | string | Rata de comision inițială |
--commission-max-rate | string | Rata 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]
| Flag | Tip | Descriere |
|---|---|---|
--for-zero-height | bool | Pregătește exportul pentru repornire la înălțimea 0 |
--height | int | Exportă starea la o anumită înălțime de bloc |
--home | string | Directorul home al nodului |
--output-document | string | Scrie exportul în acest fișier în loc de STDOUT |
--modules-to-export | strings | Listă de module de exportat, separate prin virgulă (implicit: toate) |
--jail-allowed-addrs | strings | Adresele 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]
| Flag | Tip | Descriere |
|---|---|---|
--hard | bool | Elimină și ultimul bloc din block store |
--home | string | Directorul 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ă.