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.
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:
| Servizio | URL |
|---|---|
| RPC di consenso | 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 (sola lettura) | https://svm.qore.host |
| Esploratore di blocchi | explore.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.
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
| Porta | Protocollo | Descrizione |
|---|---|---|
26657 | TCP | RPC — interrogazione e trasmissione delle transazioni |
26656 | TCP | P2P — comunicazione di rete peer-to-peer |
1317 | HTTP | API REST — interrogazione dello stato della chain via HTTP |
9090 | gRPC | API gRPC — accesso programmatico alla chain |
8545 | HTTP | EVM JSON-RPC — RPC compatibile con Ethereum (chain ID 9801) |
8546 | WebSocket | EVM WebSocket — sottoscrizioni in tempo reale agli eventi EVM |
8899 | HTTP | SVM RPC — RPC compatibile con Solana (solo letture; la corsia delle transazioni SVM è disabilitata) |
26660 | HTTP | Endpoint delle metriche Prometheus |
Dati della rete
| Campo | Valore |
|---|---|
| Chain ID | qorechain-vladi |
| EVM chain ID | 9801 (esadecimale 0x2649) |
| Versione della chain | v3.2.7 (applicata all'altezza 4.164.600 il 12 novembre 2026) |
| Attiva dal | 7 giugno 2026 |
| Tempo di blocco | circa 3,1 secondi (media misurata) |
| Token | QOR (uqor, 10^6 micro-unità = 1 QOR) |
| Prezzo minimo del gas | 0.1uqor |
| Prefisso degli account | qor |
| Prefisso dei validatori | qorvaloper |
| SDK | Cosmos SDK v0.53 |
Prossimi passi
- Eseguire un nodo — Gestisci un nodo full/RPC per exchange e integratori
- Guida per exchange e integratori — Depositi, prelievi e monitoraggio
- Eseguire un validatore — Crea e gestisci un validatore
- Configurazione del wallet — Configura un wallet per la mainnet
- La tua prima transazione — Invia il tuo primo trasferimento di QOR
- Connessione alla testnet — Unisciti alla testnet Diana per i test gratuiti
- Reti — Chain ID, porte e il riferimento completo delle reti