Zum Hauptinhalt springen

Bridge-Architektur

Das x/bridge-Modul ist darauf ausgelegt, QoreChain über 37 Chain-Konfigurationen (36 externe Chains plus Injective, das über IBC angebunden wird) und bis zu 8 IBC-(Inter-Blockchain Communication-)Gegenparteien mit dem breiteren Blockchain-Ökosystem zu verbinden. Jede Bridge-Operation ist darauf ausgelegt, durch Post-Quanten-Kryptografie abgesichert zu sein.

Auf keinem der beiden Netzwerke live

Das Bridge-Modul ist auf Mainnet und Testnet bereitgestellt, aber keine Bridge-Route ist aktiv: Alle 37 Chain-Konfigurationen haben den Status pending, es ist kein Bridge-Contract gesetzt, es sind keine Bridge-Validatoren registriert, es wurde noch nie eine Bridge-Operation erstellt, und im Mainnet existiert kein IBC-Kanal (das Testnet hat einen einzigen ICS-20-Testkanal zu einer Chain mit der ID provider, keinen zu den unten genannten Gegenparteien). Alles Folgende beschreibt das beabsichtigte Design. Senden Sie keine Assets in der Erwartung, dass sie gebridged werden.

Aktueller Status​

MainnetTestnet
Bridge-Modulaktiviertaktiviert
Chain-Konfigurationen37, alle pending37, alle pending
Registrierte Bridge-Validatoren00
Bridge-Operationen00
IBC-Kanäle / -Clients0 / 01 / 1 (ein Testkanal zum Cosmos-Hub-Testnet)

(Geprüft am 27. Oktober 2026 gegen Mainnet (damals v3.2.4; v3.2.6 vom 4. bis 12. November 2026, v3.2.7 seit dem 12. November 2026) und Testnet (damals v3.2.6; v3.2.8 seit dem 12. November 2026). Die Live-Werte lesen Sie mit qorechaind query bridge chains und qorechaind query bridge validators oder über REST unter /qorechain/bridge/v1/chains und /qorechain/bridge/v1/validators.) Die Modulkonfiguration ist auf beiden Netzwerken gleich: min_validators 10, attestation_threshold 7, challenge_period_secs 86,400 und large_transfer_threshold 100.000 QOR (100000000000 uqor). Der IBC-Stack, den das Modul verwenden würde, ist ibc-go v10.7 (seit v3.2.2), im Mainnet wurde jedoch noch kein Client und kein Kanal erstellt (das Testnet hat einen Test-Client und einen Test-Kanal, siehe oben).

Verbindungsübersicht​

QoreChain ist darauf ausgelegt, zwei parallel arbeitende Bridge-Protokolle zu unterstützen:

ProtokollVerbindungenSicherheitsmodellAnwendungsfall
IBCbis zu 8 Kanäle (keiner offen)Standard-IBC (ICS-20)Cosmos SDK-kompatible Chains
QCB37 Chain-Konfigs (alle pending)7-aus-10 Dilithium-5-MultisigNicht-IBC-Chains (EVM, Solana, TON usw.)

Die 37 Chain-Konfigurationen sind die unten aufgeführten 36 externen Chains plus Injective, das als Chain vom Typ IBC konfiguriert ist. Es gibt keine Loopback-Konfiguration für QoreChain. Die geplanten IBC-Kanäle verbinden sich mit Cosmos SDK-kompatiblen Chains.

IBC-Kanäle​

QoreChain ist darauf ausgelegt, IBC-Verbindungen zu den folgenden 8 Chains zu unterhalten, weitergeleitet von einem IBC-Relayer. Keine dieser Gegenparteien ist bislang verbunden (das Mainnet hat keinen IBC-Kanal und keinen IBC-Client; das Testnet hat einen einzigen ICS-20-Testkanal zu einer Chain mit der ID provider, geprüft am 27. Oktober 2026), daher listet diese Tabelle nur geplante Gegenparteien auf:

