iamp2p-hc

Holochain backend for IamP2P, see iamp2p-ui for user interface, and iamp2p-docs for general, design, and vision documentation.

To download it as a native application for Linux or MacOS from iamp2p-release.

Holochain Compatibility

Current compatibility with holochain/holochain: ad3ccd0a126683d5fa44985f7abc18f1d891de01 (Nov 9, 2020)

When changing, change this line in install-holochain.sh

REV=ad3ccd0a126683d5fa44985f7abc18f1d891de01

Also change this line in Cargo.toml:

hdk3 = { git = "https://github.com/holochain/holochain", rev = "ad3ccd0a126683d5fa44985f7abc18f1d891de01", package = "hdk3" }

Make sure the tests still pass for the new version.

Running

Before starting up the UI development, start up a Holochain Conductor with the IamP2P DNA. Here's how:

Enter a nix shell:

nix-shell --run iamp2p-package
nix-shell --run iamp2p-hc

This starts up the Conductor with a running instance of the DNA in it.

Leave this terminal open and running, as long as you're doing development.

Building

To rebuild the DNA that holochain uses to run use the hc command:

nix-shell --run iamp2p-package

Stop the running conductor (ctrl + c) and rerun the above again if you make changes to the DNA.

Testing

To run the tests

nix-shell --run iamp2p-test

Formatting

To format the Rust code of both DNAs

nix-shell --run iamp2p-fmt

Releasing

Edit the version.current of the config.nix file, and set it to the desired version number of the release. Also edit the version property of dnas/projects/zomes/iamp2p_projects/code/Cargo.toml and dnas/profiles/zomes/iamp2p_profiles/code/Cargo.toml, and then run nix-shell --run iamp2p-package so that the Cargo.lock file is updated as well.

TODO: notes about CHANGELOG.md and CHANGELOG-UNRELEASED.md

TODO: notes about updating Release notes

Run

nix-shell --run hn-release-github

Updating

To update the holonix version (and therefore the holochain binaries) edit the holonix property of config.nix.