QoreChain stellt drei primäre Schnittstellen für den programmatischen Zugriff bereit:
| Schnittstelle | Standardport | Protokoll | Beschreibung |
|---|
| REST | 1317 | HTTP/1.1 | LCD (Light Client Daemon) REST-API |
| gRPC | 9090 | HTTP/2 | Protobuf-kodierter gRPC-Dienst |
| RPC | 26657 | HTTP + WS | RPC der QoreChain Consensus Engine |
Alle REST-Endpunkte liefern JSON zurück. gRPC-Endpunkte verwenden Protocol Buffers und können mit jedem gRPC-Client konsumiert werden. Die RPC-Schnittstelle bietet Abfragen auf Konsensebene sowie das Broadcasting von Transaktionen.
Diese Schnittstellen sind sowohl im qorechain-vladi-Mainnet (live seit dem 7. Juni 2026 auf Chain-Version v3.1.85) als auch im qorechain-diana-Testnet verfügbar. Die unten aufgeführten Basis-URLs setzen einen lokal laufenden Node voraus; die öffentlich gehosteten Endpunkte (rpc/api/evm/svm.qore.host und ihre -testnet-Varianten) sind unter Netzwerke aufgelistet.
Basis-URLs
REST: http://localhost:1317
gRPC: localhost:9090
RPC: http://localhost:26657
AI-Modul
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /ai/v1/config | Liefert die aktuelle Konfiguration des AI-Moduls |
| GET | /ai/v1/stats | Aggregierte AI-Verarbeitungsstatistiken |
| GET | /ai/v1/fee-estimate | AI-gestützte Gasgebühren-Schätzung für eine Transaktion |
| GET | /ai/v1/fraud/investigations | Listet alle aktiven Betrugsermittlungen auf |
| GET | /ai/v1/fraud/investigations/{id} | Liefert Details zu einer bestimmten Betrugsermittlung |
| GET | /ai/v1/network/recommendations | AI-generierte Empfehlungen zur Netzwerkoptimierung |
| GET | /ai/v1/circuit-breakers | Aktuelle Circuit-Breaker-Zustände und Schwellenwerte |
Bridge-Modul
Seit Chain-Version v3.1.77 wird der Nur-Lese-Zustand des Bridge-Moduls über grpc-gateway unter dem Präfix /qorechain/bridge/v1/... per REST bereitgestellt (zuvor nur gRPC). Diese Endpunkte liefern echtes On-Chain-JSON über HTTP für Explorer und Light-Node-Telemetrie. Die Bridge-config meldet z. B. min_validators=10 und threshold=7.
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /qorechain/bridge/v1/config | Aktuelle Konfiguration des Bridge-Moduls |
| GET | /qorechain/bridge/v1/chains | Listet alle registrierten Bridge-Chains auf |
| GET | /qorechain/bridge/v1/chains/{chain_id} | Details zu einer bestimmten gebrückten Chain |
| GET | /qorechain/bridge/v1/validators | Listet registrierte Bridge-Validatoren auf |
| GET | /qorechain/bridge/v1/validators/{address} | Details zu einem bestimmten Bridge-Validator |
| GET | /qorechain/bridge/v1/operations | Listet Bridge-Operationen auf |
| GET | /qorechain/bridge/v1/operations/{id} | Details zu einer bestimmten Bridge-Operation |
Die folgenden Endpunkte mit kürzeren Pfaden bleiben verfügbar:
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /bridge/v1/chains | Listet alle registrierten Bridge-Chains auf |
| GET | /bridge/v1/chains/{id} | Details zu einer bestimmten gebrückten Chain |
| GET | /bridge/v1/validators | Listet aktive Bridge-Validatoren auf |
| GET | /bridge/v1/operations | Listet aktuelle Bridge-Operationen auf |
| GET | /bridge/v1/operations/{id} | Details zu einer bestimmten Bridge-Operation |
| GET | /bridge/v1/locked/{chain}/{asset} | Insgesamt gesperrter Wert für ein Chain-/Asset-Paar |
| GET | /bridge/v1/limits/{chain} | Ratenlimits und Schwellenwerte für eine gebrückte Chain |
| GET | /bridge/v1/estimate | Schätzt Bridge-Gebühr und Transferdauer |
PQC-Modul
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /pqc/v1/params | Aktuelle Parameter des PQC-Moduls |
| GET | /pqc/v1/accounts/{address} | PQC-Schlüsselstatus für ein bestimmtes Konto |
| GET | /pqc/v1/stats | Aggregierte PQC-Registrierungs- und Migrationsstatistiken |
Reputation-Modul
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /reputation/v1/validators | Reputationswerte für alle Validatoren |
| GET | /reputation/v1/validators/{address} | Reputationswert für einen bestimmten Validator |
Cross-VM-Modul
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /crossvm/v1/message/{id} | Ruft eine Cross-VM-Nachricht anhand ihrer ID ab |
| GET | /crossvm/v1/pending | Listet ausstehende Cross-VM-Nachrichten in der Queue auf |
| GET | /crossvm/v1/params | Aktuelle Parameter des Cross-VM-Moduls |
Multilayer-Modul
Seit Chain-Version v3.1.80 wird der vollständige Query-Service des Multilayer-Moduls über grpc-gateway unter dem Präfix /qorechain/multilayer/v1/... per REST bereitgestellt (zuvor nur gRPC), einschließlich zweier State-Anchor-Leseabfragen: anchor/{layer_id} liefert den neuesten Settlement-Anchor für einen Layer, und anchors/{layer_id} liefert dessen Anchor-Historie. Jeder Anchor trägt eine ML-DSA-87 (Dilithium-5)-Signatur über seine kanonischen Felder, sodass ein Client einen Anchor abrufen und unabhängig verifizieren kann — die On-Chain-Grundlage für die Settlement-Receipts des Rollup Development Kit.
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /qorechain/multilayer/v1/params | Aktuelle Parameter des Multilayer-Moduls |
| GET | /qorechain/multilayer/v1/layers | Listet alle registrierten Layer auf |
| GET | /qorechain/multilayer/v1/layers/{layer_id} | Details zu einem bestimmten Layer |
| GET | /qorechain/multilayer/v1/anchor/{layer_id} | Neuester State-Anchor für einen Layer |
| GET | /qorechain/multilayer/v1/anchors/{layer_id} | State-Anchor-Historie für einen Layer |
| GET | /qorechain/multilayer/v1/routing-stats | Transaktions-Routing-Statistiken über alle Layer |
Eine StateAnchorView enthält layer_id, layer_height, state_root, validator_set_hash, main_chain_height, anchored_at, pqc_aggregate_signature, transaction_count und compressed_state_proof. Die signierte kanonische Nachricht lautet layer_id || layer_height || state_root || validator_set_hash und wird gegen den registrierten PQC-Schlüssel des Layer-Erstellers verifiziert.
Die folgenden Endpunkte mit kürzeren Pfaden bleiben verfügbar:
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /multilayer/v1/layer/{id} | Details zu einem bestimmten Layer |
| GET | /multilayer/v1/layers | Listet alle registrierten Layer auf |
| GET | /multilayer/v1/anchor/{id} | Details zu einem bestimmten Anchor-Eintrag |
| GET | /multilayer/v1/anchors | Listet aktuelle Anchor-Einreichungen auf |
| GET | /multilayer/v1/routing-stats | Transaktions-Routing-Statistiken über alle Layer |
| GET | /multilayer/v1/params | Aktuelle Parameter des Multilayer-Moduls |
SVM-Modul
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /svm/v1/params | Aktuelle Parameter des SVM-Moduls |
| GET | /svm/v1/account/{address} | SVM-Kontoinformationen für eine gegebene Adresse |
| GET | /svm/v1/program/{address} | Informationen zum bereitgestellten Programm für eine gegebene Programmadresse |
RL-Consensus-Modul
Über dieses Modul werden PRISM-Tuning-Parameter und der Zustand des Reinforcement-Learning-Agenten bereitgestellt.
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /rlconsensus/v1/agent | Aktueller Status und Modus des PRISM-Agenten |
| GET | /rlconsensus/v1/observation | Neuester Beobachtungsvektor |
| GET | /rlconsensus/v1/rewards | Kumulierte Reward-Metriken |
| GET | /rlconsensus/v1/params | Aktuelle Parameter des PRISM-Consensus-Moduls |
| GET | /rlconsensus/v1/policy | Aktive Policy-Konfiguration und -Gewichte |
Burn-Modul
Seit Chain-Version v3.1.77 wird der Nur-Lese-Zustand des Burn-Moduls über grpc-gateway unter dem Präfix /qorechain/burn/v1/... per REST bereitgestellt (zuvor nur gRPC). Diese Endpunkte liefern echtes On-Chain-JSON über HTTP für Explorer und Light-Node-Telemetrie. Die Burn-stats enthalten z. B. gas_burn_rate=0.30.
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /qorechain/burn/v1/params | Aktuelle Parameter des Burn-Moduls |
| GET | /qorechain/burn/v1/stats | Burn-Statistiken über alle Kanäle |
| GET | /qorechain/burn/v1/records | Listet Burn-Einträge auf |
| GET | /qorechain/burn/v1/milestone | Fortschritt der Burn-Meilensteine |
Die folgenden Endpunkte mit kürzeren Pfaden bleiben verfügbar:
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /burn/v1/stats | Burn-Statistiken über alle Kanäle |
| GET | /burn/v1/params | Aktuelle Parameter des Burn-Moduls |
xQORE-Modul
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /xqore/v1/position/{address} | xQORE-Staking-Position für eine gegebene Adresse |
| GET | /xqore/v1/params | Aktuelle Parameter des xQORE-Moduls |
Inflation-Modul
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /inflation/v1/rate | Aktuelle annualisierte Inflationsrate |
| GET | /inflation/v1/epoch | Aktuelle Epochennummer und Fortschritt |
| GET | /inflation/v1/params | Aktuelle Parameter des Inflation-Moduls |
RDK-Modul
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /rdk/v1/rollup/{id} | Details zu einem bestimmten Rollup |
| GET | /rdk/v1/rollups | Listet alle registrierten Rollups auf |
| GET | /rdk/v1/batch/{id}/{index} | Ruft einen bestimmten Settlement-Batch ab |
| GET | /rdk/v1/batches/{id} | Listet Batches für ein bestimmtes Rollup auf |
| GET | /rdk/v1/blob/{id}/{index} | Ruft einen bestimmten DA-Blob ab |
| GET | /rdk/v1/params | Aktuelle Parameter des RDK-Moduls |
Babylon-Modul
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /babylon/v1/staking/{address} | BTC-Staking-Position für eine gegebene Adresse |
| GET | /babylon/v1/checkpoint/{epoch} | BTC-Checkpoint-Daten für eine gegebene Epoche |
| GET | /babylon/v1/params | Aktuelle Parameter des Babylon-Moduls |
Abstract-Account-Modul
Seit Chain-Version v3.1.85 wird der Abstract-Account-Query-Service über grpc-gateway unter dem Präfix /qorechain/abstractaccount/v1/... per REST bereitgestellt, einschließlich des Permission-Schemas, das zur Validierung von Authenticator-Berechtigungsumfängen ohne Hardcoding verwendet wird.
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /qorechain/abstractaccount/v1/config | Modulkonfiguration (Feature-Probe: enabled) |
| GET | /qorechain/abstractaccount/v1/accounts | Listet abstrakte Konten auf |
| GET | /qorechain/abstractaccount/v1/accounts/{address} | Abstract-Account-Zustand für eine Adresse |
| GET | /qorechain/abstractaccount/v1/permission_schema | Berechtigungstaxonomie, msg→permission-Zuordnung, nicht delegierbare Msgs |
Die folgenden Endpunkte mit kürzeren Pfaden bleiben verfügbar:
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /abstractaccount/v1/account/{address} | Abstract-Account-Details für eine gegebene Adresse |
| GET | /abstractaccount/v1/params | Aktuelle Parameter des Abstract-Account-Moduls |
FairBlock-Modul
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /fairblock/v1/config | Aktuelle FairBlock-Verschlüsselungskonfiguration |
| GET | /fairblock/v1/params | Aktuelle Parameter des FairBlock-Moduls |
Gas-Abstraction-Modul
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /gasabstraction/v1/accepted-tokens | Listet für Gaszahlungen akzeptierte Tokens auf |
| GET | /gasabstraction/v1/params | Aktuelle Parameter des Gas-Abstraction-Moduls |
gRPC-Reflection
Die gRPC-Server-Reflection ist standardmäßig aktiviert, sodass Tools wie grpcurl die verfügbaren Dienste erkennen können:
grpcurl -plaintext localhost:9090 list
So fragen Sie einen bestimmten Dienst ab:
grpcurl -plaintext localhost:9090 qorechain.pqc.v1.Query/Params
Authentifizierung
Alle REST- und gRPC-Endpunkte sind standardmäßig nicht authentifiziert. Für Produktionsumgebungen sollte ein Reverse-Proxy (z. B. Nginx oder Caddy) vor dem Node platziert werden, um TLS-Terminierung und Zugriffskontrolle zu übernehmen.