Skip to content
This repository was archived by the owner on Nov 25, 2020. It is now read-only.
/ TheOrgBook Public archive

A public repository of verifiable claims about organizations. A key component of the Verifiable Organization Network.

License

Notifications You must be signed in to change notification settings

bcgov/TheOrgBook

Folders and files

NameName
Last commit message
Last commit date

Latest commit

f328926 · Nov 24, 2020
May 29, 2020
Feb 11, 2020
Sep 10, 2020
Sep 10, 2020
Jan 22, 2020
Nov 24, 2020
Jul 30, 2020
Sep 9, 2020
Jul 16, 2019
Jul 16, 2019
Nov 24, 2020
Oct 9, 2018
Jan 31, 2019
Feb 28, 2019
Sep 19, 2017
Apr 15, 2020
Sep 19, 2017
Nov 15, 2018
Jul 16, 2018
Nov 15, 2018
Jul 16, 2018
Nov 15, 2018
Sep 28, 2018
Nov 15, 2018
Sep 18, 2018
Sep 18, 2018
Jun 27, 2019
Aug 8, 2020
May 6, 2019
Jan 15, 2019
Oct 26, 2018
Oct 19, 2018
Oct 26, 2018
Oct 26, 2018
Oct 15, 2017
Aug 20, 2019

Repository files navigation

License

SonarQube Results:

Bugs Vulnerabilities Code smells Coverage Duplication Lines of code

Zap Results:

Bugs Vulnerabilities Code smells

TheOrgBook is now Aries Verifiable Credential Registry

OrgBook BC is a deployment of an underlying software component called a Verifiable Credential Registry (VCR). A VCR is more general component that can drive OrgBooks (repositories of information about registered organizations), and other repositories of verifiable information across a variety of use cases, including education, government services, public works projects and many more. The first generation of OrgBook BC was built on top of the software whose source code is in this repository. The current iteration of OrgBook BC is powered by the Aries Verifiable Credential Registry (VCR) (Aries VCR). TheOrgBook was implemented using custom protocols defined locally by the Verifiable Organizations Network (VON) team here in BC, Aries VCR is based on Hyperledger Aries protocols defined by a global community at the Linux Foundation.

If you are interested in deploying your own OrgBook (perhaps for another jurisdiction), or learning about the internals of Verifiable Credential Registries, please start with the latest and greatest code in the Aries VCR open source repository.

If you are just interested in running the Greenlight demo to get a feel of how OrgBooks work at the user interface level, feel free to use this repository—instructions are below. We recommend that you don't build on top of the code in this repo. Stick to Aries VCR.

TheOrgBook

TheOrgBook is a Credential Registry of verifiable credentials about entities. A public instance of TheOrgBook, such as BC's OrgBook contains a verifiable credentials about organizations (incorporations, professionals, etc.) issued by trusted public services such as Corporate Registries, regulatory agencies, permitting services, licencing services, procurement services and the like.

The Verifiable Organizations Network (VON) envisions the possibility of a number of public repositories of Verifiable Claims as a way of bootstrapping a trusted digital ecosystem.

TheOrgBook is being developed as part of the Verifiable Organizations Network (VON). For more information on VON see https://vonx.io. Even, better - join in with what we are doing and contribute to VON and the Indy community.

Quick Start Guide

The best way to get started with a new project is by working with a running instance. The VON Quick Start Guide will get you started with an Indy Network, an instance of TheOrgBook (this repo) and an instance of GreenLight running on your local machine in Docker. Give it a try!

OrgBook provides a set of RESTful web services you can use to query data from your third-party application, an introduction to use of these API's is available here.

Running TheOrgBook on OpenShift

To deploy TheOrgBook on a local instance of OpenShift, refer to Running TheOrgBook Locally on OpenShift. These instructions, apart from the steps that are specific to setting up your local environment, can also be used to get the project deployed to a production OpenShift environment.

Running TheOrgBook on Docker

The project can also be run locally using Docker and Docker Compose. Refer to Running TheOrgBook with Docker Compose for instructions.

Resetting the Ledger

For information on the process of resetting the ledger and wallets refer to the Resetting the Ledger and Wallets documentation.