Sustainability Module
The protocol's resource management engine
Relevant smart contracts:
1. Overview
The Sustainability Module allocates resources to actors that update critical system components such as oracles, even in the absence of governance power over the protocol.
2. Component Descriptions
StabilityFeeTreasury
- this contract tries to keep an "optimum" amount of stability fees for itself in order to make sure it can provide funds to other contracts (or in some cases, people) that maintain the protocol's well-being. Anyone can periodically call a function to recalculate the optimum amount of funds to keep in the treasury. Any surplus above optimum values is transferred to theextraSurplusReceiver
.FSMWrapper
- this contract is meant to act as a funding source for FSM-like contracts as well as an interface that allows other contracts to read data from the FSM integrated with the wrapper.IncreasingTreasuryReimbursement
- this contract is meant to be inherited from and used as a way to offer an increasing stability fee reward (pulled from the SF treasury) to any address.MandatoryFixedTreasuryReimbursement
- this is a contract meant to be inherited from and used as a way to offer a fixed stability fee reward (pulled from the SF treasury) to any address.IncreasingRewardRelayer
- this is a contract meant to pull funds from theStabilityFeeTreasury
and send them to a custom address. It inherits functionality from theIncreasingTreasuryReimbursement
contract
3. Risks
Smart Contract Bugs
A bug in the
StabilityFeeTreasury
would potentially block other contracts from pulling funds or would incorrectly calculate the optimum amount of funds to keep in the contract (SAFEEngine.coinBalance[stabilityFeeTreasury]
). A bug could also prevent the treasury from sending extra unused resources to another address usingtransferSurplusFunds()
A bug in the
IncreasingTreasuryReimbursement
contract could block the execution ofrewardCaller()
or it would make it impossible for someone to callgetCallerReward
Similar to the
IncreasingTreasuryReimbursement
contract, a bug inMandatoryFixedTreasuryReimbursement
could block the execution ofrewardCaller()
Misconfiguration
Governance might set an incorrect address as the
extraSurplusReceiver
in theStabilityFeeTreasury
or could maliciously withdraw the permission of core contracts to pull funds. Governance could also allow malicious contracts to drain the treasury.Governance might set high values for
maxRewardIncreaseDelay
andperSecondCallerRewardIncrease
insideIncreasingTreasuryReimbursement
and thus makegetCallerReward
revert
4. Governance Minimization
Governance can withdraw their power over the StabilityFeeTreasury
if two conditions are satisfied:
All treasury dependent contracts were set up correctly (can withdraw enough funds to function properly).
All external actors (if any) have the necessary permissions to pull funds from the treasury.
The StabilityFeeTreasury
is part of the Level 2 Gov Minimization. That being said, governance should maintain control only over setting total
allowances to their initial values for every address that's currently authorized to pullFunds
from the treasury.
The FSMWrapper
may need to have leftover governance (depending on how much governance wants to automate reward setting).
IncreasingRewardRelayer
can have governance in the long run, depending on how much governance wants to remove themselves from the contract and also on what the contract is requesting rewards for.
IncreasingTreasuryReimbursement
and MandatoryFixedTreasuryReimbursement
are meant to be inherited by other contracts and so the contracts that inherit them will determine how much they can be governance minimized.
Keeping Governance Over takeFunds
Given that StabilityFeeTreasury.takeFunds
has very simple and clearly defined behaviour, it can be governed in the long run.
Last updated