update README.md

Author: jeffreysijuntan

README.md

@@ -1,6 +1,6 @@
 # Dots Application: Distributed Signature Signing
 
-### Installations
+## Installations
 
 Install Rust and GMP arithmetic library:
 
@@ -12,68 +12,49 @@ brew install rust
 brew install gmp
 ```
 
-# Setup Nodes
-First configure the server nodes in `server_conf.yml`. Any number of servers can be added. The default configuration runs with three servers;
+## Setup Nodes
+Before you begin, make sure you set up the workspace following the instructions in [dots-server](https://github.com/dots-platform/dots-server). We assume you have a workspace folder named `dots` and you are in this workspace. First, install the repo in this workspace:
 
-Ensure that the application configuration stanza is present in the server config. By default, the client uses the application name `signing`. If this repository is cloned as a sibling of the <https://github.com/dtrust-project/dots-server> repo, the following stanza should work:
+```
+git clone https://github.com/dots-platform/signing-app.git
+```
+
+Configure the server nodes in `dots-server/server_conf.yml`. Any number of servers can be added. The default configuration runs with three servers, so you should change the server config to set up three servers.
 
+Next, add the `signing` application to the config. By default, the following stanza should work:
 ```yaml
 apps:
   signing:
     path: ../signing-app/target/debug/rust_app
 ```
 
-# Start Nodes
+## Start Nodes
 Run the following command in one terminal in the `dots-server` repo.
 ```bash
-./start-n.sh 0 <N-1>
-```
-
-Where `<N-1>` is the number of servers minus one, or the index of the last server node.
-
-MacOS has a [known issue](https://github.com/ZenGo-X/multi-party-ecdsa/issues/66) where `rustc` has trouble locating the `gmp` library. You may see something similar to the following error:
-
-```jsx
-ld: library not found for -lgmp
-clang: error: linker command failed with exit code 1
+./start-n.sh 0 2
 ```
 
-If this happens, link the library manually by running:
-
-```jsx
-export LIBRARY_PATH=$LIBRARY_PATH:/opt/homebrew/lib
-export INCLUDE_PATH=$INCLUDE_PATH:/opt/homebrew/include
-```
-Now, restart the server.
-
-# Register user
+## Register user
 Register a user with the given username and password.
 ```jsx
 cargo run --bin client register username password
 ```
 
-# KeyGen
+## KeyGen
 We will generate keys for a scheme that has 3 separate parties and a threshold of 1 party. In a new terminal, run:
 
 ```jsx
 cargo run --bin client keygen username password 3 1 key.json
 ```
 The local key shares will be generated as files:
-- In `dtrust/signing/files/node1/key.json`, you will find the key for party 1.
-- In `dtrust/signing/files/node2/key.json`, you will find the key for party 2.
-- In `dtrust/signing/files/node3/key.json`, you will find the key for party 3.
-
-# Signing
+- In `dots-server/files/node{i}/key.json`, you will find the key for party i.
+## Signing
 
 We will sign the message `“hello”` by passing in the indices of the parties who attended the signing (`1,2`). In a new terminal, run:
 
 ```jsx
 cargo run --bin client sign username password 3 1 key.json 1,2 hello
 ```
-The resulting signature will be generated as a file:
-- In `dtrust/signing/files/node1/signature.json`, you will find the joint signature.
-- In `dtrust/signing/files/node2/signature.json`, you will find the joint signature.
-- In `dtrust/signing/files/node3/signature.json`, you will find nothing (not an active party).
 
 The joint signature will look something like this:
 ```jsx
@@ -155,3 +136,19 @@ The joint signature will look something like this:
    "recid":0
 }
 ```
+
+## Troubleshooting
+MacOS has a [known issue](https://github.com/ZenGo-X/multi-party-ecdsa/issues/66) where `rustc` has trouble locating the `gmp` library. You may see something similar to the following error:
+
+```jsx
+ld: library not found for -lgmp
+clang: error: linker command failed with exit code 1
+```
+
+If this happens, link the library manually by running:
+
+```jsx
+export LIBRARY_PATH=$LIBRARY_PATH:/opt/homebrew/lib
+export INCLUDE_PATH=$INCLUDE_PATH:/opt/homebrew/include
+```
+Now, restart the server.