Saltar al contenido principal

Referencia de la API JSON-RPC

El nodo core-rogue expone una interfaz JSON-RPC 2.0 totalmente compatible con Ethereum sobre HTTP (puerto estandarizado 38845, p. ej. http://127.0.0.1:38845) y WebSocket (ws://127.0.0.1:38846).

Seguridad RPC y Limitación de Tasa
  • Solo Transacciones Heredadas: eth_sendRawTransaction únicamente acepta transacciones Legacy (Type 0) en Rogue Signal; las transacciones tipadas (EIP-1559 / EIP-2930 / EIP-4844) son rechazadas.
  • Límite de Conexiones por IP: El servidor RPC HTTP/WS aplica un límite de 100 peticiones concurrentes por IP (HTTP 429 Too Many Requests).
  • Namespace randomx Protegido: randomx está deshabilitado en los módulos públicos HTTP/WS por defecto (eth,net,web3,rogue) para evitar DoS de memoria sin autenticación mediante randomx_setFastMode. Usa rogue_getConsensusStatus por HTTP, o conéctate vía IPC local (geth.ipc) para administración con randomx_*.

🔌 Métodos Principales de la Red​

eth_chainId​

Devuelve el identificador único de la cadena en formato hexadecimal (0xc3537 = 800055).

Petición​

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}' \
http://127.0.0.1:38845

Respuesta​

{
"jsonrpc": "2.0",
"id": 1,
"result": "0xc3537"
}

eth_blockNumber​

Devuelve el número del bloque más reciente sincronizado en formato hexadecimal.

Petición​

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' \
http://127.0.0.1:38845

Respuesta​

{
"jsonrpc": "2.0",
"id": 1,
"result": "0x4b20"
}

eth_getBalance​

Devuelve el saldo disponible en la dirección indicada expresado en Wei.

Petición​

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x4290352A98018e61294F9c2794D0A50F59530590", "latest"],"id":1}' \
http://127.0.0.1:38845

Respuesta​

{
"jsonrpc": "2.0",
"id": 1,
"result": "0x6f05b59d3b20000"
}

net_peerCount​

Devuelve el número de pares (peers) P2P conectados actualmente al nodo.

Petición​

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":1}' \
http://127.0.0.1:38845

Respuesta​

{
"jsonrpc": "2.0",
"id": 1,
"result": "0x12"
}

eth_syncing​

Devuelve un objeto con el progreso de sincronización (startingBlock, currentBlock, highestBlock) mientras el nodo sincroniza, o false cuando está completamente al día.

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}' \
http://127.0.0.1:38845

eth_gasPrice​

Devuelve el precio actual del gas en Wei (formato hexadecimal).

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":1}' \
http://127.0.0.1:38845

eth_getBlockByNumber​

Devuelve la información de un bloque por número (hex) o etiqueta ("latest", "earliest", "pending"). El segundo parámetro indica si incluir los objetos completos de las transacciones (true) o solo sus hashes (false).

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["latest", false],"id":1}' \
http://127.0.0.1:38845

eth_getTransactionByHash​

Devuelve los detalles de una transacción consultada por su hash.

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0x..."],"id":1}' \
http://127.0.0.1:38845

eth_getTransactionReceipt​

Devuelve el recibo de una transacción minada por su hash (incluyendo status, gasUsed, blockNumber y logs emitidos por la EVM).

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["0x..."],"id":1}' \
http://127.0.0.1:38845

web3_clientVersion​

Devuelve la cadena de versión actual del cliente core-rogue.

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":1}' \
http://127.0.0.1:38845

net_version​

Devuelve el identificador de la red como cadena ("800055").

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":1}' \
http://127.0.0.1:38845

net_listening​

Devuelve true si el nodo está escuchando activamente conexiones P2P entrantes.

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":1}' \
http://127.0.0.1:38845

eth_mining​

Devuelve true si el nodo está minando bloques activamente.

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"eth_mining","params":[],"id":1}' \
http://127.0.0.1:38845

eth_hashrate​

