本文へ移動
← Uniswap v4 で市場を作る — PoolManager と hook を 2 つの公開プロジェクトから読む
第 3 部 — 自分の値段と、本番への出し方

新しい市場を作る · Uniswap v4

このコースの 8 / 945 分

レッスン8 — hook の安全性と、本番への出し方

出典: Uniswap/v4-core v4.0.0、Uniswap/v4-periphery c6e4754(Shadowbook が固定している版)、psyto/summon-stocks 8a8b464、fabrknt/shadowbook 7ae1dd1、fabrknt/market-state cbfc651(v0.4.0、8a8b464 の Summon が固定している版)と e685ced。

Summon はここから今の main である 8a8b464 を読む。b1dd190(レッスン4〜6)からの違いは README.md と test/SummonRound.t.sol だけだ。hook が断る場面のテストが包まれたエラーを丸ごと確かめるようになり、swap 側の MultiplierMismatch のテストが加わった(59 件)。src/ と script/ は同じだ。

読了目安:約 25 分(手を動かすと 45 分)

検査を 1 行消しても、28 件のテストは全部通る

Shadowbook の NoQuote の行をコメントアウトしても、Shadowbook の 28 件のテストはすべて通る。

hook は swap を断り続ける。ただ、理由が違うだけだ。素の vm.expectRevert() は、どんな理由でも受け入れてしまう。

このレッスンが扱うのは、こういう穴だ。

hook は、PoolManager がすべての swap の途中で呼ぶコードだ。だから hook の間違いは、そのままプールの間違いになる。

このレッスンでは、2 つのプロジェクトがそれにどう備えているかをまとめる。

  • アドレス。 hook が受け取るコールバックはアドレスで決まる。だから hook はデプロイ時に自分のアドレスを確かめ、デプロイの側はちょうどそのビットになる salt を探す。
  • 断り方。 hook は revert で断る。swap した人には、理由が WrappedError に包まれて届く。テストは「何かが revert した」ではなく、その理由まで固定するべきだ。
  • keeper。 多くの hook は keeper が動かす状態を読む。keeper が間違えたとき・黙ったときに何が起きるかを決め、keeper にできることを縛り、keeper が書き込む前に自分の入力を確かめるようにする。

最後にチェックリストを置く。そして本筋の最後の演習として、アドレスを探してそこにデプロイし、テストが見落としていた revert の理由を固定する。

学ぶことは次のとおり。

  • 自己検査と salt の探索がどう組み合わさるか。何がアドレスを変えるか
  • hook が断ったことが呼び出し元にどう届くか。それを正確に確かめる 2 つの書き方
  • keeper が黙ったとき、各プロジェクトが何をするか。間違えた keeper をどう縛るか
  • 稼働中のテストネットで一度 keeper がつまずいた話と、そのあと変わったこと
  • 本物の資金を入れる前の hook のチェックリスト

アドレス: 確かめる、探す、照らし合わせる

PoolManager は、hook のアドレスにビットが立っているコールバックしか呼ばない(レッスン3)。

これを正しくする場所は 3 つある。

1. コンストラクタで。

レッスン3 の演習で、BEFORE_SWAP のない hook が何も revert せずに動くと分かった。そのあと Summon は、b1dd190 でこの検査を足した(src/SummonHook.sol L40-L53)。

constructor(address poolManager_, address deployer_) {
    poolManager = poolManager_;
    deployer = deployer_;
    // The PoolManager calls only the callbacks whose bits are set in this address. Refuse to exist at an
    // address that would skip one of ours (a hook deployed without BEFORE_SWAP would never stop a swap).
    Hooks.validateHookPermissions(IHooks(address(this)), getHookPermissions());
}

/// The callbacks this hook implements; its address must carry exactly these bits.
function getHookPermissions() public pure returns (Hooks.Permissions memory p) {
    p.beforeInitialize = true;
    p.beforeAddLiquidity = true;
    p.beforeSwap = true;
}

あわせてテストも足している。ビットを選んでいない普通の new で hook をデプロイし、拒まれることを確かめるテストだ(test/SummonRound.t.sol L663-L671)。

/// The PoolManager calls a hook only for the bits set in its address. A hook at an address missing one of
/// its bits (here: an ordinary CREATE address) must refuse to deploy, not run with a callback skipped.
function test_hookRefusesAnAddressWithoutItsPermissionBits() public {
    try new SummonHook(address(pm), address(this)) returns (SummonHook h) {
        revert(string.concat("deployed at ", vm.toString(address(h))));
    } catch (bytes memory err) {
        assertEq(bytes4(err), Hooks.HookAddressNotValid.selector);
    }
}

