@holochain/conductor-api

holochain/conductor-api

License:

A nodejs implementation of the Holochain conductor API.

Install

To install from NPM, run

npm install --save-exact @holochain/conductor-api

Note, this code is still under alpha development and npm releases are pre-releases with dev tags meaning they will not use full semantic versioning, and you may wish to lock to an exact version of the library for that reason, as shown in the above command.

Holochain Compatibility

This version of holochain-conductor-api is currently working with holochain/holochain at commit:

2dfe85db10a5d9ba3ee25ff33f4bedb1a28f875f (Nov 16, 2020)

If updating this code, please make changes to the git rev/sha in 3 places:

1. Here in the README above ^^
2. This line in install-holochain.sh

REV=2dfe85db10a5d9ba3ee25ff33f4bedb1a28f875f

1. and this line in test/e2e/fixtures/zomes/foo/Cargo.toml

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

Notice the match between the SHA in both cases. These should always match.

Running tests

You need a version (stable toolchain) of Rust available.

You would need holochain and dna-util on your path, best to use the specific versions that this code requires. To use cargo to install them, run:

./install-holochain.sh

To perform the pre-requisite DNA compilation steps, and run the nodejs test, run:

./run-test.sh

Contribute

Holochain is an open source project. We welcome all sorts of participation and are actively working on increasing surface area to accept it. Please see our contributing guidelines for our general practices and protocols on participating in the community, as well as specific expectations around things like code formatting, testing practices, continuous integration, etc.

• Connect with us on our forum

License

Copyright (C) 2020, Holochain Foundation

This program is free software: you can redistribute it and/or modify it under the terms of the license provided in the LICENSE file (CAL-1.0). This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.