# 株の市場を知っている Uniswap v4 プールを開く

Summon のやり方で、トークン化株式を Base に呼ぶ。支持者が約束金を出す。市場が開いているときだけ、保有者が今の値段で約定する。株は Uniswap v4 プールつきで届き、そのフックは停止や分割のあいだスワップを止め、取引時間外は手数料を上げる。

## 完成図

最後には、Summon の画面が手元で動き、Base Sepolia の今のラウンドを読んでいる。約束金が集まっている途中のラウンドと、呼ばれた株が支持者の v4 プールで取引されている様子だ。値段は、プールとそのフックを通して見積もる。下は私たちが実際に動かした画面だ。

- 募集中のラウンド:$300 のうち $50。ラウンドは、市場が開いているときに今の値段でだけ約定する(AMC にはまだテストネットの値段がないので、このラウンドは待っている)。 (https://fabrknt.com/recipes/stock-aware-pool/round.jpg)
- 呼ばれた株と支持者のプール:「Pool fee now 1.00%(米国の取引時間外なので 0.30% ではなく 1.00%)」。見積もりはフックを通している。 (https://fabrknt.com/recipes/stock-aware-pool/pool.jpg)

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

### 1. フックの決まりを確かめる (~5 min)

```bash
git clone --recursive https://github.com/psyto/summon-stocks
cd summon-stocks
forge test
```

見える結果:

```
[PASS] test_hookRefusesAnAddressWithoutItsPermissionBits()
[PASS] test_onlyTheRoundInitializesItsPool()
[PASS] test_onlyTheRoundAddsLiquidity()
[PASS] test_swapStopsWhileHalted()
[PASS] test_swapFeeRisesWhileClosed()
[PASS] test_swapStopsWhileTheRegistryDisagrees()
…
59 tests passed, 0 failed
```

フックが使う権限は、beforeInitialize、beforeAddLiquidity、beforeSwap の 3 つ。プールを作れるのも流動性を足せるのもラウンドだけなので、ポジションは支持者だけのものになる。権限とアドレスのビットが合わなければ、フックは配備を拒む。株の停止中、発行体がトークンを一時停止しているあいだ、コーポレートアクションの前後、分割の倍率が古いあいだは、スワップが止まる。手数料は取引時間中 0.30%、時間外か guard が黙っているあいだは 1.00%。Foundry が要る。鍵は要らず、clone の後はネットワークも要らない(初回はコンパイラを取得することがある)。

### 2. 約定に使う値段を読む (~1 min)

```bash
npm install
npm run guard -- --quote GME SOFI   # read-only: prints, writes nothing
```

見える結果:

```
GME 25.605 ±0.05630000000000024 Hyperliquid HIP-3 xyz:GME oracle
SOFI 15.2801 ±1.2156500000000001 Hyperliquid HIP-3 para:SOFI oracle
```

テストネットでは、guard がこの参照値を約定用に書き込む(Pyth に載っている株なら、ラウンドは Pyth を読む)。約定はこの値の最大 1% 上までで、米国の市場が開いているときだけ。それをラウンドがチェーン上の market-state の登録簿で確かめる。テストネットでは、その登録簿に guard が書き込んでいる。

### 3. Base Sepolia の今のラウンドで画面を開く (~3 min)

```bash
cd web && npm install
printf 'GEO_BLOCK=off\n' > .dev.vars   # locally; the site is closed to US visitors
npm run build && npx wrangler dev   # open the URL it prints
```

見える結果:

```
LIVE NOW · 2 ROUNDS   sAMC Open   sSOFI Filled
Pool fee now 1.00%: the US session is closed: 1.00% instead of 0.30%
```

画面の数字は、すべてチェーンから読んでいる。約束金と約定はラウンド自身の計算で、スワップの見積もりはプールとそのフックを通している(Uniswap の V4Quoter)。ウォレットをつないで、テスト用の USDC を約束するのは任意だ。

### 4. 停止でプールが止まるのを、チェーン上で見る (~2 min)

```bash
# no command: open the recorded transactions on Base Sepolia (README, "The full flow", step 7)
# a manual halt → a swap refused → restored → swaps again
```

見える結果:

```
halt (manual)  →  swap refused: MarketHalted(5)  →  restored  →  swap succeeds
```

この停止は再現だ。テストネットでは guard の鍵が登録簿に書き込み、取引所の停止の代わりに手動の停止(理由 5)を入れた。フックはそれを読み、解除されるまでスワップを拒んだ。別の記録(手順 8)には 2:1 の分割がある。その期間と、古い倍率のままのスワップは止まる。そのあと誰でも realign を呼べるので、最初に取引した人が差額を取ることはできない。

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

- 2026-11-07: Coinbase は Base に 298 のトークン化株式(B20)を登録していたが、227 は一度も発行されていなかった。発行されたものの一部(DJT、AMC、GME)にも、取引できるプールがなかった。数えるスクリプトは 2026-11-14 に、登録 358、未発行 286 を読んだ。 (https://github.com/psyto/summon-stocks#readme)
- 2026-11-11: 作っている途中で、古い market-state が取引時間を「常に開いている」と読み、時間外のスワップが 1.00% ではなく 0.30% で通った。直しは部品の側に入れた。知らない取引時間の名前は、今は「閉じている」と読む(market-state v0.4.0)。 (https://github.com/fabrknt/market-state/issues/1)

## 組み立てる：部品

### 1. ラウンド、ファクトリー、株の市場を知っているプールのフック: Summon

https://github.com/psyto/summon-stocks

SummonRound(約束金、上限つきの競り、返金、LP)、SummonFactory、SummonHook(beforeInitialize、beforeAddLiquidity、beforeSwap)、SummonSwap と、Foundry の試験 59 件。TypeScript の guard と keeper。Cloudflare Worker の画面。Apache-2.0、Base Sepolia のみ。

```bash
git clone --recursive https://github.com/psyto/summon-stocks
```

### 2. 市場が閉じているか停止しているときは、閉じる側に倒す: market-state

https://github.com/fabrknt/market-state

競りの開始と約定のたびに MarketStateCheck.requireOpen。NYSE の休日と短縮取引、core-hours の時間帯、Nasdaq Trader の停止を読む guard。更新が止まると、登録簿は閉じる側に倒れる。

```bash
forge install fabrknt/market-state@v0.4.1
```

### 3. 参照値を安全に読む: HL Price Guard

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

Pyth の読み取りと信頼区間の PythRef、そして JumpLatch。Summon にはさらに 2 つ要ったので、回避せずに部品の側に足した。Pyth だけの古さの検査 readFresh(v0.3.2)と、約定者が新しい値の中から選べないようにする readFirstAfter(v0.4.0)だ。

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

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

1. [Uniswap v4：フック](https://docs.uniswap.org/contracts/v4/concepts/hooks): フックの権限、アドレスのフラグ、各コールバックでできること。
2. [Summon の仕様（r5）とレビューの記録](https://github.com/psyto/summon-stocks/blob/main/docs/specs/001-summon.md): ラウンド、値段の計算、株の市場を知っているプール。8 回のレビューを通した形。
3. [market-state](https://github.com/fabrknt/market-state): トークン化株式の停止と取引時間の状態、そして登録簿が「閉じる側」に倒れるべき理由。

## 本番の前に

- 約定の 8 つの確認や、フックの 6 つの決まりのどれを外しても、試験が落ちる。フックを変えるときも、そのままにしておく。
- 取引開始の前に guard を動かし、入っている market-state が週末と最初の 15 分を「閉じている」と読むことを確かめる(そうでなければ guard は起動しない)。
- Summon は Base Sepolia だけで動いている。トークンは価値のないテスト用で、監査前。画面は公開ホストしておらず、米国の人には提供していない。
- テストネットの約定は、すべて guard の値段(その市場の運営者が出す Hyperliquid HIP-3 のオラクル価格)で決まっている。デモ用のデータにすぎない。Pyth の経路は、単体試験でしか確かめていない。
- Base の Stocks Maxxing クエストへの参加作品で、Base・Coinbase とは提携も推薦もない。
- 本番で誰が約定するかは、まだ決まっていない。keeper はどの保有者でも動かせる見本で、約束された値付け業者ではない。

## 通した記録

2026-11-14: 公開リポジトリからたどった。新しく clone して forge test(57 件通過。フックが権限のビットを確かめるようにした b1dd190 以降は 58 件、2026-11-14 の 8a8b464 では 59 件)。SSH の鍵なしで npm ci。上の読み取り専用の guard の値。Web 画面を手元でビルドして開き、Base Sepolia の今のラウンドを読むところまで(上の画面)。停止、分割、手数料の段は、2026-11-11 と 11-12 に Base Sepolia に記録された取引だ。

Fabrknt は独立しており、Hyperliquid とは提携していません。部品は監査前です。
