Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Tutorials for schemas and credentials #610

Merged
merged 4 commits into from
Jul 28, 2023
Merged

Conversation

decentralgabe
Copy link
Member

Addresses more of #606 to add how to docs for schemas and credentials

@codecov-commenter
Copy link

codecov-commenter commented Jul 28, 2023

Codecov Report

Merging #610 (4d70003) into main (b57a656) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main     #610   +/-   ##
=======================================
  Coverage   27.03%   27.03%           
=======================================
  Files          48       48           
  Lines        5830     5830           
=======================================
  Hits         1576     1576           
  Misses       3971     3971           
  Partials      283      283           
Files Changed Coverage Δ
pkg/server/router/did.go 3.44% <ø> (ø)

@decentralgabe decentralgabe marked this pull request as ready for review July 28, 2023 19:55
doc/howto/credential.md Outdated Show resolved Hide resolved

A [Verifiable Credential (VC)](https://www.w3.org/TR/vc-data-model/) is a standard format to package a set of claims that an _issuer_ makes about a _subject_. The Verifiable Credentials Data Model, a W3C standard, introduces a number of concepts, most notable among them, the [three party model](https://www.w3.org/TR/vc-data-model/#ecosystem-overview) of **issuers**, **holders**, and **verifiers**. The model is a novel way of empowering entities to have tamper-evident representations of their data which acts as a mechanism to present the data to any third party (a verifier) without necessitating contact between the verifier and issuer. With the three party model entities are given more [control, transparency, privacy, and utility](https://www.lifewithalacrity.com/2016/04/the-path-to-self-soverereign-identity.html) for data that is rightfully theirs.

VCs are defined by a data model, which does not provide guidance on transmitting or sharing credentials between parties (protocols). The data model also does not provide guidance on _securing_ the credential (which puts the verifiable in verifiable credential). There are two prominent options here: [Data Integrity](https://w3c.github.io/vc-data-integrity/) and [JWT](https://w3c.github.io/vc-jose-cose/) both of which we have demonstrated support for. The data model has a number of required (core) properties, and multiple means of extension to meet many use cases and functional needs.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

vc-jose-cose is different than JWT for VCDM v1.1

I think it's worth clarifying this. It'll make it clear that we're producing VCs represented as v1.1 style JWTs.

doc/howto/credential.md Outdated Show resolved Hide resolved
doc/howto/credential.md Outdated Show resolved Hide resolved
doc/howto/credential.md Outdated Show resolved Hide resolved
@decentralgabe decentralgabe merged commit dc805c4 into main Jul 28, 2023
6 checks passed
@decentralgabe decentralgabe deleted the tutorials-for-schema-cred branch July 28, 2023 21:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants