Aller au contenu principal

Connexion au mainnet

Rejoignez le mainnet QoreChain Vladi en service en configurant votre nœud avec le fichier genesis officiel, les pairs et les paramètres réseau.

remarque

Cette page couvre le mainnet qorechain-vladi (chain ID EVM 9801, hex 0x2649), en production depuis le 7 juin 2026 et exécutant la version v3.2.7 sur Cosmos SDK v0.53 depuis le 12 novembre 2026 (appliquée à la hauteur 4 164 600, les blocs ont repris vers 15:01 UTC, par la proposition de gouvernance 16 ; la v3.2.6 avait été appliquée à la hauteur 4 020 000 le 4 novembre 2026). Pour le testnet qorechain-diana (chain ID EVM 9800), consultez Connexion au testnet et répétez-y votre configuration avant de passer en production.

Points d'accès publics​

Si vous avez seulement besoin d'interroger la chaîne ou de diffuser des transactions, vous n'avez pas besoin de votre propre nœud — les points d'accès publics sont :

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

Pour des charges de travail lourdes ou de production (exchanges, indexeurs), exécutez votre propre nœud comme décrit ci-dessous.

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​

Installez le binaire qorechaind soit à partir du bundle précompilé officiel, soit en le compilant depuis les sources.

Bundle binaire précompilé (linux/amd64)​

La source de vérité canonique pour le binaire actuel est le manifeste mainnet, un fichier JSON actualisé en direct à l'adresse https://download.qore.host/mainnet/latest.json. Il contient l'URL et le SHA-256 du binaire actuel, l'URL/le SHA-256/la taille du genesis actuel, les pairs et seeds actuels, le port P2P, un point de confiance pour la synchronisation d'état, ainsi que la version de chaîne minimale compatible. Récupérez-le et utilisez ses valeurs plutôt que de coder en dur une version de binaire ou une somme de contrôle dans vos scripts d'installation — celles-ci deviennent obsolètes dès qu'une nouvelle version est publiée :

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

Le bundle contient qorechaind ainsi que ses bibliothèques partagées requises (libqorepqc.so, libqoresvm.so, libwasmvm.x86_64.so et, à partir de la v3.2.8, libwasmvmqore_v1.x86_64.so). Copiez le répertoire lib/ entier, et non des fichiers isolés.

Maintenez votre nœud à jour

Les nœuds complets doivent suivre la version en production du réseau — installez toujours le binaire pointé par le manifeste et ne fixez pas une ancienne version. Le manifeste actuel (vérifié le 12 novembre 2026) est v3.2.7 avec minCompatible 3.2.7 et upgradeHeight 4 164 600 : le mainnet y a appliqué la v3.2.7 le 12 novembre 2026 par la proposition de gouvernance 16 (les blocs ont repris vers 15:01 UTC), et un nœud encore sur une version antérieure ne peut pas suivre la chaîne au-delà de cette hauteur. Le bundle est qorechaind-v3.2.7-b3-linux-amd64.tar.gz (99 472 930 octets, SHA-256 d4b2f166a75900d2354759b067b3e21c6fbd96003ac056163791cf4b7fb242b5). Le manifeste indique de copier tout le dossier lib/ du bundle ; pour la v3.2.7 il contient libqorepqc.so, libqoresvm.so et libwasmvm.x86_64.so. Un nœud encore sur la v3.2.6 qui a manqué la mise à niveau s'arrête à la hauteur 4 164 600 avec UPGRADE "v3.2.7" NEEDED, et le correctif consiste à installer ce bundle (avec son dossier lib/) puis à redémarrer (l'état est conservé). Les mises à niveau par gouvernance précédentes sur le mainnet étaient la v3.1.94 à la hauteur 2 122 074 (le plafond d'émission), la v3.2.0 à la hauteur 2 981 742 (la fenêtre d'autorisation EVM et les octets de signature hybride v2), la v3.2.2 à la hauteur 3 556 788 (16 octobre 2026, proposition 7), la v3.2.3 à la hauteur 3 662 051 (20 octobre 2026, proposition 11), la v3.2.4 à la hauteur 3 742 566 (23 octobre 2026, proposition 13), la v3.2.5 à la hauteur 3 906 833 (29 octobre 2026, proposition 14) et la v3.2.6 à la hauteur 4 020 000 (4 novembre 2026, proposition 15). La v3.2.1 était une version locale au nœud, sans hauteur. La signature des transactions était inchangée dans la v3.2.6 ; la v3.2.7 ajoute le mode de signature textuel comme option supplémentaire. Un nœud qui rejoint le réseau a besoin du binaire v3.2.7 que nomme le manifeste ; privilégiez la synchronisation d'état (ci-dessous) plutôt que la relecture depuis le genesis. Le snapshot de données de chaîne publié est antérieur à toutes ces hauteurs de mise à niveau, de sorte qu'un nœud restauré à partir de celui-ci doit les rejouer.

Définissez evm-chain-id = 9801 dans app.toml (une valeur différente est journalisée comme une erreur) et maintenez l'horloge système synchronisée par NTP : un nœud s'arrête lorsque son horloge dérive de plus de 60 secondes. Vérifiez toujours les champs "version" et "minCompatible" du manifeste avant de faire confiance à binary.url — le manifeste est promu délibérément (d'abord sur le testnet, puis sur le mainnet après une période de rodage). Le format de signature, les adresses, les décimales, les mémos et les frais n'ont pas changé dans la v3.2.3 ni la v3.2.4.

Le testnet (qorechain-diana) exécute la v3.2.8, une version d'avance sur le mainnet (il a appliqué la v3.2.5 le 26 octobre 2026, la v3.2.6 le 27 octobre 2026, la v3.2.7 le 6 novembre 2026 et la v3.2.8 le 12 novembre 2026 ; le mainnet n'a pas appliqué la v3.2.8). Ne copiez jamais un binaire d'un réseau à l'autre : suivez toujours le manifeste du réseau que vous exploitez.

