Uniswap v4 Hooks, Permissioned Logic and Pool-Risk Disclosure Radar
Verified Fact Boundary
1. Uniswap v4 documentation describes v4 as a protocol architecture with hooks and singleton-related design. 2. Uniswap hooks documentation explains hook-based custom logic in the pool lifecycle. 3. Uniswap PoolManager documentation is a source for the core manager surface. 4. Uniswap create-pool documentation is a source for pool creation flow and developer context. 5. A hook-enabled pool can require a different disclosure checklist than a simple token-pair comparison. 6. A radar should separate hook address, permission behavior, approval surface, route, warning, code evidence and stop rule.
Show less
Decision Matrix
Article table: scroll horizontally, or focus the table area and use the arrow keys.
| Check | What it means | Practical action | Unknown to keep explicit |
|---|---|---|---|
| Hook identity | the hook address is part of the pool's operating logic | record hook address and source page before approval | whether a front end hides or abbreviates the hook |
| Lifecycle point | custom logic can run at defined points in the pool lifecycle | state which lifecycle event changes user risk | whether later hook upgrades or wrappers change behavior |
| Approval surface | wallet approvals can expose assets before the user understands hook behavior | stop before unlimited approval until the route is documented | whether approval is routed through an aggregator |
| PoolManager route | core routing matters for state and settlement assumptions | map PoolManager, pool key and hook route | whether the route shown in UI matches transaction calldata |
| Disclosure quality | TVL and fee data do not prove hook safety | require source code, audit or verified warning evidence | whether code verification covers the deployed address |
| Evidence hygiene | wallet and transaction evidence can expose private addresses | retain public contract address, tx hash if needed and stop rule only | whether screenshots reveal balances or strategy timing |
Source Map
- Uniswap Developers: Uniswap v4 Protocol Overview (uniswap-v4-overview)
- Uniswap Developers: Uniswap v4 Hooks (uniswap-v4-hooks)
- Uniswap Developers: PoolManager (uniswap-v4-poolmanager)
- Uniswap Developers: Create a Pool (uniswap-v4-quickstart)
Control Notes
1. Hook identity
Hook identity is the point where public documentation must become an operating rule. In this package, it means the hook address is part of the pool's operating logic. The practical action is to record hook address and source page before approval. The unresolved edge is whether a front end hides or abbreviates the hook, so the article keeps that edge explicit instead of turning it into a reward claim, licensing claim, approval claim, safety guarantee, recovery promise, platform ranking or price implication.
2. Lifecycle point
Lifecycle point is the point where public documentation must become an operating rule. In this package, it means custom logic can run at defined points in the pool lifecycle. The practical action is to state which lifecycle event changes user risk. The unresolved edge is whether later hook upgrades or wrappers change behavior, so the article keeps that edge explicit instead of turning it into a reward claim, licensing claim, approval claim, safety guarantee, recovery promise, platform ranking or price implication.
The operating test is narrow.
3. Approval surface
Approval surface is the point where public documentation must become an operating rule. In this package, it means wallet approvals can expose assets before the user understands hook behavior. The practical action is to stop before unlimited approval until the route is documented. The unresolved edge is whether approval is routed through an aggregator, so the article keeps that edge explicit instead of turning it into a reward claim, licensing claim, approval claim, safety guarantee, recovery promise, platform ranking or price implication.
The operating test is narrow.
4. PoolManager route
PoolManager route is the point where public documentation must become an operating rule. In this package, it means core routing matters for state and settlement assumptions. The practical action is to map PoolManager, pool key and hook route. The unresolved edge is whether the route shown in UI matches transaction calldata, so the article keeps that edge explicit instead of turning it into a reward claim, licensing claim, approval claim, safety guarantee, recovery promise, platform ranking or price implication.
The operating test is narrow.
5. Disclosure quality
Disclosure quality is the point where public documentation must become an operating rule. In this package, it means TVL and fee data do not prove hook safety. The practical action is to require source code, audit or verified warning evidence. The unresolved edge is whether code verification covers the deployed address, so the article keeps that edge explicit instead of turning it into a reward claim, licensing claim, approval claim, safety guarantee, recovery promise, platform ranking or price implication.
The operating test is narrow.
6. Evidence hygiene
Evidence hygiene is the point where public documentation must become an operating rule. In this package, it means wallet and transaction evidence can expose private addresses. The practical action is to retain public contract address, tx hash if needed and stop rule only. The unresolved edge is whether screenshots reveal balances or strategy timing, so the article keeps that edge explicit instead of turning it into a reward claim, licensing claim, approval claim, safety guarantee, recovery promise, platform ranking or price implication.
The operating test is narrow.
Known Unknowns
- whether a front end hides or abbreviates the hook
- whether later hook upgrades or wrappers change behavior
- whether approval is routed through an aggregator
- whether the route shown in UI matches transaction calldata
- whether code verification covers the deployed address
- whether screenshots reveal balances or strategy timing
Practical Takeaway
Uniswap v4 makes pool logic more extensible through hooks, so a useful radar cannot stop at token pair, fee tier or TVL. Uniswap documentation describes v4 as a protocol with singleton architecture and hook-based custom logic, and the hooks documentation explains that hooks can run at defined points in a pool lifecycle. The decision radar is to identify the hook address, permissioned behavior, pool manager route, approval surface, user-facing warning, source code or audit evidence and the stop condition before a wallet treats a pool as ordinary AMM liquidity. The article stops at the evidence boundary. It helps the reader decide what to inspect next without converting public documentation into a promise that a private account, wallet, API key, pool route, stablecoin balance, tokenized asset or policy framework will work under every future condition.
Topic hubs & tools:Compare any two exchangesUniswap profile & fees