Zum Hauptinhalt springen

Schnellstart

Bringen Sie einen QoreChain-Knoten in wenigen Minuten zum Laufen. Wählen Sie Docker Compose für die schnellste Einrichtung oder erstellen Sie aus dem Quellcode für volle Kontrolle.


Docker Compose (Empfohlen)​

Der einfachste Weg, eine vollständige QoreChain-Umgebung mit allen vorkonfigurierten Diensten zu betreiben.

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

Kopieren Sie vor dem ersten Start .env.example nach .env und .env.sidecar.example nach .env.sidecar (wie oben) und setzen Sie GRAFANA_PASSWORD.

Dies startet die folgenden Dienste:

DienstPortsBeschreibung
qorechain-node26657 (RPC), 1317 (REST), 9090 (gRPC), 8545 / 8546 (EVM)Vollständiger Blockchain-Knoten mit Multi-VM-Unterstützung
ai-sidecar50051QCAI-Engine für Anomalieerkennung und Risikobewertung
indexer--Block-Indexer für historische Abfragen
postgres5432Datenbank-Backend für den Indexer
prometheus9091Metrikerfassung
grafana3001Überwachungs-Dashboards

Sobald alle Container gesund sind, haben Sie eine lokale Single-Node-Entwicklungs-Chain (sie initialisiert ihren eigenen Genesis; sie tritt weder dem Mainnet noch dem Testnet bei). Um einem aktiven Netzwerk beizutreten, folgen Sie den Seiten Verbindung zum Mainnet oder Verbindung zum Testnet.


Aus dem Quellcode erstellen​

Voraussetzungen​

  • Go 1.26+ mit aktiviertem CGO
  • Rust-Toolchain (zum Kompilieren der PQC-Kryptografie und der SVM-Laufzeitbibliotheken)
  • Git

Die Binärdatei erstellen​

CGO_ENABLED=1 go build -o qorechaind ./cmd/qorechaind/
Ein Quellcode-Build dient der lokalen Entwicklung

Der öffentliche Quellbaum erzeugt die Community-Binärdatei. Sie hat den vollständigen Befehlssatz, aber nicht den Post-Quantum-Signierer: tx pqc gen-key und tx pqc cosign geben einen Fehler zurück ("requires the full build"), sodass sie keine Transaktionen für ein Netzwerk erstellen kann, das Hybridsignaturen verlangt, und ihre Stub-Keeper den Konsenszustand der Netzwerke nicht reproduzieren. Um dem Mainnet oder Testnet beizutreten oder dort Transaktionen zu senden, installieren Sie die in latest.json unter download.qore.host genannte Release-Binärdatei.

Den Knoten initialisieren​

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

Dies erstellt die Standardkonfiguration und die Datenverzeichnisse unter ~/.qorechaind/. Allein gestartet, bildet der Knoten eine lokale Single-Node-Chain; um einem aktiven Netzwerk beizutreten, folgen Sie den Verbindungsseiten.

Den Knoten starten​

./qorechaind start

Der Knoten startet mit den Standardeinstellungen. Siehe Verbindung zum Testnet für den Beitritt zum aktiven Netzwerk mit korrekter Genesis- und Peer-Konfiguration.

hinweis

Die Beispiele auf dieser Seite zielen auf das qorechain-diana-Testnet (EVM-Chain-ID 9800) ab. Das Mainnet (qorechain-vladi, EVM-Chain-ID 9801) ist seit dem 7. Juni 2026 aktiv (Release v3.2.7 seit dem 12. November 2026; das Testnet läuft seit dem 12. November 2026 auf v3.2.8) und hat seine eigene dedizierte Seite Verbindung zum Mainnet.


Installation überprüfen​

Bestätigen Sie, dass Ihr Knoten korrekt läuft:

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

Eine erfolgreiche Antwort enthält den moniker des Knotens, das network (qorechain-diana bei der oben erstellten lokalen Entwicklungs-Chain oder die Chain, der Sie beigetreten sind) und die aktuelle Blockhöhe.


Nächste Schritte​