laconicd-stack/run-validator.md

Run Validator Node

Prerequisites

• ansible
• laconic-so

Run node

• Fetch the stack:

  laconic-so fetch-stack git.vdb.to/cerc-io/laconicd-stack --git-ssh --pull
  

  This command clones the entire repository into the ~/cerc folder, which includes the genesis file published by the first validator.

• Copy the example variables file:

  cp ~/cerc/laconicd-stack/playbooks/validator/validator-vars.example.yml ~/cerc/laconicd-stack/playbooks/validator/validator-vars.yml
  

• Update ~/cerc/laconicd-stack/playbooks/validator/validator-vars.yml with required values:

  # Path to the genesis file published by the first validator
  genesis_file: "~/cerc/laconicd-stack/genesis/mainnet-genesis.json"
  
  # Set custom moniker for the node
  cerc_moniker: "LaconicMainnetNode"
  
  # Set chain ID (should match the one in the genesis file)
  cerc_chain_id: "laconic-mainnet"
  
  # Set minimum gas price
  min_gas_price: 0.001
  
  # Set log level
  cerc_loglevel: "info"
  
  # Set persistent peers (comma-separated list of node IDs and addresses)
  # You can find the list of available peers in node-addresses.yml
  cerc_peers: "<node-id>@<node-host>:26656,<node-id>@<node-host>:26656"
  

• Export the data directory and mainnet deployment directory as environment variables:

  # Parent directory where the deployment directory will live
  export DATA_DIRECTORY=
  
  # Set mainnet deployment directory
  # for eg: mainnet-laconicd-deployment
  export MAINNET_DEPLOYMENT_DIR=
  

• Run ansible playbook to set up and start your validator node:

  ansible-playbook -i localhost, -c local ~/cerc/laconicd-stack/playbooks/validator/run-validator.yml
  

• Check logs to ensure that node is running:

  laconic-so deployment --dir $DATA_DIRECTORY/$MAINNET_DEPLOYMENT_DIR logs laconicd -f
  

Register Your Node

• Get your node's address:

  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

• Submit a PR to add your node address to the repository