@learncard/didkit-plugin 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Taylor Beeston <beeston.taylor@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,140 @@
+[<img src="https://user-images.githubusercontent.com/2185016/190510561-294db809-09fd-4771-9749-6c0e0f4144fd.png" width="215"/>](https://learncard.com)
+
+# @learncard/core
+
+[![npm version](https://img.shields.io/npm/v/@learncard/core)](https://www.npmjs.com/package/@learncard/core)
+[![npm downloads](https://img.shields.io/npm/dw/@learncard/core)](https://www.npmjs.com/package/@learncard/core)
+[![vulnerabilities](https://img.shields.io/snyk/vulnerabilities/npm/@learncard/core)](https://www.npmjs.com/package/@learncard/core)
+
+The LearnCard Core is a pluggable, open-source, universal digital wallet to enable any individual or organization to seamlessly **issue, earn, store, share, and spend currency and credentials** built for the future of education and work.
+
+## Documentation
+All LearnCard documentation can be found at:
+https://docs.learncard.com
+
+## Install
+
+```bash
+pnpm i @learncard/core
+```
+
+## Usage
+
+### Instantiation
+
+Instantiate a wallet using `initLearnCard`. This method accepts a unique identifier string that is 
+up to 64 characters long. If it is less than 64 characters, `initLearnCard` will pad the start of
+the string with 0's until it is 64 characters long.
+
+```js
+import { initLearnCard } from "@learncard/core";
+
+const wallet = await initLearnCard({ seed: 'a'.repeat(64) });
+```
+
+### Issuing/Verifying Credentials and Presentations
+
+#### Issue a credential
+```js
+// Grab a test VC, or create your own!
+const unsignedVc = await wallet.invoke.getTestVc();
+
+const vc = await wallet.invoke.issueCredential(unsignedVc);
+```
+
+#### Verify a credential
+```js
+const result = await wallet.invoke.verifyCredential(vc, {}, true);
+
+if (result.warnings.length > 0) console.error('Verification warnings:', result.warnings);
+
+if (result.errors.length > 0) console.error('This credential is not valid!', result.errors);
+else console.log('This credential is valid!');
+```
+
+#### Issue a presentation
+```js
+const vp = await wallet.invoke.issuePresentation(vc);
+```
+
+#### Verify a presentation
+```js
+const result = await wallet.invoke.verifyPresentation(vp);
+
+if (result.warnings.length > 0) console.error('Verification warnings:', result.warnings);
+
+if (result.errors.length > 0) console.error('This presentation is not valid!', result.errors);
+else console.log('This presentation is valid!');
+```
+
+### Storing/Retrieving/Sending Credentials
+
+#### Ceramic/IDX
+
+To maintain co-ownership of credentials, it is best to store credentials in a public place, and then
+store references to that public place. While this is not the only way to store credentials (and is
+also definitely not a silver bullet! E.g. credentials containing private data), it is the opinion of
+this library that it should be used by default. As a result, instantiating a wallet, will 
+automatically connect you to WeLibrary's ceramic node, and allow you to publish and retrieve 
+credentials there using IDX.
+
+#### Publish Credential
+
+After signing a VC, you may choose to publish that credential to Ceramic. Doing so will return a
+stream ID, which you may share to the recipient. That stream ID can then be used to resolve the 
+issued credential. This means both the issuer and recipient may store the _stream ID_ instead of the
+credential itself.
+
+```js
+const uri = await wallet.store.Ceramic.upload(vc);
+```
+
+#### Reading From Ceramic
+
+To resolve a VC from a stream ID, simply call the `readFromCeramic` method:
+
+```js
+const vcFromCeramic = await wallet.read.get(uri);
+```
+
+#### Adding a Credential to a Wallet
+
+After receiving a streamID, you can _persist_ that streamID by calling `addCredential`, and giving
+the credential a bespoke title
+
+```js
+await wallet.index.IDX.add({ uri, id: 'Test VC' });
+```
+
+This will add the streamId, which can be used to resolve the verifiable credential to IDX using the
+wallet's secret key. You can think of this as acting like the wallet's personal storage.
+
+#### Getting a credential from the Wallet
+
+After calling `addCredential`, you can use the bespoke title to retrieve that credential at any time
+
+```js
+const record = (await wallet.index.all.get()).find(record => record.id === 'Test VC');
+const vcFromIdx = await wallet.read.get(record.uri);
+```
+
+Alternatively, you can get an array of _all_ credentials you have added using `getCredentials`
+
+```js
+const uris = (await wallet.index.all.get()).map(record => record.uri);
+const vcs = await Promise.all(uris.map(async uri => wallet.read.get(uri)));
+```
+
+## Contributing
+Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
+
+Please make sure to update tests as appropriate.
+
+## Who is Learning Economy Foundation?
+
+**[Learning Economy Foundation (LEF)](https://www.learningeconomy.io)** is a 501(c)(3) non-profit organization leveraging global standards and web3 protocols to bring quality skills and equal opportunity to every human on earth, and address the persistent inequities that exist around the globe in education and employment. We help you build the future of education and work with:
+
+
+## License
+
+MIT © [Learning Economy Foundation](https://github.com/Learning-Economy-Foundation)

package/dist/didkit/didkit_wasm.d.ts

@@ -0,0 +1,251 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+* @returns {string}
+*/
+export function getVersion(): string;
+/**
+* @param {string} did
+* @param {string} input_metadata
+* @returns {Promise<any>}
+*/
+export function didResolver(did: string, input_metadata: string): Promise<any>;
+/**
+* @param {string} did
+* @param {string} input_metadata
+* @returns {Promise<any>}
+*/
+export function resolveDID(did: string, input_metadata: string): Promise<any>;
+/**
+* @returns {string}
+*/
+export function generateEd25519Key(): string;
+/**
+* @param {Uint8Array} bytes
+* @returns {string}
+*/
+export function generateEd25519KeyFromBytes(bytes: Uint8Array): string;
+/**
+* @returns {string}
+*/
+export function generateSecp256k1Key(): string;
+/**
+* @param {Uint8Array} bytes
+* @returns {string}
+*/
+export function generateSecp256k1KeyFromBytes(bytes: Uint8Array): string;
+/**
+* @param {string} method_pattern
+* @param {string} jwk
+* @returns {string}
+*/
+export function keyToDID(method_pattern: string, jwk: string): string;
+/**
+* @param {string} method_pattern
+* @param {string} jwk
+* @returns {Promise<any>}
+*/
+export function keyToVerificationMethod(method_pattern: string, jwk: string): Promise<any>;
+/**
+* @param {string} did
+* @returns {Promise<any>}
+*/
+export function didToVerificationMethod(did: string): Promise<any>;
+/**
+* @param {string} credential
+* @param {string} proof_options
+* @param {string} key
+* @returns {Promise<any>}
+*/
+export function issueCredential(credential: string, proof_options: string, key: string): Promise<any>;
+/**
+* @param {string} credential
+* @param {string} linked_data_proof_options
+* @param {string} public_key
+* @returns {Promise<any>}
+*/
+export function prepareIssueCredential(credential: string, linked_data_proof_options: string, public_key: string): Promise<any>;
+/**
+* @param {string} credential
+* @param {string} preparation
+* @param {string} signature
+* @returns {Promise<any>}
+*/
+export function completeIssueCredential(credential: string, preparation: string, signature: string): Promise<any>;
+/**
+* @param {string} vc
+* @param {string} proof_options
+* @returns {Promise<any>}
+*/
+export function verifyCredential(vc: string, proof_options: string): Promise<any>;
+/**
+* @param {string} presentation
+* @param {string} proof_options
+* @param {string} key
+* @returns {Promise<any>}
+*/
+export function issuePresentation(presentation: string, proof_options: string, key: string): Promise<any>;
+/**
+* @param {string} presentation
+* @param {string} linked_data_proof_options
+* @param {string} public_key
+* @returns {Promise<any>}
+*/
+export function prepareIssuePresentation(presentation: string, linked_data_proof_options: string, public_key: string): Promise<any>;
+/**
+* @param {string} presentation
+* @param {string} preparation
+* @param {string} signature
+* @returns {Promise<any>}
+*/
+export function completeIssuePresentation(presentation: string, preparation: string, signature: string): Promise<any>;
+/**
+* @param {string} vp
+* @param {string} proof_options
+* @returns {Promise<any>}
+*/
+export function verifyPresentation(vp: string, proof_options: string): Promise<any>;
+/**
+* @param {string} holder
+* @param {string} linked_data_proof_options
+* @param {string} key
+* @returns {Promise<any>}
+*/
+export function DIDAuth(holder: string, linked_data_proof_options: string, key: string): Promise<any>;
+/**
+* @param {string} tz
+* @returns {Promise<any>}
+*/
+export function JWKFromTezos(tz: string): Promise<any>;
+/**
+* @param {string} capability
+* @param {string} linked_data_proof_options
+* @param {string} parents
+* @param {string} key
+* @returns {Promise<any>}
+*/
+export function delegateCapability(capability: string, linked_data_proof_options: string, parents: string, key: string): Promise<any>;
+/**
+* @param {string} capability
+* @param {string} linked_data_proof_options
+* @param {string} parents
+* @param {string} public_key
+* @returns {Promise<any>}
+*/
+export function prepareDelegateCapability(capability: string, linked_data_proof_options: string, parents: string, public_key: string): Promise<any>;
+/**
+* @param {string} capability
+* @param {string} preparation
+* @param {string} signature
+* @returns {Promise<any>}
+*/
+export function completeDelegateCapability(capability: string, preparation: string, signature: string): Promise<any>;
+/**
+* @param {string} delegation
+* @returns {Promise<any>}
+*/
+export function verifyDelegation(delegation: string): Promise<any>;
+/**
+* @param {string} invocation
+* @param {string} target_id
+* @param {string} linked_data_proof_options
+* @param {string} key
+* @returns {Promise<any>}
+*/
+export function invokeCapability(invocation: string, target_id: string, linked_data_proof_options: string, key: string): Promise<any>;
+/**
+* @param {string} invocation
+* @param {string} target_id
+* @param {string} linked_data_proof_options
+* @param {string} public_key
+* @returns {Promise<any>}
+*/
+export function prepareInvokeCapability(invocation: string, target_id: string, linked_data_proof_options: string, public_key: string): Promise<any>;
+/**
+* @param {string} invocation
+* @param {string} preparation
+* @param {string} signature
+* @returns {Promise<any>}
+*/
+export function completeInvokeCapability(invocation: string, preparation: string, signature: string): Promise<any>;
+/**
+* @param {string} invocation
+* @returns {Promise<any>}
+*/
+export function verifyInvocationSignature(invocation: string): Promise<any>;
+/**
+* @param {string} invocation
+* @param {string} delegation
+* @returns {Promise<any>}
+*/
+export function verifyInvocation(invocation: string, delegation: string): Promise<any>;
+/**
+* @param {string} url
+* @returns {Promise<any>}
+*/
+export function contextLoader(url: string): Promise<any>;
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+  readonly memory: WebAssembly.Memory;
+  readonly getVersion: (a: number) => void;
+  readonly didResolver: (a: number, b: number, c: number, d: number) => number;
+  readonly resolveDID: (a: number, b: number, c: number, d: number) => number;
+  readonly generateEd25519Key: (a: number) => void;
+  readonly generateEd25519KeyFromBytes: (a: number, b: number, c: number) => void;
+  readonly generateSecp256k1Key: (a: number) => void;
+  readonly generateSecp256k1KeyFromBytes: (a: number, b: number, c: number) => void;
+  readonly keyToDID: (a: number, b: number, c: number, d: number, e: number) => void;
+  readonly keyToVerificationMethod: (a: number, b: number, c: number, d: number) => number;
+  readonly didToVerificationMethod: (a: number, b: number) => number;
+  readonly issueCredential: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+  readonly prepareIssueCredential: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+  readonly completeIssueCredential: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+  readonly verifyCredential: (a: number, b: number, c: number, d: number) => number;
+  readonly issuePresentation: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+  readonly prepareIssuePresentation: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+  readonly completeIssuePresentation: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+  readonly verifyPresentation: (a: number, b: number, c: number, d: number) => number;
+  readonly DIDAuth: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+  readonly JWKFromTezos: (a: number, b: number) => number;
+  readonly delegateCapability: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
+  readonly prepareDelegateCapability: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
+  readonly completeDelegateCapability: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+  readonly verifyDelegation: (a: number, b: number) => number;
+  readonly invokeCapability: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
+  readonly prepareInvokeCapability: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
+  readonly completeInvokeCapability: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+  readonly verifyInvocationSignature: (a: number, b: number) => number;
+  readonly verifyInvocation: (a: number, b: number, c: number, d: number) => number;
+  readonly contextLoader: (a: number, b: number) => number;
+  readonly didkit_error_message: () => number;
+  readonly didkit_error_code: () => number;
+  readonly __wbindgen_malloc: (a: number) => number;
+  readonly __wbindgen_realloc: (a: number, b: number, c: number) => number;
+  readonly __wbindgen_export_2: WebAssembly.Table;
+  readonly _dyn_core__ops__function__FnMut__A____Output___R_as_wasm_bindgen__closure__WasmClosure___describe__invoke__hf6251ee6687a20b8: (a: number, b: number, c: number) => void;
+  readonly __wbindgen_add_to_stack_pointer: (a: number) => number;
+  readonly __wbindgen_free: (a: number, b: number) => void;
+  readonly __wbindgen_exn_store: (a: number) => void;
+  readonly wasm_bindgen__convert__closures__invoke2_mut__h63ffd509f6690aab: (a: number, b: number, c: number, d: number) => void;
+}
+
+/**
+* Synchronously compiles the given `bytes` and instantiates the WebAssembly module.
+*
+* @param {BufferSource} bytes
+*
+* @returns {InitOutput}
+*/
+export function initSync(bytes: BufferSource): InitOutput;
+
+/**
+* If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+* for everything else, calls `WebAssembly.instantiate` directly.
+*
+* @param {InitInput | Promise<InitInput>} module_or_path
+*
+* @returns {Promise<InitOutput>}
+*/
+export default function init (module_or_path?: InitInput | Promise<InitInput>): Promise<InitOutput>;