NFT Position Manager

Wraps WarpX V3 liquidity positions in ERC721 NFTs, enabling transferable and composable LP positions.

Creating a New Position

struct MintParams {    address token0;    address token1;    uint24 fee;    int24 tickLower;    int24 tickUpper;    uint256 amount0Desired;    uint256 amount1Desired;    uint256 amount0Min;    uint256 amount1Min;    address recipient;    uint256 deadline;}function mint(MintParams calldata params) external payable returns (    uint256 tokenId,    uint128 liquidity,    uint256 amount0,    uint256 amount1)

Creates a new liquidity position as an NFT. The pool must already exist and be initialized.

Parameters:

Field	Description
token0	First token address
token1	Second token address
fee	Fee tier (100, 500, 3000, or 10000)
tickLower	Lower tick boundary
tickUpper	Upper tick boundary
amount0Desired	Desired amount of token0 to add
amount1Desired	Desired amount of token1 to add
amount0Min	Minimum token0 (slippage protection)
amount1Min	Minimum token1 (slippage protection)
recipient	NFT recipient address
deadline	Transaction expiry timestamp

Returns: tokenId, liquidity, actual amount0 and amount1 deposited

Example:

INonfungiblePositionManager.MintParams memory params = INonfungiblePositionManager.MintParams({    token0: USDC,    token1: WETH,    fee: 3000,    tickLower: -887220,    tickUpper: 887220,    amount0Desired: 1000e6,    // 1000 USDC    amount1Desired: 0.5e18,    // 0.5 WETH    amount0Min: 950e6,    amount1Min: 0.475e18,    recipient: msg.sender,    deadline: block.timestamp + 300});(uint256 tokenId, uint128 liquidity, uint256 amount0, uint256 amount1) = positionManager.mint(params);

---

Increasing Liquidity

struct IncreaseLiquidityParams {    uint256 tokenId;    uint256 amount0Desired;    uint256 amount1Desired;    uint256 amount0Min;    uint256 amount1Min;    uint256 deadline;}function increaseLiquidity(IncreaseLiquidityParams calldata params) external payable returns (    uint128 liquidity,    uint256 amount0,    uint256 amount1)

Adds more liquidity to an existing position. Only the position owner can call this.

Example:

INonfungiblePositionManager.IncreaseLiquidityParams memory params =     INonfungiblePositionManager.IncreaseLiquidityParams({        tokenId: 1234,        amount0Desired: 500e6,        amount1Desired: 0.25e18,        amount0Min: 475e6,        amount1Min: 0.2375e18,        deadline: block.timestamp + 300    });(uint128 liquidity, uint256 amount0, uint256 amount1) = positionManager.increaseLiquidity(params);

---

Decreasing Liquidity

struct DecreaseLiquidityParams {    uint256 tokenId;    uint128 liquidity;    uint256 amount0Min;    uint256 amount1Min;    uint256 deadline;}function decreaseLiquidity(DecreaseLiquidityParams calldata params) external payable returns (    uint256 amount0,    uint256 amount1)

Removes liquidity from a position. Withdrawn tokens are credited to the position and must be collected separately.

Example:

INonfungiblePositionManager.DecreaseLiquidityParams memory params =     INonfungiblePositionManager.DecreaseLiquidityParams({        tokenId: 1234,        liquidity: 50000,        amount0Min: 100e6,        amount1Min: 0.05e18,        deadline: block.timestamp + 300    });(uint256 amount0, uint256 amount1) = positionManager.decreaseLiquidity(params);

---

Collecting Fees & Tokens

struct CollectParams {    uint256 tokenId;    address recipient;    uint128 amount0Max;    uint128 amount1Max;}function collect(CollectParams calldata params) external payable returns (    uint256 amount0,    uint256 amount1)

Collects accumulated fees and tokens from decreased liquidity.

Example:

// Collect all available tokens and feesINonfungiblePositionManager.CollectParams memory params =     INonfungiblePositionManager.CollectParams({        tokenId: 1234,        recipient: msg.sender,        amount0Max: type(uint128).max,        amount1Max: type(uint128).max    });(uint256 amount0, uint256 amount1) = positionManager.collect(params);

---

Burning a Position

function burn(uint256 tokenId) external payable

Burns an NFT position. The position must have:

• Zero liquidity remaining

• All tokens and fees collected

Example:

// Must decrease liquidity to 0 and collect all tokens firstpositionManager.burn(1234);

---

Creating & Initializing Pools

function createAndInitializePoolIfNecessary(    address token0,    address token1,    uint24 fee,    uint160 sqrtPriceX96) external payable returns (address pool)

Creates a new pool if it doesn't exist, and initializes it if needed. Useful for bundling with mint().

Example:

// Create and initialize USDC/WETH 0.3% pool at 1:2000 ratioaddress pool = positionManager.createAndInitializePoolIfNecessary(    USDC,    WETH,    3000,    1771845812700903892492222464  // sqrt(2000) * 2^96);

---

Querying Positions

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)

Returns full details about a position NFT.

Example:

(    ,    ,    address token0,    address token1,    uint24 fee,    int24 tickLower,    int24 tickUpper,    uint128 liquidity,    ,    ,    uint128 tokensOwed0,    uint128 tokensOwed1) = positionManager.positions(1234);

---

Events

IncreaseLiquidity

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

Emitted when liquidity is added to a position (including initial minting).

DecreaseLiquidity

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

Emitted when liquidity is removed from a position.

Collect

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

Emitted when fees or tokens are collected from a position.

---

ERC721 Compatibility

The Position Manager is a full ERC721 NFT contract, supporting:

• transferFrom() - Transfer positions between addresses

• approve() / setApprovalForAll() - Authorize operators

• ownerOf() - Query position owner

• tokenURI() - Get on-chain SVG metadata

Position NFTs can be traded, used as collateral, or integrated with NFT marketplaces.