@gimly-blockchain/gimly-id-app-sdk
v0.0.3
Published
Typescript library and html/css bundles used to interact a the Gimly ID app to login with SSO and send and receive VCs
Downloads
1
Readme
Gimly ID Mobile SDK
Typescript library and html/css bundles used to interact a the Gimly ID app to login with SSO and send and receive VCs
This is the usage documentation for the SDK used in a react native APP.
Getting Started
React native ≥0.64 required. To install locally the component we must install the main repository package
yarn add https://github.com/Gimly-Blockchain/gimly-id-app-sdk.git
Service
The SDK consists of a group of services to:
- Create the encrypted wallet on the device.
- Create DID.
- Manage credentials.
- Manage presentations.
Wallet
Description
In the process of creating the wallet through ethers, a mnemonic phrase (BIP-39) with 24 words will be created, with this phrase the wallet will be created, later it will be encrypted with the value provided. Finally it will be stored by Keychain securely on the device
For more information, see:
Usage
To create the wallet we will only have to provide a value to the function which must have a string type.
import { createEncryptedWallet } from 'gimly-id-app-sdk'
const pin = '123456'
const savePin = async (pin: string) => {
if (pin) {
await createEncryptedWallet(pin)
}
}
We will receive this response in case of error
// Error when creating the wallet
DID
Description
This service is responsible for creating and modifying the user's DID using the following libraries:
Usage
Data Interface
interface IdentityData {
chain: string;
publicKey: string;
privateKey: string;
nameKey: string;
accountName: string;
}
interface Authority {
threshold: number;
keys: KeyWeight[];
accounts: PermissionLevelWeight[];
waits: WaitWeight[];
}
Generate DID
import { GeneralIdentityService } from 'gimly-id-app-sdk'
const identityData: IdentityData = {
chain: 'eos:testnet:jungle',
publicKey: 'PUB_K1_5irHomACLB3oRbkqdgYTdh1GHGt8yvzQ7no5dxvEw5eYAiUiut',
privateKey: 'PVT_K1_27yS4sdX86VDahQRABMLCcDABH5Vzy8vgLLS7wBeKESyrXetMf',
nameKey: 'didtester3334',
accountName: 'newaccount11'
}
const authority: Authority = {
threshold: 1,
keys: [
{
key: 'PUB_K1_5irHomACLB3oRbkqdgYTdh1GHGt8yvzQ7no5dxvEw5eYAiUiut',
weight: 1
}
],
accounts: [],
waits: []
}
const generateDid = async (data: IdentityData, auth: Authority) => {
await GeneralIdentityService.createDid(data, auth)
}
We will receive this response in case of error
// Create DID error
Resolve DID
import { GeneralIdentityService } from 'gimly-id-app-sdk'
const resolveDID = async () => {
await GeneralIdentityService.getUserDid()
}
We will receive this response in case of error
// resolve DID error
Update DID
import { GeneralIdentityService } from 'gimly-id-app-sdk'
const identityData: IdentityData = {
chain: 'eos:testnet:jungle',
publicKey: 'PUB_K1_5irHomACLB3oRbkqdgYTdh1GHGt8yvzQ7no5dxvEw5eYAiUiut',
privateKey: 'PVT_K1_27yS4sdX86VDahQRABMLCcDABH5Vzy8vgLLS7wBeKESyrXetMf',
nameKey: 'didtester3334',
accountName: 'newaccount11'
}
const authority: Authority = {
threshold: 1,
keys: [
{
key: 'PUB_K1_5irHomACLB3oRbkqdgYTdh1GHGt8yvzQ7no5dxvEw5eYAiUiut',
weight: 1
}
],
accounts: [],
waits: []
}
const permission = 'active'
const parent = 'owner'
const updateDid = async (
data: IdentityData,
permission: string,
parent: string,
auth: Authority
) => {
await GeneralIdentityService.updateDid(data, permission, parent, auth)
}
We will receive this response in case of error
// Update DID error
DID (Ethr-DID)
Description
This service is responsible for creating and modifying the user's DID using the following libraries:
Usage
Data Interface
export interface EthrDid {
did: string
didDocument: string
privateKey: string
publicKey: string
}
Generate DID
import { EtherIdentityService } from 'gimly-id-app-sdk'
const generateDid = async () => {
await EtherIdentityService.createDid()
}
//This will save an EtherDid type object in the wallet.
We will receive this response in case of error
// Create DID error
Resolve DID
import { GeneralIdentityService } from 'gimly-id-app-sdk'
const resolveDID = async () => {
await EtherIdentityService.getUserDid()
}
//This will return the didDocument
We will receive this response in case of error
// resolve DID error
Credentials
Description
This service is responsible for generating and verifying the credentials
Usage
Data Interface
interface Credential {
'@context': string[]
id: string
type: string[]
issuer: string | Issuer
issuanceDate: string
credentialSubject: CredentialSubject
proof?: PresentationProof
}
interface CredentialSubject {
id: string
[custom: string]: unknown
}
interface PresentationProof {
type: string;
created: string;
verificationMethod: string;
proofPurpose: string;
challenge?: string;
jws?: string;
proofValue?: string;
}
Generate credential
When we generate a credential, we will specify the ontologies in the @context
of the credential
parameters, as stated in the w3 standard link. Examples are provided to use own and third-party credentials (schema.org) or (fhir) more examples.
import { GeneralIdentityService } from 'gimly-id-app-sdk'
const credential: Credential = {
'@context': [
'https://www.w3.org/2018/credentials/v1',
'https://www.w3.org/2018/credentials/examples/v1'
],
id: 'https://example.com/credentials/1872',
type: ['VerifiableCredential', 'AlumniCredential'],
issuer: 'https://example.edu/issuers/565049',
issuanceDate: '2010-01-01T19:23:24Z',
credentialSubject: {
id: 'did:example:ebfeb1f712ebc6f1c276e12ec21',
alumniOf: 'Example University'
}
}
const keyPair: CredentialKeyPair = {
publicKeyBase58:
'MmVhTd7VDGeowTYotyUyjTfzkweJokFNYStRpJmmF3oMrnijYy7XE9SyymFJVsn4ViUrSLKXvppG5G8j2fcgjLeS',
privateKeyBase58: 'F8v7zWWPTVPid1Gd6CidHe9815jNWZB6gQFYff3TsTWJ',
id: 'did:ethr:ropsten:0x028360fb95417724cb7dd2ff217b15d6f17fc45e0ffc1b3dce6c2b8dd1e704fa98#controllerKey',
controller:
'did:ethr:ropsten:0x028360fb95417724cb7dd2ff217b15d6f17fc45e0ffc1b3dce6c2b8dd1e704fa98'
}
const generateCredential = async (
credential: Credential,
keyPair: CredentialKeyPair
) => {
await GeneralIdentityService.createCredential(credential)
}
We will receive this response in case of error
// Create Credential Error
Verify credential
import { GeneralIdentityService } from 'gimly-id-app-sdk'
const credential: Credential = {
'@context': [
'https://www.w3.org/2018/credentials/v1',
'https://www.w3.org/2018/credentials/examples/v1'
],
id: 'https://example.com/credentials/1872',
type: ['VerifiableCredential', 'AlumniCredential'],
issuer: 'https://example.edu/issuers/565049',
issuanceDate: '2010-01-01T19:23:24Z',
credentialSubject: {
id: 'did:example:ebfeb1f712ebc6f1c276e12ec21',
alumniOf: 'Example University'
},
proof: {
type: 'EcdsaSecp256k1Signature2019',
created: '2021-10-07T10:56:58Z',
verificationMethod:
'did:ethr:ropsten:0x028360fb95417724cb7dd2ff217b15d6f17fc45e0ffc1b3dce6c2b8dd1e704fa98#controllerKey',
proofPurpose: 'assertionMethod',
jws: 'eyJhbGciOiJFUzI1NksiLCJiNjQiOmZhbHNlLCJjcml0IjpbImI2NCJdfQ..Q_HvWN3cF4zqcLdlC9g2lDp522yqA-FyH3WHOtYAy-8af6urfy-CsWa2S30fzh1yv0A3DGt1LAr6ZW0NWxEz-A'
}
}
const keyPair: CredentialKeyPair = {
publicKeyBase58:
'MmVhTd7VDGeowTYotyUyjTfzkweJokFNYStRpJmmF3oMrnijYy7XE9SyymFJVsn4ViUrSLKXvppG5G8j2fcgjLeS',
privateKeyBase58: 'F8v7zWWPTVPid1Gd6CidHe9815jNWZB6gQFYff3TsTWJ',
id: 'did:ethr:ropsten:0x028360fb95417724cb7dd2ff217b15d6f17fc45e0ffc1b3dce6c2b8dd1e704fa98#controllerKey',
controller:
'did:ethr:ropsten:0x028360fb95417724cb7dd2ff217b15d6f17fc45e0ffc1b3dce6c2b8dd1e704fa98'
}
const verifyCredential = async (
credential: Credential,
keyPair: CredentialKeyPair
) => {
await GeneralIdentityService.verifyCredential(credential)
}
We will receive this response in case of error
// Verify Credential Error
Presentations
Description
This is the service responsible for generating and verifying presentations, using the following libraries
Usage
Data Interface
interface Presentation {
'@context': string[];
type: string[];
id?: string;
holder?: string;
verifiableCredential: Credential[];
proof?: PresentationProof;
}
// The "Credential" and "PresentationProof" interfaces are the same used in the presentation service.
Create presentation
import { GeneralIdentityService } from 'gimly-id-app-sdk'
const credential: Credential = {
'@context': [
'https://www.w3.org/2018/credentials/v1',
'https://www.w3.org/2018/credentials/examples/v1'
],
id: 'https://example.com/credentials/1872',
type: ['VerifiableCredential', 'AlumniCredential'],
issuer: 'https://example.edu/issuers/565049',
issuanceDate: '2010-01-01T19:23:24Z',
credentialSubject: {
id: 'did:example:ebfeb1f712ebc6f1c276e12ec21',
alumniOf: 'Example University'
},
proof: {
type: 'EcdsaSecp256k1Signature2019',
created: '2021-10-07T10:56:58Z',
verificationMethod:
'did:ethr:ropsten:0x028360fb95417724cb7dd2ff217b15d6f17fc45e0ffc1b3dce6c2b8dd1e704fa98#controllerKey',
proofPurpose: 'assertionMethod',
jws: 'eyJhbGciOiJFUzI1NksiLCJiNjQiOmZhbHNlLCJjcml0IjpbImI2NCJdfQ..Q_HvWN3cF4zqcLdlC9g2lDp522yqA-FyH3WHOtYAy-8af6urfy-CsWa2S30fzh1yv0A3DGt1LAr6ZW0NWxEz-A'
}
}
const createPresentation = async (credentials: Credential[]) => {
await GeneralIdentityService.createPresentation(credential)
}
We will receive this response in case of error
// Create Presentation Error
Sign presentation
import { GeneralIdentityService } from 'gimly-id-app-sdk'
const presentation: Presentation = {
'@context': ['https://www.w3.org/2018/credentials/v1'],
type: ['VerifiablePresentation'],
id: 'ebc6f1c2',
holder: 'did:ex:12345',
verifiableCredential: [
{
'@context': [
'https://www.w3.org/2018/credentials/v1',
'https://www.w3.org/2018/credentials/examples/v1'
],
id: 'http://example.edu/credentials/1872',
type: ['VerifiableCredential', 'AlumniCredential'],
issuer: 'https://example.edu/issuers/565049',
issuanceDate: '2010-01-01T19:23:24Z',
credentialSubject: {
id: 'did:example:ebfeb1f712ebc6f1c276e12ec21',
alumniOf: '<span lang="en">Example University</span>'
}
}
]
}
const challenge = 'mychallengeword'
const signPresentation = async (
presentation: Presentation,
keyPair: CredentialKeyPair,
challenge: string
) => {
await GeneralIdentityService.signPresentation(
presentation,
keyPair,
challenge
)
}
We will receive this response in case of error
// Sign Presentation Error
Verify presentation
import { GeneralIdentityService } from 'gimly-id-app-sdk'
const presentation: Presentation = {
'@context': ['https://www.w3.org/2018/credentials/v1'],
type: ['VerifiablePresentation'],
id: 'ebc6f1c2',
holder: 'did:ex:12345',
verifiableCredential: [
{
'@context': [
'https://www.w3.org/2018/credentials/v1',
'https://www.w3.org/2018/credentials/examples/v1'
],
id: 'http://example.edu/credentials/1872',
type: ['VerifiableCredential', 'AlumniCredential'],
issuer: 'https://example.edu/issuers/565049',
issuanceDate: '2010-01-01T19:23:24Z',
credentialSubject: {
id: 'did:example:ebfeb1f712ebc6f1c276e12ec21',
alumniOf: '<span lang="en">Example University</span>'
},
proof: {
type: 'Ed25519Signature2018',
created: '2020-02-03T17:23:49Z',
jws: 'eyJhbGciOiJFZERTQSIsImI2NCI6ZmFsc2UsImNyaXQiOlsiYjY0Il19..AUQ3AJ23WM5vMOWNtYKuqZBekRAOUibOMH9XuvOd39my1sO-X9R4QyAXLD2ospssLvIuwmQVhJa-F0xMOnkvBg',
proofPurpose: 'assertionMethod',
verificationMethod: 'https://example.edu/issuers/keys/1'
}
}
]
}
const verifyPresentation = async (
presentation: Presentation,
keyPair: CredentialKeyPair,
challenge: string
) => {
await GeneralIdentityService.verifyPresentation(
presentation,
keyPair,
challenge
)
}
We will receive this response in case of error
// Verify Presentation Error
Verify unsigned presentation
import { GeneralIdentityService } from 'gimly-id-app-sdk'
const presentation: Presentation = {
'@context': ['https://www.w3.org/2018/credentials/v1'],
type: ['VerifiablePresentation'],
id: 'ebc6f1c2',
holder: 'did:ex:12345',
verifiableCredential: [
{
'@context': [
'https://www.w3.org/2018/credentials/v1',
'https://www.w3.org/2018/credentials/examples/v1'
],
id: 'http://example.edu/credentials/1872',
type: ['VerifiableCredential', 'AlumniCredential'],
issuer: 'https://example.edu/issuers/565049',
issuanceDate: '2010-01-01T19:23:24Z',
credentialSubject: {
id: 'did:example:ebfeb1f712ebc6f1c276e12ec21',
alumniOf: '<span lang="en">Example University</span>'
}
}
]
}
const verifyUnsignedPresentation = async (
presentation: Presentation,
credentialKeyPair: CredentialKeyPair
) => {
await GeneralIdentityService.verifyUnsignedPresentation(
presentation,
credentialKeyPair
)
}
We will receive this response in case of error
// Verify Unsigned Presentation Error
Class diagram
Running Tests
To launch the tests you need to use one of the following scripts:
Will install all repositories
yarn install
Will run all tests with jest
yarn test
Will run jest with the coverage report (this will create a new directory to be able to examine the report in more detail)
yarn test-with-coverage