From e0f7335e002a931ff8c6664729108393d60b9d29 Mon Sep 17 00:00:00 2001 From: krystal <56278409+theekrystallee@users.noreply.github.com> Date: Tue, 26 May 2026 13:35:27 -0700 Subject: [PATCH 1/3] fixed broken links and updated the content Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com> --- docs.json | 8 +++ .../more-tutorials/json-rpc-connections.mdx | 66 ++++++++++++++----- .../json-rpc-connections/hashio.mdx | 53 ++++++++++++--- .../json-rpc-connections/validation-cloud.mdx | 33 +++++++++- 4 files changed, 133 insertions(+), 27 deletions(-) diff --git a/docs.json b/docs.json index 6047ba80..018bd19b 100644 --- a/docs.json +++ b/docs.json @@ -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" + ] } ] }, diff --git a/hedera/tutorials/more-tutorials/json-rpc-connections.mdx b/hedera/tutorials/more-tutorials/json-rpc-connections.mdx index 5f40cb56..d3fa42e1 100644 --- a/hedera/tutorials/more-tutorials/json-rpc-connections.mdx +++ b/hedera/tutorials/more-tutorials/json-rpc-connections.mdx @@ -1,19 +1,63 @@ --- 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) + + + Free public Hiero JSON-RPC Relay instance hosted by Hashgraph. No sign-up required. Best for prototyping and tutorials. Rate-limited. + -**➡** [**Validation Cloud**](/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. + -**➡** [**QuickNode**](https://www.quicknode.com/docs/hedera) **(docs)** + + Commercial JSON-RPC provider with global edge infrastructure and SLAs. Best for high-throughput production apps. + - + + Run your own instance of the open-source Hiero JSON-RPC Relay for full control over rate limits, caching, and infrastructure. + + + +## 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) | + + + **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). + + +## 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) + +--- + [GitHub](https://github.com/bguiz) | [Blog](https://blog.bguiz.com/) @@ -21,14 +65,6 @@ There are four options to establish a connection to Hedera Networks. Validation [GitHub](https://github.com/aaron-cottrell-vc) - [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) - - - **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)*.* - diff --git a/hedera/tutorials/more-tutorials/json-rpc-connections/hashio.mdx b/hedera/tutorials/more-tutorials/json-rpc-connections/hashio.mdx index 2511f3e0..3bf8b158 100644 --- a/hedera/tutorials/more-tutorials/json-rpc-connections/hashio.mdx +++ b/hedera/tutorials/more-tutorials/json-rpc-connections/hashio.mdx @@ -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: + ```text Mainnet + https://mainnet.hashio.io/api + ``` + + ```text Testnet + https://testnet.hashio.io/api + ``` + + ```text Previewnet + https://previewnet.hashio.io/api + ``` +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! + + + **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). + + +## 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) + +--- + + + + [GitHub](https://github.com/theekrystallee) | [X](https://X.com/theekrystallee) | [LinkedIn](https://linkedin.com/in/theekrystallee) + + + [GitHub](https://github.com/quiet-node) | [LinkedIn](https://www.linkedin.com/in/logann131/) + + \ No newline at end of file diff --git a/hedera/tutorials/more-tutorials/json-rpc-connections/validation-cloud.mdx b/hedera/tutorials/more-tutorials/json-rpc-connections/validation-cloud.mdx index 4f286f6d..3f19f1ea 100644 --- a/hedera/tutorials/more-tutorials/json-rpc-connections/validation-cloud.mdx +++ b/hedera/tutorials/more-tutorials/json-rpc-connections/validation-cloud.mdx @@ -17,8 +17,23 @@ To connect to Hedera networks via Validation Cloud, simply use this URL when ini provider instance: + ```text Mainnet + https://mainnet.hedera.validationcloud.io/v1/ + ``` + + ```text Testnet + https://testnet.hedera.validationcloud.io/v1/ + ``` +The corresponding chain IDs are: + +| Network | Chain ID (decimal) | Chain ID (hex) | +| -------------- | :----------------: | :------------: | +| **Mainnet** | `295` | `0x127` | +| **Testnet** | `296` | `0x128` | + + **Note:** Validation Cloud provides RPC endpoints for Hedera Mainnet and Hedera Testnet but not for Hedera Previewnet. @@ -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/) + +--- - + + + [GitHub](https://github.com/theekrystallee) | [X](https://X.com/theekrystallee) | [LinkedIn](https://linkedin.com/in/theekrystallee) + + + [GitHub](https://github.com/quiet-node) | [LinkedIn](https://www.linkedin.com/in/logann131/) + + \ No newline at end of file From 54f1154725f9fe01b4a27e5dffb5091162a8db18 Mon Sep 17 00:00:00 2001 From: krystal <56278409+theekrystallee@users.noreply.github.com> Date: Tue, 26 May 2026 13:44:07 -0700 Subject: [PATCH 2/3] updated editor cards Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com> --- .../deploy-a-smart-contract-with-hardhat.mdx | 2 +- hedera/tutorials/more-tutorials/json-rpc-connections/hashio.mdx | 2 +- .../more-tutorials/json-rpc-connections/validation-cloud.mdx | 2 +- .../how-to-verify-a-smart-contract-on-hashscan.mdx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/hedera/getting-started-evm-developers/deploy-a-smart-contract-with-hardhat.mdx b/hedera/getting-started-evm-developers/deploy-a-smart-contract-with-hardhat.mdx index 3b2dd61d..1a2abb3b 100644 --- a/hedera/getting-started-evm-developers/deploy-a-smart-contract-with-hardhat.mdx +++ b/hedera/getting-started-evm-developers/deploy-a-smart-contract-with-hardhat.mdx @@ -462,7 +462,7 @@ The plugin uploads the source code and metadata to Sourcify and you should recei [Github](https://github.com/theekrystallee) | [X](https://x.com/theekrystallee) - + [GitHub](https://github.com/quiet-node) | [LinkedIn](https://www.linkedin.com/in/logann131/) diff --git a/hedera/tutorials/more-tutorials/json-rpc-connections/hashio.mdx b/hedera/tutorials/more-tutorials/json-rpc-connections/hashio.mdx index 3bf8b158..dc783193 100644 --- a/hedera/tutorials/more-tutorials/json-rpc-connections/hashio.mdx +++ b/hedera/tutorials/more-tutorials/json-rpc-connections/hashio.mdx @@ -55,7 +55,7 @@ No further settings or configurations are needed! [GitHub](https://github.com/theekrystallee) | [X](https://X.com/theekrystallee) | [LinkedIn](https://linkedin.com/in/theekrystallee) - + [GitHub](https://github.com/quiet-node) | [LinkedIn](https://www.linkedin.com/in/logann131/) \ No newline at end of file diff --git a/hedera/tutorials/more-tutorials/json-rpc-connections/validation-cloud.mdx b/hedera/tutorials/more-tutorials/json-rpc-connections/validation-cloud.mdx index 3f19f1ea..87f0c361 100644 --- a/hedera/tutorials/more-tutorials/json-rpc-connections/validation-cloud.mdx +++ b/hedera/tutorials/more-tutorials/json-rpc-connections/validation-cloud.mdx @@ -76,7 +76,7 @@ Now you're ready to connect to an RPC endpoint or query a Mirror Node via Valida [GitHub](https://github.com/theekrystallee) | [X](https://X.com/theekrystallee) | [LinkedIn](https://linkedin.com/in/theekrystallee) - + [GitHub](https://github.com/quiet-node) | [LinkedIn](https://www.linkedin.com/in/logann131/) \ No newline at end of file diff --git a/hedera/tutorials/smart-contracts/how-to-verify-a-smart-contract-on-hashscan.mdx b/hedera/tutorials/smart-contracts/how-to-verify-a-smart-contract-on-hashscan.mdx index f5cd8aac..d7bc960f 100644 --- a/hedera/tutorials/smart-contracts/how-to-verify-a-smart-contract-on-hashscan.mdx +++ b/hedera/tutorials/smart-contracts/how-to-verify-a-smart-contract-on-hashscan.mdx @@ -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/) - + [GitHub](https://github.com/quiet-node) | [LinkedIn](https://www.linkedin.com/in/logann131/) From 445cc51adeb87b5cc299249a329f895643bf9e7c Mon Sep 17 00:00:00 2001 From: krystal <56278409+theekrystallee@users.noreply.github.com> Date: Tue, 26 May 2026 13:45:38 -0700 Subject: [PATCH 3/3] updated editor cards Signed-off-by: krystal <56278409+theekrystallee@users.noreply.github.com> --- .../deploy-a-smart-contract-with-hardhat.mdx | 2 +- .../smart-contracts/hts-x-evm-part-1-how-to-mint-nfts.mdx | 2 +- .../smart-contracts/hts-x-evm-part-2-kyc-and-update.mdx | 2 +- ...ts-x-evm-part-3-how-to-pause-freeze-wipe-and-delete-nfts.mdx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/hedera/getting-started-evm-developers/deploy-a-smart-contract-with-hardhat.mdx b/hedera/getting-started-evm-developers/deploy-a-smart-contract-with-hardhat.mdx index 1a2abb3b..a9ceb967 100644 --- a/hedera/getting-started-evm-developers/deploy-a-smart-contract-with-hardhat.mdx +++ b/hedera/getting-started-evm-developers/deploy-a-smart-contract-with-hardhat.mdx @@ -465,7 +465,7 @@ The plugin uploads the source code and metadata to Sourcify and you should recei [GitHub](https://github.com/quiet-node) | [LinkedIn](https://www.linkedin.com/in/logann131/) - + [GitHub](https://github.com/jaycoolh) | [X](https://x.com/jaycoolh) diff --git a/hedera/tutorials/smart-contracts/hts-x-evm-part-1-how-to-mint-nfts.mdx b/hedera/tutorials/smart-contracts/hts-x-evm-part-1-how-to-mint-nfts.mdx index a7a054c0..91efbfcc 100644 --- a/hedera/tutorials/smart-contracts/hts-x-evm-part-1-how-to-mint-nfts.mdx +++ b/hedera/tutorials/smart-contracts/hts-x-evm-part-1-how-to-mint-nfts.mdx @@ -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) - + [GitHub](https://github.com/jaycoolh) | [X](https://x.com/jaycoolh) diff --git a/hedera/tutorials/smart-contracts/hts-x-evm-part-2-kyc-and-update.mdx b/hedera/tutorials/smart-contracts/hts-x-evm-part-2-kyc-and-update.mdx index 15ea1785..167e2f50 100644 --- a/hedera/tutorials/smart-contracts/hts-x-evm-part-2-kyc-and-update.mdx +++ b/hedera/tutorials/smart-contracts/hts-x-evm-part-2-kyc-and-update.mdx @@ -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) - + [GitHub](https://github.com/jaycoolh) | [X](https://x.com/jaycoolh) diff --git a/hedera/tutorials/smart-contracts/hts-x-evm-part-3-how-to-pause-freeze-wipe-and-delete-nfts.mdx b/hedera/tutorials/smart-contracts/hts-x-evm-part-3-how-to-pause-freeze-wipe-and-delete-nfts.mdx index 3200e72d..e7332b0b 100644 --- a/hedera/tutorials/smart-contracts/hts-x-evm-part-3-how-to-pause-freeze-wipe-and-delete-nfts.mdx +++ b/hedera/tutorials/smart-contracts/hts-x-evm-part-3-how-to-pause-freeze-wipe-and-delete-nfts.mdx @@ -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) - + [GitHub](https://github.com/jaycoolh) | [X](https://x.com/jaycoolh)