ChainBeschreibung
Cosmos HubPrimäre Hub-Verbindung
OsmosisDEX-Liquiditäts-Routing
NobleNative USDC-Emission
CelestiaData-Availability-Layer
StrideLiquid Staking
AkashDezentralisiertes Computing
BabylonBTC-Restaking-Protokoll
InjectiveDeFi-/Orderbuch-Interoperabilität

IBC-Relayer​

IBC-Pakete und Client-Updates werden von einem Relayer zwischen den Chains übertragen, einem separaten Programm, das beide Chains beobachtet und die Pakete, Beweise und Client-Updates übermittelt. Der Relayer ist nicht Teil der Chain, und dieses Handbuch verspricht keinen von QoreChain betriebenen Relayer-Dienst. QoreChain pflegt einen Open-Source-Relayer namens QORel (ein Fork von Hermes, der die hybride ML-DSA-87-Signatur ergänzt, die QoreChain bei jeder Transaktion verlangt); Version 0.1.0 ist als Vorabversion veröffentlicht. Unter QORel erfahren Sie, wie Sie ihn installieren und betreiben.

  • Client-Updates, Überwachung auf Fehlverhalten und Paketbereinigung sind Einstellungen des jeweiligen Relayers, den ein Betreiber ausführt, keine Chain-Parameter. Ein Relayer kann zum Beispiel Light Clients automatisch aktualisieren, auf Equivocation achten und ausstehende Pakete regelmäßig bereinigen.
  • Post-Quanten-Signaturen. Transaktionen, die QoreChain auf seiner nativen Lane akzeptiert, tragen eine hybride secp256k1- + ML-DSA-87-Signatur (FIPS 204), einschließlich der Transaktionen, die ein Relayer dorthin übermittelt; siehe Post-Quanten-Sicherheit. Das IBC-Paketformat selbst ist das Standardformat, und dieses Handbuch behauptet nicht, dass Pakete eine zusätzliche Signatur tragen, die andere Chains verifizieren.

QCB-(QoreChain Bridge-)Protokoll​

Das QCB-Protokoll verwendet eine Hub-and-Spoke-Architektur, die durch Post-Quanten-Kryptografie abgesichert ist. QoreChain fungiert als Hub, mit einer Spoke-Konfiguration für jede externe Chain.

Externe Chain-Konfigurationen (36)​

Das QCB-Protokoll ist darauf ausgelegt, die folgenden 36 externen Chains anzusprechen. Zusammen mit Injective (einer Konfiguration vom Typ IBC) ergeben sich insgesamt 37 Chain-Konfigurationen, die derzeit alle den Status pending haben.

Baseline-Chains (10)

Ethereum, Solana, TON, BSC, Avalanche, Polygon, Arbitrum, Optimism, Base, Sui.

EVM-Familien-Chains (14)

zkSync Era, Linea, Scroll, Blast, Mantle, Hyperliquid, Berachain, Sonic, Sei, Monad, Plasma, Filecoin FVM, Cronos, Kaia.

Nicht-EVM-Chains (5)

Starknet, XRP Ledger, Stellar, Hedera, Algorand.

Weitere Chains (7)

NEAR, Bitcoin, Cardano, Polkadot, Tezos, Tron, Aptos.

hinweis

Zählkontrolle: 10 Baseline + 14 EVM-Familie + 5 Nicht-EVM + 7 weitere = 36 externe Chains. Mit Injective (IBC) ergeben sich 37 Chain-Konfigurationen.

Adressformate​

Das QCB-Protokoll klassifiziert Chains nach Typ, um Zieladressen zu validieren:

Chain-TypBeispiel-ChainsAdressformat
evmEthereum, BSC, Avalanche, Polygon, Arbitrum, Optimism, Base0x + 40 Hex-Zeichen
solanaSolanaBase58, 32–44 Zeichen
tonTONEQ + base64-kodiert
sui_moveSui0x + 64 Hex-Zeichen
aptos_moveAptos0x + 64 Hex-Zeichen
bitcoinBitcoinBech32 (bc1), P2SH (3...) oder Legacy (1...)
nearNEAR Protocol.near-Suffix oder implizit
cardanoCardanoaddr1 (Zahlung) oder stake1 (Staking)
polkadotPolkadotSS58-kodiert
tezosTezostz1/tz2/tz3 (implizit) oder KT1 (originated)
tronTRONT + base58, 34 Zeichen

