Hyperliquid Docs
  • About Hyperliquid
    • Core contributors
  • Onboarding
    • How to start trading
    • How to use the HyperEVM
    • Connect mobile via QR code
    • Export your email wallet
    • Testnet faucet
  • Hyperliquid L1
    • L1 overview
    • Staking
    • HyperEVM
    • Bridge
    • API servers
    • Clearinghouse
    • Oracle
    • Order book
    • Multi-sig
  • Hyperliquid Improvement Proposals (HIPs)
    • HIP-1: Native token standard
    • HIP-2: Hyperliquidity
    • Frontend checks
  • Trading
    • Perpetual assets
    • Contract specifications
    • Fees
    • Builder codes
    • Order book
    • Order types
    • Take profit and stop loss orders (TP/SL)
    • Margining
    • Liquidations
    • Entry price and pnl
    • Funding
    • Miscellaneous UI
    • Auto-deleveraging
    • Robust price indices
    • Self-trade prevention
    • Portfolio graphs
    • Uniswap perpetuals
    • Hyperps
    • Market making
  • Vaults
    • Protocol vaults
    • For vault leaders
    • For vault depositors
  • Validators
    • Running a validator
    • Delegation program
  • Referrals
  • Points
  • Historical data
  • Risks
  • Bug bounty program
  • Audits
  • Brand kit
  • For developers
    • API
      • Notation
      • Asset IDs
      • Tick and lot size
      • Nonces and API wallets
      • Info endpoint
        • Perpetuals
        • Spot
      • Exchange endpoint
      • Websocket
        • Subscriptions
        • Post requests
        • Timeouts and heartbeats
      • Error responses
      • Rate limits
      • Bridge2
      • Deploying HIP-1 and HIP-2 assets
    • HyperEVM
      • Dual-block architecture
      • Raw HyperEVM block data
      • Interacting with HyperCore
      • HyperCore <> HyperEVM transfers
      • Wrapped HYPE
      • JSON-RPC
Powered by GitBook
On this page
  • Read precompiles (testnet only)
  • Write precompile (testnet only)
  1. For developers
  2. HyperEVM

Interacting with HyperCore

PreviousRaw HyperEVM block dataNextHyperCore <> HyperEVM transfers

Last updated 9 days ago

Read precompiles (testnet only)

The testnet EVM provides precompiles that allows querying HyperCore information. The precompile addresses start at 0x0000000000000000000000000000000000000800 and have methods for querying perps positions, spot balances, vault equity, staking delegations, oracle prices, and the L1 block number.

The values are guaranteed to match the latest HyperCore state at the time the EVM block is constructed.

Attached is a Solidity file describing the read precompiles as well as a Python script that demonstrates calling a precompile.

To convert to floating point numbers, divide the returned price by 10^(6 - asset szDecimals) for the perp ones and 10^(8 - base asset szDecimals) for the spot ones.

Write precompile (testnet only)

A system contract is available at 0x3333333333333333333333333333333333333333 for sending transactions from the HyperEVM to HyperCore. It supports sending IOC orders, vault transfers, staking, sending spot, and transfering between spot and perps. Solidity and ABI files for the write system contract are attached.

Happy building. Any feedback is appreciated.

5KB
L1Read.sol
1KB
precompile.py
2KB
L1Write.sol
12KB
L1Write.json