Aller au contenu principal

Connexion au testnet

Rejoignez le testnet QoreChain Diana en service en configurant votre nœud avec le bon fichier genesis, les bons pairs et les bons paramètres réseau.

remarque

Cette page couvre le testnet qorechain-diana (chain ID EVM 9800). Le mainnet (qorechain-vladi, chain ID EVM 9801) est en production depuis le 7 juin 2026 (version v3.2.7 depuis le 12 novembre 2026 ; le testnet a une version d'avance) et dispose de sa propre page dédiée Connexion au mainnet, avec un genesis, des pairs et des détails de connexion distincts. Le testnet exécute la version v3.2.8 depuis le 12 novembre 2026 (il a exécuté la v3.2.7 à partir du 6 novembre et la v3.2.6 à partir du 27 octobre ; le mainnet a appliqué la v3.2.6 le 4 novembre 2026 et la v3.2.7 le 12 novembre 2026) ; son manifeste de version se trouve à l'adresse download.qore.host/testnet/latest.json.

Points d'accès publics​

Si vous avez seulement besoin d'interroger le testnet ou de diffuser des transactions, utilisez les points d'accès publics :

ServiceURL
RPC de consensushttps://rpc-testnet.qore.host (WebSocket : wss://rpc-testnet.qore.host/websocket)
REST Cosmos (LCD)https://api-testnet.qore.host
JSON-RPC EVMhttps://evm-testnet.qore.host (chain ID 9800)
WebSocket EVMwss://evm-ws-testnet.qore.host
JSON-RPC SVM (lecture seule)https://svm-testnet.qore.host
Explorateur de blocsexplore.qore.network (basculer sur Testnet)

Des QOR de testnet sont disponibles via le Faucet du tableau de bord, qui peut aussi envoyer les jetons de test Fest réservés au testnet (fUSD, fETH, fBTC ; sans valeur).

Les hôtes publics sont partagés et soumis à des limites (débit de requêtes, tailles RPC SVM, filtres EVM) ; eth_call et l'estimation du gas passent par l'hôte JSON-RPC EVM. Voir Limites des points de terminaison publics.


Installation​

La source de référence canonique pour le binaire actuel du testnet, le genesis, les pairs et le point de confiance du state-sync est le manifeste du testnet, actualisé en direct à l'adresse https://download.qore.host/testnet/latest.json. Il a la même structure que le manifeste du mainnet, de sorte que les étapes d'installation sont identiques — récupérez-le et utilisez ses valeurs plutôt que de coder en dur une version ou une somme de contrôle :

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

Le testnet applique des mises à niveau coordonnées via des propositions de gouvernance ; son manifeste porte donc un champ upgradeHeight, et minCompatible est égal à la version actuelle. Un nœud qui rejoint le réseau maintenant a besoin de la version indiquée dans le manifeste. Depuis le 12 novembre 2026, la version du testnet est la v3.2.8 (hauteur 9,929,500) ; lisez version, minCompatible, upgradeHeight ainsi que le nom, la taille et le sha256 du bundle dans le manifeste. Le 12 novembre 2026 (v3.2.8), le manifeste indiquait version 3.2.8, minCompatible 3.2.8 et upgradeHeight 9929500, et son binaire était qorechaind-v3.2.8-b3-linux-amd64.tar.gz (107 091 599 octets, sha256 ead3f3e869d1fe52229b683d3d7c206fca7e56d6f984a2b721f3fb21cb0b9954 ; vérifiez le sha256 avant d'exécuter le binaire). À titre de référence, le 7 novembre 2026 (v3.2.7), le manifeste indiquait version 3.2.7, minCompatible 3.2.7 et upgradeHeight 9594600, et son binaire était qorechaind-v3.2.7-b3-linux-amd64.tar.gz (99,472,930 octets, sha256 d4b2f166a75900d2354759b067b3e21c6fbd96003ac056163791cf4b7fb242b5 ; relisez les valeurs dans le manifeste et vérifiez le sha256 avant d'exécuter le binaire). Sa note indique que la version inclut le multisig post-quantique, un gas de vérification post-quantique calibré, des améliorations inter-VM et des lectures de blocs JSON-RPC plus fiables. Gardez l'horloge système synchronisée par NTP.

Nœud encore sur la v3.2.7. Il s'arrête à la hauteur 9,929,500. Remplacez qorechaind et copiez le répertoire lib/ entier du bundle v3.2.8 (il ajoute une bibliothèque à côté des existantes), puis redémarrez-le : l'état est conservé et aucune resynchronisation n'est nécessaire.

VersionHauteur sur le testnetDate d'application
v3.2.26,905,0342 octobre 2026
v3.2.38,003,74615 octobre 2026
v3.2.48,337,25319 octobre 2026
v3.2.58,890,80026 octobre 2026
v3.2.68,970,63827 octobre 2026 (16:58 UTC)
v3.2.79,594,6006 novembre 2026 (vers 15:00 UTC)
v3.2.89,929,50012 novembre 2026 (vers 03:35 UTC)

Le testnet reçoit chaque version avant le mainnet. Le mainnet a appliqué la v3.2.4 à la hauteur 3,742,566 le 23 octobre 2026 et la v3.2.5 à la hauteur 3,906,833 le 29 octobre 2026 (proposition de gouvernance 14), la v3.2.6 à la hauteur 4,020,000 le 4 novembre 2026 (proposition de gouvernance 15) et la v3.2.7 à la hauteur 4,164,600 le 12 novembre 2026 (proposition de gouvernance 16). Le mainnet a donc une version de retard : le testnet exécute la v3.2.8 depuis le 12 novembre 2026, que le mainnet n'a pas appliquée. Les manifestes sont distincts ; ne copiez donc jamais un binaire d'un réseau à l'autre (les ajouts de la v3.2.8 sont listés dans l'Historique des versions).


