Skip to content

Commit 6e5651a

Browse files
committed
developing: remove obsolete terms
1 parent 23352cf commit 6e5651a

File tree

1 file changed

+8
-33
lines changed

1 file changed

+8
-33
lines changed

DEVELOPING.md

Lines changed: 8 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -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

7268
The core CDP, Dai, and collateral state is kept in the `Vat`. This
@@ -93,7 +89,7 @@ Similarly, a collateral `Ilk`:
9389

9490
Here, "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
9793
CDP of user `u`, using `gem` from user `v` and creating `dai` for user
9894
`w`.
9995

@@ -111,42 +107,21 @@ quantity of Sin.
111107

112108
Finally, 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
130116
across 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-
137118
Debt can be seized or injected into an ilk using `fold(i, u, rate)`,
138119
which increases the `dai` balance of the user `u` by increasing the
139120
encumbered 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

Comments
 (0)