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

# laconicd-full-node

Instructions for deploying a laconicd full node along with steps to join testnet as a validator post genesis

Minimum hardware requirements:

- RAM: 8-16GB
- Disk space: 200GB
- CPU: 2 cores

## 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/laconicd-full-node setup-repositories
```

## Build the fixturenet-eth containers

```bash
laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconicd-full-node build-containers
```

This should create several container images in the local image registry:

* cerc/laconic2d
* cerc/laconic-registry-cli
* cerc/webapp-base
* cerc/laconic-console-host

## Create a spec file for the deployment

```bash
laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconicd-full-node deploy init --output laconic-full-node-spec.yml
```

## Ports

Edit `network` in the spec file to map container ports to host ports as required:

```bash
...
network:
  # TODO: UPDATE
  ports:
    laconicd:
     - '6060:6060'
     - '26657:26657'
     - '26656:26656'
     - '9473:9473'
     - '9090:9090'
     - '1317:1317'
```

## Create a deployment from the spec file

```bash
laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconicd-full-node deploy create --spec-file  laconic-full-node-spec.yml --deployment-dir laconic-full-node-deployment
```

### Configuration

Copy genesis file to the deployment data directory:

```bash
# Example
cp genesis.json laconic-full-node-deployment/data/laconicd-config/
```

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

```bash
# TODO: UPDATE
# External Filecoin (ETH RPC) endpoint to point the watcher to
CERC_PEERS=""
```

## Start the deployment

```bash
laconic-so deployment --dir laconic-full-node-deployment start
```

## Check status

<!-- TODO -->

## Join as testnet validator

<!-- TODO import a funded account / create an account and get it funded -->

<!-- TODO create a validator-->

## Clean up

Stop all services running in the background:

```bash
laconic-so deployment --dir laconic-full-node-deployment stop
```

Clear volumes created by this stack:

<!-- TODO -->