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.
Cette page couvre le mainnet qorechain-vladi (chain ID EVM 9801, hex 0x2649), en production depuis le 7 juin 2026 23:59 UTC et exécutant la version de chaîne v3.1.97 sur Cosmos SDK v0.53. 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 :
| Service | URL |
|---|---|
| RPC de consensus | https://rpc.qore.host (WebSocket : wss://rpc.qore.host/websocket) |
| REST Cosmos (LCD) | https://api.qore.host |
| JSON-RPC EVM | https://evm.qore.host (chain ID 9801) |
| JSON-RPC SVM (lecture seule) | https://svm.qore.host |
| Explorateur de blocs | explore.qore.network |
Pour des charges de travail lourdes ou de production (exchanges, indexeurs), exécutez votre propre nœud comme décrit ci-dessous.
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).
Les nœuds complets doivent suivre la version de chaîne en production — installez toujours le binaire pointé par le manifeste, ne fixez pas une ancienne version. Le plancher pour un nœud qui rejoint le réseau depuis zéro (depuis le genesis) ou qui se rétablit après un arrêt est v3.1.94 ou supérieure, pour deux raisons indépendantes et cumulatives : v3.1.92 a corrigé un bug de mesure du gas qui, sinon, arrête la relecture au premier bloc contenant une transaction, et le mainnet a depuis franchi la mise à niveau par gouvernance v3.1.94 (un plafond strict sur l'émission, appliqué à la hauteur 2 122 074) — un nœud dépourvu du gestionnaire de cette mise à niveau s'arrête à nouveau en tentant de rejouer au-delà de cette même hauteur. v3.1.97 est la version actuellement recommandée (mises à jour de sécurité continues ; minCompatible vaut 3.1.94). Vérifiez toujours le champ "version" du manifeste par rapport au plancher actuel 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) et a déjà été en retard par rapport au plancher de version.
Compilation depuis les sources
git clone https://github.com/qorechain/qorechain-core.git
cd qorechain-core
CGO_ENABLED=1 go build -o qorechaind ./cmd/qorechaind/
Consultez Compilation depuis les sources pour l'ensemble des prérequis (Go 1.26+, CGO, toolchain Rust, 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
Vous pouvez également ajuster les valeurs suivantes dans config.toml :
[mempool]
size = 5000
[consensus]
timeout_propose = "3s"
timeout_commit = "5s"
Ces valeurs sont réglées pour les temps de bloc et le débit du mainnet Vladi.
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 est également publié sur download.qore.host. Vérifiez le listing actuel à cet endroit pour obtenir le nom de fichier et la somme de contrôle publiés du dernier snapshot — ne codez pas en dur un nom de fichier ou une hauteur, car un nouveau snapshot remplace régulièrement l'ancien :
# Substitute the current filename and checksum from the download.qore.host listing
curl -fsSL https://download.qore.host/<current-snapshot-filename>.tar.gz -o snapshot.tar.gz
sha256sum snapshot.tar.gz # compare against the checksum published alongside it
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
| Port | Protocole | Description |
|---|---|---|
26657 | TCP | RPC — interroger et diffuser des transactions |
26656 | TCP | P2P — communication réseau pair-à-pair |
1317 | HTTP | API REST — interroger l'état de la chaîne via HTTP |
9090 | gRPC | API gRPC — accès programmatique à la chaîne |
8545 | HTTP | JSON-RPC EVM — RPC compatible Ethereum (chain ID 9801) |
8546 | WebSocket | WebSocket EVM — abonnements aux événements EVM en temps réel |
8899 | HTTP | RPC SVM — RPC compatible Solana |
26660 | HTTP | Point d'accès des métriques Prometheus |
Informations réseau
| Champ | Valeur |
|---|---|
| Chain ID | qorechain-vladi |
| Chain ID EVM | 9801 (hex 0x2649) |
| Version de chaîne | v3.1.97 |
| En production depuis | 7 juin 2026 23:59 UTC |
| Jeton | QOR (uqor, 10^6 micro-unités = 1 QOR) |
| Prix de gaz minimum | 0.1uqor |
| Préfixe de compte | qor |
| Préfixe de validateur | qorvaloper |
| SDK | Cosmos SDK v0.53 |
Étapes suivantes
- Exécuter un nœud — Exploiter un nœud complet/RPC pour les exchanges et intégrateurs
- Guide pour exchanges et intégrateurs — Dépôts, retraits et supervision
- Exécuter un validateur — Créer et exploiter un validateur
- Configuration du portefeuille — Configurer un portefeuille pour le mainnet
- Votre première transaction — Envoyer votre premier transfert de QOR
- Connexion au testnet — Rejoindre le testnet Diana pour des tests gratuits
- Réseaux — Chain IDs, ports et la référence complète des réseaux