From d8504e27fbc0ba8bc47ac3cef2000ccd23de520f Mon Sep 17 00:00:00 2001
From: Nabarun <nabarun@deepstacksoft.com>
Date: Fri, 13 Jun 2025 18:05:07 +0000
Subject: [PATCH] Add more details in steps for running subsequent validator
 node (#20)

Part of https://www.notion.so/Create-stacks-for-mainnet-1f2a6b22d4728034be4be2c51decf94e

Reviewed-on: https://git.vdb.to/cerc-io/laconicd-stack/pulls/20
Co-authored-by: Nabarun <nabarun@deepstacksoft.com>
Co-committed-by: Nabarun <nabarun@deepstacksoft.com>
---
 .gitignore                  |  3 +++
 docs/run-first-validator.md | 22 ++++++++++++++++++----
 docs/run-validator.md       | 18 ++++++++++--------
 3 files changed, 31 insertions(+), 12 deletions(-)

diff --git a/.gitignore b/.gitignore
index 9098bbb..74a157a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -3,3 +3,6 @@
 
 # Playbook vars
 *-vars.yml
+
+# Playbooks inventories
+hosts.ini
diff --git a/docs/run-first-validator.md b/docs/run-first-validator.md
index df83237..8429312 100644
--- a/docs/run-first-validator.md
+++ b/docs/run-first-validator.md
@@ -275,8 +275,8 @@
 - Copy the genesis file generated in [Generate mainnet genesis file section](#generate-mainnet-genesis-file) from machine 3 to the machine 2 mainnet deployment tmp directory:
 
   ```bash
-  # Directory on machine 2 to place genesis.json file
-  echo $DATA_DIRECTORY/$MAINNET_DEPLOYMENT_DIR/data/laconicd-data/tmp/
+  # Example command to transfer file from machine 3 to machine 2 (run on machine 3)
+  scp -C $DATA_DIRECTORY/output/genesis.json <user>@<machine-ip-address>:<absolute-path-to-deployments-directory>/mainnet-laconicd-deployment/data/laconicd-data/tmp/
   ```
 
 - Command to run node:
@@ -399,6 +399,20 @@
   laconic-so deployment --dir $DATA_DIRECTORY/$MAINNET_DEPLOYMENT_DIR exec laconicd 'echo $(laconicd cometbft show-node-id)@laconicd-mainnet.laconic.com:26656'
   ```
 
-- Add your node's address to [node-addresses.yml](./node-addresses.yml)
+- Add your node's address to [node-addresses.yml](../node-addresses.yml)
 
-- Submit a PR with this genesis file, staking amount file and node address so that it is available to other validators
+  - Update the file `~/cerc/laconicd-stack/node-addresses.yml` in machine where genesis file is generated (machine 3)
+
+- Check git status of the stack repo
+
+  ```bash
+  cd ~/cerc/laconicd-stack
+  git status
+  ```
+
+  The following files should show up:
+  - node-addresses.yml
+  - config/mainnet-genesis.json
+	- config/staking-amount.json
+
+- Submit a PR with the genesis file, staking amount file and node address so that it is available to other validators
diff --git a/docs/run-validator.md b/docs/run-validator.md
index fa08c1b..fc1f7b8 100644
--- a/docs/run-validator.md
+++ b/docs/run-validator.md
@@ -139,7 +139,7 @@
 
   ```yaml
   # Absolute path to the node's private validator key file
-  priv_validator_key_file_path: "</path/to/priv_validator_key.json>"
+  priv_validator_key_file_path: "<absolute/path/to/priv_validator_key.json>"
 
   # Set the IP address of the machine where the laconicd node is setup
   node_ip: "<NODE_PUBLIC_IP_ADDRESS>"
@@ -189,6 +189,8 @@
   laconic-so deployment --dir $DATA_DIRECTORY/$MAINNET_DEPLOYMENT_DIR logs laconicd -f
   ```
 
+  NOTE: The node takes a long time to start syncing blocks `~40 seconds`.
+
 - Get the public key of your node:
 
   ```bash
@@ -212,23 +214,23 @@
   NOTE: Use the public key exported in [previous step](#start-node)
 
   ```bash
-  # Same moniker as set above
-  cerc_moniker: "<your-moniker>"
+  # Set the public IP address of the machine where your node is running
+  node_url: "tcp://NODE_PUBLIC_IP_ADDRESS:26657"
 
   # Make sure to wrap it with single quotes ('')
   validator_pub_key: '<public-key-of-your-node>'
 
-  # Set the public IP address of the machine where your node is running
-  node_url: "tcp://NODE_PUBLIC_IP_ADDRESS:26657"
+  # Same moniker as set above
+  cerc_moniker: "<your-moniker>"
   ```
 
-- Export required env vars:
+- Set a directory path required by the playbook to create validator (used temporarily):
 
   ```bash
   export DATA_DIRECTORY=<data-directory>
   ```
 
-- Run ansible playbook to create validator on running chain:
+- Run ansible playbook to create a validator in the running chain:
 
   ```bash
   ansible-playbook -i localhost, -c local ~/cerc/laconicd-stack/playbooks/validator/create-validator.yml
@@ -302,6 +304,6 @@
   laconic-so deployment --dir $DATA_DIRECTORY/$MAINNET_DEPLOYMENT_DIR exec laconicd 'echo $(laconicd cometbft show-node-id)@YOUR_PUBLIC_IP_ADDRESS:26656'
   ```
 
-- Add your node's address to the `~/cerc/laconicd-stack/node-addresses.yml` file
+- Add your node's address to the [node-addresses.yml](../node-addresses.yml) file
 
 - Submit a PR to add your node address to the repository