acorn-hc

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

To download it as a native application for Linux or MacOS from acorn-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 Acorn DNA. Here's how:

Enter a nix shell:

nix-shell --run acorn-package
nix-shell --run acorn-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 acorn-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 acorn-test

Formatting

To format the Rust code of both DNAs

nix-shell --run acorn-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/acorn_projects/code/Cargo.toml and dnas/profiles/zomes/acorn_profiles/code/Cargo.toml, and then run nix-shell --run acorn-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.