API reference v1.0
Introduction
periphery
tokenomics
INonfungiblePositionManager

INonfungiblePositionManager

INonfungiblePositionManager

Non-fungible token for positions Wraps Algebra positions in a non-fungible token interface which allows for them to be transferred and authorized.

Events

IncreaseLiquidity

IncreaseLiquidity(uint256,uint128,uint128,uint256,uint256,address)

Emitted when liquidity is increased for a position NFT

NameTypeDescription
tokenIduint256The ID of the token for which liquidity was increased
liquidityuint128The amount by which liquidity for the NFT position was increased
actualLiquidityuint128the actual liquidity that was added into a pool. Could differ from liquidity when using FeeOnTransfer tokens
amount0uint256The amount of token0 that was paid for the increase in liquidity
amount1uint256The amount of token1 that was paid for the increase in liquidity
pooladdress

DecreaseLiquidity

DecreaseLiquidity(uint256,uint128,uint256,uint256)

Emitted when liquidity is decreased for a position NFT

NameTypeDescription
tokenIduint256The ID of the token for which liquidity was decreased
liquidityuint128The amount by which liquidity for the NFT position was decreased
amount0uint256The amount of token0 that was accounted for the decrease in liquidity
amount1uint256The amount of token1 that was accounted for the decrease in liquidity

Collect

Collect(uint256,address,uint256,uint256)

Emitted when tokens are collected for a position NFT

NameTypeDescription
tokenIduint256The ID of the token for which underlying tokens were collected
recipientaddressThe address of the account that received the collected tokens
amount0uint256The amount of token0 owed to the position that was collected
amount1uint256The amount of token1 owed to the position that was collected

Functions

positions

positions(uint256) view external

Returns the position information associated with a given token ID.

NameTypeDescription
tokenIduint256The ID of the token that represents the position

Returns:

NameTypeDescription
nonceuint96
operatoraddress
token0address
token1address
tickLowerint24
tickUpperint24
liquidityuint128
feeGrowthInside0LastX128uint256
feeGrowthInside1LastX128uint256
tokensOwed0uint128
tokensOwed1uint128

mint

mint(struct INonfungiblePositionManager.MintParams) payable external

Creates a new position wrapped in a NFT

NameTypeDescription
paramsstruct INonfungiblePositionManager.MintParamsThe params necessary to mint a position, encoded as `MintParams` in calldata

Returns:

NameTypeDescription
tokenIduint256
liquidityuint128
amount0uint256
amount1uint256

increaseLiquidity

increaseLiquidity(struct INonfungiblePositionManager.IncreaseLiquidityParams) payable external

Increases the amount of liquidity in a position, with tokens paid by the `msg.sender`

NameTypeDescription
paramsstruct INonfungiblePositionManager.IncreaseLiquidityParamstokenId The ID of the token for which liquidity is being increased, amount0Desired The desired amount of token0 to be spent, amount1Desired The desired amount of token1 to be spent, amount0Min The minimum amount of token0 to spend, which serves as a slippage check, amount1Min The minimum amount of token1 to spend, which serves as a slippage check, deadline The time by which the transaction must be included to effect the change

Returns:

NameTypeDescription
liquidityuint128
amount0uint256
amount1uint256

decreaseLiquidity

decreaseLiquidity(struct INonfungiblePositionManager.DecreaseLiquidityParams) payable external

Decreases the amount of liquidity in a position and accounts it to the position

NameTypeDescription
paramsstruct INonfungiblePositionManager.DecreaseLiquidityParamstokenId The ID of the token for which liquidity is being decreased, amount The amount by which liquidity will be decreased, amount0Min The minimum amount of token0 that should be accounted for the burned liquidity, amount1Min The minimum amount of token1 that should be accounted for the burned liquidity, deadline The time by which the transaction must be included to effect the change

Returns:

NameTypeDescription
amount0uint256
amount1uint256

collect

collect(struct INonfungiblePositionManager.CollectParams) payable external

Collects up to a maximum amount of fees owed to a specific position to the recipient

NameTypeDescription
paramsstruct INonfungiblePositionManager.CollectParamstokenId The ID of the NFT for which tokens are being collected, recipient The account that should receive the tokens, amount0Max The maximum amount of token0 to collect, amount1Max The maximum amount of token1 to collect

Returns:

NameTypeDescription
amount0uint256
amount1uint256

burn

burn(uint256) payable external

Burns a token ID, which deletes it from the NFT contract. The token must have 0 liquidity and all tokens must be collected first.

NameTypeDescription
tokenIduint256The ID of the token that is being burned