# onboarding-app

Instructions for running the `testnet-onboarding-app` using [laconic-so](https://git.vdb.to/cerc-io/stack-orchestrator)

## Setup

* Clone the stack repo:

  ```bash
  laconic-so fetch-stack git.vdb.to/cerc-io/testnet-onboarding-app-stack
  ```

* Setup required repositories:

  ```bash
  laconic-so --stack ~/cerc/testnet-onboarding-app-stack/stack-orchestrator/stacks/onboarding-app setup-repositories
  ```

* Build the container image:

  ```bash
  laconic-so --stack ~/cerc/testnet-onboarding-app-stack/stack-orchestrator/stacks/onboarding-app build-containers
  ```

  This should create the `cerc/testnet-onboarding-app` image locally

## Create a deployment

* Create a spec file for the deployment:

  ```bash
  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 as required:

  ```bash
  network:
    ports:
      testnet-onboarding-app:
        - '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
  ```

## Configuration

* Inside the `onboarding-app-deployment` deployment directory, open `config.env` file and set following env variables:

  ```bash
  # WalletConnect project ID, same should be used in the laconic-wallet
  WALLET_CONNECT_ID=

  # Optional

  # laconicd chain id (default: laconic_9000-1)
  CERC_LACONICD_CHAIN_ID=

  # laconicd registry GQL endpoint (default: http://localhost:9473/api)
  CERC_REGISTRY_GQL_ENDPOINT=

  # laconicd RPC endpoint (default: http://laconicd:26657)
  CERC_LACONICD_RPC_ENDPOINT=

  # laconicd token denom (default: alnt)
  CERC_LACONICD_DENOM=

  # Faucet RPC endpoint (default: http://localhost:4000)
  CERC_FAUCET_ENDPOINT=

  # laconic wallet meta URL (default: http://localhost:3000)
  CERC_WALLET_META_URL=

  # Onboarding API endpoint (default: http://localhost:3001)
  CERC_SUMSUB_API_ENDPOINT=

  # Staking amount for validator creation (default: 1000000000000000)
  CERC_STAKING_AMOUNT=
  ```

## Start the deployment

  ```bash
  laconic-so deployment --dir onboarding-app-deployment start
  ```

  Open the app in a browser at <http://localhost:3000>

## Clean up

* Stop the deployment:

  ```bash
  laconic-so deployment --dir onboarding-app-deployment stop
  ```