Comment on page
Hypersign Schema SDK
A Javascript based SDK for Schema Operations
The Hypersign Schema comply Verifiable Credentials JSON Schema 2022 data model specification and is stored on Hypersign Identity Blockchain Network as it is adviced to store schema documents and made available as immutable objects.
Is a javascript library for Schema related operation (generate, sign, register etc). It also provides APIs to store/update/retrive Schema to/from the Hypersign Schema Registry on the Hypersign Blockchain network easily.
NOTES
- A DID registred on Hypersign blockchain in order to register a schema on Hypersign blockchain network.
- Schema can not be registred using private DIDs.
npm i https://github.com/hypersign-protocol/hid-ssi-js-sdk --save
import { HypersignSchema } from 'hs-ssi-sdk';
const hypersignSchema = new HypersignSchema();
// OR initialize by passing a namepace. Default ''
// More complex way to initialize this class can be found in this documentation later
const namespace = 'testnet';
const hypersignSchema = new HypersignSchema({ namespace });
Generates a new schema doc without proof
API Definition
generate(params: {
name: string;
description?: string;
author: string;
fields?: Array<ISchemaFields>;
additionalProperties: boolean;
}): Promise<SchemaDocument>;
ISchemaFields
interface ISchemaFields {
type: string;
format?: string;
name: string;
isRequired: boolean;
}
Usage
const schemaBody = {
name: 'testSchema',
description: 'This is a test schema generation',
author: 'did:hid:testnet:zAtZ8oBrVPvaKKou21KRnmzRtZaJpWxsgWuB9GNRLTQ6R',
fields: [{ name: 'name', type: 'integer', isRequired: false }],
additionalProperties: false,
}
const schema = await hypersignSchema.generate(schemaBody);
Output
{
"type": "https://w3c-ccg.github.io/vc-json-schemas/v1/schema/1.0/schema.json",
"modelVersion": "1.0",
"id": "sch:hid:testnet:z57BBNTNqkFXpsFfSMLvfvBhhiSEicGK3nVvJMXRKcE3S:1.0",
"name": "testSchema",
"author": "did:hid:testnet:zAtZ8oBrVPvaKKou21KRnmzRtZaJpWxsgWuB9GNRLTQ6R",
"authored": "2023-01-07T07:24:06Z",
"schema": {
"schema": "http://json-schema.org/draft-07/schema",
"description": "This is a test schema generation",
"type": "object",
"properties": "{\"name\":{\"type\":\"integer\"}}",
"required": [],
"additionalProperties": false
}
}
Signs a schema document and attaches proof
API Definition
sign(params: { privateKeyMultibase: string; schema: SchemaDocument, verificationMethodId: string }): Promise<Schema>;
Note: The difference between
SchemaDocument
and Schema
types is, Schema
type is SchemaDocument
with proof
attached to it. see the example below.Usage
const signedSchema = await hypersignSchema.sign({ privateKeyMultibase: privateKeyMultibase, schema: schema, verificationMethodId: 'did:hid:testnet:zAtZ8oBrVPvaKKou21KRnmzRtZaJpWxsgWuB9GNRLTQ6R#key-1' });
Output
{
"type": "https://w3c-ccg.github.io/vc-json-schemas/v1/schema/1.0/schema.json",
"modelVersion": "1.0",
"id": "sch:hid:testnet:z57BBNTNqkFXpsFfSMLvfvBhhiSEicGK3nVvJMXRKcE3S:1.0",
"name": "testSchema",
"author": "did:hid:testnet:zAtZ8oBrVPvaKKou21KRnmzRtZaJpWxsgWuB9GNRLTQ6R",
"authored": "2023-01-07T07:24:06Z",
"schema": {
"schema": "http://json-schema.org/draft-07/schema",
"description": "This is a test schema generation",
"type": "object",
"properties": "{\"name\":{\"type\":\"integer\"}}",
"required": [],
"additionalProperties": false
},
"proof": {
"type": "Ed25519Signature2020",
"created": "2023-01-07T07:24:07Z",
"verificationMethod": "did:hid:testnet:zAtZ8oBrVPvaKKou21KRnmzRtZaJpWxsgWuB9GNRLTQ6R#key-1",
"proofPurpose": "assertion",
"proofValue": "aozlK3ZSAHuP2x7is60jYXdhS8zc68bO2y9CVShgLNaXxTHdeLIIgqY5Ci6ji0nrC5Q4e+YiGtV/SNIFkvO4CQ=="
}
}
Create Instance of the class
const hypersignSchema = new HypersignSchema({
offlineSigner, // OPTIONAL signer of type OfflineSigner
nodeRestEndpoint: 'https://api.jagrat.hypersign.id', // OPTIONAL RPC endpoint of the Hypersign blockchain, Default 'TEST'
nodeRpcEndpoint: 'https://rpc.jagrat.hypersign.id', // OPTIONAL REST endpoint of the Hypersign blockchain
namespace: 'testnet', // OPTIONAL namespace of did, Default ''
});
// OR Just initalize with offlineSigner
const hypersignSchema = new HypersignSchema({
offlineSigner
})
OfflineSigner
offlineSigner = await createWallet(mnemonic);
Call
init()
to initialize the offlineSignerawait hypersignSchema.init();
Register a schema Document in Hypersign blockchain
API Definition
register(params: { schema: Schema }): Promise<object>;
Usage
const registeredSchema = await hypersignSchema.register({
schema: signedSchema
});
Output
{
"code": 0,
"height": 1449829,
"rawLog": "[{\"events\":[{\"type\":\"message\",\"attributes\":[{\"key\":\"action\",\"value\":\"/hypersignprotocol.hidnode.ssi.MsgCreateSchema\"}]}]}]",
"transactionHash": "A4909951861464DA4FF0E8CB101E128895E166891AF68909B7622B212CCEEDE2",
"gasUsed": 90160,
"gasWanted": 103216
}
Resolves a schema document with schemId from Hypersign blockchain
API Definition
resolve(params: { schemaId: string }): Promise<Schema>;
Usage
const result = await hypersignSchema.resolve({ schemaId: schema['id']});
Output
{
"type": "https://w3c-ccg.github.io/vc-json-schemas/v1/schema/1.0/schema.json",
"modelVersion": "1.0",
"id": "sch:hid:testnet:z57BBNTNqkFXpsFfSMLvfvBhhiSEicGK3nVvJMXRKcE3S:1.0",
"name": "testSchema",
"author": "did:hid:testnet:zAtZ8oBrVPvaKKou21KRnmzRtZaJpWxsgWuB9GNRLTQ6R",
"authored": "2023-01-07T07:24:06Z",
"schema": {
"schema": "http://json-schema.org/draft-07/schema",
"description": "This is a test schema generation",
"type": "object",
"properties": "{\"name\":{\"type\":\"integer\"}}",
"required": [],
"additionalProperties": false
},
"proof": {
"type": "Ed25519Signature2020",
"created": "2023-01-07T07:24:07Z",
"verificationMethod": "did:hid:testnet:zAtZ8oBrVPvaKKou21KRnmzRtZaJpWxsgWuB9GNRLTQ6R#key-1",
"proofPurpose": "assertion",
"proofValue": "aozlK3ZSAHuP2x7is60jYXdhS8zc68bO2y9CVShgLNaXxTHdeLIIgqY5Ci6ji0nrC5Q4e+YiGtV/SNIFkvO4CQ=="
}
}
// TODO
Last modified 5mo ago