OpenCerts Transcripts

In order to create valid OpenCerts transcripts, you need to adhere to the OpenCerts Schema. In this guide, we will explore how to do it.

Prerequisite

  • Create the following folders:
    • opencerts-transcripts
    • opencerts-transcripts/unwrapped
mkdir -p opencerts-transcripts/unwrapped
  • Download open-attestation-cli for your platform and move it to the previously created opencerts-transcripts folder under the name open-attestation (don't forget to correctly set the permissions).

For the rest of this guide, we will assume that every action occur from the opencerts-transcripts folder

Wrapping OpenCerts document

In order to generate wrapped documents, we will use the wrap method from the CLI. This method expects 2 arguments: one folder containing the unwrapped documents, and one folder that it will generate the wrapped documents to:

./open-attestation wrap <path_to_unwrapped_documents_folder> <path_to_generated_wrapped_document_folder>

In addition, we will use the --schema option to ensure that our documents are valid OpenCerts documents.

./open-attestation wrap <path_to_unwrapped_documents_folder> <path_to_generated_wrapped_document_folder> --schema <url_to_schema>

Creating unwrapped document

Create a document called opencerts.json in the unwrapped folder with the following content:

{
  "id": "53b75bbe",
  "name": "Govtech Demo Certificate",
  "description": "Govtech Demo Certificate",
  "issuedOn": "2019-05-29T00:00:00+08:00",
  "admissionDate": "2017-08-01T00:00:00+08:00",
  "graduationDate": "2022-08-01T00:00:00+08:00",
  "$template": {
    "name": "GOVTECH_DEMO",
    "type": "EMBEDDED_RENDERER",
    "url": "https://demo-renderer.opencerts.io"
  },
  "issuers": [
    {
      "name": "Govtech",
      "url": "https://tech.gov.sg",
      "documentStore": "0x007d40224f6562461633ccfbaffd359ebb2fc9ba",
      "identityProof": {
        "type": "DNS-TXT",
        "location": "demo.openattestation.com"
      }
    }
  ],
  "recipient": {
    "name": "Your Name",
    "nric": "SXXXXXXXY",
    "course": "Govtech Demo"
  },
  "transcript": [
    {
      "name": "Introduction to Programming",
      "grade": "A+",
      "courseCredit": "3",
      "courseCode": "CS 1110",
      "examinationDate": "2017-12-01T00:00:00+08:00",
      "semester": "1"
    },
    {
      "name": "Object Oriented Programming in Java",
      "grade": "A+",
      "courseCredit": "4",
      "courseCode": "CS 2110",
      "examinationDate": "2017-12-01T00:00:00+08:00",
      "semester": "1"
    },
    {
      "name": "Microeconomics",
      "grade": "A+",
      "courseCredit": "4",
      "courseCode": "ECON 3030",
      "examinationDate": "2018-05-01T00:00:00+08:00",
      "semester": "2"
    },
    {
      "name": "Macroeconomics",
      "grade": "A",
      "courseCredit": "4",
      "courseCode": "ECON 3040",
      "examinationDate": "2018-05-01T00:00:00+08:00",
      "semester": "2"
    },
    {
      "name": "Econometrics",
      "grade": "A-",
      "courseCredit": "4",
      "courseCode": "ECON 3120",
      "examinationDate": "2018-05-01T00:00:00+08:00",
      "semester": "2"
    }
  ],
  "additionalData": {
    "merit": "Y",
    "studentId": "123456",
    "transcriptId": "001"
  }
}

Don't forget to replace $template.url, issuers[0].documentStore and issuers[0].documentStore.identityProof.location as explained in OpenAttestation documentation

Generating wrapped document

Let's run the cli over the document:

❯  ./open-attestation wrap unwrapped wrapped --schema https://schema.opencerts.io/transcripts/2.0
✔  success   Batch Document Root: 0xc5507674eb34c36343d0da6a79a76c7967c5f3b1f7642c74ea822e7cff1b8a69
  • unwrapped is a path parameter that points to the folder containing your unwrapped documents.

🎉 Congratulations! You successfully created your first valid OpenCerts document which is available is the wrapped folder. Feel free to explore the schema to check how to create valid OpenCerts document with the data you would like to fit in.

The rest of the process to issue your document is as explained in OpenAttestation documentation.

Additional information

  • Full documentation about the CLI is available on Github
← Getting startedRegistry →