HyperEVM Specificities

Below is an overview of Hyperliquid’s unique EVM capabilities. This section is still a work in progress— for now, I’m redirecting to the official documentation, but a more detailed guide will be available soon.

---

1. Native Transfers

Move spot assets between Hyperliquid’s L1 (“native spot”) and the EVM (“EVM spot”). After linking an ERC20 contract to a native asset, you can deposit and withdraw simply by transferring tokens to the system address (0x2222222222222222222222222222222222222222).

• Setup: Use a setEvmContract action to bind the native spot asset with its EVM counterpart.

• Supply: Ensure the system address holds the full amount of the asset on the “other side.”

• HYPE: Functions as the native gas token on the EVM; special handling is required for deposits/withdrawals.

For detailed instructions, see the Official Docs on Native Transfers.

---

2. Dual-Block Architecture

HyperEVM splits throughput into small blocks (fast, lower gas limit) and large blocks (slower, higher gas limit). Both block types share a single, ever-increasing block number sequence.

• Small Blocks

  • Fast confirmations (~2s per block)

  • Gas limit: 2M

  • Ideal for frequent transactions and real-time interactions.

• Large Blocks

  • Slower execution (~1 min per block)

  • High gas limit: 30M

  • Designed for complex contract deployments and bulk transactions.

Switching between block types can be done via an L1 action (e.g., setting usingBigBlocks: true). For a deeper dive, consult the Official Docs on Dual-Block Architecture.

---

3. Interacting with the L1 (Read/Write Precompiles)

Hyperliquid provides read and write precompiles to directly access L1 functions without cross-chain complexity.

• Read Precompiles

  • Addresses: Start at 0x0000000000000000000000000000000000000800.

  • Capabilities: Query perps positions, spot balances, vault equity, staking delegations, oracle prices, and L1 block numbers.

  • Sync: Always reflects the latest L1 state at EVM block construction.

• Write Precompile

  • Address: 0x3333333333333333333333333333333333333333.

  • Actions: Supports placing IOC orders, transferring assets between vaults or perps, staking, and spot sends—directly from the EVM.

For code samples and full method details, see the L1 Integration Docs.

---

4. Additional Helpers

4.1 Indexing the HyperEVM

Retrieve raw HyperEVM block data from an S3 bucket (s3://hl-testnet-evm-blocks/) to build custom services like block explorers or analytics dashboards—no full node required. Files are stored in MessagePack format, compressed with LZ4, and named by EVM block number.

For more information, visit the Indexing Guide.

4.2 Wrapped Hype

A canonical Wrapped HYPE (WHYPE) contract is deployed at 0x555...5. It mirrors the standard wrapped-ETH design—immutable and lightweight—allowing HYPE to function as an ERC-20 asset within the EVM.

Learn more in the Wrapped HYPE Docs.