Verifiable Credentials using the Everscale SDK

SDK for creating, signing and verifying Verifiable Credentials(VC) and Verifiable Presentation(VP) using JavaScript

Table of Contents

• Install

• Description

• Security

• Specification

• Contracts

• Quick start

Install

Requires Node.js to work

Enter commands to install SDK

npm install everscale-vc-sdk-radiance

Description

JavaScript SDK that allows you to work with Verifiable Credentials(VC) and Verifiable Presentation(VP) developed according to the Verifiable Credentials Data Model v1.1 specification and uses the Everscale blockchain to store the user's status and store the VC.

The main functionality that our SDK provides:

1. Signature (issuance) of Verifiable Credentials (VC).
2. Creation of Verifiable Presentation (VP), with and without a signature.
3. Verification of Verifiable Credentials(VC)
4. Verification of Verifiable Presentation(VP).
5. Create a credentialStatus and look it up on the Everscale blockchain.
6. Storing Verifiable Credentials(VC) by the holder on the Everscale blockchain.

Security

The basic security of your system depends on your own decisions (where do you store your private keys, what you put in the IDs, etc.). The security of storage in the Everscale Verifiable Credentials (VC) blockchain is carried out by data encryption and Everscale.

Specification

Description of all sdk functions by modules

• moduleVC
• moduleVP
• moduleEver

Contracts

smart-contracts

Addresses for the ResolverContract contract:

0:904bfbc6681f1fdf884e558e1e1634615eba657dd7227c5bd37ea8b428b7c62a - main.ton.dev

0:a867a0dd47aa4f3145e3438e38fdbcb9548feb8c13387da2bdd0343b7ea9b4cb - net.ton.dev

Quick start

Issuing a Verifiable Credentials(VC)

Function signs and issues Verifiable Credentials Accepts:

1. credential - unsigned credentials
2. secretKey - secret key of the issuer

const vc = require('everscale-vc-sdk-radiance')


const credential = {
    "@context": [
        "https://www.w3.org/2018/credentials/v1",
        "https://www.w3.org/2018/credentials/examples/v1"
    ],
    "id": "https://example.com/credentials/1872",
    "type": ["VerifiableCredential", "AlumniCredential"],
    "issuer": "did:everscale:a341b9ab6235a525cb59192c7a1c7637599d01d3e3a8a76a6dc86ed53a0cf260",
    "issuanceDate": "2010-01-01T19:23:24Z",
    "credentialSubject": {
        "id": "did:everscale:47325e80e3cef5922d3a3583ae5c405ded7bda781cb069f2bc932a6c3d6ec62e",
        "alumniOf": "Example University"
    }
}

const secretKey = "7e8b57b7e7519ae5cbce869311d6c824c7a113e4e3d4ca6e929e488e66442faa"

vc.moduleVC.issueVC(credential, secretKey).then((data) => {
    console.log(JSON.stringify(data, null, 2))
})

Creating a Verifiable Presentation(VP)

Creating a Verifiable Presentation (VP) is divided into 2 parts:

• Creating a presentation without a signature
• Signature presentation

Creating an unsigned presentation

Accepts:

1. verifiableCredential - one or more Verifiable Credentials(VC)
2. id - is optional and can be used as a unique identifier for Verifiable Presentation(VP)
3. holder - is optional, but if present must be the URI of the object that creates the Verifiable Presentation(VP)

const vc = require('everscale-vc-sdk-radiance')

