Token Module
ERC20 tokens, authority contracts and adapters for exiting and joining collateral in an out of the system
Last updated
ERC20 tokens, authority contracts and adapters for exiting and joining collateral in an out of the system
Last updated
Relevant smart contracts:
The token module has four distinct parts:
System Coin: token that the core system considers equal in value to its internal debt unit.
Protocol Token: a ds-token with delegation capabilities inherited from which were in turn inherited from . It contains logic for burning and authorized minting. The token can be used to govern the system and as a recapitalization source.
Protocol Token Authority: authority contract that determines who is eligible to mint and burn protocol tokens.
Geb Printing Permissions: permissioning system to allow multiple debt auction contracts to mint protocol tokens.
Token Adapters:
Collateral Adapters: contracts that allow anyone to join or exit collateral in and out of GEB
Coin Join: adapter for the system coin to exit the system in the form of an ERC20 and enter the system in the form of SAFEEngine.coinBalance
System Coin: this contract is the user facing ERC20 token maintaining the accounting for external system coin balances.
As a governance token: tokens can be used as a representation of voting power
As a recapitalization resource: protocol tokens can autonomously be minted by the DebtAuctionHouse and sold for system coins which are used to recapitalize the system in times of insolvency
Protocol Token Authority: determines who can mint and burn protocol tokens. Can be controlled directly by token holders, by the Protocol Token Authority or in some cases all control can be withdrawn from it.
Geb Printing Permissions: forces governance to adhere to specific rules in order to allow multiple, independent DebtAuctionHouses to print protocol tokens.
Token Adapters: these are custom contracts that can allow anyone to deposit and withdraw collateral or they can have whitelisting in place to
Emergency shutdown cannot be triggered if governance calls PROTOCOL_TOKEN.stop beforehand
There is the possibility for a user to have their funds stolen by a malicious adapter which does not actually send tokens to the SAFEEngine, but instead to some other contract or wallet.
Governance can withdraw their voting power over all contracts, although, if they wish to allow the Protocol Token to protect multiple GEBs, they may retain influence over the Geb Printing Permissions.
All of the contracts in this module are part of Level 1 Gov Minimization.
Protocol Token: a token adhering to the ERC20 standard which also has -protected mint and burn functions as well as delegation capabilities. The protocol token has two main use-cases:
The system coin is susceptible to the