justmoon / dassie

Dassie

A multi-currency, zero-config, peer-to-peer, Interledger-enabled payment network

Intro

Development Environment

In order to develop a peer-to-peer application, it is very useful to quickly spin up several nodes which can all talk to each other. Dassie uses HTTPS everywhere including during development, so you will need to generate certificates for your nodes.

Prerequisites

• A Node version manager which respects .node-version. For example, fnm.
• *.localhost mapped to 127.0.0.1 (on Linux this is usually the default, on MacOS use something like dnsmasq).
• mkcert
  1. Run mkcert -install to create the private CA and register it in your OS and browser.
  2. Add export NODE_EXTRA_CA_CERTS="$(mkcert -CAROOT)/rootCA.pem" to your .bashrc, .zshrc, or similar.

Setting up the development environment

Install package dependencies.

pnpm install

Starting the development environment

Run the development environment.

pnpm start

Dassie Production Builds

You generally won't need to build Dassie images locally as this job is normally done by our CI. However, there are a few situations where you may want create custom Dassie binaries.

Prerequisites

• Node.js
• PNPM (npm install -g pnpm)
• Docker

Building

To initiate a build, simply run:

pnpm build

This will first create a "builder" Docker image and then call this image with any parameters that you pass in.

For example, you can pass in a different build target:

pnpm build canary