const verifiableCredential = {
  "@context": [
    "https://www.w3.org/2018/credentials/v1",        
    "https://www.w3.org/2018/credentials/examples/v1"
  ],
  "id": "https://example.com/credentials/1872",      
  "type": [
    "VerifiableCredential",
    "AlumniCredential"
  ],
  "issuer": "did:everscale:a341b9ab6235a525cb59192c7a1c7637599d01d3e3a8a76a6dc86ed53a0cf260",
  "issuanceDate": "2010-01-01T19:23:24Z",
  "credentialSubject": {
    "id": "did:everscale:47325e80e3cef5922d3a3583ae5c405ded7bda781cb069f2bc932a6c3d6ec62e",
    "alumniOf": "Example University"
  },
  "proof": {
    "type": "Ed25519Signature2020",
    "created": "2022-05-05T06:48:08.658Z",
    "verificationMethod": "did:everscale:a341b9ab6235a525cb59192c7a1c7637599d01d3e3a8a76a6dc86ed53a0cf260",
    "proofPurpose": "assertionMethod",
    "proofValue": "1dd750eb48f71da5d0ddf1562daa9d815619e9a08f6067a908f654241383ee1aed0e35e85e6fc141c670819d7e445fc105dd387cfcc855f304b48e536242c208"
  }
}

const id = "12332"
const holder = "did:everscale:47325e80e3cef5922d3a3583ae5c405ded7bda781cb069f2bc932a6c3d6ec62e"

vc.moduleVP.createPresentation(verifiableCredential, id, holder).then((data) => {
    console.log(JSON.stringify(data, null, 2))
})

Signature presentation

Accepts:

1. presentation - the presentation created above
2. issuerDID - URI that leads to the signer's verification method
3. secretKey - secret key by which the presentation will be signed

const vc = require('everscale-vc-sdk-radiance')

const presentation = {
  "@context": [
    "https://www.w3.org/2018/credentials/v1"
  ],
  "type": [
    "VerifiablePresentation"
  ],
  "verifiableCredential": [
    {
      "@context": [
        "https://www.w3.org/2018/credentials/v1",        
        "https://www.w3.org/2018/credentials/examples/v1"
      ],
      "id": "https://example.com/credentials/1872",      
      "type": [
        "VerifiableCredential",
        "AlumniCredential"
      ],
      "issuer": "did:everscale:a341b9ab6235a525cb59192c7a1c7637599d01d3e3a8a76a6dc86ed53a0cf260",
      "issuanceDate": "2010-01-01T19:23:24Z",
      "credentialSubject": {
        "id": "did:everscale:47325e80e3cef5922d3a3583ae5c405ded7bda781cb069f2bc932a6c3d6ec62e",
        "alumniOf": "Example University"
      },
      "proof": {
        "type": "Ed25519Signature2020",
        "created": "2022-05-05T06:48:08.658Z",
        "verificationMethod": "did:everscale:a341b9ab6235a525cb59192c7a1c7637599d01d3e3a8a76a6dc86ed53a0cf260",
        "proofPurpose": "assertionMethod",
        "proofValue": "1dd750eb48f71da5d0ddf1562daa9d815619e9a08f6067a908f654241383ee1aed0e35e85e6fc141c670819d7e445fc105dd387cfcc855f304b48e536242c208"
      }
    }
  ],
  "id": "12332",
  "holder": "did:everscale:47325e80e3cef5922d3a3583ae5c405ded7bda781cb069f2bc932a6c3d6ec62e"
}

const issuerDID = "did:everscale:7fbf2d23174967c903adef03075f482798f24d5693d05cb65345b3e5ff7e2d89"
const secretKey = "e99ea25d95f8015f86aede1acebc09addd4cff2656cf3f443032e9af2c5de421"

vc.moduleVP.signPresentation(presentation, issuerDID, secretKey).then((data) => {
    console.log(JSON.stringify(data, null, 2))
})

Verify of Verifiable Credentials(VC)

Accepts:

1. VC - Verifiable Credentials
2. publicKey - public key of the issuer

const vc = require('everscale-vc-sdk-radiance')

const VC = {
  "@context": [
    "https://www.w3.org/2018/credentials/v1",        
    "https://www.w3.org/2018/credentials/examples/v1"
  ],
  "id": "https://example.com/credentials/1872",      
  "type": [
    "VerifiableCredential",
    "AlumniCredential"
  ],
  "issuer": "did:everscale:a341b9ab6235a525cb59192c7a1c7637599d01d3e3a8a76a6dc86ed53a0cf260",
  "issuanceDate": "2010-01-01T19:23:24Z",
  "credentialSubject": {
    "id": "did:everscale:47325e80e3cef5922d3a3583ae5c405ded7bda781cb069f2bc932a6c3d6ec62e",
    "alumniOf": "Example University"
  },
  "proof": {
    "type": "Ed25519Signature2020",
    "created": "2022-05-05T06:48:08.658Z",
    "verificationMethod": "did:everscale:a341b9ab6235a525cb59192c7a1c7637599d01d3e3a8a76a6dc86ed53a0cf260",
    "proofPurpose": "assertionMethod",
    "proofValue": "1dd750eb48f71da5d0ddf1562daa9d815619e9a08f6067a908f654241383ee1aed0e35e85e6fc141c670819d7e445fc105dd387cfcc855f304b48e536242c208"
  }
}

const publicKey = "a341b9ab6235a525cb59192c7a1c7637599d01d3e3a8a76a6dc86ed53a0cf260"

vc.moduleVC.verifyVC(VC, publicKey).then(console.log)

Verify of Verifiable Presentation(VP)

Accepts:

1. verifiablePresentation - Verifiable Presentation(VP)
2. publicKey - the public key of the signer

const vc = require('everscale-vc-sdk-radiance')

const verifiablePresentation = {
  "@context": [
    "https://www.w3.org/2018/credentials/v1"
  ],
  "type": [
    "VerifiablePresentation"
  ],
  "verifiableCredential": [
    {
      "@context": [
        "https://www.w3.org/2018/credentials/v1",
        "https://www.w3.org/2018/credentials/examples/v1"
      ],
      "id": "https://example.com/credentials/1872",
      "type": [
        "VerifiableCredential",
        "AlumniCredential"
      ],
      "issuer": "did:everscale:a341b9ab6235a525cb59192c7a1c7637599d01d3e3a8a76a6dc86ed53a0cf260",
      "issuanceDate": "2010-01-01T19:23:24Z",
      "credentialSubject": {
        "id": "did:everscale:47325e80e3cef5922d3a3583ae5c405ded7bda781cb069f2bc932a6c3d6ec62e",
        "alumniOf": "Example University"
      },
      "proof": {
        "type": "Ed25519Signature2020",
        "created": "2022-05-05T06:48:08.658Z",
        "verificationMethod": "did:everscale:a341b9ab6235a525cb59192c7a1c7637599d01d3e3a8a76a6dc86ed53a0cf260",
        "proofPurpose": "assertionMethod",
        "proofValue": "1dd750eb48f71da5d0ddf1562daa9d815619e9a08f6067a908f654241383ee1aed0e35e85e6fc141c670819d7e445fc105dd387cfcc855f304b48e536242c208"
      }
    }
  ],
  "id": "12332",
  "holder": "did:everscale:47325e80e3cef5922d3a3583ae5c405ded7bda781cb069f2bc932a6c3d6ec62e",
  "proof": {
    "type": "Ed25519Signature2020",
    "created": "2022-05-05T07:09:58.939Z",
    "verificationMethod": "did:everscale:7fbf2d23174967c903adef03075f482798f24d5693d05cb65345b3e5ff7e2d89",
    "proofPurpose": "assertionMethod",
    "proofValue": "fe2101dc2da954413bc69e0f35cf2e2fef633d52d401389292459398c3e53d475c63c09ac953b09f8e6b2b0c59ca4103d9502870b5449bf114f8924e4d65bf07"
  }
}

const publicKey = "7fbf2d23174967c903adef03075f482798f24d5693d05cb65345b3e5ff7e2d89"

vc.moduleVP.verifyPresentation(verifiablePresentation, publicKey).then(console.log)

createStatus

Accepts: statusVCRoot - The Account created with the tonclient/appkit contract that issues the status userAccount - Account from which the transaction will be made holder - VC holder address for which the status is being created

const { TonClient, signerKeys, signerNone } = require('@eversdk/core')
const { libNode } = require('@eversdk/lib-node')
const { Account } = require('@eversdk/appkit')
const vc = require('everscale-vc-sdk-radiance')
const { ClientContract } = require('everscale-vc-sdk-radiance/src/build/ClientContract')
const { StatusVCRootContract } = require('everscale-vc-sdk-radiance/src/build/StatusVCRootContract')

