> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gains.trade/llms.txt
> Use this file to discover all available pages before exploring further.

# LiquidityPoolUtils

*Library to abstract liquidity pool operations such as fetching observations, calculating TWAP, etc. Currently supports Uniswap V3 and Algebra V1.9 liquidity pools*

## getLiquidityPoolInfo

```solidity theme={null}
function getLiquidityPoolInfo(struct IPriceAggregator.LiquidityPoolInput _input) internal view returns (struct IPriceAggregator.LiquidityPoolInfo)
```

*Returns a `LiquidityPoolInfo` struct for LiquidityPoolInput `_input`*

### Parameters

| Name    | Type                                                                                                                                 | Description                                          |
| ------- | ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------- |
| \_input | [IPriceAggregator.LiquidityPoolInput](/developer/technical-reference/contracts/interfaces/types/ipriceaggregator#liquiditypoolinput) | LiquidityPoolInput struct with pool address and type |

## getTimeWeightedAveragePrice

```solidity theme={null}
function getTimeWeightedAveragePrice(struct IPriceAggregator.LiquidityPoolInfo _poolInfo, uint32 _twapInterval, uint256 _precisionDelta) internal view returns (uint256)
```

*Calculates the time-weighted average price of a liquidity pool over a given interval*

### Parameters

| Name             | Type                                                                                                                               | Description                   |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| \_poolInfo       | [IPriceAggregator.LiquidityPoolInfo](/developer/technical-reference/contracts/interfaces/types/ipriceaggregator#liquiditypoolinfo) | Liquidity pool info           |
| \_twapInterval   | uint32                                                                                                                             | TWAP interval in seconds      |
| \_precisionDelta | uint256                                                                                                                            | precision delta of collateral |

## \_getPoolTickCumulatives

```solidity theme={null}
function _getPoolTickCumulatives(struct IPriceAggregator.LiquidityPoolInfo _poolInfo, uint32 _twapInterval) internal view returns (int56[])
```

*Fetches tickCumulatives data from the pool. Calls the appropriate oracle function based on the pool type*

### Parameters

| Name           | Type                                                                                                                               | Description         |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ------------------- |
| \_poolInfo     | [IPriceAggregator.LiquidityPoolInfo](/developer/technical-reference/contracts/interfaces/types/ipriceaggregator#liquiditypoolinfo) | Liquidity pool info |
| \_twapInterval | uint32                                                                                                                             | TWAP interval       |

## \_tickCumulativesToTokenPrice

```solidity theme={null}
function _tickCumulativesToTokenPrice(int56[] _tickCumulatives, uint32 _twapInterval, uint256 _precisionDelta, bool _isGnsToken0InLp) internal pure returns (uint256)
```

*Returns TWAP price (1e10 precision) from tickCumulatives data*

### Parameters

| Name              | Type     | Description                                                                                                                                                                                                                  |
| ----------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| \_tickCumulatives | int56\[] | array of tickCumulatives                                                                                                                                                                                                     |
| \_twapInterval    | uint32   | TWAP interval                                                                                                                                                                                                                |
| \_precisionDelta  | uint256  | precision delta of collateral                                                                                                                                                                                                |
| \_isGnsToken0InLp | bool     | true if GNS is token0 in LP Inspired from [https://github.com/Uniswap/v3-periphery/blob/main/contracts/libraries/OracleLibrary.sol](https://github.com/Uniswap/v3-periphery/blob/main/contracts/libraries/OracleLibrary.sol) |