Uniswap v3 Core: A Deep Dive into Concentrated Liquidity and Protocol Upgrades

·

Uniswap v3 represents a significant evolution in the design of automated market makers (AMMs) on the Ethereum blockchain. This non-custodial protocol introduces groundbreaking features aimed at enhancing capital efficiency, providing greater control for liquidity providers (LPs), and improving the reliability of its price oracle system. This article explores the core innovations and technical architecture of Uniswap v3.

What is Uniswap v3?

Uniswap v3 is a decentralized exchange protocol that allows users to swap Ethereum-based tokens without relying on a traditional order book. Instead, it uses a constant product market maker formula, similar to its predecessors, but with critical enhancements. The most notable advancement is the introduction of concentrated liquidity, which allows LPs to allocate their capital within specific price ranges rather than across the entire price spectrum from zero to infinity.

This design shift means liquidity providers can achieve higher returns on their capital by focusing it where most trading activity occurs. Additionally, v3 introduces multiple fee tiers per token pair, a more flexible governance structure, and substantial upgrades to its price and liquidity oracles.

Key Innovations in Uniswap v3

Concentrated Liquidity

In previous versions, liquidity was distributed uniformly along the x * y = k reserves curve, providing liquidity across all possible prices. This was simple but capital inefficient, as a large portion of the pooled assets sat unused at extreme prices.

Uniswap v3 allows LPs to concentrate their liquidity within an arbitrary price range, defined by upper and lower ticks. Each tick represents a 0.01% (1 basis point) price movement. By bounding their liquidity, LPs can provide the same depth of liquidity within a specific range as they would have across all prices in v2, but with significantly less capital.

When the market price moves within a position's range, it behaves like a constant product pool with larger virtual reserves. If the price moves outside the range, the position becomes inactive and stops earning fees, consisting entirely of one asset until the price reenters the range.

Flexible Fee Tiers

Unlike v2, which had a fixed 0.30% swap fee for all pools, v3 allows for multiple pools per token pair, each with a different fee level. The protocol initially supports three fee tiers: 0.05%, 0.30%, and 1%. This flexibility lets the market decide the appropriate fee for different asset types—lower fees for stablecoin pairs and higher fees for more volatile or illiquid assets.

UNI governance can add new fee tiers in the future, providing ongoing adaptability.

Enhanced Oracle System

Uniswap v3 makes major improvements to its time-weighted average price (TWAP) oracle:

Governance Upgrades

Protocol fees, which are a fraction of swap fees that can be directed to the UNI treasury, are now more flexible. UNI governance can set the protocol fee to any fraction 1/N where 4 ≤ N ≤ 10, or to zero. This parameter can be set on a per-pool basis.

Governance also has the power to add new fee tiers and transfer factory contract ownership.

How Concentrated Liquidity Works: A Technical Overview

The implementation of concentrated liquidity is the most complex and innovative aspect of Uniswap v3.

Ticks and Ranges

The continuous price spectrum is discretized into ticks. Each tick index i corresponds to a price p(i) = 1.0001^i. The square root of the price is stored internally for computational efficiency, as √p(i) = 1.0001^(i/2).

LPs can create positions between any two ticks. However, to prevent excessive gas costs from too many ticks, each pool has a tickSpacing parameter. Only ticks with indices divisible by the tickSpacing can be initialized. For example, a tickSpacing of 60 means only every 60th tick can be used, which corresponds to roughly a 0.60% price movement between initializable ticks for the 0.30% fee tier.

Global State and Swaps

Instead of tracking virtual reserves x and y, the pool contract tracks two key global state variables:

This formulation is gas-efficient because only one variable changes during a swap (√P changes) or a liquidity event (L changes).

For swaps that do not cross a tick, the amount of token out for a given amount of token in is calculated using simple formulas derived from the constant product curve:

If a swap's execution would cross an initialized tick, the swap is processed in segments. At each tick crossing, the contract:

  1. Updates the global liquidity L by adding or subtracting the liquidityNet value stored at that tick.
  2. Updates the tick's feeGrowthOutside and secondsOutside values to flip their perspective relative to the current price.
  3. Continues the swap with the new liquidity value until the next tick is reached or the swap is complete.

Tracking Fees and Seconds

A sophisticated accounting system ensures fees are distributed fairly to LPs based on when their liquidity was active.

A similar system tracks the number of seconds and the secondsPerLiquidity accumulator within specific ranges, which is crucial for external liquidity mining contracts.

Position Management

When an LP creates or modifies a position, the setPosition function handles the update. It first calculates any uncollected fees the position has accrued since its last interaction using the formula:
fees_uncollected = position_liquidity * (f_r(current) - f_r(last))

These fees are credited to the LP. The function then updates the position's liquidity value and the liquidityNet values at the upper and lower ticks. Finally, it calculates the required deposit or withdrawal of tokens based on the current price relative to the position's range, ensuring the position is always fully collateralized.

👉 Explore advanced liquidity providing strategies

Frequently Asked Questions

What is the main advantage of Uniswap v3 over v2?

The primary advantage is significantly increased capital efficiency for liquidity providers. By allowing LPs to concentrate their capital within specific price ranges, they can achieve the same level of liquidity depth as in v2 but with less capital, potentially earning higher returns on their assets.

Can I still provide liquidity across the entire price range like in v2?

Yes, you can simulate a v2-style position by creating a single liquidity position with a lower tick of -887220 and an upper tick of +887220. This covers the vast majority of possible prices, though it is not technically infinite.

What happens if the price moves outside of my liquidity position's range?

When the price exits your specified range, your liquidity becomes inactive and stops earning fees. Your position will be composed entirely of one token (the one that was not depleted). Your liquidity will become active again and begin earning fees if the price moves back into your range.

How do I collect the fees I've earned?

Fees are not automatically reinvested. They accumulate as tokens within the pool contract and must be manually collected by the liquidity provider by calling the collect function, specifying the position and the amount of tokens to collect.

Are Uniswap v3 liquidity positions fungible?

No, because each position is unique based on its price bounds and liquidity amount. The core contract does not issue fungible ERC-20 tokens for liquidity shares. However, third-party projects can create wrapper contracts that represent positions as ERC-721 non-fungible tokens (NFTs) or attempt to create fungible representations of similar positions.

Is Uniswap v3 more expensive to use than v2?

Swapping can be more gas-intensive in v3 if the swap crosses many initialized ticks, as each tick crossing incurs a fixed gas cost. Providing liquidity is also more complex and thus may cost more gas than in v2. However, the increased capital efficiency often outweighs the slightly higher gas costs for active participants.