レッスン4 — プールを作り、流動性を足せるのは誰か
出典: Uniswap/v4-core
v4.0.0、psyto/summon-stocksb1dd190、fabrknt/shadowbook7d07439。このレッスンから、Summon は 2026-11-14 以降の main である
b1dd190で読む。d4debb7に、レッスン3 の日付つきの注記で触れた権限の自己検査(SummonHook のコンストラクタでのgetHookPermissionsとvalidateHookPermissions、テスト 1 件、計 58 件)を足した版だ。レッスン1〜3 はd4debb7のまま。このレッスンが引くファイルのうち、SummonHook.solとテストファイル以外は 2 つのコミットで同一である。読了目安:約 20 分(手を動かすと 35 分)
検査を 1 行外すと、ラウンドより先に他人がプールを作れる
PoolManager は、相手が誰かを聞かない。
正しいキーなら、誰でもプールを初期化できる。どのプールにも、誰でも流動性を足せる。あるキーで最初に initialize した者が勝ち、2 回目以降はすべて revert する。
「じゃあ、誰が断れるの?」断れるのは、キーに書かれた hook だけだ。
hook は、プールが作られる前と、流動性が足されるたびに、PoolManager を呼んだアドレスを渡されて呼ばれる。
SummonHook は、そのアドレスが、ファクトリーがそのキーに登録したラウンドでなければ断る。
だからプールはラウンドが作り、LP ポジションはラウンドの支援者だけのものになる。
このレッスンではこの検査を読み、Shadowbook の 2 つの hook と比べる。そのあと作業用のコピーで検査を外し、どのテストが気づくか、外部の者に何ができるようになるかを確かめる。
initializeとmodifyLiquidityが呼び出し元について何を検査するか(何もしない)と、hook に何を渡すか(sender)- SummonHook が、プールのキーに対して許された唯一のラウンドをどう見つけるか:ファクトリーの
roundForPool登録簿 - それが Summon で特に重要な理由:事前に分かっているプールのキーと、プールに支援者のポジションしかないことを前提にした価格の合わせ直し
- 「誰ができるか」への 3 つの答え:Summon、Shadowbook、DirectionalFee
PoolManager は、呼んだのが誰かを確かめるのか:確かめない
レッスン1 の initialize をもう一度見てほしい(PoolManager.sol L116-L141)。
検査はすべてキーに対するものだ。tick spacing、通貨の順序、矛盾のない hooks アドレスだけ。
msg.sender の検査はない。レッスン2 で引いたとおり、unlock すら要らない。
2 回目の initialize を止めるのは、プール自身の状態だ(libraries/Pool.sol L100-L107)。
function initialize(State storage self, uint160 sqrtPriceX96, uint24 lpFee) internal returns (int24 tick) {
if (self.slot0.sqrtPriceX96() != 0) PoolAlreadyInitialized.selector.revertWith();
tick = TickMath.getTickAtSqrtPrice(sqrtPriceX96);
// the initial protocolFee is 0 so doesn't need to be set
self.slot0 = Slot0.wrap(bytes32(0)).setSqrtPriceX96(sqrtPriceX96).setTick(tick).setLpFee(lpFee);
}
つまり、プールのキーは早い者勝ちだ。
しかも、最初に呼んだ者が初期価格も決める。
modifyLiquidity も同じだ。ロックは要るが、特定の呼び出し元は要らない。
ポジションは、呼び出し元のアドレスの下に記録される(PoolManager.sol L157-L166):owner: msg.sender。
これで、他人にポジションを外されることはない。だが、他人が自分のポジションを隣に足すことは止められない。
PoolManager が hook に伝えるのは、誰が自分を呼んだかだ。
流動性を足す前に、自分の msg.sender を渡して hook を呼ぶ(libraries/Hooks.sol L194-L205)。
function beforeModifyLiquidity(
IHooks self,
PoolKey memory key,
IPoolManager.ModifyLiquidityParams memory params,
bytes calldata hookData
) internal noSelfCall(self) {
if (params.liquidityDelta > 0 && self.hasPermission(BEFORE_ADD_LIQUIDITY_FLAG)) {
self.callHook(abi.encodeCall(IHooks.beforeAddLiquidity, (msg.sender, key, params, hookData)));
} else if (params.liquidityDelta <= 0 && self.hasPermission(BEFORE_REMOVE_LIQUIDITY_FLAG)) {
self.callHook(abi.encodeCall(IHooks.beforeRemoveLiquidity, (msg.sender, key, params, hookData)));
}
}
beforeInitialize も同じように渡す(L177-L181、レッスン3 で引用)。
インターフェースは、この引数を「The initial msg.sender for the initialize call」(initialize を最初に呼んだ msg.sender、IHooks.sol L17)と説明している。hook については「Should only be callable by the v4 PoolManager」(v4 の PoolManager からだけ呼べるべき、L14)とある。
sender で絞る hook にとって、ここから 2 つのことが言える。
senderは、PoolManagerを呼んだ者だ。 利用者がルーターやポジションマネージャーを通すなら、senderは利用者ではなくルーターになる。senderで絞る方法が効くのは、信頼する相手が自分でPoolManagerを呼ぶ場合だ。SummonRoundは自分のunlockの中でそうしている(レッスン2)。senderは、ただの引数だ。 誰でも hook を直接呼んで、好きなアドレスを渡せる。だから hook は、msg.senderがPoolManagerであることも確かめなければならない。
なぜ Summon は、開けたままにできないのか
プールのキーは、プールより先に分かっている。
ラウンドは、トークン、USDC、2 つの定数、hook からキーを組み立てる(src/SummonRound.sol L216-L221、レッスン1 で読んだ)。
ラウンドに固有のものは入っていない。だからキーは、ラウンドが開いた時点で誰にでも分かる。
プールを作る約定は、それより何週間も後になることがある(ラウンドは最長 30 日)。
誰でも初期化できるなら、外部の者が好きな価格で先にプールを作れてしまう。
するとラウンドの fill は、中の pm.initialize で PoolAlreadyInitialized により revert する。同じ株の後のラウンドもすべて同じキーを組み立てるので、どれも約定できない。
演習では、まさにこれを走らせる。
LP ポジションは、支援者だけのもの。
README にこうある。「The pool can only be created by the round, and the backers own the LP position together.」(プールを作れるのはラウンドだけで、LP ポジションは支援者が共同で持つ、README L24-L25)。
レッスン5 で読む株式分割後の価格の合わせ直しは、これを前提にしている。そのコメントの書き出しはこうだ(src/SummonRound.sol L427-L428)。「realign: the pool is empty now, so a swap moves its price and moves no tokens.」(realign: 今プールは空なので、swap は価格を動かし、トークンは動かさない)
これが成り立つのは、ラウンド自身のポジションしかなかった場合だけだ。
hook は、どのラウンドかをどう知るのか:ファクトリーの登録簿に聞く
ファクトリーは、キーのハッシュから、それを使ってよいラウンドへの mapping を 1 つ持っている(src/SummonFactory.sol L60)。
mapping(bytes32 keyHash => address) public roundForPool;
そして、ラウンドを作るときに書き込む(L152-L154)。
latestRound[token] = address(round);
openedAt[address(round)] = uint64(block.timestamp);
roundForPool[keccak256(abi.encode(round.poolKey()))] = address(round);
「誰かが 2 つ目のラウンドを開いて、上書きできてしまうのでは?」
ラウンドは誰でも開ける。ただしオーナーが上場させたトークンに限られ、同じトークンのラウンドが進行中か約定済みなら開けない(L106-L108)。「Anyone may open a round for a listed token, unless one is still running or one already filled (the token then has its Summon pool, and the pool key can only be initialized once).」(上場済みのトークンなら誰でもラウンドを開ける。ただし進行中のラウンドか約定済みのラウンドがあれば開けない。後者ならトークンにはもう Summon のプールがあり、プールのキーは 1 度しか初期化できない)
同じコメントには例外が 1 つあり、ファクトリーの定数がそれを詳しく書いている(L39-L45)。開いてから 1 日以上たち、約束金の集まりが予定のペースより遅れている(または誰も約束していない)ラウンドは、置き換えることができる。ファクトリーは同じトランザクションで、それを取り消す。
どちらにしても、同じトークンの後のラウンドは登録を上書きする。だから、キーが指すラウンドは常に 1 つだ。
hook は、ファクトリーの場所を一度だけ、デプロイした者から教わる(src/SummonHook.sol L55-L60)。「One-time wiring; the factory needs the hook's address and the hook needs the factory's.」(一度だけの配線。ファクトリーは hook のアドレスを、hook はファクトリーのアドレスを必要とする)
そのうえで、2 つのコールバックが同じ検査をする(L62-L74 と L116-L124)。
function beforeInitialize(address sender, PoolKey calldata key, uint160) external view returns (bytes4) {
_requireRound(sender, key);
return IHooks.beforeInitialize.selector;
}
function beforeAddLiquidity(address sender, PoolKey calldata key, IPoolManager.ModifyLiquidityParams calldata, bytes calldata)
external
view
returns (bytes4)
{
_requireRound(sender, key);
return IHooks.beforeAddLiquidity.selector;
}
...
function _roundOf(PoolKey calldata key) internal view returns (address) {
return address(factory) == address(0) ? address(0) : factory.roundForPool(keccak256(abi.encode(key)));
}
function _requireRound(address sender, PoolKey calldata key) internal view {
if (msg.sender != poolManager) revert NotPoolManager();
address round = _roundOf(key);
if (round == address(0) || round != sender) revert NotTheRound(sender);
}
上の 2 点と照らして読んでほしい。
msg.sender の検査で、sender が信用できるものになる。
検索は、hook が呼ばれたときのキーを keccak256(abi.encode(key)) でハッシュする。ファクトリーが保存したのと同じハッシュで、レッスン1 で見たとおり、プールの id とも同じだ。
手数料や tick spacing など、どれか 1 つのフィールドが違うキーは、誰も書き込んでいない項目に当たる。round == address(0) で拒まれる。
2 つのコールバックは、どちらも view だ。hook はプールごとに何も保存せず、毎回ファクトリーに聞く。
(注:SummonHook には beforeRemoveLiquidity のビットがない。要らないからだ。ポジションを外せるのはその持ち主だけで、持ち主はラウンドである。)
「誰ができるか」への 3 つの答え
Summon(SummonHook) | Shadowbook | DirectionalFee | |
|---|---|---|---|
| プールを作る | キーに登録されたラウンドだけ | オーナーだけ、1 回 | オーナーだけ、1 回、動的手数料のときだけ |
| 流動性を足す | そのラウンドだけ | 誰もできない | 誰でも |
| hook が知る方法 | ファクトリーでキーを引く | 最初の initialize でプールの id を保存 | 最初の initialize でプールの id を保存 |
Shadowbook は、オーナーを確かめ、自分を 1 つのプールに結びつける。
(src/Shadowbook.sol L216-L230)
function beforeInitialize(address sender, PoolKey calldata key, uint160) external onlyPoolManager returns (bytes4) {
if (sender != owner) revert NotOwner();
if (bound) revert AlreadyBound();
(poolId, bound) = (key.toId(), true);
return IHooks.beforeInitialize.selector;
}
function beforeAddLiquidity(address, PoolKey calldata, ModifyLiquidityParams calldata, bytes calldata)
external
view
onlyPoolManager
returns (bytes4)
{
revert NoExternalLiquidity();
}
なぜ流動性をすべて断るのか。このプールが曲線ではないからだ。
hook が、すべての swap を自分の在庫で約定させる(レッスン2 の最後の節)。だから、プールにポジションを置いても取引されない。
DirectionalFee の beforeInitialize は、同じ検査に手数料の検査を足したもの。
(src/DirectionalFee.sol L191-L197)。BEFORE_ADD_LIQUIDITY のビットは、そもそも持たない。
README:「One pool, initialized by the owner, which must use the dynamic-fee flag. Anyone can add liquidity; the hook only sets the fee.」(プールは 1 つで、オーナーが動的手数料のフラグで初期化する。流動性は誰でも足せる。hook は手数料を決めるだけ、README L141-L142)
「なら、なぜ Summon には登録簿が要るのか?」
Shadowbook と DirectionalFee のオーナー検査が簡単なのは、どちらの hook も 1 人のオーナーの 1 つのプールにしか使わないからだ。
Summon は 1 つの hook をすべての株のプールで使い、株ごとに新しいラウンドがある。だから、キーからラウンドを引く仕組みが要る。
この規則を守っているテストはどれか
Summon のテストのうち 2 件が、この規則を扱う(test/SummonRound.t.sol L657-L661 と L1000-L1009)。
function test_onlyTheRoundInitializesItsPool() public {
PoolKey memory key = round.poolKey();
vm.expectRevert(); // the PoolManager wraps the hook's NotTheRound
pm.initialize(key, 79228162514264337593543950336);
}
...
function test_onlyTheRoundAddsLiquidity() public {
(, PoolKey memory key,) = _summoned();
PoolModifyLiquidityTest lp = new PoolModifyLiquidityTest(IPoolManager(address(pm)));
usdc.mint(address(this), 1_000e6);
token.mint(address(this), 100e8);
usdc.approve(address(lp), type(uint256).max);
token.approve(address(lp), type(uint256).max);
vm.expectRevert(); // the PoolManager wraps the hook's NotTheRound
lp.modifyLiquidity(key, IPoolManager.ModifyLiquidityParams(-887220, 887220, 1e9, 0), "");
}
2 件目で hook が受け取る sender は、テストコントラクトではなく、v4-core のテスト用ルーター PoolModifyLiquidityTest だ。PoolManager を呼ぶのはルーターだからだ。
引数なしの vm.expectRevert() にも注意してほしい。どんな revert でも通る。
エラーを名指ししなかった理由はコメントのとおりで、PoolManager がそれを包むからだ。包まれたエラーを正確に照合する方法は、レッスン5 で扱う。
演習:作業用のコピーで検査を外す
checkout がある場所(レッスン1 で clone した場所)から始める。
summon-stocks の checkout が b1dd190 より古ければ、fetch で取り込める。
git -C summon-stocks fetch origin
git -C summon-stocks checkout b1dd190 && git -C summon-stocks submodule update --init --recursive
rm -rf /tmp/summon-scratch
cp -R summon-stocks /tmp/summon-scratch && cd /tmp/summon-scratch
rm -rf cache/fuzz # no fuzz failures replayed from earlier runs
forge test --mc SummonRoundTest # 52 passed
A. 誰でも初期化できる。
beforeInitialize の検査(b1dd190 の 63 行目)をコメントアウトする。
sed -i '' '63s|^ _requireRound| // _requireRound|' src/SummonHook.sol # GNU sed: sed -i without ''
git diff
forge test --mc SummonRoundTest
実際の出力(forge 1.7.1、macOS、2026-11-14)。diff の変更 2 行、失敗したテスト、要約の順で、時間は … で切った。
- _requireRound(sender, key);
+ // _requireRound(sender, key);
[FAIL: next call did not revert as expected] test_hookRejectsDirectCalls() (gas: 22833)
[FAIL: next call did not revert as expected] test_onlyTheRoundInitializesItsPool() (gas: 55466)
Suite result: FAILED. 50 passed; 2 failed; 0 skipped; …
失敗は 1 件ではなく 2 件だ。
msg.sender の検査も _requireRound の中にある。だから beforeInitialize を直接呼んでも(test_hookRejectsDirectCalls、L663-L667)、revert しなくなった。
B. 外部の者に、できるようになること。
A の編集を残したまま、自分でテストを 1 つ足す。
テストの setUp と補助関数を継承する。別のアドレスにラウンドのプールを先に初期化させ(ここでは bob。ラウンド以外ならどのアドレスでも同じ)、そのあといつもどおりラウンドを約定させる。
cat > test/FirstToInitialize.t.sol <<'EOF'
// SPDX-License-Identifier: Apache-2.0
pragma solidity 0.8.26;
import {PoolKey} from "v4-core/src/types/PoolKey.sol";
import {SummonRound} from "../src/SummonRound.sol";
import {SummonRoundTest} from "./SummonRound.t.sol";
contract FirstToInitializeTest is SummonRoundTest {
function test_aStrangerCannotInitializeFirst() public {
PoolKey memory key = round.poolKey();
// a stranger tries to create the round's pool first, at a price of their choosing
vm.prank(bob);
try pm.initialize(key, 79228162514264337593543950336) {} catch {}
// the round must still fill and seed its own pool
_start();
_fillAfter(60);
assertEq(uint8(round.state()), uint8(SummonRound.State.Filled));
}
}
EOF
forge test --mt test_aStrangerCannotInitializeFirst
(注:テストコントラクトを継承したコントラクトは、継承元のテストもすべてもう一度走らせる。だから --mt で新しいものだけを走らせる。)
検査を外した状態では(sender と key が使われていないというコンパイラの警告も出る):
Ran 1 test for test/FirstToInitialize.t.sol:FirstToInitializeTest
[FAIL: PoolAlreadyInitialized()] test_aStrangerCannotInitializeFirst() (gas: 861429)
Suite result: FAILED. 0 passed; 1 failed; 0 skipped; …
外部の者の initialize が、1:1 の価格で通った。
ラウンドの約定は、自分の pm.initialize で revert した。
hook を元に戻して、もう一度走らせる。
git checkout -- src
forge test --mt test_aStrangerCannotInitializeFirst
Ran 1 test for test/FirstToInitialize.t.sol:FirstToInitializeTest
[PASS] test_aStrangerCannotInitializeFirst() (gas: 1134040)
Suite result: ok. 1 passed; 0 failed; 0 skipped; …
今度は外部の者の呼び出しが revert し(try … catch が飲み込む)、ラウンドがプールを作った。
ファイルは消しておく:rm test/FirstToInitialize.t.sol。
C. 誰でも流動性を足せる。
今度は beforeAddLiquidity の検査(72 行目)をコメントアウトする。
sed -i '' '72s|^ _requireRound| // _requireRound|' src/SummonHook.sol
forge test --mc SummonRoundTest
[FAIL: next call did not revert as expected] test_onlyTheRoundAddsLiquidity() (gas: 3021892)
Suite result: FAILED. 51 passed; 1 failed; 0 skipped; …
これが価格の合わせ直しに何をするか。それも試した。
同じ作業用のコピーで、PoolModifyLiquidityTest 経由で外部の者のポジションを足し、乗数を 2:1 に変えてから round.realign() を呼ぶテストを書いた。CurrencyNotSettled() で失敗した。
トレースを見ると、理由が分かる。
- 価格を動かすためのラウンドの swap(
amountSpecified: -1)が、外部の者の流動性と約定した。 - ラウンドから USDC を 1 単位取り、価格はそのままだった。
- ラウンドのコールバックはその swap の代金を払わないので、
unlockは借りが残ったまま終わった。
git checkout -- src で戻すと、forge test は再び 58 件通る。
確認すること
-
initializeとmodifyLiquidityが呼び出し元について何を検査するか、同じキーの 2 回目のinitializeがなぜ revert するかを言える。 - 利用者がルーター経由で流動性を足すとき
senderが何になるか、hook がなぜmsg.senderも確かめるかを言える。 - プールのキーを
SummonFactory.openRoundからSummonHook._requireRoundまで追え、手数料が違うキーがなぜ拒まれるかを言える。 -
beforeInitializeの検査を外すと 2 件のテストが失敗し、自分のテストがPoolAlreadyInitialized()で失敗し、戻すと通るのを見た。 - 自分の hook なら、表の 3 行をどう埋めるかが分かっている。
次のレッスン5 では、3 つ目のコールバック beforeSwap を読む。株が止まったとき、プールがどう取引を止めるかだ。