TonClient.useBinaryLibrary(libNode)

const client = new TonClient({
  network: {
    endpoints: ["net.ton.dev"]
  }
})

const statusRoot = new Account(StatusVCRootContract, {
  address: "0:3c09dbbc7a3aa9cb1cae3b307a063cf111e38166d7dd1940bed083ce4dce8228",
  client: client
})

const issuer = new Account(ClientContract, {
  address: "0:9f918cb6c22d28e82ebb57c79fbbbde00318b6402024d33895ccd5256806a245",
  signer: signerKeys({
      public: 'a1d6d37f31b71c570f8c78d06c955719a7194f23b203851a8be8ea82c9f4035d',
      secret: '3b61258adaada3a048513bbb54c658dc3a656bdaffb391c057196476da5f4e04'
  }),
  client: client
})

const holder = "47325e80e3cef5922d3a3583ae5c405ded7bda781cb069f2bc932a6c3d6ec62e"


vc.moduleEver.createStatus(statusRoot, issuer, holder).then(console.log)

storage Verifiable Credentials(VC) in the Evrescale blockchain

A contract was specifically created to store data in the blockchain, but you can’t just store Verifiable Credentials (VC) in a contract. To protect it, we will encrypt the VC and then enter it into the contract.

const vc = require('everscale-vc-sdk-radiance')
const { ClientContract } = require('everscale-vc-sdk-radiance/src/build/ClientContract')
const { TonClient, signerKeys, signerNone } = require('@eversdk/core')
const { libNode } = require('@eversdk/lib-node')
const { Account } = require('@eversdk/appkit')

TonClient.useBinaryLibrary(libNode)

const client = new TonClient({
  network: {
    endpoints: ["net.ton.dev"]
  }
})


const verifiableCredential = {
  "@context": [
    "https://www.w3.org/2018/credentials/v1",        
    "https://www.w3.org/2018/credentials/examples/v1"
  ],
  "id": "https://example.com/credentials/1872",      
  "type": [
    "VerifiableCredential",
    "AlumniCredential"
  ],
  "issuer": "did:everscale:a341b9ab6235a525cb59192c7a1c7637599d01d3e3a8a76a6dc86ed53a0cf260",
  "issuanceDate": "2010-01-01T19:23:24Z",
  "credentialSubject": {
    "id": "did:everscale:47325e80e3cef5922d3a3583ae5c405ded7bda781cb069f2bc932a6c3d6ec62e",
    "alumniOf": "Example University"
  },
  "proof": {
    "type": "Ed25519Signature2020",
    "created": "2022-05-05T06:48:08.658Z",
    "verificationMethod": "did:everscale:a341b9ab6235a525cb59192c7a1c7637599d01d3e3a8a76a6dc86ed53a0cf260",
    "proofPurpose": "assertionMethod",
    "proofValue": "1dd750eb48f71da5d0ddf1562daa9d815619e9a08f6067a908f654241383ee1aed0e35e85e6fc141c670819d7e445fc105dd387cfcc855f304b48e536242c208"
  }
}

const userAccount = new Account(ClientContract, {
  address: "0:1d1e24b5036dcbd810c76d7fe03697a992de332ff4436a79c563d27e62a61d87",
  signer: signerKeys({
    public: 'a8fea093d3ae5daab36cdc04bcc8685dce354195c5bbb16bebf771d0ef413bd6',
    secret: '7406c4501581667fa2d8b5d6f35b569dbb420cb1bacbdc9f0723e2f5f2d63ff2'
  }),
  client: client
})

var dataVC = await vc.moduleEver.newAddressVC(client)
      
  await userAccount.run("transfer", {
    dest: dataVC.address,
    value: 210000000
  })

  

  await moduleEver.deployVC(dataVC.address, dataVC.keys, client, await userAccount.getAddress(), "JSON", 
    await moduleVC.encryptVerifiableCredential(verifiableCredential, userAccount.signer.keys.secret)).then(console.log)