Self-sovereign identity is awesome and we all know that. 😎
However, the process of issuing and verifying digital credentials can involve a number of steps, concepts and parameterisations that make the process less fun than it might have been when all you wanted to do was create a simple proof of concept or demo application.
To solve this problem, we created the JS SDK to provide users of the walt.id identity stack with a set of ready-to-use Vue and React components that encapsulate the hassle of implementing basic digital identity workflows.
UI components for digital ID use-cases powered by walt.id's Open-Source digital ID and wallet infrastructure.
- Issue or verify digital ID credentials by rendering QR codes or links via pre-build model and button components.
- Configure credential types to issue or verify, provide redirect URIs for success events, and adjust the styling to your needs via component props. No need to understand and write complex issuance and verification requests or custom frontend components.
- A few minutes, and your ID use case is ready to present.
- The components offered are available for React and Vue.
Note: At this point, the components are only meant for demo use-cases as secrets like private keys, used for signing credentials, are stored and handled in the frontend. Later versions will let you configure external credential storage options.
In a nutshell, this is how to use it.
npm i waltid-react-components<IssuanceButton credentials={[{ "type": "eID" }]} />
To see it working straight away, take a look at this example app.
This library is available in the NPM repository in 2 flavours: Vue and React.
Installing the React version:
npm i waltid-react-componentsInstaling the Vue version:
npm i waltid-vue-componentsOnce the lib is installed on your environment, you can now start using it in your custom React or Vue components.
import { IssuanceButton, VerificationButton } from 'waltid-react-components'
The library provides two button components: the IssuanceButton, for credential issuance and the VerificationButton,
for credential verification.
Both are like black boxes that abstract all the necessary backend details for issuing and verifying credentials from the developer. If you are not sure about which details are hidden behind these buttons, take a look at here (for issuance) and here (for verification).
The only parameter you need to specify to create the credential issue button is the credential type. A list of by default supported credential types can be found in our credential repository.
In the example below, we create a button to issue
a credential of type eID.
<IssuanceButton credentials={[{ "type": "eID" }]} />
The result will be a button like this:
When clicked, the generated button will call the Issuer API to initialize an OID4VC exchange session. The final result will be a credential offer URL which will be enconded as a QrCode to be sacanned by the user with her wallet.
The basic usage of the verification button is very similar to the previous one. The only required parameter is the credential type to be presented.
<VerificationButton credentialTypes={["eID"]} />
The resulting button will be like:
When clicked, the Verifier API will be called to initialize an OID4VP presentation session. Similiar to the issuance process, the result of the API call is a presentation request URL which is usually encoded as a QrCode.
The user then uses their wallet to scan the QrCode and the flow of credential presentation and verification continues.
For more fine-grained customization, the components expose the walt.id's complete issuer and verifier API interfaces to be able to handle even the most complex use cases.
You can also take a look at our example apps which show different use-cases in more detail.
The SDK is built using Mitosis, a tool that allows you to build components in a framework-agnostic way. Any extension of the components therefore must happen in the Mitosis language. You can learn more about it here.
- library: Mitosis project that contains the source code of the Waltid JS SDK.
- library/src: source code of the Waltid JS SDK.
- library/packages: output of the Waltid JS SDK for different frontend frameworks.
- test-apps: test applications that demonstrate how to use the Waltid JS SDK with different frontend frameworks.
- Run Mitosis in watch mode
npm install
cd library
npm run start- Build the library for the frontend framework you want to use. For example, to build the library for React:
cd library/packages/react
npm run build- Finally, run the test application. For example, to run the test application built with React:
cd test-apps/react
npm run dev