Passa al contenuto principale

Connessione alla mainnet

Unisciti alla mainnet QoreChain Vladi attiva configurando il tuo nodo con il file genesis ufficiale, i peer e le impostazioni di rete.

nota

Questa pagina riguarda la mainnet qorechain-vladi (EVM chain ID 9801, esadecimale 0x2649), attiva dal 7 giugno 2026 ed eseguita con la release v3.2.7 su Cosmos SDK v0.53 dal 12 novembre 2026 (applicata all'altezza 4.164.600, con i blocchi ripresi intorno alle 15:01 UTC, dalla proposta di governance 16; la v3.2.6 era stata applicata all'altezza 4.020.000 il 4 novembre 2026). Per la testnet qorechain-diana (EVM chain ID 9800), consulta Connessione alla testnet e prova lì la tua configurazione prima di andare in produzione.

Endpoint pubblici​

Se hai solo bisogno di interrogare la chain o trasmettere transazioni, non è necessario un nodo proprio — gli endpoint pubblici sono:

ServizioURL
RPC di consensohttps://rpc.qore.host (WebSocket: wss://rpc.qore.host/websocket)
Cosmos REST (LCD)https://api.qore.host
EVM JSON-RPChttps://evm.qore.host (chain ID 9801)
SVM JSON-RPC (sola lettura)https://svm.qore.host
Esploratore di blocchiexplore.qore.network

Per carichi di lavoro intensi o di produzione (exchange, indexer), esegui un nodo tuo come descritto di seguito.

Gli host pubblici sono condivisi e hanno dei limiti (frequenza delle richieste, dimensioni delle RPC SVM, filtri EVM); eth_call e la stima del gas passano dall'host EVM JSON-RPC. Vedi Limiti sugli endpoint pubblici.


Installazione​

Installa il binario qorechaind dal bundle precompilato ufficiale oppure compilandolo dal codice sorgente.

Bundle binario precompilato (linux/amd64)​

La fonte canonica di verità per il binario attuale è il manifest della mainnet, un file JSON aggiornato in tempo reale su https://download.qore.host/mainnet/latest.json. Contiene l'URL e lo SHA-256 del binario corrente, l'URL/SHA-256/dimensione del genesis corrente, i peer e i seed attuali, la porta P2P, un punto di fiducia per lo state sync e la versione minima compatibile della chain. Recuperalo e usa i suoi valori invece di scrivere in modo fisso una versione del binario o un checksum nei tuoi script di installazione — diventerebbero obsoleti non appena viene rilasciata una nuova release:

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

Il bundle contiene qorechaind più le librerie condivise richieste (libqorepqc.so, libqoresvm.so, libwasmvm.x86_64.so e, dalla v3.2.8, libwasmvmqore_v1.x86_64.so). Copia l'intera directory lib/, non i singoli file.

Mantieni il nodo aggiornato

