> ## Documentation Index
> Fetch the complete documentation index at: https://hypernode-docs.polynode.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# EVM RPC

> Dedicated Ethereum JSON-RPC for HyperEVM (chain 999) with no shared rate limits

hypernode's EVM RPC is a dedicated endpoint for HyperEVM queries and transaction submission. No shared public endpoint, no rate limit contention with other users.

<Note>
  This endpoint serves **HyperEVM** (chain ID 999), not HyperCore. HyperCore orders, fills, and the L1 matching engine are served by the [WebSocket stream](/api/connection) and [REST API](/rest/overview). The EVM RPC is for smart contract reads, token balances, and HyperEVM transaction submission.
</Note>

## Endpoint

```
POST https://hyper.polynode.dev/v2/evm
```

Standard Ethereum JSON-RPC 2.0 format. Requires API key via `x-api-key` header.

```bash theme={null}
curl -X POST https://hyper.polynode.dev/v2/evm \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```

## Supported methods

| Method                      | Description                          |
| --------------------------- | ------------------------------------ |
| `eth_blockNumber`           | Latest block number                  |
| `eth_chainId`               | Chain ID (999)                       |
| `eth_gasPrice`              | Current gas price                    |
| `eth_getBalance`            | Address balance at latest block      |
| `eth_getBlockByNumber`      | Block by number (recent blocks)      |
| `eth_getBlockByHash`        | Block by hash                        |
| `eth_getTransactionByHash`  | Transaction details                  |
| `eth_getTransactionReceipt` | Transaction receipt with logs        |
| `eth_getTransactionCount`   | Nonce for an address                 |
| `eth_call`                  | Read-only contract call              |
| `eth_estimateGas`           | Estimate gas for a transaction       |
| `eth_getLogs`               | Event logs with topic filters        |
| `eth_getCode`               | Contract bytecode                    |
| `eth_getStorageAt`          | Raw storage slot read                |
| `eth_sendRawTransaction`    | Submit a signed HyperEVM transaction |
| `eth_feeHistory`            | Fee history                          |
| `eth_syncing`               | Sync status                          |
| `net_version`               | Network version                      |
| `web3_clientVersion`        | Client version                       |

## What this is

This is a dedicated RPC. Your requests go to your own capacity, not a shared public endpoint. One hypernode API key gives you HyperCore trading, the EVM RPC, the WebSocket stream, and the L4 order book.

Combined with the HyperCore trading API, one hypernode key gives you both chains: place orders on HyperCore via `POST /v2/order`, read contracts and submit transactions on HyperEVM via `POST /v2/evm`.

## Limitations

**Recent blocks only.** Block and state queries work for the last \~300 blocks. Older blocks return an error. For deep historical state queries, use an archival provider.

**No WebSocket subscriptions.** `eth_subscribe`, `eth_newFilter`, and `eth_newBlockFilter` are not supported. Poll `eth_blockNumber` or `eth_getLogs` instead.

**No debug/trace.** `debug_traceTransaction` and trace methods are not available.

**No mempool via RPC.** `eth_pendingTransactions` and `txpool_content` are not supported on HyperLiquid's RPC. However, hypernode streams pre-block EVM transactions via the WebSocket as `evmRawTx` events. Subscribe with `{"action": "subscribe", "filters": {"action_types": ["evmRawTx"]}}` to see every HyperEVM transaction before it is included in a block. See [Event Types](/actions/overview) for details.

## Use cases

* Read HyperEVM contract state (token balances, LP positions, protocol data)
* Submit signed HyperEVM transactions via `eth_sendRawTransaction`
* Monitor recent EVM blocks and transaction receipts
* Query event logs from HyperEVM smart contracts