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).
- Legacy Transactions Only:
eth_sendRawTransactiononly 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
randomxNamespace:randomxis disabled on default public HTTP/WS modules (eth,net,web3,rogue) to prevent unauthenticated memory DoS viarandomx_setFastMode. Userogue_getConsensusStatusover HTTP, or connect via local IPC (geth.ipc) forrandomx_*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_*)
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(): Returnstrueif 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
| Medal | Level | Title | Blocks Mined | Target XP |
|---|---|---|---|---|
![]() | 0 | Unranked Runner | 0 | 1 |
![]() | 1 | Recon Runner | 1 – 24 | 25 |
![]() | 2 | Signal Scraper | 25 – 99 | 100 |
![]() | 3 | Hash Warden | 100 – 499 | 500 |
![]() | 4 | Cipher Architect | 500 – 2,499 | 2,500 |
![]() | 5 | Apex Operator | 2,500 – 9,999 | 10,000 |
![]() | 6 | Rogue Singularity | 10,000+ | 10,000 (Max) |
Click on any medal thumbnail to view it in full high resolution.






