happ-0.1.0-beta

0.1.0-beta "Sapling" Release Notes

This marks the first minimum-viable, feature-complete release with a stable externally-facing API. It includes all changes and learnings from previous alpha releases over ~3 years of development to align with Holochain app best-practises and the current almost-beta version of Holochain core.

Documention for integrators (and explorers) can be found here: docs.hrea.io.

The following modules have been implemented with baseline editing, querying & listing functionality adhering to the Valueflows specification:

• Agent, including single and group agent profiles
• Observation data for economic event ledgers, resource accounting and process management
• Planning functionality for managing intended outcomes, committed actions and the satisfaction & fulfillment thereof
• Agreement management for recording & tracking agreements between peers in an economic network
• Proposal affords the ability for agents to make offers, requests and interlinked agreements with each other, which may lead to commitments to do work together
• Plan management for higher-order grouping of process & commitment workflows into related units of work
• Specification definition functionality for describing types of processes, resources, measurement units and economic event actions

For a complete list of specific methods and properties which reveals their implementation status, you can see that in a complete list here or in a per module breakdown here.

This release also includes the bundled GraphiQL explorer as a *.webhapp file suitable for installation into the Holochain launcher. Since this release is largely an infrastructural milestone intended for user-facing applications to be built on top of, other general-purpose applications are yet to be bundled and will be made available in future versions.

Integrators should note that although API signatures are intended to remain stable well into the future, there are some planned changes to the internal data architecture that will necessitate wiping or migrating your Holochain datastores in the next release.

Holochain Version Compatibility

holochain 0.0.162
hc 0.0.57
hdk 0.0.152
hdi 0.1.2
lair-keystore 0.2.0

Important! Data Privacy

Note, unless you have zero concern for the data you may enter into hREA, you should be aware that data will be shared by default across the whole network of peers who install it. The way that you can, and likely should, avoid this is by providing a 'network seed' during installation of the hApp. In the Holochain Launcher, you do this by expanding the 'advanced' options during installation, and writing an unguessable phrase into the 'network seed' text input.

Any random or only known to you string of characters will do. You can consider it similar to a password to your data, which could also allow you to invite others to share that data with you by entering the same one.