Skip to main content

JSON-RPC Endpoints

Horizen is fully EVM-compatible and supports the standard Ethereum JSON-RPC API. Use these endpoints to connect wallets, submit transactions, query state, and interact with deployed contracts.

Mainnet

ParameterValue
Chain ID26514
RPC (HTTPS)https://horizen.calderachain.xyz/http
RPC (WebSocket)wss://horizen.calderachain.xyz/ws
Currency SymbolETH
Block Explorerhttps://explorer.horizen.io/
Bridgehttps://hub.horizen.io/

Testnet (Base Sepolia)

ParameterValue
Chain ID2651420
RPC (HTTPS)https://horizen-testnet.rpc.caldera.xyz/http
RPC (WebSocket)wss://horizen-testnet.rpc.caldera.xyz/ws
Currency SymbolETH
Block Explorerhttps://explorer-testnet.horizen.io/
Faucethttps://hub-testnet.horizen.io/

Supported JSON-RPC Methods

Horizen supports the full standard Ethereum JSON-RPC specification. The most commonly used methods are listed below.

Chain & Network

MethodDescription
eth_chainIdReturns the current chain ID
net_versionReturns the network ID
eth_blockNumberReturns the latest block number
eth_gasPriceReturns the current gas price in wei

Accounts & Balances

MethodDescription
eth_accountsReturns a list of addresses owned by the client
eth_getBalanceReturns the ETH balance of an address
eth_getTransactionCountReturns the nonce of an address

Blocks

MethodDescription
eth_getBlockByHashReturns block data by hash
eth_getBlockByNumberReturns block data by block number
eth_getBlockTransactionCountByHashReturns number of transactions in a block by hash
eth_getBlockTransactionCountByNumberReturns number of transactions in a block by number

Transactions

MethodDescription
eth_sendRawTransactionSubmits a signed transaction
eth_getTransactionByHashReturns transaction data by hash
eth_getTransactionReceiptReturns receipt for a mined transaction
eth_estimateGasEstimates gas required for a transaction
eth_callExecutes a call without creating a transaction

Logs & Events

MethodDescription
eth_getLogsReturns logs matching a filter
eth_newFilterCreates a new filter for log events
eth_getFilterLogsReturns logs for an existing filter
eth_uninstallFilterRemoves a filter

Example for Querying Chain ID:

curl -X POST https://horizen.calderachain.xyz/http \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x6792"
}

0x6792 is 26514 in decimal — Horizen Mainnet's Chain ID.

Example for Querying ETH Balance:

curl -X POST https://horizen.calderachain.xyz/http \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": ["0xYourAddress", "latest"],
"id": 1
}'

Example for WebSocket subscription (ethers.js):

import { ethers } from "ethers";

const provider = new ethers.WebSocketProvider(
"wss://horizen.calderachain.xyz/ws"
);

provider.on("block", (blockNumber) => {
console.log("New block:", blockNumber);
});