Skip to main content

UniswapV3Pool

Functions#

_blockTimestamp#

function _blockTimestamp(
) internal view virtual returns (uint32)

Returns the block timestamp truncated to 32 bits, i.e. mod 2**32. This method is overridden in tests.

secondsInside#

function secondsInside(
int24 tickLower,
int24 tickUpper
) external view override noDelegateCall returns (uint32)

Returns a relative timestamp value representing how long, in seconds, the pool has spent between tickLower and tickUpper

This timestamp is strictly relative. To get a useful elapsed time (i.e., duration) value, the value returned by this method should be checkpointed externally after a position is minted, and again before a position is burned. Thus the external contract must control the lifecycle of the position.

Parameters:#

NameTypeDescription
tickLowerint24The lower tick of the range for which to get the seconds inside
tickUpperint24The upper tick of the range for which to get the seconds inside

Return Values:#

NameTypeDescription
Aint24relative timestamp for how long the pool spent in the tick range

observe#

function observe(
uint32[] secondsAgos
) external view override noDelegateCall returns (int56[] tickCumulatives, uint160[] liquidityCumulatives)

Returns the cumulative tick and liquidity as of each timestamp secondsAgo from the current block timestamp

To get a time weighted average tick or liquidity-in-range, you must call this with two values, one representing the beginning of the period and another for the end of the period. E.g., to get the last hour time-weighted average tick, you must call it with secondsAgos = [3600, 0]. The time weighted average tick represents the geometric time weighted average price of the pool, in log base sqrt(1.0001) of token1 / token0. The TickMath library can be used to go from a tick value to a ratio.

Parameters:#

NameTypeDescription
secondsAgosuint32[]From how long ago each cumulative tick and liquidity value should be returned

Return Values:#

NameTypeDescription
tickCumulativesuint32[]Cumulative tick values as of each secondsAgos from the current block timestamp
liquidityCumulativesCumulative liquidity-in-range value as of each secondsAgos from the current block

timestamp

increaseObservationCardinalityNext#

function increaseObservationCardinalityNext(
uint16 observationCardinalityNext
) external

Increase the maximum number of price and liquidity observations that this pool will store

This method is no-op if the pool already has an observationCardinalityNext greater than or equal to the input observationCardinalityNext.

Parameters:#

NameTypeDescription
observationCardinalityNextuint16The desired minimum number of observations for the pool to store

initialize#

function initialize(
uint160 sqrtPriceX96
) external

Sets the initial price for the pool

not locked because it initializes unlocked

Parameters:#

NameTypeDescription
sqrtPriceX96uint160the initial sqrt price of the pool as a Q64.96

mint#

function mint(
address recipient,
int24 tickLower,
int24 tickUpper,
uint128 amount,
bytes data
) external override lock returns (uint256 amount0, uint256 amount1)

Adds liquidity for the given recipient/tickLower/tickUpper position

noDelegateCall is applied indirectly via _modifyPosition

Parameters:#

NameTypeDescription
recipientaddressThe address for which the liquidity will be created
tickLowerint24The lower tick of the position in which to add liquidity
tickUpperint24The upper tick of the position in which to add liquidity
amountuint128The amount of liquidity to mint
databytesAny data that should be passed through to the callback

Return Values:#

NameTypeDescription
amount0addressThe amount of token0 that was paid to mint the given amount of liquidity. Matches the value in the callback
amount1int24The amount of token1 that was paid to mint the given amount of liquidity. Matches the value in the callback

collect#

function collect(
address recipient,
int24 tickLower,
int24 tickUpper,
uint128 amount0Requested,
uint128 amount1Requested
) external override lock returns (uint128 amount0, uint128 amount1)

Collects tokens owed to a position

Does not recompute fees earned, which must be done either via mint or burn of any amount of liquidity. Collect must be called by the position owner. To withdraw only token0 or only token1, amount0Requested or amount1Requested may be set to zero. To withdraw all tokens owed, caller may pass any value greater than the actual tokens owed, e.g. type(uint128).max. Tokens owed may be from accumulated swap fees or burned liquidity.

