Arhitectura podului
Modulul x/bridge este conceput pentru a conecta QoreChain la ecosistemul blockchain mai larg prin 37 de configurații de lanț (36 de lanțuri externe plus Injective, accesat prin IBC) și până la 8 contrapărți IBC (Inter-Blockchain Communication). Fiecare operațiune a podului este concepută să fie securizată prin criptografie post-cuantică.
Modulul podului este implementat pe mainnet și testnet, dar nicio rută de pod nu este activă: toate cele 37 de configurații de lanț sunt în starea pending, fără contract de pod setat, nu este înregistrat niciun validator de pod, nu a fost creată vreodată nicio operațiune de pod și nu există niciun canal IBC pe mainnet (testnet-ul are un singur canal de test ICS-20 către un lanț cu ID provider, niciunul către contrapărțile de mai jos). Tot ce urmează descrie designul intenționat. Nu trimiteți active așteptând să fie transferate prin pod.
Starea curentă
| Mainnet | Testnet | |
|---|---|---|
| Modulul podului | activat | activat |
| Configurații de lanț | 37, toate pending | 37, toate pending |
| Validatori de pod înregistrați | 0 | 0 |
| Operațiuni de pod | 0 | 0 |
| Canale / clienți IBC | 0 / 0 | 1 / 1 (un canal de test către testnet-ul Cosmos Hub) |
(Verificat la 27 octombrie 2026 pe mainnet (atunci v3.2.4; v3.2.6 de la 4 la 12 noiembrie 2026, v3.2.7 din 12 noiembrie 2026) și testnet (atunci v3.2.6; v3.2.8 din 12 noiembrie 2026). Citiți valorile live cu qorechaind query bridge chains și qorechaind query bridge validators, sau prin REST la /qorechain/bridge/v1/chains și /qorechain/bridge/v1/validators.) Configurația modulului este aceeași pe ambele rețele: min_validators 10, attestation_threshold 7, challenge_period_secs 86,400 și large_transfer_threshold 100.000 QOR (100000000000 uqor). Stiva IBC pe care ar folosi-o modulul este ibc-go v10.7 (începând cu v3.2.2), dar nu a fost creat niciun client sau canal pe mainnet (testnet-ul are un client și un canal de test, vezi mai sus).
Prezentare generală a conexiunilor
QoreChain este conceput să susțină două protocoale de pod care funcționează în paralel:
| Protocol | Conexiuni | Model de securitate | Caz de utilizare |
|---|---|---|---|
| IBC | până la 8 canale (niciunul deschis) | IBC standard (ICS-20) | Lanțuri compatibile Cosmos SDK |
| QCB | 37 configurații de lanț (toate pending) | Multisig Dilithium-5 7-din-10 | Lanțuri non-IBC (EVM, Solana, TON etc.) |
Cele 37 de configurații de lanț sunt cele 36 de lanțuri externe enumerate mai jos plus Injective, configurat ca lanț de tip IBC. Nu există o configurație loopback pentru QoreChain. Canalele IBC planificate se conectează la lanțuri compatibile Cosmos SDK.
Canale IBC
QoreChain este conceput să mențină conexiuni IBC către următoarele 8 lanțuri, retransmise de un releu IBC. Niciuna dintre aceste contrapărți nu este încă conectată (mainnet-ul nu are niciun canal sau client IBC; testnet-ul are un singur canal de test ICS-20 către un lanț cu ID provider, verificat la 27 octombrie 2026), deci acest tabel enumeră doar contrapărțile planificate:
| Lanț | Descriere |
|---|---|
| Cosmos Hub | Conexiune principală de hub |
| Osmosis | Rutarea lichidității DEX |
| Noble | Emisiune nativă USDC |
| Celestia | Strat de disponibilitate a datelor |
| Stride | Liquid staking |
| Akash | Calcul descentralizat |
| Babylon | Protocol de restaking BTC |
| Injective | Interoperabilitate DeFi / orderbook |
Releul IBC
Pachetele IBC și actualizările de client sunt transportate între lanțuri de un releu, un program separat care urmărește ambele lanțuri și trimite pachetele, dovezile și actualizările de client. Releul nu face parte din lanț, iar acest manual nu promite un serviciu de releu rulat de QoreChain. QoreChain întreține un releu open-source numit QORel (un fork al Hermes care adaugă semnătura hibridă ML-DSA-87 pe care QoreChain o cere pentru fiecare tranzacție); versiunea 0.1.0 este lansată ca pre-lansare. Vezi QORel pentru a-l instala și a-l rula.
- Actualizările de client, monitorizarea comportamentului necorespunzător și curățarea pachetelor sunt setări ale oricărui releu rulat de un operator, nu parametri ai lanțului. De exemplu, un releu poate reîmprospăta automat clienții light, poate urmări echivocația și poate curăța periodic pachetele în așteptare.
- Semnături post-cuantice. Tranzacțiile pe care QoreChain le acceptă pe lane-ul nativ poartă o semnătură hibridă secp256k1 + ML-DSA-87 (FIPS 204), inclusiv tranzacțiile pe care un releu i le trimite; vezi Securitate post-cuantică. Formatul pachetului IBC în sine este cel standard, iar acest manual nu afirmă că pachetele poartă o semnătură suplimentară pe care o verifică alte lanțuri.
Protocolul QCB (QoreChain Bridge)
Protocolul QCB folosește o arhitectură hub-and-spoke securizată prin criptografie post-cuantică. QoreChain acționează ca hub, cu o configurație de tip spoke pentru fiecare lanț extern.
Configurații de lanțuri externe (36)
Protocolul QCB este conceput să țintească următoarele 36 de lanțuri externe. Împreună cu Injective (o configurație de tip IBC), aceasta rezultă în 37 de configurații de lanț în total, toate aflate în prezent în starea pending.
Lanțuri de bază (10)
Ethereum, Solana, TON, BSC, Avalanche, Polygon, Arbitrum, Optimism, Base, Sui.
Lanțuri din familia EVM (14)
zkSync Era, Linea, Scroll, Blast, Mantle, Hyperliquid, Berachain, Sonic, Sei, Monad, Plasma, Filecoin FVM, Cronos, Kaia.
Lanțuri non-EVM (5)
Starknet, XRP Ledger, Stellar, Hedera, Algorand.
Alte lanțuri (7)
NEAR, Bitcoin, Cardano, Polkadot, Tezos, Tron, Aptos.
Verificare a numărului: 10 de bază + 14 din familia EVM + 5 non-EVM + 7 alte lanțuri = 36 de lanțuri externe. Adăugând Injective (IBC) rezultă 37 de configurații de lanț.
Formate de adresă
Protocolul QCB clasifică lanțurile după tip pentru a valida adresele de destinație:
| Tip de lanț | Lanțuri exemplu | Format de adresă |
|---|---|---|
evm | Ethereum, BSC, Avalanche, Polygon, Arbitrum, Optimism, Base | 0x + 40 de caractere hex |
solana | Solana | Base58, 32-44 de caractere |
ton | TON | EQ + codificat base64 |
sui_move | Sui | 0x + 64 de caractere hex |
aptos_move | Aptos | 0x + 64 de caractere hex |
bitcoin | Bitcoin | Bech32 (bc1), P2SH (3...) sau legacy (1...) |
near | NEAR Protocol | sufix .near sau implicit |
cardano | Cardano | addr1 (plată) sau stake1 (staking) |
polkadot | Polkadot | codificat SS58 |
tezos | Tezos | tz1/tz2/tz3 (implicit) sau KT1 (originat) |
tron | TRON | T + base58, 34 de caractere |
Clienți light
Pentru a verifica evenimentele de pe lanțurile externe fără încredere, podul este conceput să ruleze clienți light on-chain adaptați la sistemul de consens și de probe al fiecărui lanț sursă. Acești clienți light permit QoreChain să valideze depozitele și retragerile fără a se baza exclusiv pe atestările validatorilor.
| Client light | Lanț sursă | Primitive de verificare |
|---|---|---|
| Client light Ethereum | Ethereum / EVM L1 | Verificare de semnătură BLS12-381, serializare SSZ, probe de stare MPT |
| Bitcoin SPV | Bitcoin | Simplified Payment Verification față de antetele blocurilor |
| Starknet STARK | Starknet | Verificare de probe STARK a tranzițiilor de stare Starknet |
| Sui BLS | Sui | Verificare de semnătură agregată BLS a checkpoint-urilor Sui |
| Wormhole / Solana VAA | Solana (prin Wormhole) | Verificare de semnătură de gardian Verified Action Approval (VAA) |
Fluxul de depozit (extern către QoreChain)
Secvența de mai jos prezintă depozitul QCB așa cum este conceput: activele sunt blocate pe un lanț extern, validatorii QoreChain trimit atestări semnate PQC (7-din-10 Dilithium-5), iar token-urile wrapped sunt emise. Lanțurile compatibile Cosmos SDK ar folosi în schimb calea IBC paralelă (până la 8 canale, transportate de un releu IBC). Niciuna dintre căi nu este activă; nu a fost făcut niciodată vreun depozit.
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 |
- Blocare — Utilizatorul blochează activele în contractul podului de pe lanțul extern.
- Atestare — Validatorii podului observă tranzacția de blocare și trimit atestări semnate Dilithium-5. Este necesar un minim de 7 din 10 atestări de validator. Acolo unde un client light este disponibil pentru lanțul sursă, evenimentul de blocare este verificat suplimentar față de propriile probe ale lanțului.
- Emitere — Odată ce pragul de atestare este atins, token-urile wrapped sunt emise pe QoreChain.
- Perioadă de contestare — Pentru transferurile care depășesc echivalentul a 100.000 QOR, se aplică o perioadă de contestare de 24 de ore înainte de execuție. În acest interval, validatorii pot semnala activitate suspectă.
Fluxul de retragere (QoreChain către extern)
QoreChain QoreChain Validators External Chain
| | |
| 1. Burn wrapped tokens | |
|------------------------>| |
| | 2. Attest burn |
| | (7/10 PQC sigs) |
| |------------------------->|
| | | 3. Unlock original
| | | assets
- Ardere — Utilizatorul arde token-urile wrapped pe QoreChain.
- Atestare — Validatorii atestă evenimentul de ardere cu semnături Dilithium-5 (prag 7/10).
- Deblocare — Odată ce pragul este atins, activele originale sunt deblocate pe lanțul extern.
Toate taxele de pod colectate în timpul retragerilor sunt direcționate către modulul x/burn prin canalul de ardere bridge_fee (100% din taxele de pod sunt arse).
Retrageri L2 → L1 (rollup-uri)
Retragerile din rollup nu folosesc podul. Ele sunt plătite de modulul x/rdk cu execute-withdrawal față de rădăcina retragerilor unui lot finalizat — vezi ZK / STARK și retrageri.
Arhitectura de securitate
Multisig PQC
Toate operațiunile podului QCB necesită un prag de 7-din-10 semnături post-cuantice Dilithium-5 de la validatorii de pod înregistrați. Fiecare validator de pod se înregistrează cu:
- O adresă de validator QoreChain
- O cheie publică Dilithium-5 (2.592 de octeți)
- O listă de lanțuri suportate
- Un scor de reputație (menținut de
x/reputation)
Începând cu v3.2.2, modulul validează consecvent sumele zero și configurația sa pe fiecare cale. De la v3.2.4 (pe mainnet din 23 octombrie 2026, pe testnet din 19 octombrie 2026): înregistrarea unui validator de pod necesită și o dovadă de posesie a cheii Dilithium-5 (același format proof_of_possession ca la înregistrarea cheii PQC, vezi Securitate post-cuantică) și refuză o cheie pe care o folosește deja alt validator de pod. Versiunile anterioare nu au o astfel de verificare, iar pe niciuna dintre rețele nu este înregistrat vreun validator de pod.
Disjunctoare (circuit breakers)
Fiecare lanț conectat are protecții independente de tip disjunctor:
| Protecție | Descriere |
|---|---|
| Limita per transfer | Suma maximă pentru orice operațiune individuală de pod per lanț |
| Limita zilnică agregată | Plafon de volum total per lanț per fereastră de 24 de ore |
| Pauză manuală | Oprire de urgență per lanț declanșată de guvernanță sau validator |
| Detectarea anomaliilor | Pauză automată dacă >50 de operațiuni într-o fereastră scurtă sau volumul depășește de 5x limita zilnică |
Starea disjunctorului este urmărită per lanț și include: transferul unic maxim, limita zilnică, utilizarea zilnică curentă, înălțimea ultimei resetări și starea de pauză cu motiv.
Perioada de contestare
Pentru transferurile mari (>100.000 echivalent QOR, configurabil prin large_transfer_threshold):
- O perioadă de contestare de 24 de ore (86.400 de secunde) se aplică după ce pragul de atestare este atins.
- În acest interval, validatorii sunt concepuți să poată semnala operațiunea.
- Dacă nu este contestată, operațiunea se execută automat după expirarea perioadei.
- Operațiunile contestate sunt înghețate pentru revizuire de către guvernanță.
Optimizarea traseelor prin AI
Modulul podului se integrează cu subsistemul AI pentru optimizarea rutelor (neexpus prin REST). Pentru transferurile care pot traversa mai multe căi (de exemplu, lanțul A către lanțul B prin intermediul unui intermediar), optimizatorul de traseu evaluează:
- Taxele estimate pe rute
- Timpul estimat de finalizare
- Scorul de securitate per cale
- Nivelul de încredere al estimării
Administrarea podului
Activarea lanțurilor post-implementare (fără guvernanță)
Începând cu versiunea de lanț v3.1.78, un lanț de pod poate fi activat și reconfigurat după implementare cu o singură tranzacție semnată — fără propunere de guvernanță și fără upgrade de lanț. O cheie bridge_admin (setată în BridgeConfig.BridgeAdmin la genesis) sau un deținător al licenței qcb_bridge poate:
tx bridge update-chain-config— setează adresa de contract, numărul de confirmări, arhitectura și statusul unui lanț (MsgUpdateChainConfig).tx bridge set-verifier-bootstrap— selectează verificatorul activ pentru un lanț și instalează rădăcina sa de încredere (MsgSetVerifierBootstrap).
Aceasta permite unui operator să aducă online podul unui lanț conectat — sau să-i rotească verificatorul — direct, cu autorizarea verificată față de cheia de administrator al podului. Începând cu versiunea de lanț v3.2.0, modulul podului are și propriul cont de modul (versiunile anterioare nu aveau, așa că primul depozit pe o rută activată ar fi eșuat).
Licențe precum qcb_bridge sunt acordate de contul autorității de licențiere. Începând cu v3.2.3 (mainnet), guvernanța poate înlocui acel cont cu o propunere MsgUpdateAuthority; modulul în sine este descris în Licențiere de lanț.
Validarea rețelelor conectate
Începând cu versiunea de lanț v3.1.79, un validator care deține licența validator_<chain> (sau qcb_bridge) corespunzătoare poate rula clientul rețelei externe pe același nod, provizionat automat sub orchestrarea QoreChain odată ce licența este activată. Driverele sunt livrate pentru toate cele 37 de rețele de pod, clasificate după modelul de participare (validator permissionless, plafonat/ales/admitere, full-node L2 și non-staking/listă de încredere). Stake-ul și cheile de semnare ale rețelei externe sunt furnizate de operator pentru fiecare rețea. Consultați Rulează un validator pentru pașii operatorului. Deoarece fiecare configurație de lanț este pending, în prezent nicio rețea conectată nu este validată prin pod.
Endpoint-uri REST API
Starea podului poate fi interogată read-only prin REST via grpc-gateway sub prefixul /qorechain/bridge/v1/.... Acestea servesc JSON real on-chain prin HTTP pentru exploratoare și telemetrie de noduri light. Consultați Endpoint-uri REST / gRPC pentru lista completă.
| Metodă | Endpoint | Descriere |
|---|---|---|
| GET | /qorechain/bridge/v1/config | Configurația modulului podului (min_validators, attestation_threshold, challenge_period_secs, large_transfer_threshold, enabled) |
| GET | /qorechain/bridge/v1/chains | Toate configurațiile de lanț și starea lor |
| GET | /qorechain/bridge/v1/chains/{chain_id} | O configurație de lanț |
| GET | /qorechain/bridge/v1/validators | Validatorii de pod înregistrați |
| GET | /qorechain/bridge/v1/validators/{address} | Un validator de pod |
| GET | /qorechain/bridge/v1/operations | Operațiunile podului |
| GET | /qorechain/bridge/v1/operations/{id} | O operațiune a podului |
Sumele blocate, starea disjunctoarelor și estimările de rută nu au în prezent nicio rută de interogare.
Evenimente ale podului
Modulul podului emite următoarele evenimente on-chain:
| Tip de eveniment | Descriere |
|---|---|
bridge_deposit | Operațiune de depozit nouă creată |
bridge_withdraw | Operațiune de retragere nouă creată |
bridge_attestation | Atestare de validator trimisă |
bridge_operation_executed | Operațiune finalizată și executată |
bridge_circuit_breaker_trip | Disjunctor activat sau dezactivat |
bridge_validator_registered | Validator de pod nou înregistrat |
bridge_pqc_verification | Rezultatul verificării semnăturii PQC (pachete IBC) |
Înrudite
- Transferul activelor prin pod — mută activele între lanțuri pas cu pas.
- Restaking BTC prin Babylon — securitate susținută de Bitcoin.
- Securitate post-cuantică — verificare PQC pe pachetele IBC.