Proposal Types
Last updated
Last updated
Governance proposals on the Mirror Protocol can come in a variety of formats. There are four main categories of governance proposals: Asset Listing, Reward Distribution, Parameter Modification, and Suggestion / Others.
The full process of getting a new asset to be fully operational on the Mirror Protocol is described here.
The function of this proposal is to start a poll to whitelist a new asset. Given that this is a simple text proposal, there are a few fields that need to be filled. The Asset Name
, Ticker
, Listed Exchange
, and Reason for listing
are required. The length of the description field is limited to 1024 bytes. It is suggested that additional information be added on a separate web page and linked to using the Information Link
field.
Information that would be necessary for a voter to make informed decisions should be clearly stated in addition to reasons for listing this asset and the asset name and ticker. For example, simply stating:
Google should be listed because it is a popular stock
has numerous problems. First, the specific exchange that the price feed should be taken from is not clearly stated (many companies are dual-listed). Second, Google actually has two stocks that are publicly traded: GOOGL
and GOOG
(the former has voting rights whereas the latter does not). In addition, the official name registered with NASDAQ is not Google
but rather Alphabet Inc.
Thus it is extremely important to make it as clear as possible to others about the asset that you intend to whitelist.
Asset Name
Name of the asset to be whitelisted
Required
Ticker
Ticker of asset to be whitelisted
Required
Listed Exchange
Exchange that the underlying asset trades on
Required
Reason for listing
Short description of whitelist reason
Required
Information Link
External URL for further information
Optional
Suggested Oracle
Oracle provider or address
Optional
If a proposal to whitelist is approved, another poll must be passed to set the parameters of the newly listed asset. The required fields include Title
, Description
, Asset Name
, Symbol
, Oracle Provider
, Auction Discount
, and the Minimum Collateral Ratio
. Again, it is advised to include reference to the passed whitelist poll as well as reasoning for choosing the given oracle address. Given that the Mirror Protocol is in its early stages, it is advisable to keep the parameters equal to existing parameters for already listed assets (Auction Discount at 20%, and Minimum Collateral Ratio at 150%).
Oracle Provider can only be chosen among the ones that are listed on Oracle Hub contract. Originally, mAsset prices are provided by Band Protocol feeder, but other sources can be whitelisted to Oracle Hub contract through Mirror Governance.
Title
Title of the poll
Required
Description
Short description of the poll
Required
Information Link
External URL for further information
Optional
Asset Name
Name of the asset to be whitelisted
Required
Symbol
Ticker to be used on Mirror Protocol without the m
prefix (ex. AAPL instead of mAAPL)
Required
Reference Poll ID
Poll ID of referenced poll (ex. whitelisting poll)
Optional
Oracle Provider
Droplist of available oracle provider for a given symbol
. The droplist will appear once the symbol
field is entered correctly.
Required
Auction Discount
Discount ratio applied during CDP liquidation auction
Required
Minimum Collateral Ratio
Minimum collateral ratio applied when opening a mint position
Required
The function of this proposal is to start a poll to whitelist an asset which is scheduled to go through an initial public offering (or IPO), but is not publicly listed yet. Similar to the "Suggest asset whitelisting" proposal, this is also a text proposal. Fields that need to be filled are Asset Name
, Ticker
, Listed Exchange
, and Reason for listing
. It is suggested that additional information on the IPO or supporting information to be added using the Information Link
field.
Title
Name of the asset to be whitelisted
Required
Reason for listing
Short description of whitelist reason
Required
Asset Name
Name of the asset to be whitelisted
Required
Symbol
Ticker of the asset to be whitelisted
Required
Listed Exchange
Exchange which the underlying asset will be traded on
Required
Information Link
External URL for further information
Optional
Suggested Oracle
Oracle provider or address
Optional
After the proposal to suggest Pre-IPO asset is approved, an additional poll to register the asset to Mirror Protocol must be submitted and executed.
Title
Title of the poll
Required
Description
Short description of whitelist reason
Required
Information Link
External URL for further information
Optional
Asset Name
Name of the asset to be whitelisted
Required
Symbol
Ticker of the asset to be whitelisted (without the m
prefix)
Required
Reference Poll ID
Poll ID of the referenced poll
Optional
Listed Exchange
Exchange which the underlying asset will be traded on
Required
Oracle Provider
Droplist of available oracle provider for a given symbol
. The droplist will appear once the symbol
field is entered correctly.
Required
Auction Discount (after IPO)
Discount ratio applied during CDP liquidation auction for Post-IPO asset
Required
Min collateral ratio (after IPO)
Minimum collateral ratio to be used for mint operations for Post-IPO asset
Required
Min Collateral Ratio (during mint period)
Collateral ratio to be applied during mint_period
Required
Mint Period
Number of seconds which mint operation will be allowed for Pre-IPO asset
Required
Pre-IPO Price
Fixed price decided by official IPO registration statement, which will be used for Pre-IPO asset
Required
Specific mAsset on Mirror Protocol is delisted upon approval and execution of this poll. More information about delisting can be found here.
Title
Name of the asset to be whitelisted
Required
Description
Short description of whitelist reason
Required
Information Link
External URL for further information
Optional
Asset Name
Droplist of mAsset on Mirror Protocol
Required
This category allows modification of two types of MIR distribution: 1) mAsset LP staking reward; 2) Governance voting reward.
Through this poll, the ratio which newly minted MIR tokens are distributed among LP token stakers, called weight
parameter can be changed. To learn how weight
parameter determines the amount of MIR distributed to each mAsset pool refer to this document.
Title
Name of the asset to be whitelisted
Required
Reasons for modifying weight parameter
Short description of whitelist reason
Required
Information Link
External URL for further information
Optional
Asset
Droplist of mAsset on Mirror Protocol, which to change weight parameter for
Required
Weight
Weight parameter to be applied for LP staking reward distribution
Required
This poll category allows modification of mAsset, governance contract, collateral and premium tolerance parameters in Mirror Protocol.
Through this poll, the existing Mirror Protocol parameters for a specific individual mAsset can be modified. The possible parameters to be updated consist of either the Auction Discount
and the Minimum Collateral Ratio
.
Title
Title of the poll
Required
Reasons for modifying mint parameters
Short description of the poll
Required
Information Link
External URL for further information
Optional
Asset
Name of the asset to modify parameters
Required
Auction Discount
Discount ratio applied during CDP liquidation auction
Required
Minimum Collateral Ratio
Minimum collateral ratio applied when opening a mint position
Required
Similar to modifying mint parameters, governance parameters such as the Effective Delay
, and Voter Weight
can be modified.
Title
Title of the poll
Required
Reason for modifying governance parameter
Short description of the poll
Required
Information Link
External URL for further information
Optional
Effective Delay
Length of delay before protocol integration for a passed poll (in units of seconds)
Optional
Voter Weight
Ratio of rewards to be distributed to governance voting participants
Optional
This poll allows configuration modifications for default_poll
types such as quorum
, threshold
, voting_period
and proposal_deposit
.
Due to sensitivity in contract migration polls, both migration and key authorization poll configurations cannot be modified through Mirror Web App UI.
Title
Title of the poll
Required
Description
Short description of the poll
Required
Information Link
External URL for further information
Optional
Quorum
Minimum quorum required for accepting a poll (in percentage)
Optional
Threshold
Minimum percentage of YES
votes to pass a poll (in percentage)
Optional
Voting Period
Length of poll (in units of seconds)
Optional
Proposal Deposit
Required deposit to start a poll (in units of MIR)
Optional
Through this poll, existing collateral's multiplier
or oracle address
can be modified.
Title
Title of the poll
Required
Reasons for modifying collateral parameter
Short description of the poll
Required
Information Link
External URL for further information
Optional
Collateral (Asset)
Droplist of collateral types on Mirror Protocol, which to modify parameter for
Required
Multiplier
Number to be min_collateral_ratio
of the asset being minted
Required
Collateral Oracle Feeder
Address of the collateral oracle used for this asset type
Required
This category allows modification on price oracle settings and parameters.
This poll is to propose the priority settings of an mAsset’s price feed. For instance, if there are more than one price sources supporting a specific mAsset (i.e. Band Protocol and Chainlink), the proposer can create a poll to prefer one price source over another.
This poll can only be submitted when there is more than one price source for a chosen mAsset.
Title
Title of the poll
Required
Description
Short description of priority change reason
Required
Information Link
Optional URL for further information
Optional
Asset
Droplist of mAssets on Mirror Protocol, which to change price priority for
Required
Priority
Drag & Drop field to put one price source over another. Sources are loaded only after the Asset field is selected.
Required
When there is a price source that is invalid or unnecessary (as decided by community consensus), the proposer of this poll can suggest removing a price source for an asset.
Title
Title of the poll
Required
Description
Short description of price removal
Required
Information Link
Optional URL for further information
Optional
Asset
Droplist of mAssets on Mirror Protoco, which to change price priority for
Required
Priority
Droplist of prices currently being provided fro the chosen mAsset. The field may not be a droplist if there is only one price source.
Required
Proposals relating to spending the accrued MIR tokens in the community pool can be made under this section. The proposal should ideally specify the reasons for the distribution and identify the recipient and amount to be given.
Title
Title of the poll
Required
Reason for community pool spending
Short description of the poll
Required
Information Link
External URL for further information
Optional
Recipient
Grant recipient address
Required
Amount
Grant amount (in units of MIR)
Required
The function of the text proposal is to allow proposals that do not fit the defined categories. Given that it is a basic text proposal, simple fields for the Title
, Description
, and an Information Link
for additional information.
Title
Title of the poll
Required
Description
Short description of the poll
Required
Information Link
External URL for further information
Optional