# 5 分の上がる・下がる市場を開く：チェーン上にある値段だけで決着させる

5 分ごとのラウンドに、プールが 1 つ。始まる前に Up か Down に賭けて、当たった側が外れた側の賭け金を分ける。2 つの値段は、開始と終了それぞれの後で最初に記録された受理できる読みで、チェーン上にすでにある値段から取る。API キーは要らない。Monad の fork で実際の BTC のラウンドを、HyperEVM で記録した実際の NVDA のラウンドを動かし、壊れたオラクルを流して、消した検査をどの試験が捕まえるかを見る。

## 完成図

最後には、新しく clone したところから 2 つの実際のラウンドを動かしている。Monad の mainnet fork の BTC(開始と終了の後の最初の Pyth の更新で決着)と、HyperEVM で生で記録した値で再生する xyz:NVDA だ。板の裏付けのないオラクルが拒まれるのを見て、消した検査をどの試験が捕まえるかも測る。下は、私たちが動かした結果だ。

- 2 つの実際のラウンド。Monad の BTC:開始の 8 秒前に賭け、開始の後(28 秒)と終了の後(2 秒)の最初の Pyth の更新で値段を記録した。Down の勝ち。日曜の xyz:NVDA:オラクルが動かず、同値なので無効。賭け金はすべて戻る。 (https://fabrknt.com/recipes/five-minute-market/rounds.jpg)
- マークから 5.24% 離れたオラクル:PriceRejected(3, 524, 50)。3 は MarkOracle だ。何も記録されず、読みのない区切りは、ラウンドを無効にする。 (https://fabrknt.com/recipes/five-minute-market/refused.jpg)
- unproven が手数料の検査を 1 つずつ消して、試験を走らせ直す。どれも捕まる。最初の測定では、38 の検査のうち 18 を何も捕まえていなかった。 (https://fabrknt.com/recipes/five-minute-market/unproven.jpg)

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

### 1. 2 つの実際のラウンドを動かす (~2 min)

```bash
git clone --recurse-submodules https://github.com/fabrknt/fivemin && cd fivemin   # needs Foundry
forge test --match-test "test_realRound|test_recordedSunday" -vv
```

見える結果:

```
[PASS] test_recordedSundayRound_equalOracle_isVoid() (gas: 383048)
  xyz:NVDA open 161110 / 1000 at the start, close 161110 / 1000 at the end: equal, so the round is void
  every stake back: alice 50, bob 30; no fee
[PASS] test_realRound_btc_downWins() (gas: 502046)
  bets at block 122356650, 8 s before the start: alice Up 100, bob Down 60, carol Down 40
  open  recorded at block 122356773: BTC 64725, published 28 s after the start
  close recorded at block 122357676: BTC 64634, published 2 s after the end
  Down won: bob claims 118.8, carol 79.2, alice 0, fee 2 (2% of the losing side)
```

BTC のラウンドは、Monad の mainnet fork の 3 つの実際のブロックで動く。賭け、開始の後の最初の Pyth の更新、終了の後の最初の更新で、PriceFeedUpdate のログから見つけた。NVDA のラウンドは、HyperEVM で生で記録した値を再生する。なぜ記録なのか。HyperEVM の値段の precompile は、どのブロックを指定しても今の状態を返すからだ。その日曜は米国株が閉まっていて、trade.xyz のオラクルはほとんど動かなかった。株のラウンドは、取引時間内にだけ意味がある。

### 2. 本の裏付けのないオラクルを流す (~1 min)

```bash
forge test --match-test test_oracleAwayFromTheBook -vvvv
```

見える結果:

```
[PASS] test_oracleAwayFromTheBook_isRefused() (gas: 30937)
    ├─ [0] VM::expectRevert(PriceRejected(3, 524, 50))
    ├─ [12895] Hip3Source::read(0x0000000000000000000000000000000000000000000000000000010000000203) [staticcall]
    │   └─ ← [Revert] PriceRejected(3, 524, 50)
```

HIP-3 のオラクルは市場の運営者が決め、無料で比べられる外の値段はない。だから Hip3Source は、hl-price-guard の HLPriceGuard.read を通して読む。スプレッド、マーク、中値が上限(20・50・50 bp。日曜の記録では最大 3.11・3.72・11.79)より離れていれば拒む。運営者がオラクルだけを上限より大きく板から離せば、何も記録されない。上限の内側の小さな動きは、まだ記録されうる。

### 3. 検査を消して、どの試験が気づくかを見る (~5 min)

```bash
cargo install --locked --git https://github.com/fabrknt/unproven --tag v0.2.0   # needs Rust
unproven unproven.toml --only "collectFee"
```

見える結果:

```
baseline: no finding, every test passes
[1/3] collectFee: round is final ...
ok       collectFee: round is final  [test]
           failed: test/FiveMin.t.sol::FiveMinTest::test_collectFee_refusedWhilePending
[2/3] collectFee: once ...
ok       collectFee: once  [test]
           failed: test/FiveMin.t.sol::FiveMinTest::test_fullRound_downWins_feeFromLosersOnly
[3/3] collectFee: no fee on a void round ...
ok       collectFee: no fee on a void round  [test]
           failed: test/FiveMin.t.sol::FiveMinTest::test_collectFee_noFeeOnAVoidRound, test/Hip3Recorded.t.sol::Hip3RecordedTest::test_recordedSundayRound_equalOracle_isVoid
0 by the fuzzer, 3 by a test only, 0 refused by something else, 0 unproven
```

unproven.toml は、契約の 38 の検査と、それぞれを消す編集を並べている。unproven は 1 つずつ当てて forge test --json を走らせ直し、行と結果が違えば落ちる。最初の測定は、予想と行ごとに一致した。20 が捕まり、18 は何も捕まえない。その 18 のうち 3 つは、検査がなければお金を失うものだった(終わっていないラウンドの手数料、無効なラウンドの手数料、Down だけのラウンドで Up が勝つと誰にも払われない)。今は試験が 31 を捕まえる。残る 7 は重複・無害・別の所で拒まれるもので、行ごとに理由を書いた。表全体で約 10 分。

### 4. 自分で生のラウンドを記録する (~2 min)

```bash
python3 script/record_hip3.py 1 2 3 60 live.json   # dex 1 (xyz), asset 2 (NVDA), szDecimals 3, 60 s
```

見える結果:

```
59 samples, 1 errors, blocks 51302798..51302859
```

1 秒に 1 回の JSON-RPC のまとめ呼び出しで、最新の HyperEVM のブロックと、そのブロックでのオラクル・マーク・最良気配の precompile を読む。JSON にすべての標本が入る。記録を試験にする方法は、Hip3Recorded.t.sol にある。眠る PC では取り逃すので、リポジトリの定期実行の GitHub Action が、米国の取引時間のラウンドを記録する。

## なぜ必要か：実際に起きたこと（実測）

- 2026-11-15: 最初の測定では、契約の 38 の検査のうち 18 を、どの試験も捕まえていなかった。そのうち 3 つは、消えればお金を失うものだった。11 に試験を足した。 (https://github.com/fabrknt/fivemin/blob/main/unproven.toml)
- 2026-11-15: レビューで、2 つの穴が見つかった。ラウンドが無効になった後でも、遅い記録が窓の中の時刻の値段を記録できた。ブロックより先の時刻の読みも、受け入れていた。どちらも、試験つきで直した。 (https://github.com/fabrknt/fivemin/commit/b78e526)
- 2026-11-15: 日曜に記録した実際の xyz:NVDA のラウンドは、161.110 で始まり 161.110 で終わった。板は動いたのに、オラクルは 6 分で 2 回しか変わらなかった。株の上場は、取引時間内にだけ動かす意味がある。 (https://github.com/fabrknt/fivemin/blob/main/test/Hip3Recorded.t.sol)

## 組み立てる：部品

### 1. プール、2 つの値段、払い出し: fivemin

https://github.com/fabrknt/fivemin

FiveMin(賭け、記録、結果、受け取り)と 2 つの値段の元:Monad 用の PythPushSource と HyperEVM 用の Hip3Source。Foundry、Apache-2.0、Claude と書いた。

```bash
git clone --recurse-submodules https://github.com/fabrknt/fivemin
```

### 2. 裏付けのあるオラクルを読む: HL Price Guard

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

HIP-3 の板の確認に HLPriceGuard.read、Pyth に PythRef。

```bash
forge install fabrknt/hl-price-guard@v0.4.1
```

### 3. 試験が見逃す検査を知る: unproven

https://github.com/fabrknt/unproven

並べた検査を 1 つずつ消して、試験を走らせ直す。0.2 は forge test --json を読む。CI で回せば、表がコードからずれても気づける。

```bash
cargo install --locked --git https://github.com/fabrknt/unproven --tag v0.2.0
```

## 深く学ぶ（この順で）

1. [Pyth：ネットワークごとの sponsored push feeds](https://docs.pyth.network/price-feeds/core/push-feeds/evm): どのチェーンにどの値段を、どの変化幅と間隔で流しているか。Pyth のページ(2026-11-15 に参照)では、Monad は 52 本。株を 5 分で流すチェーンはない。
2. [Hyperliquid：HyperEVM から HyperCore を読む](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/hyperevm/interacting-with-hypercore): Hip3Source の裏にある読み取りの precompile:オラクル、マーク、板。
3. [fivemin の仕様](https://github.com/fabrknt/fivemin/blob/main/docs/spec.md): なぜ開始時に締め切るのか、なぜ区切りの後の最初の読みなのか、何が未解決かを率直に。

## 本番の前に

- Monad の上場でお金を受ける前に、Pyth の問題(API キーを使う「ある時刻の後の最初の更新」)を閉じる。
- 株は取引時間内だけ上場し、板の上限は自分で記録した値から決める。
- unproven を CI で回して、どの検査の結果(捕まるか、理由つきで捕まらないか)も、気づかないままコードとずれないようにする。誰がプールを運営するか、どこで提供しないかも決める。
- 監査前で、配備もしていない。契約と試験は 2026-11-15 に Claude が書き、設計と検査は人が選んだ。何で確かめたかは、README にある。
- Monad の値段の元には、未解決の問題がある。署名済みの Pyth の更新を持つ人は、区切りの窓の中で一番有利な値段を自分で流してから、記録できる。閉じるには Pyth の「ある時刻の後の最初の更新」の確認が要り、それには API キーが要る。それまでは、テスト用だ。
- HyperEVM では運営者がオラクルを決め、取引でオラクル・マーク・板をまとめて動かすこともできる。板の確認は、運営者が単独でできることを狭めるだけだ。記録する人は、3 秒の窓の中のブロックを選べる。

## 通した記録

2026-11-15: 2026-11-15 UTC に公開リポジトリを新しく clone してたどった(fivemin dfb3353、Foundry 1.7.1、タグから入れた unproven v0.2.0)。手順 1〜4 と、上の出力だ。たどってみると、試験を足した後の unproven.toml の 2 行が古くなっていた。このページを出す前に直した。

Fabrknt は独立していて、Hyperliquid、trade.xyz、Pyth、Monad とは提携していない。fivemin は監査前で、配備しておらず、誰にも提供していない。
