Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -263,6 +263,14 @@
"hedera/tutorials/more-tutorials/HSM-signing/azure-key-vault",
"hedera/tutorials/more-tutorials/HSM-signing/gcp-kms"
]
},
{
"group": "JSON RPC Connections",
"pages": [
"hedera/tutorials/more-tutorials/json-rpc-connections",
"hedera/tutorials/more-tutorials/json-rpc-connections/hashio",
"hedera/tutorials/more-tutorials/json-rpc-connections/validation-cloud"
]
}
]
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -462,10 +462,10 @@ The plugin uploads the source code and metadata to Sourcify and you should recei
<Card title="Editor: Krystal, Senior DX Engineer">
[Github](https://github.com/theekrystallee) | [X](https://x.com/theekrystallee)
</Card>
<Card title="Editor: Logan, Software Engineer II" arrow>
<Card title="Editor: Logan, Senior Software Engineer" arrow>
[GitHub](https://github.com/quiet-node) | [LinkedIn](https://www.linkedin.com/in/logann131/)
</Card>
<Card title="Editor: Jake, DevRel Engineer" arrow>
<Card title="Editor: Jake, Senior DevRel Engineer" arrow>
[GitHub](https://github.com/jaycoolh) | [X](https://x.com/jaycoolh)
</Card>
<Card title="Editor: Michiel, DevRel Engineer" arrow>
Expand Down
66 changes: 51 additions & 15 deletions hedera/tutorials/more-tutorials/json-rpc-connections.mdx
Original file line number Diff line number Diff line change
@@ -1,34 +1,70 @@
---
title: "How to Connect to Hedera Networks Over RPC"
description: "Compare the available JSON-RPC providers for Hedera and pick the right endpoint for your project."
mode: "wide"
---

There are four options to establish a connection to Hedera Networks. Validation Cloud, Arkhia, and Hashio are all managed JSON-RPC providers; the Hedera JSON-RPC Relay is for running your own local JSON-RPC instance. Hashio is a Hedera community service offered by [Hashgraph](https://www.hashgraph.com/) that has limited capabilities.
The [JSON-RPC Relay](https://github.com/hiero-ledger/hiero-json-rpc-relay) is the open-source service that bridges EVM-style JSON-RPC clients (MetaMask, ethers.js, web3.js, Hardhat, Foundry, viem, etc.) to the Hedera network. You have three ways to access it: use the free public instance ([Hashio](/hedera/tutorials/more-tutorials/json-rpc-connections/hashio)), use a managed third-party provider, or run your own instance.

**➡** [**Hashio**](/hedera/tutorials/more-tutorials/json-rpc-connections/hashio)
## Choose a connection option

**➡** [**Hiero JSON-RPC Relay**](https://github.com/hiero-ledger/hiero-json-rpc-relay)
<CardGroup cols={2}>
<Card title="Hashio" icon="bolt" href="/hedera/tutorials/more-tutorials/json-rpc-connections/hashio">
Free public Hiero JSON-RPC Relay instance hosted by Hashgraph. No sign-up required. Best for prototyping and tutorials. Rate-limited.
</Card>

**➡** [**Validation Cloud**](/hedera/tutorials/more-tutorials/json-rpc-connections/validation-cloud)
<Card title="Validation Cloud" icon="cloud" href="/hedera/tutorials/more-tutorials/json-rpc-connections/validation-cloud">
Freemium managed JSON-RPC and Mirror Node service. Requires an account but no credit card. Scales for production workloads.
</Card>

**➡** [**QuickNode**](https://www.quicknode.com/docs/hedera) **(docs)**
<Card title="QuickNode" icon="rocket" href="https://www.quicknode.com/docs/hedera">
Commercial JSON-RPC provider with global edge infrastructure and SLAs. Best for high-throughput production apps.
</Card>

<Columns cols={2}>
<Card title="Self-host the Relay" icon="server" href="https://github.com/hiero-ledger/hiero-json-rpc-relay">
Run your own instance of the open-source Hiero JSON-RPC Relay for full control over rate limits, caching, and infrastructure.
</Card>
</CardGroup>

## Network support

| Option | Mainnet | Testnet | Previewnet | Sign-up |
| ------------------------------- | :-----: | :-----: | :--------: | :-----: |
| **Hashio** (public Hiero Relay) | ✅ | ✅ | ✅ | ❌ |
| **Validation Cloud** | ✅ | ✅ | ❌ | ✅ |
| **QuickNode** | ✅ | ✅ | ❌ | ✅ |
| **Self-hosted Relay** | ✅ | ✅ | ✅ | — |

## Network reference

| Network | Chain ID (decimal) | Chain ID (hex) | Hashio endpoint |
| -------------- | :----------------: | :------------: | ---------------------------------------------------------------------- |
| **Mainnet** | `295` | `0x127` | [`https://mainnet.hashio.io/api`](https://mainnet.hashio.io/api) |
| **Testnet** | `296` | `0x128` | [`https://testnet.hashio.io/api`](https://testnet.hashio.io/api) |
| **Previewnet** | `297` | `0x129` | [`https://previewnet.hashio.io/api`](https://previewnet.hashio.io/api) |

<Warning>
**Hashio is for development and testing purposes only.** Production use cases are strongly encouraged to use [commercial-grade JSON-RPC relays](/hedera/core-concepts/smart-contracts/json-rpc-relay#community-hosted-json-rpc-relays) or host their own instance of the [Hiero JSON-RPC Relay](https://github.com/hiero-ledger/hiero-json-rpc-relay).
</Warning>

## Additional resources

* [JSON-RPC Relay overview](/hedera/core-concepts/smart-contracts/json-rpc-relay)
* [Community-hosted JSON-RPC relays](/hedera/core-concepts/smart-contracts/json-rpc-relay#community-hosted-json-rpc-relays)
* [Add Hedera to MetaMask](/hedera/getting-started-evm-developers/add-hedera-to-metamask)
* [How to connect MetaMask to Hedera](/hedera/tutorials/smart-contracts/how-to-connect-metamask-to-hedera)
* [Hiero JSON-RPC Relay on GitHub](https://github.com/hiero-ledger/hiero-json-rpc-relay)

---

<Columns cols={2}>
<Card title="Writer: Brendan, DevRel Engineer">
[GitHub](https://github.com/bguiz) | [Blog](https://blog.bguiz.com/)
</Card>
<Card title="Writer: Aaron, Validation Cloud">
[GitHub](https://github.com/aaron-cottrell-vc)
</Card>
<Card title="Editor: Krystal, Senior DX Engineer">
[GitHub](https://github.com/theekrystallee) | [X](https://X.com/theekrystallee)
[GitHub](https://github.com/theekrystallee) | [X](https://X.com/theekrystallee) | [LinkedIn](https://linkedin.com/in/theekrystallee)
</Card>
</Columns>

<Warning>
**Please note**: Hashio is For development and testing purposes only.
Production use cases are strongly encouraged to use* [*commercial-grade
JSON-RPC relays*](hedera/core-concepts/smart-contracts/json-rpc-relay) *or
host their own instance of the* [*Hiero JSON-RPC
Relay*](https://github.com/hiero-ledger/hiero-json-rpc-relay)*.*
</Warning>
53 changes: 43 additions & 10 deletions hedera/tutorials/more-tutorials/json-rpc-connections/hashio.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,27 +2,60 @@
title: "Configuring Hashio RPC endpoints"
---

How to configure a JSON-RPC endpoint that enables communication between
EVM-compatible developer tools using Hashio
How to configure a JSON-RPC endpoint that enables communication between EVM-compatible developer tools using Hashio.

[Hashio](https://www.hashgraph.com/hashio/)
is a public RPC endpoint hosted by Swirlds Labs. As a *public* endpoint, it:
Hashio is a public RPC endpoint hosted by [Hashgraph](https://www.hashgraph.com/) that runs an instance of the [Hiero JSON-RPC Relay](https://github.com/hiero-ledger/hiero-json-rpc-relay). As a *public* endpoint, it:

* Is free to use
* Does not have any sign-up requirements
* Has significantly restrictive rate limits

While this combination may be considered less reliable, it offers the highest levels of ease of use among RPC
endpoints.
While this combination may be considered less reliable, it offers the highest levels of ease of use among RPC endpoints.

To connect to the Hedera networks via Hashio, simply use this URL when initializing the wallet or web3 provider
instance:
To connect to the Hedera networks via Hashio, simply use one of these URLs when initializing the wallet or web3 provider instance:

<CodeGroup>
```text Mainnet
https://mainnet.hashio.io/api
```

```text Testnet
https://testnet.hashio.io/api
```

```text Previewnet
https://previewnet.hashio.io/api
```
</CodeGroup>

The corresponding chain IDs are:

**Please note**: Hashio is
For development and testing purposes only. Production use cases are strongly encouraged to use [commercial-grade JSON-RPC relays](/hedera/core-concepts/smart-contracts/json-rpc-relay#community-hosted-json-rpc-relays) or host their own instance of the [Hedera JSON-RPC Relay](https://github.com/hashgraph/hedera-json-rpc-relay?tab=readme-ov-file#hedera-json-rpc-relay).
| Network | Chain ID (decimal) | Chain ID (hex) |
| -------------- | :------------------: | :------------: |
| **Mainnet** | `295` | `0x127` |
| **Testnet** | `296` | `0x128` |
| **Previewnet** | `297` | `0x129` |

No further settings or configurations are needed!

<Warning>
**Please note**: Hashio is for development and testing purposes only. Production use cases are strongly encouraged to use [commercial-grade JSON-RPC relays](/hedera/core-concepts/smart-contracts/json-rpc-relay#community-hosted-json-rpc-relays) or host their own instance of the [Hiero JSON-RPC Relay](https://github.com/hiero-ledger/hiero-json-rpc-relay).
</Warning>

## Additional resources

* [Hiero JSON-RPC Relay repository](https://github.com/hiero-ledger/hiero-json-rpc-relay)
* [JSON-RPC Relay overview](/hedera/core-concepts/smart-contracts/json-rpc-relay)
* [How to connect MetaMask to Hedera](/hedera/tutorials/smart-contracts/how-to-connect-metamask-to-hedera)
* [Add Hedera to MetaMask](/hedera/getting-started-evm-developers/add-hedera-to-metamask)

---

<Columns cols={2}>
<Card title="Editor: Krystal, Senior DX Engineer">
[GitHub](https://github.com/theekrystallee) | [X](https://X.com/theekrystallee) | [LinkedIn](https://linkedin.com/in/theekrystallee)
</Card>
<Card title="Editor: Logan, Senior Software Engineer" arrow>
[GitHub](https://github.com/quiet-node) | [LinkedIn](https://www.linkedin.com/in/logann131/)
</Card>
</Columns>
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,23 @@ To connect to Hedera networks via Validation Cloud, simply use this URL when ini
provider instance:

<CodeGroup>
```text Mainnet
https://mainnet.hedera.validationcloud.io/v1/<YOUR_API_KEY>
```

```text Testnet
https://testnet.hedera.validationcloud.io/v1/<YOUR_API_KEY>
```
</CodeGroup>

The corresponding chain IDs are:

| Network | Chain ID (decimal) | Chain ID (hex) |
| -------------- | :----------------: | :------------: |
| **Mainnet** | `295` | `0x127` |
| **Testnet** | `296` | `0x128` |


<Info>
**Note:** Validation Cloud provides RPC endpoints for Hedera Mainnet and Hedera Testnet but not for Hedera Previewnet.
</Info>
Expand Down Expand Up @@ -48,6 +63,20 @@ with a Validation Cloud API Endpoint Key, and that requires the following prereq

Now you're ready to connect to an RPC endpoint or query a Mirror Node via Validation Cloud!

You can also watch this short video showing the process end-to-end, with examples of making Hedera JSON-RPC and Mirror Node requests with Validation Cloud:
## Additional resources

* [Validation Cloud documentation](https://docs.validationcloud.io/v1)
* [Hedera JSON-RPC Relay API reference](https://docs.validationcloud.io/v1/hedera/json-rpc-relay-api)
* [Hedera REST Mirror Node API reference](https://docs.validationcloud.io/v1/hedera/rest-mirror-node-api)
* [Validation Cloud Node API dashboard](https://app.validationcloud.io/)

---

<iframe width="768" height="432" src="https://www.loom.com/share/22cb87ee589248e58c95bbba6edc1667?sid=a93b0c6d-58a9-40de-a230-509b4d2198a3" title="Hedera Ecosystem - get up and running with Validation Cloud" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
<Columns cols={2}>
<Card title="Editor: Krystal, Senior DX Engineer">
[GitHub](https://github.com/theekrystallee) | [X](https://X.com/theekrystallee) | [LinkedIn](https://linkedin.com/in/theekrystallee)
</Card>
<Card title="Editor: Logan, Senior Software EngineerI" arrow>
[GitHub](https://github.com/quiet-node) | [LinkedIn](https://www.linkedin.com/in/logann131/)
</Card>
</Columns>
Original file line number Diff line number Diff line change
Expand Up @@ -169,7 +169,7 @@ While the bundled metadata approach above is more robust than uploading individu
[GitHub](https://github.com/ed-marquez) |
[LinkedIn](https://www.linkedin.com/in/ed-marquez/)
</Card>
<Card title="Editor: Logan, Software Engineer II">
<Card title="Editor: Logan, Senior Software Engineer">
[GitHub](https://github.com/quiet-node) |
[LinkedIn](https://www.linkedin.com/in/logann131/)
</Card>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -777,7 +777,7 @@ Check out our GitHub repo to find the full contract and Hardhat test scripts, al
- [Full Contract and Tests Repository](https://github.com/hedera-dev/hedera-code-snippets/tree/main/hts-evm-mint-nfts)

<Columns cols={2}>
<Card title="Writer: Jake, DevRel Engineer" arrow>
<Card title="Writer: Jake, Senior DevRel Engineer" arrow>
[GitHub](https://github.com/jaycoolh) | [X](https://x.com/jaycoolh)
</Card>
<Card title="Editor: Michiel, DevRel Engineer" arrow>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -891,7 +891,7 @@ Check out our GitHub repo to find the full contract and Hardhat test scripts, al
- [Full Contract and Tests Repository](https://github.com/hedera-dev/hedera-code-snippets/tree/main/hts-evm-mint-nfts)

<Columns cols={2}>
<Card title="Writer: Jake, DevRel Engineer" arrow>
<Card title="Writer: Jake, Senior DevRel Engineer" arrow>
[GitHub](https://github.com/jaycoolh) | [X](https://x.com/jaycoolh)
</Card>
<Card title="Editor: Michiel, DevRel Engineer" arrow>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -983,7 +983,7 @@ Check out our GitHub repo to find the full contract and Hardhat test scripts, al
- [Full Contract and Tests Repository](https://github.com/hedera-dev/hedera-code-snippets/tree/main/hts-evm-mint-nfts)

<Columns cols={2}>
<Card title="Writer: Jake, DevRel Engineer" arrow>
<Card title="Writer: Jake, Senior DevRel Engineer" arrow>
[GitHub](https://github.com/jaycoolh) | [X](https://x.com/jaycoolh)
</Card>
<Card title="Editor: Michiel, DevRel Engineer" arrow>
Expand Down
Loading