Skip to content

transcript-entry.md

Latest commit

 

History

History
60 lines (47 loc) · 1.63 KB

transcript-entry.md

File metadata and controls

60 lines (47 loc) · 1.63 KB

Transcript Entry

A transcript entry is a permanent record of a user's score for a single topic.

Required content

The following content must be included in each transcript entry.

  • User ID
  • Topic
  • TopicList + Version
  • Topic Score
  • Issued At
  • Issuer (domain name)
  • Certificate

Signed

All transcript entries are individually signed by the issuer to enable verification of scores.

  • Prevents tampering of records.
  • Prevents record loss if an issuer is no longer available.
  • Prevents record loss if an experience source is no longer available.

Distributable

All transcript entries are stored individually to enable selective sharing with desired parties.

  • Enables proficiency progress across multiple sources.
  • Enables storage of scores across multiple services.
  • Enables fine-grained privacy for sharing scores.
  • Prevents repeated learning of proficient topics.

Example

[
  {
    "userID": "fist.last@example.com",
    "topic": "addition",
    "topicList": "https://example.com/0.1.0/math.json",
    "score": "competent",
    "issued-at": "2026-01-01T01:01:01Z",
    "issuer": "example.com",
    "certificate": "-----BEGIN CERTIFICATE-----ABC123DEF456-----END CERTIFICATE-----"
  },
  {
    "userID": "chriswblake@gmail.com",
    "topic": "subtraction",
    "topicList": "https://example.com/0.1.0/math.json",
    "score": "competent",
    "issued-at": "2026-01-01T01:01:01Z",
    "issuer": "example.com",
    "certificate": "-----BEGIN CERTIFICATE-----ABC123DEF456-----END CERTIFICATE-----"
  }
]

Note

The above is just an example of fields. No specific format is defined.