testnet-laconicd-stack/ops/stage0-to-stage1.md

4.6 KiB

Halt stage0 and start stage1

Once all the participants have completed their onboarding, stage0 laconicd chain can be halted and stage1 chain can be initialized and started

Login

  • Log in as dev user on the deployments VM

  • All the deployments are placed in the /srv directory:

    cd /srv
    

Halt stage0

  • Confirm the the currently running node is for stage0 chain:

    cd /srv/laconicd
    
    laconic-so deployment --dir stage0-deployment logs laconicd -f --tail 30
    
  • Stop the stage0 deployment:

    laconic-so deployment --dir stage0-deployment stop
    

Start stage1

  • Rebuild laconicd container with >=v0.1.7 to enable slashing module:

    # laconicd source
    cd ~/cerc/laconicd
    
    # Pull latest changes
    git pull
    
    # Confirm the latest commit hash
    git log
    
    # Rebuild the containers
    cd /srv/laconicd
    
    laconic-so --stack ~/cerc/fixturenet-laconicd-stack/stack-orchestrator/stacks/fixturenet-laconicd build-containers --force-rebuild
    
  • Fetch the generated genesis file with stage1 participants and token allocations:

    # Place in stage1 deployment directory
    wget -P /srv/laconicd/stage1-deployment/data/genesis-config/genesis.json https://git.vdb.to/cerc-io/testnet-laconicd-stack/raw/branch/main/ops/stage1/genesis.json
    
  • Start the stage1 deployment:

    laconic-so deployment --dir stage1-deployment start
    
  • Check status of stage1 laconicd:

    # List down the container and check health status
    docker ps -a | grep laconicd
    
    # Follow logs for laconicd container, check that new blocks are getting created
    laconic-so deployment --dir stage1-deployment logs laconicd -f
    
  • Query the list of registered participants in stage1 laconicd:

    laconic-so deployment --dir stage1-deployment exec laconicd "laconicd query onboarding list"
    
    # Confirm that all onboarded participants on stage0 appear in the list
    
  • Get the node's peer adddress and stage1 genesis file to share with the participants:

    • Get the node id:

      echo $(laconic-so deployment --dir stage1-deployment exec laconicd "laconicd cometbft show-node-id")@laconicd.laconic.com:26656
      
    • Get the genesis file:

      scp dev@<deployments-server-hostname>:/srv/laconicd/stage1-deployment/data/laconicd-data/config/genesis.json </path/to/local/directory>
      
  • Now users can follow the steps to Join as a validator on stage1

Bank Transfer

  • Transfer tokens to an address:

    cd /srv/laconicd
    
    RECEIVER_ADDRESS=
    AMOUNT=
    
    laconic-so deployment --dir stage1-deployment exec laconicd "laconicd tx bank send alice ${RECEIVER_ADDRESS} ${AMOUNT}alnt --from alice --fees 1000000alnt"
    
  • Check balance:

    laconic-so deployment --dir stage1-deployment exec laconicd "laconicd query bank balances ${RECEIVER_ADDRESS}"
    

Generating stage1 genesis

  • Following steps to be run on a local machine

  • Clone repos:

    git clone git@git.vdb.to:cerc-io/testnet-laconicd-stack.git
    
    git clone git@git.vdb.to:cerc-io/fixturenet-laconicd-stack.git
    
  • Create stage1 participants and allocations using provided validators list:

    • Prerequisite: validators.csv file with list of laconic addresses, example:

      laconic13ftz0c6cg6ttfda7ct4r6pf2j976zsey7l4wmj
      laconic1he4wjpfm5atwfvqurpg57ctp8chmxt9swf02dx
      laconic1wpsdkwz0t4ejdm7gcl7kn8989z88dd6wwy04np
      ...
      
    • Build

      # Change to scripts dir
      cd testnet-laconicd-stack/scripts
      
      # Install dependencies and build
      yarn && yarn build
      
    • Run script

      yarn participants-with-filtered-validators --validators-csv ./validators.csv --participant-alloc 200000000000 --validator-alloc 1000200000000000 --output stage1-participants-$(date +"%Y-%m-%dT%H%M%S").json --output-allocs stage1-allocs-$(date +"%Y-%m-%dT%H%M%S").json
      
      # This should create two json files with stage1 participants and allocations
      
  • Create stage1 genesis file:

    # Change to fixturenet-laconicd stack dir
    cd fixturenet-laconicd-stack/stack-orchestrator/stacks/fixturenet-laconicd
    
    # Generate genesis file
    # Provide absolute paths to generated stage1-participants and stage1-allocs files
    ./scripts/generate-stage1-genesis-from-json.sh /path/to/stage1-participants-2024-08-19T122342.json /path/to/stage1-allocs-2024-08-19T122342.json
    
    # This should generate the required genesis file at output/genesis.json