Skip to main content

JSON-RPC Relay (Beta Testing)

Beta Testing Note (Write Transactions)

Hgraph's JSON-RPC relay endpoints are for beta testing only at this current time. If you plan on making many write transactions (transactions that get sent to consensus nodes), please reach out to us before testing. For questions, join our Discord.

Hgraph's new Hedera JSON-RPC relay brings new levels of EVM compatibility to the ecosystem. If you're interested in becoming an early tester, follow the steps below.

The Hedera JSON-RPC Relay enables developers to interact with the Hedera network using Ethereum-compatible JSON-RPC methods. This allows seamless integration of Ethereum-based tools, such as wallets and developer frameworks, with the Hedera blockchain. View the official repository on Hiero.

The relay follows the JSON-RPC 2.0 Specification and implements a subset of the Ethereum JSON-RPC APIs to facilitate smart contract interactions and transaction execution.

Hgraph offers reliable, fast acces to the Hedera JSON-RPC relay and will select some customers to be early beta testers.

Requirements​

Paid Plans Only After Beta

We are encouraging developer feedback during our small testing phase. When our beta testing phase is over, the JSON-RPC relay will be available on the "Developer" plan and up. View our subscription pricing plans.

The Hedera JSON-RPC relay will be available on the following Hgraph susbcription plans at launch:

  • Developer
  • Startup
  • Premium
  • Enterprise

See more information on our pricing page.

API Endpoints​

Beta testers can interact with the JSON-RPC relay through the following endpoints:

Testnet Endpoint (For Testing Only)​

https://testnet.hedera.api.hgraph.io/rpc

Mainnet Endpoint (For Testing Only)​

https://mainnet.hedera.api.hgraph.io/rpc

Note: The naming convention for API endpoints may evolve based on feedback. Currently, /rpc is used.

Authentication​

  • API requests require an API key for authentication.
  • You can obtain an API key by creating an account!

How to Use the API Key​

Include the API key in your URL for path-based authentication:

https://testnet.hedera.api.hgraph.io/v1/<YOUR_API_KEY>/rpc

Testing the Relay​

You can test the JSON-RPC relay by making a simple curl request to check the network chain ID.

Example: Get Network Chain ID​

curl --verbose -X POST \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":"2","method":"eth_chainId","params":[null]}' \
https://testnet.hedera.api.hgraph.io/v1/<YOUR_API_KEY>/rpc

Expected Response​

{
  "result": "00x127",
  "jsonrpc": "2.0",
  "id": 2,
}

Supported JSON-RPC Methods​

The relay supports a subset of Ethereum JSON-RPC methods for interacting with the Hedera network. These include:

MethodDescription
eth_chainIdReturns the chain ID of the connected network.
eth_getBlockByNumberRetrieves information about a specific block.
eth_getTransactionByHashReturns transaction details based on a transaction hash.
eth_callExecutes a smart contract read operation.
eth_sendRawTransactionSends a signed transaction to the network.

For a full list of supported methods, refer to the Hedera JSON-RPC Relay API documentation.

Become an Early Beta Tester​

  1. Sign up for an Hgraph account.
  2. Obtain your API key from Hgraph.
  3. Submit a ticket in Discord.
    • Let us know you're interested in becoming a beta tester!

For further details and technical insights, refer to the official Hedera JSON-RPC Relay GitHub repository.

Important Note

Hgraph's JSON-RPC relay endpoints are for beta testing only at this current time. If you plan on making many write transactions (transactions that get sent to consensus nodes), please reach out to us before testing. For questions, join our Discord.

Support​

For any issues or questions, contact support.