HIP-3 の perp 市場を開く
Hyperliquid に HIP-3 の perp 市場を開き、板の薄い初日も取引できるようにする。その値段で決済するものは、押された板や跳ねたオラクルから守る。読む順番、組み合わせる部品、確かめることをまとめた。
完成図
最後には、こうなる。Web 画面から取引できる HIP-3 の perp 市場、板が薄いあいだ相手方になるプール、オラクルが跳ねたらすべてを止める値段の検査が、手元で動いている。下は私たちが実際に動かした画面だ。$10,000 のロングを建てて、そのあと壊れた値段を流した。


動かしてみる (約 24 分)
- 1
上場初日の市場を手元で動かす
約 10 分git clone --recurse-submodules https://github.com/fabrknt/dayone cd dayone && npm install npm run demo見える結果
… ok short settled without a request … ok cleared on a one-sided book all okHyperliquid の値段の precompile を模したローカルのチェーンに、資金を入れたプールと keeper を立てる。建玉、決済、清算、ジャンプのラッチ、取引時間、停止した市場、運営者による終了までを、1 段ずつ確かめながら通す。鍵も資金も要らない。
- 2
画面で取引し、壊れた値段を流す
約 3 分./keeper/dev.sh # chain, pool, keeper, a moving price cd web && npm install && npm run dev # 2nd terminal, from dayone/; open the URL echo 0.85 > /tmp/dayone-shock # after opening a position: a 15% drop見える結果
Paused: the oracle jumped too far since the last accepted price (1501 bp, limit 200) keeper: liquidate(1) skipped: Breach Jump: 1501 over 200画面の開発用ウォレットで、プールを相手に取引できる。最後の 1 行は、SK Hynix 型の壊れた更新の再現だ。ジャンプのラッチがその値段を拒むので、決済も清算もその値段では起きない。
- 3
押された板が拒まれるのを見る
約 1 分cd ~ # a fresh folder, not inside dayone git clone --recurse-submodules https://github.com/fabrknt/hl-price-guard cd hl-price-guard && forge test --match-contract Quickstart -vv見える結果
normal book: accepted at $2427.23 pushed book: rejected, mid vs oracle 20 bp, limit 152 つ目の板は、Papertrade のときのように、オラクルから 20 bp 押されている。値段の検査は、それを拒む。
- 4
自分のコントラクトに検査を入れる
約 5 分cd ~ forge init mymarket && cd mymarket forge install fabrknt/hl-price-guard@v0.4.1 echo 'hl-price-guard/=lib/hl-price-guard/src/' >> remappings.txt # save src/MyMarket.sol (MyMarket, under "Put together") and test/MyMarket.t.sol (below), then: forge test --match-test test_pushedBooktest/MyMarket.t.sol
// SPDX-License-Identifier: Apache-2.0 pragma solidity ^0.8.24; import {HLTest} from "hl-price-guard/test/HLTest.sol"; import {HLPriceGuard} from "hl-price-guard/HLPriceGuard.sol"; import {MyMarket} from "../src/MyMarket.sol"; contract MyMarketTest is HLTest { function setUp() public { installHL(); } function test_pushedBook() public { MyMarket m = new MyMarket(); setBook(ETH, 2427.23e18, 2428.00e18, 2432.00e18, 2432.10e18); vm.expectRevert( abi.encodeWithSelector(HLPriceGuard.PriceRejected.selector, HLPriceGuard.Breach.MidOracle, 20, 15) ); m.price(); } }見える結果
[PASS] test_pushedBook()これで、あなたのコントラクトは検査を通して Hyperliquid のオラクルを読む。押された板には、PriceRejected で失敗する。
- 5
自分の市場のオラクルを動かす(送信なし)
約 5 分cd ~ # needs Rust (cargo) git clone https://github.com/fabrknt/hip3-ops && cd hip3-ops cargo build --release ./target/release/hip3-ops oracle examples/oracle-testnet.toml --ticks 3見える結果
oracle hopsa | 2 asset(s) | every 3000 ms | dry run 1794637678523 hopsa:AAPL=355.62 hopsa:BTC=67334 …次は運営者の側だ。hip3-ops が各価格源から今の値段を読み、テストネットの dex の銘柄ごとに、オラクルの更新値を 3 秒ごとに計算する。送信はしない。同じ道具で、設定の変更の計画、マルチシグでの署名、誰でも計算し直せる受領記録も扱える。
なぜ必要か:実際に起きたこと(実測)
- 2026-10-10 ある財布が、Hyperliquid で ETH の板を $130,873 かけて押した。HL の仲値で決済していた取引所 Papertrade は、その財布に $1.41M を払った(差し引き $1.28M)。同じ 228 のポジションを再生してみると、オラクルで決済しても、取られた額は 15% しか減らなかった。 出典 (新しいタブで開きます)
- 2026-07-27 HIP-3 の運営者が出す xyz:SKHX のオラクルが、1 回の更新で 15.6% 下がり、その後も 1% ずつ下がった。毎回を前回と比べるだけの検査は、$1,000 未満の値段を 39 回通した。ジャンプのラッチは、1 回も通さなかった。 出典 (新しいタブで開きます)
組み立てる:部品
1. 板の薄い初日から取引できるようにする: Day One (新しいタブで開きます)
上場したばかりの HIP-3 の perp のための、損失で積み立てる相手方のプール。守られたオラクル決済(HL Price Guard)、1 分あたりの上限、停止した市場からの出口、keeper、Web 画面がついている。demo は鍵なしで手元で動く(Foundry、Node 24、Python 3、zsh が必要。約 10 分)。監査前、テストネットのみ。
git clone --recurse-submodules https://github.com/fabrknt/dayone
cd dayone && npm install && npm run demo2. HyperEVM のコントラクトを、押されずに HL の値段で決済する: HL Price Guard (新しいタブで開きます)
read は、オラクルから離れた板や mark を拒む。オラクルごと動かす押し方には、独立した参照値、ジャンプのラッチ(HLPriceGuard.observe)、1 分あたりの上限(ExposureBudget.Rolling)を足す。銘柄ごとの上限は docs/safe-limits.md にある。タグを固定して使う。監査前。
forge install fabrknt/hl-price-guard@v0.4.1
echo 'hl-price-guard/=lib/hl-price-guard/src/' >> remappings.txtimport {HLPriceGuard} from "hl-price-guard/HLPriceGuard.sol";
contract MyMarket {
HLPriceGuard.Asset ETH = HLPriceGuard.Asset({dex: 0, index: 1, szDecimals: 4});
HLPriceGuard.Bounds BOUNDS =
HLPriceGuard.Bounds({maxMarkOracleBps: 15, maxMidOracleBps: 15, maxSpreadBps: 10, maxRefOracleBps: 0});
function price() public view returns (uint256) {
// The oracle (1e18), or a revert PriceRejected(reason, observedBps, limitBps).
return HLPriceGuard.read(ETH, BOUNDS, HLPriceGuard.Ref(0, 0, 0));
}
}3. オラクル、市場の設定、鍵を運用する: HIP-3 Ops (新しいタブで開きます)
自分の環境で動かす、資金を預からない Rust の道具。切り替えと取引時間つきのオラクル、市場設定の plan/apply、ネイティブのマルチシグ、方針で検査する署名、計算し直せるオラクルの受領記録、リスクの点数表、公開データから任意の運営者を見張る機能がある。運営者が自分の鍵で動かし、送信はテストネットのみ。RedStone を使うには API キー(HIP3_OPS_REDSTONE_API_KEY)が要る。監査前、AGPL-3.0。
git clone https://github.com/fabrknt/hip3-ops && cd hip3-ops
cargo build --release
./target/release/hip3-ops doctor --all # read-only, mainnet
./target/release/hip3-ops plan examples/paragon-sample.toml # read-only diff against a live dex深く学ぶ(この順で)
- 無期限先物 DEX のしくみ(1〜3): perp、funding、証拠金と清算。
- Hyperliquid のアーキテクチャ(3・4・6・7): チェーン上の板、HyperCore と HyperEVM、清算エンジン、HIP-1 から HIP-3。
- HIP-3 市場の運営(1〜5): 運営者が負うもの、担保の通貨と採算、オラクルの運用、リスク上限、鍵と止め方。
- HyperEVM 開発(4): HyperEVM 側も作るなら:コントラクトから precompile で HyperCore の値段を読む。
本番の前に
- 2 つの事件を、自分の上限で再生する(hl-price-guard の cases/ と docs/safe-limits.md)。 開く (新しいタブで開きます)
- プールや keeper を変えるたびに、Day One の通し試験を回す(npm run demo)。
- 開いた後は、HIP-3 Record で自分の市場の運営操作を公開データと照らす。 開く
- Day One と HL Price Guard は監査前。Day One は HyperEVM のテストネットだけで動いていて、トレーダーには提供していない。
- HIP-3 Ops は監査前で、送信はテストネットだけ。RedStone の経路は、本物の API キーではまだ通していない。
- 1 分あたりの上限の大きさは、1 件の事件からの最初の見積もりだ(hl-price-guard の docs/safe-limits.md)。保証ではない。
通した記録
2026-11-14 新しい環境で通した。fabrknt/dayone を新しく clone し、hl-price-guard v0.4.1 で npm run demo(all ok)と forge test(70 件通過)。keeper/dev.sh と Web 画面で $10,000 のロングを建て、0.85 の値段を流した(停止し、清算は見送り。上の画面)。hl-price-guard の Quickstart(上のとおり accepted と rejected)。fabrknt/hip3-ops を新しく clone し、cargo test(186 件通過)と上のオラクルの試し実行。空の Foundry プロジェクトに v0.4.1 を forge install し、上の MyMarket と試験が通ることも確かめた(forge 1.7.1)。
Fabrknt は独立していて、Hyperliquid とは提携していない。部品は監査前。