Devuelve el hashrate actual de minería CPU en hashes por segundo (hexadecimal).

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"eth_hashrate","params":[],"id":1}' \
http://127.0.0.1:38845

🛠️ Namespaces Opcionales y Diagnóstico (txpool_*, admin_*, debug_*)​

Habilitación de Namespaces en HTTP API

El Cliente de Escritorio Rogue inicia automáticamente el nodo local con --http.api eth,net,web3,miner,txpool,admin,randomx. Si ejecutas un nodo independiente o necesitas métricas debug_*, añade el namespace requerido en --http.api. Nunca expongas admin o debug en una interfaz pública.

txpool_status​

Devuelve el conteo de transacciones pendientes (pending) y en cola (queued) dentro del mempool local.

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"txpool_status","params":[],"id":1}' \
http://127.0.0.1:38845

txpool_content​

Devuelve el listado completo de transacciones pendientes y en cola agrupadas por dirección remitente y nonce.

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"txpool_content","params":[],"id":1}' \
http://127.0.0.1:38845

admin_nodeInfo​

Devuelve los metadatos de identidad del nodo incluyendo enode, puertos de escucha, IP y subprotocolos soportados.

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"admin_nodeInfo","params":[],"id":1}' \
http://127.0.0.1:38845

admin_peers​

Devuelve información detallada de todos los pares P2P conectados, capacidades y latencia de red.

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"admin_peers","params":[],"id":1}' \
http://127.0.0.1:38845

debug_metrics​

Devuelve métricas internas del runtime Go/Geth (memoria, goroutines, chaindb, p2p). Requiere --http.api ...,debug.

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"debug_metrics","params":[true],"id":1}' \
http://127.0.0.1:38845

⚡ Métodos de Consenso y Minería RandomX (randomx_*)​

El motor de consenso RandomX expone métodos dedicados de diagnóstico y control bajo los namespaces randomx y eth. Nota: los métodos RPC de minería externa (eth_getWork, eth_submitWork, eth_submitHashrate) están deshabilitados permanentemente por diseño para garantizar la minería exclusiva con nodo completo.

randomx_getConsensusStatus​

Devuelve en tiempo real los parámetros de consenso, altura de bloque actual, dificultad activa, desglose de recompensa (25 ROGUE: 23.75 minero / 1.25 tesorería), cuenta regresiva para el halving, telemetría del pool de VMs (vmPool) y defensas Anti-51% activas (ECBP-1100 (MESS)).

Petición​

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"randomx_getConsensusStatus","params":[],"id":1}' \
http://127.0.0.1:38845

Respuesta​

{
"jsonrpc": "2.0",
"id": 1,
"result": {
"algorithm": "RandomX (rx/0)",
"targetBlockTime": 30,
"lwmaWindow": 60,
"mtpWindow": 11,
"maxFutureDrift": 30,
"maxExtraDataSize": 64,
"finalityMode": "ECBP-1100 (MESS)",
"messActive": true,
"unclesAllowed": false,
"remoteMiningAllowed": false,
"currentBlock": 120,
"currentEra": 0,
"halvingInterval": 2000000,
"blocksUntilHalving": 1999880,
"blockRewardWei": "25000000000000000000",
"minerRewardWei": "23750000000000000000",
"treasuryRewardWei": "1250000000000000000",
"treasuryAddress": "0xe9aae535b7971a9ac8c6af0e4b524d02260d3a03",
"fastMode": false,
"localHashrate": 1450,
"vmPool": {
"totalVMs": 2,
"activeVMs": 0,
"mode": "light",
"allocatedMemoryMB": 256
}
}
}

randomx_getEpochInfo​

Devuelve los metadatos de la época de semilla RandomX actual, el bloque semilla (E * 2048 - 64), el hash de semilla activo de 256 bits y la ventana de precomputación de la siguiente época (SeedLag = 64 bloques).

Petición​

curl -X POST -H "Content-Type: application/json" \
--data '{"jsonrpc":"2.0","method":"randomx_getEpochInfo","params":[],"id":1}' \
http://127.0.0.1:38845

Respuesta​

