Aller au contenu principal

Démarrage rapide

Lancez un nœud QoreChain en quelques minutes. Choisissez Docker Compose pour la configuration la plus rapide, ou compilez depuis les sources pour un contrôle total.


Docker Compose (recommandé)​

La manière la plus simple d'exécuter un environnement QoreChain complet avec tous les services préconfigurés.

git clone https://github.com/qorechain/qorechain-core.git
cd qorechain-core
cp .env.example .env
cp .env.sidecar.example .env.sidecar
# edit .env and set GRAFANA_PASSWORD (Compose refuses to start without it)
docker compose up -d

Avant le premier démarrage, copiez .env.example vers .env et .env.sidecar.example vers .env.sidecar (comme ci-dessus) et définissez GRAFANA_PASSWORD.

Cela démarre les services suivants :

ServicePortsDescription
qorechain-node26657 (RPC), 1317 (REST), 9090 (gRPC), 8545 / 8546 (EVM)Nœud blockchain complet avec support multi-VM
ai-sidecar50051Moteur de détection d'anomalies et de scoring de risque QCAI
indexer--Indexeur de blocs pour les requêtes historiques
postgres5432Backend de base de données pour l'indexeur
prometheus9091Collecte de métriques
grafana3001Tableaux de bord de surveillance

Une fois tous les conteneurs sains, vous disposez d'une chaîne de développement locale à nœud unique (elle initialise son propre genesis ; elle ne rejoint ni le mainnet ni le testnet). Pour rejoindre un réseau en service, suivez les pages Connexion au mainnet ou Connexion au testnet.


Compiler depuis les sources​

Prérequis​

  • Go 1.26+ avec CGO activé
  • Chaîne d'outils Rust (pour compiler la cryptographie PQC et les bibliothèques du runtime SVM)
  • Git

Compiler le binaire​

CGO_ENABLED=1 go build -o qorechaind ./cmd/qorechaind/
Une compilation depuis les sources est destinée au développement local

L'arborescence source publique compile le binaire communautaire. Il dispose de l'ensemble des commandes mais pas du signataire post-quantique : tx pqc gen-key et tx pqc cosign renvoient une erreur (« requires the full build »), il ne peut donc pas créer de transactions pour un réseau qui exige des signatures hybrides, et ses keepers factices (stubs) ne reproduisent pas l'état de consensus des réseaux. Pour rejoindre le mainnet ou le testnet, ou y effectuer des transactions, installez le binaire de release indiqué dans latest.json sous download.qore.host.

Initialiser le nœud​

./qorechaind init my-node --chain-id qorechain-diana

Cela crée les répertoires de configuration et de données par défaut sous ~/.qorechaind/. Démarré seul, le nœud forme une chaîne locale à nœud unique ; pour rejoindre un réseau en service, suivez les pages de connexion.

Démarrer le nœud​

./qorechaind start

Le nœud démarre avec les paramètres par défaut. Voir Connexion au testnet pour rejoindre le réseau en service avec une configuration genesis et de pairs appropriée.

remarque

Les exemples de cette page ciblent le testnet qorechain-diana (EVM chain ID 9800). Le mainnet (qorechain-vladi, EVM chain ID 9801) est en service depuis le 7 juin 2026 (version v3.2.7 depuis le 12 novembre 2026 ; le testnet exécute la v3.2.8 depuis le 12 novembre 2026) et dispose de sa propre page dédiée Connexion au mainnet.


Vérifier l'installation​

Confirmez que votre nœud fonctionne correctement :

# Check that the binary runs
./qorechaind --help
# Query the node status via RPC
curl localhost:26657/status

Une réponse réussie inclut le moniker du nœud, le network (qorechain-diana pour la chaîne de développement locale créée ci-dessus, ou la chaîne que vous avez rejointe) et la hauteur de bloc courante.


Étapes suivantes​