Light Clients​

Um externe Chain-Ereignisse vertrauenslos zu verifizieren, ist die Bridge darauf ausgelegt, On-Chain-Light-Clients auszuführen, die auf den Konsens und das Beweissystem jeder Quell-Chain zugeschnitten sind. Diese Light Clients ermöglichen es QoreChain, Einzahlungen und Auszahlungen zu validieren, ohne sich ausschließlich auf Validator-Attestierungen zu verlassen.

Light ClientQuell-ChainVerifizierungsprimitive
Ethereum Light ClientEthereum / EVM L1BLS12-381-Signaturverifizierung, SSZ-Serialisierung, MPT-State-Proofs
Bitcoin SPVBitcoinSimplified Payment Verification anhand von Block-Headern
Starknet STARKStarknetSTARK-Beweisverifizierung von Starknet-Zustandsübergängen
Sui BLSSuiBLS-Aggregat-Signaturverifizierung von Sui-Checkpoints
Wormhole / Solana VAASolana (via Wormhole)Verified Action Approval (VAA) Guardian-Signaturverifizierung

Einzahlungsablauf (Extern zu QoreChain)​

Die nachfolgende Sequenz zeigt die vorgesehene QCB-Einzahlung: Assets werden auf einer externen Chain gesperrt, QoreChain-Validatoren reichen PQC-signierte Attestierungen ein (7-aus-10 Dilithium-5), und Wrapped Tokens werden geprägt. Cosmos SDK-kompatible Chains würden stattdessen den parallelen IBC-Pfad verwenden (bis zu 8 Kanäle, getragen von einem IBC-Relayer). Keiner der beiden Pfade ist aktiv; es wurde noch nie eine Einzahlung vorgenommen.

External Chain QoreChain Validators QoreChain
| | |
| 1. Lock assets on | |
| bridge contract | |
|------------------------>| |
| | 2. Observe & attest |
| | (7/10 PQC sigs) |
| |------------------------->|
| | | 3. Mint wrapped
| | | tokens
| | |
| | [If > 100K QOR] |
| | 24h challenge period |
| | before execution |
  1. Lock — Der Nutzer sperrt Assets im Bridge-Contract auf der externen Chain.
  2. Attestieren — Bridge-Validatoren beobachten die Lock-Transaktion und reichen Dilithium-5-signierte Attestierungen ein. Es sind mindestens 7 von 10 Validator-Attestierungen erforderlich. Wo ein Light Client für die Quell-Chain verfügbar ist, wird das Lock-Ereignis zusätzlich anhand der chaineigenen Beweise verifiziert.
  3. Mint — Sobald der Attestierungsschwellenwert erreicht ist, werden Wrapped Tokens auf QoreChain geprägt.
  4. Challenge-Periode — Für Transfers, die den Gegenwert von 100.000 QOR überschreiten, gilt vor der Ausführung eine 24-stündige Challenge-Periode. Während dieses Zeitfensters können Validatoren verdächtige Aktivitäten kennzeichnen.

Auszahlungsablauf (QoreChain zu Extern)​

QoreChain QoreChain Validators External Chain
| | |
| 1. Burn wrapped tokens | |
|------------------------>| |
| | 2. Attest burn |
| | (7/10 PQC sigs) |
| |------------------------->|
| | | 3. Unlock original
| | | assets
  1. Burn — Der Nutzer verbrennt Wrapped Tokens auf QoreChain.
  2. Attestieren — Validatoren attestieren das Burn-Ereignis mit Dilithium-5-Signaturen (7/10-Schwellenwert).
  3. Unlock — Sobald der Schwellenwert erreicht ist, werden die ursprünglichen Assets auf der externen Chain freigegeben.

