cert-schema

Blockchain Certificate schemas implement those of Verifiable Credentials. As with Verifiable Credentials, we've provided both a JSON-LD context and JSON schema. The purpose of the JSON-LD context is to map types to Internationalized Resource Identifiers (IRIs), providing semantic context for data. The JSON Schema is used for syntactic validation.

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

Blockcerts JSON Schema

Example

TODO update for V3 once cert-issuer issues one

The following is a Blockchain Certificate issued on the testnet Bitcoin network.

{
  "@context": [
    "https://www.w3.org/2018/credentials/v1",
    "https://www.blockcerts.org/schema/3.0-alpha/context.json",
    "https://www.w3.org/2018/credentials/examples/v1"
  ],
  "id": "urn:uuid:bbba8553-8ec1-445f-82c9-a57251dd731c",
  "type": [
    "VerifiableCredential"
  ],
  "issuer": "did:example:23adb1f712ebc6f1c276eba4dfa",
  "issuanceDate": "2010-01-01T19:73:24Z",
  "credentialSubject": {
    "id": "did:example:ebfeb1f712ebc6f1c276e12ec21",
    "alumniOf": {
      "id": "did:example:c276e12ec21ebfeb1f712ebc6f1"
    }
  },
  "signature": {
    "type": "MerkleProof2019",
    "created": "2020-01-21T12:32:11.693759",
    "proofValue": "z2LuLBVSfnVzaQtvzuA7EaPQsGEgYWeaMTH1p3uqAG3ESx9HYyFzFFrYsyPkZSbn1Ji5LN76jw6HBr3oiaa8KsQenCPqKk7dJvxEXsDnYvhuDHtsrSRbzHdJKd66jAowkzPxPFi3ivyAv7WRK1WV2VhegYVQEnCBTrGJWFUMFFXunTcus7ZyedQvS4sr61X2y8QuJ57ycB5JMEHvUgAVq3qh2g3ucehg2ERKLo98jmqTcsh9HThkECG3BTNYRD3QL7AHWPjxRbQNSA83QNYXcCNA7NaZnCWyjC17ZBj3xszp76XvqFRrLjQbRSbzjVTPtBSV8QjhxThT3KTfgwjRn5JeeXhYvebsTT9YGL3W4ufzFRDpH79n5KPiaj1BPbEUfUq7vf2dg26QWeZBi7ME56",
    "proofPurpose": "assertionMethod",
    "verificationMethod": "ecdsa-koblitz-pubkey:0x7e30a37763e6Ba1fFeDE1750bBeFB4c60b17a1B3"
  }
}

Publishing package to pypi

First time info
Publish script: ./release_package.sh

Unit tests

This project uses tox to validate against several python environments.

Ensure you have an python environment. Recommendations
Run tests
```
./run_tests.sh
```

Compile markdown from schema

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

Metadata

Release files for cert-schema 3.10.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cert-schema 3.10.0
File	Size	Uploaded
cert_schema-3.10.0.tar.gz	58.6 kB	Jul 31, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for cert-schema 3.10.0
File	Interpreter	ABI	Platform	Reset
cert_schema-3.10.0-py3-none-any.whl 86.5 kB Jul 31, 2025	Python 3	none	any	Details

Total release size: 145.1 kB

Release files / cert_schema-3.10.0.tar.gz

Download URL	cert_schema-3.10.0.tar.gz
Size	58.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`305af92f0dc29ab0b4a25c5146a1f9d800f6ceee67923b96064de9a44532224e`
BLAKE2b-256 checksum How to use checksums	`f1a7f2bd7fd1eced2ca85b18397fcf7174b644c468fcaa0290677789ed68ed86`
Upload date	Jul 31, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.10.18`

Release files / cert_schema-3.10.0-py3-none-any.whl

Download URL	cert_schema-3.10.0-py3-none-any.whl
Size	86.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`cddfcbee89535aa4956d04ee2062648f79fdfb60856a3f1d9601af42b8ddcf7d`
BLAKE2b-256 checksum How to use checksums	`4f35b29ba068ffd5b25cec0024bee2242c1540a07a00869bb2c226f24ed80c01`
Upload date	Jul 31, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.10.18`