Skip to main content

JSON-RPC API Reference

The core-rogue node exposes a fully compliant Ethereum JSON-RPC 2.0 API over HTTP (standardized port 38845, e.g. http://127.0.0.1:38845) and WebSocket (ws://127.0.0.1:38846).

RPC Security & Rate Limiting
  • Legacy Transactions Only: eth_sendRawTransaction only accepts Legacy (Type 0) transactions on Rogue Signal; typed transactions (EIP-1559 / EIP-2930 / EIP-4844) are rejected.
  • Per-IP Connection Cap: The HTTP/WS RPC server enforces a limit of 100 concurrent requests per IP (HTTP 429 Too Many Requests).
  • Protected randomx Namespace: randomx is disabled on default public HTTP/WS modules (eth,net,web3,rogue) to prevent unauthenticated memory DoS via randomx_setFastMode. Use rogue_getConsensusStatus over HTTP, or connect via local IPC (geth.ipc) for randomx_* administration.

🔌 Standard Network Endpoints​

eth_chainId​

Returns the network's chain ID in hexadecimal format (0xc3537 = 800055).

Request​

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

Response​

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

eth_blockNumber​

Returns the current highest synced block number in hexadecimal.

Request​

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

Response​

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

eth_getBalance​

Returns the balance of the given account in Wei.

Request​

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

Response​

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

net_peerCount​

Returns the number of active P2P peers connected to your node.

Request​

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

Response​

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

eth_syncing​

Returns an object with sync status data (startingBlock, currentBlock, highestBlock) while the node is syncing, or false when fully synced.

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​

Returns the current gas price in Wei (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​

Returns information about a block by block number (hex) or tag ("latest", "earliest", "pending"). Set the second parameter to true to include full transaction objects, or false for transaction hashes only.

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​

Returns the information about a transaction requested by transaction 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​

Returns the receipt of a transaction by transaction hash (including status, gasUsed, blockNumber, and emitted EVM logs).

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​

Returns the current core-rogue client version string.

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​

Returns the current network ID string ("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​

Returns true if the client is actively listening for incoming P2P connections.

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​

Returns true if the node is actively mining new blocks.

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​

Returns the current CPU mining hashrate in hashes per second (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

🛠️ Optional & Diagnostic Namespaces (txpool_*, admin_*, debug_*)​

Enabling HTTP API Namespaces

The Rogue Desktop Client automatically launches the local node with --http.api eth,net,web3,miner,txpool,admin,randomx. If you run a standalone node or need debug_* metrics, include the required namespace in --http.api. Never expose admin or debug on a public-facing interface.

txpool_status​

Returns the number of pending and queued transactions currently in the local mempool.

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​

Returns the full list of pending and queued transactions grouped by sender address and 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​

Returns node identity metadata including enode, listening ports, IP, and supported subprotocols.

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​

Returns detailed information about all connected P2P peers, capabilities, and network latency.

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​

Returns internal Go/Geth runtime metrics (memory, goroutines, chaindb, p2p). Requires --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

⚡ RandomX Consensus & Mining Endpoints (randomx_*)​

The RandomX consensus engine exposes dedicated diagnostic and control methods under both the randomx and eth namespaces. Note that external pool/work RPCs (eth_getWork, eth_submitWork, eth_submitHashrate) are permanently disabled by design to enforce full-node solo mining.

randomx_getConsensusStatus​

Returns live consensus parameters, current block height, active difficulty, block reward breakdown (25 ROGUE: 23.75 miner / 1.25 treasury), halving countdown, VM pool telemetry (vmPool), and active anti-51% security defenses (ECBP-1100 (MESS)).

Request​

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

Response​

{
"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​

Returns the current RandomX seed epoch metadata, seed block height (E * 2048 - 64), active 256-bit seed hash, and next epoch precomputation window (SeedLag = 64 blocks).

Request​

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

Response​

{
"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: Returns the node's internal RandomX CPU mining rate in hashes per second (uint64).
  • randomx_setFastMode(bool): Toggles between Light Mode (~256 MiB cache) and Fast Mode (~2080 MiB RAM dataset) for the next initialized RandomX context.
  • randomx_getFastMode(): Returns true if Fast Mode is enabled.

🏆 On-Chain Miner Reputation (RogueMinerReputation at 0x...0020)​

RogueMinerReputation (eth_call)​

Miner ranks, XP, progress (progressBps), localized rank titles (en, es, zh), and badge URIs are served directly on-chain by the RogueMinerReputation system contract deployed at Block 0 (0x0000000000000000000000000000000000000020). The legacy rogue_* RPC namespace has been retired in favor of standard EVM eth_call and on-chain STATICCALL composability.

For public consensus telemetry, use randomx_getConsensusStatus (or eth_call against 0x...0020 for PoW reputation).

Querying via Foundry cast (eth_call)​

# Get numeric level (0..6)
cast call 0x0000000000000000000000000000000000000020 \
"getMinerLevel(address)(uint32)" \
0x2fB9D05d39A1eE37Fce2F00964D3B00C0a8677c7 \
--rpc-url http://127.0.0.1:38845

# Get full stats localized in English, Spanish, or Chinese ("en", "es", "zh")
cast call 0x0000000000000000000000000000000000000020 \
"getMinerStats(address,string)((uint256,uint32,string,string,uint256,uint256,uint16))" \
0x2fB9D05d39A1eE37Fce2F00964D3B00C0a8677c7 "en" \
--rpc-url http://127.0.0.1:38845

# Check tier eligibility
cast call 0x0000000000000000000000000000000000000020 \
"meetsLevel(address,uint32)(bool)" \
0x2fB9D05d39A1eE37Fce2F00964D3B00C0a8677c7 3 \
--rpc-url http://127.0.0.1:38845

Querying from Smart Contracts (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); // Requires Hash Warden (100+ blocks)
}
}

Querying from TypeScript (viem)​

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

Progression Tiers Table​

MedalLevelTitleBlocks MinedTarget XP
Level 0 - Unranked Runner0Unranked Runner01
Level 1 - Recon Runner1Recon Runner1 – 2425
Level 2 - Signal Scraper2Signal Scraper25 – 99100
Level 3 - Hash Warden3Hash Warden100 – 499500
Level 4 - Cipher Architect4Cipher Architect500 – 2,4992,500
Level 5 - Apex Operator5Apex Operator2,500 – 9,99910,000
Level 6 - Rogue Singularity6Rogue Singularity10,000+10,000 (Max)
tip

Click on any medal thumbnail to view it in full high resolution.