Arquitectura de Seguridad de Consenso y ADRs
Este documento constituye la referencia oficial de ingeniería, seguridad y criptoeconomía (Architecture Decision Records — ADR) de Rogue Signal (Chain ID 800055). Documenta en detalle todas las capas de protección del protocolo implementadas en rogue-core-chain y rogue-desktop-client, los vectores de ataque mitigados, las alternativas de diseño evaluadas y la justificación matemática y física de cada regla de consenso.
1. Matriz Maestra de Especificaciones de Red y Seguridad
| Parámetro | Especificación Oficial | Módulo en Código | Propósito Técnico y de Seguridad |
|---|---|---|---|
| Nombre de la Red | Rogue Signal | params/config_rogue.go | Red principal EVM Proof-of-Work de Capa 1 |
| Ticker | ROGUE | Todo el ecosistema | Moneda nativa (18 decimales, 10^18 wei) |
| Chain ID / Network ID | 800055 (0xc3537) | params/config_rogue.go | Protección estricta anti-Replay (EIP-155 desde el Bloque 0) |
| Algoritmo PoW | RandomX (rx/0) | consensus/randomx/ | Resistencia a ASICs y GPUs mediante ejecución en CPU y caché L3 |
Tiempo Objetivo de Bloque (T) | 30 segundos | DefaultTargetBlockTime (difficulty.go) | Minimiza bloques huérfanos (< 0.5%) en enlaces domésticos sin Uncles |
| Recompensa Base Inicial | 25 ROGUE | InitialBaseReward (rewards.go) | Escalada 3x para bloques de 30s preservando la curva bianual |
| Distribución de Recompensa | 95% Minero / 5% Tesorería | SplitReward (rewards.go) | 23.75 ROGUE al minero / 1.25 ROGUE al fondo de desarrollo del protocolo |
| Intervalo de Halving | 2,000,000 bloques (~1.90 años) | HalvingInterval (rewards.go) | Reducción a la mitad cada 2,000,000 * 30s (~694.44 días (~1.90 años)) |
| Suministro Máximo (Hard Cap) | 100,000,000 ROGUE | MaxSupplyCap (rewards.go) | Techo matemático estricto en 32 eras (MaxHalvingEras = 32), cero tail emission |
| Ajuste de Dificultad (DAA) | LWMA-1 (N = 60) | CalculateDifficulty (difficulty.go) | Ventana móvil ponderada de 60 bloques (~30 min), clamp +-33% por bloque |
| Dificultad Mínima / Génesis | 0x10000 (65,536) | MinDifficulty (difficulty.go) | Arranque fluido para CPUs domésticas (~2.1 KH/s) |
| Regla Temporal Pasada | MTP-11 Estricto | CalculateMTP11 (difficulty.go) | header.Time > Mediana(últimos 11 bloques) |
| Deriva Temporal Futura Máxima | 30 segundos | MaxFutureDrift (difficulty.go) | header.Time <= time.Now() + 30s |
| Defensa Anti-51% (Capa 1) | ECBP-1100 (MESS) desde Bloque 0 | ECBP1100FBlock = 0 (blockchain_af.go) | Penalización polinómica exigiendo hasta 31x TD a cadenas secretas |
| Anti-Selfish Mining (Capa 2) | Desempate Eyal-Sirer | ReorgNeeded (forkchoice.go) | Preserva bloque local o desempata con crypto/rand (50/50) |
| Política de Bloques Uncle | Prohibidos (ErrUnclesNotAllowed) | VerifyUncles / verifyHeader | Modelo Bitcoin puro (header.UncleHash == EmptyUncleHash) |
| Rotación de Semilla RandomX | 2048 bloques (~17.07 horas) | EpochLength (epoch.go) | Época estándar rx/0 con SeedLag = 64 bloques (~32 min precomputación) |
Tamaño Máximo de ExtraData | 64 bytes | MaxExtraDataSize (randomx.go) | Permite etiquetas descriptivas e impide ataques de Header Bloat DoS |
| Límite de Gas por Bloque | 50,000,000 gas (0x2faf080) | genesis_rogue.go / miner.go | Alta capacidad EVM por cada bloque de 30 segundos |
| Modelo de Comisiones EVM | PoW Clásico (100% al Minero) | config_rogue.go / ethconfig | Sin quema EIP-1559; solo tx legacy (tipo 0); 100% de comisiones al minero |
| Precio Mínimo de Gas (TxPool) | 1 Gwei (10^9 wei) | eth/ethconfig/config.go | Protección anti-spam de transacciones gratuitas en mempool P2P (límite RAM 128 MB) |
| Hash del Bloque Génesis (Bloque 0) | 0xde4c5e747fbb072d39db2ece5a245e46b6164045e166301dfdba78f86cfbe4dd | RogueGenesisHash (genesis_rogue.go) | Fijado en RequireBlockHashes[0] para aislamiento criptográfico P2P |
| Inscripción del Bloque Génesis | ROGUE::800055 // THE_SILICON_BELONGS_TO_THE_MANY // 09.11.26 | genesis.json / genesis_rogue.go | Inscripción fundacional de 60 bytes grabada en el Bloque 0 |
2. Registro de Decisiones de Diseño (ADRs)
ADR-001: Aumento del Tiempo Objetivo de Bloque de 10s a 30s y Escalado Monetario
Contexto y Problema
En una red Proof-of-Work global que aplica un árbol de bloques estricto estilo Bitcoin (cero bloques Uncle/Ommer permitidos, ErrUnclesNotAllowed), el hallazgo de bloques sigue un proceso de Poisson sin memoria donde la probabilidad de encontrar un bloque en menos de tau segundos es:
P(delta_t < tau) = 1 - exp(-tau / T)
- Con
T = 10 segundos, el 18.1% de los bloques se descubren en< 2 segundosy el 9.5% en< 1 segundo. - Dado que la propagación P2P intercontinental sumada a la verificación CGo de RandomX (~15-25 ms por salto en Light Mode) y la ejecución de estado EVM requiere entre
300 msy1.5 segundos, un intervalo de 10 segundos sin recompensas Uncle genera colisiones frecuentes (bloques huérfanos). Esto penaliza desproporcionadamente a los mineros domésticos frente a nodos en centros de datos de baja latencia.
Decisión Adoptada
- Aumentar
DefaultTargetBlockTimede10a30segundos enconsensus/randomx/difficulty.go:- Con
T = 30s, la probabilidad de colisión en< 1scae del9.5%al3.2%, reduciendo la tasa global de bloques huérfanos a< 0.5%.
- Con
- Escalado Monetario Proporcional (
3x) enconsensus/randomx/rewards.go:- Recompensa Base Inicial (
InitialBaseReward): Sube de8 ROGUEa25 ROGUEpor bloque (23.75 ROGUEpara el minero [95%] y1.25 ROGUEpara la tesorería del protocolo [5%]). - Intervalo de Halving (
HalvingInterval): Se ajusta de6,300,000bloques a2,000,000bloques (~1.90 años a 30s/bloque:2,000,000 * 30s = 60,000,000 segundos~694.44 días). - Invarianza del Suministro Total:
El calendario bianual de halvings y el suministro máximo de ~100M ROGUE permanecen 100% invariantes.Suministro Total = sum_{k=0..31} (25 / 2^k) * 2,000,000 = 100,000,000 ROGUE (100M Hard Cap Exacto)
- Recompensa Base Inicial (
ADR-002: Arquitectura Anti-Monopolio y Anti-Sybil — Por Qué se Adoptó el Estándar Puro Probado frente a Reglas de Enfriamiento (Cooldown) Artificiales
Contexto y Alternativas Evaluadas
Se analizó si el protocolo debía imponer un tope de hashrate por máquina o una regla de enfriamiento por dirección (Coinbase Cooldown) acompañada de un requisito de antigüedad (Bond Anti-Sybil / Historical Lookback) para evitar que máquinas potentes acaparen la minería.
Se evaluaron en detalle tres diseños alternativos antes de tomar la decisión arquitectónica final:
- Alternativa Evaluada A — Enfriamiento Duro por Ventana Deslizante (
Coinbase Cooldown):- Concepto: Rechazar en
VerifyHeadercualquier bloque cuya direcciónheader.Coinbaseya hubiera minado>= 2bloques en los últimos10bloques (con válvula de escape tras 90s de inactividad) y pausar automáticamente el minero local durante el enfriamiento. - Razón de Descarte: Dado que PoW es un proceso de Poisson sin memoria, incluso en una red con 10 mineros domésticos idénticos, un minero honesto encuentra naturalmente 3 bloques consecutivos por pura varianza estadística. Pausar su CPU o rechazar bloques válidos desperdicia seguridad termodinámica honesta, retrasa o retiene rendimientos legítimos e introduce casos borde de vivacidad (liveness).
- Concepto: Rechazar en
- Alternativa Evaluada B — Cuota de Antigüedad por Mirada Histórica de Cabeceras (
Header-Lookback) y Auto-Bonding sin Saldo Previo:- Interrogante Explorada: ¿Cómo podría exigirse antigüedad o garantía Anti-Sybil si los nuevos mineros entran a la red con saldo
0 ROGUE? - Mecanismos Evaluados:
- Antigüedad por Cabeceras (
[N-100, N-11]): En lugar de exigir saldo previo en elStateDB(lo cual rompe el Header Sync sin estado e impone una barrera de entrada imposible para usuarios nuevos), una dirección adquiere estatus de "Cuenta con Antigüedad" automáticamente tras minar 1 solo bloque que madure más allá de 10 bloques ([N-100, N-11]). Las direcciones nuevas (0 ROGUE) tienen permitido minar hasta el50%de cualquier ventana de 10 bloques (MaxFreshMinerBlocksInWindow = 5) tras un arranque inicial de 50 bloques, mientras las cuentas con antigüedad compiten por el 100% de los bloques bajo el enfriamiento por dirección. - Auto-Bonding en Protocolo: Retener automáticamente una fracción del primer bloque minado en el contrato de bóveda durante
FinalizeAndAssemble.
- Antigüedad por Cabeceras (
- Razón de Descarte: Aunque la mirada histórica
[N-100, N-11]resuelve limpiamente el problema del saldo cero sin tocar elStateDB, cualquier cuota artificial sobre direcciones nuevas sigue estrangulando la producción de bloques cuando se incorporan oleadas legítimas de nuevos mineros domésticos.
- Interrogante Explorada: ¿Cómo podría exigirse antigüedad o garantía Anti-Sybil si los nuevos mineros entran a la red con saldo
- Alternativa Evaluada C — Amortiguación Suave de Dificultad por Minero:
- Concepto: Incrementar un
+10%la dificultad objetivo para una direcciónCoinbaseque repita bloques dentro de una ventana corta. - Razón de Descarte: Los operadores avanzados eluden trivialmente el recargo rotando direcciones de su billetera HD, penalizando únicamente al usuario doméstico que mina hacia una sola dirección fija.
- Concepto: Incrementar un
Decisión Adoptada: El Estándar Puro Probado (Descentralización Física y de Protocolo en 4 Capas)
Siguiendo los estándares probados en combate de Monero, Bitcoin y Ethereum Classic, se eliminaron todas las pausas artificiales y restricciones de rendimiento (cada bloque PoW válido recibe el 100% de su recompensa de inmediato y el usuario puede asignar libremente el 100% de los hilos de su CPU). En su lugar, las granjas de servidores y el hardware especializado quedan neutralizados mediante 4 barreras estructurales:
- Cuello de Botella Físico de Caché L3 en RandomX (
rx/0): Cada hilo de minería exige 2 MiB de caché L3 exclusiva en la CPU y acceso aleatorio constante a un dataset de 2080 MiB en RAM. Los ASICs no pueden sintetizar código máquina dinámico aleatorio, las GPUs sufren penalizaciones severas por divergencia de ramificación, y los servidores multi-socket ven limitada su eficiencia por el ancho de banda del bus de memoria. - Eliminación Total de Stratum y RPCs de Minería Remota (
eth_getWorkDeshabilitado): Enconsensus/randomx/api.go, el puente Stratum y los métodoseth_getWork,eth_submitWorkyeth_submitHashrateestán deshabilitados permanentemente. Una granja no puede conectar 500 workers ligeros (XMRig) a un solo nodo central: cada máquina que mine debe ejecutar un nodo EVM completo sincronizado (core-rogue) con su propia base de datos y su propio dataset RandomX en memoria. - Intervalo de Bloque de 30 Segundos: Elimina la ventaja de latencia P2P de la fibra óptica de centros de datos frente a conexiones domésticas.
- LWMA-1 (
N=60) + ECBP-1100 (MESS): Neutraliza ataques del 51% con CPUs alquiladas en la nube y ataques de coin-hopping.
ADR-003: Defensa Anti-51% (ECBP-1100 MESS + Anti-Selfish Mining)
Contexto y Problema
Las redes PoW jóvenes minadas por CPU enfrentan la amenaza de que un atacante alquile servidores en la nube durante una hora, mine una bifurcación privada en aislamiento (Secret Shadow Chain) y la transmita de golpe para ejecutar una reorganización profunda (Long-Range 51% Attack / Doble Gasto).
Decisión Adoptada
Implementamos ECBP-1100 (MESS) Puro + Desempate Anti-Selfish Mining Activo desde el Bloque 0 en core/forkchoice.go, core/blockchain.go y params/config_rogue.go:
- Capa 1 — Finalidad Artificial ECBP-1100 (MESS):
- Las bifurcaciones secretas tardías enfrentan una penalización de gravedad polinómica cúbica que exige hasta
31xla dificultad de la subcadena local, sin bloquear de forma rígida a los nodos honestos ante sincronizaciones profundas o particiones legítimas (MaxReorgDeptheliminado).
- Las bifurcaciones secretas tardías enfrentan una penalización de gravedad polinómica cúbica que exige hasta
- Capa 2 — Penalización Exponencial Subjetiva (
ECBP-1100 MESSencore/blockchain_af.goyeth/sync.go):- Activada desde el Bloque 0 (
ECBP1100FBlock = 0enRogueChainConfigy habilitada por defecto enNewBlockChain). - Para bifurcaciones de profundidad
1..90, MESS aplica un multiplicador de gravedad polinómico cúbico basado en la antigüedad del ancestro común (delta_t = current.Time - commonAncestor.Time), exigiendo que una cadena secreta acumule hasta31xla dificultad de la subcadena local para ser aceptada. - Calibrada con
artificialFinalitySafetyInterval = 30 * 30 * time.Second(15 minutos / 30 bloques Rogue), evitando falsas detecciones de cadenas obsoletas durante la varianza normal de bloques PoW.
- Activada desde el Bloque 0 (
- Capa 3 — Desempate Anti-Selfish Mining (Regla Eyal-Sirer en
core/forkchoice.go):- Cuando
externTd == localTD, el nodo preserva su propio bloque minado localmente (currentPreserve) o desempata entre bloques externos mediante selección aleatoria criptográfica 50/50 (crypto/rand).
- Cuando
ADR-004: Defensas contra Time-Warp, Manipulación de Dificultad Propia y Flash-Mining
- Independencia del Timestamp Candidato en
LWMA-1:- En
consensus/randomx/difficulty.go,CalculateDifficulty(chain, time, parent)calcula la dificultad del bloqueNexclusivamente a partir de los bloques históricos cerrados[N-k .. N-1]. Un minero no puede manipular elheader.Timede su bloque candidato para reducir su propia dificultad.
- En
- Verificación Determinista de Ancestros:
- Si falta algún bloque ancestro intermedio en la ventana de observación de LWMA-1,
CalculateDifficultyretorna deterministamenteconsensus.ErrUnknownAncestoren lugar de caer en fallbacks silenciosos con dificultades desactualizadas.
- Si falta algún bloque ancestro intermedio en la ventana de observación de LWMA-1,
- Acotamiento de Solvetime y Clamping por Bloque (
+-33%):- Los tiempos de resolución individuales en la ventana LWMA-1 de 60 bloques se acotan a
[1s, 6 * T = 180s], y el cambio de dificultad por bloque se restringe entre el67%(MaxClampDownFactor) y el133%(MaxClampUpFactor) deparent.Difficulty.
- Los tiempos de resolución individuales en la ventana LWMA-1 de 60 bloques se acotan a
- Regla Estricta
MTP-11+30sde Deriva Futura Máxima + Alineación enPrepare():VerifyHeaderTimeexigeheader.Time > CalculateMTP11(chain, parent)yheader.Time <= now + 30.- En
RandomX.Prepare(consensus/randomx/randomx.go), si marcas de tiempo desordenadas en los últimos 11 bloques provocan queheader.Time <= CalculateMTP11(chain, parent),Prepareadelanta automáticamenteheader.Time = mtp + 1para que el minero local jamás selle un bloque que violeErrOlderBlockTime.
ADR-005: Seguridad de Memoria CGo, Concurrencia de Contextos y VerifyHeaders Paralelo en Dos Fases
- Corrección de Bug
Use-After-Freey Defensa ante Nil-VM enRxContext.CalculateHash(consensus/randomx/rx_cgo.go):ctx.mu.RLock()se mantiene activo mediantedefer ctx.mu.RUnlock()durante toda la ejecución deCalculateHash, impidiendo quectx.Close()libere la memoria C++ del dataset/cache mientras algún hilo continúa calculando un hash.CalculateHashverifica de forma defensiva el tipo de interfaz y punteros crudos C (!ok || vm == nil || vm.raw == nil), devolviendo un error estructurado en lugar de provocar fallos de segmentación o panics bajo presión de memoria.
- Límite de Concurrencia de Épocas y Acotamiento de Contextos (
consensus/randomx/epoch.go):EpochManagerutiliza un semáforo interno (allocSem, capacidad 2) para limitar asignaciones CGo concurrentes de dataset, protegiendo a los nodos de ataques DoS por agotamiento de RAM ante anuncios de cabeceras en conflicto.- Los contextos en caché están estrictamente acotados a
MaxCachedContexts = 3con desalojo LRU por época. - Se eliminó el borrado prematuro de contextos en
GetSeedentre ramas que compiten, asegurando que los hilos mineros locales jamás se interrumpan durante sincronizaciones por lotes de bifurcaciones secundarias.
- Precomputación de Dataset Amigable con la CPU (
NewFastDataset):- La inicialización del dataset de 2080 MiB utiliza
max(1, runtime.NumCPU() / 2)goroutines para que la precomputación en segundo plano durante la ventanaSeedLagde 64 bloques (~32 minutos) deje libre el 50% de la CPU para la red P2P y el minado activo.
- La inicialización del dataset de 2080 MiB utiliza
VerifyHeadersParalelo Fail-Fast en Dos Fases, Límite ExtraData y Prohibición de Tíos:- Fase 1 (Fail-Fast en microsegundos): Valida las reglas ligeras (
len(header.Extra) <= 64,header.UncleHash == EmptyUncleHash,MTP-11 + 30s drift, dificultadLWMA-1,GasUsed <= GasLimity rechazo de campos opcionales no nulos de bifurcaciones inactivas) antes de invocar CGo. - Fase 2 (Pool Paralelo de Workers): Distribuye
VerifySealentreruntime.NumCPU()goroutines en paralelo, acelerando la sincronización inicial de cabeceras y mitigando ataques DoS de agotamiento de CPU.
- Fase 1 (Fail-Fast en microsegundos): Valida las reglas ligeras (
ADR-006: Anclaje Génesis P2P, Protección Anti-Spam del Mempool y Blindaje RPC en Desktop
- Anclaje Criptográfico del Bloque Génesis (
RequireBlockHashes[0]):- El Bloque 0 (timestamp
1762711936/0x6910d980, inscripción"ROGUE::800055 // THE_SILICON_BELONGS_TO_THE_MANY // 09.11.26") produce el hash canónico:0xde4c5e747fbb072d39db2ece5a245e46b6164045e166301dfdba78f86cfbe4dd - Anclado en
RogueChainConfig.RequireBlockHashes[0](params/config_rogue.go) y sincronizado engenesis.json.
- El Bloque 0 (timestamp
- Suelo Anti-Spam del Mempool (
TxPool):TxPool.PriceLimity elGasPricedel minero se fijan por defecto en1 Gwei(10^9 wei) conGasCeil = 50,000,000(eth/ethconfig/config.go,miner/miner.go).
- Blindaje RPC y CORS en
rogue-desktop-client:- En
rogue-desktop-client/src-tauri/src/process_manager.rs,--http.corsdomainy--ws.originsse restringen atauri://localhost,http://tauri.localhost,http://localhost:1420,http://127.0.0.1:1420y se elimina el módulo legadopersonal.
- En
- Diagnóstico de Consenso en Tiempo Real y Controles Idempotentes:
- Se añadieron
randomx_getEpochInfoyrandomx_getConsensusStatus(consensus/randomx/api.go) exponiendo métricas en vivo de consenso, época, recompensas y finalidad. - Los métodos de control como
randomx_setFastModese validaron como idempotentes a través deRandomX,EpochManageryAPI.
- Se añadieron