> For the complete documentation index, see [llms.txt](https://docs.titan.tg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.titan.tg/colossus-concentrated-liquidity-amm/smart-contracts/pool-manager.md).

# Pool Manager

The pool manager serves as a proxy between pools and vaults.\
Users do not interact directly with it.

***

## Interface

### `get_pool_manager_data`

Returns pool manager data.

**Arguments**

*None*

**Returns**

| Data Type | Description              |
| --------- | ------------------------ |
| `int`     | Is initialized           |
| `int`     | Lowest pool shard index  |
| `int`     | Highest pool shard index |
| `int`     | Tick size                |
| `int`     | Token0 vault address     |
| `int`     | Token1 vault address     |
| `slice`   | Protocol fee address     |
| `int`     | LP fee                   |
| `int`     | Protocol fee             |
| `int`     | Referral fee             |

***

### `get_account_address`

Returns LP account address for user.

**Arguments**

| Data Type | Description |
| --------- | ----------- |
| `slice`   | User wallet |

**Returns**

| Data Type | Description             |
| --------- | ----------------------- |
| `slice`   | User LP account address |

***

### `get_pool_address`

Returns pool address for given index.

**Arguments**

| Data Type | Description           |
| --------- | --------------------- |
| `int`     | Min tick (pool index) |

**Returns**

| Data Type | Description  |
| --------- | ------------ |
| `slice`   | Pool address |

***

## Messages

### Add Liquidity

```plaintext
Opcode: 0xb9251ce7
```

**Body Format**

| Data Type      | Description  |
| -------------- | ------------ |
| `Uint32`       | Opcode       |
| `Uint64`       | Query ID     |
| `Int32`        | Low tick     |
| `Int32`        | High tick    |
| `Coins`        | Amount0      |
| `Coins`        | Amount1      |
| `Address`      | User address |
| `Uint128`      | Liquidity    |
| `^Cell`        | Farm cell    |
| `Uint1`        | Should stake |
| `Maybe Uint32` | Farm index   |
| `Int32`        | Pool index   |

***

### Refund User

```plaintext
Opcode: 0xdc37aa85
```

**Body Format**

| Data Type | Description |
| --------- | ----------- |
| `Uint32`  | Opcode      |
| `Uint64`  | Query ID    |
| `Coins`   | Amount0     |
| `Coins`   | Amount1     |
| `Address` | Address     |

***

### Stage LP

```plaintext
Opcode: 0x4535f1ab
```

**Body Format**

| Data Type      | Description     |
| -------------- | --------------- |
| `Uint32`       | Opcode          |
| `Uint64`       | Query ID        |
| `Address`      | User address    |
| `Coins`        | Amount0         |
| `Coins`        | Amount1         |
| `Coins`        | Provide amount0 |
| `Coins`        | Provide amount1 |
| `Int32`        | Low tick        |
| `Int32`        | High tick       |
| `Int32`        | Pool index      |
| `^Cell`        | Liquidity data  |
| `Uint128`      | Liquidity       |
| `^Cell`        | Farm data       |
| `Uint1`        | Should stake    |
| `Maybe Uint32` | Farm index      |

***

### Stake LP

```plaintext
Opcode: 0xe55cf6af
```

**Body Format**

| Data Type | Description    |
| --------- | -------------- |
| `Uint32`  | Opcode         |
| `Uint64`  | Query ID       |
| `Int32`   | Pool index     |
| `Int32`   | Low tick       |
| `Int32`   | High tick      |
| `Uint128` | Liquidity      |
| `Uint256` | Tx count       |
| `^Cell`   | Farm data cell |
| `Address` | User address   |
| `Uint64`  | Position index |
| `Uint32`  | Farm index     |

***

### Stake Liquidity

```plaintext
Opcode: 0x71a6fd4b
```

**Body Format**

| Data Type | Description     |
| --------- | --------------- |
| `Uint32`  | Opcode          |
| `Uint64`  | Query ID        |
| `Int32`   | Pool index      |
| `Int32`   | Low tick        |
| `Int32`   | High tick       |
| `Uint128` | Liquidity       |
| `Uint256` | Tx count        |
| `Uint32`  | Farm index      |
| `Cell`    | Farm data cell  |
| `Uint64`  | Start timestamp |
| `Uint64`  | End timestamp   |
| `Address` | User address    |
| `Uint64`  | Position index  |

***

### Unstake LP

```plaintext
Opcode: 0x71af2880
```

**Body Format**

| Data Type | Description         |
| --------- | ------------------- |
| `Uint32`  | Opcode              |
| `Uint64`  | Query ID            |
| `Int32`   | Pool index          |
| `Uint256` | Seconds inside X128 |
| `Uint64`  | Seconds             |
| `Address` | User address        |
| `Uint32`  | Farm index          |
| `Uint1`   | Should restake      |

***

### Stake Notification Manager

```plaintext
Opcode: 0x26b4cbbf
```

**Body Format**

| Data Type | Description      |
| --------- | ---------------- |
| `Uint32`  | Opcode           |
| `Uint64`  | Query ID         |
| `Int32`   | Pool index       |
| `Uint32`  | Farm index       |
| `Address` | Response address |