Skip to content

Commit

Permalink
reformat readme and index, update links
Browse files Browse the repository at this point in the history
  • Loading branch information
Bnonni committed Jul 22, 2024
1 parent a5eb433 commit fd0c83b
Show file tree
Hide file tree
Showing 10 changed files with 152 additions and 45 deletions.
Binary file added .DS_Store
Binary file not shown.
Original file line number Diff line number Diff line change
@@ -1,27 +1,27 @@
{
"protocol": "https://formfree.github.io/.well-known/protocols/dvcx/credential-applicant.json",
"protocol": "https://formfree.github.io/.well-known/protocols/dcx/credential-applicant.json",
"published": false,
"types": {
"application": {
"schema": "https://formfree.github.io/.well-known/schemas/dvcx/application.json",
"schema": "https://formfree.github.io/.well-known/schemas/dcx/application.json",
"dataFormats": [
"application/json"
]
},
"manifest": {
"schema": "https://formfree.github.io/.well-known/schemas/dvcx/manifest.json",
"schema": "https://formfree.github.io/.well-known/schemas/dcx/manifest.json",
"dataFormats": [
"application/json"
]
},
"response": {
"schema": "https://formfree.github.io/.well-known/schemas/dvcx/response.json",
"schema": "https://formfree.github.io/.well-known/schemas/dcx/response.json",
"dataFormats": [
"application/json"
]
},
"invoice": {
"schema": "https://formfree.github.io/.well-known/schemas/dvcx/invoice.json",
"schema": "https://formfree.github.io/.well-known/schemas/dcx/invoice.json",
"dataFormats": [
"application/json"
]
Expand Down
Original file line number Diff line number Diff line change
@@ -1,27 +1,27 @@
{
"protocol": "https://formfree.github.io/.well-known/protocols/dvcx/credential-exchange.json",
"protocol": "https://formfree.github.io/.well-known/protocols/dcx/credential-exchange.json",
"published": false,
"types": {
"application": {
"schema": "https://formfree.github.io/.well-known/schemas/dvcx/application.json",
"schema": "https://formfree.github.io/.well-known/schemas/dcx/application.json",
"dataFormats": [
"application/json"
]
},
"manifest": {
"schema": "https://formfree.github.io/.well-known/schemas/dvcx/manifest.json",
"schema": "https://formfree.github.io/.well-known/schemas/dcx/manifest.json",
"dataFormats": [
"application/json"
]
},
"response": {
"schema": "https://formfree.github.io/.well-known/schemas/dvcx/response.json",
"schema": "https://formfree.github.io/.well-known/schemas/dcx/response.json",
"dataFormats": [
"application/json"
]
},
"invoice": {
"schema": "https://formfree.github.io/.well-known/schemas/dvcx/invoice.json",
"schema": "https://formfree.github.io/.well-known/schemas/dcx/invoice.json",
"dataFormats": [
"application/json"
]
Expand Down
Original file line number Diff line number Diff line change
@@ -1,27 +1,27 @@
{
"protocol": "https://formfree.github.io/.well-known/protocols/dvcx/credential-issuer.json",
"protocol": "https://formfree.github.io/.well-known/protocols/dcx/credential-issuer.json",
"published": false,
"types": {
"application": {
"schema": "https://formfree.github.io/.well-known/schemas/dvcx/application.json",
"schema": "https://formfree.github.io/.well-known/schemas/dcx/application.json",
"dataFormats": [
"application/json"
]
},
"manifest": {
"schema": "https://formfree.github.io/.well-known/schemas/dvcx/manifest.json",
"schema": "https://formfree.github.io/.well-known/schemas/dcx/manifest.json",
"dataFormats": [
"application/json"
]
},
"response": {
"schema": "https://formfree.github.io/.well-known/schemas/dvcx/response.json",
"schema": "https://formfree.github.io/.well-known/schemas/dcx/response.json",
"dataFormats": [
"application/json"
]
},
"invoice": {
"schema": "https://formfree.github.io/.well-known/schemas/dvcx/invoice.json",
"schema": "https://formfree.github.io/.well-known/schemas/dcx/invoice.json",
"dataFormats": [
"application/json"
]
Expand Down
2 changes: 1 addition & 1 deletion .well-known/schemas/dcx/application.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"$id": "https://formfree.github.io/.well-known/schemas/dvcx/application.json",
"$id": "https://formfree.github.io/.well-known/schemas/dcx/application.json",
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Credential Application",
"type": "object",
Expand Down
2 changes: 1 addition & 1 deletion .well-known/schemas/dcx/invoice.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://formfree.github.io/.well-known/schemas/dvcx/invoice.json",
"$id": "https://formfree.github.io/.well-known/schemas/dcx/invoice.json",
"type": "object",
"properties": {
"url": {
Expand Down
2 changes: 1 addition & 1 deletion .well-known/schemas/dcx/manifest.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"$schema": "http://json-schema.org/draft-07/schema",
"$id": "https://formfree.github.io/.well-known/schemas/dvcx/manifest.json",
"$id": "https://formfree.github.io/.well-known/schemas/dcx/manifest.json",
"title": "Credential Manifest",
"type": "object",
"properties": {
Expand Down
2 changes: 1 addition & 1 deletion .well-known/schemas/dcx/response.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://formfree.github.io/.well-known/schemas/dvcx/response.json",
"$id": "https://formfree.github.io/.well-known/schemas/dcx/response.json",
"title": "Credential Response",
"type": "object",
"properties": {
Expand Down
63 changes: 49 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,49 @@
# formfree.github.io

Contains .well-known files for FormFree identity
- <a href="./.well-known/protocols/">protocols</a>
- <a href="./.well-known/protocols/dvcx/">dvcx protocols</a>
- <a href="./.well-known/protocols/dvcx/credential-issuer.json">dvcx credential-issuer protocol</a>
- <a href="./.well-known/protocols/dvcx/credential-applicant.json">dvcx credential-applicant protocol</a>
- <a href="./.well-known/protocols/dvcx/credential-exchange.json">dvcx credential-exchange protocol</a>
- <a href="./.well-known/schemas/">schemas</a>
- <a href="./.well-known/schemas/dvcx/">dvcx schemas</a>
- <a href="./.well-known/schemas/dvcx/application.json">dvcx application schema</a>
- <a href="./.well-known/schemas/dvcx/invoice.json">dvcx invoice schema</a>
- <a href="./.well-known/schemas/dvcx/manifest.json">dvcx manifest schema</a>
- <a href="./.well-known/schemas/dvcx/response.json">dvcx response schema</a>
# FormFree Protocols & Schemas

This repo contains .well-known files for FormFree Holdings Corporation

- [Protocols](/.well-known/protocols/)
- [Schemas](/.well-known/schemas/)
- [DCX](/.well-known/schemas/dcx/)

## DCX

For more information about DCX, check out the following links

- [TBD54566975/incubation-dcx](https://github.com/TBD54566975/incubation-dcx) TBD incubation repo
- [@dcx-protocol/root](https://www.npmjs.com/package/@dcx-protocol/root) NPMJS Package

### Protocols

These are DWN protocols for the issuer and applicant side of DCX, as well as the full exchange (both sides).
Protocols define the CRUD operations permitted by on the different DWN records defined in the [Schemas](#schemas) section below.
Credential Exchange Protocol is not implemented directly. It is implemented separately but is provided here for reference.

- [Credential Issuer Protocol](/.well-known/protocols/dcx/credential-issuer.json)
- [Credential Applicant Protocol](/.well-known/protocols/dcx/credential-applicant.json)
- [Credential Exchange Protocol](/.well-known/protocols/dcx/credential-exchange.json)

### Schemas

- [Application Schema](/.well-known/schemas/dcx/application.json)
- Schema definition for application DWN records
- Submitted by DCX applicants to DCX issuer DWNs
- Includes the actual input credential proofs of credentials currently held by DCX applicants
- Used to request a new output credential from a DCX issuer

- [Manifest Schema](/.well-known/schemas/dcx/manifest.json)
- Schema definition for manifest DWN records
- Created by issuers in their own DWNs
- Conforms to the DIF spec for [credential manifests](https://github.com/TBD54566975/incubation-dcx?tab=readme-ov-file#credential-manifest)
- Defines the input credentials required to obtain an output credential and the type of output credential
- Read by applicants and used to know what credentials they need to acquire before requesting an output credential from a DCX issuer

- [Response Schema](/.well-known/schemas/dcx/response.json)
- Schema definition for response DWN records;
- Created by DCX issuers in response to an application record
- Contains either an approval + output VC or a denial + reasoning

- [Invoice Schema](/.well-known/schemas/dcx/invoice.json)
- Optional Schema definition for invoice DWN records
- Created by DCX issuers and sent to DCX applicant DWNs
- Currently unimplemented in the DCX npm package
96 changes: 84 additions & 12 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,29 +4,101 @@
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>formfree.github.io</title>
<title>FormFree Protocols & Schemas | formfree.github.io</title>
</head>

<body>
<h1>FormFree Protocols & Schemas</h1>
<img src="/images/hero.jpg" height="250" width="750" />
<h1>FormFree .well-known files</h1>
<p>This repo contains .well-known files for FormFree Holdings Corporation</p>
<div>
<h2>DCX</h2>
<p>For more information about DCX, check out the following links:</p>
<ul>
<li>
<a target="_blank" href="https://github.com/TBD54566975/incubation-dcx">
github.com/TBD54566975/incubation-dcx
</a>
</li>
<li>
<a target="_blank" href="https://www.npmjs.com/package/@dcx-protocol/root">
npmjs.com/package/@dcx-protocol/root
</a>
</li>
</ul>
<div>
<h5>Protocols</h5>
<h3>Protocols</h3>
<p>These are DWN protocols for the issuer and applicant side of DCX, as well as the full exchange (both
sides). Protocols define the CRUD operations permitted on the different DWN records defined in the
Schemas section below. Credential Exchange Protocol is not implemented directly. It is implemented
separately but is provided here for reference.</p>
<ul>
<li><a href="./.well-known/protocols/dcx/credential-issuer.json">credential-issuer.json</a></li>
<li><a href="./.well-known/protocols/dcx/credential-applicant.json">credential-applicant.json</a></li>
<li><a href="./.well-known/protocols/dcx/credential-exchange.json">credential-exchange.json</a></li>
<li><a href="/.well-known/protocols/dcx/credential-issuer.json">Credential Issuer Protocol</a></li>
<li><a href="/.well-known/protocols/dcx/credential-applicant.json">Credential Applicant Protocol</a>
</li>
<li><a href="/.well-known/protocols/dcx/credential-exchange.json">Credential Exchange Protocol</a></li>
</ul>
</div>
<br />
<div>
<h5>Schemas</h5>
<h3>Schemas</h3>
<ul>
<li><a href="./.well-known/schemas/dcx/application.json">application.json</a></li>
<li><a href="./.well-known/schemas/dcx/invoice.json">invoice.json</a></li>
<li><a href="./.well-known/schemas/dcx/manifest.json">manifest.json</a></li>
<li><a href="./.well-known/schemas/dcx/response.json">response.json</a></li>
<li>
<a href="/.well-known/schemas/dcx/application.json">Application Schema</a>
<ul>
<li>
Schema definition for application DWN records. Submitted by DCX applicants to DCX issuer
DWNs.
</li>
<li>
Includes the actual input credential proofs of credentials currently held by DCX applicants.
</li>
<li>
Used to request a new output credential from a DCX issuer.
</li>
</ul>
</li>
<br />
<li>
<a href="/.well-known/schemas/dcx/manifest.json">Manifest Schema</a>
<ul>
<li>
Schema definition for manifest DWN records. Created by issuers in their own DWNs.
</li>
<li>
Conforms to the DIF spec for <a
href="https://github.com/TBD54566975/incubation-dcx?tab=readme-ov-file#credential-manifest">
credential manifests.
</a>
</li>
<li>
Defines the input credentials required to obtain an output credential and the type of output
credential.
</li>
<li>
Read by applicants and used to know what credentials they need to acquire before requesting
an output credential from a DCX issuer.
</li>
</ul>
</li>
<br />
<li>
<a href="/.well-known/schemas/dcx/response.json">Response Schema</a>
<ul>
<li>Schema definition for response DWN records.</li>
<li>Created by DCX issuers in response to an application record.</li>
<li>Contains either an approval + output VC or a denial + reasoning.</li>
</ul>
</li>
<br />
<li>
<a href="/.well-known/schemas/dcx/invoice.json">Invoice Schema</a>
<ul>
<li>Optional Schema definition for invoice DWN records.</li>
<li>Created by DCX issuers and sent to DCX applicant DWNs.</li>
<li>Currently unimplemented in the DCX npm package.</li>
</ul>
</li>
<br />
</ul>
</div>
</div>
Expand Down

0 comments on commit fd0c83b

Please sign in to comment.