Zum Hauptinhalt springen

Verbindung zum Mainnet

Treten Sie dem live laufenden QoreChain-Vladi-Mainnet bei, indem Sie Ihren Node mit der offiziellen Genesis-Datei, den Peers und den Netzwerkeinstellungen konfigurieren.

hinweis

Diese Seite behandelt das qorechain-vladi-Mainnet (EVM-Chain-ID 9801, hexadezimal 0x2649), live seit dem 7. Juni 2026, mit dem Release v3.2.7 auf Cosmos SDK v0.53 seit dem 12. November 2026 (angewendet auf Höhe 4.164.600, die Blöcke liefen gegen 15:01 UTC wieder, durch Governance-Vorschlag 16; v3.2.6 war auf Höhe 4.020.000 am 4. November 2026 angewendet worden). Für das qorechain-diana-Testnet (EVM-Chain-ID 9800) siehe Verbindung zum Testnet und proben Sie dort Ihr Setup, bevor Sie live gehen.

Öffentliche Endpunkte​

Wenn Sie lediglich die Chain abfragen oder Transaktionen broadcasten möchten, benötigen Sie keinen eigenen Node — die öffentlichen Endpunkte sind:

DienstURL
Konsensus-RPChttps://rpc.qore.host (WebSocket: wss://rpc.qore.host/websocket)
Cosmos REST (LCD)https://api.qore.host
EVM JSON-RPChttps://evm.qore.host (Chain-ID 9801)
SVM JSON-RPC (nur lesend)https://svm.qore.host
Block-Explorerexplore.qore.network

Für hohe Lasten oder Produktions-Workloads (Börsen, Indexer) betreiben Sie einen eigenen Node, wie unten beschrieben.

Die öffentlichen Hosts werden gemeinsam genutzt und unterliegen Limits (Anfragerate, SVM-RPC-Größen, EVM-Filter); eth_call und die Gasschätzung laufen über den EVM-JSON-RPC-Host. Siehe Limits der öffentlichen Endpunkte.


Installation​

Installieren Sie das qorechaind-Binary entweder aus dem offiziellen vorkompilierten Bundle oder durch Kompilieren aus dem Quellcode.

Vorkompiliertes Binary-Bundle (linux/amd64)​

Die maßgebliche Quelle für das aktuelle Binary ist das Mainnet-Manifest, eine JSON-Datei, die live unter https://download.qore.host/mainnet/latest.json aktualisiert wird. Sie enthält die aktuelle Binary-URL und den SHA-256-Wert, die aktuelle Genesis-URL/den SHA-256-Wert/die Größe, die aktuellen Peers und Seeds, den P2P-Port, einen State-Sync-Vertrauenspunkt sowie die minimal kompatible Chain-Version. Rufen Sie sie ab und verwenden Sie ihre Werte, anstatt eine Binary-Version oder Prüfsumme in Ihren Installationsskripten fest zu hinterlegen — diese veralten, sobald ein neues Release erscheint:

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

Das Bundle enthält qorechaind sowie die benötigten Shared Libraries (libqorepqc.so, libqoresvm.so, libwasmvm.x86_64.so und, ab v3.2.8, libwasmvmqore_v1.x86_64.so). Kopieren Sie das gesamte Verzeichnis lib/, nicht einzelne Dateien.

Halten Sie Ihren Node aktuell — v3.2.3, dann v3.2.4