Parameters:#

NameTypeDescription
recipientaddressThe address which should receive the fees collected
tickLowerint24The lower tick of the position for which to collect fees
tickUpperint24The upper tick of the position for which to collect fees
amount0Requesteduint128How much token0 should be withdrawn from the fees owed
amount1Requesteduint128How much token1 should be withdrawn from the fees owed

Return Values:#

NameTypeDescription
amount0addressThe amount of fees collected in token0
amount1int24The amount of fees collected in token1

burn#

function burn(
int24 tickLower,
int24 tickUpper,
uint128 amount
) external override lock returns (uint256 amount0, uint256 amount1)

Burn liquidity from the sender and account tokens owed for the liquidity to the position

noDelegateCall is applied indirectly via _modifyPosition

Parameters:#

NameTypeDescription
tickLowerint24The lower tick of the position for which to burn liquidity
tickUpperint24The upper tick of the position for which to burn liquidity
amountuint128How much liquidity to burn

Return Values:#

NameTypeDescription
amount0int24The amount of token0 sent to the recipient
amount1int24The amount of token1 sent to the recipient

swap#

function swap(
address recipient,
bool zeroForOne,
int256 amountSpecified,
uint160 sqrtPriceLimitX96,
bytes data
) external override noDelegateCall returns (int256 amount0, int256 amount1)

Swap token0 for token1, or token1 for token0

The caller of this method receives a callback in the form of IUniswapV3SwapCallback#uniswapV3SwapCallback

Parameters:#

NameTypeDescription
recipientaddressThe address to receive the output of the swap
zeroForOneboolThe direction of the swap, true for token0 to token1, false for token1 to token0
amountSpecifiedint256The amount of the swap, which implicitly configures the swap as exact input (positive), or exact output (negative)
sqrtPriceLimitX96uint160The Q64.96 sqrt price limit. If zero for one, the price cannot be less than this

value after the swap. If one for zero, the price cannot be greater than this value after the swap |data | bytes | Any data to be passed through to the callback

Return Values:#

NameTypeDescription
amount0addressThe delta of the balance of token0 of the pool, exact when negative, minimum when positive
amount1boolThe delta of the balance of token1 of the pool, exact when negative, minimum when positive

flash#

function flash(
address recipient,
uint256 amount0,
uint256 amount1,
bytes data
) external

Receive token0 and/or token1 and pay it back, plus a fee, in the callback

The caller of this method receives a callback in the form of IUniswapV3FlashCallback#uniswapV3FlashCallback Can be used to donate underlying tokens pro-rata to currently in-range liquidity providers by calling with 0 amount{0,1} and sending the donation amount(s) from the callback

Parameters:#

NameTypeDescription
recipientaddressThe address which will receive the token0 and token1 amounts
amount0uint256The amount of token0 to send
amount1uint256The amount of token1 to send
databytesAny data to be passed through to the callback

setFeeProtocol#

function setFeeProtocol(
uint8 feeProtocol0,
uint8 feeProtocol1
) external

Set the denominator of the protocol's % share of the fees

Parameters:#

NameTypeDescription
feeProtocol0uint8new protocol fee for token0 of the pool
feeProtocol1uint8new protocol fee for token1 of the pool

collectProtocol#

function collectProtocol(
address recipient,
uint128 amount0Requested,
uint128 amount1Requested
) external override lock onlyFactoryOwner returns (uint128 amount0, uint128 amount1)

Collect the protocol fee accrued to the pool

Parameters:#

NameTypeDescription
recipientaddressThe address to which collected protocol fees should be sent
amount0Requesteduint128The maximum amount of token0 to send, can be 0 to collect fees in only token1
amount1Requesteduint128The maximum amount of token1 to send, can be 0 to collect fees in only token0

Return Values:#

NameTypeDescription
amount0uint128The protocol fee collected in token0
amount1uint128The protocol fee collected in token1