Alle während Auszahlungen erhobenen Bridge-Gebühren werden über den bridge_fee-Burn-Kanal an das x/burn-Modul geleitet (100 % der Bridge-Gebühren werden verbrannt).

L2 → L1-Auszahlungen (Rollups)​

Rollup-Auszahlungen nutzen die Bridge nicht. Sie werden vom x/rdk-Modul mit execute-withdrawal gegen die Auszahlungs-Root eines finalisierten Batches bezahlt — siehe ZK / STARK & Withdrawals.

Sicherheitsarchitektur​

PQC-Multisig​

Alle QCB-Bridge-Operationen erfordern einen 7-aus-10-Schwellenwert von Dilithium-5-Post-Quanten-Signaturen registrierter Bridge-Validatoren. Jeder Bridge-Validator registriert sich mit:

  • Einer QoreChain-Validator-Adresse
  • Einem Dilithium-5-Public-Key (2.592 Bytes)
  • Einer Liste unterstützter Chains
  • Einem Reputationswert (verwaltet von x/reputation)

Seit v3.2.2 validiert das Modul Nullbeträge und seine Konfiguration auf jedem Pfad einheitlich. Ab v3.2.4 (Mainnet seit 23. Oktober 2026, Testnet seit 19. Oktober 2026): Die Registrierung eines Bridge-Validators erfordert zusätzlich einen Besitznachweis des Dilithium-5-Schlüssels (dasselbe proof_of_possession-Format wie bei der PQC-Schlüsselregistrierung, siehe Post-Quanten-Sicherheit) und weist einen Schlüssel zurück, den bereits ein anderer Bridge-Validator verwendet. Frühere Releases haben keine solche Prüfung, und auf keinem der beiden Netzwerke ist ein Bridge-Validator registriert.

Circuit Breaker​

Jede verbundene Chain verfügt über unabhängige Circuit-Breaker-Schutzmechanismen:

SchutzmechanismusBeschreibung
EinzeltransferlimitMaximalbetrag für jede einzelne Bridge-Operation pro Chain
Tägliches GesamtlimitGesamtvolumenobergrenze pro Chain pro 24-Stunden-Fenster
Manuelle PauseDurch Governance oder Validatoren ausgelöster Notfallstopp pro Chain
AnomalieerkennungAutomatische Pause bei >50 Operationen in einem kurzen Fenster oder wenn das Volumen das 5-fache des Tageslimits überschreitet

Der Circuit-Breaker-Zustand wird pro Chain verfolgt und umfasst: maximaler Einzeltransfer, Tageslimit, aktuelle Tagesnutzung, letzte Reset-Höhe sowie Pausenstatus mit Begründung.

Challenge-Periode​

Für große Transfers (>100.000 QOR-Gegenwert, konfigurierbar über large_transfer_threshold):

  • Nach Erreichen des Attestierungsschwellenwerts gilt eine 24-stündige Challenge-Periode (86.400 Sekunden).
  • Während dieses Zeitfensters sollen Validatoren die Operation kennzeichnen können.
  • Wird sie nicht angefochten, führt sich die Operation nach Ablauf der Periode automatisch aus.
  • Angefochtene Operationen werden für eine Governance-Überprüfung eingefroren.

KI-Pfadoptimierung​

Das Bridge-Modul integriert sich mit dem KI-Subsystem für die Routenoptimierung (nicht über REST verfügbar). Für Transfers, die mehrere Pfade durchlaufen können (z. B. Chain A zu Chain B über einen Vermittler), bewertet der Pfadoptimierer:

  • Geschätzte Gebühren über die Routen hinweg
  • Geschätzte Abschlusszeit
  • Sicherheitswert pro Pfad
  • Konfidenzniveau der Schätzung

Bridge-Administration​

Chain-Aktivierung nach dem Deployment (keine Governance)​

Ab Chain-Version v3.1.78 kann eine Bridge-Chain nach dem Deployment mit einer einzigen signierten Transaktion aktiviert und neu konfiguriert werden — ohne Governance-Vorschlag und ohne Chain-Upgrade. Ein bridge_admin-Key (gesetzt in BridgeConfig.BridgeAdmin zum Genesis-Zeitpunkt) oder ein Inhaber der qcb_bridge-Lizenz kann:

  • tx bridge update-chain-config — die Contract-Adresse, Bestätigungsanzahl, Architektur und den Status einer Chain festlegen (MsgUpdateChainConfig).
  • tx bridge set-verifier-bootstrap — den aktiven Verifier für eine Chain auswählen und dessen Trust Root installieren (MsgSetVerifierBootstrap).

Dadurch kann ein Betreiber die Bridge einer verbundenen Chain direkt online bringen — oder deren Verifier rotieren —, wobei die Autorisierung gegen den Bridge-Admin-Key geprüft wird. Ab Chain-Version v3.2.0 besitzt das Bridge-Modul außerdem ein eigenes Modul-Konto (frühere Releases hatten keines, sodass die erste Einzahlung auf einer aktivierten Route fehlgeschlagen wäre).

Lizenzen wie qcb_bridge werden vom Lizenzautoritäts-Konto vergeben. Seit v3.2.3 (Mainnet) kann die Governance dieses Konto mit einem MsgUpdateAuthority-Vorschlag ersetzen; das Modul selbst ist unter Chain-Lizenzierung beschrieben.

Validierung verbundener Netzwerke​

Ab Chain-Version v3.1.79 kann ein Validator, der die passende validator_<chain>-(oder qcb_bridge-)Lizenz hält, den Client des externen Netzwerks auf demselben Node ausführen, automatisch unter QoreChains Orchestrierung bereitgestellt, sobald die Lizenz aktiviert ist. Für alle 37 Bridge-Netzwerke werden Treiber ausgeliefert, klassifiziert nach Teilnahmemodell (permissionless Validator, gedeckelt/gewählt/Zulassung, L2-Full-Node und Non-Staking/Trust-List). Stake und Signaturschlüssel des externen Netzwerks werden vom Betreiber pro Netzwerk bereitgestellt. Siehe Einen Validator betreiben für die Betreiberschritte. Da jede Chain-Konfiguration pending ist, wird heute kein verbundenes Netzwerk über die Bridge validiert.

REST-API-Endpunkte​

Der Bridge-Zustand ist schreibgeschützt über REST via grpc-gateway unter dem Präfix /qorechain/bridge/v1/... abfragbar. Diese liefern echtes On-Chain-JSON über HTTP für Explorer und Light-Node-Telemetrie. Siehe REST-/gRPC-Endpunkte für die vollständige Liste.

MethodeEndpunktBeschreibung
GET/qorechain/bridge/v1/configKonfiguration des Bridge-Moduls (min_validators, attestation_threshold, challenge_period_secs, large_transfer_threshold, enabled)
GET/qorechain/bridge/v1/chainsAlle Chain-Konfigurationen und ihr Status
GET/qorechain/bridge/v1/chains/{chain_id}Eine Chain-Konfiguration
GET/qorechain/bridge/v1/validatorsRegistrierte Bridge-Validatoren
GET/qorechain/bridge/v1/validators/{address}Ein Bridge-Validator
GET/qorechain/bridge/v1/operationsBridge-Operationen
GET/qorechain/bridge/v1/operations/{id}Eine Bridge-Operation

Gesperrte Beträge, Circuit-Breaker-Zustand und Routenschätzungen haben heute keine Abfrageroute.

Bridge-Ereignisse​

Das Bridge-Modul emittiert die folgenden On-Chain-Ereignisse:

EreignistypBeschreibung
bridge_depositNeue Einzahlungsoperation erstellt
bridge_withdrawNeue Auszahlungsoperation erstellt
bridge_attestationValidator-Attestierung eingereicht
bridge_operation_executedOperation finalisiert und ausgeführt
bridge_circuit_breaker_tripCircuit Breaker aktiviert oder deaktiviert
bridge_validator_registeredNeuer Bridge-Validator registriert
bridge_pqc_verificationPQC-Signaturverifizierungsergebnis (IBC-Pakete)

Verwandt​