@@ -10,7 +10,7 @@ previous iteration of Dai was called Single Collateral Dai (SCD), or
1010## Tooling
1111
1212- dapp.tools
13- - solc v0.4.24
13+ - solc v0.5.0
1414- tests use ds-test and are in files ending .t.sol
1515
1616
@@ -63,10 +63,6 @@ the considerations that make this code look like it does:
6363 into themselves, except for math. Again, this masks complexity.
6464
6565
66- ## Architecture
67-
68- ![ MCD calls] ( img/mcd-calls.png )
69-
7066## CDP Engine
7167
7268The core CDP, Dai, and collateral state is kept in the ` Vat ` . This
@@ -93,7 +89,7 @@ Similarly, a collateral `Ilk`:
9389
9490Here, "encumbered" means "locked in a CDP".
9591
96- CDPs are managed via ` tune (i, u, v, w, dink, dart)` , which modifies the
92+ CDPs are managed via ` frob (i, u, v, w, dink, dart)` , which modifies the
9793CDP of user ` u ` , using ` gem ` from user ` v ` and creating ` dai ` for user
9894` w ` .
9995
@@ -111,42 +107,21 @@ quantity of Sin.
111107
112108Finally, the quantity ` dai ` can be transferred between users with ` move ` .
113109
114- ### Identifiers
115-
116- The above discusses "users", but really the ` Vat ` does not have a
117- notion of "addresses" or "users", and just assigns internal values to
118- ` bytes32 ` identifiers. The operator of the ` Vat ` is free to use any
119- scheme they like to manage these identifiers. A simple scheme
120- is to give an ethereum address control over any identifier that has the
121- address as the last 20 bytes.
122-
110+ ### Rate
123111
124- ### Rates
112+ The ilk quantity ` rate ` define the ratio of exchange
113+ between un-encumbered and encumbered Debt.
125114
126- The ilk quantities ` take ` and ` rate ` define the ratio of exchange
127- between un-encumbered and encumbered Collateral and Debt respectively.
128-
129- These quantitites allow for manipulations collateral and debt balances
115+ This quantity allows for manipulation of debt balances
130116across a whole Ilk.
131117
132- Collateral can be seized or injected into an ilk using ` toll(i, u, take) ` ,
133- which decreases the ` gem ` balance of the user ` u ` by increasing the
134- encumbered collateral balance of all urns in the ilk by the ratio
135- ` take ` .
136-
137118Debt can be seized or injected into an ilk using ` fold(i, u, rate) ` ,
138119which increases the ` dai ` balance of the user ` u ` by increasing the
139120encumbered debt balance of all urns in the ilk by the ratio ` rate ` .
140121
141- The practical use of these mechanisms is in applying stability fees and
142- seizing collateral in the case of global settlement.
143-
144122## CDP Interface
145123
146- The ` Vat ` is unsuitable for use by untrusted actors. External
147- users can manage their CDP using the ` Pit ` ("trading pit").
148-
149- The ` Pit ` contains risk parameters for each ` ilk ` :
124+ The ` Vat ` contains risk parameters for each ` ilk ` :
150125
151126- ` spot ` : the maximum amount of Dai drawn per unit collateral
152127- ` line ` : the maximum total Dai drawn
@@ -155,7 +130,7 @@ And a global risk parameter:
155130
156131- ` Line ` : the maximum total Dai drawn across all ilks
157132
158- The ` Pit ` exposes one public function:
133+ The ` Vat ` exposes the public function:
159134
160135- ` frob(ilk, dink, dart) ` : manipulate the callers CDP in the given ` ilk `
161136 by ` dink ` and ` dart ` , subject to the risk parameters
0 commit comments