# Position Manager

The `PositionManager` is a non-fungible liquidity management contract built on top of uniswap V3, and similar models. It allows users to mint, increase, decrease, collect, and burn liquidity positions represented as NFTs, with added support for **treasury fees**, **TWAP volatility guards**, **admin recovery functions**, and **parameterised configuration**.

It inherits core functionality from `BasePositionManager` and adds direct integration with Camelot's `ICamelotNonfungiblePositionManager` and `IAlgebraPoolV3 or other such pools`

***

#### Key Features

**NFT-Based Liquidity Minting**

* Users can mint new positions using `mintLiquidity()`, which returns a unique position `tokenId` representing an LP NFT.
* Includes built-in refund for unused tokens to prevent overpayment.

**Fee Collection & Treasury Routing**

* Automatically deducts protocol treasury fees on `collectFees()` and `burnLiquidity()` using `_collectLogic()`.
* Treasury address and fee 3% (in basis points) can be configured and updated by admins.

***

#### Core Functions

*  **`mintLiquidity(...)`**

Mints a new LP position and returns the `tokenId`. Refunds unused token0/token1.

*  **`increaseLiquidity(...)`**

Adds tokens to an existing position. Refunds unused amounts. Requires position ownership.

*  **`decreaseLiquidity(...)`**

Removes part of the liquidity from a position. Transfers fees and liquidity to a recipient.

*  **`collectFees(...)`**

Transfers LP NFT to the contract, collects all fees, deducts treasury cut, then returns NFT to user.

*  **`burnLiquidity(...)`**

Performs full withdrawal:

1. Collects fees
2. Removes all liquidity
3. Transfers to user
4. Burns NFT
5. Removes position from `userPositionIds`

*  **`batchUpdateConfig(...)`**

Admin-only method to update:

1. Treasury address and fee
2. Token0 / Token1
3. Min/Max limits
4. Pool address / fee / TWAP

***

####  Admin Functions

| Function                       | Purpose                                       |
| ------------------------------ | --------------------------------------------- |
| `pause()` / `unpause()`        | Emergency stop/start                          |
| `updateTreasury()`             | Set new treasury address and fee percent      |
| `updateTokenPair()`            | Change underlying token0/token1 addresses     |
| `updateAmountLimits()`         | Change min/max limits for token0/token1       |
| `setDeviation()`               | Adjust TWAP deviation for volatility check    |
| `emergencyWithdraw()`          | Recover stuck funds from contract (any ERC20) |
| `addAdmin()` / `removeAdmin()` | Manage ADMIN\_ROLE                            |

***

#### Internal Design Notes

* **Caching**: `currentState()` caches tick/price info for 60 seconds to optimize gas across frequent liquidity actions.
* **Volatility Guard**: all transactions require minimum amounts according to the slippage required.
* **Composability**: Designed to be extended for specific pool integrations via `BasePositionManager`.

***

#### Extensibility

Because `BasePositionManager` is an abstract class, we can reuse this structure for:

* Uniswap V3 (by overriding `currentTick()` and `_twap()`)
* Other Algebra forks (e.g., THENA, Velodrome v2)
* Custom fee managers
* Time-locked vault integrations

***

####  Example Use Case

```solidity
solidityCopyEdit// Minting liquidity
IERC20(token0).approve(address(positionManager), amt0);
IERC20(token1).approve(address(positionManager), amt1);

(uint256 tokenId, , , ) = positionManager.mintLiquidity(
    amt0, amt1,
    -887220, 887220, // full range
    0, 0             // slippage
);

// Collecting fees
positionManager.collectFees(tokenId, msg.sender);

// Full exit
positionManager.burnLiquidity(tokenId, msg.sender, 0, 0);
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.alloc8.xyz/architechure/readme/position-manager.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.