Hyperliquid

Hyperliquid is a high-performance Layer 1 blockchain with native perpetual futures and spot trading. Switchboard On-Demand provides native oracle support for HyperEVM with the same security guarantees and ease of use as other EVM chains.

Network Information

Network	Chain ID	RPC URL	Switchboard Contract
Mainnet	999	https://rpc.hyperliquid.xyz/evm	0xcDb299Cb902D1E39F83F54c7725f54eDDa7F3347
Testnet	998	https://rpc.hyperliquid-testnet.xyz/evm	TBD

Quick Start

1. Clone the Examples Repository

git clone https://github.com/switchboard-xyz/sb-on-demand-examples.git
cd sb-on-demand-examples/evm/price-feeds
bun install
forge build

2. Configure Your Wallet

Security: Never use export PRIVATE_KEY=... or pass private keys as command-line arguments—they appear in shell history and process listings.

Import your private key into Foundry's encrypted keystore:

cast wallet import mykey --interactive
# Enter your private key when prompted (hidden from terminal)
# Set a password to encrypt the keystore

Create a .env file for scripts (add to .gitignore):

PRIVATE_KEY=0xyour_private_key_here
RPC_URL=https://rpc.hyperliquid.xyz/evm
NETWORK=hyperliquid-mainnet
# Optional: if omitted, the example deploys a new consumer contract for you
CONTRACT_ADDRESS=0xyour_contract_address

3. Deploy Contract

# Mainnet
SWITCHBOARD_ADDRESS=0xcDb299Cb902D1E39F83F54c7725f54eDDa7F3347 \
forge script deploy/DeploySwitchboardPriceConsumer.s.sol:DeploySwitchboardPriceConsumer \
  --rpc-url https://rpc.hyperliquid.xyz/evm \
  --private-key $PRIVATE_KEY \
  --broadcast -vvvv

Hyperliquid testnet remains TBD in the deployment table above, so the packaged examples currently only have a documented Hyperliquid mainnet path.

4. Run Examples

# Price Feeds (reads from .env)
bun run example

# Direct randomness example
cd ../randomness
bun install
PRIVATE_KEY=0x... NETWORK=hyperliquid-mainnet bun run example

Integration Example

import { ethers } from 'ethers';
import { CrossbarClient } from '@switchboard-xyz/common';

const provider = new ethers.JsonRpcProvider('https://rpc.hyperliquid.xyz/evm');
const signer = new ethers.Wallet(process.env.PRIVATE_KEY!, provider);

// Switchboard contract on Hyperliquid Mainnet
const switchboardAddress = '0xcDb299Cb902D1E39F83F54c7725f54eDDa7F3347';
const switchboard = new ethers.Contract(
  switchboardAddress,
  ['function getFee(bytes[] calldata updates) external view returns (uint256)'],
  signer
);
const priceConsumer = new ethers.Contract(
  process.env.CONTRACT_ADDRESS!,
  [
    'function updatePrices(bytes[] calldata updates, bytes32[] calldata feedIds) external payable',
    'function getPrice(bytes32 feedId) external view returns (int128 value, uint256 timestamp, uint64 slotNumber)'
  ],
  signer
);

// Fetch and update prices for perpetual futures
const crossbar = new CrossbarClient('https://crossbar.switchboard.xyz');
const btcFeedHash = '0x4cd1cad962425681af07b9254b7d804de3ca3446fbfd1371bb258d2c75059812'; // BTC/USD

const response = await crossbar.fetchEVMResults({
  chainId: 999,
  aggregatorIds: [btcFeedHash],
});
const fee = await switchboard.getFee(response.encoded);

const tx = await priceConsumer.updatePrices(response.encoded, [btcFeedHash], { value: fee });
const receipt = await tx.wait();

console.log(`Price updated on Hyperliquid! Block: ${receipt.blockNumber}`);

// Query the updated price
const [value, timestamp, slotNumber] = await priceConsumer.getPrice(btcFeedHash);
console.log(`BTC/USD Price: $${ethers.formatUnits(value, 18)}`);

Resources

• Hyperliquid Docs

• HyperEVM Documentation

Getting Started

Testnet:

• Use the Hyperliquid testnet to test your integration

• Request testnet tokens through the official faucet

Mainnet:

• Bridge ETH to Hyperliquid using the official bridge

• Start with small amounts to test your integration