Skip to content

Commit 290957b

Browse files
gfletcher-cllaelmanaa
gfletcher-cll
and
aelmanaa
authored
add new hyperevm testnet rpc guide to network specific ccip docs (#3047)
* add new hyperevm testnet rpc guide to network specific ccip docs * Update sidebar.ts * Update hyperevm-testnet-rpc.mdx * Update hyperevm-testnet-rpc.mdx * nit * nit * nit * Update hyperevm-testnet-rpc.mdx --------- Co-authored-by: aelmanaa <[email protected]> Co-authored-by: Amine E. <[email protected]>
1 parent a7b583a commit 290957b

File tree

3 files changed

+188
-0
lines changed

3 files changed

+188
-0
lines changed

‎src/config/sidebar.ts‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1779,6 +1779,10 @@ export const SIDEBAR: Partial<Record<Sections, SectionEntry[]>> = {
17791779
title: "Hyperliquid Integration Guide",
17801780
url: "ccip/tools-resources/network-specific/hyperliquid-integration-guide",
17811781
},
1782+
{
1783+
title: "HyperEVM Testnet RPC Guide",
1784+
url: "ccip/tools-resources/network-specific/hyperevm-testnet-rpc",
1785+
},
17821786
],
17831787
},
17841788
{

‎src/content/ccip/tools-resources/network-specific/hyperevm-testnet-rpc.mdx‎

Lines changed: 181 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,181 @@
1+
---
2+
title: "HyperEVM Testnet RPC Guide"
3+
section: ccip
4+
date: Last Modified
5+
metadata:
6+
description: "HyperEVM Testnet RPC for Chainlink CCIP—endpoint, supported JSON-RPC methods, limits, and quick curl/web3 examples."
7+
excerpt: "ccip hyperliquid hyperevm hypercore bridge cross-chain token testnet rpc json"
8+
datePublished: "2025-10-08T00:00:00Z"
9+
lastModified: "2025-10-08T00:00:00Z"
10+
difficulty: "beginner"
11+
estimatedTime: "15 minutes"
12+
---
13+
14+
import { Aside, CopyText } from "@components"
15+
16+
<Aside type="caution" title="Disclaimer">
17+
This RPC is provided “as is” without warranties of any kind. Use is at your own risk, Chainlink Labs and its
18+
affiliates are not liable for any losses, damages, or interruptions arising from its use. The RPC may be modified or
19+
unavailable at any time, and users are solely responsible for their interactions and compliance with applicable laws.
20+
</Aside>
21+
22+
To enhance the HyperEVM developer experience, we provide free public access to our professionally hosted Testnet RPC endpoint. Developers can use this endpoint to build Hyperliquid applications and configure it as a testnet RPC in browser wallets. For mainnet deployments, see available mainnet RPC URLs on the [Hyperliquid docs](https://hyperliquid.gitbook.io/hyperliquid-docs/builder-tools/hyperevm-tools).
23+
24+
## RPC Endpoint Details
25+
26+
- **Network Name**: HyperEVM Testnet
27+
- **RPC URL**: https://rpcs.chain.link/hyperevm/testnet
28+
- **Chain ID**: 998
29+
- **Currency Symbol**: HYPE
30+
- **Block Explorer URL (Optional)**: https://testnet.purrsec.com/
31+
32+
## For Developers: Building with the RPC
33+
34+
You can use this endpoint in your dApps, scripts, or backend services with any standard Web3 library.
35+
36+
### Ethers.js (JavaScript/TypeScript)
37+
38+
[Ethers.js](https://docs.ethers.org/v6/) is a library for interacting with Ethereum and EVM-compatible chains.
39+
40+
```javascript
41+
import { ethers } from "ethers"
42+
43+
const rpcUrl = "https://rpcs.chain.link/hyperevm/testnet"
44+
const provider = new ethers.JsonRpcProvider(rpcUrl)
45+
46+
async function getBlock() {
47+
const blockNumber = await provider.getBlockNumber()
48+
console.log("Current Block Number:", blockNumber)
49+
}
50+
51+
getBlock()
52+
```
53+
54+
### Viem (JavaScript/TypeScript)
55+
56+
[Viem](https://viem.sh/) is a TypeScript library for interacting with Ethereum and EVM-compatible chains. It provides modular, type-safe APIs as an alternative to ethers.js.
57+
58+
```javascript
59+
import { createPublicClient, http } from "viem"
60+
61+
const rpcUrl = "https://rpcs.chain.link/hyperevm/testnet"
62+
63+
const client = createPublicClient({
64+
transport: http(rpcUrl),
65+
})
66+
67+
async function getBlock() {
68+
const blockNumber = await client.getBlockNumber()
69+
console.log("Current Block Number:", blockNumber)
70+
}
71+
72+
getBlock()
73+
```
74+
75+
### Web3.py (Python)
76+
77+
[Web3.py](https://web3py.readthedocs.io/) is a Python library for interacting with EVM-compatible chains.
78+
79+
```python
80+
from web3 import Web3
81+
82+
rpc_url = "https://rpcs.chain.link/hyperevm/testnet"
83+
w3 = Web3(Web3.HTTPProvider(rpc_url))
84+
85+
if w3.is_connected():
86+
print("Connected to RPC!")
87+
block_number = w3.eth.block_number
88+
print("Current Block Number:", block_number)
89+
else:
90+
print("Failed to connect.")
91+
```
92+
93+
### cURL (Testing)
94+
95+
```shell
96+
curl -X POST -H "Content-Type: application/json" \
97+
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' \
98+
https://rpcs.chain.link/hyperevm/testnet
99+
```
100+
101+
**Expected Response**:
102+
103+
```json
104+
{ "jsonrpc": "2.0", "id": 1, "result": "0x1f92031" }
105+
```
106+
107+
## For Users: Adding to Your Wallet
108+
109+
You can easily add this network to browser extension wallets like [MetaMask](https://metamask.io/) or [Rabby](https://rabby.io/).
110+
111+
### Using MetaMask
112+
113+
[MetaMask](https://metamask.io/) is a popular browser extension wallet for Ethereum and EVM-compatible chains.
114+
115+
1. Open your MetaMask wallet.
116+
1. Click the network selection dropdown at the top left.
117+
1. Click "Add network".
118+
1. At the bottom, select "Add a network manually".
119+
1. Fill in the form with the network details:
120+
- Network Name: HyperEVM Testnet
121+
- RPC URL: https://rpcs.chain.link/hyperevm/testnet
122+
- Chain ID: 998
123+
- Currency Symbol: HYPE
124+
- Block Explorer URL (Optional): https://testnet.purrsec.com/
125+
1. Click "Save".
126+
127+
### Using Rabby
128+
129+
[Rabby](https://rabby.io/) is a browser extension wallet designed for multi-chain DeFi users with enhanced security features.
130+
131+
1. Click on the "More" button, find "Add Custom Network".
132+
1. Press "Add Custom Network", or the edit button if editing an existing connection.
133+
1. Fill in the network details:
134+
- Network Name: HyperEVM Testnet
135+
- RPC URL: https://rpcs.chain.link/hyperevm/testnet
136+
- Chain ID: 998
137+
- Currency Symbol: HYPE
138+
- Block Explorer URL (Optional): https://testnet.purrsec.com/
139+
1. Click "Confirm."
140+
141+
## Supported JSON-RPC Methods
142+
143+
| Method | Description |
144+
| --------------------------------------- | -------------------------------------------------------------------------------------------------------- |
145+
| net_version | Returns the current network ID (as a decimal string). |
146+
| web3_clientVersion | Returns the client software version string. |
147+
| eth_blockNumber | Returns the number of the most recent block (hex quantity). |
148+
| eth_call | Executes a read-only call (no state change) against a contract. Only the latest block is supported. |
149+
| eth_chainId | Returns the chain ID used for EIP-155 transaction signing (hex quantity). |
150+
| eth_estimateGas | Estimates the gas required to execute a transaction/call. Only the latest block is supported. |
151+
| eth_feeHistory | Returns historical base fees, priority fee rewards, and gas usage ratios for a range of recent blocks. |
152+
| eth_gasPrice | Returns the node’s suggested gas price. Returns the base fee for the next small block. |
153+
| eth_getBalance | Returns the account balance for an address. Only the latest block is supported. |
154+
| eth_getBlockByHash | Returns block details by block hash; can include full transactions when requested. |
155+
| eth_getBlockByNumber | Returns block details by block number; can include full transactions when requested. |
156+
| eth_getBlockReceipts | Returns all transaction receipts for the specified block. |
157+
| eth_getBlockTransactionCountByHash | Returns the number of transactions in a block, by block hash. |
158+
| eth_getBlockTransactionCountByNumber | Returns the number of transactions in a block, by block number. |
159+
| eth_getCode | Returns the EVM bytecode at an address. Only the latest block is supported. |
160+
| eth_getLogs | Returns log entries that match a filter object. Up to 4 topics and up to 50 blocks in query range. |
161+
| eth_getStorageAt | Returns the value from a storage slot at an address. Only the latest block is supported. |
162+
| eth_getTransactionByBlockHashAndIndex | Returns a transaction from a block, by block hash and transaction index. |
163+
| eth_getTransactionByBlockNumberAndIndex | Returns a transaction from a block, by block number and transaction index. |
164+
| eth_getTransactionByHash | Returns a transaction by its hash. |
165+
| eth_getTransactionCount | Returns the number of transactions sent from an address (the nonce). Only the latest block is supported. |
166+
| eth_getTransactionReceipt | Returns the receipt of a transaction by hash (includes status, gas used, logs). |
167+
| eth_maxPriorityFeePerGas | Returns the current max priority fee per gas (tip). Always returns zero currently. |
168+
| eth_syncing | Reports node sync status. Always returns false. |
169+
170+
The following HyperEVM-specific endpoints are available:
171+
172+
| Method | Description |
173+
| ----------------------------- | ---------------------------------------------------------------------------------------------------------- |
174+
| eth_bigBlockGasPrice | Returns the base fee for the next big block. |
175+
| eth_usingBigBlocks | Returns whether the address is using big blocks. |
176+
| eth_getSystemTxsByBlockHash | Similar to the "getTransaction" analogs but returns the system transactions that originate from HyperCore. |
177+
| eth_getSystemTxsByBlockNumber | Similar to the "getTransaction" analogs but returns the system transactions that originate from HyperCore. |
178+
179+
## Rate Limits
180+
181+
The RPC endpoint allows 1,000 requests per IP address within a 5-minute moving window.

‎src/content/ccip/tools-resources/network-specific/index.mdx‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,4 +7,7 @@ isIndex: true
77

88
This section provides guidance on how to integrate with networks that require specific setup in order to successfully utilize CCIP.
99

10+
## Hyperliquid
11+
1012
- [Hyperliquid Integration Guide](/ccip/tools-resources/network-specific/hyperliquid-integration-guide)
13+
- [HyperEVM Testnet RPC Guide](/ccip/tools-resources/network-specific/hyperevm-testnet-rpc)

0 commit comments

Comments
 (0)