laconicd-stack/docs/demo.md
2025-05-19 10:55:06 +05:30

2.6 KiB

demo

Prerequisites

Run node

  • Follow these steps to run first validator node: run-first-validator.md

  • Following steps can be used to run subsequent validator nodes

  • Copy the example variables file:

    cp ~/cerc/laconicd-stack/playbooks/validator/validator-vars.example.yml ~/cerc/laconicd-stack/playbooks/validator/validator-vars.yml
    
  • Check first validator node address using:

    laconic-so deployment --dir $DATA_DIRECTORY/$MAINNET_DEPLOYMENT_DIR exec laconicd 'echo $(laconicd cometbft show-node-id)@host.docker.internal:26656'
    

    NOTE: Make sure that DATA_DIRECTORY and MAINNET_DEPLOYMENT_DIR values are that of first validator deployment

  • Update cerc_peers in ~/cerc/laconicd-stack/playbooks/validator/validator-vars.yml:

    cerc_moniker: "LaconicMainnetNode-2"
    
    cerc_peers: "<node-id>@host.docker.internal: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-validator-deployment
    export MAINNET_DEPLOYMENT_DIR=
    
  • Update port mappings in ~/cerc/laconicd-stack/playbooks/validator/templates/specs/spec-template.yml.j2 to avoid port conflicts with first validator node:

    network:
      ports:
        laconicd:
          - '3060:6060'
          - '36657:26657'
          - '36656:26656'
          - '3473:9473'
          - '3090:9090'
          - '3317:1317'
    
  • 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
    

Create Validator

  • Export required env vars:

    # desired key name
    export KEY_NAME=<key-name>
    
    export DATA_DIRECTORY=<data-directory>
    export MAINNET_DEPLOYMENT_DIR=<mainnet-deployment-dir>
    
  • Run ansible playbook to create validator on running chain:

    ansible-playbook -i localhost, -c local ~/cerc/laconicd-stack/playbooks/validator/create-validator.yml
    
    • Input private key of the existing account when prompted
  • Check the validator list:

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