feat: Remove liquidity

[luchobonatti]

Add Remove Liquidity Support (buildRemoveLiquidityCallData)

Overview

This PR adds support for building calldata to remove liquidity from Uniswap V4 positions. Developers can now easily generate calldata and value for partial or full liquidity removal, with slippage and deadline controls, ready to be sent to the PositionManager contract.

Changes

• Added buildRemoveLiquidityCallData utility for preparing calldata to remove liquidity from a position.
• Added comprehensive unit tests for buildRemoveLiquidityCallData.
• Updated the README with usage instructions and parameter documentation for removing liquidity.

Technical Details

• buildRemoveLiquidityCallData:
  • Accepts liquidityPercentage (in BPS), tokenId, optional slippageTolerance, and optional deadline.
  • Fetches position data and builds calldata using the Uniswap V4 SDK.
  • Handles default and custom deadlines.
  • Throws clear errors if the position is not found or if the SDK fails.
• README:
  • Documents the new function with a usage example.
  • Clarifies BPS usage for all percentage-based parameters.

Testing

Added test suite:

• buildRemoveLiquidityCallData.test.ts covering:
  • 100% liquidity removal
  • Custom slippage tolerance
  • Error when position is not found
  • Error propagation from the Uniswap SDK

Usage Example

const { calldata, value } = await uniDevKit.buildRemoveLiquidityCallData({
  liquidityPercentage: 10_000, // 100%
  tokenId: '123',
  slippageTolerance: 50, // 0.5%
  deadline: '1700000000'
});

const tx = await sendTransaction({
  to: uniDevKit.getContractAddress('positionManager'),
  data: calldata,
  value
});

[github-actions]

🎉 This PR is included in version 1.0.12 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