HIP-4 documentation

Testnet · Exploratory documentation — not official Hyperliquid documentation.

HIP-4 Contest Contract

Third-party EVM (testnet)
V10x4fd772e5708da2a7f097f51b3127e515a72744bd
V20x6d86b21e853758f5719408633e6bcb2cfd50cf07
Balance
94.37 HYPE
Active deposited balance
Platform fee
0.9% / implicit
V1: 90 bps view · V2: from pools
Active contests
4
IDs: 595, 596, 604, 608
Ownership
0xe21c…0d135
Renounce disabled
Mainnet
Not deployed
Testnet only
Versions
2
V1 reverse-engineered · V2 source + bytecode

Contest lifecycle — V1

  • 1
    OWNER createContest(contestId, entryFee)
  • 2
    Users deposit(contestId, sideId) payable — one deposit per address per side.
  • 3
    Deadline enforced on-chain.
  • 4
    OWNER publishMerkleRoot after finalize flow.
  • 5
    Winners claim with Merkle proof.
  • !
    Refund: refund(contestId, sideId, user)

Contest lifecycle — V2

  • 1
    finalizeContest, publishMerkleRoot, Pausable, Ownable2Step.
  • 2
    deposit(contestId, sideId, deadline) payable.
  • 3
    Leaves: keccak256(abi.encodePacked(index, recipient, amount)); bitmap by index.
  • 4
    claim(contestId, index, recipient, amount, proof[])
  • 5
    Fee via withdrawPlatformFee + accounting fields.

Market types (HyperCore)

Custom
Open questions, N outcomes.
priceBinary
Yes/No threshold markets.
Recurring
15m / 1h / 1d periods.