Visión general de la arquitectura
QoreChain es un nodo de blockchain modular compuesto por tres procesos principales —el nodo de cadena, el sidecar de IA y el indexador de bloques— respaldados por una base de datos Postgres y monitorizados mediante Prometheus y Grafana. La mainnet (qorechain-vladi, EVM chain ID 9801) está activa desde el 7 de junio de 2026 con la versión v3.2.3 hasta la altura 3,742,566 y v3.2.4 desde ese bloque, junto con una testnet en paralelo (qorechain-diana, EVM chain ID 9800, que ejecuta v3.2.4 desde el 19 de octubre de 2026). La cadena está construida sobre Cosmos SDK v0.53. El siguiente diagrama muestra la disposición de los componentes a alto nivel.
El ciclo de vida de las transacciones que se muestra a continuación resume cómo fluye una transacción enviada a través del nodo: desde la cadena de decoradores del AnteHandler (comprobaciones de seguridad y comisiones) hasta la ejecución en la VM y la liquidación 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) │
└───────────┘ └──────────┘
Componentes del nodo
QoreChain se ejecuta como tres procesos cooperantes, cada uno con su propio módulo Go y binario:
| Componente | Descripción | Ubicación |
|---|---|---|
| qorechain-node | El nodo principal de la blockchain. Ejecuta el QoreChain Consensus Engine, ejecuta todos los módulos personalizados, gestiona los tres entornos de ejecución de VM y expone endpoints RPC, REST, gRPC y JSON-RPC. | qorechain-core/ |
| ai-sidecar | Un servicio gRPC que proporciona capacidades avanzadas de inferencia de IA respaldadas por el QCAI Backend. El sidecar gestiona las solicitudes de inferencia que superan el alcance del agente RL on-chain, como el análisis de lenguaje natural y el reconocimiento de patrones complejos. Se comunica con el nodo a través de gRPC en el puerto 50051. | qorechain-core/sidecar/ |
| block-indexer | Un listener de WebSocket que se suscribe a nuevos bloques y transacciones desde el endpoint RPC del nodo, analiza eventos y escribe datos estructurados en una base de datos Postgres para consultas rápidas por parte de exploradores y APIs. | qorechain-core/indexer/ |
Puertos
| Puerto | Protocolo | Servicio |
|---|---|---|
| 26657 | HTTP/WebSocket | RPC del QoreChain Consensus Engine (bloques, transacciones, estado de consenso) |
| 1317 | HTTP | API REST (endpoints de consulta, difusión de transacciones) |
| 9090 | gRPC | Endpoints gRPC de consulta y transacciones |
| 8545 | HTTP | EVM JSON-RPC (espacios de nombres eth_, web3_, net_, txpool_) |
| 8546 | WebSocket | EVM JSON-RPC (suscripciones WebSocket) |
| 8899 | HTTP | SVM JSON-RPC (compatible con Solana: getAccountInfo, getBalance, getSlot, etc.) |
| 50051 | gRPC | AI Sidecar (solicitudes de inferencia desde el nodo) |
| 5432 | TCP | Postgres (almacenamiento del indexador de bloques) |
| 26660 | HTTP | Endpoint de métricas de Prometheus del nodo |
| 9091 | HTTP | Servidor Prometheus (puerto del host en el stack de Docker Compose) |
| 3001 | HTTP | Paneles de Grafana (puerto del host en el stack de Docker Compose; puerto del contenedor 3000) |
Mapa de módulos
QoreChain registra 48 módulos de génesis, 20 de ellos específicos de QoreChain, agrupados por función:
Seguridad
x/pqc— Criptografía poscuántica: Dilithium-5, ML-KEM-1024, híbrido secp256k1 (ECDSA) + ML-DSA-87, SHAKE-256, agilidad de algoritmos
IA y aprendizaje automático
x/ai— Enrutamiento de transacciones, detección de anomalías, detección de fraude, optimización de comisiones, atestación TEE, aprendizaje federadox/reputation— Puntuación de reputación de validadores multifactorial con decaimiento temporalx/rlconsensus— Agente RL on-chain (PPO MLP), diseño de ajuste del consenso, disyuntor (circuit breaker), asesoramiento de rollups — la capa de optimización PRISM (solo observación en las redes en producción: no se carga ninguna política)
Consenso
x/qca— Diseño de Triple-Pool Composite PoS (RPoS/DPoS/PoS), curva de bonding personalizada, slashing progresivo, gobernanza QDRW — implementado pero aún no conectado a la producción de bloques, las recompensas, el slashing ni el recuento de gobernanza
Máquinas virtuales
x/vm— Enrutamiento de VM y gestión del ciclo de vidax/svm— Entorno de ejecución SVM: despliegue/ejecución de BPF, recaudación de rent, RPC compatible con Solanax/crossvm— Comunicación entre VMs: precompile EVM-QoreChain Native + eventos asíncronos de SVM
Tokenomics y liquidez
x/burn— 12 fuentes de quema (13 desde v3.2.4), distribución de comisiones en EndBlocker (reparto 37/30/20/10/3)x/xqore— Diseño de staking potenciado por gobernanza: lock/unlock, penalizaciones de salida graduadas, rebase PvP (solo contabilidad; las transacciones de lock y unlock aún no están conectadas en las redes en producción)x/inflation— Emisión limitada: se acuña una cantidad fija por época hasta alcanzar un tope acumulado estricto (590.000.000 QOR)x/amm— Liquidez on-chain / creador de mercado automatizado
Puentes e interoperabilidad
x/bridge— 37 configuraciones de cadena (36 cadenas externas más Injective mediante IBC) en todos los principales tipos de cadena, atestaciones firmadas con PQC, disyuntores (todas las configuraciones enpending; no está en producción)x/babylon— Restaking de BTC mediante Babylon Protocol, checkpoints de época (fase de diseño; sin transacciones habilitadas)x/multilayer— Gestión de capas de sidechain/paychain/rollup, anclaje de estado
Extensiones de gobernanza y licencias
x/abstractaccount— Cuentas inteligentes: multifirma, recuperación social, claves de sesión, reglas de gasto (desactivado en ambas redes:enabled = false)x/fairblock— Protección MEV: framework de mempool cifrado con IBE de umbral (desactivado en ambas redes)x/gasabstraction— Diseño de pago de gas multi-token: conversión de comisiones ibc/USDC, ibc/ATOM (aún no hay ningún canal IBC abierto, por lo que las comisiones se pagan en QOR)x/license— Licenciamiento de cadenas
Rollups
x/rdk— Rollup Development Kit: 4 modos de liquidación (optimistic, zk, based, sovereign), perfiles predefinidos, DA nativo, escrow bancario
Cadena AnteHandler
Toda transacción pasa por una cadena de decoradores antes de su ejecución; cualquier decorador puede rechazarla. Hay dos cadenas.
Lane de Cosmos (en orden): RejectMessages (sin MsgEthereumTx en este lane) → AuthzLimiter (sin mensajes de EVM ni de creación de vesting dentro de authz, y desde v3.2.3 sin mensajes de gestión de claves poscuánticas) → SetUpContext → guardas de mempool y de profundidad de multifirma → decoradores de QoreChain Native de gas de simulación, contador de tx, registro de gas y contratos → CircuitBreaker → comprobación de opciones de extensión → ValidateBasic → TxTimeout → Memo → puerta de licencia de validador (MsgCreateValidator) → PQCVerify → PQCHybridVerify → PQCReplayGuard → AIAnomaly (incluye el límite de frecuencia por remitente) → FairBlock → SVMComputeBudget → SVMDeductFee → MinGasPrice → ConsumeTxSize → GasAbstraction → DeductFee → SetPubKey → ValidateSigCount → SigGasConsume → SigVerify → IncrementSequence → contador de transacciones de quema → comprobación de relay IBC redundante → seguimiento del gas solicitado.
Lane de EVM (transacciones que llevan la opción de extensión de Ethereum): CircuitBreaker → el decorador mono de EVM (comprobaciones de firma, nonce, comisión y saldo) → EVMWindowDecorator (clave poscuántica registrada y una ventana de autorización activa; consulta Ventana de autorización de EVM).
Decoradores clave en el lane de Cosmos:
- PQCVerify — Módulo
x/pqc. Verifica las firmas Dilithium-5 en transacciones marcadas como PQC. - PQCHybridVerify — Módulo
x/pqc. Verifica las firmas híbridas duales secp256k1 (ECDSA) + ML-DSA-87. - AIAnomaly — Módulo
x/ai. Ejecuta la detección de anomalías mediante isolation forest y la puntuación de riesgo, y aplica el límite de transacciones por remitente. - FairBlock — Módulo
x/fairblock. Procesa transacciones cifradas con tIBE para la protección MEV (desactivado en las redes en producción). - SVMComputeBudget — Módulo
x/svm. Valida y asigna unidades de cómputo para programas SVM. - SVMDeductFee — Módulo
x/svm. Deduce las comisiones de ejecución específicas de SVM. - GasAbstraction — Módulo
x/gasabstraction. Convierte los tokens de comisión no nativos antes de la deducción (actualmente las comisiones se pagan en QOR).
Stack de Docker Compose
El stack de desarrollo completo se ejecuta como un despliegue de Docker Compose de seis servicios sobre una red bridge compartida (qorechain-net):
| Servicio | Imagen | Propósito |
|---|---|---|
qorechain-node | qorechain-core:latest (compilada localmente a partir del Dockerfile; no hay imagen de nodo publicada) | Nodo de cadena con todos los módulos, VMs y endpoints RPC |
ai-sidecar | ghcr.io/qorechain/ai-sidecar:latest | Servicio de inferencia de IA (gRPC + QCAI Backend) |
block-indexer | ghcr.io/qorechain/block-indexer:latest | Indexador de bloques/transacciones (WebSocket + Postgres) |
postgres | postgres:16-alpine | Base de datos para el indexador de bloques |
prometheus | prom/prometheus:v3.10.0 | Recopilación y almacenamiento de métricas |
grafana | grafana/grafana:12.4.1 | Paneles de monitorización y alertas |
Inicia el stack completo:
docker compose up -d
Antes del primer arranque, copia .env.example a .env y .env.sidecar.example a .env.sidecar, y define GRAFANA_PASSWORD (Compose se niega a arrancar sin ella).
Todos los datos persistentes se almacenan en volúmenes Docker con nombre: node-data, postgres-data, prometheus-data y grafana-data.
Relacionado
- Arquitectura multicapa — registro de sidechains y anclaje de estado.
- Mecanismo de consenso — producción de bloques, finalidad y slashing.
- PRISM Consensus Engine — optimización de parámetros impulsada por IA.
- Seguridad poscuántica — firmas Dilithium-5 en todo el stack.