SSI medical prescriptions demo

Web application demonstrating usage of self-sovereign identity principles for issuance and verification of medical prescriptions.

The application is based on aries-framework-go and cheqd-node. It uses W3C verifiable credentials and Hyperledger Aries Issuance and Presentation protocols over DIDComm.

Demo server

Build demo server

make demo-server

Build af-go rest agent docker image

1. Configure af-go version for the image

   ARIES_AGENT_IMAGE_NAME 	?= aries-agent
   ARIES_AGENT_IMAGE_TAG	?= latest
   ARIES_FRAMEWORK_GO_REPO ?= https://github.com/DSRCorporation/aries-framework-go.git
   ARIES_FRAMEWORK_GO_REPO_BRANCH ?= <branch-or-tag>

2. Build docker image

   make aries-agent-docker

• docker image will be tagged as aries-agent:latest

Build demo server docker image

1. Build docker image

   make demo-server-docker

• docker image will be tagged as demo-server:latest

Run demo server and swagger ui using docker

1. Run demo server

   make run-demo-server
   

   • Demo server api will be available at http://localhost:8888
   • OpenAPI will be available at http://localhost:8889/openapi
   • To create DIDs and add private keys to wallet manually follow how-to-add-dids-manually.md

2. Stop demo server

   make stop-demo-server

Mock server

Generate stubs from openapi specs

1. Install oapi-codegen:

   go install github.com/deepmap/oapi-codegen/cmd/oapi-codegen@latest

   export PATH=$PATH:$HOME/go/bin

2. Generate mock stubs for openapi specs

   oapi-codegen -package rest ./api/openapi-spec/openapi.yml > internal/controller/rest/ssimp_rest.gen.go

Build mock server

make mock-server

Run mock server and swagger ui using docker

1. Run mock server container

   make run-mock-server
   

   • Mock server api will be available at http://localhost:8989
   • OpenAPI will be available at http://localhost:8889/openapi

2. Stop mock server

   make stop-mock-server

Test

Run unit tests

make run-unit-tests

Run integration tests

1. Run demo-server
2. Run integration tests

   make run-integration-tests

Components

• aries-framework-go framework is used as an underlying verifiable credential engine
• cheqd ledger is used to store and resolve Decentralized Identifiers (DIDs)

Architecture