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

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](#configuration) the `testnet-laconicd-deployment`)
 
-* Create required validator configuration:
+  * Fetch and enter your 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:
 
@@ -243,3 +267,7 @@ laconic-so deployment --dir testnet-laconicd-deployment start
   # Remove deployment directory (deployment will have to be recreated for a re-run)
   rm -r testnet-laconicd-deployment
   ```
+
+## Troubleshooting
+
+* If you face any issues in the onboarding app or the web-wallet, clear your browser cache and reload