Skip to content

Wealize/lacchain-ssi-api

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Deploy SSI API

This tutorial describes the steps to deploy the Self-Sovereign API REST that allows to build a Blockchain-based Root-of-Trust and issue/revoke/verify Verifiable Credentials: Below you will find a set of tutorials that explore all the possibilities using this API.

  1. Generate a new DID
  2. Register an X.509 RSA certificate to a DID
  3. Deploy a regional Public Key Directory (PKD)
  4. Deploy a national Trusted List (TL)
  5. Register a TL in a PKD
  6. Register an Entity in a TL
  7. Revoke a TL in a PKD
  8. Revoke an Entity in a TL
  9. Issue a Verifiable Credential
  10. Verify a Verifiable Credential
  11. Revoke a Verifiable Credential

Pre-requisites

  • NodeJS: =v14.4.0
  • MongoDB: >v4.0
  • Docker: >v4.8 (Optional for that deploy method)

Deploy from source code

1. Clone repository

In order to deploy the API from source code it is necessary to clone the repository executing the following command:

git clone https://github.com/lacchain/ssi-api

The output of the command should download the source code in the ssi-api folder from the repository, as shown in the following image:

Clone SSI API

1. Install NodeJS version 14.4

The API is developed in version 14.4 of Node JS. To install this version it is recommended to use the NVM version manager, executing the following command:

nvm use 14.4

Clone SSI API

3. Configure API

Note: This tutorial assumes that you already have the MongoDB installed and running in the localhost at 27017 port.

Set the environment variables (see Configuration):

export ACCOUNT_ADDRESS=0xdfeb89479ad22cf277b3e3100c128a0151e612cb
export ACCOUNT_PRIVATE_KEY=0a28986d50924c22fe1eb55b5ce6b351e2ff89216a78ad486e5bb8a129a68051
export ACCOUNT_PUBLIC_ENCRYPTION_KEY=0x9db1e671082908dbc5e5819b6dceb944f12ff927c6f3d64a4254bf7f2965b887
export ACCOUNT_PRIVATE_ENCRYPTION_KEY=a205ca50b424f17aa9e76d75b4a7e1fde75997d4c7e7bf14a03fdeb4b004a5039db1e671082908dbc5e5819b6dceb944f12ff927c6f3d64a4254bf7f2965b887

Now, it is necessary to install the dependencies executing the next command:

yarn install

yarn install

After doing that, just run the following command to start the server:

npm start

If everything goes correctly, the server will run at http://localhost:8080:

npm start

Deploy from Docker

There is a way to run the API server from Docker image, to do that you need first pull the image from the github registry:

docker pull ghcr.io/lacchain/ssi-api:latest

docker pull

Now you are ready to start the server, just specify the environment variables (see Configuration section) by execute the next command:

docker run -e ACCOUNT_ADDRESS=0xdfeb89479ad22cf277b3e3100c128a0151e612cb \
-e ACCOUNT\_PRIVATE\_KEY=0a28986d50924c22fe1eb55b5ce6b351e2ff89216a78ad486e5bb8a129a68051 \
-e ACCOUNT\_PUBLIC\_ENCRYPTION_KEY=0x9db1e671082908dbc5e5819b6dceb944f12ff927c6f3d64a4254bf7f2965b887 \
-e ACCOUNT\_PRIVATE\_ENCRYPTION_KEY=a205ca50b424f17aa9e76d75b4a7e1fde75997d4c7e7bf14a03fdeb4b004a5039db1e671082908dbc5e5819b6dceb944f12ff927c6f3d64a4254bf7f2965b887 \
-e MONGODB_URL=mongodb://host.docker.internal:27017/ssi-api \
-p 0.0.0.0:8080:8080/tcp \
ghcr.io/lacchain/ssi-api

Note: This tutorial assumes that you have installed MongoDB in the host at 8080 port.

The previous command will start and expose the SSI API at http://localhost:8080 url.

docker run

Swagger API

The full documentation of API is available in Swagger at http://localhost:8080.

swagger

Configuration variables

Environment Variable Default value Required Description
NETWORK_RPC https://writer.lacchain.net yes Besu node RPC url
NODE_ADDRESS no Node address (for LACChain Gas Model)
NODE_EXPIRATION no Expiration time (for LACChain Gas Model)
ACCOUNT_ADDRESS yes Account address that will act as sender of all transactions
ACCOUNT_PRIVATE_KEY yes Account private key that will sign transactions
ACCOUNT_PUBLIC_ENCRYPTION_KEY no (yes for issue VC) NaCl public key used to encrypt VC sent using DIDComm protocol in Mailbox (must be registered as keyAgreement Verification Method in the account address DID)
ACCOUNT_PRIVATE_ENCRYPTION_KEY no (yes for issue VC)
MONGODB_URL mongodb://localhost:27017/ssi-api yes
MAILBOX_DID did:lac:main:0x5c3968542ca976bec977270d3fe980dd4742865e no Mailbox DID, the default value is for Legacy Mailbox. For OpenProTest Newtwork use: did:lac:openprotest:0xf33bc23691245c2d5de99d7d45e9fdd113495870
NETWORK_NAME main no Network name used for DID suffix (i.e. did:lac:<network_name>). Default is main which points to Legacy Network. For OpenProTest Network use: openprotest

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%