Lorsqu'une mise à niveau coordonnée est programmée, le texte de la proposition indique la hauteur et vous demande de rester sur la version précédente jusque-là : le nœud s'arrête à cette hauteur et vous le redémarrez sous le nouveau binaire. Lisez le status de la proposition (curl -s https://api.qore.host/cosmos/gov/v1/proposals/<id>) ainsi que les champs version et upgradeHeight du manifeste mainnet avant de remplacer un binaire, et n'installez jamais un binaire de mise à niveau avant sa hauteur : un nœud qui l'embarque trop tôt s'arrête lui aussi. Le 12 novembre 2026, aucun plan de mise à niveau n'était défini (curl -s https://api.qore.host/cosmos/upgrade/v1beta1/current_plan renvoyait "plan": null). La dernière, la proposition de gouvernance 16, a appliqué la v3.2.7 (build 3) à la hauteur 4 164 600 le 12 novembre 2026 (la précédente, la proposition 15, a appliqué la v3.2.6 à la hauteur 4 020 000 le 4 novembre 2026) ; le manifeste ci-dessus fait foi pour ce qu'un nœud neuf doit installer.

Compilation depuis les sources (développement uniquement)​

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

Cela compile le binaire communautaire avec des keepers factices (stubs) et sans signataire post-quantique, qui ne peut ni reproduire l'état de consensus des réseaux ni créer de transactions à signature hybride. Pour exécuter un nœud sur le mainnet, installez le binaire de version ci-dessus. Consultez Compilation depuis les sources pour l'ensemble des prérequis (Go 1.26+, CGO, bibliothèques natives).

Initialiser le nœud​

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

Cela crée les répertoires de configuration et de données par défaut sous ~/.qorechaind/.


Télécharger le genesis​

Remplacez votre fichier genesis local par le genesis officiel du mainnet, en utilisant l'URL et le SHA-256 provenant 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 également servi en direct par la chaîne elle-même — vous pouvez recouper le téléchargement avec celui-ci :

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

Ce fichier définit l'état initial du mainnet Vladi, y compris l'ensemble des validateurs du genesis, les allocations de jetons (TGE au genesis) et les paramètres des modules.


Configurer les pairs​

Modifiez la configuration de votre nœud pour vous connecter aux nœuds sentinelles publics du mainnet. Lisez les listes actuelles de pairs et de seeds depuis le manifeste plutôt que de coder en dur les identifiants de nœuds et les hôtes — ceux-ci sont renouvelés périodiquement :

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

Ouvrez ~/.qorechaind/config/config.toml et définissez 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 prix plancher des frais du réseau est 0.1uqor) :

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 mainnet produit actuellement un bloc environ toutes les 3,1 secondes). Laissez les délais de 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 (snapshot ou synchronisation d'état)​

La synchronisation depuis le genesis peut prendre beaucoup de temps. Le champ stateSync du manifeste contient une paire hauteur/hash de confiance actualisée toutes les heures — utilisez-la pour configurer la synchronisation d'état plutôt que de rechercher une hauteur manuellement :

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

Définissez ensuite la section [statesync] de config.toml avec ces valeurs — voir Exécuter un nœud pour le workflow complet, y compris une méthode manuelle de repli basée sur le RPC si vous devez dériver vous-même un point de confiance.

Un snapshot des données de la chaîne figure également dans le manifeste (snapshot.url, snapshot.sha256, snapshot.height). Lisez les valeurs depuis le manifeste plutôt que de coder en dur un nom de fichier ou une hauteur, car un nouveau snapshot remplace l'ancien. Le snapshot est volumineux (des dizaines de gigaoctets) et, tel que publié en octobre 2026, a été pris à la hauteur 1 966 629 (21 août 2026) — avant chacune des hauteurs de mise à niveau indiquées ci-dessus — de sorte qu'un nœud restauré à partir de celui-ci doit rejouer ces mises à niveau ; la synchronisation d'état est généralement plus rapide et évite cela :

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/

Démarrer le nœud​

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

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

Le nœud se connecte aux pairs et commence à télécharger les blocs (depuis le genesis, ou depuis la hauteur du snapshot si vous en avez restauré un).


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'

Confirmez que vous êtes sur le bon réseau — le champ network doit indiquer qorechain-vladi :

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

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 9801)
8546WebSocketWebSocket EVM — abonnements aux événements EVM en temps réel
8899HTTPRPC SVM — RPC compatible Solana (lectures uniquement ; la voie de transactions SVM est désactivée)
26660HTTPPoint d'accès des métriques Prometheus

Informations réseau​

ChampValeur
Chain IDqorechain-vladi
Chain ID EVM9801 (hex 0x2649)
Version de chaînev3.2.7 (appliquée à la hauteur 4 164 600 le 12 novembre 2026)
En production depuis7 juin 2026
Temps de blocenviron 3,1 secondes (moyenne mesurée)
JetonQOR (uqor, 10^6 micro-unités = 1 QOR)
Prix de gaz minimum0.1uqor
Préfixe de compteqor
Préfixe de validateurqorvaloper
SDKCosmos SDK v0.53

Étapes suivantes​