# ILiquidityProvider

## newOffer

```solidity
function newOffer(struct OLKey olKey, Tick tick, uint256 gives, uint256 gasreq) external payable returns (uint256 offerId)
```

creates a new offer on Mangrove with an override for gas requirement

### Parameters

| Name   | Type         | Description                                                            |
| ------ | ------------ | ---------------------------------------------------------------------- |
| olKey  | struct OLKey | the offer list key.                                                    |
| tick   | Tick         | the tick                                                               |
| gives  | uint256      | the amount of inbound tokens the offer maker gives for a complete fill |
| gasreq | uint256      | the gas required by the offer logic                                    |

### Return Values

| Name    | Type    | Description            |
| ------- | ------- | ---------------------- |
| offerId | uint256 | the Mangrove offer id. |

## updateOffer

```solidity
function updateOffer(struct OLKey olKey, Tick tick, uint256 gives, uint256 offerId, uint256 gasreq) external payable
```

updates an offer existing on Mangrove (not necessarily live) with an override for gas requirement

### Parameters

| Name    | Type         | Description                                                                |
| ------- | ------------ | -------------------------------------------------------------------------- |
| olKey   | struct OLKey | the offer list key.                                                        |
| tick    | Tick         | the tick                                                                   |
| gives   | uint256      | the new amount of inbound tokens the offer maker gives for a complete fill |
| offerId | uint256      | the id of the offer in the offer list.                                     |
| gasreq  | uint256      | the gas required by the offer logic                                        |

## retractOffer

```solidity
function retractOffer(struct OLKey olKey, uint256 offerId, bool deprovision) external returns (uint256 freeWei)
```

Retracts an offer from an Offer List of Mangrove.

*An offer that is retracted without `deprovision` is retracted from the offer list, but still has its provisions locked by Mangrove.*\
*Calling this function, with the `deprovision` flag, on an offer that is already retracted must be used to retrieve the locked provisions.*

### Parameters

| Name        | Type         | Description                                                             |
| ----------- | ------------ | ----------------------------------------------------------------------- |
| olKey       | struct OLKey | the offer list key.                                                     |
| offerId     | uint256      | the identifier of the offer in the offer list                           |
| deprovision | bool         | if set to `true` if offer owner wishes to redeem the offer's provision. |

### Return Values

| Name    | Type    | Description                                                                            |
| ------- | ------- | -------------------------------------------------------------------------------------- |
| freeWei | uint256 | the amount of native tokens (in WEI) that have been retrieved by retracting the offer. |


---

# 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.mangrove.exchange/dev/strat-lib/technical-references/api-preferences/strats/src/strategies/interfaces/iliquidityprovider.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.