Full Nodes müssen dem live laufenden Release des Netzwerks folgen — installieren Sie stets das Binary, auf das das Manifest verweist, und pinnen Sie kein altes fest. Das aktuelle Manifest (geprüft am 12. November 2026) ist v3.2.7 mit minCompatible 3.2.7 und upgradeHeight 4.164.600: Das Mainnet hat v3.2.7 dort am 12. November 2026 über den Governance-Vorschlag 16 angewendet (die Blöcke liefen gegen 15:01 UTC wieder), und ein Node, der noch auf einem älteren Release läuft, kann der Chain nicht über diese Höhe hinaus folgen. Das Bundle ist qorechaind-v3.2.7-b3-linux-amd64.tar.gz (99.472.930 Bytes, SHA-256 d4b2f166a75900d2354759b067b3e21c6fbd96003ac056163791cf4b7fb242b5). Laut Manifest ist das gesamte Verzeichnis lib/ des Bundles zu kopieren; für v3.2.7 enthält es libqorepqc.so, libqoresvm.so und libwasmvm.x86_64.so. Ein Node, der noch auf v3.2.6 läuft und das Upgrade verpasst hat, hält bei Höhe 4.164.600 mit UPGRADE "v3.2.7" NEEDED an, und die Lösung ist, dieses Bundle (mit seinem Verzeichnis lib/) zu installieren und neu zu starten (der Zustand bleibt erhalten). Frühere Governance-Upgrades im Mainnet waren v3.1.94 bei Höhe 2.122.074 (die Emissions-Obergrenze), v3.2.0 bei Höhe 2.981.742 (das EVM-Autorisierungsfenster und die v2-Hybridsignatur-Bytes), v3.2.2 bei Höhe 3.556.788 (16. Oktober 2026, Vorschlag 7), v3.2.3 bei Höhe 3.662.051 (20. Oktober 2026, Vorschlag 11) v3.2.4 bei Höhe 3.742.566 (23. Oktober 2026, Vorschlag 13) und v3.2.5 bei Höhe 3.906.833 (29. Oktober 2026, Vorschlag 14) und v3.2.6 bei Höhe 4.020.000 (4. November 2026, Vorschlag 15). v3.2.1 war ein node-lokales Release ohne Höhe. Die Transaktionssignierung blieb in v3.2.6 unverändert; v3.2.7 ergänzt den Textual-Signiermodus als zusätzliche Option. Ein Node, der frisch beitritt, benötigt das v3.2.7-Binary, das das Manifest nennt; bevorzugen Sie State Sync (unten) gegenüber einem Replay ab Genesis. Der veröffentlichte Chain-Daten-Snapshot liegt vor allen diesen Upgrade-Höhen, ein daraus wiederhergestellter Node muss sie daher replayen.

Setzen Sie evm-chain-id = 9801 in app.toml (ein anderer Wert wird als Fehler protokolliert) und halten Sie die Systemuhr per NTP synchron: Ein Node hält an, wenn seine Uhr um mehr als 60 Sekunden abweicht. Prüfen Sie stets die Felder "version" und "minCompatible" des Manifests, bevor Sie binary.url vertrauen — das Manifest wird bewusst schrittweise ausgerollt (zuerst Testnet, dann Mainnet nach einer Bewährungsphase). Signaturformat, Adressen, Dezimalstellen, Memos und Gebühren haben sich in v3.2.3 oder v3.2.4 nicht geändert.

Das Testnet (qorechain-diana) läuft mit v3.2.8, ein Release vor dem Mainnet (es hat v3.2.5 am 26. Oktober 2026, v3.2.6 am 27. Oktober 2026, v3.2.7 am 6. November 2026 und v3.2.8 am 12. November 2026 angewendet; das Mainnet hat v3.2.8 nicht angewendet). Kopieren Sie niemals ein Binary von einem Netzwerk ins andere: Folgen Sie stets dem Manifest des Netzwerks, das Sie betreiben.

