本文へ移動
← 市場レシピ

HIP-3 の perp 市場を開く

Hyperliquid に HIP-3 の perp 市場を開き、板の薄い初日も取引できるようにする。その値段で決済するものは、押された板や跳ねたオラクルから守る。読む順番、組み合わせる部品、確かめることをまとめた。

今すぐ動かす(約 24 分) ↓AI エージェント向けに、同じレシピを Markdown で: /llms/ja/recipes/hip3-launch.md

完成図

最後には、こうなる。Web 画面から取引できる HIP-3 の perp 市場、板が薄いあいだ相手方になるプール、オラクルが跳ねたらすべてを止める値段の検査が、手元で動いている。下は私たちが実際に動かした画面だ。$10,000 のロングを建てて、そのあと壊れた値段を流した。

HyperCoreHIP-3 の市場:板とオラクルHIP-3 Ops:オラクル・設定・鍵precompile で値段を読むHyperEVMHL Price Guard乖離・ジャンプのラッチ・1 分の上限Day One のプール板が薄いあいだ相手方になるkeeper:決済・清算トレーダー・Web 画面
稼働中:プールを相手に $10,000 のロングを建てたところ。
稼働中:プールを相手に $10,000 のロングを建てたところ。
15% 下がった値段を流すと、「Paused: the oracle jumped too far since the last accepted price(1501 bp、上限 200)」。その値段では、何も決済されない。
15% 下がった値段を流すと、「Paused: the oracle jumped too far since the last accepted price(1501 bp、上限 200)」。その値段では、何も決済されない。

動かしてみる (約 24 分)

  1. 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 ok

    Hyperliquid の値段の precompile を模したローカルのチェーンに、資金を入れたプールと keeper を立てる。建玉、決済、清算、ジャンプのラッチ、取引時間、停止した市場、運営者による終了までを、1 段ずつ確かめながら通す。鍵も資金も要らない。

  2. 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. 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 15

    2 つ目の板は、Papertrade のときのように、オラクルから 20 bp 押されている。値段の検査は、それを拒む。

  4. 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_pushedBook

    test/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

    自分の市場のオラクルを動かす(送信なし)

    約 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 秒ごとに計算する。送信はしない。同じ道具で、設定の変更の計画、マルチシグでの署名、誰でも計算し直せる受領記録も扱える。

なぜ必要か:実際に起きたこと(実測)

組み立てる:部品

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 demo

2. 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.txt
import {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

深く学ぶ(この順で)

  1. 無期限先物 DEX のしくみ(1〜3): perp、funding、証拠金と清算。
  2. Hyperliquid のアーキテクチャ(3・4・6・7): チェーン上の板、HyperCore と HyperEVM、清算エンジン、HIP-1 から HIP-3。
  3. HIP-3 市場の運営(1〜5): 運営者が負うもの、担保の通貨と採算、オラクルの運用、リスク上限、鍵と止め方。
  4. HyperEVM 開発(4): HyperEVM 側も作るなら:コントラクトから precompile で HyperCore の値段を読む。

本番の前に

通した記録

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 とは提携していない。部品は監査前。