Skip to content

Note the per-tick liquidityGross cap on full-range positions - #1148

Closed
gretzke wants to merge 1 commit into
mainfrom
docs/v4-full-range-tick-cap-note
Closed

Note the per-tick liquidityGross cap on full-range positions#1148
gretzke wants to merge 1 commit into
mainfrom
docs/v4-full-range-tick-cap-note

Conversation

@gretzke

@gretzke gretzke commented Aug 13, 2026

Copy link
Copy Markdown

Adds a note to the v4 position minting guide about the per-tick liquidityGross cap.

The guide currently shows nearestUsableTick(MIN_TICK/MAX_TICK, tickSpacing) as the way to build a full-range position, with no mention that those ticks share a maxLiquidityPerTick budget that anyone can fill for a very small amount of tokens. Once a tick is at its cap, mints and increases using that exact tick revert with TickLiquidityOverflow.

This came out of a public bug bounty submission on Cantina (#909). The submission was rejected, the cap is a safety parameter and reaching it is the intended tradeoff, but the researcher has audited several integrations that hardcode the extreme ticks in immutable code and cannot move their bounds. The note reflects the rejection reasoning: shift the bound in by a spacing or two, and do not hardcode the extreme ticks in a contract.

The note covers three things:

  1. What the cap is and why it exists.
  2. What to do if you hit it as a user, and why shifting the bound costs nothing in practice.
  3. What contracts with fixed bounds should do instead, pointing at InstantLaunchStrategy as the example.

@github-actions

Copy link
Copy Markdown

Thanks for contributing to Uniswap Docs! 馃

Quick heads up on how this repo works: the docs you see on developers.uniswap.org are built from a separate source repo. When we accept a change here, we port it over there, so your fix might show up on the live site before it lands in this repo.

Updates to this repo come in batches on a regular cadence. When yours is included, you'll be credited as a co-author on the commit, so the contribution counts on your GitHub profile and in Uniswap/docs.

We review every PR but can't merge everything. Either way, someone from the docs team will follow up here once we've taken a look.

One legal bit: by submitting a PR you agree your contribution is licensed under the repo's MIT license.

@gretzke

gretzke commented Aug 13, 2026

Copy link
Copy Markdown
Author

Closing this. The change belongs in the dev-portal content in Uniswap/universe, which is where the live site is built from. I will open it there instead.

@gretzke gretzke closed this Aug 13, 2026
@gretzke
gretzke deleted the docs/v4-full-range-tick-cap-note branch August 13, 2026 13:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant