JSON-RPC Relay
Last updated
Was this helpful?
Last updated
Was this helpful?
The is an open-source project implementing the EVM JSON-RPC standard. It allows developers to interact with Hedera nodes using familiar EVM tools, allowing developers and users to deploy, query, and execute contracts as they usually would. Check out the interactive and a simple .
The Hiero JSON RPC Relay msg.value uses 18 decimals when it returns HBAR. As a result, the gasPrice value returns 18 decimal places since it is only utilized from the JSON RPC Relay. Refer to the for a list of Hiero APIs and the decimal places they return.
When interacting with smart contracts on Hedera, developers have several options for setting up a JSON RPC Relay. Each choice comes with unique advantages and trade-offs based on your project's needs, scalability, and operational preferences.
: It provides a built-in JSON RPC Relay and simulates the Hedera network environment locally. This option is ideal for quick prototyping, debugging, and isolated testing without external dependencies. It's ideal if you want to run extensive and repeated tests without having to worry about running out of testnet HBAR.
: Running your own JSON RPC Relay offers complete control over configurations and network selection (testnet, previewnet, mainnet). It is best suited for projects requiring flexibility, high reliability, and scalability, especially in production environments.
: Several third-party providers offer managed JSON RPC Relay services with different levels of reliability, service-level agreements (SLAs), and fee structures. These services remove infrastructure maintenance overhead, allowing teams to focus more on development (you can find the list of supported services ).
Infrastructure Management
Minimal
Required
None
Reliability and Stability
High (local)
High
Variable by SLA
Scalability
/ (local)
Flexible
Variable by provider
Setup Complexity
Low to Medium
Medium to High
Low
Ideal Use Case
Testing & Development
Testing & Production
Builders who prefer convenience & Production
Read the post to learn more about the different options!
Anyone in the community can set up their own JSON RPC relay that applications can use to deploy, query, and execute smart contracts. The list of community-hosted Hiero JSON RPC relays and endpoints for previewnet, testnet, and mainnet can be found in the table below, as well as their associated docs or websites.
Mainnet
295
Testnet
296
Previewnet
297
**
**
**
Hashio is for development and testing purposes only. Production use cases are strongly encouraged to use or host their own instance of the .
If you want to add your hosted JSON-RPC relay to this list, please open an issue in the . Please visit the community-hosted websites to review any limitations specific to their instance.
The configuration guide to connect to the Hedera Network over RPC can be found .
The endpoints for previewnet, testnet, and mainnet can be found on , accessible through the website. Feel free to join the discussion on for more questions.
The JSON-RPC Relay msg.value uses 18 decimals when it returns HBAR. The gasPrice value also returns 18 decimal places. Check out the for the full list of Hedera APIs and their decimal representation.
To contribute or log errors, please refer to the and submit them as issues in the .
