testnet-laconicd-stack/testnet-nitro-node.md

testnet-nitro-node

Prerequisites

• laconic-so: see installation

• Ansible: see installation

• Check versions to verify installation:

  laconic-so version
  
  ansible --version
  

Setup

• Clone the cerc-io/testnet-ops repository:

  git clone git@git.vdb.to:cerc-io/testnet-ops.git
  
  cd testnet-ops/nitro-node-setup
  

• Fetch the required Nitro node config:

  wget -O nitro-vars.yml https://git.vdb.to/cerc-io/testnet-laconicd-stack/raw/branch/main/ops/stage2/nitro-node-config.yml
  

• TODO: Get Laconic tokens on your address

• Edit nitro-vars.yml and fill in the following values:

  # L1 WS endpoint
  l1_nitro_chain_url: ""
  
  # Private key for your Nitro address
  nitro_sc_pk: ""
  
  # Private key for a funded account on L1
  # This account should have Laconic tokens for funding your Nitro channels
  nitro_chain_pk: ""
  
  # Multiaddr with publically accessible IP address / DNS for your nitro node
  # Example: "/ip4/192.168.x.y/tcp/3009"
  # Example: "/dns4/example.com/tcp/3009"
  nitro_node_multiaddr: ""
  

• Update the target dir in setup-vars.yml:

  # Set path to desired deployments dir
  DEPLOYMENTS_DIR=<path-to-deployments-dir>
  
  sed -i "s|^nitro_directory:.*|nitro_directory: $DEPLOYMENTS_DIR/nitro-node|" setup-vars.yml
  
  # Will create deployments at $DEPLOYMENTS_DIR/nitro-node/l1-nitro-deployment and $DEPLOYMENTS_DIR/nitro-node/l2-nitro-deployment
  

Run

• Setup and run a Nitro node (L1+L2) by executing the run-nitro-node.yml Ansible playbook:

  LANG=en_US.utf8 ansible-playbook -i localhost, --connection=local run-nitro-node.yml --extra-vars='{ "target_host": "localhost"}' --user $USER
  

  • For skipping container build, run with "skip_container_build" : true:

    LANG=en_US.utf8 ansible-playbook -i localhost, --connection=local run-nitro-node.yml --extra-vars='{ "target_host": "localhost", "skip_container_build": true }' --user $USER
    

Clean up

• Switch to deployments dir:

  cd $DEPLOYMENTS_DIR/nitro-node
  

• Stop all Nitro services running in the background:

  laconic-so deployment --dir l1-nitro-deployment stop
  laconic-so deployment --dir l2-nitro-deployment stop
  

• To stop all services and also delete data:

  laconic-so deployment --dir l1-nitro-deployment stop --delete-volumes
  laconic-so deployment --dir l2-nitro-deployment stop --delete-volumes
  
  # Remove deployment directories (deployments will have to be recreated for a re-run)
  sudo rm -r l1-nitro-deployment
  sudo rm -r l2-nitro-deployment