Conectarea la Mainnet
Alătură-te mainnet-ului live QoreChain Vladi configurându-ți nodul cu fișierul genesis oficial, peers și setările de rețea.
Această pagină acoperă mainnet-ul qorechain-vladi (EVM chain ID 9801, hex 0x2649), live din 7 iunie 2026, rulând versiunea v3.2.6 pe Cosmos SDK v0.53 din 4 noiembrie 2026 (aplicată la înălțimea 4.020.000, în jurul orei 14:45 UTC, prin propunerea de guvernanță 15; v3.2.5 fusese aplicată la înălțimea 3,906,833 pe 29 octombrie 2026). Pentru testnet-ul qorechain-diana (EVM chain ID 9800), vezi Conectarea la Testnet și repetă configurarea acolo înainte de a trece live.
Endpoint-uri publice
Dacă ai nevoie doar să interoghezi chain-ul sau să transmiți tranzacții, nu ai nevoie de propriul nod — endpoint-urile publice sunt:
| Serviciu | URL |
|---|---|
| Consensus RPC | https://rpc.qore.host (WebSocket: wss://rpc.qore.host/websocket) |
| Cosmos REST (LCD) | https://api.qore.host |
| EVM JSON-RPC | https://evm.qore.host (chain ID 9801) |
| SVM JSON-RPC (doar citire) | https://svm.qore.host |
| Block explorer | explore.qore.network |
Pentru sarcini grele sau de producție (exchange-uri, indexere), rulează propriul nod conform descrierii de mai jos.
Gazdele publice sunt partajate și au limite (rata cererilor, dimensiuni SVM RPC, filtre EVM); eth_call și estimarea gazului merg prin gazda EVM JSON-RPC. Vezi Limite pe punctele finale publice.
Instalare
Instalează binarul qorechaind fie din pachetul oficial precompilat, fie construindu-l din sursă.
Pachet binar precompilat (linux/amd64)
Sursa canonică de adevăr pentru binarul curent este manifestul de mainnet, un fișier JSON reîmprospătat live la https://download.qore.host/mainnet/latest.json. Acesta conține URL-ul curent al binarului și SHA-256 aferent, URL-ul/SHA-256/dimensiunea genesis-ului curent, listele curente de peers și seeds, portul P2P, un punct de încredere pentru state-sync și versiunea minimă compatibilă de chain. Preia-l și folosește valorile din el în loc să hardcodezi o versiune de binar sau un checksum în scripturile tale de instalare — acestea devin învechite imediat ce apare un release nou:
curl -s https://download.qore.host/mainnet/latest.json -o latest.json
BINARY_URL=$(jq -r .binary.url latest.json)
BINARY_SHA256=$(jq -r .binary.sha256 latest.json)
curl -fsSL "$BINARY_URL" -o qore.tgz
echo "${BINARY_SHA256} qore.tgz" | sha256sum -c -
tar xzf qore.tgz
sudo install -m0755 qorechaind /usr/local/bin/
sudo mkdir -p /opt/qorechain/lib && sudo cp lib/*.so /opt/qorechain/lib/
export LD_LIBRARY_PATH=/opt/qorechain/lib
Pachetul conține qorechaind plus bibliotecile partajate necesare (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.
Nodurile complete trebuie să urmărească versiunea live a rețelei — instalează întotdeauna binarul indicat de manifest, nu fixa unul vechi. Manifestul curent (verificat la 4 noiembrie 2026) este v3.2.6, cu minCompatible 3.2.6 și upgradeHeight 4,020,000: mainnet-ul a aplicat acolo v3.2.6 la 4 noiembrie 2026 prin propunerea de guvernanță 15, iar un nod aflat încă pe o versiune mai veche nu poate urmări chain-ul dincolo de acea înălțime. Pachetul este qorechaind-v3.2.6-b3-linux-amd64.tar.gz (98,878,438 octeți, SHA-256 acd9f95bfd8d6f3c6c5ea306fe9dacb6362336ddaa96c61197599298bb1e2fb2). Manifestul spune că nodurile noi se alătură cu v3.2.6 prin state sync; un nod aflat încă pe v3.2.5 care a ratat upgrade-ul se oprește la înălțimea 4,020,000 cu UPGRADE "v3.2.6" NEEDED, iar remedierea este să instalezi acest pachet și să repornești (starea se păstrează). Upgrade-urile de guvernanță anterioare de pe mainnet au fost v3.1.94 la înălțimea 2,122,074 (plafonul de emisiune), v3.2.0 la înălțimea 2,981,742 (fereastra de autorizare EVM și octeții de semnătură hibridă v2), v3.2.2 la înălțimea 3,556,788 (16 octombrie 2026, propunerea 7), v3.2.3 la înălțimea 3,662,051 (20 octombrie 2026, propunerea 11), v3.2.4 la înălțimea 3,742,566 (23 octombrie 2026, propunerea 13) și v3.2.5 la înălțimea 3,906,833 (29 octombrie 2026, propunerea 14). v3.2.1 a fost o versiune locală nodului, fără înălțime. Semnarea tranzacțiilor rămâne neschimbată în v3.2.6. Un nod care se alătură de la zero are nevoie de binarul v3.2.6 indicat de manifest; preferă state sync (mai jos) în locul replay-ului de la genesis. Snapshot-ul publicat al datelor de chain este anterior tuturor acestor înălțimi de upgrade, așa că un nod restaurat din el trebuie să le reia (replay).
Setează evm-chain-id = 9801 în app.toml (o valoare diferită este înregistrată ca eroare) și menține ceasul sistemului sincronizat prin NTP: un nod se oprește dacă ceasul său este în afara intervalului cu mai mult de 60 de secunde. Verifică întotdeauna câmpurile "version" și "minCompatible" ale manifestului înainte de a avea încredere în binary.url — manifestul este promovat în mod deliberat (mai întâi pe testnet, apoi pe mainnet după o perioadă de rodaj). Formatul de semnare, adresele, zecimalele, memo-urile și taxele nu s-au schimbat în v3.2.3 sau v3.2.4.
Testnet-ul (qorechain-diana) rulează v3.2.8, cu două versiuni înaintea mainnet-ului (a aplicat v3.2.5 pe 26 octombrie 2026, v3.2.6 pe 27 octombrie 2026, v3.2.7 pe 6 noiembrie 2026 și v3.2.8 pe 12 noiembrie 2026; mainnet-ul nu are o dată pentru v3.2.8). Nu copia niciodată un binar de pe o rețea pe cealaltă: urmează întotdeauna manifestul rețelei pe care o rulezi.
Când este programat un upgrade coordonat, textul propunerii numește înălțimea și îți spune să rămâi pe versiunea anterioară până atunci: nodul se oprește la acea înălțime, iar tu îl repornești pe noul binar. Citește status al propunerii (curl -s https://api.qore.host/cosmos/gov/v1/proposals/<id>) și câmpurile version și upgradeHeight din manifestul mainnet înainte de a schimba orice binar și nu instala niciodată un binar de upgrade înainte de înălțimea sa: un nod care îl are mai devreme se oprește și el. Pe 4 noiembrie 2026 nu era setat niciun plan de upgrade (curl -s https://api.qore.host/cosmos/upgrade/v1beta1/current_plan returna "plan": null) și nu era programat niciun alt upgrade de mainnet. Ultimul, propunerea de guvernanță 15, a aplicat v3.2.6 (build 3) la înălțimea 4.020.000 pe 4 noiembrie 2026; manifestul de mai sus este sursa de adevăr pentru ce instalează un nod nou.
Construire din sursă (doar pentru dezvoltare)
git clone https://github.com/qorechain/qorechain-core.git
cd qorechain-core
CGO_ENABLED=1 go build -o qorechaind ./cmd/qorechaind/
Aceasta construiește binarul comunității, cu keeper-e stub și fără semnatar post-cuantic, care nu poate reproduce starea de consens a rețelelor și nici nu poate crea tranzacții semnate hibrid. Pentru a rula un nod pe mainnet, instalează binarul de lansare de mai sus. Vezi Construirea din sursă pentru toate cerințele preliminare (Go 1.26+, CGO, biblioteci native).
Inițializarea nodului
qorechaind init my-node --chain-id qorechain-vladi
Aceasta creează directoarele implicite de configurare și date sub ~/.qorechaind/.
Descărcarea Genesis
Înlocuiește fișierul genesis local cu genesis-ul oficial de mainnet, folosind URL-ul și SHA-256 din manifestul preluat mai sus:
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 -
Același fișier este de asemenea servit live chiar de către chain — poți verifica încrucișat descărcarea față de acesta:
curl -s https://rpc.qore.host/genesis | jq '.result.genesis' > /tmp/genesis-live.json
Acest fișier definește starea inițială a mainnet-ului Vladi, inclusiv setul de validatori genesis, alocările de token-uri (TGE la genesis) și parametrii modulelor.
Configurarea Peers
Editează configurația nodului tău pentru a te conecta la nodurile sentry publice de mainnet. Citește listele curente de peers și seeds din manifest în loc să hardcodezi ID-uri de noduri și host-uri — acestea se rotesc:
PEERS=$(jq -r '.peers | join(",")' latest.json)
SEEDS=$(jq -r '.seeds | join(",")' latest.json)
Deschide ~/.qorechaind/config/config.toml și setează câmpurile persistent_peers (și seeds) la aceste valori:
persistent_peers = "<value of $PEERS>"
seeds = "<value of $SEEDS>"
Setează de asemenea prețul minim al gas-ului în ~/.qorechaind/config/app.toml (pragul de taxă al rețelei este 0.1uqor):
minimum-gas-prices = "0.1uqor"
Setări recomandate
Un nod complet nu alege timpul de bloc — îl aleg validatorii (mainnet-ul produce în prezent un bloc la aproximativ 3,1 secunde). Lasă timeout-urile de consens la valorile implicite, cu excepția cazului în care operezi un validator și ți-au fost date valori de către grupul de validatori. O setare utilă pentru mempool, pentru un nod RPC public, în config.toml:
[mempool]
size = 5000
Bootstrap rapid (Snapshot sau State Sync)
Sincronizarea de la genesis poate dura mult. Câmpul stateSync din manifest conține o pereche înălțime/hash de încredere, reîmprospătată orar — folosește-o pentru a configura state sync în loc să cauți manual o înălțime:
TRUST_HEIGHT=$(jq -r .stateSync.trustHeight latest.json)
TRUST_HASH=$(jq -r .stateSync.trustHash latest.json)
Apoi setează secțiunea [statesync] din config.toml cu aceste valori — vezi Rularea unui nod pentru fluxul complet de lucru, inclusiv un fallback manual bazat pe RPC dacă trebuie să derivezi singur un punct de încredere.
Un snapshot al datelor de chain este listat de asemenea în manifest (snapshot.url, snapshot.sha256, snapshot.height). Citește valorile din manifest în loc să hardcodezi un nume de fișier sau o înălțime, deoarece un snapshot nou îl înlocuiește pe cel vechi. Snapshot-ul este mare (zeci de gigaocteți) și, așa cum a fost publicat în octombrie 2026, a fost luat la înălțimea 1,966,629 (21 august 2026) — înainte de fiecare înălțime de upgrade listată mai sus — deci un nod restaurat din el trebuie să reia acele upgrade-uri; state sync este de obicei mai rapid și evită acest lucru:
SNAPSHOT_URL=$(jq -r .snapshot.url latest.json)
SNAPSHOT_SHA256=$(jq -r .snapshot.sha256 latest.json)
curl -fsSL "$SNAPSHOT_URL" -o snapshot.tar.gz
echo "${SNAPSHOT_SHA256} snapshot.tar.gz" | sha256sum -c -
tar xzf snapshot.tar.gz -C ~/.qorechaind/
Pornirea nodului
Lansează-ți nodul pentru a începe sincronizarea cu rețeaua:
qorechaind start --minimum-gas-prices=0.1uqor
Nodul se conectează la peers și începe descărcarea blocurilor (de la genesis, sau de la înălțimea snapshot-ului dacă ai restaurat unul).
Verificarea stării de sincronizare
Verifică dacă nodul tău ajunge din urmă cel mai recent bloc:
curl localhost:26657/status | jq '.result.sync_info.catching_up'
true— Nodul încă se sincronizează. Așteaptă să ajungă din urmă.false— Nodul este complet sincronizat și procesează blocuri noi.
Poți verifica de asemenea cea mai recentă înălțime de bloc:
curl localhost:26657/status | jq '.result.sync_info.latest_block_height'
Confirmă că te afli pe rețeaua corectă — câmpul network ar trebui să raporteze qorechain-vladi:
curl localhost:26657/status | jq '.result.node_info.network'
Monitorizare
QoreChain expune mai multe endpoint-uri pentru monitorizarea sănătății și performanței nodului.
Metrici Prometheus
Metricile brute sunt disponibile la:
http://localhost:26660/metrics
Aceste metrici pot fi colectate (scraped) de orice colector compatibil cu Prometheus.
Dashboard-uri Grafana
Dacă rulezi prin Docker Compose, Grafana este disponibil la:
http://localhost:3001
La prima autentificare, setează-ți propriile credențiale când ți se cere — nu lăsa valorile implicite. Dashboard-urile preconfigurate afișează producția de blocuri, throughput-ul tranzacțiilor, conexiunile la peers și utilizarea resurselor.
Verificare de sănătate REST
API-ul REST oferă un endpoint rapid de status:
http://localhost:1317
Referință porturi
| Port | Protocol | Descriere |
|---|---|---|
26657 | TCP | RPC — interoghează și transmite tranzacții |
26656 | TCP | P2P — comunicare de rețea peer-to-peer |
1317 | HTTP | REST API — interoghează starea chain-ului prin HTTP |
9090 | gRPC | gRPC API — acces programatic la chain |
8545 | HTTP | EVM JSON-RPC — RPC compatibil Ethereum (chain ID 9801) |
8546 | WebSocket | EVM WebSocket — abonări la evenimente EVM în timp real |
8899 | HTTP | SVM RPC — RPC compatibil Solana (doar citire; lane-ul de tranzacții SVM este dezactivat) |
26660 | HTTP | Endpoint de metrici Prometheus |
Date despre rețea
| Câmp | Valoare |
|---|---|
| Chain ID | qorechain-vladi |
| EVM chain ID | 9801 (hex 0x2649) |
| Versiune de chain | v3.2.6 (aplicată la înălțimea 4,020,000, pe 4 noiembrie 2026) |
| Live din | 7 iunie 2026 |
| Timp de bloc | aproximativ 3,1 secunde (medie măsurată) |
| Token | QOR (uqor, 10^6 micro-unități = 1 QOR) |
| Preț minim gas | 0.1uqor |
| Prefix cont | qor |
| Prefix validator | qorvaloper |
| SDK | Cosmos SDK v0.53 |
Pașii următori
- Rularea unui nod — Operează un nod complet/RPC pentru exchange-uri și integratori
- Ghid pentru exchange-uri și integratori — Depuneri, retrageri și monitorizare
- Rularea unui validator — Creează și operează un validator
- Configurarea unui wallet — Configurează un wallet pentru mainnet
- Prima ta tranzacție — Trimite primul tău transfer de QOR
- Conectarea la Testnet — Alătură-te testnet-ului Diana pentru testare gratuită
- Rețele — Chain ID-uri, porturi și referința completă a rețelelor