Sari la conținutul principal

Rularea unui nod

Acest ghid acoperă rularea unei implementări QoreChain doar-nod — un nod complet sau RPC care sincronizează lanțul și expune endpoint-uri pentru integrare, fără atribuții de validator. Se adresează exchange-urilor (CEX), backend-urilor de portofel, indexatorilor și integratorilor care au nevoie de acces fiabil de citire/scriere la rețea, dar nu semnează blocuri.

notă

Pentru producția de blocuri, staking, slashing și clasificarea pool-urilor, consultați Rularea unui Validator. O implementare doar-nod nu deține niciodată o cheie de consens de validator și nu apare niciodată în setul activ.

avertisment

Binarele, genesis-ul și instantaneele (snapshots) sunt publicate la download.qore.host cu sume de control SHA-256. Verificați întotdeauna sumele de control înainte de a instala sau extrage, și verificați depozitele doar în raport cu propriul nod sincronizat.

Sursa de adevăr: manifestul live

Binarul curent, genesis-ul, peers, seeds și un punct de încredere pentru state-sync sunt publicate ca manifest JSON, actualizat live — nu codificați rigid o versiune de binar, o sumă de control sau un nume de fișier de instantaneu în scripturile de instalare, deoarece devin învechite imediat ce apare o versiune nouă:

  • Mainnet: https://download.qore.host/mainnet/latest.json
  • Testnet: https://download.qore.host/testnet/latest.json

Câmpurile manifestului includ binary (url + sha256), genesis (url + sha256 + sizeBytes), peers, seeds, p2pPort, stateSync (un punct de încredere actualizat orar) și minCompatible. Pașii de instalare și conectare de mai jos preiau acest manifest și folosesc valorile lui curente.

Folosiți versiunea indicată de manifest: v3.2.7 pe mainnet, v3.2.8 pe testnet

Un nod care se sincronizează de la genesis sau reface starea dintr-un instantaneu trece prin mai multe upgrade-uri de guvernanță (consultați Upgrade-uri mai jos), așa că instalați întotdeauna binarul indicat de manifest: acesta conține toate handler-ele de upgrade. Pe mainnet, minCompatible și version din manifest sunt ambele 3.2.7 (aplicată la înălțimea 4.164.600 pe 12 noiembrie 2026, propunerea de guvernanță 16), deci un nod care se alătură acum are nevoie de v3.2.7: un binar mai vechi se oprește la o înălțime de upgrade pe care nu o cunoaște. Versiunea este pachetul qorechaind-v3.2.7-b3-linux-amd64.tar.gz (99.472.930 de octeți, SHA-256 d4b2f166a75900d2354759b067b3e21c6fbd96003ac056163791cf4b7fb242b5, citit din manifest pe 12 noiembrie 2026; manifestul live este sursa de adevăr). Manifestul recomandă ca nodurile noi să se alăture prin state sync. Conține qorechaind și lib/ cu libqorepqc.so, libqoresvm.so și libwasmvm.x86_64.so. Un nod rămas pe v3.2.6 s-a oprit la înălțimea 4.164.600 cu UPGRADE "v3.2.7" NEEDED: instalați pachetul și reporniți, iar starea sa este păstrată. Niciun alt upgrade de mainnet nu este programat (current_plan este null, verificat la 12 noiembrie 2026); când manifestul indică o versiune mai nouă, aceea este binarul de instalat. Pe testnet, minCompatible și version din manifest sunt ambele 3.2.8 (v3.2.5 a fost aplicată la înălțimea 8.890.800 pe 26 octombrie 2026, v3.2.6 la înălțimea 8.970.638 pe 27 octombrie, v3.2.7 la înălțimea 9.594.600 pe 6 noiembrie și v3.2.8 la înălțimea 9.929.500 pe 12 noiembrie), deci un nod care se alătură testnet-ului are nevoie de binarul v3.2.8: luați numele pachetului, dimensiunea și SHA-256 din manifestul live al testnet-ului, care este sursa de adevăr (pe 7 noiembrie 2026, pe v3.2.7, acesta indica qorechaind-v3.2.7-b3-linux-amd64.tar.gz, 99.472.930 de octeți, SHA-256 d4b2f166a75900d2354759b067b3e21c6fbd96003ac056163791cf4b7fb242b5). Un nod de testnet rămas pe v3.2.7 se oprește la înălțimea 9.929.500 cu UPGRADE "v3.2.8" NEEDED: înlocuiți qorechaind și copiați întregul folder lib/ din pachet, apoi porniți-l din nou; starea sa este păstrată și nu are nevoie de resincronizare. Mainnet-ul rămâne pe v3.2.7, cu o versiune în urma testnet-ului; nu a aplicat v3.2.8, deci nimic din notele v3.2.8 nu se schimbă pentru nodurile de mainnet. Nu rulați un binar de testnet împotriva mainnet-ului sau invers: fiecare director conține propria versiune (consultați Upgrade-uri). Manifestul este promovat deliberat (mai întâi pe testnet, apoi pe mainnet după o perioadă de rodaj), așa că verificați câmpul său "version" în raport cu minCompatible înainte de a avea încredere în binary.url.

Un binar compilat din sursa publică (build-ul comunitar) refuză să pornească pe oricare dintre rețelele publice (v3.2.3 și mai nou): nu poate verifica semnăturile post-cuantice și nu poate reda fidel blocurile rețelelor. Folosiți doar arhiva de release.

Două setări contează începând cu v3.2.1: mențineți ceasul sistemului sincronizat prin NTP (nodul se oprește dacă ceasul său are o abatere de mai mult de 60 de secunde) și setați evm-chain-id în app.toml (consultați Limitele nodului).


Nod vs Validator​

AspectDoar-nod (acest ghid)Validator
Cheie de consensNiciunaCheie de consens ed25519 (trebuie securizată)
Producție de blocuriNuDa — propune și semnează blocuri
Staking / slashingNu se aplicăAuto-delegare, risc de slashing
Scop principalServește RPC/REST/gRPC/EVM (și SVM doar-citire) pentru integrăriSecurizează rețeaua (se aplică recompense de staking)
Expunere publicăEndpoint-urile RPC/EVM sunt de obicei expuseValidatorul este ascuns în spatele nodurilor sentry

Rețele țintă​

RețeaChain IDChain ID EVMNote
Mainnetqorechain-vladi9801 (hex 0x2649)Principală — live din 7 iun 2026; versiunea de nod v3.2.7 (din 12 nov 2026)
Testnetqorechain-diana9800Testați integrările aici mai întâi; versiunea de nod v3.2.8 (din 12 nov 2026)

Înlocuiți --chain-id-ul corespunzător pentru rețeaua țintă pe parcursul acestui ghid. Exemplele folosesc implicit mainnet.


ProfilCPURAMDisc (NVMe SSD)Rețea
Nod RPC cu pruning4 nuclee16 GB500 GB+100 Mbps+
Nod complet/arhivă8 nuclee32 GB2 TB+ (crește în timp)1 Gbps
Integrare de exchange8 nuclee32 GB2 TB+ cu marjă suplimentară1 Gbps

Un SSD NVMe este puternic recomandat: starea lanțului și magaziile EVM/SVM sunt intensive din punct de vedere I/O. Cifrele de disc de mai sus sunt generoase. Măsurat pe mainnet (27 octombrie 2026): un validator care s-a alăturat prin state sync cu pruning = "custom" (keep-recent 100000) și indexer = "null" ocupă aproximativ 10 GB după două luni, iar un nod cu pruning implicit, care rulează de la genesis, ocupă aproximativ 100 până la 130 GB după patru luni. Dimensionarea validatorilor se găsește în Rularea unui validator: hardware. Nodurile de arhivă (fără pruning, indexare completă a tranzacțiilor) cresc continuu; alocați spațiu pe disc cu marjă și monitorizare.


Implementare (Deployment)​

Docker Compose​

O implementare doar-nod cu Docker Compose. Nu există o imagine qorechaind publicată public de descărcat (nu este publicat nimic sub organizația Docker Hub a proiectului). Dockerfile-ul din repository-ul public construiește binarul community (fără bibliotecă post-cuantică, keepers de tip stub): este potrivit pentru dezvoltare locală, dar nu poate urmări mainnet-ul sau testnet-ul, iar începând cu v3.2.3 refuză să pornească pe ele. Pentru un nod de rețea, construiți-vă propria imagine din arhiva de release indicată în latest.json, etichetați-o cu versiunea de release (v3.2.6 atât pe mainnet, cât și pe testnet, la momentul redactării), apoi montați un volum persistent pentru datele lanțului:

# Fetch and verify the release archive (see "Joining the Network" below for the manifest steps)
curl -s https://download.qore.host/mainnet/latest.json -o latest.json
curl -fsSL "$(jq -r .binary.url latest.json)" -o qore.tgz
echo "$(jq -r .binary.sha256 latest.json) qore.tgz" | sha256sum -c -
mkdir release && tar xzf qore.tgz -C release

