| Contract Group | Purpose |
|---|---|
| Token (MUSD) | The stablecoin at the heart of the system, designed to maintain a peg to USD |
| Core Protocol | Handles opening/closing positions, managing collateral, and maintaining system stability |
| Asset Pools | Manages the system’s various collateral and liquidity pools |
| Supporting Contracts | Provides essential services like price feeds, position sorting, and protocol-controlled value management |
Custody and Collateral Management
MUSD positions can be tracked onchain, and the underlying Bitcoin collateral is securely managed using tBTC’s robust, decentralized custody infrastructure.You can see all BTC backing MUSD in real time on the Mezo block explorer.
Live Collateral Pools
- ActivePool - Holds collateral for all active loans
- DefaultPool - Manages redistributed collateral from liquidations
- CollSurplusPool - Holds surplus collateral after redemptions
- GasPool - Manages gas deposits
tBTC: The Backbone of MUSD Collateral
tBTC, which is built by the same team behind Mezo, Thesis, is powered by the Threshold Network. Threshold is a decentralized signer set that has operated the Threshold Bitcoin bridge since early 2020 and successfully bridged over 28k Bitcoin.Proof of reserves for tBTC have been live for the entire life of the bridge and are viewable at tbtcscan.
Contract Custody Flow
A user opens up a position by callingBorrowerOperations.openTrove, providing BTC, and requesting MUSD. The BTC is routed to the ActivePool, where it stays until one of the following actions occurs:
- Withdraws (
BorrowerOperations.withdrawColl) - Pays off their debt (
BorrowerOperations.closeTrove) - Redeems collateral (
TroveManager.redeemCollateral) - Is liquidated (
TroveManager.liquidate)
Fixed-Interest Borrowing
Interest rates are fixed for the life of the loan. The rate you lock in at loan creation never changes unless you choose to refinance.
How It Works
- Global Interest Rate: A single global interest rate applies to all newly opened loans.
- Maintaining Interest Rates: Once a loan is opened, it retains the interest rate at which it was created, even if the global rate changes. The interest rate on a loan can only be updated by the user through the refinance function.
- Refinance Function: The refinance function allows users to adjust their loan’s debt to the new global interest rate. This process incurs a refinancing fee, which is a configurable percentage of the issuance fee. Refinancing offers users the advantage of avoiding collateral movement while incurring lower fees compared to closing and reopening a loan at the updated rate. You can also refinance to extend your line of credit if BTC has appreciated in value.
- Simple Interest: Interest is calculated using a simple interest model rather than a compounding one.
- Interest Payments: Interest payments are directed to the PCV (Protocol Controlled Value). The allocation of these payments is governed and can be split between an arbitrary recipient and repayment of the bootstrap loan.
Additional Governance
- Governance Control: The interest rate and other critical parameters are controlled by governance. Changes to these parameters require a governance proposal and a minimum delay before they can be enacted.
- Interest Rate Proposals: New interest rates can be proposed by governance. These proposals must be approved after a minimum delay to ensure stability and predictability.
Protocol Controlled Value (PCV)
The Protocol Controlled Value (PCV) contract is a key component of the system, responsible for managing fees collected from borrowing and refinancing. Below is an overview of how the PCV operates:Fee Collection
Fee Collection
Borrowing fees and refinancing fees are directed to the PCV contract.
Fee Allocation
Fee Allocation
Fees collected by the PCV are allocated to paying down the bootstrap loan or sending funds to the gauge system.
Governable Split
Governable Split
The allocation of fees between paying down the debt and the gauge system is governable. However, until the bootstrap loan is fully repaid, no more than 50% of the fees can be sent to the gauge system.
Post-Debt Repayment
Post-Debt Repayment
Once the bootstrap loan is fully repaid, fees accrue as Protocol-Owned Liquidity in the StabilityPool.
Protocol Bootstrap Loan
The Stability Pool is bootstrapped with a protocol loan against future fees and interest. The MUSD minted from this protocol loan is restricted to use in the Stability Pool. While the protocol loan is in place, a minimum of 50% of the interest and fees charged by the protocol are used to pay down the loan.Definitions
Understanding these terms will help you navigate the MUSD system:Loan (Trove)
Loan (Trove)
A collateralized debt position, bound to a single Ethereum address. Also referred to as a “CDP” in similar protocols.
Active Collateral
Active Collateral
The amount of collateral recorded on a loan’s struct.
Active Principal
Active Principal
The amount of MUSD debt recorded on a loan’s struct, not including any interest.
Active Interest
Active Interest
The amount of MUSD interest recorded on a loan’s struct.
Active Debt
Active Debt
The amount of MUSD debt recorded on a loan’s struct (active principal plus active interest).
Entire Collateral
Entire Collateral
The sum of a loan’s active collateral plus its pending collateral rewards accumulated from distributions.
Entire Debt
Entire Debt
The sum of a loan’s active debt plus its pending debt rewards accumulated from distributions.
Individual Collateralization Ratio (ICR)
Individual Collateralization Ratio (ICR)
A loan’s ICR is the ratio of the dollar value of its entire collateral at the current collateral:USD price, to its entire debt.
Nominal Collateralization Ratio (NICR)
Nominal Collateralization Ratio (NICR)
A loan’s nominal ICR is its entire collateral (in collateral) multiplied by 100e18 and divided by its entire debt.
Entire System Collateral
Entire System Collateral
The sum of the collateral in the ActivePool and DefaultPool.
Entire System Debt
Entire System Debt
The sum of the debt in the ActivePool and DefaultPool.
Total Collateralization Ratio (TCR)
Total Collateralization Ratio (TCR)
The ratio of the dollar value of the entire system collateral at the current collateral:USD price, to the entire system debt.
Critical Collateralization Ratio (CCR)
Critical Collateralization Ratio (CCR)
150%. When the TCR is below the CCR, the system enters Recovery Mode.
Redemption
Redemption
The act of swapping MUSD tokens with the system, in return for an equivalent value of collateral. Any account with an MUSD token balance may redeem them, regardless of whether they are a borrower.
Liquidation
Liquidation
The act of force-closing an undercollateralized loan and redistributing its collateral and debt. When the Stability Pool is sufficiently large, the liquidated debt is offset with the Stability Pool, and the collateral distributed to depositors. If the liquidated debt cannot be offset with the Pool, the system redistributes the liquidated collateral and debt directly to the active loans with >110% collateralization ratio. Liquidation functionality is permissionless and publicly available - anyone may liquidate an undercollateralized loan, or batch liquidate loans.
Collateral Surplus
Collateral Surplus
The borrowers’ excess collateral that they can reclaim in the event that they have been fully redeemed against.
Offset
Offset
Cancellation of liquidated debt with MUSD in the Stability Pool, and assignment of liquidated collateral to Stability Pool depositors, in proportion to their deposit.
Gas Compensation
Gas Compensation
A refund in MUSD and collateral that automatically paid to the caller of a liquidation function, intended ensure liquidations are profitable during market stress. The $200 MUSD was set based on Ethereum gas prices and block times. Designed to ensure that liquidators are not dissuaded by potentially high gas costs.