Wenn ein koordiniertes Upgrade angesetzt ist, nennt der Vorschlagstext die Höhe und weist Sie an, bis dahin auf dem vorherigen Release zu bleiben: Der Node hält bei dieser Höhe an, und Sie starten ihn mit dem neuen Binary neu. Lesen Sie den status des Vorschlags (curl -s https://api.qore.host/cosmos/gov/v1/proposals/<id>) sowie die Felder version und upgradeHeight des Mainnet-Manifests, bevor Sie ein Binary austauschen, und installieren Sie ein Upgrade-Binary niemals vor seiner Höhe: Ein Node, der es früh trägt, hält ebenfalls an. Am 12. November 2026 war kein Upgrade-Plan gesetzt (curl -s https://api.qore.host/cosmos/upgrade/v1beta1/current_plan lieferte "plan": null). Das letzte, der Governance-Vorschlag 16, hat v3.2.7 (Build 3) auf Höhe 4.164.600 am 12. November 2026 angewendet (das davor, Vorschlag 15, hat v3.2.6 auf Höhe 4.020.000 am 4. November 2026 angewendet); das Manifest oben ist die maßgebliche Quelle dafür, was ein frischer Node installiert.

Aus dem Quellcode kompilieren (nur für die Entwicklung)​

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

Dies erzeugt das Community-Binary mit Stub-Keepern und ohne Post-Quantum-Signierer; es kann weder den Konsenszustand der Netzwerke reproduzieren noch hybrid-signierte Transaktionen erstellen. Um einen Node im Mainnet zu betreiben, installieren Sie das oben genannte Release-Binary. Die vollständigen Voraussetzungen (Go 1.26+, CGO, native Bibliotheken) finden Sie unter Building from Source.

Node initialisieren​

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

Dies erstellt die Standard-Konfigurations- und Datenverzeichnisse unter ~/.qorechaind/.


Genesis herunterladen​

Ersetzen Sie Ihre lokale Genesis-Datei durch die offizielle Mainnet-Genesis, unter Verwendung der URL und des SHA-256-Werts aus dem oben abgerufenen Manifest:

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 -

Dieselbe Datei wird auch live von der Chain selbst ausgeliefert — Sie können den Download dagegen gegenprüfen:

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

Diese Datei definiert den Anfangszustand des Vladi-Mainnets, einschließlich des Genesis-Validator-Sets, der Token-Zuteilungen (TGE bei Genesis) und der Modulparameter.


Peers konfigurieren​

Bearbeiten Sie Ihre Node-Konfiguration, um sich mit den öffentlichen Mainnet-Sentry-Nodes zu verbinden. Lesen Sie die aktuellen Peer- und Seed-Listen aus dem Manifest, anstatt Node-IDs und Hosts fest zu hinterlegen — diese rotieren:

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

Öffnen Sie ~/.qorechaind/config/config.toml und setzen Sie die Felder persistent_peers (und seeds) auf diese Werte:

persistent_peers = "<value of $PEERS>"
seeds = "<value of $SEEDS>"

Setzen Sie außerdem den minimalen Gaspreis in ~/.qorechaind/config/app.toml (die Gebührenuntergrenze des Netzwerks beträgt 0.1uqor):

minimum-gas-prices = "0.1uqor"

Empfohlene Einstellungen​

Ein Full Node legt die Blockzeit nicht fest — das tun die Validatoren (das Mainnet erzeugt derzeit etwa alle 3,1 Sekunden einen Block). Belassen Sie die Konsensus-Timeouts bei ihren Standardwerten, es sei denn, Sie betreiben einen Validator und haben von der Validatorengruppe Werte erhalten. Eine nützliche Mempool-Einstellung für einen öffentlichen RPC-Node in config.toml:

[mempool]
size = 5000

Schneller Bootstrap (Snapshot oder State Sync)​

Die Synchronisation ab Genesis kann lange dauern. Das Feld stateSync des Manifests enthält ein stündlich aktualisiertes Paar aus Vertrauenshöhe und -hash — verwenden Sie es, um State Sync zu konfigurieren, anstatt eine Höhe manuell nachzuschlagen:

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

Setzen Sie anschließend den Abschnitt [statesync] von config.toml mit diesen Werten — den vollständigen Ablauf, einschließlich eines manuellen, RPC-basierten Fallbacks, falls Sie einen Vertrauenspunkt selbst ableiten müssen, finden Sie unter Running a Node.

Ein Chain-Daten-Snapshot ist ebenfalls im Manifest aufgeführt (snapshot.url, snapshot.sha256, snapshot.height). Lesen Sie die Werte aus dem Manifest, anstatt einen Dateinamen oder eine Höhe fest zu hinterlegen, da ein neuer Snapshot den alten ablöst. Der Snapshot ist groß (zig Gigabyte) und wurde, wie im Oktober 2026 veröffentlicht, bei Höhe 1.966.629 (21. August 2026) erstellt — vor jeder oben aufgeführten Upgrade-Höhe —, sodass ein daraus wiederhergestellter Node diese Upgrades replayen muss; State Sync ist in der Regel schneller und vermeidet das:

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/

Node starten​

Starten Sie Ihren Node, um mit der Synchronisation mit dem Netzwerk zu beginnen:

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

Der Node verbindet sich mit Peers und beginnt, Blöcke herunterzuladen (ab Genesis oder ab der Snapshot-Höhe, falls Sie einen Snapshot eingespielt haben).


Synchronisationsstatus prüfen​

Überprüfen Sie, ob Ihr Node zum neuesten Block aufholt:

curl localhost:26657/status | jq '.result.sync_info.catching_up'
  • true — Der Node synchronisiert noch. Warten Sie, bis er aufgeholt hat.
  • false — Der Node ist vollständig synchronisiert und verarbeitet neue Blöcke.

Sie können auch die aktuelle Blockhöhe prüfen:

curl localhost:26657/status | jq '.result.sync_info.latest_block_height'

Bestätigen Sie, dass Sie im richtigen Netzwerk sind — das Feld network sollte qorechain-vladi melden:

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

Monitoring​

QoreChain stellt mehrere Endpunkte zur Überwachung von Node-Gesundheit und -Leistung bereit.

Prometheus-Metriken​

Rohmetriken sind verfügbar unter:

http://localhost:26660/metrics

Diese Metriken können von jedem Prometheus-kompatiblen Collector gescrapt werden.

Grafana-Dashboards​

Beim Betrieb über Docker Compose ist Grafana verfügbar unter:

http://localhost:3001

Legen Sie beim ersten Login eigene Zugangsdaten fest, wenn Sie dazu aufgefordert werden — belassen Sie es nicht bei den Standardwerten. Vorkonfigurierte Dashboards zeigen Blockproduktion, Transaktionsdurchsatz, Peer-Verbindungen und Ressourcennutzung an.

REST-Health-Check​

Die REST-API bietet einen schnellen Status-Endpunkt:

http://localhost:1317

Port-Referenz​

PortProtokollBeschreibung
26657TCPRPC — Transaktionen abfragen und broadcasten
26656TCPP2P — Peer-to-Peer-Netzwerkkommunikation
1317HTTPREST-API — Chain-Zustand per HTTP abfragen
9090gRPCgRPC-API — programmatischer Chain-Zugriff
8545HTTPEVM JSON-RPC — Ethereum-kompatibles RPC (Chain-ID 9801)
8546WebSocketEVM WebSocket — EVM-Event-Abonnements in Echtzeit
8899HTTPSVM RPC — Solana-kompatibles RPC (nur lesend; die SVM-Transaktionsspur ist deaktiviert)
26660HTTPPrometheus-Metriken-Endpunkt

Netzwerk-Fakten​

FeldWert
Chain-IDqorechain-vladi
EVM-Chain-ID9801 (hexadezimal 0x2649)
Chain-Versionv3.2.7 (angewendet bei Höhe 4.164.600 am 12. November 2026)
Live seit7. Juni 2026
Blockzeitetwa 3,1 Sekunden (gemessener Durchschnitt)
TokenQOR (uqor, 10^6 Mikroeinheiten = 1 QOR)
Minimaler Gaspreis0.1uqor
Account-Präfixqor
Validator-Präfixqorvaloper
SDKCosmos SDK v0.53

Nächste Schritte​