{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockNumber": 120,
"epoch": 0,
"epochLength": 2048,
"seedLag": 64,
"seedBlock": 0,
"seedHash": "0xde4c5e747fbb072d39db2ece5a245e46b6164045e166301dfdba78f86cfbe4dd",
"nextEpochBlock": 2048,
"blocksRemaining": 1928,
"nextSeedBlock": 1984,
"nextSeedReady": false,
"fastMode": false
}
}

randomx_getHashrate / randomx_setFastMode / randomx_getFastMode​

  • randomx_getHashrate: Devuelve la tasa de hash interna del minero RandomX del nodo en hashes por segundo (uint64).
  • randomx_setFastMode(bool): Alterna entre Light Mode (~256 MiB en caché) y Fast Mode (~2080 MiB de dataset en RAM) para el siguiente contexto RandomX inicializado.
  • randomx_getFastMode(): Devuelve true si el modo rápido está habilitado.

🏆 Reputación de Mineros On-Chain (RogueMinerReputation en 0x...0020)​

RogueMinerReputation (eth_call)​

Los rangos, XP, progreso (progressBps), títulos localizados (en, es, zh) y URIs de medallas se sirven directamente on-chain desde el contrato de sistema RogueMinerReputation desplegado en el Bloque 0 (0x0000000000000000000000000000000000000020). El namespace legado rogue_* fue retirado en favor de eth_call estándar y composabilidad EVM mediante STATICCALL.

Para telemetría pública de consenso, usa randomx_getConsensusStatus (o eth_call contra 0x...0020 para reputación PoW).

Consulta con Foundry cast (eth_call)​

# Obtener nivel numérico (0..6)
cast call 0x0000000000000000000000000000000000000020 \
"getMinerLevel(address)(uint32)" \
0x2fB9D05d39A1eE37Fce2F00964D3B00C0a8677c7 \
--rpc-url http://127.0.0.1:38845

# Obtener estadísticas completas localizadas ("en", "es", "zh")
cast call 0x0000000000000000000000000000000000000020 \
"getMinerStats(address,string)((uint256,uint32,string,string,uint256,uint256,uint16))" \
0x2fB9D05d39A1eE37Fce2F00964D3B00C0a8677c7 "es" \
--rpc-url http://127.0.0.1:38845

# Comprobar elegibilidad de rango
cast call 0x0000000000000000000000000000000000000020 \
"meetsLevel(address,uint32)(bool)" \
0x2fB9D05d39A1eE37Fce2F00964D3B00C0a8677c7 3 \
--rpc-url http://127.0.0.1:38845

Consulta desde Contratos Inteligentes (STATICCALL)​

import {IRogueMinerReputation} from "./interfaces/IRogueMinerReputation.sol";

contract MinerGatedService {
IRogueMinerReputation constant REPUTATION =
IRogueMinerReputation(0x0000000000000000000000000000000000000020);

function accessTieredFeature(address miner) external view returns (bool) {
return REPUTATION.meetsLevel(miner, 3); // Requiere Hash Warden (100+ bloques)
}
}

Consulta desde TypeScript (viem)​

const stats = await publicClient.readContract({
address: "0x0000000000000000000000000000000000000020",
abi: rogueReputationAbi,
functionName: "getMinerStats",
args: [minerAddress, "es"],
});

Tabla de Rangos y Medallas de Progresión​

MedallaNivelTítuloBloques MinadosXP Objetivo
Nivel 0 - Unranked Runner0Unranked Runner01
Nivel 1 - Recon Runner1Recon Runner1 – 2425
Nivel 2 - Signal Scraper2Signal Scraper25 – 99100
Nivel 3 - Hash Warden3Hash Warden100 – 499500
Nivel 4 - Cipher Architect4Cipher Architect500 – 2,4992,500
Nivel 5 - Apex Operator5Apex Operator2,500 – 9,99910,000
Nivel 6 - Rogue Singularity6Rogue Singularity10,000+10,000 (Máx)
consejo

Haz clic en cualquier miniatura de medalla para verla en resolución completa ultra nítida.