Use alnt token in bond creation example

Part of [laconicd testnet validator enrollment](#19)

Reviewed-on: #20
Co-authored-by: Nabarun <nabarun@deepstacksoft.com>
Co-committed-by: Nabarun <nabarun@deepstacksoft.com>

.gitignore

@@ -0,0 +1,6 @@
+venv
+laconic_testnet.egg-info
+__pycache__
+
+*-deployment
+*-spec.yml

README.md

@@ -1 +1,17 @@
 # testnet-laconicd-stack
+
+Stacks to run a node for laconic testnet
+
+- [testnet-laconicd stack documentation](stack-orchestrator/stacks/testnet-laconicd/README.md)
+- [laconic-console stack documentation](stack-orchestrator/stacks/laconic-console/README.md) (to run laconic registry CLI and console standalone)
+- [laconic-faucet stack documentation](stack-orchestrator/stacks/laconic-faucet/README.md)
+
+## ops
+
+- [Update deployments after code changes](./ops/update-deployments.md)
+- [Halt stage0 and start stage1](./ops/stage0-to-stage1.md)
+- [Create deployments from scratch (for reference only)](./ops/deployments-from-scratch.md)
+
+## Join LORO testnet
+
+Follow steps in [testnet-onboarding-validator.md](./testnet-onboarding-validator.md) to onboard your participant and join as a validator on the LORO testnet

cli/README.md

@@ -0,0 +1,32 @@
+# cli
+
+## Setup
+
+* Run commands in repo root directory
+  ```bash
+  python3 -m venv venv
+  source ./venv/bin/activate
+  ```
+
+* Install CLI in editable mode
+  ```bash
+  pip install --editable .
+  ```
+
+* Verify installation
+  ```bash
+  laconic-testnet --help
+  ```
+
+## Usage
+
+```bash
+laconic-testnet --onboarded-json path/to/onboarded-accounts.json --subscribers-csv path/to/subscribers.csv --output path/to/subscribed-onboarded-accounts.csv
+```
+
+## Cleanup
+
+Deactivate virtual environment
+```bash
+deactivate
+```

cli/cli.py

@@ -0,0 +1,15 @@
+import click
+from .core import process_subscribers
+
+@click.command()
+@click.option('--onboarded-json', required=True, type=click.Path(exists=True), help='Path to onboarded accounts JSON file.')
+@click.option('--subscribers-csv', required=True, type=click.Path(exists=True), help='Path to the subscribers CSV file.')
+@click.option('--output', required=True, type=click.Path(), help='Path to the output CSV file.')
+def main(onboarded_json, subscribers_csv, output):
+    """
+    CLI tool to match subscriber data with participant data and generate a CSV.
+    """
+    process_subscribers(onboarded_json, subscribers_csv, output)
+
+if __name__ == "__main__":
+    main()

cli/core.py

@@ -0,0 +1,50 @@
+import csv
+import hashlib
+import json
+
+def hash_subscriber_id(subscriber_id):
+    return '0x' + hashlib.sha256(subscriber_id.encode()).hexdigest()
+
+def process_subscribers(onboarded_json, subscribers_csv, output):
+    # Load JSON data from the file
+    with open(onboarded_json, 'r') as json_file:
+        json_data = json.load(json_file)
+
+    # Create a dictionary mapping kyc_id to participant data
+    kyc_map = {participant['kyc_id']: participant for participant in json_data['participants']}
+
+    # Load subscribers data from the CSV file and process it using map
+    with open(subscribers_csv, 'r') as csv_file:
+        csv_reader = csv.DictReader(csv_file)
+        subscribers = list(csv_reader)
+
+    # Use map to process subscribers
+    def process_subscriber(subscriber):
+        hashed_subscriber_id = hash_subscriber_id(subscriber['subscriber_id'])
+        participant = kyc_map.get(hashed_subscriber_id)
+
+        if participant:
+            return {
+                'subscriber_id': subscriber['subscriber_id'],
+                'email': subscriber['email'],
+                'cosmos_address': participant['cosmos_address'],
+                'nitro_address': participant['nitro_address'],
+                'role': participant['role'],
+                'hashed_subscriber_id': participant['kyc_id'],
+                'status': subscriber['status'],
+                'premium': subscriber['premium?'],
+                'created_at': subscriber['created_at']
+            }
+        return None
+
+    # Apply the map function and filter out None values
+    output_data = list(filter(None, map(process_subscriber, subscribers)))
+
+    # Write the matched data to a new CSV file
+    with open(output, 'w', newline='') as csv_file:
+        fieldnames = ['subscriber_id', 'email', 'cosmos_address', 'nitro_address', 'role', 'hashed_subscriber_id', 'status', 'premium', 'created_at']
+        csv_writer = csv.DictWriter(csv_file, fieldnames=fieldnames)
+        csv_writer.writeheader()
+        csv_writer.writerows(output_data)
+
+    print(f'Data has been written to {output}')

ops/deployments-from-scratch.md

@@ -0,0 +1,678 @@
+# Create deployments from scratch (for reference only)
+
+## Login
+
+* Log in as `dev` user on the deployments VM
+
+* All the deployments are placed in the `/srv` directory:
+
+  ```bash
+  cd /srv
+  ```
+
+<details open>
+  <summary>stage0 laconicd</summary>
+
+## stage0 laconicd
+
+* Stack: <https://git.vdb.to/cerc-io/fixturenet-laconicd-stack/src/branch/main/stack-orchestrator/stacks/fixturenet-laconicd>
+
+* Source repo: <https://git.vdb.to/cerc-io/laconicd>
+
+* Target dir: `/srv/laconicd/stage0-deployment`
+
+* Cleanup an existing deployment if required:
+
+  ```bash
+  cd /srv/laconicd
+
+  # Stop the deployment
+  laconic-so deployment --dir stage0-deployment stop --delete-volumes
+
+  # Remove the deployment dir
+  sudo rm -rf stage0-deployment
+
+  # Remove the existing spec file
+  rm stage0-spec.yml
+  ```
+
+### Setup
+
+* Clone the stack repo:
+
+  ```bash
+  laconic-so fetch-stack git.vdb.to/cerc-io/fixturenet-laconicd-stack --pull
+
+  # This should clone the fixturenet-laconicd-stack repo at `/home/dev/cerc/fixturenet-laconicd-stack`
+  ```
+
+* Clone required repositories:
+
+  ```bash
+  laconic-so --stack ~/cerc/fixturenet-laconicd-stack/stack-orchestrator/stacks/fixturenet-laconicd setup-repositories --pull
+
+  # This should clone the laconicd repo at `/home/dev/cerc/laconicd`
+  ```
+
+* Build the container images:
+
+  ```bash
+  laconic-so --stack ~/cerc/fixturenet-laconicd-stack/stack-orchestrator/stacks/fixturenet-laconicd build-containers --force-rebuild
+
+  # This should create the "cerc/laconicd" Docker image
+  ```
+
+### Deployment
+
+* Create a spec file for the deployment:
+
+  ```bash
+  cd /srv/laconicd
+
+  laconic-so --stack ~/cerc/fixturenet-laconicd-stack/stack-orchestrator/stacks/fixturenet-laconicd deploy init --output stage0-spec.yml
+  ```
+
+* Edit network in the spec file to map container ports to host ports:
+
+  ```bash
+  # stage0-spec.yml
+  network:
+    ports:
+      laconicd:
+        - '6060'
+        - '127.0.0.1:26657:26657'
+        - '26656'
+        - '127.0.0.1:9473:9473'
+        - '127.0.0.1:9090:9090'
+        - '127.0.0.1:1317:1317'
+  ```
+
+* Create a deployment from the spec file:
+
+  ```bash
+  laconic-so --stack ~/cerc/fixturenet-laconicd-stack/stack-orchestrator/stacks/fixturenet-laconicd deploy create --spec-file stage0-spec.yml --deployment-dir stage0-deployment
+  ```
+
+* Update the configuration:
+
+  ```bash
+  cat <<EOF > stage0-deployment/config.env
+  # Set to true to enable adding participants functionality of the onboarding module
+  ONBOARDING_ENABLED=true
+
+  # A custom human readable name for this node
+  MONIKER=LaconicStage0
+  EOF
+  ```
+
+### Start
+
+* Start the deployment:
+
+  ```bash
+  laconic-so deployment --dir stage0-deployment start
+  ```
+
+* Check status:
+
+  ```bash
+  # List down the containers 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 stage0-deployment logs laconicd -f
+  ```
+
+* Verify that endpoint is now publicly accessible:
+
+  * <https://laconicd.laconic.com> is pointed to the node's RPC endpoint
+
+  * Check status query:
+
+    ```bash
+    curl https://laconicd.laconic.com/status | jq
+
+    # Expected output:
+    # JSON with `node_info`, `sync_info` and `validator_info`
+    ```
+
+</details>
+
+<details open>
+  <summary>faucet</summary>
+
+## faucet
+
+* Stack: <https://git.vdb.to/cerc-io/testnet-laconicd-stack/src/branch/main/stack-orchestrator/stacks/laconic-faucet>
+
+* Source repo: <https://git.vdb.to/cerc-io/laconic-faucet>
+
+* Target dir: `/srv/faucet/laconic-faucet-deployment`
+
+* Cleanup an existing deployment if required:
+
+  ```bash
+  cd /srv/faucet
+
+  # Stop the deployment
+  laconic-so deployment --dir laconic-faucet-deployment stop
+
+  # Remove the deployment dir
+  sudo rm -rf laconic-faucet-deployment
+
+  # Remove the existing spec file
+  rm laconic-faucet-spec.yml
+  ```
+
+### Setup
+
+* Clone the stack repo:
+
+  ```bash
+  laconic-so fetch-stack git.vdb.to/cerc-io/testnet-laconicd-stack --pull
+
+  # This should clone the testnet-laconicd-stack repo at `/home/dev/cerc/testnet-laconicd-stack`
+  ```
+
+* Clone required repositories:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-faucet setup-repositories --pull
+
+  # This should clone the laconicd repo at `/home/dev/cerc/laconic-faucet
+  ```
+
+* Build the container images:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-faucet build-containers --force-rebuild
+
+  # This should create the "cerc/laconic-faucet" Docker image
+  ```
+
+### Deployment
+
+* Create a spec file for the deployment:
+
+  ```bash
+  cd /srv/faucet
+
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-faucet deploy init --output laconic-faucet-spec.yml
+  ```
+
+* Edit network in the spec file to map container ports to host ports:
+
+  ```bash
+  # laconic-faucet-spec.yml
+  network:
+    ports:
+      faucet:
+        - '127.0.0.1:4000:3000'
+  ```
+
+* Create a deployment from the spec file:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-faucet deploy create --spec-file laconic-faucet-spec.yml --deployment-dir laconic-faucet-deployment
+
+  # Place in the same namespace as stage0
+  cp /srv/laconicd/stage0-deployment/deployment.yml laconic-faucet-deployment/deployment.yml
+  ```
+
+* Update the configuration:
+
+  ```bash
+  # Get the faucet account key from stage0 deployment
+  export FAUCET_ACCOUNT_PK=$(laconic-so deployment --dir /srv/laconicd/stage0-deployment exec laconicd "echo y | laconicd keys export alice --keyring-backend test --unarmored-hex --unsafe")
+
+  cat <<EOF > laconic-faucet-deployment/config.env
+  CERC_FAUCET_KEY=$FAUCET_ACCOUNT_PK
+  EOF
+  ```
+
+### Start
+
+* Start the deployment:
+
+  ```bash
+  laconic-so deployment --dir laconic-faucet-deployment start
+  ```
+
+* Check status:
+
+  ```bash
+  # List down the containers and check health status
+  docker ps -a | grep faucet
+
+  # Check logs for faucet container
+  laconic-so deployment --dir laconic-faucet-deployment logs faucet -f
+  ```
+
+* Verify that endpoint is now publicly accessible:
+
+  * <https://faucet.laconic.com> is pointed to the faucet endpoint
+
+  * Check faucet:
+
+    ```bash
+    curl -X POST https://faucet.laconic.com/faucet
+
+    # Expected output:
+    # {"error":"address is required"}
+    ```
+
+</details>
+
+<details open>
+  <summary>testnet-onboarding-app</summary>
+
+## testnet-onboarding-app
+
+* Stack: <https://git.vdb.to/cerc-io/testnet-onboarding-app-stack/src/branch/main/stack-orchestrator/stacks/onboarding-app>
+
+* Source repo: <https://git.vdb.to/cerc-io/testnet-onboarding-app>
+
+* Target dir: `/srv/app/onboarding-app-deployment`
+
+* Cleanup an existing deployment if required:
+
+  ```bash
+  cd /srv/app
+
+  # Stop the deployment
+  laconic-so deployment --dir onboarding-app-deployment
+
+  # Remove the deployment dir
+  sudo rm -rf onboarding-app-deployment
+
+  # Remove the existing spec file
+  rm onboarding-app-spec.yml
+  ```
+
+### Setup
+
+* Clone the stack repo:
+
+  ```bash
+  laconic-so fetch-stack git.vdb.to/cerc-io/testnet-onboarding-app-stack --pull
+
+  # This should clone the testnet-onboarding-app-stack repo at `/home/dev/cerc/testnet-onboarding-app-stack`
+  ```
+
+* Clone required repositories:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-onboarding-app-stack/stack-orchestrator/stacks/onboarding-app setup-repositories --pull
+
+  # This should clone the testnet-onboarding-app repo at `/home/dev/cerc/testnet-onboarding-app`
+  ```
+
+* Build the container images:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-onboarding-app-stack/stack-orchestrator/stacks/onboarding-app build-containers --force-rebuild
+
+  # This should create the Docker image "cerc/testnet-onboarding-app" locally
+  ```
+
+### Deployment
+
+* Create a spec file for the deployment:
+
+  ```bash
+  cd /srv/app
+
+  laconic-so --stack ~/cerc/testnet-onboarding-app-stack/stack-orchestrator/stacks/onboarding-app deploy init --output onboarding-app-spec.yml
+  ```
+
+* Edit network in the spec file to map container ports to host ports:
+
+  ```bash
+  network:
+    ports:
+      testnet-onboarding-app:
+        - '127.0.0.1:3000:80'
+  ```
+
+* Create a deployment from the spec file:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-onboarding-app-stack/stack-orchestrator/stacks/onboarding-app deploy create --spec-file onboarding-app-spec.yml --deployment-dir onboarding-app-deployment
+  ```
+
+* Update the configuration:
+
+  ```bash
+  cat <<EOF > onboarding-app-deployment/config.env
+  WALLET_CONNECT_ID=63...
+
+  CERC_REGISTRY_GQL_ENDPOINT="https://laconicd.laconic.com/api"
+  CERC_LACONICD_RPC_ENDPOINT="https://laconicd.laconic.com"
+
+  CERC_FAUCET_ENDPOINT="https://faucet.laconic.com"
+
+  CERC_WALLET_META_URL="https://loro-signup.laconic.com"
+  EOF
+  ```
+
+### Start
+
+* Start the deployment:
+
+  ```bash
+  laconic-so deployment --dir onboarding-app-deployment start
+  ```
+
+* Check status:
+
+  ```bash
+  # List down the container
+  docker ps -a | grep testnet-onboarding-app
+
+  # Follow logs for testnet-onboarding-app container, wait for the build to finish
+  laconic-so deployment --dir onboarding-app-deployment logs testnet-onboarding-app -f
+  ```
+
+* The onboarding app can now be viewed at <https://loro-signup.laconic.com>
+
+</details>
+
+<details open>
+  <summary>laconic-wallet-web</summary>
+
+## laconic-wallet-web
+
+* Stack: <https://git.vdb.to/cerc-io/laconic-wallet-web/src/branch/main/stack/stack-orchestrator/stack/laconic-wallet-web>
+
+* Source repo: <https://git.vdb.to/cerc-io/laconic-wallet-web>
+
+* Target dir: `/srv/wallet/laconic-wallet-web-deployment`
+
+* Cleanup an existing deployment if required:
+
+  ```bash
+  cd /srv/wallet
+
+  # Stop the deployment
+  laconic-so deployment --dir laconic-wallet-web-deployment
+
+  # Remove the deployment dir
+  sudo rm -rf laconic-wallet-web-deployment
+
+  # Remove the existing spec file
+  rm laconic-wallet-web-spec.yml
+  ```
+
+### Setup
+
+* Clone the stack repo:
+
+  ```bash
+  laconic-so fetch-stack git.vdb.to/cerc-io/laconic-wallet-web --pull
+
+  # This should clone the laconic-wallet-web repo at `/home/dev/cerc/laconic-wallet-web`
+  ```
+
+* Build the container images:
+
+  ```bash
+  laconic-so --stack ~/cerc/laconic-wallet-web/stack/stack-orchestrator/stack/laconic-wallet-web build-containers --force-rebuild
+
+  # This should create the Docker image "cerc/laconic-wallet-web" locally
+  ```
+
+### Deployment
+
+* Create a spec file for the deployment:
+
+  ```bash
+  cd /srv/wallet
+
+  laconic-so --stack ~/cerc/laconic-wallet-web/stack/stack-orchestrator/stack/laconic-wallet-web deploy init --output laconic-wallet-web-spec.yml
+  ```
+
+* Edit network in the spec file to map container ports to host ports:
+
+  ```bash
+  network:
+    ports:
+      laconic-wallet-web:
+        - '127.0.0.1:5000:80'
+  ```
+
+* Create a deployment from the spec file:
+
+  ```bash
+  laconic-so --stack ~/cerc/laconic-wallet-web/stack/stack-orchestrator/stack/laconic-wallet-web deploy create --spec-file laconic-wallet-web-spec.yml --deployment-dir laconic-wallet-web-deployment
+  ```
+
+* Update the configuration:
+
+  ```bash
+  cat <<EOF > laconic-wallet-web-deployment/config.env
+  WALLET_CONNECT_ID=63...
+  EOF
+  ```
+
+### Start
+
+* Start the deployment:
+
+  ```bash
+  laconic-so deployment --dir laconic-wallet-web-deployment start
+  ```
+
+* Check status:
+
+  ```bash
+  # List down the container
+  docker ps -a | grep laconic-wallet-web
+
+  # Follow logs for laconic-wallet-web container, wait for the build to finish
+  laconic-so deployment --dir laconic-wallet-web-deployment logs laconic-wallet-web -f
+  ```
+
+* The web wallet can now be viewed at <https://wallet.laconic.com>
+
+</details>
+
+<details open>
+  <summary>stage1 laconicd</summary>
+
+## stage1 laconicd
+
+* Stack: <https://git.vdb.to/cerc-io/fixturenet-laconicd-stack/src/branch/main/stack-orchestrator/stacks/fixturenet-laconicd>
+
+* Source repo: <https://git.vdb.to/cerc-io/laconicd>
+
+* Target dir: `/srv/laconicd/stage1-deployment`
+
+* Cleanup an existing deployment if required:
+
+  ```bash
+  cd /srv/laconicd
+
+  # Stop the deployment
+  laconic-so deployment --dir stage1-deployment stop --delete-volumes
+
+  # Remove the deployment dir
+  sudo rm -rf stage1-deployment
+
+  # Remove the existing spec file
+  rm stage1-spec.yml
+  ```
+
+### Setup
+
+* Same as that for [stage0 laconicd](#setup), not required if already done for stage0
+
+### Deployment
+
+* Create a spec file for the deployment:
+
+  ```bash
+  cd /srv/laconicd
+
+  laconic-so --stack ~/cerc/fixturenet-laconicd-stack/stack-orchestrator/stacks/fixturenet-laconicd deploy init --output stage1-spec.yml
+  ```
+
+* Edit network in the spec file to map container ports to host ports:
+
+  ```bash
+  # stage1-spec.yml
+  network:
+    ports:
+      laconicd:
+        - '6060'
+        - '127.0.0.1:26657:26657'
+        - '26656:26656'
+        - '127.0.0.1:9473:9473'
+        - '127.0.0.1:9090:9090'
+        - '127.0.0.1:1317:1317'
+  ```
+
+* Create a deployment from the spec file:
+
+  ```bash
+  laconic-so --stack ~/cerc/fixturenet-laconicd-stack/stack-orchestrator/stacks/fixturenet-laconicd deploy create --spec-file stage1-spec.yml --deployment-dir stage1-deployment
+  ```
+
+* Update the configuration:
+
+  ```bash
+  cat <<EOF > stage1-deployment/config.env
+  AUTHORITY_AUCTION_ENABLED=true
+  AUTHORITY_AUCTION_COMMITS_DURATION=3600
+  AUTHORITY_AUCTION_REVEALS_DURATION=3600
+  AUTHORITY_GRACE_PERIOD=7200
+
+  MONIKER=LaconicStage1
+  EOF
+  ```
+
+### Start
+
+* Follow [stage0-to-stage1.md](./stage0-to-stage1.md) to halt stage0 deployment, generate the genesis file for stage1 and start the stage1 deployment
+
+</details>
+
+<details open>
+  <summary>laconic-console</summary>
+
+## laconic-console
+
+* Stack: <https://git.vdb.to/cerc-io/testnet-laconicd-stack/src/branch/main/stack-orchestrator/stacks/laconic-console>
+
+* Source repos:
+  * <https://git.vdb.to/cerc-io/laconic-registry-cli>
+  * <https://git.vdb.to/cerc-io/laconic-console>
+
+* Target dir: `/srv/console/laconic-console-deployment`
+
+* Cleanup an existing deployment if required:
+
+  ```bash
+  cd /srv/console
+
+  # Stop the deployment
+  laconic-so deployment --dir laconic-console-deployment stop --delete-volumes
+
+  # Remove the deployment dir
+  sudo rm -rf laconic-console-deployment
+
+  # Remove the existing spec file
+  rm laconic-console-spec.yml
+  ```
+
+### Setup
+
+* Clone the stack repo:
+
+  ```bash
+  laconic-so fetch-stack git.vdb.to/cerc-io/testnet-laconicd-stack --pull
+
+  # This should clone the testnet-laconicd-stack repo at `/home/dev/cerc/testnet-laconicd-stack`
+  ```
+
+* Clone required repositories:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-console setup-repositories --pull
+
+  # This should clone the laconic-registry-cli repo at `/home/dev/cerc/laconic-registry-cli`, laconic-console repo at `/home/dev/cerc/laconic-console`
+  ```
+
+* Build the container images:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-console build-containers --force-rebuild
+
+  # This should create the Docker images: "cerc/laconic-registry-cli", "cerc/webapp-base", "cerc/laconic-console-host"
+  ```
+
+### Deployment
+
+* Create a spec file for the deployment:
+
+  ```bash
+  cd /srv/console
+
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-console deploy init --output laconic-console-spec.yml
+  ```
+
+* Edit network in the spec file to map container ports to host ports:
+
+  ```bash
+  network:
+    ports:
+      console:
+        - '127.0.0.1:4001:80'
+  ```
+
+* Create a deployment from the spec file:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-console deploy create --spec-file laconic-console-spec.yml --deployment-dir laconic-console-deployment
+  ```
+
+* Update the configuration:
+
+  ```bash
+  cat <<EOF > laconic-console-deployment/config.env
+  # Laconicd (hosted) GQL endpoint
+  LACONIC_HOSTED_ENDPOINT=https://laconicd.laconic.com
+  EOF
+  ```
+
+### Start
+
+* Start the deployment:
+
+  ```bash
+  laconic-so deployment --dir laconic-console-deployment start
+  ```
+
+* Check status:
+
+  ```bash
+  # List down the container
+  docker ps -a | grep console
+
+  # Follow logs for console container
+  laconic-so deployment --dir laconic-console-deployment logs console -f
+  ```
+
+* The laconic console can now be viewed at <https://loro-console.laconic.com>
+
+</details>
+
+## Domains / Port Mappings
+
+```bash
+laconicd.laconic.com        -> 26657
+laconicd.laconic.com/api    -> 9473/api
+faucet.laconic.com          -> 4000
+loro-signup.laconic.com     -> 3000
+wallet.laconic.com          -> 5000
+loro-console.laconic.com    -> 4001
+```

ops/stage0-to-stage1.md

@@ -0,0 +1,110 @@
+# 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:
+
+  ```bash
+  cd /srv
+  ```
+
+## Halt stage0
+
+* Confirm the the currently running node is for stage0 chain:
+
+  ```bash
+  cd /srv/laconicd
+
+  laconic-so deployment --dir stage0-deployment logs laconicd -f --tail 30
+  ```
+
+* List the participants on stage0:
+
+  ```bash
+  laconic-so deployment --dir stage0-deployment exec laconicd "laconicd query onboarding list"
+  ```
+
+* Stop the stage0 deployment:
+
+  ```bash
+  laconic-so deployment --dir stage0-deployment stop
+  ```
+
+## Start stage1
+
+* Use the scripts in fixturenet-laconicd stack to generate genesis file for stage1 using onboarding participants from stage0 chain with token allocations:
+
+  ```bash
+  cd /srv/laconicd
+
+  # Set current working dir path in a variable
+  DEPLOYMENTS_DIR=$(pwd)
+
+  cd ~/cerc/fixturenet-laconicd-stack/stack-orchestrator/stacks/fixturenet-laconicd
+
+  # Generate the genesis file
+  # Participant allocation: 1000000000000 (10^12)
+  # Validator allocation:   2000000000000000 (10^15)
+  ./scripts/generate-stage1-genesis-using-allocations.sh $DEPLOYMENTS_DIR/stage0-deployment 1000000000000 2000000000000000
+
+  # Expected output:
+  # Genesis file for stage1 written to output/genesis.json
+
+  # Remove the temporary data directory
+  sudo rm -rf stage1-genesis
+
+  # Go back to the directory where deployments are created
+  cd $DEPLOYMENTS_DIR
+  ```
+
+* Copy over the generated genesis file (`.json`) containing the onboarding module state with funded participants to data directory in stage1 deployment (`stage1-deployment/data/genesis-config`):
+
+  ```bash
+  cd /srv/laconicd
+
+  cp ~/cerc/fixturenet-laconicd-stack/stack-orchestrator/stacks/fixturenet-laconicd/output/genesis.json stage1-deployment/data/genesis-config/genesis.json
+  ```
+
+* Start the stage1 deployment:
+
+  ```bash
+  laconic-so deployment --dir stage1-deployment start
+  ```
+
+* Check status of stage1 laconicd:
+
+  ```bash
+  # 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:
+
+  ```bash
+  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:
+
+    ```bash
+    echo $(laconic-so deployment --dir stage1-deployment exec laconicd "laconicd cometbft show-node-id")@laconicd.laconic.com:26656
+    ```
+
+  * Get the genesis file:
+
+    ```bash
+    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](https://git.vdb.to/cerc-io/testnet-laconicd-stack/src/branch/main/testnet-onboarding-validator.md#join-as-a-validator-on-stage1)

ops/update-deployments.md

@@ -0,0 +1,256 @@
+# Update deployments after code changes
+
+Instructions to reset / update the deployments
+
+## Login
+
+* Log in as `dev` user on the deployments VM
+
+* All the deployments are placed in the `/srv` directory:
+
+  ```bash
+  cd /srv
+  ```
+
+## stage0 laconicd
+
+* Deployment dir: `/srv/laconicd/stage0-deployment`
+
+* If code has changed, fetch and build with updated source code:
+
+  ```bash
+  # laconicd source
+  cd ~/cerc/laconicd
+
+  # Pull latest changes, or checkout to the required branch
+  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
+  ```
+
+* Optionally, reset the data directory (this will remove all stage0 data!):
+
+  ```bash
+  # Stop the deployment
+  laconic-so deployment --dir stage0-deployment stop --delete-volumes
+
+  # Remove and recreate the required data dir
+  sudo rm -rf stage0-deployment/data/laconicd-data
+  mkdir stage0-deployment/data/laconicd-data
+  ```
+
+* Start the deployment:
+
+  ```bash
+  laconic-so deployment --dir stage0-deployment start
+
+  # Follow logs for laconicd container, check that new blocks are getting created
+  laconic-so deployment --dir stage0-deployment logs laconicd -f
+  ```
+
+* If the stage0 laconicd chain has been reset, reset the faucet deployment too with new faucet key:
+
+  ```bash
+  cd /srv/faucet
+
+  export FAUCET_ACCOUNT_PK=$(laconic-so deployment --dir /srv/laconicd/stage0-deployment exec laconicd "echo y | laconicd keys export alice --keyring-backend test --unarmored-hex --unsafe")
+
+  cat <<EOF > laconic-faucet-deployment/config.env
+  CERC_FAUCET_KEY=$FAUCET_ACCOUNT_PK
+  EOF
+
+  # Stop the deployment
+  laconic-so deployment --dir laconic-faucet-deployment stop --delete-volumes
+
+  # Remove and recreate the required data dir
+  sudo rm -rf laconic-faucet-deployment/data/faucet-data
+  mkdir laconic-faucet-deployment/data/faucet-data
+
+  # Start the deployment
+  laconic-so deployment --dir laconic-faucet-deployment start
+  ```
+
+## testnet-onboarding-app
+
+* Deployment dir: `/srv/app/onboarding-app-deployment`
+
+* If code has changed, fetch and build with updated source code:
+
+  ```bash
+  # testnet-onboarding-app source
+  cd ~/cerc/testnet-onboarding-app
+
+  # Pull latest changes, or checkout to the required branch
+  git pull
+
+  # Confirm the latest commit hash
+  git log
+
+  # Rebuild the containers
+  cd /srv/app
+
+  laconic-so --stack ~/cerc/testnet-onboarding-app-stack/stack-orchestrator/stacks/onboarding-app build-containers --force-rebuild
+  ```
+
+* Update the configuration, if required in `onboarding-app-deployment/config.env`:
+
+  ```bash
+  WALLET_CONNECT_ID=63...
+
+  CERC_REGISTRY_GQL_ENDPOINT="https://laconicd.laconic.com/api"
+  CERC_LACONICD_RPC_ENDPOINT="https://laconicd.laconic.com"
+
+  CERC_FAUCET_ENDPOINT="https://faucet.laconic.com"
+
+  CERC_WALLET_META_URL="https://loro-signup.laconic.com"
+
+  CERC_STAKING_AMOUNT=1000000000000000
+  ````
+
+* Restart the deployment:
+
+  ```bash
+  laconic-so deployment --dir onboarding-app-deployment stop
+
+  laconic-so deployment --dir onboarding-app-deployment start
+
+  # Follow logs for testnet-onboarding-app container, wait for the build to finish
+  laconic-so deployment --dir onboarding-app-deployment logs testnet-onboarding-app -f
+  ```
+
+* The updated onboarding app can now be viewed at <https://loro-signup.laconic.com>
+
+## laconic-wallet-web
+
+* Deployment dir: `/srv/wallet/laconic-wallet-web-deployment`
+
+* If code has changed, fetch and build with updated source code:
+
+  ```bash
+  # testnet-onboarding-app source
+  cd ~/cerc/laconic-wallet-web
+
+  # Pull latest changes, or checkout to the required branch
+  git pull
+
+  # Confirm the latest commit hash
+  git log
+
+  # Rebuild the containers
+  cd /srv/wallet
+
+  laconic-so --stack ~/cerc/laconic-wallet-web/stack/stack-orchestrator/stack/laconic-wallet-web build-containers --force-rebuild
+  ```
+
+* Update the configuration, if required in `laconic-wallet-web-deployment/config.env`:
+
+  ```bash
+  WALLET_CONNECT_ID=63...
+  ```
+
+* Restart the deployment:
+
+  ```bash
+  laconic-so deployment --dir laconic-wallet-web-deployment stop
+
+  laconic-so deployment --dir laconic-wallet-web-deployment start
+
+  # Follow logs for laconic-wallet-web container, wait for the build to finish
+  laconic-so deployment --dir laconic-wallet-web-deployment logs laconic-wallet-web -f
+  ```
+
+* The web wallet can now be viewed at <https://wallet.laconic.com>
+
+## stage1 laconicd
+
+* Deployment dir: `/srv/laconicd/stage1-deployment`
+
+* If code has changed, fetch and build with updated source code:
+
+  ```bash
+  # laconicd source
+  cd ~/cerc/laconicd
+
+  # Pull latest changes, or checkout to the required branch
+  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
+  ```
+
+* Optionally, reset the data directory:
+
+  ```bash
+  # Stop the deployment
+  laconic-so deployment --dir stage1-deployment stop --delete-volumes
+
+  # Remove and recreate the required data dirs
+  sudo rm -rf stage1-deployment/data/laconicd-data stage1-deployment/data/genesis-config
+
+  mkdir stage1-deployment/data/laconicd-data
+  mkdir stage1-deployment/data/genesis-config
+  ```
+
+* Update the configuration, if required in `stage1-deployment/config.env`:
+
+  ```bash
+  AUTHORITY_AUCTION_ENABLED=true
+  AUTHORITY_AUCTION_COMMITS_DURATION=3600
+  AUTHORITY_AUCTION_REVEALS_DURATION=3600
+  AUTHORITY_GRACE_PERIOD=7200
+  ```
+
+* Follow [stage0-to-stage1.md](./stage0-to-stage1.md) to generate the genesis file for stage1 and start the deployment
+
+## laconic-console
+
+* Deployment dir: `/srv/console/laconic-console-deployment`
+
+* If code has changed, fetch and build with updated source code:
+
+  ```bash
+  # testnet-onboarding-app source
+  cd ~/cerc/laconic-console
+
+  # Pull latest changes, or checkout to the required branch
+  git pull
+
+  # Confirm the latest commit hash
+  git log
+
+  # Rebuild the containers
+  cd /srv/console
+
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-console build-containers --force-rebuild
+  ```
+
+* Update the configuration, if required in `laconic-console-deployment/config.env`:
+
+  ```bash
+  # Laconicd (hosted) GQL endpoint
+  LACONIC_HOSTED_ENDPOINT=https://laconicd.laconic.com
+  ```
+
+* Restart the deployment:
+
+  ```bash
+  laconic-so deployment --dir laconic-console-deployment stop
+
+  laconic-so deployment --dir laconic-console-deployment start
+
+  # Follow logs for console container
+  laconic-so deployment --dir laconic-console-deployment logs console -f
+  ```
+
+* The laconic console can now be viewed at <https://loro-console.laconic.com>

requirements.txt

@@ -0,0 +1 @@
+Click

setup.py

@@ -0,0 +1,15 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="laconic-testnet",
+    version="0.1.0",
+    packages=find_packages(),
+    install_requires=[
+        "Click",
+    ],
+    entry_points={
+        'console_scripts': [
+            'laconic-testnet = cli.cli:main',
+        ],
+    },
+)

stack-orchestrator/compose/docker-compose-laconic-console.yml

@@ -0,0 +1,32 @@
+services:
+  cli:
+    image: cerc/laconic-registry-cli:local
+    command: ["bash", "-c", "/app/create-config.sh && tail -f /dev/null"]
+    environment:
+      CERC_LACONICD_RPC_ENDPOINT: ${CERC_LACONICD_RPC_ENDPOINT:-http://laconicd:26657}
+      CERC_LACONICD_GQL_ENDPOINT: ${CERC_LACONICD_GQL_ENDPOINT:-http://laconicd:9473/api}
+      CERC_LACONICD_CHAIN_ID: ${CERC_LACONICD_CHAIN_ID:-laconic_9000-1}
+      CERC_LACONICD_USER_KEY: ${CERC_LACONICD_USER_KEY}
+      CERC_LACONICD_BOND_ID: ${CERC_LACONICD_BOND_ID}
+      CERC_LACONICD_GAS: ${CERC_LACONICD_GAS:-200000}
+      CERC_LACONICD_FEES: ${CERC_LACONICD_FEES:-200000alnt}
+    volumes:
+      - ../config/laconic-console/cli/create-config.sh:/app/create-config.sh
+      - laconic-registry-data:/laconic-registry-data
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+
+  console:
+    restart: unless-stopped
+    image: cerc/laconic-console-host:local
+    environment:
+      CERC_SCRIPT_DEBUG: ${CERC_SCRIPT_DEBUG}
+      CERC_WEBAPP_FILES_DIR: ${CERC_WEBAPP_FILES_DIR:-/usr/local/share/.config/yarn/global/node_modules/@cerc-io/console-app/dist/production}
+      LACONIC_HOSTED_ENDPOINT: ${LACONIC_HOSTED_ENDPOINT:-http://localhost:9473}
+    volumes:
+      - ../config/laconic-console/console/config.yml:/config/config.yml
+    ports:
+      - "80"
+
+volumes:
+  laconic-registry-data:

stack-orchestrator/compose/docker-compose-laconic-faucet.yml

@@ -0,0 +1,29 @@
+services:
+  faucet:
+    restart: unless-stopped
+    image: cerc/laconic-faucet:local
+    command: ["bash", "-c", "./start-faucet.sh"]
+    environment:
+      CERC_SCRIPT_DEBUG: ${CERC_SCRIPT_DEBUG}
+      CERC_LACONICD_RPC_ENDPOINT: ${CERC_LACONICD_RPC_ENDPOINT:-http://laconicd:26657}
+      CERC_FAUCET_KEY: ${CERC_FAUCET_KEY}
+      CERC_LACONICD_CHAIN_ID: ${CERC_LACONICD_CHAIN_ID:-laconic_9000-1}
+      CERC_TRANSFER_AMOUNT: ${CERC_TRANSFER_AMOUNT:-10000000000}
+      CERC_PERIOD_TRANSFER_LIMIT: ${CERC_PERIOD_TRANSFER_LIMIT:-30000000000}
+    volumes:
+      - faucet-data:/app/db
+      - ../config/laconic-faucet/start-faucet.sh:/app/start-faucet.sh
+      - ../config/laconic-faucet/config-template.toml:/app/environments/config-template.toml
+    ports:
+      - 3000
+    healthcheck:
+      test: ["CMD", "nc", "-vz", "127.0.0.1", "3000"]
+      interval: 10s
+      timeout: 5s
+      retries: 10
+      start_period: 5s
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+
+volumes:
+  faucet-data:

stack-orchestrator/compose/docker-compose-testnet-laconicd.yml

@@ -0,0 +1,31 @@
+services:
+  laconicd:
+    restart: unless-stopped
+    image: cerc/laconicd:local
+    command: ["bash", "-c", "/opt/run-laconicd.sh"]
+    environment:
+      CERC_MONIKER: ${CERC_MONIKER:-TestnetNode}
+      CERC_CHAIN_ID: ${CERC_CHAIN_ID:-laconic_9000-1}
+      CERC_PEERS: ${CERC_PEERS}
+      CERC_LOGLEVEL: ${CERC_LOGLEVEL:-info}
+    volumes:
+      - laconicd-data:/root/.laconicd
+      - ../config/laconicd/run-laconicd.sh:/opt/run-laconicd.sh
+    ports:
+      - "6060"
+      - "26657"
+      - "26656"
+      - "9473"
+      - "9090"
+      - "1317"
+    healthcheck:
+      test: ["CMD", "nc", "-vz", "127.0.0.1", "26657"]
+      interval: 30s
+      timeout: 10s
+      retries: 10
+      start_period: 10s
+    extra_hosts:
+    - "host.docker.internal:host-gateway"
+
+volumes:
+  laconicd-data:

stack-orchestrator/config/laconic-console/cli/create-config.sh

@@ -0,0 +1,23 @@
+#!/bin/bash
+
+if [[ -n "$CERC_SCRIPT_DEBUG" ]]; then
+  set -x
+fi
+
+set -e
+
+# Create the required config file
+config_file="/app/config.yml"
+cat <<EOF > $config_file
+services:
+  registry:
+    rpcEndpoint: ${CERC_LACONICD_RPC_ENDPOINT}
+    gqlEndpoint: ${CERC_LACONICD_GQL_ENDPOINT}
+    userKey: ${CERC_LACONICD_USER_KEY}
+    bondId: ${CERC_LACONICD_BOND_ID}
+    chainId: ${CERC_LACONICD_CHAIN_ID}
+    gas: ${CERC_LACONICD_GAS}
+    fees: ${CERC_LACONICD_FEES}
+EOF
+
+echo "Exported config to $config_file"

stack-orchestrator/config/laconic-console/console/config.yml

@@ -0,0 +1,6 @@
+# Config for laconic-console
+
+services:
+  wns:
+    server: 'LACONIC_HOSTED_ENDPOINT/api'
+    webui: 'LACONIC_HOSTED_ENDPOINT/console'

stack-orchestrator/config/laconic-faucet/config-template.toml

@@ -0,0 +1,13 @@
+[upstream]
+  rpcEndpoint = "REPLACE_WITH_CERC_LACONICD_RPC_ENDPOINT"
+  chainId = "laconic_9000-1"
+  denom = "alnt"
+  prefix = "laconic"
+  gasPrice = "1"
+  faucetKey = "REPLACE_WITH_CERC_FAUCET_KEY"
+
+[server]
+  port=3000
+  transferAmount = "REPLACE_WITH_CERC_TRANSFER_AMOUNT"
+  periodTransferLimit = "REPLACE_WITH_CERC_PERIOD_TRANSFER_LIMIT"
+  dbDir = "db"

stack-orchestrator/config/laconic-faucet/start-faucet.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+
+set -e
+set -u
+if [ -n "$CERC_SCRIPT_DEBUG" ]; then
+  set -x
+fi
+
+config_template=$(cat environments/config-template.toml)
+target_config="./environments/local.toml"
+
+# Check if faucet key is set
+if [ -z "${CERC_FAUCET_KEY:-}" ]; then
+  echo "Error: CERC_FAUCET_KEY is not set. Exiting..."
+  exit 1
+fi
+
+echo "Using laconicd RPC endpoint: $CERC_LACONICD_RPC_ENDPOINT"
+echo "Transfer amount per request: $CERC_TRANSFER_AMOUNT"
+echo "Transfer limit for an address within a period: $CERC_PERIOD_TRANSFER_LIMIT"
+
+FAUCET_CONFIG=$(echo "$config_template" | \
+  sed -E "s|REPLACE_WITH_CERC_FAUCET_KEY|${CERC_FAUCET_KEY}|g; \
+          s|REPLACE_WITH_CERC_LACONICD_RPC_ENDPOINT|${CERC_LACONICD_RPC_ENDPOINT}|g; \
+          s|REPLACE_WITH_CERC_TRANSFER_AMOUNT|${CERC_TRANSFER_AMOUNT}|g; \
+          s|REPLACE_WITH_CERC_PERIOD_TRANSFER_LIMIT|${CERC_PERIOD_TRANSFER_LIMIT}|; ")
+
+echo "$FAUCET_CONFIG" > $target_config
+echo "Starting faucet..."
+node dist/index.js

stack-orchestrator/config/laconicd/run-laconicd.sh

@@ -0,0 +1,52 @@
+#!/bin/bash
+
+if [[ -n "$CERC_SCRIPT_DEBUG" ]]; then
+  set -x
+fi
+
+set -e
+
+input_genesis_file=/root/.laconicd/tmp/genesis.json
+if [ ! -f ${input_genesis_file} ]; then
+  echo "Genesis file not provided, exiting..."
+  exit 1
+fi
+
+if [ -z "$CERC_PEERS" ]; then
+  echo "Persistent peers not provided, exiting..."
+  exit 1
+fi
+
+echo "Env:"
+echo "Moniker: $CERC_MONIKER"
+echo "Chain Id: $CERC_CHAIN_ID"
+echo "Persistent peers: $CERC_PEERS"
+echo "Log level: $CERC_LOGLEVEL"
+
+NODE_HOME=/root/.laconicd
+
+# Set chain id in config
+laconicd config set client chain-id $CERC_CHAIN_ID --home $NODE_HOME
+
+# Check if node data dir already exists
+if [ -z "$(ls -A "$NODE_HOME/data")" ]; then
+  # Init node
+  echo "Initializing a new laconicd node with moniker $CERC_MONIKER and chain id $CERC_CHAIN_ID"
+  laconicd init $CERC_MONIKER --chain-id=$CERC_CHAIN_ID --home $NODE_HOME
+
+  # Use provided genesis config
+  cp $input_genesis_file $NODE_HOME/config/genesis.json
+else
+  echo "Node data dir $NODE_HOME/data already exists, skipping initialization..."
+fi
+
+# Update config with persistent peers
+sed -i "s/^persistent_peers *=.*/persistent_peers = \"$CERC_PEERS\"/g" $NODE_HOME/config/config.toml
+
+echo "Starting laconicd node..."
+laconicd start \
+  --api.enable \
+  --rpc.laddr="tcp://0.0.0.0:26657" \
+  --gql-playground --gql-server \
+  --log_level $CERC_LOGLEVEL \
+  --home $NODE_HOME

stack-orchestrator/container-build/cerc-laconic-console-host/Dockerfile

@@ -0,0 +1,16 @@
+FROM cerc/webapp-base:local
+
+# Configure the cerc-io npm registry
+RUN npm config set @cerc-io:registry https://git.vdb.to/api/packages/cerc-io/npm/
+RUN npm config set @lirewine:registry https://git.vdb.to/api/packages/cerc-io/npm/
+
+WORKDIR /app
+
+COPY . .
+
+RUN echo "Installing dependencies" && yarn
+RUN echo "Building" && LACONIC_HOSTED_CONFIG_FILE=config-hosted.yml yarn dist
+
+RUN npm config set @cerc-io:registry https://git.vdb.to/api/packages/cerc-io/npm/
+
+RUN yarn global add file:$PWD

stack-orchestrator/container-build/cerc-laconic-console-host/build.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+
+# Build cerc/laconic-console-host
+
+source ${CERC_CONTAINER_BASE_DIR}/build-base.sh
+
+# See: https://stackoverflow.com/a/246128/1701505
+SCRIPT_DIR=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )
+
+docker build -t cerc/laconic-console-host:local ${build_command_args} -f ${SCRIPT_DIR}/Dockerfile ${CERC_REPO_BASE_DIR}/laconic-console

stack-orchestrator/container-build/cerc-laconic-faucet/build.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+
+# Build cerc/laconic-faucet
+source ${CERC_CONTAINER_BASE_DIR}/build-base.sh
+docker build -t cerc/laconic-faucet:local ${build_command_args} ${CERC_REPO_BASE_DIR}/laconic-faucet

stack-orchestrator/container-build/cerc-laconic-registry-cli/Dockerfile

@@ -0,0 +1,20 @@
+# Node.js version (use -bullseye variants on local arm64/Apple Silicon): 18, 16, 14, 18-bullseye, 16-bullseye, 14-bullseye, 18-buster, 16-buster, 14-buster
+ARG VARIANT=18-bullseye
+FROM node:${VARIANT}
+
+RUN apt-get update \
+  && apt-get -y install --no-install-recommends python3 jq bash curl nano
+
+WORKDIR /app
+
+COPY . .
+
+RUN echo "Installing dependencies and building laconic-registry-cli" && \
+  yarn && yarn build
+
+# Globally install the cli binary
+RUN npm config set @cerc-io:registry https://git.vdb.to/api/packages/cerc-io/npm/
+RUN yarn global add file:$PWD
+
+# Default command sleeps forever so docker doesn't kill it
+CMD ["bash", "-c", "while :; do sleep 600; done"]

stack-orchestrator/container-build/cerc-laconic-registry-cli/build.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+
+# Build cerc/laconic-registry-cli
+source ${CERC_CONTAINER_BASE_DIR}/build-base.sh
+
+# See: https://stackoverflow.com/a/246128/1701505
+SCRIPT_DIR=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )
+
+docker build -t cerc/laconic-registry-cli:local ${build_command_args} -f ${SCRIPT_DIR}/Dockerfile ${CERC_REPO_BASE_DIR}/laconic-registry-cli

stack-orchestrator/container-build/cerc-laconicd/build.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+
+# Build cerc/laconicd
+source ${CERC_CONTAINER_BASE_DIR}/build-base.sh
+docker build -t cerc/laconicd:local ${build_command_args} ${CERC_REPO_BASE_DIR}/laconicd

stack-orchestrator/container-build/cerc-webapp-base/Dockerfile

@@ -0,0 +1,58 @@
+# Originally from: https://github.com/devcontainers/images/blob/main/src/javascript-node/.devcontainer/Dockerfile
+# [Choice] Node.js version (use -bullseye variants on local arm64/Apple Silicon): 18, 16, 14, 18-bullseye, 16-bullseye, 14-bullseye, 18-buster, 16-buster, 14-buster
+ARG VARIANT=20-bullseye-slim
+FROM node:${VARIANT}
+
+ARG USERNAME=node
+ARG NPM_GLOBAL=/usr/local/share/npm-global
+
+# Add NPM global to PATH.
+ENV PATH=${NPM_GLOBAL}/bin:${PATH}
+# Prevents npm from printing version warnings
+ENV NPM_CONFIG_UPDATE_NOTIFIER=false
+
+RUN \
+    # Configure global npm install location, use group to adapt to UID/GID changes
+    if ! cat /etc/group | grep -e "^npm:" > /dev/null 2>&1; then groupadd -r npm; fi \
+    && usermod -a -G npm ${USERNAME} \
+    && umask 0002 \
+    && mkdir -p ${NPM_GLOBAL} \
+    && touch /usr/local/etc/npmrc \
+    && chown ${USERNAME}:npm ${NPM_GLOBAL} /usr/local/etc/npmrc \
+    && chmod g+s ${NPM_GLOBAL} \
+    && npm config -g set prefix ${NPM_GLOBAL} \
+    && su ${USERNAME} -c "npm config -g set prefix ${NPM_GLOBAL}" \
+    # Install eslint
+    && su ${USERNAME} -c "umask 0002 && npm install -g eslint" \
+    # Install semver
+    && su ${USERNAME} -c "umask 0002 && npm install -g semver" \
+    # Install pnpm
+    && su ${USERNAME} -c "umask 0002 && npm install -g pnpm" \
+    && npm cache clean --force > /dev/null 2>&1
+
+# [Optional] Uncomment this section to install additional OS packages.
+RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
+    && apt-get -y install --no-install-recommends jq gettext-base
+
+# [Optional] Uncomment if you want to install an additional version of node using nvm
+# ARG EXTRA_NODE_VERSION=10
+# RUN su node -c "source /usr/local/share/nvm/nvm.sh && nvm install ${EXTRA_NODE_VERSION}"
+
+# We do this to get a yq binary from the published container, for the correct architecture we're building here
+COPY --from=docker.io/mikefarah/yq:latest /usr/bin/yq /usr/local/bin/yq
+
+COPY scripts /scripts
+
+# [Optional] Uncomment if you want to install more global node modules
+# RUN su node -c "npm install -g <your-package-list-here>"
+
+RUN mkdir -p /config
+
+# Install simple web server for now (use nginx perhaps later)
+RUN yarn global add http-server
+
+# Expose port for http
+EXPOSE 80
+
+# Default command sleeps forever so docker doesn't kill it
+CMD ["/scripts/start-serving-app.sh"]

stack-orchestrator/container-build/cerc-webapp-base/Dockerfile.webapp

@@ -0,0 +1,12 @@
+FROM cerc/webapp-base:local as builder
+
+ARG CERC_BUILD_TOOL
+ARG CERC_BUILD_OUTPUT_DIR
+
+WORKDIR /app
+COPY . .
+RUN rm -rf node_modules build dist .next*
+RUN /scripts/build-app.sh /app /data
+
+FROM cerc/webapp-base:local
+COPY --from=builder /data /data

stack-orchestrator/container-build/cerc-webapp-base/build.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+# Build cerc/webapp-base
+
+source ${CERC_CONTAINER_BASE_DIR}/build-base.sh
+
+# See: https://stackoverflow.com/a/246128/1701505
+SCRIPT_DIR=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )
+
+CERC_CONTAINER_BUILD_WORK_DIR=${CERC_CONTAINER_BUILD_WORK_DIR:-$SCRIPT_DIR}
+CERC_CONTAINER_BUILD_DOCKERFILE=${CERC_CONTAINER_BUILD_DOCKERFILE:-$SCRIPT_DIR/Dockerfile}
+CERC_CONTAINER_BUILD_TAG=${CERC_CONTAINER_BUILD_TAG:-cerc/webapp-base:local}
+
+docker build -t $CERC_CONTAINER_BUILD_TAG ${build_command_args} -f $CERC_CONTAINER_BUILD_DOCKERFILE $CERC_CONTAINER_BUILD_WORK_DIR
+rc=$?
+
+if [ $rc -ne 0 ]; then
+  echo "BUILD FAILED" 1>&2
+  exit $rc
+fi
+
+if [ "$CERC_CONTAINER_BUILD_TAG" != "cerc/webapp-base:local" ]; then
+  cat <<EOF
+
+#################################################################
+
+Built host container for $CERC_CONTAINER_BUILD_WORK_DIR with tag:
+
+    $CERC_CONTAINER_BUILD_TAG
+
+To test locally run:
+
+    laconic-so run-webapp --image $CERC_CONTAINER_BUILD_TAG --env-file /path/to/environment.env
+
+EOF
+fi

stack-orchestrator/container-build/cerc-webapp-base/scripts/apply-runtime-env.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+
+if [ -n "$CERC_SCRIPT_DEBUG" ]; then
+    set -x
+fi
+
+WORK_DIR="${1:-./}"
+
+cd "${WORK_DIR}" || exit 1
+
+if [ -f ".env" ]; then
+  TMP_ENV=`mktemp`
+  declare -px > $TMP_ENV
+  set -a
+  source .env
+  source $TMP_ENV
+  set +a
+  rm -f $TMP_ENV
+fi
+
+for f in $(find . -type f \( -regex '.*.html?' -or -regex ".*.[tj]s\(x\|on\)?$" \) | grep -v 'node_modules' | grep -v '.git'); do
+  for e in $(cat "${f}" | tr -s '[:blank:]' '\n' | tr -s '["/\\{},();]' '\n' | tr -s "[']" '\n' | egrep -o -e '^CERC_RUNTIME_ENV_.+$' -e '^LACONIC_HOSTED_CONFIG_.+$'); do
+    orig_name=$(echo -n "${e}" | sed 's/"//g')
+    cur_name=$(echo -n "${orig_name}" | sed 's/CERC_RUNTIME_ENV_//g')
+    cur_val=$(echo -n "\$${cur_name}" | envsubst)
+    if [ "$CERC_RETAIN_ENV_QUOTES" != "true" ]; then
+      cur_val=$(sed "s/^[\"']//" <<< "$cur_val" | sed "s/[\"']//")
+    fi
+    esc_val=$(sed 's/[&/\]/\\&/g' <<< "$cur_val")
+    echo "$f: $cur_name=$cur_val"
+    sed -i "s/$orig_name/$esc_val/g" $f
+  done
+done

stack-orchestrator/container-build/cerc-webapp-base/scripts/apply-webapp-config.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+if [ -n "$CERC_SCRIPT_DEBUG" ]; then
+    set -x
+fi
+if [[ $# -ne 2 ]]; then
+    echo "Illegal number of parameters" >&2
+    exit 1
+fi
+config_file_name=$1
+webapp_files_dir=$2
+if ! [[ -f ${config_file_name} ]]; then
+    echo "Config file ${config_file_name} does not exist" >&2
+    exit 1
+fi
+if ! [[ -d ${webapp_files_dir} ]]; then
+    echo "Webapp directory ${webapp_files_dir} does not exist" >&2
+    exit 1
+fi
+# First some magic using yq to translate our yaml config file into an array of key value pairs like:
+# LACONIC_HOSTED_CONFIG_<path-through-objects>=<value>
+readarray -t config_kv_pair_array < <( yq '.. | ([path | join("_"), .] | join("=") )' ${config_file_name} | sort -r | sed -e '$ d' | sed 's/^/LACONIC_HOSTED_CONFIG_/' )
+declare -p config_kv_pair_array
+# Then iterate over that kv array making the template substitution in our web app files
+for kv_pair_string in "${config_kv_pair_array[@]}"
+do
+    kv_pair=(${kv_pair_string//=/ })
+    template_string_to_replace=${kv_pair[0]}
+    template_value_to_substitute=${kv_pair[1]}
+    template_value_to_substitute_expanded=${template_value_to_substitute//LACONIC_HOSTED_ENDPOINT/${LACONIC_HOSTED_ENDPOINT}}
+    # Run find and sed to do the substitution of one variable over all files
+    # See: https://stackoverflow.com/a/21479607/1701505
+    echo "Substituting: ${template_string_to_replace} = ${template_value_to_substitute_expanded}"
+    # Note: we do not escape our strings, on the expectation they do not container the '#' char.
+    find ${webapp_files_dir} -type f -exec sed -i 's#'${template_string_to_replace}'#'${template_value_to_substitute_expanded}'#g' {} +
+done

stack-orchestrator/container-build/cerc-webapp-base/scripts/build-app.sh

@@ -0,0 +1,61 @@
+#!/bin/bash
+
+SCRIPT_DIR=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )
+
+if [ -n "$CERC_SCRIPT_DEBUG" ]; then
+    set -x
+fi
+
+CERC_BUILD_TOOL="${CERC_BUILD_TOOL}"
+CERC_BUILD_OUTPUT_DIR="${CERC_BUILD_OUTPUT_DIR}"
+
+WORK_DIR="${1:-/app}"
+DEST_DIR="${2:-/data}"
+
+if [ -f "${WORK_DIR}/build-webapp.sh" ]; then
+  echo "Building webapp with ${WORK_DIR}/build-webapp.sh ..."
+  cd "${WORK_DIR}" || exit 1
+
+  rm -rf "${DEST_DIR}"
+  ./build-webapp.sh "${DEST_DIR}" || exit 1
+elif [ -f "${WORK_DIR}/package.json" ]; then
+  echo "Building node-based webapp ..."
+  cd "${WORK_DIR}" || exit 1
+
+  if [ -z "$CERC_BUILD_TOOL" ]; then
+    if [ -f "pnpm-lock.yaml" ]; then
+      CERC_BUILD_TOOL=pnpm
+    elif [ -f "yarn.lock" ]; then
+      CERC_BUILD_TOOL=yarn
+    else
+      CERC_BUILD_TOOL=npm
+    fi
+  fi
+
+  time $CERC_BUILD_TOOL install || exit 1
+  time $CERC_BUILD_TOOL build || exit 1
+
+  rm -rf "${DEST_DIR}"
+  if [ -z "${CERC_BUILD_OUTPUT_DIR}" ]; then
+    if [ -d "${WORK_DIR}/dist" ]; then
+      CERC_BUILD_OUTPUT_DIR="${WORK_DIR}/dist"
+    elif [ -d "${WORK_DIR}/build" ]; then
+      CERC_BUILD_OUTPUT_DIR="${WORK_DIR}/build"
+    else
+      echo "ERROR: Unable to locate build output.  Set with --extra-build-args \"--build-arg CERC_BUILD_OUTPUT_DIR=path\"" 1>&2
+      exit 1
+    fi
+  fi
+  mv "${CERC_BUILD_OUTPUT_DIR}" "${DEST_DIR}"
+else
+  echo "Copying static app ..."
+  mv "${WORK_DIR}" "${DEST_DIR}"
+fi
+
+# One special fix ...
+cd "${DEST_DIR}"
+for f in $(find . -type f -name '*.htm*'); do
+  sed -i -e 's#/LACONIC_HOSTED_CONFIG_homepage/#LACONIC_HOSTED_CONFIG_homepage/#g' "$f"
+done
+
+exit 0

stack-orchestrator/container-build/cerc-webapp-base/scripts/start-serving-app.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+if [ -n "$CERC_SCRIPT_DEBUG" ]; then
+    set -x
+fi
+
+CERC_LISTEN_PORT=${CERC_LISTEN_PORT:-80}
+CERC_WEBAPP_FILES_DIR="${CERC_WEBAPP_FILES_DIR:-/data}"
+CERC_ENABLE_CORS="${CERC_ENABLE_CORS:-false}"
+CERC_SINGLE_PAGE_APP="${CERC_SINGLE_PAGE_APP}"
+
+if [ -z "${CERC_SINGLE_PAGE_APP}" ]; then 
+  # If there is only one HTML file, assume an SPA.
+  if [ 1 -eq $(find "${CERC_WEBAPP_FILES_DIR}" -name '*.html' | wc -l) ]; then
+    CERC_SINGLE_PAGE_APP=true
+  else
+    CERC_SINGLE_PAGE_APP=false
+  fi
+fi
+
+# ${var,,} is a lower-case comparison
+if [ "true" == "${CERC_ENABLE_CORS,,}" ]; then
+  CERC_HTTP_EXTRA_ARGS="$CERC_HTTP_EXTRA_ARGS --cors"
+fi
+
+# ${var,,} is a lower-case comparison
+if [ "true" == "${CERC_SINGLE_PAGE_APP,,}" ]; then
+  echo "Serving content as single-page app.  If this is wrong, set 'CERC_SINGLE_PAGE_APP=false'"
+  # Create a catchall redirect back to /
+  CERC_HTTP_EXTRA_ARGS="$CERC_HTTP_EXTRA_ARGS --proxy http://localhost:${CERC_LISTEN_PORT}?"
+else
+  echo "Serving content normally.  If this is a single-page app, set 'CERC_SINGLE_PAGE_APP=true'"
+fi
+
+LACONIC_HOSTED_CONFIG_FILE=${LACONIC_HOSTED_CONFIG_FILE}
+if [ -z "${LACONIC_HOSTED_CONFIG_FILE}" ]; then
+  if [ -f "/config/laconic-hosted-config.yml" ]; then
+    LACONIC_HOSTED_CONFIG_FILE="/config/laconic-hosted-config.yml"
+  elif [ -f "/config/config.yml" ]; then
+    LACONIC_HOSTED_CONFIG_FILE="/config/config.yml"
+  fi
+fi
+
+if [ -f "${LACONIC_HOSTED_CONFIG_FILE}" ]; then
+  /scripts/apply-webapp-config.sh $LACONIC_HOSTED_CONFIG_FILE "${CERC_WEBAPP_FILES_DIR}"
+fi
+
+/scripts/apply-runtime-env.sh ${CERC_WEBAPP_FILES_DIR}
+http-server $CERC_HTTP_EXTRA_ARGS -p ${CERC_LISTEN_PORT} "${CERC_WEBAPP_FILES_DIR}"

stack-orchestrator/stacks/laconic-console/README.md

@@ -0,0 +1,141 @@
+# laconic-console
+
+Instructions for running laconic registry CLI and console
+
+## Prerequisites
+
+* laconicd RPC and GQL endpoints
+
+## Setup
+
+* Clone the stack repo:
+
+  ```bash
+  laconic-so fetch-stack git.vdb.to/cerc-io/testnet-laconicd-stack
+  ```
+
+* Clone required repositories:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-console setup-repositories
+  ```
+
+* Build the container images:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-console build-containers
+  ```
+
+  This should create the following docker images locally:
+
+  * `cerc/laconic-registry-cli`
+  * `cerc/webapp-base`
+  * `cerc/laconic-console-host`
+
+## Create a deployment
+
+* Create a spec file for the deployment:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-console deploy init --output laconic-console-spec.yml
+  ```
+
+* Edit `network` in the spec file to map container ports to host ports as required:
+
+  ```bash
+  ...
+  network:
+    ports:
+      laconic-console:
+        - '8080:80'
+  ```
+
+* Create a deployment from the spec file:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-console deploy create --spec-file laconic-console-spec.yml --deployment-dir laconic-console-deployment
+  ```
+
+## Configuration
+
+* Inside the deployment directory, open `config.env` file and set following env variables:
+
+  ```bash
+  # All optional
+
+  # CLI configuration
+
+  # laconicd RPC endpoint (default: http://laconicd:26657)
+  CERC_LACONICD_RPC_ENDPOINT=
+
+  # laconicd GQL endpoint (default: http://laconicd:9473/api)
+  CERC_LACONICD_GQL_ENDPOINT=
+
+  # laconicd chain id (default: laconic_9000-1)
+  CERC_LACONICD_CHAIN_ID=
+
+  # laconicd user private key for txs
+  CERC_LACONICD_USER_KEY=
+
+  # laconicd bond id for txs
+  CERC_LACONICD_BOND_ID=
+
+  # Gas limit for txs (default: 200000)
+  CERC_LACONICD_GAS=
+
+  # Max fees for txs (default: 200000alnt)
+  CERC_LACONICD_FEES=
+
+  # Console configuration
+
+  # Laconicd (hosted) GQL endpoint (default: http://localhost:9473)
+  LACONIC_HOSTED_ENDPOINT=
+  ```
+
+## Run
+
+* Start the deployment:
+
+  ```bash
+  laconic-so deployment --dir laconic-console-deployment start
+  ```
+
+* View the laconic console at <http://localhost:8080>
+
+* Use the `cli` service for registry CLI operations:
+
+  ```bash
+  # Example
+  laconic-so deployment --dir laconic-console-deployment exec cli "laconic registry status"
+  ```
+
+## Check status
+
+* To list down and monitor the running containers:
+
+  ```bash
+  # With status
+  docker ps -a
+
+  # Follow logs for console container
+  laconic-so deployment --dir laconic-console-deployment logs console -f
+  ```
+
+## Clean up
+
+* Stop all services running in the background:
+
+  ```bash
+  # Stop the docker containers
+  laconic-so deployment --dir laconic-console-deployment stop
+  ```
+
+* To stop all services and also delete data:
+
+  ```bash
+  # Stop the docker containers
+  laconic-so deployment --dir laconic-console-deployment stop --delete-volumes
+
+  # Remove deployment directory (deployment will have to be recreated for a re-run)
+  rm -r laconic-console-deployment
+  ```

stack-orchestrator/stacks/laconic-console/stack.yml

@@ -0,0 +1,12 @@
+version: "1.0"
+name: laconic-console
+description: "Laconic registry CLI and console"
+repos:
+  - git.vdb.to/cerc-io/laconic-registry-cli
+  - git.vdb.to/cerc-io/laconic-console
+containers:
+  - cerc/laconic-registry-cli
+  - cerc/webapp-base
+  - cerc/laconic-console-host
+pods:
+  - laconic-console

stack-orchestrator/stacks/laconic-faucet/README.md

@@ -0,0 +1,121 @@
+# laconic-faucet
+
+Instructions for running the laconic faucet
+
+## Setup
+
+* Clone the stack repo:
+
+  ```bash
+  laconic-so fetch-stack git.vdb.to/cerc-io/testnet-laconicd-stack
+  ```
+
+* Clone the laconic-faucet respository:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-faucet setup-repositories
+  ```
+
+* Build the container image:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-faucet build-containers
+  ```
+
+  This should create the `cerc/laconic-faucet` image locally
+
+## Create a deployment
+
+* Create a spec file for the deployment:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-faucet deploy init --output laconic-faucet-spec.yml
+  ```
+
+* Edit `network` in the spec file to map container ports to host ports as required:
+
+  ```bash
+  network:
+    ports:
+      faucet:
+        - '3000:3000'
+  ```
+
+* Create a deployment from the spec file:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-faucet deploy create --spec-file laconic-faucet-spec.yml --deployment-dir laconic-faucet-deployment
+  ```
+
+## Configuration
+
+* Inside the `laconic-faucet-deployment` deployment directory, open `config.env` file and set following env variables:
+
+  ```bash
+  # Private key of a funded faucet account
+  CERC_FAUCET_KEY=
+
+  # Optional
+
+  # laconicd RPC endpoint (default: http://laconicd:26657)
+  CERC_LACONICD_RPC_ENDPOINT=
+
+  # laconicd chain id (default: laconic_9000-1)
+  CERC_LACONICD_CHAIN_ID=
+
+  # Amount of tokens to transfer on a single request (default: 1000000)
+  CERC_TRANSFER_AMOUNT=
+
+  # Transfer limit for an address within a period (default: 3000000)
+  CERC_PERIOD_TRANSFER_LIMIT=
+  ```
+
+## Start the deployment
+
+  ```bash
+  laconic-so deployment --dir laconic-faucet-deployment start
+  ```
+
+## Check status
+
+* To list down and monitor the running container:
+
+  ```bash
+  # With status
+  docker ps
+
+  # Check logs for a container
+  docker logs -f <CONTAINER_ID>
+  ```
+
+## Run
+
+* Request tokens from the faucet for an account:
+
+  ```bash
+  curl -X POST http://localhost:3000/faucet \
+    -H "Content-Type: application/json" \
+    -d '{"address": "<laconicd_address>"}'
+
+  # Expected output:
+  # {"success":true,"txHash":"<tx_hash>"}
+  ```
+
+## Clean up
+
+* Stop the `laconic-faucet` service running in the background:
+
+  ```bash
+  # Stop the docker container
+  laconic-so deployment --dir laconic-faucet-deployment stop
+  ```
+
+* To stop the service and also delete data:
+
+  ```bash
+  # Stop the docker containers
+  laconic-so deployment --dir laconic-faucet-deployment stop --delete-volumes
+
+  # Remove deployment directory (deployment will have to be recreated for a re-run)
+  rm -r laconic-faucet-deployment
+  ```

stack-orchestrator/stacks/laconic-faucet/stack.yml

@@ -0,0 +1,9 @@
+version: "1.0"
+name: laconic-faucet
+description: "Faucet for laconicd"
+repos:
+  - git.vdb.to/cerc-io/laconic-faucet
+containers:
+  - cerc/laconic-faucet
+pods:
+  - laconic-faucet

stack-orchestrator/stacks/testnet-laconicd/README.md

@@ -0,0 +1,302 @@
+# testnet-laconicd
+
+Instructions for running a laconicd testnet full node and joining as a validator
+
+## Prerequisites
+
+* Minimum hardware requirements:
+
+  ```bash
+  RAM: 8-16GB
+  Disk space: 200GB
+  CPU: 2 cores
+  ```
+
+* Testnet genesis file (file or an URL) and peer node addresses
+
+## Setup
+
+* Clone the stack repo:
+
+  ```bash
+  laconic-so fetch-stack git.vdb.to/cerc-io/testnet-laconicd-stack
+  ```
+
+* Clone required repositories:
+
+  ```bash
+  # laconicd
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/testnet-laconicd setup-repositories --pull
+
+  # laconic cli and console
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-console setup-repositories --pull
+
+  # If this throws an error as a result of being already checked out to a branch/tag in a repo, remove the repositories and re-run the command
+  ```
+
+* Build the container images:
+
+  ```bash
+  # laconicd
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/testnet-laconicd build-containers
+
+  # laconic cli and console
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-console build-containers
+  ```
+
+  This should create the following docker images locally:
+
+  * `cerc/laconicd`
+  * `cerc/laconic-registry-cli`
+  * `cerc/webapp-base`
+  * `cerc/laconic-console-host`
+
+## Create a deployment
+
+* Create a spec file for the deployment:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/testnet-laconicd deploy init --output testnet-laconicd-spec.yml
+
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-console deploy init --output laconic-console-spec.yml
+  ```
+
+* Edit `network` in both the spec files to map container ports to host ports as required:
+
+  ```bash
+  # testnet-laconicd-spec.yml
+  ...
+  network:
+    ports:
+      laconicd:
+        - '6060:6060'
+        - '26657:26657'
+        - '26656:26656'
+        - '9473:9473'
+        - '9090:9090'
+        - '1317:1317'
+
+  # laconic-console-spec.yml
+  ...
+  network:
+    ports:
+      console:
+        - '8080:80'
+  ```
+
+* Create deployments from the spec files:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/testnet-laconicd deploy create --spec-file testnet-laconicd-spec.yml --deployment-dir testnet-laconicd-deployment
+
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconic-console deploy create --spec-file laconic-console-spec.yml --deployment-dir laconic-console-deployment
+
+  # Place them both in the same namespace (cluster)
+  cp testnet-laconicd-deployment/deployment.yml laconic-console-deployment/deployment.yml
+  ```
+
+* Copy over the published testnet genesis file (`.json`) to data directory in deployment (`testnet-laconicd-deployment/data/laconicd-data/tmp`):
+
+  ```bash
+  # Example
+  mkdir -p testnet-laconicd-deployment/data/laconicd-data/tmp
+  cp genesis.json testnet-laconicd-deployment/data/laconicd-data/tmp/genesis.json
+  ```
+
+## Configuration
+
+* Inside the `testnet-laconicd-deployment` deployment directory, open `config.env` file and set following env variables:
+
+  ```bash
+  # Comma separated list of nodes to keep persistent connections to
+  # Example: "node-1-id@node-1-host:26656,node-2-id@node-2-host:26656"
+  CERC_PEERS=""
+
+  # Optional
+
+  # A custom human readable name for this node (default: TestnetNode)
+  CERC_MONIKER=
+
+  # Network chain ID (default: laconic_9000-1)
+  CERC_CHAIN_ID=
+
+  # Output log level (default: info)
+  CERC_LOGLEVEL=
+  ```
+
+* Inside the `laconic-console-deployment` deployment directory, open `config.env` file and set following env variables:
+
+  ```bash
+  # All optional
+
+  # CLI configuration
+
+  # laconicd chain id (default: laconic_9000-1)
+  CERC_LACONICD_CHAIN_ID=
+
+  # laconicd user private key for txs
+  CERC_LACONICD_USER_KEY=
+
+  # laconicd bond id for txs
+  CERC_LACONICD_BOND_ID=
+
+  # Gas limit for txs (default: 200000)
+  CERC_LACONICD_GAS=
+
+  # Max fees for txs (default: 200000alnt)
+  CERC_LACONICD_FEES=
+
+  # Console configuration
+
+  # Laconicd (hosted) GQL endpoint (default: http://localhost:9473)
+  LACONIC_HOSTED_ENDPOINT=
+  ```
+
+  Note: Use `host.docker.internal` as host to access ports on the host machine
+
+## Start the deployments
+
+```bash
+laconic-so deployment --dir testnet-laconicd-deployment start
+laconic-so deployment --dir laconic-console-deployment start
+```
+
+## Check status
+
+* To list down and monitor the running containers:
+
+  ```bash
+  # With status
+  docker ps -a
+
+  # Follow logs for laconicd container
+  laconic-so deployment --dir testnet-laconicd-deployment logs laconicd -f
+  ```
+
+* Check the sync status of your node:
+
+  ```bash
+  laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd status | jq .sync_info"
+
+  # `catching_up: false` indicates that node is completely synced
+  ```
+
+* View the laconic console at <http://localhost:8080>
+
+* Use the cli service for registry CLI operations:
+
+  ```bash
+  # Example
+  laconic-so deployment --dir laconic-console-deployment exec cli "laconic registry status"
+  ```
+
+## Join as testnet validator
+
+* Create / import a new key pair:
+
+  ```bash
+  # Create new keypair
+  laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd keys add <key-name>"
+
+  # OR
+  # Restore existing key with mnemonic seed phrase
+  # You will be prompted to enter mnemonic seed
+  laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd keys add <key-name> --recover"
+
+  # Query the keystore for your account's address
+  laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd keys show <key-name> -a"
+  ```
+
+* Request tokens from the testnet faucet for your account if required
+
+* Check balance for your account:
+
+  ```bash
+  laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd query bank balances <account-address>"
+  ```
+
+* Create required validator configuration:
+
+  ```bash
+  # Note:
+  # Edit the staking amount and other fields as required
+  # Replace <your-node-moniker> with your node's moniker in command below
+
+  laconic-so deployment --dir testnet-laconicd-deployment exec laconicd 'cat <<EOF > my-validator.json
+  {
+    "pubkey": $(laconicd cometbft show-validator),
+    "amount": "900000000alnt",
+    "moniker": "<your-node-moniker>",
+    "commission-rate": "0.1",
+    "commission-max-rate": "0.2",
+    "commission-max-change-rate": "0.01",
+    "min-self-delegation": "1"
+  }
+  EOF'
+  ```
+
+* Create a validator:
+
+  ```bash
+  laconic-so deployment --dir testnet-laconicd-deployment exec laconicd 'laconicd tx staking create-validator my-validator.json \
+  --fees 500000alnt \
+  --chain-id=laconic_9000-1 \
+  --from <key-name>'
+  ```
+
+* View validators:
+
+  ```bash
+  laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd query staking validators"
+  ```
+
+  * Check that in the list of validators `<your-node-moniker>` exists
+
+## Perform operations
+
+* To perform txs against the chain using registry CLI, set your private key in config in the CLI container:
+
+  ```bash
+  # (Optional) Get the PK from your node
+  laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd keys export <key-name> --unarmored-hex --unsafe"
+
+  # Set your PK as 'userKey' in the config file
+  laconic-so deployment --dir laconic-console-deployment exec cli "nano config.yml"
+
+  # services:
+  # registry:
+  #   ...
+  #   userKey: <your-private-key>
+  #   ...
+
+  # Note: any changes made to the config will be lost when the cli Docker container is brought down
+  # So set / update the values in 'laconic-console-deployment/config.env' accordingly before restarting
+  ```
+
+* Adjust / set other config values (`bondId`, `gas`, `fees`) as required and perform txs:
+
+  ```bash
+  # Example
+  laconic-so deployment --dir laconic-console-deployment exec cli "laconic registry bond create --type alnt --quantity 1000000000000"
+  ```
+
+## Clean up
+
+* Stop all `testnet-laconicd` services running in the background:
+
+  ```bash
+  # Stop the docker containers
+  laconic-so deployment --dir testnet-laconicd-deployment stop
+  ```
+
+* To stop all services and also delete data:
+
+  ```bash
+  # Stop the docker containers
+  laconic-so deployment --dir testnet-laconicd-deployment stop --delete-volumes
+
+  # Remove deployment directory (deployment will have to be recreated for a re-run)
+  rm -r testnet-laconicd-deployment
+  ```
+
+* For `laconic-console`, see [laconic-console clean up](../laconic-console/README.md#clean-up)

stack-orchestrator/stacks/testnet-laconicd/stack.yml

@@ -0,0 +1,9 @@
+version: "1.0"
+name: testnet-laconicd
+description: "Laconicd full node"
+repos:
+  - git.vdb.to/cerc-io/laconicd
+containers:
+  - cerc/laconicd
+pods:
+  - testnet-laconicd

testnet-onboarding-validator.md

@@ -0,0 +1,285 @@
+# testnet-onboarding-validator
+
+## Onboard as a participant / validator on stage0
+
+* Visit <https://wallet.laconic.com/> and click on `Create wallet`
+  * Save the mnemonic for further usage
+
+* Register your laconic address as a participant using the [Onboarding App](https://loro-signup.laconic.com)
+
+  * Read and accept the `Terms and Conditions`
+
+  * On next page, enter your email to register to join the LORO testnet
+
+  * Visit the confirmation link sent on the registered email (email delivery might take a few minutes)
+
+    * It should take you to the `Testnet Onboarding` app
+
+    * Note: The confirmation link will only work the first time, visit <https://loro-signup.laconic.com/sign-with-nitro-key> for further attempts if required
+
+  * Connect testnet-onboarding app to the wallet:
+
+    * Click on `CONNECT WALLET` button on the testnet-onboarding app
+
+    * Click on the WalletConnect icon on the top right corner in the wallet
+
+      * If using the wallet website, enter WalletConnect URI for pairing
+
+  * In the onboarding app, choose your nitro and laconicd account to onboard
+
+  * Sign using the nitro key
+
+    * Approve sign request on Wallet
+
+  * Select the desired participant role (`Validator` or `Participant`) and accept the onboarding terms and conditions
+
+  * In the next step, fund your laconic account by clicking on the `REQUEST TOKENS FROM FAUCET` button; ensure that the displayed balance is updated
+
+  * Send transaction request to the wallet
+
+    * From wallet, approve and send transaction to stage0 laconicd chain
+
+## Join as a validator on stage1
+
+### Prerequisites
+
+* Minimum hardware requirements:
+
+  ```bash
+  RAM: 8-16GB
+  Disk space: 200GB
+  CPU: 2 cores
+  ```
+
+* Testnet genesis file and peer node address
+
+* Mnemonic from the [wallet](https://wallet.laconic.com)
+
+* Participant onboarded on stage0
+
+### Setup
+
+* Clone the stack repo:
+
+  ```bash
+  laconic-so fetch-stack git.vdb.to/cerc-io/testnet-laconicd-stack
+  ```
+
+* Clone required repositories:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/testnet-laconicd setup-repositories --pull
+
+  # If this throws an error as a result of being already checked out to a branch/tag in a repo, remove the repositories and re-run the command
+  ```
+
+* Build the container images:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/testnet-laconicd build-containers
+  ```
+
+  This should create the following docker images locally:
+
+  * `cerc/laconicd`
+
+### Create a deployment
+
+* Create a spec file for the deployment:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/testnet-laconicd deploy init --output testnet-laconicd-spec.yml
+  ```
+
+* Edit `network` in the spec file to map container ports to host ports as required:
+
+  ```bash
+  # testnet-laconicd-spec.yml
+  ...
+  network:
+    ports:
+      laconicd:
+        - '6060:6060'
+        - '26657:26657'
+        - '26656:26656'
+        - '9473:9473'
+        - '9090:9090'
+        - '1317:1317'
+  ```
+
+* Create the deployment from the spec file:
+
+  ```bash
+  laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/testnet-laconicd deploy create --spec-file testnet-laconicd-spec.yml --deployment-dir testnet-laconicd-deployment
+  ```
+
+* Copy over the published testnet genesis file (`.json`) to data directory in deployment (`testnet-laconicd-deployment/data/laconicd-data/tmp`):
+
+  ```bash
+  # Example
+  mkdir -p testnet-laconicd-deployment/data/laconicd-data/tmp
+  cp genesis.json testnet-laconicd-deployment/data/laconicd-data/tmp/genesis.json
+  ```
+
+### Configuration
+
+* Inside the `testnet-laconicd-deployment` deployment directory, open `config.env` file and set following env variables:
+
+  ```bash
+  # Comma separated list of nodes to keep persistent connections to
+  # Example: "node-1-id@laconicd.laconic.com:26656"
+  # Use the provided node id
+  CERC_PEERS=""
+
+  # A custom human readable name for this node
+  CERC_MONIKER=
+  ```
+
+### Start the deployment
+
+```bash
+laconic-so deployment --dir testnet-laconicd-deployment start
+```
+
+### Check status
+
+* To list down and monitor the running containers:
+
+  ```bash
+  # With status
+  docker ps -a
+
+  # Follow logs for laconicd container
+  laconic-so deployment --dir testnet-laconicd-deployment logs laconicd -f
+  ```
+
+* Check the sync status of your node:
+
+  ```bash
+  laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd status | jq .sync_info"
+
+  # `catching_up: false` indicates that node is completely synced
+  ```
+
+* After the node has caught up, view current list of validators:
+
+  ```bash
+  laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd query staking validators"
+  ```
+
+  * Confirm that in the list of validators, your node moniker does not exist
+
+### Join as testnet validator
+
+* Open the wallet: <https://wallet.laconic.com/>
+
+* Create a validator from the onboarding app:
+
+  * Visit the [validator creation](https://loro-signup.laconic.com/validator) page
+
+    * If required, connect testnet-onboarding app to the wallet with which onboarding was done on stage0
+
+  * Select the Laconic account (same as the one used while onboarding) using which you wish to send the create validator request
+
+    * This should display the details of your onboarded participant
+
+    * You can proceed if the participant has `validator` role
+
+  * Enter your node's moniker (use the same one used while [configuring](#configuration) the `testnet-laconicd-deployment`)
+
+  * Fetch and enter your validator's pubkey:
+
+    ```bash
+    laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd cometbft show-validator" | jq -r .key
+    ```
+
+  * Send the transaction request to wallet
+
+    * From wallet, approve and send transaction to stage1 laconicd chain
+
+* Alternatively, create a validator using the laconicd CLI:
+
+  * Import a key pair:
+
+    ```bash
+    KEY_NAME=alice
+
+    # Restore existing key with mnemonic seed phrase
+    # You will be prompted to enter mnemonic seed
+    laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd keys add $KEY_NAME --recover"
+
+    # Query the keystore for your account's address
+    laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd keys show $KEY_NAME -a"
+    ```
+
+  * Check balance for your account:
+
+    ```bash
+    laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd query bank balances <account-address>"
+    ```
+
+  * Create required validator configuration:
+
+    ```bash
+    # Note:
+    # Edit the staking amount and other fields as required
+    # Replace <your-node-moniker> with your node's moniker in command below
+
+    laconic-so deployment --dir testnet-laconicd-deployment exec laconicd 'cat <<EOF > my-validator.json
+    {
+      "pubkey": $(laconicd cometbft show-validator),
+      "amount": "1000000000000000alnt",
+      "moniker": "<your-node-moniker>",
+      "commission-rate": "0.1",
+      "commission-max-rate": "0.2",
+      "commission-max-change-rate": "0.01",
+      "min-self-delegation": "1"
+    }
+    EOF'
+    ```
+
+  * Create a validator:
+
+    ```bash
+    laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd tx staking create-validator my-validator.json \
+    --fees 500000alnt \
+    --chain-id=laconic_9000-1 \
+    --from $KEY_NAME"
+    ```
+
+* View validators:
+
+  ```bash
+  laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd query staking validators"
+  ```
+
+  * Check that in the list of validators `<your-node-moniker>` exists
+
+* View validator set:
+
+  ```bash
+  laconic-so deployment --dir testnet-laconicd-deployment exec laconicd "laconicd query consensus comet validator-set"
+  ```
+
+### Clean up
+
+* Stop all `testnet-laconicd` services running in the background:
+
+  ```bash
+  # Stop the docker containers
+  laconic-so deployment --dir testnet-laconicd-deployment stop
+  ```
+
+* To stop all services and also delete data:
+
+  ```bash
+  # Stop the docker containers
+  laconic-so deployment --dir testnet-laconicd-deployment stop --delete-volumes
+
+  # Remove deployment directory (deployment will have to be recreated for a re-run)
+  sudo rm -r testnet-laconicd-deployment
+  ```
+
+## Troubleshooting
+
+* If you face any issues in the onboarding app or the web-wallet, clear your browser cache and reload