This post serves to inform all stakeholders of the risk parameters that are slated to be included in the upcoming Liquidations 2.0 release and to initiate discussion around them. Note that it is not too late to add, remove, or modify parameters, and this post will be updated accordingly as this occurs. For example, the best way to add a liquidation incentive is currently being considered, and will involve the addition of at least one more risk parameter.
This post is intended to be more focused on the risk aspect rather than the technical smart contract aspect, and thus parameters are discussed in a way that is natural to human thought. For example, the
chop parameter is often referred to in percentage terms during risk discussions (“a
chop of 13%”) even though the underlying smart contracts would require that value to be expressed as
1.13 * 10^27.
Liquidator Contract (Dog)
Hole : upper limit on the amount of DAI needed to cover the debt and penalty of all active auctions; liquidations cannot occur once the limit is reached.
chop : as in the current system, a liquidation penalty that causes the auctions to seek a greater amount of DAI (above the Vault’s debt) before collateral can be returned to the Vault. Prevents the “auction grinding” attack.
hole : similar to
Hole, but per-ilk. This allows taking into account market liquidity on a per-collateral basis when limiting the amount of DAI needed to cover debt+penalty of active auctions.
chip : percentage of the Vault’s debt to reward as DAI to the liquidator (caller of
bark). Bad debt is simultaneously assigned to the Vow. This parameter acts to reward Keepers proportionally to the amount of risk they remove from the system by liquidating an undercollateralized Vault. So long as it is less than
chop by a margin of safety, liquidations are still net-positive for the system in terms of income.
tip : a constant reward paid as DAI to the liquidator (caller of
bark). This parameter can be used to cover the gas costs of liquidation, or to add extra incentive for liquidating smaller Vaults which might be less attractive to liquidators.
Auction Contract (Clipper)
buf : percentage increase applied to the OSM price when determining the starting price for an auction.
tail : maximum auction duration. Auctions that have run longer than this time period must be reset with a call to the
cusp : minimum percentage of starting price that an auction is permitted to reach before a reset is required. E.g. if the starting price is 500 DAI/COL, and
cusp is 20%, then if the price reaches or falls below 100 DAI/COL the auction cannot be bid on and must be reset.
calc : a contract implementing a price versus time curve. Different price curves will have their own, separate, risk parameters. For example, a linear decrease function may be parametrized by the time required to reach zero, or an exponential function by its half life. Currently, the contract assumes an interface in which the price at time t is a function of only the auction’s initial price, it’s start time, and t.