Update Rock-Paper-Scissors readme

Author: bigspider

Diff for: examples/rps/README.md

@@ -1,18 +1,36 @@
 
-## Rock-Paper-Scissors
+# Rock, Paper, Scissors (RPS) with Bitcoin Protocol
 
-Rock-Paper-Scissors is an interactive game between two players who lock some money into a UTXO, and then proceed to play the game; the winner will get the sats.
+This script implements the Rock, Paper, Scissors game based on a protocol described [here](https://lists.linuxfoundation.org/pipermail/bitcoin-dev/2023-May/021599.html).
 
-Play as Alice:
 
-```console
-$ python rps.py --alice --rock
+## Prerequisites
+
+After following the [root prerequisites](../..#prerequisites), make sure to install the additional requirements:
+
+```bash
+$ pip install -r requirements.txt
 ```
 
-On a separate terminal, play as Bob:
+## How to Run:
 
-```console
-$ python rps.py --alice --scissors
+The game can be played as either Alice or Bob, and you can specify your move (rock, paper, scissors). Additionally, other options like non-interactive mode and automatic mining can be set.
+
+```bash
+python rps.py --alice/--bob [--rock/--paper/--scissors] [--non-interactive] [--mine-automatically] [--host HOST] [--port PORT]
 ```
 
-The two scripts will communicate via a socket in order to coordinate the initial UTXO creation; once the game is funded, they take turns to spend it according to the rules.
+In order to play a game, run `python rps.py --alice` on a shell, and `python rps.py --bob` on a separate shell.
+
+The two scripts will establish a socket to communicate and negotiate a game UTXO.
+
+Once the UTXO is funded (NOTE: it must be funded externally), the two scripts proceed to play the game. 
+
+### Arguments:
+
+- `--alice` / `--bob`: Specify the player you want to play as.
+- `--rock` / `--paper` / `--scissors`: Specify your move. If ommitted, a random move is chosen.
+- `--non-interactive`: Run in non-interactive mode (if not enabled, the user has to confirm each action).
+- `--mine-automatically`: Enable automatic mining when transactions are broadcast.
+- `--host`: Specify the host address (default is `localhost`).
+- `--port`: Specify the port number (default is `12345`).