← Kleros Oracle
Hyperliquid · HIP-4 Outcome Markets

You are staking 500,000 HYPE on every settlement decision.

HIP-4 deployers settle their own markets — and validators can slash the stake for markets settled wrong, settled late, or defined ambiguously. Kleros turns settlement from a personal liability into a public, defensible, automated process: an open bonded oracle with a jury of last resort, and an on-chain record proving you followed it.

Talk to us @juanrah on Telegram

Defensible settlements
Every settlement is backed by a public, bonded, challengeable answer — with a Kleros jury as the final word. If validators ever ask, your defense is a URL.
Never late
A relayer settles your markets the moment the oracle finalizes — running on a restricted key that can't touch funds. The 1-week rule stops being your problem.
Verifiable commitment
The market's own on-chain description names the question that governs it. Anyone can check the settlement matched with a single call — and anyone can contest the answer before payouts happen.

Three ways a deployer loses their stake

Hyperliquid's spec makes the deployer the settlement authority — and makes the stake slashable by validator vote on three grounds:

Slashing groundThe exposure
Settled incorrectlyYour private judgment call is the final answer. A contested edge case becomes validators re-litigating your market — with your stake on the table.
Unsettled > 1 weekSettlement ops is a standing obligation. Hyperliquid's own testnet accumulated markets left unsettled for six weeks — the failure mode is real, and it's slashable.
Poorly definedAmbiguity discovered at settlement time is too late. Someone must absorb the judgment — today, that someone is you.

Traders carry the mirror risk: there is no dispute mechanism anywhere in HIP-4. Whoever holds the deployer key decides who gets paid — "trust me" with a bond.

The pattern: outsource truth, keep execution

HyperCore can't read other chains, so no bridge is possible — instead, the deployer pre-commits to an external truth process and automates following it:

  1. Deploy your market from an approved template, as usual.
  2. Bind it — post the question on Reality.eth with a Kleros arbitrator, then name that question inside the market's own resolution criteria, in the template's officialSource keyword. The commitment travels in the market's on-chain description itself — nothing extra to look up. From this moment, your settlement discretion is publicly forfeited. (For templates with no free keyword, an Outcome Oracle Registry on HyperEVM carries the same binding externally.)
  3. Resolve in the open — at settlement time, anyone posts the answer with money behind it. Wrong answers are challengeable at 2× the bond by anyone on earth. Genuinely contested questions go to a Kleros jury, whose ruling is final and overrides all bonds.
  4. Settle automatically — a relayer watches the question and, the moment it finalizes, settles your market to match, signed by a restricted agent key that can't touch funds. Never wrong, never late.

If validators ever question a settlement, your defense is a URL: the question, the bonds, the challenges, the ruling, and the settlement that matches — timestamped and immutable.

A worked example, on-chain

Outcome #11646US Midterms 2026 Senate Control: Democrats v Republicans — deployed from Hyperliquid's own sportsContestWinner template, with the resolution source written into the market's description. The answer was contested on purpose, from two different addresses, so the dispute mechanics are visible. Every step is independently verifiable:

ClaimProof
Market deployed permissionlesslydeploy tx on HyperCore
Resolution source named in the market itselfsame tx — officialSource: reality.eth:0x268339e0…
Question, arbitrator & timing immutablequestion on reality.eth
Answer contested & resolvedsame page — 0.001 Yes0.002 No0.004 Yes → finalized YES
Settlement matches the oraclesettle tx on HyperCoresettleFraction 1.0

Check the last step yourself — no trust in us required:

curl -s -X POST https://api.hyperliquid-testnet.xyz/info \
  -H 'Content-Type: application/json' \
  -d '{"type":"settledOutcome","outcome":11646}'

The toolkit

Everything above is packaged as hip4kit — a reference CLI a deployer runs end to end. It encodes the sharp edges of the HIP-4 deployer API (canonical action serialization, agent-vs-master signing rules, oracle question timing, the settlement latency budget), so your integration takes an afternoon, not a debugging week:

hip4kit activate           # one-time deployer registration
hip4kit ask-question ...   # the question, Kleros arbitrator attached
hip4kit deploy ...         # market from any template, bound to that question
hip4kit watch              # relayer: monitor, settle the moment it finalizes

Your master key signs exactly once (activation). Everything operational runs on a restricted, revocable agent key. The toolkit is open — or integrate the pattern directly into your own stack; nothing about it is proprietary. Write to us for the repo and a guided setup.

Where this goes: making the commitment visible

The template catalog now reaches well past price thresholds — sports contests, rate decisions, and more arriving as Hyperliquid iterates. Those templates settle against an officialSource named in prose, with a fallback to "independent reputable reporting." That is precisely where contested settlements will land, and precisely where a bonded oracle with a jury of last resort belongs.

Because officialSource is free text, the binding above already works — no protocol change, today. What's missing is a type. A typed resolution-source keyword would let the exchange validate the reference at deploy time and let the interface show traders the question, its arbitrator and its live answer, instead of leaving the commitment buried in a description nothing renders. We've put that proposal into Hyperliquid's feedback process. Deployers who adopt the pattern now inherit the visibility the moment it ships.