Emerging Platform ITMO schema reference

The structure of an ITMO credential on the Emerging Platform: JSON-LD contexts, required types, credentialSubject sections and validation checks.

This page is the Emerging Platform reference for the structure of an ITMO credential: the contexts it must declare, the sections its subject carries, and the checks a verifier runs. Use it when you build or check an ITMO credential payload.

For the steps to issue ITMO credentials in a clean cooking programme, see Emerging Household Energy ITMO credentials. For how the two pages divide the topic, see Digital certification.

Base credential shape

Every ITMO credential declares the W3C credentials context, the Ed25519 2018 security suite, and the itmo and prov terms, and has the types VerifiableCredential and ITMOCredential.

Illustrative example: the issuer DID and date are placeholders.

{
  "@context": [
    "https://www.w3.org/2018/credentials/v1",
    "https://w3id.org/security/suites/ed25519-2018/v1",
    {
      "itmo": "https://w3id.org/article6/itmo-context.jsonld",
      "prov": "http://www.w3.org/ns/prov#"
    }
  ],
  "type": ["VerifiableCredential", "ITMOCredential"],
  "issuer": "did:example:issuer",
  "issuanceDate": "2024-03-15T00:00:00Z",
  "credentialSubject": {}
}

Credential subject sections

credentialSubject should include the ITMO sections your implementation uses:

  • authorizationInfo
  • ndcQuantification
  • correspondingAdjustments
  • environmentalIntegrity

Validation checks

KindCheck
TechnicalThe JSON-LD contexts resolve and are consistent
TechnicalRequired fields conform to the schema
TechnicalThe cryptographic proof verifies
TechnicalThe credential status is valid
BusinessThe required ITMO sections are present
BusinessParticipating parties and references are valid
BusinessAdjustment and integrity values are consistent with each other

A credential that passes these checks is well formed and signed by its issuer. It does not, on its own, prove that the mitigation outcome is real. See Trust boundaries.