laconicd-stack/playbooks/validator

validator

This directory contains playbooks for setting up and managing a validator on the Laconic chain. There are two main playbooks:

• create-validator.yml - Creates a validator on an already running node
• (Coming soon) setup-validator.yml - Sets up and runs a validator node

Prerequisites

• Ansible
• Stack orchestrator
• Private key or mnemonic of validator account from previous testnet
  • Use https://wallet.laconic.com

Configuration

• Set the required environment variables:

  export DATA_DIRECTORY=/path/to/deployment/parent/directory
  export DEPLOYMENT_DIR=validator-laconicd-deployment
  

• Copy the example variables file and edit it:

  cp validator-vars.example.yml validator-vars.yml
  

• Edit validator-vars.yml to set your validator parameters:

  # Chain configuration
  cerc_moniker: "YourValidatorName"  # Your validator's name
  cerc_chain_id: "laconic-mainnet"    # Chain ID
  
  # TODO: Add persistent peer addresses
  cerc_peers: ""                     # Comma-separated list of peers
  

Creating a Validator

To create a validator:

• Make sure your validator node is running and synced

• Set key name used for importing validator account

  export KEY_NAME=<key-name>
  

• Run the create-validator playbook:

  ansible-playbook playbooks/validator/create-validator.yml
  

Verification

After running the playbook, you can verify your validator was created by:

• Check the validator list:

  laconic-so deployment --dir $DATA_DIRECTORY/$DEPLOYMENT_DIR exec laconicd 'laconicd query staking validators'
  

• Check your validator's details:

  laconic-so deployment --dir $DATA_DIRECTORY/$DEPLOYMENT_DIR exec laconicd 'laconicd query staking validator $(laconicd keys show validator --bech val -a)'