The cert-schema project contains the Blockchain Certificate JSON schema and JSON LD specification. These are extensions to Open Badges schemas allowing the entire certificate contents to be registered and verified on a blockchain.

The cert-schema python package allows verification of a Blockchain Certificate against the JSON schemas. This is not the same as validating the contents of a certificate against what is stored on the blockchain. See the cert-verifier project.

In 1.2 we've added a JSON LD schema to provide semantically rich linked data.

Certificate JSON LD

• Blockchain Certificate JSON Schema
  • Certificate Document JSON Schema
    • Assertion JSON Schema
    • Certificate JSON Schema
      • Issuer JSON Schema
  • Blockchain Receipt JSON Schema
• Issuer Identification JSON Schema

1. Ensure you have an python environment. Recommendations

2. Git clone the repository and change to the directory

git clone https://github.com/blockchain-certificates/cert-schema.git && cd cert-schema

3. Run cert-schema setup

pip install .

• First time info
• Publish script: ./release_package.sh

This project uses tox to validate against several python environments.

1. Ensure you have an python environment. Recommendations

2. Run tests

   ./run_tests.sh
   

Note that json-schema-to-markdown doesn't handle ref schemas well, so you will need to manually update any 'undefined' references.

scripts/generate_markdown.js builds the markdown-formatted schemas from json

Contact info@blockcerts.org with questions