tmkms-stack/stack-orchestrator/stacks/tmkms

tmkms

Instructions for running TMKMS service

Prerequisites

• laconic-so

• A cosmos-sdk based node setup

Setup

• Clone the stack repo:

  laconic-so fetch-stack git.vdb.to/LaconicNetwork/tmkms-stack --git-ssh --pull
  

• Clone required repositories:

  laconic-so --stack ~/cerc/tmkms-stack/stack-orchestrator/stacks/tmkms setup-repositories --git-ssh --pull
  
  # If this throws an error as a result of being already checked out to a branch/tag in a repo, remove the repository and re-run the command
  

• Build the container images:

  laconic-so --stack ~/cerc/tmkms-stack/stack-orchestrator/stacks/tmkms build-containers --force-rebuild
  

  This should create the cerc/tmkms docker image locally

Create a deployment

• Create a spec file for the deployment:

  laconic-so --stack ~/cerc/tmkms-stack/stack-orchestrator/stacks/tmkms deploy init --output tmkms-spec.yml
  

• Create deployment from the spec file:

  laconic-so --stack ~/cerc/tmkms-stack/stack-orchestrator/stacks/tmkms deploy create --spec-file tmkms-spec.yml --deployment-dir tmkms-deployment
  

Configuration

• Copy the private validator key to the tmp directory:

  cp <path/to/priv_validator_key.json> tmkms-deployment/data/tmkms-data/tmp
  

• Inside the tmkms-deployment deployment directory, open config.env file and set following env variables:

  # Chain ID
  CERC_CHAIN_ID=
  
  # Public IP address of the node
  NODE_IP=
  
  # Port on which the node is listening for consensus messages (default: 26659)
  NODE_PORT=
  
  # Key prefix (for ex. laconic)
  CERC_KEY_PREFIX=
  

Run

• Start the deployment:

  laconic-so --dir tmkms-deployment start
  

• Check the logs:

  laconic-so --dir tmkms-deployment logs -f