# HIP-3 の perp 市場を開く

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

## 完成図

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

- 稼働中：プールを相手に $10,000 のロングを建てたところ。 (https://fabrknt.com/recipes/hip3-launch/trade.jpg)
- 15% 下がった値段を流すと、「Paused: the oracle jumped too far since the last accepted price（1501 bp、上限 200）」。その値段では、何も決済されない。 (https://fabrknt.com/recipes/hip3-launch/paused.jpg)

## 動かしてみる (~24 min)

### 1. 上場初日の市場を手元で動かす (~10 min)

```bash
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. 画面で取引し、壊れた値段を流す (~3 min)

```bash
./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 min)

```bash
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. 自分のコントラクトに検査を入れる (~5 min)

```bash
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`:

```solidity
// 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 min)

```bash
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% しか減らなかった。 (https://github.com/fabrknt/hl-price-guard/tree/main/cases/papertrade-20261010)
- 2026-07-27: HIP-3 の運営者が出す xyz:SKHX のオラクルが、1 回の更新で 15.6% 下がり、その後も 1% ずつ下がった。毎回を前回と比べるだけの検査は、$1,000 未満の値段を 39 回通した。ジャンプのラッチは、1 回も通さなかった。 (https://github.com/fabrknt/hl-price-guard/tree/main/cases/skhx-20260727)

## 組み立てる：部品

### 1. 板の薄い初日から取引できるようにする: Day One

https://github.com/fabrknt/dayone

上場したばかりの HIP-3 の perp のための、損失で積み立てる相手方のプール。守られたオラクル決済(HL Price Guard)、1 分あたりの上限、停止した市場からの出口、keeper、Web 画面がついている。demo は鍵なしで手元で動く(Foundry、Node 24、Python 3、zsh が必要。約 10 分)。監査前、テストネットのみ。

```bash
git clone --recurse-submodules https://github.com/fabrknt/dayone
cd dayone && npm install && npm run demo
```

### 2. HyperEVM のコントラクトを、押されずに HL の値段で決済する: HL Price Guard

https://github.com/fabrknt/hl-price-guard

read は、オラクルから離れた板や mark を拒む。オラクルごと動かす押し方には、独立した参照値、ジャンプのラッチ(HLPriceGuard.observe)、1 分あたりの上限(ExposureBudget.Rolling)を足す。銘柄ごとの上限は docs/safe-limits.md にある。タグを固定して使う。監査前。

```bash
forge install fabrknt/hl-price-guard@v0.4.1
echo 'hl-price-guard/=lib/hl-price-guard/src/' >> remappings.txt
```

```solidity
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

https://github.com/fabrknt/hip3-ops

自分の環境で動かす、資金を預からない Rust の道具。切り替えと取引時間つきのオラクル、市場設定の plan/apply、ネイティブのマルチシグ、方針で検査する署名、計算し直せるオラクルの受領記録、リスクの点数表、公開データから任意の運営者を見張る機能がある。運営者が自分の鍵で動かし、送信はテストネットのみ。RedStone を使うには API キー(HIP3_OPS_REDSTONE_API_KEY)が要る。監査前、AGPL-3.0。

```bash
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）](https://fabrknt.com/hip3/ja/learn/how-perpetual-dexs-work/index.html): perp、funding、証拠金と清算。
2. [Hyperliquid のアーキテクチャ（3・4・6・7）](https://fabrknt.com/hip3/ja/learn/hyperliquid-architecture/index.html): チェーン上の板、HyperCore と HyperEVM、清算エンジン、HIP-1 から HIP-3。
3. [HIP-3 市場の運営（1〜5）](https://fabrknt.com/hip3/ja/course/index.html): 運営者が負うもの、担保の通貨と採算、オラクルの運用、リスク上限、鍵と止め方。
4. [HyperEVM 開発（4）](https://fabrknt.com/hip3/ja/learn/hyperevm-development/04-l1-precompiles.html): HyperEVM 側も作るなら：コントラクトから precompile で HyperCore の値段を読む。

## 本番の前に

- 2 つの事件を、自分の上限で再生する（hl-price-guard の cases/ と docs/safe-limits.md）。 (https://github.com/fabrknt/hl-price-guard/tree/main/cases)
- プールや keeper を変えるたびに、Day One の通し試験を回す（npm run demo）。
- 開いた後は、HIP-3 Record で自分の市場の運営操作を公開データと照らす。 (https://fabrknt.com/hip3/ja/record/index.html)
- 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 とは提携していません。部品は監査前です。