Télécharger le genesis​

Remplacez votre fichier genesis local par le genesis officiel du testnet, en utilisant l'URL et le SHA-256 du manifeste récupéré ci-dessus :

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 -

Le même fichier est aussi servi en direct par la chaîne elle-même :

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

Ce fichier définit l'état initial du testnet Diana, y compris l'ensemble des validateurs, les allocations de jetons et les paramètres des modules.

Le testnet est mis à niveau sur place

Diana fonctionne en continu depuis le 1er juillet 2026 et est mis à niveau par des propositions de gouvernance, comme le mainnet. Le testnet est un réseau de préproduction et peut être réinitialisé sans préavis : si votre nœud cesse de se synchroniser, consultez le manifeste et les annonces Discord, puis retéléchargez le genesis et repartez d'un répertoire de données vierge. Le sentry public ne conserve que les blocs récents ; un nouveau nœud doit donc utiliser le state-sync (ci-dessous) plutôt que de rejouer la chaîne depuis le genesis.


Configurer les pairs​

Lisez les listes actuelles de pairs et de seeds dans le manifeste plutôt que de coder en dur des identifiants de nœuds et des hôtes :

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

Ouvrez ~/.qorechaind/config/config.toml et renseignez les champs persistent_peers (et seeds) avec ces valeurs :

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

Définissez également le prix plancher des frais dans ~/.qorechaind/config/app.toml (le testnet utilise le même prix de gaz minimum de 0.1uqor que le mainnet) :

minimum-gas-prices = "0.1uqor"

Paramètres recommandés​

Un nœud complet ne choisit pas le temps de bloc — ce sont les validateurs qui le font (le testnet produit actuellement un bloc environ toutes les 1,3 secondes). Laissez les délais d'expiration du consensus à leurs valeurs par défaut, sauf si vous exploitez un validateur et que le groupe de validateurs vous a communiqué des valeurs. Un paramètre de mempool utile pour un nœud RPC public, dans config.toml :

[mempool]
size = 5000

Démarrage rapide (State Sync)​

Le champ stateSync du manifeste fournit une paire hauteur/hash de confiance actualisée régulièrement :

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

Renseignez la section [statesync] de config.toml avec ces valeurs et les rpcServers du manifeste — consultez Exécuter un nœud pour le flux de travail complet.


Démarrer le nœud​

Lancez votre nœud pour commencer la synchronisation avec le réseau :

./qorechaind start

Le nœud se connecte aux pairs et commence à télécharger les blocs (depuis le genesis, ou depuis la hauteur de confiance si vous utilisez le state-sync). La durée de la synchronisation initiale dépend de la hauteur actuelle de la chaîne et de la vitesse de votre réseau.


Vérifier l'état de synchronisation​

Vérifiez que votre nœud rattrape le dernier bloc :

curl localhost:26657/status | jq '.result.sync_info.catching_up'
  • true — Le nœud est encore en cours de synchronisation. Attendez qu'il rattrape la chaîne.
  • false — Le nœud est entièrement synchronisé et traite les nouveaux blocs.

Vous pouvez aussi consulter la dernière hauteur de bloc :

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

Supervision​

QoreChain expose plusieurs points d'accès pour surveiller la santé et les performances du nœud.

Métriques Prometheus​

Les métriques brutes sont disponibles à l'adresse :

http://localhost:26660/metrics

Ces métriques peuvent être collectées par n'importe quel collecteur compatible Prometheus.

Tableaux de bord Grafana​

En cas d'exécution via Docker Compose, Grafana est disponible à l'adresse :

http://localhost:3001

Lors de la première connexion, définissez vos propres identifiants lorsque vous y êtes invité — ne laissez pas les valeurs par défaut en place. Des tableaux de bord préconfigurés affichent la production de blocs, le débit de transactions, les connexions aux pairs et l'utilisation des ressources.

Vérification de santé REST​

L'API REST fournit un point d'accès de statut rapide :

http://localhost:1317

Référence des ports​

PortProtocoleDescription
26657TCPRPC — interroger et diffuser des transactions
26656TCPP2P — communication réseau pair-à-pair
1317HTTPAPI REST — interroger l'état de la chaîne via HTTP
9090gRPCAPI gRPC — accès programmatique à la chaîne
8545HTTPJSON-RPC EVM — RPC compatible Ethereum (chain ID 9800)
8546WebSocketWebSocket EVM — abonnements aux événements EVM en temps réel
8899HTTPRPC SVM — RPC compatible Solana (lecture seule ; la voie de transaction SVM est désactivée)
26660HTTPPoint d'accès des métriques Prometheus

Prochaines étapes​