Videos and documentation always say claims are stored in the ledger but only the "credential definition" or "Schemas and claim definitions". Is this really needed?
1 Answers
As Verifiable Credentials typically contain private data, verifiable claims are not stored on ledger.
Credential Schemas are written on the ledger. They don't contain any private data and only specify what certain type of document contains. For example, it might specify that a driving licence document should contain name, surname, date of birth of the holder, plus classes of vehicles the holder is eligible to drive. Schema is simply a template according to which an issuer may issue verifiable claims.
Credential Definitions are also written on the ledger. It also doesn't contain any private data. Credential definition is linked to 1 Credential Schema (which must already exist on ledger). Credential Definition contains public key which an issuer uses to issue Verifiable Claim of certain type.
Example for context
- Government decides that every university diploma in the country will have following fields:
Name
,Surname
,University name
,Program
,Degree
. They write Credential SchemaDiploma:1.0.0
on the ledger. Anyone can see how diploma looks like. Universities can use it to issue diplomas (as verifiable credentials) for students. Faber Uni.
is university in the country. It wants to issue university degrees according to government specification of how diploma should look like. SoFaber Uni
writes on ledger credential DefinitionFaber:Diploma:1.0.0
. This credential definition also contains public key123
ofFaber Uni
for issuing credentials of this type (Faber Uni
will safely keeps somewhere private part456
). Each timeFaber Uni
issues a student diploma as verifiable credential, it will sign the data using the private part of the key,456
.- When
Faber Uni
issues diploma for its graduateBob
, there's no trace of this event on the ledger.Faber Uni
simply signs a document conforming theDiploma:1.0.0
schema which is on the ledger, using private key456
, whose public counterpart123
is on the ledger. - Now
Bob
wants to get a job atAbcd
and is asked to prove his education. He submits the credential issued byFaber Uni
, which he safely stores on his device.Abcd
could read from the ledgerFaber Uni
's diploma signing key and use it to verify signatures on the verifiable claim presented byBob
.

- 1,883
- 17
- 24
-
There's a nice document dedicated to this topic. "What Goes On The Ledger" by Evernym company https://www.evernym.com/wp-content/uploads/2017/07/What-Goes-On-The-Ledger.pdf – Patrik Stas Apr 28 '19 at 16:30