Uniswap V4 Development Book: Swap & Liquidity Insights

Welcome to the world of decentralized finance and automated market makers!

This handbook is your technical guide to one of the most important innovations in DeFi Uniswap v4.

Uniswap v4 introduces a new era of flexibility in AMM design, powered by hooks and a re-architected core contract system. In this handbook, we’ll take a deeply technical journey into how it all works under the hood.

You will learn about:

Liquidity mechanics: the contract architecture and flows behind providing and managing liquidity.
Swap execution: how token swaps are processed step by step in Uniswap V4.
Hooks: what they are, how they extend Uniswap’s functionality, and the security aspects developers must consider.
Security Insights: potential attack surfaces on hooks and best practices for auditing Uniswap V4 hooks based protocols.

Who Is This Handbook For?

This is not a beginner’s guide.

I expect you to already be comfortable with Solidity, EVM fundamentals, and have experience reading and writing smart contracts. If you’re a DeFi developer, smart contract auditor, or blockchain researcher, this handbook is for you.

If you’re just starting with DeFi and blockchains, I recommend first exploring simpler materials on automated market makers (AMMs) and earlier Uniswap versions (V1–V3) before diving in here. This book builds on that foundation and goes much deeper into the internals of V4.

Why This Handbook?

Uniswap V4 is more than just an upgrade, it fundamentally changes how developers can build on top of AMMs:

Hooks turn Uniswap into a programmable liquidity layer.
The new singleton architecture simplifies design but introduces new security considerations.
Protocol builders now have unprecedented flexibility, but also new responsibilities.

This handbook provides step-by-step contract flows, technical deep dives, and security analysis to help you understand and master these mechanics.

Where to Start for a Beginner?

If you’re new to AMMs or Uniswap, here are some recommended resources to build a solid foundation:

Uniswap V1

Programming DeFi: Uniswap Part 1 – Introductory breakdown of Uniswap’s first version.
Programming DeFi: Uniswap Part 2 – In-depth look at V2’s core design.
Programming DeFi: Uniswap Part 3 – Covers advanced applications.

Uniswap V2

Uniswap V2 Course – Cyfrin Updraft – Beginner-friendly walkthrough of V2 mechanics.

Uniswap V3

Uniswap V3 Course – Cyfrin Updraft – Hands-on introduction to advanced concepts.
Uniswap V3 Book – Comprehensive guide to V3’s features.