Connessione alla Testnet
Unisciti alla testnet Diana di QoreChain configurando il tuo nodo con il file genesis, i peer e le impostazioni di rete corretti.
Questa pagina riguarda la testnet qorechain-diana (chain ID EVM 9800). La mainnet (qorechain-vladi, chain ID EVM 9801) è attiva dal 7 giugno 2026 (release v3.2.7 dal 12 novembre 2026; la testnet è una release avanti) e dispone di una pagina dedicata Connessione alla Mainnet con genesis, peer e dettagli di connessione separati. La testnet esegue la v3.2.8 dal 12 novembre 2026 (ha eseguito la v3.2.7 dal 6 novembre e la v3.2.6 dal 27 ottobre; la mainnet ha applicato la v3.2.6 il 4 novembre 2026 e la v3.2.7 il 12 novembre 2026); il suo manifesto di rilascio si trova all'indirizzo download.qore.host/testnet/latest.json.
Endpoint Pubblici
Se hai solo bisogno di interrogare la testnet o trasmettere transazioni, utilizza gli endpoint pubblici:
| Servizio | URL |
|---|---|
| RPC di consenso | https://rpc-testnet.qore.host (WebSocket: wss://rpc-testnet.qore.host/websocket) |
| Cosmos REST (LCD) | https://api-testnet.qore.host |
| EVM JSON-RPC | https://evm-testnet.qore.host (chain ID 9800) |
| EVM WebSocket | wss://evm-ws-testnet.qore.host |
| SVM JSON-RPC (sola lettura) | https://svm-testnet.qore.host |
| Block explorer | explore.qore.network (passa a Testnet) |
I QOR di testnet sono disponibili tramite il Faucet della Dashboard, che può inviare anche i token di test Fest solo testnet (fUSD, fETH, fBTC; senza valore).
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
La fonte canonica di riferimento per il binario attuale della testnet, il genesis, i peer e il punto di fiducia dello state-sync è il manifesto della testnet, aggiornato in tempo reale all'indirizzo https://download.qore.host/testnet/latest.json. Ha la stessa struttura del manifesto della mainnet, quindi i passaggi di installazione sono gli stessi — scaricalo e usa i suoi valori invece di fissare nel codice una versione o un checksum:
curl -s https://download.qore.host/testnet/latest.json -o latest.json
jq -r '.version, .minCompatible, .upgradeHeight' 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
qorechaind init my-node --chain-id qorechain-diana
La testnet adotta aggiornamenti coordinati tramite proposte di governance, quindi il suo manifesto riporta un campo upgradeHeight e minCompatible è uguale alla versione attuale. Un nodo che si unisce ora ha bisogno della release indicata nel manifesto. Dal 12 novembre 2026 la release della testnet è la v3.2.8 (altezza 9.929.500); leggi version, minCompatible, upgradeHeight e nome, dimensione e sha256 del bundle dal manifesto. Il 12 novembre 2026 (v3.2.8) il manifesto riportava version 3.2.8, minCompatible 3.2.8 e upgradeHeight 9929500, e il suo binario era qorechaind-v3.2.8-b3-linux-amd64.tar.gz (107.091.599 byte, sha256 ead3f3e869d1fe52229b683d3d7c206fca7e56d6f984a2b721f3fb21cb0b9954; verifica lo sha256 prima di eseguire il binario). Come riferimento, il 7 novembre 2026 (v3.2.7) il manifesto riportava version 3.2.7, minCompatible 3.2.7 e upgradeHeight 9594600, e il suo binario era qorechaind-v3.2.7-b3-linux-amd64.tar.gz (99.472.930 byte, sha256 d4b2f166a75900d2354759b067b3e21c6fbd96003ac056163791cf4b7fb242b5; rileggi i valori dal manifesto e verifica lo sha256 prima di eseguire il binario). La sua nota dice che la release include il multisig post-quantistico, il gas di verifica post-quantistica calibrato, miglioramenti cross-VM e letture dei blocchi JSON-RPC più affidabili. Mantieni l'orologio di sistema sincronizzato via NTP.
Nodo ancora sulla v3.2.7. Si ferma all'altezza 9.929.500. Sostituisci qorechaind e copia l'intera cartella lib/ del bundle v3.2.8 (aggiunge una libreria accanto a quelle esistenti), poi riavvialo: lo stato viene mantenuto e non serve una nuova sincronizzazione.
| Release | Altezza sulla testnet | Data di applicazione |
|---|---|---|
| v3.2.2 | 6.905.034 | 2 ottobre 2026 |
| v3.2.3 | 8.003.746 | 15 ottobre 2026 |
| v3.2.4 | 8.337.253 | 19 ottobre 2026 |
| v3.2.5 | 8.890.800 | 26 ottobre 2026 |
| v3.2.6 | 8.970.638 | 27 ottobre 2026 (16:58 UTC) |
| v3.2.7 | 9.594.600 | 6 novembre 2026 (circa 15:00 UTC) |
| v3.2.8 | 9.929.500 | 12 novembre 2026 (circa 03:35 UTC) |
La testnet adotta ogni release prima della mainnet. La mainnet ha applicato la v3.2.4 all'altezza 3.742.566 il 23 ottobre 2026 la v3.2.5 all'altezza 3.906.833 il 29 ottobre 2026 (proposta di governance 14), la v3.2.6 all'altezza 4.020.000 il 4 novembre 2026 (proposta di governance 15) e la v3.2.7 all'altezza 4.164.600 il 12 novembre 2026 (proposta di governance 16). La mainnet è quindi una release indietro: la testnet esegue la v3.2.8 dal 12 novembre 2026, che la mainnet non ha applicato. I manifesti sono separati, quindi non copiare mai un binario da una rete all'altra (le aggiunte della v3.2.8 sono elencate in Cronologia delle Versioni).
Scaricare il Genesis
Sostituisci il tuo file genesis locale con il genesis ufficiale della testnet, usando l'URL e lo SHA-256 del manifesto scaricato sopra:
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 anche in tempo reale dalla chain stessa:
curl -s https://rpc-testnet.qore.host/genesis | jq '.result.genesis' > /tmp/genesis-live.json
Questo file definisce lo stato iniziale della testnet Diana, incluso il set di validatori, le allocazioni dei token e i parametri dei moduli.
Diana è in esecuzione ininterrotta dal 1° luglio 2026 e viene aggiornata tramite proposte di governance, come la mainnet. La testnet è una rete di staging e può essere reimpostata senza preavviso: se il tuo nodo smette di sincronizzarsi, controlla il manifesto e gli annunci su Discord, poi scarica nuovamente il genesis e riparti da una directory dati pulita. Il sentry pubblico conserva solo i blocchi recenti, quindi un nuovo nodo dovrebbe usare lo state-sync (qui sotto) invece di rieseguire la chain dal genesis.
Configurare i Peer
Leggi gli elenchi attuali di peer e seed dal manifesto invece di fissare nel codice gli ID dei nodi e gli host:
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) con quei valori:
persistent_peers = "<value of $PEERS>"
seeds = "<value of $SEEDS>"
Imposta anche la soglia minima delle commissioni in ~/.qorechaind/config/app.toml (la testnet utilizza lo stesso prezzo minimo del gas di 0.1uqor della mainnet):
minimum-gas-prices = "0.1uqor"
Impostazioni Consigliate
Un full node non sceglie il tempo di blocco — lo scelgono i validatori (la testnet produce attualmente un blocco circa ogni 1,3 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 (State Sync)
Il campo stateSync del manifesto contiene una coppia altezza/hash di fiducia aggiornata regolarmente:
TRUST_HEIGHT=$(jq -r .stateSync.trustHeight latest.json)
TRUST_HASH=$(jq -r .stateSync.trustHash latest.json)
Imposta la sezione [statesync] di config.toml con quei valori e gli rpcServers del manifesto — consulta Eseguire un Nodo per il flusso di lavoro completo.
Avviare il Nodo
Avvia il tuo nodo per iniziare la sincronizzazione con la rete:
./qorechaind start
Il nodo si connette ai peer e inizia a scaricare i blocchi (dal genesis, oppure dall'altezza di fiducia se usi lo state-sync). Il tempo di sincronizzazione iniziale dipende dall'altezza attuale della chain e dalla velocità della tua rete.
Verificare lo 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 si sta ancora sincronizzando. Attendi che completi l'allineamento.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'
Monitoraggio
QoreChain espone diversi endpoint per monitorare la salute e le prestazioni del nodo.
Metriche Prometheus
Le metriche grezze sono disponibili all'indirizzo:
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 all'indirizzo:
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 | REST API — interrogazione dello stato della chain via HTTP |
9090 | gRPC | gRPC API — accesso programmatico alla chain |
8545 | HTTP | EVM JSON-RPC — RPC compatibile con Ethereum (chain ID 9800) |
8546 | WebSocket | EVM WebSocket — sottoscrizioni in tempo reale agli eventi EVM |
8899 | HTTP | SVM RPC — RPC compatibile con Solana (sola lettura; la corsia delle transazioni SVM è disabilitata) |
26660 | HTTP | Endpoint delle metriche Prometheus |
Prossimi Passi
- Configurazione del Wallet — Configura un wallet per la testnet
- La Tua Prima Transazione — Invia il tuo primo trasferimento di QOR