Awesome

Krist

This is the new official Krist node. It is written in Node.js.

Repo Guidelines

All code and commits are made in British English (Not Simplified American English)
As of 2020, commits are made with Conventional Commits

API Documentation

The documentation is generated with apiDoc. You can find a live copy of the API documentation here.

Docker Installation

The preferred method of installation is Docker. The Docker images are published on the GitHub Container Registry under ghcr.io/quantumlytangled/krist or quantumlytangled/krist.

MySQL/MariaDB and Redis are required too. There are two options to connect to the databases. The easier way is to run MySQL and Redis on the host machine, and specify the DB_HOST=${DOCKER_GATEWAY} and REDIS_HOST=${DOCKER_GATEWAY} environment variables to Krist. Alternatively, you can run MariaDB and Redis in Docker too (left as an exercise to the reader).

Example usage with Docker Compose:

version: "3.9"
services:
  krist:
    image: "quantumlytangled/krist"
    environment:
      - DB_PASS=${DB_PASS}
      - PUBLIC_URL=krist.ceriat.net
      - DB_HOST=172.17.0.1
      - REDIS_HOST=172.17.0.1
      - MINING_ENABLED=true
      - GEN_GENESIS=true
    ports:
      - "127.0.0.1:8080:8080"
    restart: unless-stopped

Manual Installation

Requirements

Node.js v14
MySQL or MariaDB
Redis

Installation

Installation is fairly straight-forward. Simply clone the project, run npm i to install the required dependencies and then run node ..

Webserver Configuration

This Krist node is supposed to be ran behind a serverside proxy. The file casket_example.casket includes a basic configuration for how to set up the proxy in Casket. The Node.js webserver is not designed to and should not be exposed to the public web. HTTPS is required.

Configuration

Basic configuration is now done via environment variables. You must supply the following environment variables:

Variable	Default	Description
`DB_PASS`	required	The password of the database user.
`PUBLIC_URL`	required	The FQDN of the Krist server (e.g. `krist.ceriat.net`).

The following optional environment variables may also be specified:

Variable	Default	Description
`DB_HOST`	`127.0.0.1`	The hostname of the database.
`DB_PORT`	`3306`	The port of the database.
`DB_NAME`	`krist`	The name of the database.
`DB_USER`	`krist`	The username of the database user.
`TEST_DB_NAME`	`test_krist`	Required for testing. If `NODE_ENV` is `test`, the name of the database.
`TEST_DB_USER`	`test_krist`	Required for testing. If `NODE_ENV` is `test`, the username of the database user.
`TEST_DB_PASS`		Required for testing. If `NODE_ENV` is `test`, the password of the database user.
`WEB_LISTEN`	`8080`	The port that the webserver listens on.
`REDIS_HOST`	`127.0.0.1`	The hostname of the redis server.
`REDIS_PORT`	`6379`	The port of the redis server.
`REDIS_PREFIX`	`krist:`	The prefix of the redis keys.
`TEST_REDIS_PREFIX`	`test_krist:`	Required for testing. If `NODE_ENV` is `test` (e.g. running Jest), the prefix of the redis keys.
`MINING_ENABLED`	`false`	If mining should be enabled.
`GEN_GENESIS`	`false`	If Krist should force generate a genesis block.
`NODE_ENV`	`development`	Either `development` or `production`. If `development`, the Krist server runs in debug mode.
`FORCE_INSECURE`	`false`	If `true`, force the websocket gateway to return `ws://` URLs instead of `wss://`. Used for development only.
`GITHUB_TOKEN`		Any valid GitHub token (e.g. a PAT with no scopes) to obtain avatars for the homepage. Completely optional.
`USE_PROMETHEUS`	`false`	If `true`, enables Prometheus metrics on the `/metrics` endpoint.
`PROMETHEUS_PASSWORD`		If set, require HTTP basic authentication to access Prometheus metrics, with the username `prometheus`.

For convenience, you may specify environment variables in a .env file.

License

This project is released under GPL-3.0. More information can be found in the LICENSE file.