Skip to content

Latest commit

 

History

History
34 lines (26 loc) · 3.67 KB

architecture.md

File metadata and controls

34 lines (26 loc) · 3.67 KB

Architecture

This section describes provides a high-level overview regarding the technical implementation of Mirror Protocol.

{% hint style="info" %} Even with a thorough understanding of Mirror Protocol, it is highly recommended to interact with Mirror through client channels such as the Mirror Web App or Mirror.js. {% endhint %}

Smart Contracts

The source code for Mirror smart contracts can be found on GitHub. Mirror Protocol is deployed with one of each of the following contracts, organized through the Factory.

Contract Function
Collector Gathers protocol fees incurred from CDP withdrawals and liquidations and send to Gov
Community Manages the Community Pool fund
Factory Central directory that organizes the various component contracts of Mirror
Gov

Allows other Mirror contracts to be controlled by decentralized governance

Distributes MIR received from Collector to MIR stakers and voters

Admin Manager Contract owned by Gov which enables contract migrations and admin actions through Mirror governance consensus.
Mint Handles both long and short CDP creation, management, and liquidation
Lock Responsible for locking up UST from short CDP
Oracle Hub Provides an interface for registering new oracle provider and fetching asset prices with highest priority
Collateral Oracle Feeds price and collateral multiplier for each collateral asset type
Staking Distributes MIR rewards from block reward to LP and sLP stakers
Limit Order Registers and executes swap orders at submitted limit price and amount

The Mirror Token (MIR) is a Terraswap CW20 Token instance that is created during the initial bootstrapping of the protocol and is registered with the Mirror Protocol core contracts.

When new mAssets are whitelisted, Mirror Protocol will create the following contract instances:

  • Terraswap CW20 Token for the new mAsset
  • Terraswap Pair for the new mAsset against UST
  • Terraswap CW20 Token for the new mAsset's LP Token
  • Terraswap CW20 Token for the new mAsset's sLP Token