Koru
About
This is a prototype for Koru, a parametrized p2p monetary system consisting of:
- Mutual credit
- Voting and decision making platform (for economic governance)
- Open credit scoring (Reputation)
- Credit underwriting
- Fractional reserve and exchange service for fiat/crypto
to learn more checkout : https://koru.finance
Environment Setup
- Install the holochain dev environment (only nix-shell is required): https://developer.holochain.org/docs/install/
- Enable Holochain cachix with:
nix-env -iA cachix -f https://cachix.org/api/v1/install
cachix use holochain-ci
- Clone this repo and
cd
inside of it. - Enter the nix shell by running this in the root folder of the repository:
nix-shell
npm install
This will install all the needed dependencies in your local environment, including holochain
, hc
and npm
.
Building the DNA
- Build the DNA (assumes you are still in the nix shell for correct rust/cargo versions from step above):
npm run build:happ
Running the DNA tests
npm run test
Start
To run the built happ:
npm run start
This will spawn an orchestrator (API) and a UI. The network configuration is for local only. Production ready configuration with bootstrap server is not available yet.
Package
To package the web happ:
npm run package
You'll have the koru.webhapp
in workdir
. This is what you should distribute so that the Holochain Launcher can install it.
You will also have its subcomponent koru.happ
in the same folder`.
Documentation
We are using this tooling:
- NPM Workspaces: npm v7's built-in monorepo capabilities.
- hc: Holochain CLI to easily manage Holochain development instances.
- @holochain/tryorama: test framework.
- @holochain/conductor-api: client library to connect to Holochain from the UI.