Build
Architecture
contracts
contracts
evm
testing
TestUniswapV3Contracts.sol
Interface.inonfungiblepositionmanager

Git Source (opens in a new tab)

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

positions

Returns the position information associated with a given token ID.

Throws if the token ID is not valid.

function positions(uint256 tokenId)
    external
    view
    returns (
        uint96 nonce,
        address operator,
        address token0,
        address token1,
        uint24 fee,
        int24 tickLower,
        int24 tickUpper,
        uint128 liquidity,
        uint256 feeGrowthInside0LastX128,
        uint256 feeGrowthInside1LastX128,
        uint128 tokensOwed0,
        uint128 tokensOwed1
    );

Parameters

NameTypeDescription
tokenIduint256The ID of the token that represents the position

Returns

NameTypeDescription
nonceuint96The nonce for permits
operatoraddressThe address that is approved for spending
token0addressThe address of the token0 for a specific pool
token1addressThe address of the token1 for a specific pool
feeuint24The fee associated with the pool
tickLowerint24The lower end of the tick range for the position
tickUpperint24The higher end of the tick range for the position
liquidityuint128The liquidity of the position
feeGrowthInside0LastX128uint256The fee growth of token0 as of the last action on the individual position
feeGrowthInside1LastX128uint256The fee growth of token1 as of the last action on the individual position
tokensOwed0uint128The uncollected amount of token0 owed to the position as of the last computation
tokensOwed1uint128The uncollected amount of token1 owed to the position as of the last computation

mint

Creates a new position wrapped in a NFT

Call this when the pool does exist and is initialized. Note that if the pool is created but not initialized a method does not exist, i.e. the pool is assumed to be initialized.

function mint(MintParams calldata params)
    external
    payable
    returns (uint256 tokenId, uint128 liquidity, uint256 amount0, uint256 amount1);

Parameters

NameTypeDescription
paramsMintParamsThe params necessary to mint a position, encoded as MintParams in calldata

Returns

NameTypeDescription
tokenIduint256The ID of the token that represents the minted position
liquidityuint128The amount of liquidity for this position
amount0uint256The amount of token0
amount1uint256The amount of token1

increaseLiquidity

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

function increaseLiquidity(IncreaseLiquidityParams calldata params)
    external
    payable
    returns (uint128 liquidity, uint256 amount0, uint256 amount1);

Parameters

NameTypeDescription
paramsIncreaseLiquidityParamstokenId 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
liquidityuint128The new liquidity amount as a result of the increase
amount0uint256The amount of token0 to acheive resulting liquidity
amount1uint256The amount of token1 to acheive resulting liquidity

decreaseLiquidity

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

function decreaseLiquidity(DecreaseLiquidityParams calldata params)
    external
    payable
    returns (uint256 amount0, uint256 amount1);

Parameters

NameTypeDescription
paramsDecreaseLiquidityParamstokenId 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
amount0uint256The amount of token0 accounted to the position's tokens owed
amount1uint256The amount of token1 accounted to the position's tokens owed

collect

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

function collect(CollectParams calldata params) external payable returns (uint256 amount0, uint256 amount1);

Parameters

NameTypeDescription
paramsCollectParamstokenId 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
amount0uint256The amount of fees collected in token0
amount1uint256The amount of fees collected in token1

burn

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

function burn(uint256 tokenId) external payable;

Parameters

NameTypeDescription
tokenIduint256The ID of the token that is being burned

IncreaseLiquidity

Emitted when liquidity is increased for a position NFT

Also emitted when a token is minted

event IncreaseLiquidity(uint256 indexed tokenId, uint128 liquidity, uint256 amount0, uint256 amount1);

Parameters

NameTypeDescription
tokenIduint256The ID of the token for which liquidity was increased
liquidityuint128The amount by which liquidity for the NFT position was increased
amount0uint256The amount of token0 that was paid for the increase in liquidity
amount1uint256The amount of token1 that was paid for the increase in liquidity

DecreaseLiquidity

Emitted when liquidity is decreased for a position NFT

event DecreaseLiquidity(uint256 indexed tokenId, uint128 liquidity, uint256 amount0, uint256 amount1);

Parameters

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

Emitted when tokens are collected for a position NFT

The amounts reported may not be exactly equivalent to the amounts transferred, due to rounding behavior

event Collect(uint256 indexed tokenId, address recipient, uint256 amount0, uint256 amount1);

Parameters

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

MintParams

struct MintParams {
    address token0;
    address token1;
    uint24 fee;
    int24 tickLower;
    int24 tickUpper;
    uint256 amount0Desired;
    uint256 amount1Desired;
    uint256 amount0Min;
    uint256 amount1Min;
    address recipient;
    uint256 deadline;
}

IncreaseLiquidityParams

struct IncreaseLiquidityParams {
    uint256 tokenId;
    uint256 amount0Desired;
    uint256 amount1Desired;
    uint256 amount0Min;
    uint256 amount1Min;
    uint256 deadline;
}

DecreaseLiquidityParams

struct DecreaseLiquidityParams {
    uint256 tokenId;
    uint128 liquidity;
    uint256 amount0Min;
    uint256 amount1Min;
    uint256 deadline;
}

CollectParams

struct CollectParams {
    uint256 tokenId;
    address recipient;
    uint128 amount0Max;
    uint128 amount1Max;
}