README
¶
ssi-sdk
Introduction
Named ssi-sdk, this SDK encapsulates a set of standards related
to Self Sovereign Identity.
The ssi-sdk intends to provide flexible functionality based on a set of standards-based primitives for building
decentralized identity applications in a modular manner: with limited dependencies between components.
The image above outlines the SDK's vision. Standards may be added and/or removed. The standards themselves are under active development, and as such, are subject to change. When possible we aim to call out which versions or revisions of standards we are building implementations against.
The SDK has not undergone any formal security review or audit, so please use with caution.
For more information, see the vision document.
Contributing
This project is fully open source, and we welcome contributions! For more information please see CONTRIBUTING. Our current thinking about the development of the library is captured in GitHub Issues.
Specifications
Here are a set of references to specifications that this library currently supports. It is a dynamic set that will change as the library evolves.
- Decentralized Identifiers (DIDs) v1.0 W3C Proposed Recommendation 03 August 2021
- Verifiable Credentials Data Model v1.1 W3C Recommendation
09 November 2021
- Supports Linked Data Proof formats.
- Supports VC-JWT and VP-JWT formats.
- Verifiable Credentials JSON Schema Specification Draft Community Group Report, 21 September 2021
- Presentation Exchange 2.0.0 Working Group Draft, March 2022
- Wallet Rendering Strawman, June 2022
- Credential Manifest Strawman, June 2022
- Status List 2021 Draft Community Group Report 04 April 2022
signature suites
- Data Integrity 1.0 Draft Community Group Report
- Linked Data Cryptographic Suite Registry Draft Community Group Report 29 December 2020
- JSON Web Signature 2020 Draft Community Group Report 09 February 2022
- VC Proof Formats Test Suite, VC Data Model with JSON Web Signatures Unofficial Draft 09 March 2022 This implementation's compliance with the JWS Test Suite can be found here.
- Supports both JWT and Linked Data proof formats with JOSE compliance.
did methods
- The did:key Method v0.7 Unofficial Draft 14 February 2022
- The did:web Method 20 December 2021
- The did:peer Method W3C Document 12 October 2021
- The did:pkh Method Draft, 22 August 2022
Building
This project uses mage, please view CONTRIBUTING for more information.
After installing mage, you can build and test the SDK with the following commands:
mage build
mage test
A utility is provided to run clean, build, and test in sequence with:
mage cbt
Mobile targets can be built with:
// Creates both Android and iOS packages
mage mobile
// Outputs an .xcframework for the crypto, cryptosuite, did packages
mage ios
// Outputs a .jar and .aar for the crypto, cryptosuite, did packages
mage android
Versioning
For information on versioning refer to our versioning guide.
The latest version is...nothing! No releases have been made.
Examples
A set of code examples can be found in the examples directory. We welcome contributions for additional examples.
- Decentralized Identifiers Example
- Verifiable Credentials Example
- Presentation Exchange Examples
To run the examples use the following command
go run example/did/did.go
go run example/usecase/apartment_application/apartment_application.go
Project Resources
| Resource | Description |
|---|---|
| VISION | Outlines the project vision |
| VERSIONING | Project versioning strategy |
| CODE_OF_CONDUCT | Expected behavior for project contributors, promoting a welcoming environment |
| CONTRIBUTING | Developer guide to build, test, run, access CI, chat, discuss, file issues |
| GOVERNANCE | Project governance |
| LICENSE | Apache License, Version 2.0 |
Directories
¶
| Path | Synopsis |
|---|---|
|
Package did DID Peer ------------------------------------------------ https://identity.foundation/peer-did-method-spec/
|
Package did DID Peer ------------------------------------------------ https://identity.foundation/peer-did-method-spec/ |
|
did
A simple application using a did:key.
|
A simple application using a did:key. |
|
manifest
A simple example of making a credential manifest and issuing a credential from it, using a credential application.
|
A simple example of making a credential manifest and issuing a credential from it, using a credential application. |
|
presentation
|------------| |----------------------| |------------| | Verifier | ----> | Presentation Request | -----> | Holder | | | | \Definition | | | |------------| |----------------------| |------------|
|
|------------| |----------------------| |------------| | Verifier | ----> | Presentation Request | -----> | Holder | | | | \Definition | | | |------------| |----------------------| |------------| |
|
vc
This is a simple application which creates a Verifiable Credential.
|
This is a simple application which creates a Verifiable Credential. |