> For the complete documentation index, see [llms.txt](https://docs.essencefinance.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.essencefinance.io/development/smart-contracts/peg/priceboundpsm.md).

# PriceBoundPSM

contract to create a price bound DAI PSM This contract will allow swaps when the price of DAI is between 98 cents and 1.02 by default These defaults are changeable by the admin and governance by calling floor and ceiling setters setOracleFloor and setOracleCeiling

## Functions

### constructor

```solidity
function constructor(
    uint256 _floor,
    uint256 _ceiling,
    struct PegStabilityModule.OracleParams _params,
    uint256 _mintFeeBasisPoints,
    uint256 _redeemFeeBasisPoints,
    uint256 _reservesThreshold,
    uint256 _chiLimitPerSecond,
    uint256 _mintingBufferCap,
    contract IERC20 _underlyingToken,
    contract IPCVDeposit _surplusTarget
) public
```

constructor

#### Parameters

| Name                    | Type                                   | Description                     |
| ----------------------- | -------------------------------------- | ------------------------------- |
| `_floor`                | uint256                                | minimum acceptable oracle price |
| `_ceiling`              | uint256                                | maximum acceptable oracle price |
| `_params`               | struct PegStabilityModule.OracleParams | PSM construction params         |
| `_mintFeeBasisPoints`   | uint256                                |                                 |
| `_redeemFeeBasisPoints` | uint256                                |                                 |
| `_reservesThreshold`    | uint256                                |                                 |
| `_chiLimitPerSecond`    | uint256                                |                                 |
| `_mintingBufferCap`     | uint256                                |                                 |
| `_underlyingToken`      | contract IERC20                        |                                 |
| `_surplusTarget`        | contract IPCVDeposit                   |                                 |

### setOracleFloorBasisPoints

```solidity
function setOracleFloorBasisPoints(
    uint256 newFloorBasisPoints
) external
```

sets the floor price in BP

#### Parameters

| Name                  | Type    | Description |
| --------------------- | ------- | ----------- |
| `newFloorBasisPoints` | uint256 |             |

### setOracleCeilingBasisPoints

```solidity
function setOracleCeilingBasisPoints(
    uint256 newCeilingBasisPoints
) external
```

sets the ceiling price in BP

#### Parameters

| Name                    | Type    | Description |
| ----------------------- | ------- | ----------- |
| `newCeilingBasisPoints` | uint256 |             |

### isPriceValid

```solidity
function isPriceValid() external returns (bool)
```

return wether the current oracle price is valid or not

### \_setCeilingBasisPoints

```solidity
function _setCeilingBasisPoints(
    uint256 newCeilingBasisPoints
) internal
```

helper function to set the ceiling in basis points

#### Parameters

| Name                    | Type    | Description |
| ----------------------- | ------- | ----------- |
| `newCeilingBasisPoints` | uint256 |             |

### \_setFloorBasisPoints

```solidity
function _setFloorBasisPoints(
    uint256 newFloorBasisPoints
) internal
```

helper function to set the floor in basis points

#### Parameters

| Name                  | Type    | Description |
| --------------------- | ------- | ----------- |
| `newFloorBasisPoints` | uint256 |             |

### \_validPrice

```solidity
function _validPrice(
    struct Decimal.D256 price
) internal returns (bool valid)
```

helper function to determine if price is within a valid range

#### Parameters

| Name    | Type                | Description |
| ------- | ------------------- | ----------- |
| `price` | struct Decimal.D256 |             |

### \_validatePriceRange

```solidity
function _validatePriceRange(
    struct Decimal.D256 price
) internal
```

reverts if the price is greater than or equal to the ceiling or less than or equal to the floor

#### Parameters

| Name    | Type                | Description |
| ------- | ------------------- | ----------- |
| `price` | struct Decimal.D256 |             |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.essencefinance.io/development/smart-contracts/peg/priceboundpsm.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.