Quick Start
Deploy Your First Contract on HyperEVM
HyperEVM is a fully EVM-compatible smart contract platform on Hyperliquid L1. This guide gets you from zero to a deployed, verified contract on testnet — using Foundry.
Prerequisites
- Foundry installed — curl -L https://foundry.paradigm.xyz | bash
- MetaMask or any EVM wallet
- A Hyperliquid testnet account with some HYPE for gas
1
Add HyperEVM Testnet to Your Wallet
Add via chainlist.org/chain/998 or manually:
| Network Name | HyperEVM Testnet |
| RPC URL | https://rpc.hyperliquid-testnet.xyz/evm |
| Chain ID | 998 |
| Currency Symbol | HYPE |
| Block Explorer | https://testnet.purrsec.com |
The native gas token is HYPE, not PURR. PURR is a community meme token.
2
Get Testnet HYPE
- 1.Go to app.hyperliquid-testnet.xyz and claim testnet USDC from the faucet.
- 2.Swap testnet USDC → HYPE on the testnet exchange.
- 3.Transfer HYPE from HyperCore to your EVM wallet address by sending to the system bridge address:
// Bridge address (HyperCore → HyperEVM)
0x2222222222222222222222222222222222222222
3
Enable Big Blocks
Default (small) blocks have a 2M gas limit — not enough for contract deployment. Switch your address to big blocks (30M gas) first.
Toggle big blocks at:
hyperevm-block-toggle.vercel.app4
Create & Deploy with Foundry
Initialize a new Foundry project
forge init my-hyperevm-contract cd my-hyperevm-contract
Write your contract (src/Counter.sol — already exists in new projects)
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Counter {
uint256 public number;
function setNumber(uint256 newNumber) public {
number = newNumber;
}
function increment() public {
number++;
}
}Deploy to HyperEVM Testnet
forge create src/Counter.sol:Counter \ --rpc-url https://rpc.hyperliquid-testnet.xyz/evm \ --chain-id 998 \ --private-key $PRIVATE_KEY
5
Verify on Purrsec
Use Sourcify — the only working verifier for HyperEVM testnet. Replace <CONTRACT_ADDRESS> with your deployed address.
Verify with Sourcify
forge verify-contract <CONTRACT_ADDRESS> \ src/Counter.sol:Counter \ --chain-id 998 \ --verifier sourcify \ --verifier-url https://sourcify.parsec.finance/verify
View your verified contract on testnet.purrsec.com.