本文へ移動
← 市場レシピ

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

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

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

完成図

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

Base支持者USDC を約束SummonRound今の値段 +1% までで約定市場が開いているときだけ約定する人株の保有者なら誰でもプールを作れるのはラウンドだけUniswap v4 プール + SummonHookLP は支持者のもの停止と分割のあいだスワップを止める取引時間中 0.30%・時間外 1.00%market-state停止・取引時間値段Pyth・guard(テストネット)
募集中のラウンド:$300 のうち $50。ラウンドは、市場が開いているときに今の値段でだけ約定する(AMC にはまだテストネットの値段がないので、このラウンドは待っている)。
募集中のラウンド:$300 のうち $50。ラウンドは、市場が開いているときに今の値段でだけ約定する(AMC にはまだテストネットの値段がないので、このラウンドは待っている)。
呼ばれた株と支持者のプール:「Pool fee now 1.00%(米国の取引時間外なので 0.30% ではなく 1.00%)」。見積もりはフックを通している。
呼ばれた株と支持者のプール:「Pool fee now 1.00%(米国の取引時間外なので 0.30% ではなく 1.00%)」。見積もりはフックを通している。

動かしてみる (約 11 分)

  1. 1

    フックの決まりを確かめる

    約 5 分
    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. 2

    約定に使う値段を読む

    約 1 分
    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. 3

    Base Sepolia の今のラウンドで画面を開く

    約 3 分
    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. 4

    停止でプールが止まるのを、チェーン上で見る

    約 2 分
    # 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 を呼べるので、最初に取引した人が差額を取ることはできない。

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

組み立てる:部品

1. ラウンド、ファクトリー、株の市場を知っているプールのフック: Summon (新しいタブで開きます)

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

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

2. 市場が閉じているか停止しているときは、閉じる側に倒す: market-state (新しいタブで開きます)

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

forge install fabrknt/market-state@v0.4.1

3. 参照値を安全に読む: HL Price Guard (新しいタブで開きます)

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

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

深く学ぶ(この順で)

  1. Uniswap v4:フック (新しいタブで開きます): フックの権限、アドレスのフラグ、各コールバックでできること。
  2. Summon の仕様(r5)とレビューの記録 (新しいタブで開きます): ラウンド、値段の計算、株の市場を知っているプール。8 回のレビューを通した形。
  3. market-state (新しいタブで開きます): トークン化株式の停止と取引時間の状態、そして登録簿が「閉じる側」に倒れるべき理由。

本番の前に

通した記録

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