validateHookPermissions は完全一致で比べる(レッスン3)。だから、ビットが余分でも足りなくても同じように失敗する。

これは Shadowbook より SummonHook にとって大事だ。

SummonHook が宣言しているのは 3 つのコールバックだけだ(contract SummonHook {。IHooks も fallback もない、L25)。ほかのコールバックが呼ばれれば revert する。一方の Shadowbook はすべてを実装し、使わないものは HookNotImplemented で revert する。

2. デプロイのスクリプトで。

CREATE2 はコントラクトを keccak256(0xff ++ deployer ++ salt ++ keccak256(initCode)) の末尾 20 バイトに置く(HookMiner.sol L48-L56)。init code にはコンストラクタの引数も入る。

v4-periphery の HookMiner は、下位 14 ビットが一致し、まだ何もデプロイされていないアドレスになるまで salt を試す(test/shared/HookMiner.sol L16-L41、一部省略)。

/// @param deployer The address that will deploy the hook. In `forge test`, this will be the test contract `address(this)` or the pranking address
/// In `forge script`, this should be `0x4e59b44847b379578588920cA78FbF26c0B4956C` (CREATE2 Deployer Proxy)
...
for (uint256 salt; salt < MAX_LOOP; salt++) {
    hookAddress = computeAddress(deployer, salt, creationCodeWithArgs);

    // if the hook's bottom 14 bits match the desired flags AND the address does not have bytecode, we found a match
    if (uint160(hookAddress) & FLAG_MASK == flags && hookAddress.code.length == 0) {
        return (hookAddress, bytes32(salt));
    }
}

つまり見つけた salt が有効なのは、1 つのデプロイ元、1 つのビルド、1 組のコンストラクタ引数に対してだけだ。

どれかを変えれば、アドレスは動く。演習でそれを見る。

3. デプロイのあとで。

どちらのスクリプトも、デプロイされたアドレスを探したアドレスと照らし合わせる。

  • Summon は require(address(hook) == hookAddr, "hook address")(script/Deploy.s.sol L49-L55)
  • Shadowbook は require(address(hook) == at, "hook address")(レッスン3)

結果は公開されている。Base Sepolia の Summon の hook は 0x13F9D81A93Ae3906551cC7D89A99D5b949D3e880 にある(deployments/84532.json L4)。下位 14 ビットは 0x2880 で、テストと同じ 3 つのコールバックだ。

「では、デプロイ済みの hook にはコンストラクタの検査が入っているのか?」

入っていない。

この hook のデプロイは 2026-11-11 で(README L70)、b1dd190 より前だ。だから検査がない版だ。ビットが正しいのは、スクリプトが探して当てたからだ。

検査つきの版は init code が違うので、新しい salt が要る。

断るとは revert すること。だから理由をテストする

どちらの hook も revert で断る。

断られた swap は、まったく起きない。ルーターがその unlock の中でしたほかのことも含めて、トランザクション全体が巻き戻る。

PoolManager は revert を WrappedError(hook, callback, reason, HookCallFailed) で包む(libraries/Hooks.sol L130-L136、libraries/CustomRevert.sol L10-L11。読み方はレッスン5)。レッスン7 の演習 A では、トークンの送金を包む同じ形を見た。

「revert したことさえ確かめれば十分では?」

十分ではない。「revert した」としか言わないテストは、ある拒否と別の拒否を、あるいは関係のないバグを見分けられない。

2 つのプロジェクトは、それぞれ違う方法で理由を固定している。

包まれたエラーを丸ごと期待する。

8a8b464 の Summon のテストは、それを一度だけ組み立てる(test/SummonRound.t.sol L182-L195)。

/// The PoolManager (v4-core v4.0.0) wraps a hook's revert: WrappedError(hook, callback, reason, HookCallFailed).
function _hookError(bytes4 callback, bytes memory reason) internal view returns (bytes memory) {
    return abi.encodeWithSelector(
        CustomRevert.WrappedError.selector,
        address(hook),
        callback,
        reason,
        abi.encodeWithSelector(Hooks.HookCallFailed.selector)
    );
}

function _expectSwapRevert(bytes memory reason) internal {
    vm.expectRevert(_hookError(IHooks.beforeSwap.selector, reason));
}

そしてすべての拒否で使う。たとえば _expectSwapRevert(abi.encodeWithSelector(SummonHook.MarketHalted.selector, halt));(L951)。

8a8b464 より前は、どれも素の vm.expectRevert() だった。

PoolManager になりすましてコールバックを直接呼ぶ。

Shadowbook は 1 つのテストでこうしている(test/Shadowbook.t.sol L335-L343)。

function test_closedSide_errorIsSideClosed() public {
    uint16 closed = hook.CLOSED();
    vm.prank(quoter);
    _post(hook, MID, HALF, closed);
    // the PoolManager wraps hook reverts; check the inner reason via a direct beforeSwap call
    vm.prank(address(manager));
    vm.expectRevert(abi.encodeWithSelector(Shadowbook.SideClosed.selector, false));
    hook.beforeSwap(address(this), key, SwapParams(false, 1e18, MAX_PRICE_LIMIT), ZERO_BYTES);
}

短く書ける。ただ PoolManager を通らないので、swap した人に何が届くかは分からない。

Shadowbook のほかの拒否のテスト(古い気配、気配なし、停止、幅、閉じた側、上限、端数、在庫切れ)は、素の vm.expectRevert() だ(たとえば L153-L160)。

それが検査の抜けを隠す場所を、1 つ見つけた。

NoQuote の行(L240)をコメントアウトしても、Shadowbook の 28 件はすべて通る。なぜか。気配のない hook は、その次の StaleQuote の検査で代わりに失敗するからだ。

演習でこれを固定する。

もう 1 つ、ここに入る守りがある。

外部関数は誰でも呼べる。だから、すべてのコールバックは呼び出し元が PoolManager であることを確かめる必要がある。

SummonHook は最初の行でそうしている(L81、L121)。そのうち 2 つを直接呼ぶテストもある(test_hookRejectsDirectCalls、test_hookRejectsDirectSwapCalls、L683-L687、L1060-L1064)。

Shadowbook は onlyPoolManager 修飾子を使う(src/Shadowbook.sol L92-L95)。

keeper が黙ったとき、間違えたとき、hook はどうするか

このコースの 3 つの hook は、どれもオフチェーンのプログラムが書く状態を読む。Shadowbook の気配、DirectionalFee の参照価格、Summon の市場の状態だ。

それがどれだけ安全かは、2 つの問いで決まる。

keeper が黙ったとき。

keeper が書くもの許された時間より長く黙った一度も書かれていない
ShadowbooksetQuote(quoter)swap は StaleQuote で revert(L241)swap は NoQuote で revert(L240)
DirectionalFeesetRef(keeper)swap は baseFee を払う(レッスン6)swap は baseFee を払う
Summon の swapsetState、heartbeat(guard)swap は 1.00% を払う(レッスン5)(約定の前にプールはない)
Summon の約定同上約定は MarketStateStale で revert約定は revert。updatedAt が 0 なら古いと数える(src/MarketStateCheck.sol L17-L18)

「なぜ、こんなに振る舞いが違うのか?」

どれを選ぶかは、hook が何を守っているかで決まる。

  • Shadowbook は keeper の値段で自分の在庫を売る。だから新しい値段がなければ止まる。
  • DirectionalFee は普通のプールに手数料を上乗せするだけだ。だから参照価格がなければ普通のプールに戻る。
  • Summon は新しい約定を止めるが、すでにあるプールは高い手数料で取引を続けさせる。

どれも「何事もなかったように続ける」ではない。

3 つとも、その選択をコントラクトのコメントに書いている。自分の hook でもそうしてほしい。

keeper が間違えたとき。

間違えた keeper や盗まれた鍵がしでかせることを、コントラクトの中で縛る。

  • Shadowbook。 quoter は owner の幅の外に中値を出せないので、"a bad or compromised quoter can at worst sell inventory at the band's edge"(src/Shadowbook.sol L27-L29)。悪くても、幅の端の値段で在庫を売るところまでだ。期間ごとの約定額の上限は量を絞るもので、README ははっきり "limits volume, not loss from a wrong price; the band does that" と書いている(README L123-L130)。気配はそれぞれ、値段を見た時刻と通し番号を持つ。だから遅れて届いたトランザクションが、古い値段を生き返らせたり、新しい気配を上書きしたりはできない(L137-L153)。
  • DirectionalFee。 owner の決めた範囲のおかげで、間違った参照価格は "only moves swaps between baseFee and a higher fee" にとどまる(レッスン6)。
  • market-state。 ここでは縛りはコードではなく文章だ: "A malicious or compromised updater can mark a halted stock as open. A stopped updater only closes markets. Run the updater yourself, and show users who holds the key."(README L62-L65)。悪意のある updater は止まっている株を開いていると書けるが、止まった updater は市場を閉じるだけ。updater は自分で動かし、誰が鍵を持つかを利用者に示す、ということだ。

keeper 自身の入力。

Summon の guard(ts/guard.ts)は、情報源を読めないときは何も書かない。だからラウンドは閉じた側に倒れる(ts/guard.ts L11-L12): "A closed market writes nothing (a stale state reads as closed). An unreadable feed or price writes nothing either, so rounds fail closed."

状態が変われば、1 件ずつすぐに書く。

変わらない状態は、前回の確認がラウンドの 300 秒の上限に近づいたときに、まとめて 1 回の heartbeat で確認する(L26-L29、L64-L88)。

hook は正しかった。古かったのは keeper の中身だ

テストネットで一度、うまくいかなかったことがある。

Summon の README に記録がある(L71): "a stale v0.2.0 build once read the session as always open, so swaps after the close paid 0.30%."

何が起きたのか。

guard は「開いている」「閉じている」を、market-state の TypeScript 側で決める。その node_modules に残っていた v0.2.0 のビルドは、core-hours というセッション名を知らなかった。

知らない名前は、セッションの検査なしを意味していた。"so the market read open around the clock"(market-state README L86-L89)。

取引時間が終わったあとも、guard は株を開いていると報告した。新しく開いている状態を読んだ hook は、時間中の手数料を取った。

直しは 2 か所に 1 つずつ入った。

  • 部品が閉じた側に倒れる。 market-state v0.4.0 は、知らないセッション名を閉じていると読む(ts/guard.ts L227-L229)。
} else if (name !== "always") {
  // a policy read from JSON can carry any string: an unknown session is not evidence the market is open
  return { halted: true, reason: MARKET_REASON.SESSION_CLOSED, resumeAfter: 0, detail: `unknown session ${JSON.stringify(name)}` };
  • keeper が動き出す前に自分を確かめる。 Summon の guard は、入っているコピーが既知の週末の時刻とセッション開始直後を閉じていると読まない限り、起動を拒む(ts/guard.ts L156-L170)。

hook はずっと正しく動いていて、入力を信じただけだった。

よくある形だ。コントラクトはテストで確かめられる。本番がテストと違うのは、keeper の動く環境のほうだ。

小さなものをもう 1 つ。このコースを書いている途中で見つけた。

market-state の setState は "emits only when the state itself changes" と書いている。だが halted = false で理由が 0 でないときは、呼ぶたびにイベントを出していた。

保存するのは REASON_NONE なのに、送られてきた理由のままで比べていたからだ。

e685ced は保存する値で比べるようにし(src/MarketStateRegistry.sol L60-L73)、テストを 1 つ足した(forge test で 8 件から 9 件)。2026-11-15 に v0.4.1 として出し、Summon もそれに固定した(64bdf98)。

「余分なイベントが出るだけで、バグなのか?」

レジストリは自分のイベントログを "the machine-readable halt notice for participants" と呼んでいる。だから、何も変わっていないのに出るイベントも、バグだ。

本物の資金の前に: どちらも監査を受けていない

どちらのプロジェクトも、監査を受けていない。

  • Summon: "testnet only (Base Sepolia), unaudited, not for real funds"(README L5)
  • Shadowbook: "early and unaudited; not yet deployed"(README L15)

どちらも、別のモデル(Codex)のレビューを承認まで何回も受けた。それでも README には、今も監査前と書いてある。

自分の README にも、事実でなくなるまでその一行を残してほしい。そして小さく始める。Shadowbook の計画は "a small inventory and a narrow band" だ(README L281)。

この 2 つのコードから、習慣をあと 2 つ。

  • 最初の swap ではなく、デプロイで失敗させる。 Shadowbook のコンストラクタは、ゼロの owner や quoter、コードのない PoolManager、おかしな幅、おかしな上限の期間を拒む。テストがそれぞれを試す(src/Shadowbook.sol L102-L124、test L218-L251)。
  • 管理の窓口は小さく、何があるかを書く。 SummonHook の管理用の呼び出しは、デプロイした者による 1 回きりの setFactory だけだ(L55-L60)。代わりに、入力(レジストリ)にそれぞれの持ち主がいる。Shadowbook の owner は全面的に信頼される役で、README はすべての役についてできること・できないことを並べている(README L115-L121)。停止もその 1 つだ(L176-L178)。

チェックリスト

アドレスと権限

  • getHookPermissions がコントラクトの実装するコールバックをちょうど並べ、コンストラクタが Hooks.validateHookPermissions を呼ぶ。
  • 間違ったアドレスに hook をデプロイし、HookAddressNotValid を期待するテストがある。
  • デプロイのスクリプトが、実際にデプロイする者(forge script なら 0x4e59…956C)と最終のコンストラクタ引数で salt を探し、デプロイされたアドレスが探したものと同じことを require する。

コールバック

  • すべてのコールバックが msg.sender == poolManager を確かめ、それぞれを直接呼ぶテストがある。
  • 使わないコールバックは、ビットを立てないか、revert する。
  • 1 つのプール用の hook は、beforeInitialize でそのプールに結びつき、すべてのコールバックでそれを確かめる。

拒否と delta

  • すべての拒否に、WrappedError を丸ごと(または PoolManager として呼んで正確な理由を)期待するテストがあり、拒否する行をどれか外せばテストが失敗する。
  • hook が delta を返すなら、どの経路でも自分の勘定がゼロになり、swap の種類ごと(exact in と out、両方向)のテストがある。
  • 丸めはすべてプールか hook に有利で、その不等式を fuzz テストで確かめている。

keeper

  • keeper の入力ごとに、古いとき・一度も書かれていないときに hook がどうするかを、コントラクトのコメントとテストに書いている。
  • 間違えた keeper や盗まれた鍵が最悪で何をできるかを、コントラクトで縛り、README に書いている。
  • keeper は情報源を読めないときは何も書かず、動き出す前に自分の依存を確かめる。

出す

  • コンストラクタの引数をデプロイ時に確かめる。
  • README に、誰がどの鍵を持つか、何が監査済みで何がそうでないかを書く。
  • 本物のネットワークでは、まず小さな上限(在庫、約定額、幅、ラウンドの大きさ)で始める。

演習: アドレスを探し、理由を固定する

レッスン7 の shadowbook-7ae1dd1 の clone から、新しい作業用のコピーを作る。

rm -rf /tmp/shadowbook-scratch
cp -R shadowbook-7ae1dd1 /tmp/shadowbook-scratch && cd /tmp/shadowbook-scratch
rm -rf cache/fuzz   # no fuzz failures replayed from earlier runs

A. 探して、デプロイし、アドレスを動かす。

test/Mine.t.sol を作る。

// SPDX-License-Identifier: Apache-2.0
pragma solidity 0.8.26;

import {Deployers} from "v4-core/test/utils/Deployers.sol";
import {Hooks} from "v4-core/src/libraries/Hooks.sol";
import {HookMiner} from "v4-periphery/test/shared/HookMiner.sol";
import {Shadowbook} from "../src/Shadowbook.sol";

contract MineTest is Deployers {
    address quoter = makeAddr("quoter");
    uint160 constant FLAGS = uint160(
        Hooks.BEFORE_INITIALIZE_FLAG | Hooks.BEFORE_ADD_LIQUIDITY_FLAG | Hooks.BEFORE_SWAP_FLAG
            | Hooks.BEFORE_SWAP_RETURNS_DELTA_FLAG
    );

    function _args(uint32 maxAge) internal view returns (bytes memory) {
        return abi.encode(manager, address(this), quoter, uint128(50e24), uint128(100e24), maxAge, uint192(100_000e6), uint64(60));
    }

    function _deploy(bytes32 salt, uint32 maxAge) internal returns (Shadowbook) {
        return new Shadowbook{salt: salt}(manager, address(this), quoter, 50e24, 100e24, maxAge, 100_000e6, 60);
    }

    /// In a test the deployer is this contract; under forge script it is the CREATE2 deployer proxy.
    function test_mineAndDeploy() public {
        deployFreshManagerAndRouters();
        (address at, bytes32 salt) = HookMiner.find(address(this), FLAGS, type(Shadowbook).creationCode, _args(2));
        emit log_named_uint("salt", uint256(salt));
        emit log_named_address("hook", at);
        assertEq(address(_deploy(salt, 2)), at);
    }

    /// Mined without BEFORE_SWAP_RETURNS_DELTA: the constructor refuses the address.
    function test_mineWithoutTheDeltaBit() public {
        deployFreshManagerAndRouters();
        uint160 flags = FLAGS & ~uint160(Hooks.BEFORE_SWAP_RETURNS_DELTA_FLAG);
        (, bytes32 salt) = HookMiner.find(address(this), flags, type(Shadowbook).creationCode, _args(2));
        _deploy(salt, 2);
    }

    /// The right salt for maxAge 2, used with maxAge 3: another address.
    function test_otherArgsSameSalt() public {
        deployFreshManagerAndRouters();
        (, bytes32 salt) = HookMiner.find(address(this), FLAGS, type(Shadowbook).creationCode, _args(2));
        _deploy(salt, 3);
    }
}
forge test --mc MineTest -vv

出力はこうだった(ログとまとめ)。

[PASS] test_mineAndDeploy() (gas: 49219603)
Logs:
  salt: 3029
  hook: 0x8F9E0C82aA5856154b0c8f4d7792a82D7f112888

[FAIL: HookAddressNotValid(0x4094aF20E4757AE390183f1f1396c16A37b0a880)] test_mineWithoutTheDeltaBit() (gas: 105672011)
[FAIL: HookAddressNotValid(0x1133842cFB53cd74c26eD9abDcb4B6efC9e91d56)] test_otherArgsSameSalt() (gas: 45154524)
Suite result: FAILED. 1 passed; 2 failed; 0 skipped; …

大事なのは、2 つの失敗のほうだ。下位 14 ビットを読む。

  • 0x2888 はビット 13、11、7、3 で、Shadowbook が求める 4 つだ。
  • 0x4094…a880 の下位 14 ビット(0xa880 & 0x3fff)は 0x2880。つまりビット 13、11、7 で、delta のビットがない。だからコンストラクタが拒んだ。
  • 0x1d56 は、引数を変えた結果たまたまそうなっただけの値だ。

本物のデプロイでは、最後のケースは、ある引数で salt を探して別の引数でデプロイしたスクリプトにあたる。それを捕まえるのが new のあとの require だ。

salt とアドレスは、ビルドとテスト自身のアドレスだけで決まる。だから 7ae1dd1 なら、私たちと同じになるはずだ。

B. テストが見落としていた理由を固定する。

NoQuote の行をコメントアウトして、今あるテストを走らせる。

sed -i '' '240s|^        if (q.updatedAt == 0) revert NoQuote();|        // if (q.updatedAt == 0) revert NoQuote();|' src/Shadowbook.sol   # GNU sed: sed -i without ''
forge test --mc ShadowbookTest
Suite result: ok. 28 passed; 0 failed; 0 skipped; …

test_noQuote_reverts は通ったままだ。その vm.expectRevert() は、代わりに起きた StaleQuote も受け入れてしまう。

git checkout -- src で戻す。それから、理由を固定した同じテスト test/NoQuoteExact.t.sol を足す。

// SPDX-License-Identifier: Apache-2.0
pragma solidity 0.8.26;

import {IHooks} from "v4-core/src/interfaces/IHooks.sol";
import {Hooks} from "v4-core/src/libraries/Hooks.sol";
import {CustomRevert} from "v4-core/src/libraries/CustomRevert.sol";
import {PoolKey} from "v4-core/src/types/PoolKey.sol";
import {Currency} from "v4-core/src/types/Currency.sol";
import {MockERC20} from "solmate/src/test/utils/mocks/MockERC20.sol";
import {Shadowbook} from "../src/Shadowbook.sol";
import {ShadowbookTest} from "./Shadowbook.t.sol";

contract NoQuoteExactTest is ShadowbookTest {
    /// test_noQuote_reverts, with the reason pinned: the PoolManager wraps the hook's NoQuote.
    function test_noQuote_revertsNoQuote() public {
        Shadowbook h2 = _deployHook(address(uint160(FLAGS) ^ (0x5555 << 144)));
        (PoolKey memory k2,) = initPool(currency0, currency1, IHooks(address(h2)), 0, 60, SQRT_PRICE_1_1);
        MockERC20(Currency.unwrap(currency1)).transfer(address(h2), 1_000e6);
        vm.expectRevert(
            abi.encodeWithSelector(
                CustomRevert.WrappedError.selector,
                address(h2),
                IHooks.beforeSwap.selector,
                abi.encodeWithSelector(Shadowbook.NoQuote.selector),
                abi.encodeWithSelector(Hooks.HookCallFailed.selector)
            )
        );
        _swap(k2, true, -1e18);
    }
}

ShadowbookTest を継承しているので、ただの forge test では継承した 28 件がもう一度走る。新しいものだけを選ぶ。

forge test --mt test_noQuote_revertsNoQuote
[PASS] test_noQuote_revertsNoQuote() (gas: 393187)

もう一度 240 行目をコメントアウトして(同じ sed)、走らせ直す。

[FAIL: Error != expected error: WrappedError(0x5555000000000000000000000000000000002888, 0x575e24b4, 0xdaf34ce100000000000000000000000000000000000000000000000000000000000f4240, 0xa9e35b2f) != WrappedError(0x5555000000000000000000000000000000002888, 0x575e24b4, 0xc3186163, 0xa9e35b2f)] test_noQuote_revertsNoQuote() (gas: 393352)

hook は断っている。だが理由は 0xdaf34ce1 = StaleQuote(uint256) で、経過は 0xf4240 = 1,000,000 秒(テストの時計から時刻 0 を引いたもの)だ。0xc3186163 = NoQuote() ではない。

(注:どちらも cast sig で確かめられる。)

git checkout -- src で戻す。

C. 同じことを反対側から(Summon)。

Summon のテストは、8a8b464 で理由を固定した。

停止の規則(109 行目)が違うエラーで revert するようにして、2 つのコミットでテストを走らせる。summon-stocks の checkout がある場所から始める。

rm -rf /tmp/summon-scratch
cp -R summon-stocks /tmp/summon-scratch && cd /tmp/summon-scratch
git fetch origin && git checkout 8a8b464 && git submodule update --init --recursive
rm -rf cache/fuzz
sed -i '' '109s|revert MarketHalted(s.reason);|revert IssuerPaused();|' src/SummonHook.sol
forge test --mc SummonRoundTest
git stash && git checkout b1dd190 && git stash pop
forge test --mc SummonRoundTest
# at 8a8b464
[FAIL: Error != expected error: WrappedError(0x0500000000000000000000000000000000002880, 0x575e24b4, 0x26bbf01b, 0xa9e35b2f) != WrappedError(0x0500000000000000000000000000000000002880, 0x575e24b4, 0x46510f530000000000000000000000000000000000000000000000000000000000000001, 0xa9e35b2f)] test_swapStopsWhileHalted() (gas: 1932917)
Suite result: FAILED. 52 passed; 1 failed; 0 skipped; …
# at b1dd190
Suite result: ok. 52 passed; 0 failed; 0 skipped; …

b1dd190 の停止のテストは、どんな revert でもよしとしていた。だから IssuerPaused(0x26bbf01b)を受け入れた。

8a8b464 では MarketHalted(1) を期待し、違うと言った。

(注:テストは 8a8b464 で 53 件、b1dd190 で 52 件なので、どちらも 52 passed になる。)

git checkout -- src で戻す。

確認すること

  • 探した salt が依存する 3 つを言え、コンストラクタの引数を 1 つ変えるとアドレスが動くのを見た。
  • 0x2888、0x2880、デプロイ済みの Summon の 0x…e880 をコールバックに読み替えられる。
  • 検査を 1 つ外しても素の vm.expectRevert() が通り、同じ編集で自分の WrappedError のテストが失敗するのを見た。
  • このコースの keeper それぞれについて、黙ったときに hook が何をするか、間違えた keeper を何が縛るかを言える。
  • 自分の hook のために、上のチェックリストを手元に置いた。

この先: 端から端まで作ってみる

コースの本筋は、ここまでだ。レッスン9 では、同じ hook を Monad で動かす。

  • プールはキーそのものだ。
  • 残高の変化は、すべて unlock を通る。
  • hook のアドレスが、コールバックを決める。
  • hook は、誰が流動性を足せるか、いつ swap を止めるか、いくら払わせるか、どの値段で約定させるかを決められる。

端から端まで作ってみるなら、レシピ 株の市場を知っている Uniswap v4 プールを開く が、Summon を手元で動かし、Base Sepolia につなぐ。

/parts には、これらのプロジェクトが使う部品(market-state など)が、入れ方の一行とともに並んでいる。