cloudzombie/addresses

Contract Addresses on Hyperliquid

CRITICAL: Never hallucinate a contract address. Wrong addresses mean lost funds. If an address isn't listed here, verify it on https://explorer.hyperliquid.xyz or official Hyperliquid documentation before using it.

---

System Addresses

| Name | Address | What It Does | |------|---------|-------------| | HYPE Bridge (HyperCore → HyperEVM) | 0x2222222222222222222222222222222222222222 | System address for HYPE transfers between layers |

The bridge address is deterministic and canonical. Sending HYPE to this address on HyperEVM moves it to HyperCore. For the reverse (HyperCore → HyperEVM), use the /exchange API with "evmUserModify" or "spotSend" action type.

---

HyperSwap V2

HyperSwap V2 is the primary AMM DEX on HyperEVM. Uniswap V2 compatible.

| Contract | Address | Status | |----------|---------|--------| | HyperSwap V2 Router | 0xb4a9C4a5e4c4D1E5e5C3A7D8B9F0E1A2B3C4D5E6 | Verify on explorer | | HyperSwap V2 Factory | 0xA1B2C3D4E5F6a7b8c9d0e1f2A3B4C5D6E7F8A9B0 | Verify on explorer |

⚠️ IMPORTANT: HyperSwap V2 addresses above are placeholders. Before using, verify the actual deployed addresses at:

• https://explorer.hyperliquid.xyz (search for "HyperSwap" or "UniswapV2Router")
• Official HyperSwap documentation
• The HyperSwap GitHub repository

Never use an address from this file without verifying it onchain first.

To verify an address:

# Check the contract exists and has code
cast code 0xTHEADDRESS --rpc-url https://rpc.hyperliquid.xyz/evm
# Non-empty output = contract deployed at that address

# Check it's a V2 router by calling factory()
cast call 0xTHEADDRESS "factory()(address)" --rpc-url https://rpc.hyperliquid.xyz/evm

---

Native Tokens on HyperEVM

| Token | Address | Decimals | Notes | |-------|---------|----------|-------| | HYPE | Native currency | 18 | Use msg.value, not ERC-20 | | USDC | Verify on explorer | 6 | Bridged from external chains | | WETH | Verify on explorer | 18 | Wrapped ETH bridged to HyperEVM | | WHYPE | Verify on explorer | 18 | Wrapped HYPE (ERC-20 version) |

All token addresses on HyperEVM must be verified on https://explorer.hyperliquid.xyz before use.

---

How to Find Addresses

Via Block Explorer

1. Go to https://explorer.hyperliquid.xyz
2. Search for contract name (e.g., "HyperSwap", "USDC")
3. Verify the source code is verified (green checkmark)
4. Check deployer address and deployment transaction

Via Official Sources

• Hyperliquid docs: https://hyperliquid.gitbook.io/hyperliquid-docs/
• HyperSwap: Check the official HyperSwap documentation or social channels
• Token addresses: Check the Hyperliquid app UI (inspect network calls to find token addresses)

Programmatically

# Verify contract exists
cast code 0xADDRESS --rpc-url https://rpc.hyperliquid.xyz/evm
# Returns bytecode if deployed, "0x" if not

# Verify token symbol
cast call 0xADDRESS "symbol()(string)" --rpc-url https://rpc.hyperliquid.xyz/evm

# Verify token decimals
cast call 0xADDRESS "decimals()(uint8)" --rpc-url https://rpc.hyperliquid.xyz/evm

---

HyperCore Assets (Not Contracts)

HyperCore assets are identified by name in the API, not by address. They do NOT have contract addresses.

Perp markets — use asset index from meta.universe:

meta = requests.post('https://api.hyperliquid.xyz/info',
                     json={'type': 'meta'}).json()
# ETH perp is typically at index 1
# BTC perp is typically at index 0
# Always fetch the index dynamically, never hardcode

Spot markets — use asset ID = 10000 + index:

spot_meta = requests.post('https://api.hyperliquid.xyz/info',
                           json={'type': 'spotMeta'}).json()
# PURR (first HIP-1 token) might be spot index 0 → asset ID 10000
# Always check dynamically

---

Multicall3 on HyperEVM

The standard Multicall3 deployment:

0xcA11bde05977b3631167028862bE2a173976CA11

This CREATE2-deployed contract should be present on HyperEVM. Verify with:

cast code 0xcA11bde05977b3631167028862bE2a173976CA11 --rpc-url https://rpc.hyperliquid.xyz/evm

If it returns code, Multicall3 is available. Use it to batch read calls.

---

Address Safety Rules

1. Never hallucinate addresses. If you're not sure, look it up.
2. Verify before use. Always check bytecode exists at the address.
3. Check the source. Verified contracts on the explorer show source code.
4. Check token identity. Call symbol() and name() on any token address.
5. Cross-reference. Check protocol docs + explorer + GitHub deployments.

One wrong address in production = permanent fund loss. There is no undo.

---

Address Discovery Resources

• HyperEVM Explorer: https://explorer.hyperliquid.xyz
• HyperEVM Testnet Explorer: https://explorer-testnet.hyperliquid.xyz
• Hyperliquid Docs: https://hyperliquid.gitbook.io/hyperliquid-docs/
• HyperCore API (for asset info): POST https://api.hyperliquid.xyz/info with {"type":"meta"}

---

Notes on Address Formats

HyperEVM uses standard EIP-55 checksummed Ethereum addresses. All tools validate checksums automatically.

# Convert to checksummed format
cast to-check-sum-address 0xdeadbeef...

HyperCore uses the same address format but lowercased in API responses. Both formats work — just be consistent in your code.