update README

Signed-off-by: Utkarsh Srivastava <[email protected]>

Author: tangledbytes

README.md

@@ -3,12 +3,31 @@
 go-vsr is the implementation of ViewStamped Replication[^1] in Golang. The goal here is to NOT build a production ready package rather is to simply play around with the protocol. As of now the it implements:
 1. Normal Operation
 2. View Change
+3. State Transfer
 
 Recovery is not yet supported.
 
 [^1]: https://pmg.csail.mit.edu/papers/vr-revisited.pdf
 
-There is a simulator in the repository but it is NOT functional at the moment. There are many reasons for that, primarily that there are still quite a few sources of non-determinism in the code (probably biggest is the networking layer).
+## Simulator
+The simulator in the repository is still in works as is the VSR implmentation. The simulator is a deterministic simulator, i.e. for as long as the given seed is the same, you should be able to generate the same scenarios on repeat. At the moment, the simulator is in working condition and can do the following:
+1. Take a seed and create a cluster of random numbers of replicas + random number of clients.
+2. Simulates packet drops
+3. Simulates unordered deliveries
+4. Simulates network delays
+5. Can do some sanity tests in the middle of the simulation as simulator drives the entire cluster and clients as well as has complete control over the passage of time.
+6. Performs a several assertions at the end of the simulation.
+
+### How to run?
+Running the simulator is easy, you just need Go installed on the system.
+```console
+$ go run ./cmd/simulator <seed>
+```
+
+If a seed is given then that seed will be used or else a seed will be generated and will be printed.
+
+## Example
+There is a simple client (REPL) server example in the repository. It can mimic a distributed in-memory KV store.
 
 ### How to run the example?
 ```console
@@ -41,5 +60,5 @@ client=>
 
 The above will start a client which can communicate with the cluster.
 
-### NOTE
+## NOTE
 This is below alpha level software at the moment and is being actively worked on.