cat > release/Dockerfile <<'EOF'
FROM debian:bookworm-slim
RUN apt-get update && apt-get install -y ca-certificates curl jq && rm -rf /var/lib/apt/lists/*
COPY qorechaind /usr/local/bin/qorechaind
COPY lib/ /opt/qorechain/lib/
ENV LD_LIBRARY_PATH=/opt/qorechain/lib
ENTRYPOINT ["qorechaind"]
EOF
docker build -t qorechain-node:v3.2.7 release/

Arhiva conține qorechaind și un director lib/ cu bibliotecile sale partajate (libqorepqc.so, libqoresvm.so, libwasmvm.x86_64.so și, începând cu v3.2.8, libwasmvmqore_v1.x86_64.so). Copiați întregul director lib/, nu fișiere individuale; imaginea de mai sus este doar linux/amd64, ca și arhiva de release.

# docker-compose.yml
services:
qorechain-node:
image: qorechain-node:v3.2.7
container_name: qorechain-node
restart: unless-stopped
command: ["start", "--home", "/root/.qorechaind"]
volumes:
- qorechain-data:/root/.qorechaind
ports:
- "26657:26657" # RPC
- "26656:26656" # P2P
- "1317:1317" # REST
- "9090:9090" # gRPC
- "8545:8545" # EVM JSON-RPC
- "8546:8546" # EVM WebSocket
- "8899:8899" # SVM RPC (read-only: SVM transactions are disabled)
- "26660:26660" # Prometheus

volumes:
qorechain-data:

Inițializați directorul de date o singură dată (de exemplu docker compose run --rm qorechain-node init my-node --chain-id qorechain-vladi --home /root/.qorechaind; genesis-ul și configurarea peer-ilor sunt acoperite mai jos), apoi porniți:

docker compose up -d
docker compose logs -f qorechain-node

systemd​

Pentru o instalare pe metal fizic (bare-metal), rulați qorechaind sub systemd:

# /etc/systemd/system/qorechaind.service
[Unit]
Description=QoreChain node
After=network-online.target
Wants=network-online.target

[Service]
User=qorechain
ExecStart=/usr/local/bin/qorechaind start --home /var/lib/qorechaind
Restart=on-failure
RestartSec=5
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now qorechaind
sudo journalctl -u qorechaind -f

Alăturarea la rețea​

1. Inițializare​

qorechaind init my-node --chain-id qorechain-vladi

2. Preluați manifestul​

curl -s https://download.qore.host/mainnet/latest.json -o latest.json
# testnet: https://download.qore.host/testnet/latest.json

Folosiți acest fișier ca sursă pentru valorile de binar, genesis și peer din pașii de mai jos — verificați jq -r .minCompatible latest.json și rulați cel puțin acea versiune (cea recomandată este jq -r .version latest.json).

3. Descărcați și verificați genesis-ul​

GENESIS_URL=$(jq -r .genesis.url latest.json)
GENESIS_SHA256=$(jq -r .genesis.sha256 latest.json)

curl -fsSL "$GENESIS_URL" -o ~/.qorechaind/config/genesis.json
echo "${GENESIS_SHA256} $HOME/.qorechaind/config/genesis.json" | sha256sum -c -

# Cross-verify against the genesis served live by the chain:
curl -s https://rpc.qore.host/genesis | jq '.result.genesis' > /tmp/genesis-live.json

4. Configurați peers și pragul de taxă​

Citiți peers și seeds curenți din manifest, în loc să codificați rigid ID-uri de noduri și hosturi — acestea se rotesc:

PEERS=$(jq -r '.peers | join(",")' latest.json)
SEEDS=$(jq -r '.seeds | join(",")' latest.json)

Deschideți ~/.qorechaind/config/config.toml și setați persistent_peers (și seeds) la aceste valori:

persistent_peers = "<value of $PEERS>"
seeds = "<value of $SEEDS>"

Apoi setați prețul minim al gazului în ~/.qorechaind/config/app.toml (pragul de taxă al rețelei: 0.1uqor):

minimum-gas-prices = "0.1uqor"

qorechaind init <moniker> --chain-id qorechain-vladi scrie în app.toml și chain id-ul EVM al rețelei (consultați Limitele nodului); verificați-l pe un director home inițializat cu mult timp în urmă.

5. Porniți sincronizarea​

qorechaind start --minimum-gas-prices=0.1uqor

Pornire rapidă (Fast Bootstrap)​

Sincronizarea de la genesis poate dura mult timp. Folosiți state sync ca modalitate implicită de a vă alătura; un instantaneu (snapshot) este doar o variantă de rezervă (instantaneul mainnet este din 21 august 2026, iar testnet-ul nu publică niciunul).

State sync​

State sync preia un instantaneu recent al stării aplicației de la servere RPC de încredere, în loc să redea fiecare bloc. Configurați secțiunea [statesync] din config.toml:

[statesync]
enable = true
rpc_servers = "https://rpc.qore.host:443,https://<a second RPC you run or trust>:26657"
trust_height = <TRUSTED_BLOCK_HEIGHT>
trust_hash = "<TRUSTED_BLOCK_HASH>"
trust_period = "168h0m0s"

Preluați trust_height / trust_hash din câmpul stateSync al manifestului. Este actualizat orar, deci este sursa preferată:

TRUST_HEIGHT=$(jq -r .stateSync.trustHeight latest.json)
TRUST_HASH=$(jq -r .stateSync.trustHash latest.json)
Două servere RPC diferite

State sync verifică prin încrucișare punctul de încredere față de două servere RPC. Câmpul stateSync.rpcServers al manifestului listează https://rpc.qore.host de două ori pe mainnet (și https://rpc-testnet.qore.host de două ori pe testnet): două intrări identice satisfac numărul cerut, dar anulează verificarea încrucișată. Adăugați un al doilea RPC pe care îl rulați sau în care aveți încredere independent și comparați hash-ul de încredere cu o a doua sursă, de exemplu curl -s "https://<second-rpc>/block?height=$TRUST_HEIGHT" | jq -r .result.block_id.hash, care trebuie să fie egal cu $TRUST_HASH.

Ca alternativă/rezervă, puteți deriva singuri o înălțime și un hash de încredere din RPC-ul public:

curl -s https://rpc.qore.host/block | jq -r '.result.block.header.height, .result.block_id.hash'

Restaurare din instantaneu (snapshot)​

Alternativ, descărcați instantaneul publicat al datelor lanțului, verificați-i suma de control și extrageți-l peste directorul dumneavoastră de date. Pe mainnet, obiectul snapshot din manifest oferă URL-ul, height (înălțimea blocului), dimensiunea și SHA-256. URL-ul instantaneului din manifestul de testnet returnează în prezent 404 (nu este publicat niciun instantaneu de testnet), așa că folosiți state sync acolo. Citiți snapshot.height înainte de a-l folosi pe cel de mainnet: este o singură arhivă de aproximativ 27 GB, iar una veche înseamnă o recuperare lungă. Instantaneul de mainnet publicat în prezent este din 21 august 2026 (înălțimea 1.966.629): este anterior înălțimilor upgrade-urilor v3.1.94, v3.2.0, v3.2.2, v3.2.3 și v3.2.4, așa că un nod restaurat din el redă aproximativ două luni de blocuri cu binarul de versiune indicat de manifest. State sync este aproape întotdeauna alegerea mai bună.

SNAP_URL=$(jq -r .snapshot.url latest.json)
SNAP_SHA256=$(jq -r .snapshot.sha256 latest.json)
curl -fsSL "$SNAP_URL" -o snapshot.tar.gz
echo "${SNAP_SHA256} snapshot.tar.gz" | sha256sum -c -

tar xzf snapshot.tar.gz -C ~/.qorechaind/
qorechaind start --minimum-gas-prices=0.1uqor
notă

Câmpurile snapshot.height și snapshot.ts din manifest arată cât de proaspătă este arhiva, iar state sync (mai sus) este de obicei mai rapid decât o descărcare de 27 GB. Verificați întotdeauna suma de control înainte de a extrage și folosiți o versiune de nod care conține toate handler-ele de upgrade (consultați avertismentul de la începutul acestei pagini) când redați starea dintr-un instantaneu.


Upgrade-uri​

Schimbările de consens sosesc ca upgrade-uri de guvernanță coordonate: o propunere adoptată denumește un plan (de exemplu v3.2.3) și o înălțime de bloc. Binarul de release conține handler-ele de upgrade; la înălțimea planului fiecare nod trebuie să ruleze acest binar, iar un nod rămas pe binarul anterior se oprește la acea înălțime (acesta este comportamentul intenționat al modulului de upgrade). Manifestul vă spune de ce tip este o versiune: upgradeType este height pentru un upgrade coordonat (cu upgradeHeight setat) și rolling pentru o versiune locală a nodului, care poate fi înlocuită nod cu nod. Instalați noul binar înainte de înălțime; dacă nodul dumneavoastră s-a oprit primul, înlocuiți binarul și reporniți (consultați nota despre rollback din Depanare).

VersiuneMainnet qorechain-vladiTestnet qorechain-diana
v3.1.94înălțimea 2.122.074neaplicat
v3.2.0înălțimea 2.981.742înălțimea 5.920.000
v3.2.1local nodului, fără înălțimelocal nodului
v3.2.2înălțimea 3.556.788 (16 oct 2026)înălțimea 6.905.034 (2 oct 2026)
v3.2.3înălțimea 3.662.051 (20 oct 2026, propunerea de guvernanță 11)înălțimea 8.003.746 (15 oct 2026)
v3.2.4înălțimea 3.742.566 (23 oct 2026, propunerea de guvernanță 13)înălțimea 8.337.253 (19 oct 2026, propunerea de guvernanță 13)
v3.2.5înălțimea 3.906.833 (29 oct 2026, propunerea de guvernanță 14)înălțimea 8.890.800 (26 oct 2026)
v3.2.6înălțimea 4.020.000 (4 nov 2026, propunerea de guvernanță 15)înălțimea 8.970.638 (27 oct 2026)
v3.2.7înălțimea 4.164.600 (12 nov 2026, propunerea de guvernanță 16)înălțimea 9.594.600 (6 nov 2026, propunerea de guvernanță 33)
v3.2.8neaplicatăînălțimea 9.929.500 (12 nov 2026)

Ce a făcut un operator de nod pentru v3.2.4 (înălțimea mainnet 3.742.566). Propunerea de guvernanță 13 a numit planul v3.2.4 la înălțimea 3.742.566 (aplicat pe 23 octombrie 2026): nodurile au rămas pe v3.2.3 până la acea înălțime, s-au oprit acolo și au repornit pe v3.2.4. Pentru următorul upgrade coordonat pașii sunt aceiași:

  1. Urmăriți manifestul (https://download.qore.host/mainnet/latest.json): până când indică noua versiune nu aveți nimic de instalat, iar un binar din directorul de testnet nu este versiunea de mainnet.
  2. Când manifestul indică versiunea, descărcați arhiva de la binary.url, verificați sha256 (textul propunerii publică și el sha256-ul binarului) și pregătiți-o înainte de acea înălțime. Verificați planul în așteptare cu GET /cosmos/upgrade/v1beta1/current_plan (name și height) și înălțimea curentă cu GET /status pe RPC.
  3. La înălțimea planului, un nod aflat încă pe binarul vechi se oprește (acesta este comportamentul intenționat al modulului de upgrade, nu o defecțiune); un nod care rulează deja noul binar aplică handler-ul de upgrade și continuă. Dacă al dumneavoastră s-a oprit primul, înlocuiți binarul și reporniți. După upgrade, GET /cosmos/upgrade/v1beta1/applied_plan/v3.2.4 returnează înălțimea în loc de 0 (3742566 pe mainnet, 8337253 pe testnet).
  4. Un nod care se alătură acum mainnet-ului instalează versiunea pe care o indică manifestul (v3.2.7 la momentul redactării; verificați version în raport cu minCompatible).

Semnarea tranzacțiilor, adresele, zecimalele, memo-urile și taxele nu sunt schimbate de v3.2.4.

v3.2.5 pe mainnet (înălțimea 3.906.833, 29 octombrie 2026, propunerea de guvernanță 14). Au fost aplicați aceiași pași: manifestul a indicat 3.2.5 atât ca version, cât și ca minCompatible, iar un nod rămas pe v3.2.4 s-a oprit la înălțimea planului cu UPGRADE "v3.2.5" NEEDED. Remedierea este instalarea pachetului v3.2.5 (conține împreună qorechaind și bibliotecile partajate din lib/; păstrați-le una lângă alta) și repornirea; starea nodului este păstrată.

v3.2.6 pe mainnet (înălțimea 4.020.000, 4 noiembrie 2026, propunerea de guvernanță 15). Au fost aplicați aceiași pași: manifestul indică 3.2.6 atât ca version, cât și ca minCompatible, iar un nod rămas pe v3.2.5 se oprește la înălțimea planului cu UPGRADE "v3.2.6" NEEDED; instalați pachetul v3.2.6 și reporniți. Semnarea (sign-bytes v2), adresele, zecimalele, memo-urile și taxele nu sunt schimbate, iar manifestul cere operatorilor să mențină ceasul sincronizat prin NTP. GET /cosmos/upgrade/v1beta1/applied_plan/v3.2.6 returnează {"height":"4020000"} pe mainnet. Niciun alt upgrade de mainnet nu este programat.

v3.2.7 pe mainnet (înălțimea 4.164.600, 12 noiembrie 2026, propunerea de guvernanță 16). Au fost aplicați aceiași pași: manifestul indică 3.2.7 atât ca version, cât și ca minCompatible, iar un nod rămas pe v3.2.6 se oprește la înălțimea planului cu UPGRADE "v3.2.7" NEEDED; instalați pachetul v3.2.7 și reporniți. GET /cosmos/upgrade/v1beta1/applied_plan/v3.2.7 returnează {"height":"4164600"} pe mainnet. Upgrade-ul a activat unsprezece funcționalități de protocol (multisig post-cuantic hibrid, un gaz fix de 2.000 per verificare post-cuantică, evenimentul ferestrei EVM, mesajele de chei de verificare RDK și mai multe corecturi SVM de adrese și cross-VM), 101 în total. Lane-ul SVM, apelul cross-VM și încărcarea și instanțierea CosmWasm rămân oprite pe mainnet.

Citiți înregistrarea live cu GET /cosmos/upgrade/v1beta1/applied_plan/<name> (0 = neaplicat) și orice plan în așteptare cu GET /cosmos/upgrade/v1beta1/current_plan. v3.2.2 a ridicat versiunile dependențelor motorului de consens, Cosmos SDK (v0.53.8) și IBC, iar verificările mai stricte ale tranzacțiilor din SDK fac ca această versiune să înlocuiască binarul anterior la înălțimea de upgrade, nu nod cu nod. Semnarea tranzacțiilor, adresele, zecimalele, memo-urile și taxele nu s-au schimbat în v3.2.2 sau v3.2.3.

State sync și ceasul. State sync își preia punctul de încredere din blocul stateSync al manifestului (trustHeight, trustHash, actualizate orar); serverul RPC pe care îl listează este al proiectului, așa că pentru un nod de producție adăugați servere RPC în care aveți încredere și verificați hash-ul de încredere față de o altă sursă. Mențineți ceasul sincronizat prin NTP: nodul se oprește când are o abatere de mai mult de 60 de secunde față de rețea.


Pruning și indexare​

Ajustați pruning-ul și indexarea tranzacțiilor în funcție de integrarea dumneavoastră. Exchange-urile care au nevoie de istoricul complet al tranzacțiilor ar trebui să ruleze cu pruning minim și cu un indexator de tranzacții activat.

Pruning (app.toml)​

# Keep recent state only — smallest disk footprint
pruning = "default"

# Keep everything — required for archive / full historical queries
# pruning = "nothing"
pruningComportamentCaz de utilizare
defaultPăstrează starea recentă, elimină restulNod RPC, interogări de sold/stare
nothingPăstrează toată starea istoricăNod de arhivă, istoric complet
customValori de reținere/interval definite de operatorRetenție personalizată

Runtime-ul de contracte în v3.2.8​

Un nod pe release-ul v3.2.8 (doar pe testnet până la un upgrade ulterior de mainnet) are nevoie de: întregul director lib/ al pachetului (poartă libwasmvmqore alături de libwasmvm, libqorepqc și libqoresvm); un [wasm] memory_cache_size de cel puțin 256 MiB (o valoare mai mică este ridicată la 256 cu un avertisment, deci planificați memoria); și directorul codului de contract la <home>/wasm (un director de cod existent în altă parte continuă să funcționeze cu un avertisment). Un app.toml nou setează de asemenea simulation_gas_limit = 50000000 și servește namespace-urile JSON-RPC eth,net,web3.

Limitele nodului (app.toml)​

Începând cu versiunea de nod v3.2.1, init scrie o secțiune [qorechain] cu trei limite locale ale nodului. Acestea schimbă doar ce păstrează acest nod în memorie și ce include în blocurile pe care le propune, niciodată ce trebuie să conțină un bloc pentru a fi valid:

[qorechain]
# Maximum number of Cosmos transactions held in the app-side mempool (default 5000).
# When full, a new transaction that pays more per gas evicts the lowest-paying one; otherwise it is refused.
cosmos-mempool-max-txs = 5000

# Time the node may spend selecting transactions for a proposal before it proposes what it has ("0s" disables the budget).
prepare-proposal-budget = "1s"

# Stop after this many candidates in a row that do not fit in the remaining block space (0 disables the cap).
prepare-proposal-max-skips = 64

init scrie de asemenea chain id-ul EVM al rețelei în setarea evm-chain-id din secțiunea [evm] a fișierului app.toml (9801 pentru --chain-id qorechain-vladi, 9800 pentru qorechain-diana). Un nod al cărui app.toml conține o altă valoare pornește totuși, dar înregistrează o eroare la pornire, iar propriul său JSON-RPC (eth_chainId, semnarea față de acel nod) răspunde cu un chain id greșit până când corectați fișierul; consensul nu este afectat. Binarele mai vechi scriau valoarea de testnet (9800) indiferent de --chain-id, așa că un nod de mainnet inițializat cu mult timp în urmă ar trebui să-și verifice această setare. Nu setați QORE_EVM_CHAIN_ID la o valoare diferită de cea a rețelei: un astfel de nod refuză să pornească.

Indexarea tranzacțiilor (config.toml)​

[tx_index]
indexer = "kv"

Setați indexer = "kv" (sau un indexator mai bogat) astfel încât tranzacțiile să poată fi interogate după hash și eveniment — esențial pentru exchange-urile care reconciliază depozite și retrageri. Setați indexer = "null" doar dacă nu aveți nevoie de interogări istorice ale tranzacțiilor.


Expunerea endpoint-urilor pentru integrare​

Activați și legați serverele API de care au nevoie integratorii în app.toml:

[api]
enable = true
address = "tcp://0.0.0.0:1317"

[grpc]
enable = true
address = "0.0.0.0:9090"

[json-rpc]
enable = true
address = "0.0.0.0:8545"
ws-address = "0.0.0.0:8546"
api = "eth,net,web3,txpool"

Limite JSON-RPC în versiunea de nod v3.2.4. Un nod care rulează binarul v3.2.4 (testnet din 19 octombrie 2026; mainnet din 23 octombrie 2026) își limitează propriul server JSON-RPC. Acestea sunt setări locale ale nodului, în secțiunea [json-rpc] din app.toml, și nu afectează consensul: http-body-limit (implicit 262144 de octeți, 256 KiB; un corp de cerere mai mare este refuzat cu HTTP 413 înainte de a fi citit), max-concurrent-requests (implicit 256; cererile peste această limită primesc imediat HTTP 503) și max-open-connections (o valoare lipsă sau zero înseamnă acum 1000, nu nelimitat). În plus, argumentul de filtrare al eth_getLogs și eth_newFilter este refuzat dacă listează mai mult de 4 poziții de topic, mai mult de 1000 de alternative într-o singură poziție sau mai mult de 1000 de adrese. Un integrator care trimite propriului nod cereri foarte mari în lot sau de implementare de contracte ar trebui să verifice că cea mai mare cerere încape în limita corpului și să o mărească dacă este nevoie.

Endpoint-urile publice servesc namespace-urile eth_, net_, web3_ și txpool_ (doar status); un nod inițializat de v3.2.3 sau mai nou folosește implicit eth,net,web3 și lasă txpool deoparte (acesta publică tranzacțiile în așteptare ale nodului), așa că adăugați-l doar dacă aveți nevoie de el. Namespace-ul qor_ nu este servit de nicio versiune lansată a nodului, așa că nu îl adăugați (consultați namespace-ul qor_).

Și listenerul RPC în config.toml:

[rpc]
laddr = "tcp://0.0.0.0:26657"
EndpointPortUtilizare
RPC26657Difuzarea tranzacțiilor, interogarea blocurilor/statusului
REST1317Interogări HTTP ale stării lanțului
gRPC9090Acces programatic de mare debit (high-throughput)
EVM JSON-RPC8545Integrări compatibile Ethereum (chain ID 9801)
EVM WS8546Abonamente la evenimente EVM
SVM RPC8899Citiri compatibile Solana (tranzacțiile SVM sunt dezactivate)
avertisment

Nu expuneți niciodată RPC, EVM JSON-RPC sau gRPC direct pe internetul public fără un reverse proxy, limitare de rată (rate limiting), autentificare și un firewall. Legați (bind) la 0.0.0.0 doar în spatele unui strat de ingress controlat.


Monitorizarea sănătății și sincronizării​

Statusul sincronizării​

curl -s localhost:26657/status | jq '.result.sync_info.catching_up'
  • true — încă se sincronizează.
  • false — complet sincronizat și servește starea curentă.
# Latest height and network
curl -s localhost:26657/status | jq '.result.sync_info.latest_block_height, .result.node_info.network'

Câmpul network ar trebui să raporteze qorechain-vladi (mainnet) sau qorechain-diana (testnet).

Prometheus și Grafana​

Nodul poate expune metrici Prometheus pe portul 26660 (setați prometheus = true în secțiunea [instrumentation] din config.toml):

http://localhost:26660/metrics

Colectați aceste metrici cu orice colector compatibil Prometheus. Dacă rulați stiva de monitorizare din Docker Compose, Grafana este disponibil la http://localhost:3001 — setați-vă propriile credențiale la prima conectare. Urmăriți întârzierea înălțimii blocului, numărul de peers și utilizarea resurselor; alertați atunci când catching_up rămâne true sau numărul de peers scade la zero.

Verificarea endpoint-ului EVM​

curl -s -X POST http://localhost:8545 \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'
# Expect "0x2649" (9801) on mainnet

Bune practici operaționale​

  1. Fixați versiunea de lanț. Rulați versiunea recomandată de manifest (v3.2.7 pe mainnet și v3.2.8 pe testnet, la momentul redactării), urmăriți versiunile oficiale pentru upgrade-uri coordonate și mențineți ceasul sistemului sincronizat prin NTP.

  2. Rulați noduri redundante. Operați cel puțin două noduri în spatele unui load balancer, astfel încât o singură repornire sau resincronizare să nu întrerupă traficul de integrare.

  3. Verificați genesis-ul și instantaneele. Validați întotdeauna suma de control SHA-256 a genesis-ului și orice sumă de control a instantaneelor față de versiunea oficială înainte de pornire.

  4. Protejați endpoint-urile publice. Puneți RPC/EVM/gRPC în spatele unui reverse proxy, cu limitare de rată și firewall. Nu expuneți niciodată RPC de scriere neautentificat pe internet.

  5. Potriviți pruning-ul cu nevoia. Folosiți pruning = "nothing" plus tx_index = "kv" pentru exchange-urile care reconciliază istoricul complet de depozite/retrageri; folosiți default pentru interogări ușoare.

  6. Monitorizați sincronizarea continuu. Alertați la întârzierea înălțimii blocului, zero peers și un nod blocat în catching_up.

O implementare doar-nod nu semnează niciodată. Tranzacțiile pe care integrarea dumneavoastră le difuzează prin ea trebuie să poarte deja semnătura hibridă post-cuantică (iar, pentru lane-ul EVM, expeditorul are nevoie de o cheie înregistrată și de o fereastră de autorizare deschisă); consultați Integrarea cu exchange-uri și Semnarea post-cuantică.

Pentru a observa rețeaua fără a rula un nod complet, consultați documentația Light Node.


Depanare (Troubleshooting)​

Nodul se oprește cu o eroare de ceas​

Începând cu versiunea de nod v3.2.1, motorul de consens se oprește când ceasul sistemului are o abatere de mai mult de 60 de secunde față de rețea. Rulați un client NTP (chrony sau systemd-timesyncd), confirmați că ceasul este sincronizat cu timedatectl status, apoi reporniți nodul.

Un nod oprit înainte de upgrade nu își reia funcționarea după înlocuirea binarului​

Dacă nodul dumneavoastră era deja oprit sau blocat înainte de a-i actualiza binarul, simpla introducere a noului binar și repornirea nu este suficientă — nodul are rezultate ABCI învechite, memorate din rularea veche, și nu va re-executa blocul care a cauzat oprirea. Faceți rollback explicit înainte de a reporni:

qorechaind rollback --home <HOME>
systemctl restart <unit>

Comanda este qorechaind rollback (o subcomandă de nivel superior) — nu există o subcomandă comet rollback și nici un flag --hard pentru ea.

Restaurarea din instantaneu intră în buclă de eșec (crash-loop) din cauza lipsei priv_validator_state.json​

O arhivă/instantaneu publicat(ă) nu include data/priv_validator_state.json, iar nodul refuză să pornească fără el. Dacă lipsește după o restaurare din instantaneu, creați-l — dar doar dacă nu există deja unul. Nu suprascrieți niciodată unul real: pe un validator, acest fișier este garda anti-dublă-semnare, iar suprascrierea lui riscă o dublă semnare.

echo '{"height":"0","round":0,"step":0}' > <HOME>/data/priv_validator_state.json

Pași următori​