https://github.com/makerdao/dss-charter

https://github.com/makerdao/dss-charter

Last synced: 3 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/makerdao/dss-charter
• Owner: makerdao
• License: agpl-3.0
• Created: 2021-07-06T05:46:34.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2023-03-16T02:02:28.000Z (over 1 year ago)
• Last Synced: 2024-04-06T09:34:09.785Z (7 months ago)
• Language: Solidity
• Size: 692 KB
• Stars: 13
• Watchers: 9
• Forks: 6
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Audit: audits/ChainSecurity_MakerDAO_DSS_Charter_audit.pdf

Awesome Lists containing this project

• awesome-smart-contract-development - DSS Charter
• awesome-dapptools - DSS Charter

README

        
# Charter

![Build Status](https://github.com/makerdao/dss-charter/actions/workflows/.github/workflows/tests.yaml/badge.svg?branch=master)

This is a vault manager that supports origination fees and permissioned vaults.

Charter wraps the Vat and the ManagedGemJoin adapter. Similarly to the CropJoin design, it creates proxy accounts for each user, while making sure only these accounts can hold the specific ilk's gem.

There is support for an unpermissioned mode, in which anyone can create a vault and draw debt. The new debt is applicable to an origination fee (`Nib`).

In the alternative permissioned mode, each vault owner is chartered a debt ceiling (`uline`) and specific origination fee (`nib`).

When accruing debt (during `frob`) the Charter contract validates the user's ceiling (if exists) and draws a portion of the created debt as system fee.

A minimal collateralization ratio (`Peace` / `peace`) is enforced upon drawing debt or withdrawing collateral.

As in CropJoin, liquidations can only be done by users who created a UrnProxy through the Charter contract.

### Terms

- `gate` : whether the ilk is permissioned.

- `Nib` : per ilk relative fee (for unpermissioned ilks).

- `nib` : per user relative fee for a specific ilk (for permissioned ilks).

- `Peace`: minimal collateralization ratio (for vaults in unpermissioned ilks).

- `peace`: per user minimal collateralization ratio (for vaults in permissioned ilks).

- `uline` : per user debt ceiling for a specific ilk (for permissioned ilks).

- `rollable` : whether a vault can move debt to another vault without paying origination fees (for vaults in permissioned ilks). 

### Proxy Actions

This repository also includes proxy action functions, located in the DssProxyActionsCharter and DssProxyActionsEndCharter contracts. They are to be used via ds-proxy, similarly to [dss-proxy-actions](https://github.com/makerdao/dss-proxy-actions).

As opposed to the original actions, these functions interact with the Charter and are not based on dss-cdp-manager as a CDP registry.