Returns the information about a position by the position's key
PoolImmutables
constructor()
public
timepoints(uint256)
view external
Returns data about a specific timepoint index
Name | Type | Description |
---|---|---|
index | uint256 | The element of the timepoints array to fetch |
Returns:
Name | Type | Description |
---|---|---|
initialized | bool | |
blockTimestamp | uint32 | |
tickCumulative | int56 | |
secondsPerLiquidityCumulative | uint160 | |
volatilityCumulative | uint88 | |
averageTick | int24 | |
volumePerLiquidityCumulative | uint144 |
onlyValidTicks
getInnerCumulatives(int24,int24)
view external
Returns a snapshot of the tick cumulative, seconds per liquidity and seconds inside a tick range
Name | Type | Description |
---|---|---|
bottomTick | int24 | The lower tick of the range |
topTick | int24 | The upper tick of the range |
Returns:
Name | Type | Description |
---|---|---|
innerTickCumulative | int56 | |
innerSecondsSpentPerLiquidity | uint160 | |
innerSecondsSpent | uint32 |
getTimepoints(uint32[])
view external
Returns the cumulative tick and liquidity as of each timestamp `secondsAgo` from the current block timestamp
Name | Type | Description |
---|---|---|
secondsAgos | uint32[] | From how long ago each cumulative tick and liquidity value should be returned |
Returns:
Name | Type | Description |
---|---|---|
tickCumulatives | int56[] | |
secondsPerLiquidityCumulatives | uint160[] | |
volatilityCumulatives | uint112[] | |
volumePerAvgLiquiditys | uint256[] |
initialize(uint160)
external
Sets the initial price for the pool
Name | Type | Description |
---|---|---|
initialPrice | uint160 |
lock, onlyValidTicks
mint(address,address,int24,int24,uint128,bytes)
external
Adds liquidity for the given recipient/bottomTick/topTick position
Name | Type | Description |
---|---|---|
sender | address | The address which will receive potential surplus of paid tokens |
recipient | address | The address for which the liquidity will be created |
bottomTick | int24 | The lower tick of the position in which to add liquidity |
topTick | int24 | The upper tick of the position in which to add liquidity |
liquidityDesired | uint128 | |
data | bytes | Any data that should be passed through to the callback |
Returns:
Name | Type | Description |
---|---|---|
amount0 | uint256 | |
amount1 | uint256 | |
liquidityActual | uint128 |
lock
collect(address,int24,int24,uint128,uint128)
external
Collects tokens owed to a position
Name | Type | Description |
---|---|---|
recipient | address | The address which should receive the fees collected |
bottomTick | int24 | The lower tick of the position for which to collect fees |
topTick | int24 | The upper tick of the position for which to collect fees |
amount0Requested | uint128 | How much token0 should be withdrawn from the fees owed |
amount1Requested | uint128 | How much token1 should be withdrawn from the fees owed |
Returns:
Name | Type | Description |
---|---|---|
amount0 | uint128 | |
amount1 | uint128 |
lock, onlyValidTicks
burn(int24,int24,uint128)
external
Burn liquidity from the sender and account tokens owed for the liquidity to the position
Name | Type | Description |
---|---|---|
bottomTick | int24 | The lower tick of the position for which to burn liquidity |
topTick | int24 | The upper tick of the position for which to burn liquidity |
amount | uint128 | How much liquidity to burn |
Returns:
Name | Type | Description |
---|---|---|
amount0 | uint256 | |
amount1 | uint256 |
swap(address,bool,int256,uint160,bytes)
external
Swap token0 for token1, or token1 for token0
Name | Type | Description |
---|---|---|
recipient | address | The address to receive the output of the swap |
zeroToOne | bool | The direction of the swap, true for token0 to token1, false for token1 to token0 |
amountRequired | int256 | |
limitSqrtPrice | uint160 | The 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. If using the Router it should contain SwapRouter#SwapCallbackData |
Returns:
Name | Type | Description |
---|---|---|
amount0 | int256 | |
amount1 | int256 |
swapSupportingFeeOnInputTokens(address,address,bool,int256,uint160,bytes)
external
Swap token0 for token1, or token1 for token0 (tokens that have fee on transfer)
Name | Type | Description |
---|---|---|
sender | address | The address called this function (Comes from the Router) |
recipient | address | The address to receive the output of the swap |
zeroToOne | bool | The direction of the swap, true for token0 to token1, false for token1 to token0 |
amountRequired | int256 | |
limitSqrtPrice | uint160 | The 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. If using the Router it should contain SwapRouter#SwapCallbackData |
Returns:
Name | Type | Description |
---|---|---|
amount0 | int256 | |
amount1 | int256 |
lock
flash(address,uint256,uint256,bytes)
external
Receive token0 and/or token1 and pay it back, plus a fee, in the callback
Name | Type | Description |
---|---|---|
recipient | address | The address which will receive the token0 and token1 amounts |
amount0 | uint256 | The amount of token0 to send |
amount1 | uint256 | The amount of token1 to send |
data | bytes | Any data to be passed through to the callback |
lock, onlyFactoryOwner
setCommunityFee(uint8,uint8)
external
Set the community's % share of the fees. Cannot exceed 25% (250)
Name | Type | Description |
---|---|---|
communityFee0 | uint8 | new community fee percent for token0 of the pool in thousandths (1e-3) |
communityFee1 | uint8 | new community fee percent for token1 of the pool in thousandths (1e-3) |
setIncentive(address)
external
Sets an active incentive
Name | Type | Description |
---|---|---|
virtualPoolAddress | address | The address of a virtual pool associated with the incentive |
onlyFactoryOwner
setLiquidityCooldown(uint32)
external
Sets new lock time for added liquidity
Name | Type | Description |
---|---|---|
newLiquidityCooldown | uint32 | The time in seconds |