Skip to content

Hyperliquid

Hyperliquid EVM mainnet over JSON-RPC.

Endpoint
Default port 3360 (override per endpoints[] entry)
Calling convention POST / with a JSON-RPC body
chain-id HYPERLIQUID
Spec specs/hyperliquid.json

Method surface

Hyperliquid's EVM exposes the standard Ethereum JSON-RPC method surface (eth_*, net_*, web3_*). Its eth_chainId is 0x3e7 (999). See Ethereum → Supported method families for the shared eth_* families; the full method list lives in the spec file linked above.

Run this example

The repo ships a ready-to-run config at config/smartrouter_examples/smartrouter_hyperliquid.yml — a single public upstream on the official Hyperliquid EVM RPC (rpc.hyperliquid.xyz/evm), no API key needed. It serves no websocket leg, so run it with --skip-websocket-verification:

SR_CONFIG=config/smartrouter_examples/smartrouter_hyperliquid.yml \
  docker compose -f docker/docker-compose.yml up --build

smartrouter config/smartrouter_examples/smartrouter_hyperliquid.yml \
  --use-static-spec specs/ --skip-websocket-verification

Then call it:

curl -X POST http://127.0.0.1:3360 \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

Connect a client

import { createPublicClient, http, defineChain } from 'viem';

const hyperliquid = defineChain({
  id: 999,
  name: 'Hyperliquid',
  nativeCurrency: { name: 'HYPE', symbol: 'HYPE', decimals: 18 },
  rpcUrls: { default: { http: ['http://127.0.0.1:3360'] } },
});

const client = createPublicClient({ chain: hyperliquid, transport: http() });
const block = await client.getBlockNumber();

import { JsonRpcProvider } from 'ethers';
const provider = new JsonRpcProvider('http://127.0.0.1:3360');
const block = await provider.getBlockNumber();

Point at your own upstreams by editing the node-urls in the config — see The config file.