From eb2e271cbec3d66c7fa879212015fe40562b7762 Mon Sep 17 00:00:00 2001
From: Prathamesh Musale <prathamesh.musale0@gmail.com>
Date: Thu, 8 Aug 2024 18:42:26 +0530
Subject: [PATCH] Update validator creation instructions to use onboarding app

---
 README.md                       |   3 +
 testnet-onboarding-validator.md | 102 ++++++++++++++++++++------------
 2 files changed, 66 insertions(+), 39 deletions(-)

diff --git a/README.md b/README.md
index 8e656ed..ce2c0e9 100644
--- a/README.md
+++ b/README.md
@@ -10,3 +10,6 @@ Stacks to run a node for laconic testnet
 
 Follow steps in [testnet-onboarding-demo.md](./testnet-onboarding-demo.md) to run demo for onboarding testnet participants in laconicd chain
 
+## Join LORO testnet
+
+Follow steps in [testnet-onboarding-validator.md](./testnet-onboarding-validator.md) to onboard your participant and join as a validator on the LORO testnet
diff --git a/testnet-onboarding-validator.md b/testnet-onboarding-validator.md
index 50a0b60..93c0bf3 100644
--- a/testnet-onboarding-validator.md
+++ b/testnet-onboarding-validator.md
@@ -29,7 +29,7 @@
 
   * Send transaction request to the wallet
 
-    * From wallet, approve and send transaction to laconicd chain
+    * From wallet, approve and send transaction to stage0 laconicd chain
 
 ## Join as a validator on stage1
 
@@ -123,7 +123,7 @@
   # Use the provided node id
   CERC_PEERS=""
 
-  # A custom human readable name for this node (default: TestnetNode)
+  # A custom human readable name for this node
   CERC_MONIKER=
   ```
 
@@ -163,53 +163,77 @@ laconic-so deployment --dir testnet-laconicd-deployment start
 
 ### Join as testnet validator
 
-* Import a key pair:
+* Create a validator from the onboarding app:
 
-  ```bash
-  KEY_NAME=alice
+  * Visit the [validator creation](https://loro-signup.laconic.com/validator) page
 
-  # Restore existing key with mnemonic seed phrase
-  # You will be prompted to enter mnemonic seed
-  laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd keys add $KEY_NAME --recover"
+  * Select the Laconic account (same as the one used while onboarding) using which you wish to send the create validator request
 
-  # Query the keystore for your account's address
-  laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd keys show $KEY_NAME -a"
-  ```
+    * This should display the details of your onboarded participant
 
-* Check balance for your account:
+    * You can proceed if the participant has `validator` role
 
-  ```bash
-  laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd query bank balances <account-address>"
-  ```
+  * Enter your node's moniker (use the same one used while configuring the `testnet-laconicd-deployment`)
 
-* Create required validator configuration:
+  * Fetch and enter you validator's pubkey:
 
-  ```bash
-  # Note:
-  # Edit the staking amount and other fields as required
-  # Replace <your-node-moniker> with your node's moniker in command below
+    ```bash
+    laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd cometbft show-validator" | jq -r .key
+    ```
 
-  laconic-so deployment --dir testnet-laconicd-deployment exec laconicd 'cat <<EOF > my-validator.json
-  {
-    "pubkey": $(laconicd cometbft show-validator),
-    "amount": "1000000000000000alnt",
-    "moniker": "<your-node-moniker>",
-    "commission-rate": "0.1",
-    "commission-max-rate": "0.2",
-    "commission-max-change-rate": "0.01",
-    "min-self-delegation": "1"
-  }
-  EOF'
-  ```
+  * Send the transaction request to wallet
 
-* Create a validator:
+    * From wallet, approve and send transaction to stage1 laconicd chain
 
-  ```bash
-  laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd tx staking create-validator my-validator.json \
-  --fees 500000alnt \
-  --chain-id=laconic_9000-1 \
-  --from $KEY_NAME"
-  ```
+* Alternatively, create a validator using the laconicd CLI:
+
+  * Import a key pair:
+
+    ```bash
+    KEY_NAME=alice
+
+    # Restore existing key with mnemonic seed phrase
+    # You will be prompted to enter mnemonic seed
+    laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd keys add $KEY_NAME --recover"
+
+    # Query the keystore for your account's address
+    laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd keys show $KEY_NAME -a"
+    ```
+
+  * Check balance for your account:
+
+    ```bash
+    laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd query bank balances <account-address>"
+    ```
+
+  * Create required validator configuration:
+
+    ```bash
+    # Note:
+    # Edit the staking amount and other fields as required
+    # Replace <your-node-moniker> with your node's moniker in command below
+
+    laconic-so deployment --dir testnet-laconicd-deployment exec laconicd 'cat <<EOF > my-validator.json
+    {
+      "pubkey": $(laconicd cometbft show-validator),
+      "amount": "1000000000000000alnt",
+      "moniker": "<your-node-moniker>",
+      "commission-rate": "0.1",
+      "commission-max-rate": "0.2",
+      "commission-max-change-rate": "0.01",
+      "min-self-delegation": "1"
+    }
+    EOF'
+    ```
+
+  * Create a validator:
+
+    ```bash
+    laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd tx staking create-validator my-validator.json \
+    --fees 500000alnt \
+    --chain-id=laconic_9000-1 \
+    --from $KEY_NAME"
+    ```
 
 * View staking validators: