Messenger Demo

Environment Setup

PREREQUISITE: set up the holochain development environment.

Enter the nix shell by running this in the root folder of the repository:

nix develop
pnpm install

Run all the other instructions in this README from inside this nix shell, otherwise they won't work.

Running 2 agents

pnpm start

This will create a network of 2 nodes connected to each other and their respective UIs. It will also bring up the Holochain Playground for advanced introspection of the conductors.

Running the backend tests

pnpm test

Bootstrapping a network

Create a custom network of nodes connected to each other and their respective UIs with:

pnpm network 3

Substitute the "3" for the number of nodes that you want to bootstrap in your network. This will also bring up the Holochain Playground for advanced introspection of the conductors.

Packaging

To package the web happ:

pnpm package

You'll have the messenger-demo.webhapp in workdir. This is what you should distribute so that the Holochain Launcher can install it.

Documentation

This repository is using these tools:

• PNPM Workspaces: npm replacement that supports git dependencies with subdirectories.
• hc: Holochain CLI to easily manage Holochain development instances.
• @holochain/tryorama: test framework.
• @holochain/client: client library to connect to Holochain from the UI.
• @holochain-playground/cli: introspection tooling to understand what's going on in the Holochain nodes.