I full node devono seguire la release attualmente in esecuzione sulla rete, quindi installa sempre il binario indicato dal manifest e non fissarne uno vecchio. Il manifest corrente (verificato il 12 novembre 2026) è v3.2.7 con minCompatible 3.2.7 e upgradeHeight 4.164.600: la mainnet ha applicato la v3.2.7 a quell'altezza il 12 novembre 2026 tramite la proposta di governance 16 (i blocchi sono ripresi intorno alle 15:01 UTC), e un nodo ancora su una release precedente non può seguire la chain oltre quell'altezza. Il bundle è qorechaind-v3.2.7-b3-linux-amd64.tar.gz (99.472.930 byte, SHA-256 d4b2f166a75900d2354759b067b3e21c6fbd96003ac056163791cf4b7fb242b5). Il manifest indica di copiare l'intera cartella lib/ del bundle; per la v3.2.7 contiene libqorepqc.so, libqoresvm.so e libwasmvm.x86_64.so. Un nodo ancora sulla v3.2.6 che ha perso l'upgrade si ferma all'altezza 4.164.600 con UPGRADE "v3.2.7" NEEDED, e la soluzione è installare questo bundle (con la sua cartella lib/) e riavviare (lo stato viene mantenuto). Gli upgrade di governance precedenti sulla mainnet sono stati la v3.1.94 all'altezza 2.122.074 (il tetto massimo all'emissione), la v3.2.0 all'altezza 2.981.742 (la finestra di autorizzazione EVM e i byte di firma ibrida v2), la v3.2.2 all'altezza 3.556.788 (16 ottobre 2026, proposta 7), la v3.2.3 all'altezza 3.662.051 (20 ottobre 2026, proposta 11), la v3.2.4 all'altezza 3.742.566 (23 ottobre 2026, proposta 13), la v3.2.5 all'altezza 3.906.833 (29 ottobre 2026, proposta 14) e la v3.2.6 all'altezza 4.020.000 (4 novembre 2026, proposta 15). La v3.2.1 è stata una release locale al nodo, senza altezza. La firma delle transazioni non è cambiata nella v3.2.6; la v3.2.7 aggiunge la modalità di firma textual come opzione aggiuntiva. Un nodo che si unisce ora ha bisogno del binario v3.2.7 indicato dal manifest; preferisci lo state sync (sotto) al replay dal genesis. Lo snapshot dei dati della chain pubblicato è antecedente a tutte queste altezze di upgrade, quindi un nodo ripristinato da esso deve rieseguirle.

Imposta evm-chain-id = 9801 in app.toml (un valore diverso viene registrato nei log come errore) e mantieni l'orologio di sistema sincronizzato via NTP: un nodo si arresta quando il suo orologio si discosta di oltre 60 secondi. Controlla sempre i campi "version" e "minCompatible" del manifest prima di fidarti di binary.url — il manifest viene promosso in modo deliberato (prima sulla testnet, poi sulla mainnet dopo un periodo di rodaggio). Formato di firma, indirizzi, decimali, memo e commissioni non sono cambiati nella v3.2.3 né nella v3.2.4.

La testnet (qorechain-diana) esegue la v3.2.8, una release avanti rispetto alla mainnet (ha applicato la v3.2.5 il 26 ottobre 2026, la v3.2.6 il 27 ottobre 2026, la v3.2.7 il 6 novembre 2026 e la v3.2.8 il 12 novembre 2026; la mainnet non ha applicato la v3.2.8). Non copiare mai un binario da una rete all'altra: segui sempre il manifest della rete che esegui.

Quando è programmato un upgrade coordinato, il testo della proposta indica l'altezza e ti dice di restare sulla release precedente fino ad allora: il nodo si ferma a quell'altezza e lo riavvii sul nuovo binario. Leggi lo status della proposta (curl -s https://api.qore.host/cosmos/gov/v1/proposals/<id>) e i campi version e upgradeHeight del manifest della mainnet prima di sostituire qualsiasi binario, e non installare mai un binario di upgrade prima della sua altezza: anche un nodo che lo monta in anticipo si ferma. Il 12 novembre 2026 non era impostato alcun piano di upgrade (curl -s https://api.qore.host/cosmos/upgrade/v1beta1/current_plan restituiva "plan": null). L'ultimo, la proposta di governance 16, ha applicato la v3.2.7 (build 3) all'altezza 4.164.600 il 12 novembre 2026 (il precedente, la proposta 15, ha applicato la v3.2.6 all'altezza 4.020.000 il 4 novembre 2026); il manifest qui sopra è la fonte di verità per ciò che installa un nodo nuovo.

Compilazione dal codice sorgente (solo per sviluppo)​

git clone https://github.com/qorechain/qorechain-core.git
cd qorechain-core
CGO_ENABLED=1 go build -o qorechaind ./cmd/qorechaind/

Questo compila il binario della community con keeper stub e senza firmatario post-quantistico, che non può riprodurre lo stato di consenso delle reti né creare transazioni con firma ibrida. Per eseguire un nodo sulla mainnet, installa il binario di release indicato sopra. Consulta Compilazione dal codice sorgente per i prerequisiti completi (Go 1.26+, CGO, librerie native).

Inizializzazione del nodo​

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

Questo comando crea le directory predefinite di configurazione e dei dati in ~/.qorechaind/.


Download del genesis​

Sostituisci il tuo file genesis locale con il genesis ufficiale della mainnet, usando l'URL e lo SHA-256 ottenuti dal manifest recuperato in precedenza:

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 -

Lo stesso file è servito in tempo reale anche dalla chain stessa — puoi verificare in modo incrociato il download confrontandolo con esso:

curl -s https://rpc.qore.host/genesis | jq '.result.genesis' > /tmp/genesis-live.json

Questo file definisce lo stato iniziale della mainnet Vladi, incluso il set di validatori del genesis, le allocazioni dei token (TGE al genesis) e i parametri dei moduli.


Configurazione dei peer​

Modifica la configurazione del tuo nodo per connetterti ai sentry node pubblici della mainnet. Leggi gli elenchi attuali di peer e seed dal manifest invece di scrivere in modo fisso ID nodo e host — questi ruotano nel tempo:

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

Apri ~/.qorechaind/config/config.toml e imposta i campi persistent_peers (e seeds) su questi valori:

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

Imposta anche il prezzo minimo del gas in ~/.qorechaind/config/app.toml (la soglia minima delle commissioni di rete è 0.1uqor):

minimum-gas-prices = "0.1uqor"

Impostazioni consigliate​

Un full node non sceglie il tempo di blocco — lo scelgono i validatori (la mainnet produce attualmente un blocco circa ogni 3,1 secondi). Lascia i timeout di consenso ai valori predefiniti, a meno che tu non gestisca un validatore e il gruppo dei validatori ti abbia fornito dei valori. Un'impostazione utile del mempool per un nodo RPC pubblico, in config.toml:

[mempool]
size = 5000

Bootstrap rapido (snapshot o state sync)​

La sincronizzazione dal genesis può richiedere molto tempo. Il campo stateSync del manifest contiene una coppia altezza/hash di fiducia aggiornata ogni ora — usala per configurare lo state sync invece di individuare manualmente un'altezza:

TRUST_HEIGHT=$(jq -r .stateSync.trustHeight latest.json)
TRUST_HASH=$(jq -r .stateSync.trustHash latest.json)

Imposta poi la sezione [statesync] di config.toml con questi valori — consulta Eseguire un nodo per la procedura completa, incluso un metodo alternativo manuale basato su RPC nel caso tu debba ricavare da solo un punto di fiducia.

Nel manifest è elencato anche uno snapshot dei dati della chain (snapshot.url, snapshot.sha256, snapshot.height). Leggi i valori dal manifest invece di scrivere in modo fisso un nome file o un'altezza, poiché un nuovo snapshot sostituisce quello precedente. Lo snapshot è grande (decine di gigabyte) e, come pubblicato a ottobre 2026, è stato acquisito all'altezza 1.966.629 (21 agosto 2026) — prima di ogni altezza di upgrade elencata sopra — quindi un nodo ripristinato da esso deve rieseguire quegli upgrade; lo state sync è di solito più veloce ed evita questo:

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/

Avvio del nodo​

Avvia il tuo nodo per iniziare la sincronizzazione con la rete:

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

Il nodo si connette ai peer e inizia a scaricare i blocchi (dal genesis, oppure dall'altezza dello snapshot se ne hai ripristinato uno).


Verifica dello stato di sincronizzazione​

Verifica che il tuo nodo si stia allineando all'ultimo blocco:

curl localhost:26657/status | jq '.result.sync_info.catching_up'
  • true — Il nodo è ancora in fase di sincronizzazione. Attendi che si allinei.
  • false — Il nodo è completamente sincronizzato e sta elaborando nuovi blocchi.

Puoi anche controllare l'altezza dell'ultimo blocco:

curl localhost:26657/status | jq '.result.sync_info.latest_block_height'

Conferma di essere sulla rete giusta — il campo network deve riportare qorechain-vladi:

curl localhost:26657/status | jq '.result.node_info.network'

Monitoraggio​

QoreChain espone diversi endpoint per monitorare lo stato di salute e le prestazioni del nodo.

Metriche Prometheus​

Le metriche grezze sono disponibili su:

http://localhost:26660/metrics

Queste metriche possono essere raccolte da qualsiasi collector compatibile con Prometheus.

Dashboard Grafana​

Se esegui il nodo tramite Docker Compose, Grafana è disponibile su:

http://localhost:3001

Al primo accesso, imposta le tue credenziali quando richiesto — non lasciare quelle predefinite. Le dashboard preconfigurate mostrano la produzione dei blocchi, il throughput delle transazioni, le connessioni ai peer e l'utilizzo delle risorse.

Controllo di stato REST​

L'API REST fornisce un endpoint di stato rapido:

http://localhost:1317

Riferimento delle porte​

PortaProtocolloDescrizione
26657TCPRPC — interrogazione e trasmissione delle transazioni
26656TCPP2P — comunicazione di rete peer-to-peer
1317HTTPAPI REST — interrogazione dello stato della chain via HTTP
9090gRPCAPI gRPC — accesso programmatico alla chain
8545HTTPEVM JSON-RPC — RPC compatibile con Ethereum (chain ID 9801)
8546WebSocketEVM WebSocket — sottoscrizioni in tempo reale agli eventi EVM
8899HTTPSVM RPC — RPC compatibile con Solana (solo letture; la corsia delle transazioni SVM è disabilitata)
26660HTTPEndpoint delle metriche Prometheus

Dati della rete​

CampoValore
Chain IDqorechain-vladi
EVM chain ID9801 (esadecimale 0x2649)
Versione della chainv3.2.7 (applicata all'altezza 4.164.600 il 12 novembre 2026)
Attiva dal7 giugno 2026
Tempo di bloccocirca 3,1 secondi (media misurata)
TokenQOR (uqor, 10^6 micro-unità = 1 QOR)
Prezzo minimo del gas0.1uqor
Prefisso degli accountqor
Prefisso dei validatoriqorvaloper
SDKCosmos SDK v0.53

Prossimi passi​