A multi-currency, zero-config, peer-to-peer, Interledger-enabled payment network
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.
- A Node version manager which respects
.node-version. For example, fnm. *.localhostmapped to127.0.0.1(on Linux this is usually the default, on MacOS use something like dnsmasq).- mkcert
- Run
mkcert -installto create the private CA and register it in your OS and browser. - Add
export NODE_EXTRA_CA_CERTS="$(mkcert -CAROOT)/rootCA.pem"to your.bashrc,.zshrc, or similar.
- Run
Install package dependencies.
pnpm installRun the development environment.
pnpm startYou 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.
- Node.js
- PNPM (
npm install -g pnpm) - Docker
To initiate a build, simply run:
pnpm buildThis 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