Skip to content

dhealthproject/dapps-framework

Repository files navigation

dHealth dApps Framework

lerna License Discord In progress

dHealth dApps Framework for dHealth Network.

NOTE: The author(s) and contributor(s) of this package cannot be held responsible for any loss of money or for any malintentioned usage forms of this package. Please use this package with caution.

Concepts

This framework aims to make it easier to access dHealth Network features and to develop dApps with dHealth Network.

This software package includes multiple libraries and runtimes that can be configured separately and that can be extended and modified freely.

Scopes

In the source code of this framework, you will find several feature scopes that are separately implemented and that can be enabled/disabled by configuration.

Following scopes are defined with their respective description:

Scope Documentation Description
common AppModule Contains source code that is shared amongst all dApps.
discovery DiscoveryModule Contains source code for the discovery of entities on dHealth Network, e.g. Transactions, Accounts, Blocks, etc.
notifier NotifierModule Contains source code to enable maintenance notifications that are sent out per email to the team in the case of errors or warnings.
payout PayoutModule Contains source code for the payout of tokens on dHealth Network. Payouts can be configured to work with any mosaic on dHealth Network.
processor ProcessorModule Contains source code for the processor of entities on dHealth Network. The implementation stores operations after reading transactions.
statistics StatisticsModule Contains source code for the aggregate of data related to a dApp.

CAUTION: The above feature scopes may be modified in the near- to mid-future, as we are discovering more use for some of the listed feature scopes.

Runtimes

Our dapps-framework comes with batteries included! In fact, this framework includes several so-called runtimes that can be configured independently and libraries that offer several focussed feature sets. Following are the currently available runtimes:

Path Package Documentation Description
runtime/backend @dhealthdapps/backend Reference documentation A NestJS backend for development of dApps with dHealth Network.
runtime/dapp-frontend-vue @dhealthdapps/frontend Reference documentation A VueJS frontend for development of dApps with dHealth Network.

Libraries

Our dapps-framework also includes re-usable libraries for Typescript and Javascript developers! These libraries offer several focussed feature sets. Following are the currently available libraries:

Path Package Documentation Description
libraries/contracts @dhealth/contracts Reference documentation A library for creating smart contracts compatible with this software package.
libraries/ui-components @dhealth/components Reference documentation A library of Components available for re-use that feature some of the utilites as displayed on the Frontend Runtime.

Developer notes

As a developer, you may install lerna globally on your machine with: npm install -g lerna ; or you can also use this package's local lerna installation using npx lerna.

Following command installs all sub-project dependencies (local and remote):

lerna bootstrap

Please read the INSTALL NOTES to find out more about how to run this software in development and production environments.

Building packages

Using lerna instead of npm, scripts will run directly inside all packages (use --parallel for parallel execution). If using npm or yarn, use the scripts as provided in package.json.

lerna run lint --stream
lerna run build --stream
lerna run test --stream
lerna run docs --stream

Note that we recommend using the --stream flag to stream logs without delay. Note also that we recommend using the --scope argument using one of the following package identifiers to optimize the building and testing process:

  • @dhealth/contract: Build, test or generate documentation for the Contracts library.
  • @dhealth/components: Build, test or generate documentation for the Components library.
  • @dhealthdapps/backend: Build, test or generate documentation for the Backend runtime.
  • @dhealthdapps/frontend: Build, test or generate documentation for the Backend runtime.

i.e. Following commands are recommended and apply for developers that aim to build-, test- or generate documentation for this software package:

# Build, test and generate docs for Contracts Library
lerna run lint --stream --scope @dhealth/contracts
lerna run build --stream --scope @dhealth/contracts
lerna run test --stream --scope @dhealth/contracts
lerna run docs --stream --scope @dhealth/contracts

# Build, test and generate docs for Components Library
lerna run lint --stream --scope @dhealth/components
lerna run build --stream --scope @dhealth/components
lerna run test --stream --scope @dhealth/components
lerna run docs --stream --scope @dhealth/components

# Build, test and generate docs for Backend Runtime
lerna run lint --stream --scope @dhealthdapps/backend
lerna run build --stream --scope @dhealthdapps/backend
lerna run test --stream --scope @dhealthdapps/backend
lerna run docs --stream --scope @dhealthdapps/backend

# Build, test and generate docs for Frontend Runtime
lerna run lint --stream --scope @dhealthdapps/frontend
lerna run build --stream --scope @dhealthdapps/frontend
lerna run test --stream --scope @dhealthdapps/frontend
lerna run docs --stream --scope @dhealthdapps/frontend

Running individual package scripts

e.g. If you want to run the serve script inside the package.json of @dhealthdapps/backend, use the following command:

# run in one package
lerna run serve --scope @dhealthdapps/backend --stream

# or run in all packages
lerna run serve --stream

Getting help

Use the following available resources to get help:

Contributing

Contributions are welcome and appreciated. Check CONTRIBUTING for information on how to contribute.

License

Copyright 2022-present dHealth Network, All rights reserved.

Licensed under the LGPL v3.0