diff --git a/dev-docs/README.md b/dev-docs/README.md index aaecae4..5d2dde1 100644 --- a/dev-docs/README.md +++ b/dev-docs/README.md @@ -28,12 +28,12 @@ The workflow of a token trade has three parts: 2. **Take** - A second user, known as a *Taker*, will *take* the *Offer* by issues a *Counter Offer* 3. **Accept** - The original *Maker* checks the *Counter Offer* and *Accepts* it by signing and then broadcasting the transaction. -Trade done in this way are both *trustless* and *atomic*: -- **Trustless** - This means that neither party needs to trust the other. The Maker gets to review the Counter Offer before broadcasting it. The Maker can not alter the Counter Offer after the Taker has signed it. +Trades done in this way are both *trustless* and *atomic*: +- **Trustless** - This means that neither party needs to trust the other. The *Maker* gets to review the *Counter Offer* before broadcasting it. The *Maker* can not alter the *Counter Offer* after the *Taker* has signed it. - **Atomic** - The trade happens in a single transaction. There is no middle-state where the trade can get stuck. It either happens or doesn't, it's state is binary and atomic. Specific *Entities* are defined in the [specification](./specification.md), but here is a brief summary: -- **Order** represents the Maker side of the trade. This entity is tracked internal to `bch-dex` and is used to track tokens set aside for sale. +- **Order** represents the *Maker* side of the trade. This entity is internal to `bch-dex`. It is used to track tokens set aside for sale and managed by the wallet controlled by `bch-dex`. - **Offer** contains most of the same information as an **Order**, but is external to `bch-dex`. This is data submitted to the P2WDB and visible to all users on the network. - **Counter Offer** is generated by a *Taker*, in order to take the other side of the trade. It contains a partially-signed transaction, ready for review by the *Maker*.