Compilation depuis les sources

Ce guide vous accompagne dans la compilation du binaire qorechaind depuis les sources, en couvrant à la fois la compilation communautaire (open-core) et la compilation propriétaire complète.

Prérequis

Dépendance	Version minimale	Remarques
Go	1.26+	Requise pour toutes les compilations
CGO	Activé (CGO_ENABLED=1)	Requis pour les ponts FFI PQC et SVM
Chaîne d'outils Rust	Dernière version stable	Requise pour compiler libqorepqc et libqoresvm
Make	3.81+	Automatisation de la compilation
Git	2.x	Récupération des sources

Vérifiez votre environnement :

go version        # go1.26.x or later
rustc --version   # stable toolchain
cargo --version
echo $CGO_ENABLED # must be 1

danger

Chaque invocation de go build, go test et go run doit avoir CGO_ENABLED=1 défini. Les modules PQC et SVM utilisent des ponts FFI qui nécessitent cgo.

Bibliothèques natives

QoreChain dépend de deux bibliothèques natives compilées en Rust, chargées au moment de l'exécution.

libqorepqc (cryptographie post-quantique)

La bibliothèque PQC fournit la génération de clés, la signature et la vérification ML-DSA-87 (Dilithium-5) via une interface FFI compatible C.

cd rust/qorepqc
cargo build --release

La bibliothèque compilée est placée dans lib/{os}_{arch}/ :

Plateforme	Fichier de bibliothèque	Répertoire
macOS arm64	libqorepqc.dylib	lib/darwin_arm64/
Linux amd64	libqorepqc.so	lib/linux_amd64/
Linux arm64	libqorepqc.so	lib/linux_arm64/

libqoresvm (environnement d'exécution SVM)

La bibliothèque SVM fournit l'environnement d'exécution des programmes BPF pour le module x/svm.

cd rust/qoresvm
cargo build --release

La sortie suit la même convention lib/{os}_{arch}/ que ci-dessus (libqoresvm.dylib sur macOS, libqoresvm.so sur Linux).

Définition du chemin de la bibliothèque

Les bibliothèques natives doivent être détectables au moment de l'exécution. Définissez la variable d'environnement appropriée pour votre plateforme :

macOS :

export DYLD_LIBRARY_PATH=$(pwd)/lib/darwin_arm64:$DYLD_LIBRARY_PATH

Linux :

export LD_LIBRARY_PATH=$(pwd)/lib/linux_amd64:$LD_LIBRARY_PATH

info

Astuce : ajoutez l'export à votre profil shell (~/.bashrc, ~/.zshrc) pour qu'il persiste entre les sessions.

Architecture Open-Core

QoreChain suit un modèle open-core :

• Compilation communautaire — Contient l'intégralité des interfaces de module, des commandes CLI, des définitions protobuf et des types de messages pour chaque module QoreChain (x/pqc, x/ai, x/reputation, x/qca, x/svm, x/crossvm, etc.). Les keepers des modules propriétaires utilisent des implémentations factices (stub) qui renvoient des valeurs par défaut sûres ou des réponses sans effet (no-op). Cela permet aux outils tiers, aux portefeuilles et aux indexeurs de s'intégrer avec toutes les API QoreChain sans nécessiter de code propriétaire.
• Compilation complète (propriétaire) — Active les implémentations complètes des keepers derrière le tag de compilation proprietary. Cela inclut la véritable logique de détection d'anomalies par IA, l'ajustement des paramètres de consensus PRISM, le calcul avancé du score de réputation, et toutes les fonctionnalités de niveau production.

Les deux compilations produisent un binaire portant le même nom qorechaind et exposent des commandes CLI et des points de terminaison gRPC/REST identiques. La différence réside dans le comportement à l'exécution de la logique des keepers derrière ces interfaces.

Compilation communautaire

CGO_ENABLED=1 go build -o qorechaind ./cmd/qorechaind/

Cela compile toutes les interfaces de module publiques avec des keepers factices pour les fonctionnalités propriétaires. Le binaire résultant est pleinement fonctionnel pour :

• Exécuter un nœud validateur
• Soumettre et interroger des transactions
• Interagir avec les machines virtuelles EVM, CosmWasm et SVM
• Créer des intégrations et des outils tiers
• Le développement et les tests en local

Compilation complète (propriétaire)

CGO_ENABLED=1 go build -tags proprietary -o qorechaind ./cmd/qorechaind/

Le drapeau -tags proprietary active les implémentations complètes des keepers, qui ne font pas partie de l'arborescence de sources publique.

Exécution des tests

CGO_ENABLED=1 go test ./... -count=1

Le drapeau -count=1 désactive la mise en cache des tests, garantissant une exécution propre à chaque fois. Les tests de packages individuels peuvent être exécutés avec :

CGO_ENABLED=1 go test ./x/pqc/... -count=1 -v
CGO_ENABLED=1 go test ./x/ai/... -count=1 -v
CGO_ENABLED=1 go test ./x/svm/... -count=1 -v

Exécutez les tests des bibliothèques Rust séparément :

cd rust/qorepqc && cargo test
cd rust/qoresvm && cargo test

Vérification de la compilation

Après une compilation réussie, vérifiez le binaire :

./qorechaind version
./qorechaind init test-node --chain-id qorechain-diana

La commande init doit créer un fichier genesis et une configuration de nœud dans ~/.qorechaind/ sans erreur. L'exemple ci-dessus initialise le nœud sur le testnet qorechain-diana — pour le mainnet, remplacez par --chain-id qorechain-vladi, le réseau en production exécutant la version de chaîne v3.1.97.

Compilation Docker

Pour les compilations conteneurisées, un Dockerfile est fourni à la racine du dépôt :

docker build -t qorechaind:latest .

L'image Docker gère automatiquement toute la compilation des bibliothèques natives et la configuration des chemins. Consultez le guide Démarrage rapide pour exécuter un nœud avec Docker Compose.

Dépannage

cgo : compilateur C introuvable

Installez les outils en ligne de commande Xcode (macOS) ou build-essential (Linux)

Introuvable : -lqorepqc

Compilez d'abord les bibliothèques Rust, puis définissez LD_LIBRARY_PATH / DYLD_LIBRARY_PATH

Symbole non défini : sonic.*

Assurez-vous que go.sum est à jour : go mod tidy

Signal : processus arrêté pendant la compilation

Augmentez la mémoire disponible (cas fréquent avec Docker lorsque les limites sont basses)

Les tests PQC échouent avec une incompatibilité de taille

Vérifiez que vous utilisez pqcrypto v0.5.0+ (ML-DSA-87 : pubkey=2592, privkey=4896, sig=4627 octets)