# Peg Stability Module ## Overview The Peg Stability Module (PSM) is a crucial component of the Venus Protocol designed to maintain the value of the VAI stablecoin at $1. It functions similarly to the system provided by MakerDAO for DAI. The PSM contract utilizes two stablecoins: VAI (the target stablecoin) and USDT (used to help maintain the peg). ## Features **Convert Functionality**: * Users can exchange VAI and USDT with a "fixed" conversion rate of 1 VAI = $1. * Users can send VAI to the PSM and receive USDT if enough USDT is available in the PSM. * Users can send USDT to the PSM and receive VAI, provided that the PSM hasn't reached its maximum allowed minted VAI limit. **No Stability Fee** The VAI minted through the PSM does not accrue any interest or stability fee. **Configurable Parameters**: The PSM contract has three configurable variables set via the Venus Improvement Proposal (VIP): * `feeIn`: Fee charged when users send USDT to the PSM. * `feeOut`: Fee charged when users send VAI to the PSM. * `maxMintedVAI`: The maximum amount of VAI that the PSM can distribute. Conversions that exceed this limit will be reverted. **Fees Sent to Treasury**: The collected fees are sent to the Venus Treasury contract in each operation. **Integration with Oracle Price**: The PSM considers the USD value of the stablecoin to peg VAI to its value accurately. ## Convert Functions ### Function `swapStableForVAI` This function allows users to exchange the paired stablecoin (USDT) for VAI. **Expected Parameters**: * `receiver`: Address of the user who will receive the VAI. * `amount`: The amount of stablecoin (USDT) the sender wants to convert. The received stablecoins will be held by the PSM, and the fee specified by `feeIn` will be sent to the Treasury contract. This function returns the amount of VAI transferred to the receiver. ### Function `swapVAIForStable` This function enables users to exchange VAI for the paired stablecoin (USDT). **Expected Parameters**: * `receiver`: Address of the user who will receive the stablecoin. * `amount`: The expected amount of stablecoin (USDT) the user should receive. The received VAI will be burnt, and the fee specified by `feeOut` will be sent to the Treasury contract. This function returns the amount of VAI transferred from the sender (burnt + fee). ## Preview Functions The PSM also offers preview functions that help users estimate the outcome of convert operations: ### `previewSwapVAIForStable(uint256 stableTknAmount)` Returns the amount of VAI that the sender would transfer (burnt + fee) to receive the specified stablecoin amount. ### `previewSwapStableForVAI(uint256 stableTknAmount)` Returns the amount of VAI that the receiver would receive after executing the `swapVAIForStable` function with the specified stablecoin amount. ## Integration of the Oracle Price
USD price considered by the Peg Stability Module at Venus
To protect the value of VAI and consider the USD value of the paired stablecoin, the PSM integrates with the Resilient Oracle. The following rules are applied: **swapVAIForStable** (the user sends VAI and receives USDT) * If the oracle price of the paired stablecoin is below $1, the conversion rate is 1 stablecoin = $1. {% hint style="info" %} **For example if 1 USDT = $0.90** * Input: The user wishes to receive 1 USDT. * Calculation: The conversion rate to consider is max(1, 0.9) => 1 USDT = $1 = 1 VAI. * The user needs to send 1 VAI (1 USDT \* 1 $/USDT) + fees. * Assuming feeOut = 10%, 0.10 VAI will be sent to the treasury, and 1 VAI will be burnt, resulting in a total of 1.1 VAI provided by the user. * The fee is calculated considering the "principal" VAI amount that we are to burn (1 VAI = $1). {% endhint %} * If the oracle price of the paired stablecoin is above $1, the conversion rate is 1 stablecoin = oracle price. {% hint style="info" %} **For example if 1 USDT = $1.1** * Input: The user desires to receive 10 USDT. * Calculation: The conversion rate to consider is max(1, 1.1) => 1 USDT = $1.1 = 1.1 VAI. * The user needs to send 11 VAI (10 USDT \* 1.1 $/USDT) + fees. * Assuming feeOut = 10%, 1.1 VAI will be sent to the treasury, and 10 VAI will be burnt, resulting in a total of 12.1 VAI provided by the user. * The fee is calculated considering the "principal" VAI amount that we are to burn (11 VAI = $11). {% endhint %} **swapStableForVAI** (the user sends USDT and receives VAI) * If the oracle price of the paired stablecoin is below $1, the conversion rate is 1 stablecoin = oracle price. {% hint style="info" %} **For example if 1 USDT = $0.90** * Input: The user wishes to send 10 USDT to the PSM. * Calculation: The conversion rate to consider is min(1, 0.9) => 10 USDT = $9 = 9 VAI. * The user will receive 9 VAI (10 USDT \* 0.9) - fees. * Assuming feeIn = 10%, 0.9 VAI will be sent to the treasury, and 8.1 VAI will be sent to the user. * The fee is calculated considering the "principal" VAI amount (9 VAI = $9). {% endhint %} * If the oracle price of the paired stablecoin is above $1, the conversion rate is 1 stablecoin = $1. {% hint style="info" %} **For example if 1 USDT = $1.1** * 1 USDT = $1.1 (conversion rate according to our oracles) * Input: The user wishes to send 10 USDT to the PSM. * Calculation: The conversion rate to consider is min(1, 1.1) => 10 USDT = $10 = 10 VAI. * The user will receive 10 VAI (10 USDT \* 1.0) - fees. * Assuming feeIn = 10%, 1 VAI will be sent to the treasury, and 9 VAI will be sent to the user. * The fee is calculated considering the "principal" VAI amount (10 VAI = $10). {% endhint %} {% hint style="warning" %} This documentation is designed to be user-friendly and does not cover the technical implementation details of the Peg Stability Module. For technical information, developers and smart contract auditors can refer to the [smart contract code](https://github.com/VenusProtocol/venus-protocol/blob/develop/contracts/PegStability/PegStability.sol). {% endhint %}