docs/demo.md

@@ -9,7 +9,7 @@
     ```bash
     cargo install tmkms --features=softsign --version=0.14.0
     ```
-- Install `zstd` using `sudo apt install zstd`
+- Install `zstd` using `sudo apt install zstd` (Linux) or `brew install zstd` (macOS)
 - testnet-state.zst ([exported testnet state](./run-first-validator.md#export-testnet-state))
 - LPS distribution Google spreadsheet URL or CSV file path
 
@@ -20,7 +20,7 @@
 - Fetch stack:
 
   ```bash
-  laconic-so fetch-stack git.vdb.to/cerc-io/laconicd-stack --git-ssh --pull
+  laconic-so fetch-stack git.vdb.to/cerc-io/laconicd-stack --pull
   ```
 
 - Generate LPS lockup distribution JSON file

docs/export-testnet.md

@@ -4,7 +4,7 @@
 
 - Machine where the SAPO testnet validator node is already running
 
-  - Install `zstd` using `sudo apt install zstd`
+  - Install `zstd` using `sudo apt install zstd` (Linux) or `brew install zstd` (macOS)
 
   - [laconic-so](https://github.com/cerc-io/stack-orchestrator/?tab=readme-ov-file#install)
 

docs/run-first-validator.md

@@ -10,7 +10,7 @@
 
 - Machine 3: Where the genesis file is to be generated
 
-  - Install `zstd` using `sudo apt install zstd`
+  - Install `zstd` using `sudo apt install zstd` (Linux) or `brew install zstd` (macOS)
 
   - [LSP distribution JSON](./export-testnet.md#prepare-lps-distribution-json)
 
@@ -25,7 +25,7 @@
   - laconicd-stack
 
     ```bash
-    laconic-so fetch-stack git.vdb.to/cerc-io/laconicd-stack --git-ssh --pull
+    laconic-so fetch-stack git.vdb.to/cerc-io/laconicd-stack --pull
     ```
 
 ## Build laconicd to generate genesis file

docs/run-validator.md

@@ -7,7 +7,7 @@
 - To fetch laconicd-stack:
 
   ```bash
-  laconic-so fetch-stack git.vdb.to/cerc-io/laconicd-stack --git-ssh --pull
+  laconic-so fetch-stack git.vdb.to/cerc-io/laconicd-stack --pull
   ```
 
 - Machine 1: Where your SAPO testnet node is already running
@@ -18,7 +18,7 @@
 
   - [ansible](playbooks/README.md#ansible-installation)
 
-  - Install `zstd` using `sudo apt install zstd`
+  - Install `zstd` using `sudo apt install zstd` (Linux) or `brew install zstd` (macOS)
 
 - Machine 3: Where the create-validator transaction is to be signed
 
@@ -32,7 +32,6 @@
 
   - [ansible](playbooks/README.md#ansible-installation)
 
-
 ## Stop SAPO testnet node
 
 - Run the following steps in machine where your SAPO testnet validator node is already running (machine 1)
@@ -209,6 +208,15 @@
 
   NOTE: This public key is required in next step to create validator
 
+- Check sync status of node:
+
+  ```bash
+  # Check sync status
+  laconic-so deployment --dir $DATA_DIRECTORY/$MAINNET_DEPLOYMENT_DIR exec laconicd "laconicd status | jq .sync_info"
+
+  # `catching_up: false` indicates that node is completely synced
+  ```
+
 ## Create Validator
 
 - Run these steps in a machine from where [the create-validator transaction is to be signed (machine 3)](#build-laconicd-to-create-validator)
@@ -243,6 +251,8 @@
 
 - Run ansible playbook to create a validator in the running chain:
 
+  NOTE: Make sure that your node has completed syncing before running the playbook
+
   ```bash
   ansible-playbook -i localhost, -c local ~/cerc/laconicd-stack/playbooks/validator/create-validator.yml
   ```

docs/update-deployments.md

@@ -260,7 +260,7 @@ Instructions to reset / update the deployments
 * If code has changed, fetch and build with updated source code:
 
   ```bash
-  laconic-so --stack ~/cerc/snowballtools-base-api-stack/stack-orchestrator/stacks/snowballtools-base-backend setup-repositories --git-ssh --pull
+  laconic-so --stack ~/cerc/snowballtools-base-api-stack/stack-orchestrator/stacks/snowballtools-base-backend setup-repositories --pull
 
   # rebuild containers
   laconic-so --stack ~/cerc/snowballtools-base-api-stack/stack-orchestrator/stacks/snowballtools-base-backend build-containers --force-rebuild

playbooks/cosmos-multisig-app/README.md

@@ -15,7 +15,7 @@ This playbook sets up the Cosmos Multisig application for managing multisig wall
 - Fetch the stack:
 
   ```bash
-  laconic-so fetch-stack git.vdb.to/cerc-io/laconicd-stack --git-ssh --pull
+  laconic-so fetch-stack git.vdb.to/cerc-io/laconicd-stack --pull
   ```
 
 - Copy the example variables file:

playbooks/cosmos-multisig-app/cosmos-multisig-app-start.yml

@@ -25,7 +25,7 @@
 
     - name: Clone cosmos-multisig-ui repo
       shell: |
-        laconic-so fetch-stack git.vdb.to/cerc-io/cosmos-multisig-ui@v0.1.2 --git-ssh --pull
+        laconic-so fetch-stack git.vdb.to/cerc-io/cosmos-multisig-ui@v0.1.2 --pull
 
     - name: Build container image
       shell: |

playbooks/first-validator/setup-first-validator.yml

@@ -24,7 +24,7 @@
     - name: Setup required repositories
       shell: >
         laconic-so --stack ~/cerc/laconicd-stack/stack-orchestrator/stacks/mainnet-laconicd
-        setup-repositories --git-ssh --pull
+        setup-repositories --pull
 
     - name: Build container images
       shell: |

playbooks/setup.yml

@@ -11,9 +11,14 @@
     path: "{{ ansible_env.HOME }}/.laconic-tools/yq"
   register: yq_file
 
+- name: Detect OS and architecture
+  set_fact:
+    yq_os: "{{ 'darwin' if ansible_system == 'Darwin' else 'linux' }}"
+    yq_arch: "{{ ansible_architecture | regex_replace('x86_64', 'amd64') | regex_replace('aarch64', 'arm64') }}"
+
 - name: Download yq to user's tools directory
   shell: |
-    curl -L https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64 -o {{ ansible_env.HOME }}/.laconic-tools/yq
+    curl -L https://github.com/mikefarah/yq/releases/latest/download/yq_{{ yq_os }}_{{ yq_arch }} -o {{ ansible_env.HOME }}/.laconic-tools/yq
     chmod +x {{ ansible_env.HOME }}/.laconic-tools/yq
   when: not yq_file.stat.exists
   args:

playbooks/tmkms/setup-tmkms.yml

@@ -17,7 +17,7 @@
 
     - name: Fetch tmkms stack
       shell: |
-        laconic-so fetch-stack git.vdb.to/LaconicNetwork/tmkms-stack --git-ssh --pull
+        laconic-so fetch-stack git.vdb.to/LaconicNetwork/tmkms-stack --pull
 
     - name: Build tmkms container images
       shell: |

playbooks/validator/build-laconicd.yml

@@ -8,7 +8,7 @@
     - name: Setup required repositories
       shell: >
         laconic-so --stack ~/cerc/laconicd-stack/stack-orchestrator/stacks/mainnet-laconicd
-        setup-repositories --git-ssh --pull
+        setup-repositories --pull
 
     - name: Build container images
       shell: |

playbooks/validator/create-validator.yml

@@ -48,17 +48,31 @@
       when: private_key_input.user_input | default('') | trim == ''
 
     - name: Run create-validator script
-      shell: |
+      command:
-        docker run -i \
+        argv:
-          -v {{create_validator_dir}}:/root/create-validator \
+          - docker
-          -v ~/cerc/laconicd-stack/stack-orchestrator/config/mainnet-laconicd/create-validator.sh:/scripts/create-validator.sh \
+          - run
-          -e "KEY_NAME={{ key_name }}" \
+          - -i
-          -e "NODE_URL={{ node_url }}" \
+          - -v
-          -e "CERC_MONIKER={{ cerc_moniker }}" \
+          - "{{create_validator_dir}}:/root/create-validator"
-          -e "CERC_CHAIN_ID={{ cerc_chain_id }}" \
+          - -v
-          -e "MIN_GAS_PRICE={{ min_gas_price }}" \
+          - "{{ ansible_env.HOME }}/cerc/laconicd-stack/stack-orchestrator/config/mainnet-laconicd/create-validator.sh:/scripts/create-validator.sh"
-          -e "VALIDATOR_PUB_KEY={{ validator_pub_key | to_json }}" \
+          - -e
-          -e "PVT_KEY={{ private_key_input.user_input }}" \
+          - "KEY_NAME={{ key_name }}"
-          --network=host \
+          - -e
-          cerc/laconicd:local \
+          - "NODE_URL={{ node_url }}"
-          sh -c "/scripts/create-validator.sh"
+          - -e
+          - "CERC_MONIKER={{ cerc_moniker }}"
+          - -e
+          - "CERC_CHAIN_ID={{ cerc_chain_id }}"
+          - -e
+          - "MIN_GAS_PRICE={{ min_gas_price }}"
+          - -e
+          - "VALIDATOR_PUB_KEY={{ validator_pub_key }}"
+          - -e
+          - "PVT_KEY={{ private_key_input.user_input }}"
+          - --network=host
+          - cerc/laconicd:local
+          - sh
+          - -c
+          - "/scripts/create-validator.sh"

playbooks/validator/setup-validator.yml

@@ -31,7 +31,7 @@
     - name: Setup required repositories
       shell: >
         laconic-so --stack ~/cerc/laconicd-stack/stack-orchestrator/stacks/mainnet-laconicd
-        setup-repositories --git-ssh --pull
+        setup-repositories --pull
 
     - name: Build container images
       shell: |
@@ -94,10 +94,20 @@
 
     - name: Initialize laconicd node
       when: not BUILD_ONLY
-      shell: |
+      command:
-        docker run -i \
+        argv:
-          -v {{data_directory}}/{{ mainnet_deployment_dir }}/data/laconicd-data:/root/.laconicd \
+          - docker
-          -v {{data_directory}}/{{ mainnet_deployment_dir }}/config/mainnet-laconicd:/scripts \
+          - run
-          -e "CERC_MONIKER={{ cerc_moniker }}" \
+          - -i
-          -e "CERC_CHAIN_ID={{ cerc_chain_id }}" \
+          - -v
-          cerc/laconicd:local bash -c "/scripts/setup-laconicd.sh"
+          - "{{data_directory}}/{{ mainnet_deployment_dir }}/data/laconicd-data:/root/.laconicd"
+          - -v
+          - "{{data_directory}}/{{ mainnet_deployment_dir }}/config/mainnet-laconicd:/scripts"
+          - -e
+          - "CERC_MONIKER={{ cerc_moniker }}"
+          - -e
+          - "CERC_CHAIN_ID={{ cerc_chain_id }}"
+          - cerc/laconicd:local
+          - bash
+          - -c
+          - "/scripts/setup-laconicd.sh"