0x04 · open source

Uniswap V4 Docs

Protocol Documentation

Uniswap V4 Docs

Improved protocol documentation and authored delta handling guidance for liquidity modifications.

01 · Requirement Analysis

V4's flash-accounting and unlock-callback model confused integrators — especially how to settle currency deltas after liquidity modifications. The task was to make that flow legible and correct in the official docs.

02 · Architecture Discovery

Read the V4 PoolManager, the unlock callback, and how currency deltas accumulate then settle within a single transaction. Traced real callback paths so each explanation was grounded in actual control flow.

03 · Software Architecture

Documentation structured as guide → concept → reference, with the unlock-callback and delta-handling pages authored as the canonical path integrators follow when modifying liquidity.

04 · Development Principles

Accuracy over the lifecycle ordering, minimal working snippets, single-source-of-truth explanations, and explicit callouts for the invariant — deltas must net to zero before settlement.

05 · Impact

Reduced integration confusion for V4 hook and router authors, establishing a reference path that later contributors extend.

DELTA POOL HOOK