cerc-io/laconicd-stack
13
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Add more details in steps for running subsequent validator node (#20)

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

Reviewed-on: #20
Co-authored-by: Nabarun <nabarun@deepstacksoft.com>
Co-committed-by: Nabarun <nabarun@deepstacksoft.com>
This commit is contained in:
Nabarun 2025-06-13 18:05:07 +00:00 committed by nabarun
parent 4eeb9f751e
commit d8504e27fb
3 changed files with 31 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
.gitignore vendored
View File

@ -3,3 +3,6 @@
# Playbook vars
*-vars.yml
# Playbooks inventories
hosts.ini

22
docs/run-first-validator.md
View File

@ -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

18
docs/run-validator.md
View File

@ -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