Panoramica dell'Architettura
QoreChain è un nodo blockchain modulare composto da tre processi principali — il nodo della chain, il sidecar AI e l'indicizzatore di blocchi — supportati da un database Postgres e monitorati tramite Prometheus e Grafana. La mainnet (qorechain-vladi, EVM chain ID 9801) è attiva dal 7 giugno 2026 sulla release v3.2.3 fino all'altezza 3.742.566 e sulla v3.2.4 da quel blocco, con una testnet parallela (qorechain-diana, EVM chain ID 9800, che esegue la v3.2.4 dal 19 ottobre 2026). La chain è costruita su Cosmos SDK v0.53. Il diagramma seguente mostra la disposizione di alto livello dei componenti.
Il ciclo di vita della transazione riportato di seguito riassume come una transazione inviata attraversa il nodo — dalla catena di decorator dell'AnteHandler (controlli di sicurezza e delle commissioni) all'esecuzione nella VM e al regolamento on-chain:
┌────────────────────────────────────────────────────────────────────────────┐
│ QoreChain Node │
│ │
│ ┌──────────────────── Virtual Machines ──────────────────────┐ │
│ │ ┌───────┐ ┌──────────┐ ┌───────┐ │ │
│ │ │ EVM │ │QoreChain │ │ SVM │ │ │
│ │ │(Sol.) │◄──►│ Native │◄──►│ (BPF) │ │ │
│ │ └───┬───┘ └────┬─────┘ └───┬───┘ │ │
│ │ └─────────┬───┘──────────────┘ │ │
│ │ x/crossvm (bridge) │ │
│ └────────────────────────────────────────────────────────────┘ │
│ │
│ ┌────────────────────── Tokenomics ─────────────────────────┐ │
│ │ ┌──────┐ ┌───────┐ ┌───────────┐ │ │
│ │ │x/burn│ │x/xqore│ │x/inflation│ │ │
│ │ │12 src│ │lock/ │ │capped │ │ │
│ │ │37/30/│ │unlock │ │emission │ │ │
│ │ │20/10/│ │PvP │ │emission │ │ │
│ │ │3 │ │ │ │590M cap │ │ │
│ │ └──────┘ └───────┘ └───────────┘ │ │
│ └────────────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────── IBC / Bridges ────────────────────────────────┐ │
│ │ ┌──────────┐ ┌──────────┐ ┌───────────┐ ┌──────────┐ │ │
│ │ │x/bridge │ │x/babylon │ │x/abstract │ │x/gas │ │ │
│ │ │37 QCB │ │BTC re- │ │ account │ │abstract. │ │ │
│ │ │configs │ │staking │ │session key│ │multi-tok │ │ │
│ │ └────┬─────┘ └────┬─────┘ └───────────┘ └──────────┘ │ │
│ │ QCB Bridge Babylon IBC ERC-4337-like ibc/USDC │ │
│ │ PQC-signed BTC finality social recov. ibc/ATOM │ │
│ │ 36 ext chains checkpoint spending rules fee convert │ │
│ │ ┌──────────┐ │ │
│ │ │x/fair │ Lane config (not enforced): PQC|MEV|AI|... │ │
│ │ │ block │ tIBE encrypted mempool framework │ │
│ │ └──────────┘ │ │
│ └────────────────────────────────────────────────────────────┘ │
│ │
│ ┌──── Rollup Development Kit ───────────────────────────────┐ │
│ │ ┌──────────┐ ┌──────────┐ ┌───────────┐ ┌──────────┐ │ │
│ │ │ x/rdk │ │Settlement│ │ DA Router │ │ Profiles │ │ │
│ │ │ 4 modes: │ │Optimistic│ │ Native │ │ defi │ │ │
│ │ │ opt/zk/ │ │ZK/Based/ │ │ Celestia* │ │ gaming │ │ │
│ │ │ based/ │ │Sovereign │ │ Both │ │ nft │ │ │
│ │ │ sovereign│ │ │ │ │ │ social/ │ │ │
│ │ │ │ │ │ │ │ │ general │ │ │
│ │ └────┬─────┘ └────┬─────┘ └───────────┘ └──────────┘ │ │
│ │ Bank escrow Auto-finalize SHAKE-256 commit AI-assisted │ │
│ │ Burn on create EndBlocker Blob pruning PRISM sugg. │ │
│ │ → x/multilayer (RegisterSidechain + AnchorState) │ │
│ └────────────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────┐ ┌──────┐ ┌────────────┐ ┌─────┐ │
│ │x/rlconsensus │ │ x/ai │ │x/reputation│ │x/qca│ │
│ │ PRISM (RL) │ │ │ │ │ │ │ │
│ └──────┬───────┘ └──┬───┘ └────┬──────┘ └──┬──┘ │
│ PPO MLP AI Engine Scoring CPoS Pools │
│ Obs/Action Fraud Det. Decay Bonding │
│ Circuit Brk Fee Opt. Sigmoid Slashing │
│ Rollup Adv. TEE/FL QDRW Gov │
│ │
│ ┌──────┐ ┌──────────┐ │
│ │x/pqc │ │ x/multi │ │
│ └──┬───┘ └────┬─────┘ │
│ Dilithium Layer Router │
│ ML-KEM Sidechains │
│ Hybrid Sig + Rollups │
│ SHAKE-256 │
│ │
│ ┌──────┐ ┌───────┐ │
│ │x/svm │ │x/cross│ │
│ └──┬───┘ └───┬───┘ │
│ BPF Exec CrossVM Msg │
└────────┬──────┬───────────────────────────────────────┬───────────────────┘
│ │ │
┌─────┴─────┐│ ┌───────┴──────┐
│libqorepqc ││ │ Indexer │
│(Rust PQC) ││ │ (Postgres) │
└───────────┘│ └──────────────┘
┌───────────┐│ ┌──────────┐
│libqoresvm ││ │AI Sidecar│
│(Rust BPF) │└──│ (gRPC) │
└───────────┘ └──────────┘
Componenti del Nodo
QoreChain viene eseguito come tre processi cooperanti, ciascuno con il proprio modulo Go e il proprio binario:
| Componente | Descrizione | Posizione |
|---|---|---|
| qorechain-node | Il nodo blockchain principale. Esegue il QoreChain Consensus Engine, esegue tutti i moduli personalizzati, gestisce tutti e tre i runtime VM ed espone endpoint RPC, REST, gRPC e JSON-RPC. | qorechain-core/ |
| ai-sidecar | Un servizio gRPC che fornisce capacità avanzate di inferenza AI supportate dal QCAI Backend. Il sidecar gestisce le richieste di inferenza che superano l'ambito dell'agente RL on-chain, come l'analisi del linguaggio naturale e il riconoscimento di pattern complessi. Comunica con il nodo tramite gRPC sulla porta 50051. | qorechain-core/sidecar/ |
| block-indexer | Un listener WebSocket che si sottoscrive ai nuovi blocchi e alle transazioni dall'endpoint RPC del nodo, analizza gli eventi e scrive dati strutturati in un database Postgres per query rapide da parte di explorer e API. | qorechain-core/indexer/ |
Porte
| Porta | Protocollo | Servizio |
|---|---|---|
| 26657 | HTTP/WebSocket | RPC del QoreChain Consensus Engine (blocchi, transazioni, stato del consenso) |
| 1317 | HTTP | API REST (endpoint di query, broadcast delle transazioni) |
| 9090 | gRPC | Endpoint gRPC per query e transazioni |
| 8545 | HTTP | EVM JSON-RPC (namespace eth_, web3_, net_, txpool_) |
| 8546 | WebSocket | EVM JSON-RPC (sottoscrizioni WebSocket) |
| 8899 | HTTP | SVM JSON-RPC (compatibile con Solana: getAccountInfo, getBalance, getSlot, ecc.) |
| 50051 | gRPC | AI Sidecar (richieste di inferenza dal nodo) |
| 5432 | TCP | Postgres (archiviazione dell'indicizzatore di blocchi) |
| 26660 | HTTP | Endpoint delle metriche Prometheus del nodo |
| 9091 | HTTP | Server Prometheus (porta host nello stack Docker Compose) |
| 3001 | HTTP | Dashboard Grafana (porta host nello stack Docker Compose; porta del container 3000) |
Mappa dei Moduli
QoreChain registra 48 moduli di genesis, 20 dei quali specifici di QoreChain, raggruppati per funzione:
Sicurezza
x/pqc— Crittografia post-quantistica: Dilithium-5, ML-KEM-1024, ibrida secp256k1 (ECDSA) + ML-DSA-87, SHAKE-256, agilità algoritmica
AI e Machine Learning
x/ai— Routing delle transazioni, rilevamento di anomalie, rilevamento di frodi, ottimizzazione delle commissioni, attestazione TEE, apprendimento federatox/reputation— Punteggio di reputazione multi-fattore dei validatori con decadimento temporalex/rlconsensus— Agente RL on-chain (PPO MLP), design di tuning del consenso, circuit breaker, advisory per i rollup — il livello di ottimizzazione PRISM (solo osservazione sulle reti attive: nessuna policy è caricata)
Consenso
x/qca— Design del Triple-Pool Composite PoS (RPoS/DPoS/PoS), bonding curve personalizzata, slashing progressivo, governance QDRW — implementato ma non ancora collegato alla produzione dei blocchi, alle ricompense, allo slashing né al conteggio dei voti di governance
Macchine Virtuali
x/vm— Routing delle VM e gestione del ciclo di vitax/svm— Runtime SVM: distribuzione/esecuzione BPF, riscossione del rent, RPC compatibile con Solanax/crossvm— Comunicazione cross-VM: precompile EVM-QoreChain Native + eventi asincroni SVM
Tokenomics e Liquidità
x/burn— 12 fonti di burn (13 dalla v3.2.4), distribuzione delle commissioni nell'EndBlocker (suddivisione 37/30/20/10/3)x/xqore— Design di staking potenziato dalla governance: lock/unlock, penalità di uscita graduate, rebase PvP (solo contabilità; le transazioni di lock e unlock non sono ancora collegate sulle reti attive)x/inflation— Emissione con tetto: un importo fisso viene coniato a ogni epoca fino al raggiungimento di un tetto cumulativo rigido (590.000.000 QOR)x/amm— Liquidità on-chain / market maker automatizzato
Bridge e Interoperabilità
x/bridge— 37 configurazioni di chain (36 chain esterne più Injective tramite IBC) per ogni tipo di chain principale, attestazioni firmate con PQC, circuit breaker (tutte le configurazioni sonopending; non attive)x/babylon— Restaking BTC tramite Babylon Protocol, checkpoint di epoca (fase di design; nessuna transazione abilitata)x/multilayer— Gestione dei livelli di sidechain/paychain/rollup, ancoraggio dello stato
Estensioni di Governance e Licensing
x/abstractaccount— Smart account: multisig, social recovery, session key, regole di spesa (disattivato su entrambe le reti:enabled = false)x/fairblock— Protezione MEV: framework di mempool cifrato con threshold IBE (disattivato su entrambe le reti)x/gasabstraction— Design del pagamento del gas multi-token: conversione delle commissioni ibc/USDC, ibc/ATOM (nessun canale IBC è ancora aperto, quindi le commissioni si pagano in QOR)x/license— Licensing della chain
Rollup
x/rdk— Rollup Development Kit: 4 modalità di settlement (optimistic, zk, based, sovereign), profili preconfigurati, DA native, escrow bancario
Catena AnteHandler
Ogni transazione passa attraverso una catena di decorator prima dell'esecuzione; qualsiasi decorator può rifiutarla. Esistono due catene.
Lane Cosmos (in ordine): RejectMessages (nessun MsgEthereumTx su questa lane) → AuthzLimiter (nessun messaggio EVM o di creazione di vesting dentro authz, e dalla v3.2.3 nessun messaggio di gestione delle chiavi post-quantistiche) → SetUpContext → protezioni su mempool e profondità multisig → decorator QoreChain Native per simulation-gas, tx-counter, gas-register e contratti → CircuitBreaker → controllo dell'extension option → ValidateBasic → TxTimeout → Memo → gate della licenza validatore (MsgCreateValidator) → PQCVerify → PQCHybridVerify → PQCReplayGuard → AIAnomaly (include il rate limit per mittente) → FairBlock → SVMComputeBudget → SVMDeductFee → MinGasPrice → ConsumeTxSize → GasAbstraction → DeductFee → SetPubKey → ValidateSigCount → SigGasConsume → SigVerify → IncrementSequence → contatore delle transazioni di burn → controllo del relay IBC ridondante → tracciamento del gas richiesto.
Lane EVM (transazioni che portano l'extension option di Ethereum): CircuitBreaker → il decorator monolitico EVM (controlli di firma, nonce, commissioni e saldo) → EVMWindowDecorator (chiave post-quantistica registrata e finestra di autorizzazione attiva; vedi Finestra di autorizzazione EVM).
Decorator principali sulla lane Cosmos:
- PQCVerify — Modulo
x/pqc. Verifica le firme Dilithium-5 sulle transazioni contrassegnate come PQC. - PQCHybridVerify — Modulo
x/pqc. Verifica le firme ibride duali secp256k1 (ECDSA) + ML-DSA-87. - AIAnomaly — Modulo
x/ai. Esegue il rilevamento di anomalie con isolation forest e il punteggio di rischio, e applica il limite di transazioni per mittente. - FairBlock — Modulo
x/fairblock. Elabora le transazioni cifrate con tIBE per la protezione MEV (disattivato sulle reti attive). - SVMComputeBudget — Modulo
x/svm. Convalida e alloca le compute unit per i programmi SVM. - SVMDeductFee — Modulo
x/svm. Deduce le commissioni di esecuzione specifiche di SVM. - GasAbstraction — Modulo
x/gasabstraction. Converte i token di commissione non nativi prima della deduzione (le commissioni sono attualmente pagate in QOR).
Stack Docker Compose
L'intero stack di sviluppo viene eseguito come un deployment Docker Compose a sei servizi su una rete bridge condivisa (qorechain-net):
| Servizio | Immagine | Scopo |
|---|---|---|
qorechain-node | qorechain-core:latest (costruita localmente dal Dockerfile; nessuna immagine del nodo pubblicata) | Nodo della chain con tutti i moduli, le VM e gli endpoint RPC |
ai-sidecar | ghcr.io/qorechain/ai-sidecar:latest | Servizio di inferenza AI (gRPC + QCAI Backend) |
block-indexer | ghcr.io/qorechain/block-indexer:latest | Indicizzatore di blocchi/transazioni (WebSocket + Postgres) |
postgres | postgres:16-alpine | Database per l'indicizzatore di blocchi |
prometheus | prom/prometheus:v3.10.0 | Raccolta e archiviazione delle metriche |
grafana | grafana/grafana:12.4.1 | Dashboard di monitoraggio e alerting |
Avvia l'intero stack:
docker compose up -d
Prima del primo avvio, copia .env.example in .env e .env.sidecar.example in .env.sidecar, e imposta GRAFANA_PASSWORD (Compose rifiuta di avviarsi senza).
Tutti i dati persistenti sono archiviati in volumi Docker denominati: node-data, postgres-data, prometheus-data e grafana-data.
Correlati
- Architettura Multilayer — registrazione delle sidechain e ancoraggio dello stato.
- Meccanismo di Consenso — produzione dei blocchi, finalità e slashing.
- Motore di Consenso PRISM — ottimizzazione dei parametri guidata dall'AI.
- Sicurezza Post-Quantistica — firme Dilithium-5 in tutto lo stack.