R5 Network
WebsiteR5 LabsGitHub
  • Getting Started
    • Hello & Welcome!
  • About R5
    • Overview
    • R5 Components
    • Consensus Mechanism
    • zkNet (Privacy)
  • R5 Coin
  • R5 Tokenomics
  • Tutorials & Guides
    • Connect & Use R5
      • R5 Desktop Wallet
      • MetaMask
      • Rabby Wallet
      • Coinbase Wallet
    • zkNet Web Wallet
    • R5 Desktop Wallet
      • Interface Overview
      • Send a Transaction
      • Receive a Transaction
      • Backup Your Wallet
      • Retrieve Your Private Key
    • How To: Deploy a Node
    • How To: Mine R5
    • How To: GPU Mine R5
    • How To: Build R5 From Source
    • How To: Connect Local Nodes
  • For Developers
    • R5 SDK
      • R5 Relayer
      • R5 Console
      • JS Console
      • CLI Wallet
      • SCdev
      • SSL Proxy
    • Hardware Requirements
    • R5 Testnet
    • R5 Devnet
    • Local Networks
    • JSON-RPC API
      • admin
      • debug
      • ethash
      • miner
      • net
      • r5 (eth)
      • rpc
      • txpool
      • web3
    • Indexer API
    • zkNet API
    • Node Configuration
    • Ethash-R5
    • Smart Contracts
    • Wrapped R5 (Native)
    • Tokens & NFTs
  • Bug Bounty Program
  • Resources
    • Website
    • R5 Labs
    • R5 Labs GitHub
Powered by GitBook
On this page
  • Overview
  • admin Namespace
  • debug Namespace
  • ethash Namespace
  • miner Namespace
  • net Namespace
  • r5 (eth) Namespace
  • rpc Namespace
  • txpool Namespace
  • web3 Namespace
  1. For Developers

JSON-RPC API

PreviousLocal NetworksNextadmin

Last updated 2 months ago

Overview

The RPC API provides a JSON‑RPC interface for interacting with an R5 node. Applications and dapps can call these endpoints to query blockchain data, send transactions, and perform a variety of operations. You can use the to interact directly with the API in the same way as an application would.

By default, R5 RPC nodes expose only the following APIs:

  • r5 (eth)

  • web3

  • net

Other namespaces such as admin, miner, debug, and ethash are usually not open on RPC for security reasons. They contain sensitive functions for node administration, mining control, and internal debugging, and are typically accessible only in a controlled environment. You can still access these endpoints via the .

Below is a brief overview of each namespace. (Click the corresponding button to navigate to the full subpage for detailed endpoint documentation.)


admin Namespace

Contains endpoints for administering node‑level operations, such as managing peers, retrieving node information, and controlling the RPC/HTTP/WS servers. For security reasons, these endpoints are typically restricted and not exposed on public RPC nodes by default.


debug Namespace

Offers a suite of endpoints designed for detailed internal debugging and performance analysis. These methods provide insights into the node’s execution, database, memory, and other internal operations. They are intended for development and troubleshooting and are usually disabled on production RPC nodes.


ethash Namespace

Provides specific endpoints to interact with the Ethash proof‑of‑work (PoW) process. These endpoints allow miners to obtain the current work package, monitor mining hashrate, and submit proof‑of‑work details for validation.


miner Namespace

Includes methods to control and monitor the mining process. You can start or stop mining, set mining parameters like Etherbase, extra data, gas limits, and gas price, and check the current mining hashrate. Due to their sensitive nature, these endpoints are normally not available on public RPC nodes.


net Namespace

Provides endpoints to obtain network‑related information. You can use these methods to check if the node is listening for connections, view the number of connected peers, and retrieve the network ID. This helps in diagnosing connectivity issues and verifying network status.


r5 (eth) Namespace

Provides all standard Ethereum‑compatible methods to interact with the blockchain. Endpoints in this namespace (e.g. r5_getBalance, r5_sendTransaction) enable you to query account balances, retrieve block or transaction details, and broadcast transactions. It is fully compatible with EVM dapps.


rpc Namespace

The rpc namespace provides endpoints for retrieving information about the node's JSON-RPC server itself. These endpoints let you query the list of available modules and their versions, giving you insight into the RPC capabilities exposed by your R5 node.


txpool Namespace

The txpool namespace provides RPC endpoints for inspecting and managing the node's transaction pool. These endpoints enable you to view pending and queued transactions, as well as check the current status of the transaction pool, ensuring you have full visibility into the transaction processing state.


web3 Namespace

Offers a collection of utility functions and helper methods for interacting with the node. This includes retrieving client version details, performing various data conversions (e.g. between ASCII, UTF‑8, hexadecimal, and wei), and handling BigNumber operations. These utilities are commonly used by front‑end applications and dapps.

R5 Console
JS Console
admin
debug
ethash
miner
net
r5 (eth)
web3