@docknetwork/wallet-sdk-core 1.5.0 → 1.5.8

package/lib/biometric-provider.d.ts

@@ -1,29 +1,56 @@
+/// <reference types="node" />
 import { WalletDocument } from '@docknetwork/wallet-sdk-wasm/lib/types';
 import { IWallet } from './types';
-export type BiometricsPluginIssuerConfig = {
-    networkId: string;
-    did: string;
-    apiKey: string;
-    apiUrl: string;
-};
-export type BiometricsPluginConfigs = {
+import { Credential } from './credential-provider';
+import { EventEmitter } from 'events';
+export type BiometricsProviderConfigs<E> = {
     enrollmentCredentialType: string;
     biometricMatchCredentialType: string;
-    biometricMatchExpirationMinutes: number;
-    issuerConfigs: BiometricsPluginIssuerConfig[];
+    idvConfigs: E;
 };
-export declare function setBiometricConfigs(_configs: BiometricsPluginConfigs): void;
+export interface IDVProcessOptions {
+    onDeepLink?: () => void;
+    onMessage?: () => void;
+    onError?: (error: Error) => void;
+    onCancel?: () => void;
+    onComplete?: (credential: any) => void;
+}
+export interface BiometricPlugin {
+    onEnroll(walletDID: string): Promise<WalletDocument>;
+    onMatch(walletDID: string, enrollmentCredential: Credential): Promise<WalletDocument>;
+}
+export declare function setConfigs(configs: BiometricsProviderConfigs<unknown>): void;
+export declare function isBiometricPluginEnabled(): boolean;
 export declare function assertConfigs(): void;
-export declare function getBiometricConfigs(): BiometricsPluginConfigs;
-export declare function getIssuerConfigsForNetwork(networkId: any): BiometricsPluginIssuerConfig;
-export declare function createBiometricBindingProvider({ wallet, onEnroll, onMatch, onCheckBiometryRequired, }: {
+export declare function getBiometricConfigs(): BiometricsProviderConfigs<unknown>;
+export declare function hasProofOfBiometrics(proofRequest: any): any;
+export declare const IDV_EVENTS: {
+    onDeepLink: string;
+    onMessage: string;
+    onError: string;
+    onCancel: string;
+    onComplete: string;
+};
+export interface IDVProvider {
+    enroll(walletDID: string, proofRequest: any): Promise<{
+        enrollmentCredential: Credential;
+        matchCredential: Credential;
+    }>;
+    match(walletDID: string, enrollmentCredential: Credential, proofRequest: any): Promise<{
+        matchCredential: Credential;
+    }>;
+}
+export interface IDVProviderFactory {
+    create(eventEmitter: EventEmitter, wallet: IWallet): IDVProvider;
+}
+export declare function createBiometricProvider({ wallet, idvProviderFactory, }: {
     wallet: IWallet;
-    onEnroll: () => Promise<WalletDocument>;
-    onMatch: (biometricTemplate: WalletDocument) => Promise<WalletDocument>;
-    onCheckBiometryRequired: (request: any) => boolean;
+    idvProviderFactory: IDVProviderFactory;
 }): {
-    enrollBiometry: () => Promise<any>;
-    matchBiometry: () => Promise<WalletDocument>;
-    checkIsBiometryRequired: (request: any) => boolean;
+    startIDV: (proofRequest: any) => Promise<{
+        enrollmentCredential: Credential;
+        matchCredential: Credential;
+    }>;
+    eventEmitter: EventEmitter;
 };
 //# sourceMappingURL=biometric-provider.d.ts.map

package/lib/biometric-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"biometric-provider.d.ts","sourceRoot":"","sources":["../src/biometric-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,wCAAwC,CAAC;AACtE,OAAO,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAIhC,MAAM,MAAM,4BAA4B,GAAG;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,wBAAwB,EAAE,MAAM,CAAC;IACjC,4BAA4B,EAAE,MAAM,CAAC;IACrC,+BAA+B,EAAE,MAAM,CAAC;IACxC,aAAa,EAAC,4BAA4B,EAAE,CAAC;CAC9C,CAAA;AAID,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,uBAAuB,QAEpE;AAED,wBAAgB,aAAa,SAE5B;AAED,wBAAgB,mBAAmB,4BAGlC;AAED,wBAAgB,0BAA0B,CAAC,SAAS,KAAA,GAAG,4BAA4B,CAElF;AAED,wBAAgB,8BAA8B,CAAC,EAC7C,MAAM,EACN,QAAQ,EACR,OAAO,EACP,uBAAuB,GACxB,EAAE;IACD,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IACxC,OAAO,EAAE,CAAC,iBAAiB,EAAE,cAAc,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACxE,uBAAuB,EAAE,CAAC,OAAO,KAAA,KAAK,OAAO,CAAC;CAC/C;;;+CADuC,OAAO;EA2C9C"}
+{"version":3,"file":"biometric-provider.d.ts","sourceRoot":"","sources":["../src/biometric-provider.ts"],"names":[],"mappings":";AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,wCAAwC,CAAC;AACtE,OAAO,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAChC,OAAO,EAEL,UAAU,EAEX,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAC,YAAY,EAAC,MAAM,QAAQ,CAAC;AAGpC,MAAM,MAAM,yBAAyB,CAAC,CAAC,IAAI;IAEzC,wBAAwB,EAAE,MAAM,CAAC;IACjC,4BAA4B,EAAE,MAAM,CAAC;IAErC,UAAU,EAAE,CAAC,CAAC;CACf,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACrD,OAAO,CACL,SAAS,EAAE,MAAM,EACjB,oBAAoB,EAAE,UAAU,GAC/B,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5B;AAID,wBAAgB,UAAU,CAAC,OAAO,EAAE,yBAAyB,CAAC,OAAO,CAAC,QAErE;AAED,wBAAgB,wBAAwB,YAEvC;AAED,wBAAgB,aAAa,SAE5B;AAED,wBAAgB,mBAAmB,uCAGlC;AAED,wBAAgB,oBAAoB,CAAC,YAAY,KAAA,OAShD;AAGD,eAAO,MAAM,UAAU;;;;;;CAMtB,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,GAAG,GAChB,OAAO,CAAC;QAAC,oBAAoB,EAAE,UAAU,CAAC;QAAC,eAAe,EAAE,UAAU,CAAA;KAAC,CAAC,CAAC;IAC5E,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,oBAAoB,EAAE,UAAU,EAChC,YAAY,EAAE,GAAG,GAChB,OAAO,CAAC;QACT,eAAe,EAAE,UAAU,CAAC;KAC7B,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,GAAG,WAAW,CAAC;CAClE;AAED,wBAAgB,uBAAuB,CAAC,EACtC,MAAM,EACN,kBAAkB,GACnB,EAAE;IACD,MAAM,EAAE,OAAO,CAAC;IAChB,kBAAkB,EAAE,kBAAkB,CAAC;CACxC;6BAOuC,GAAG;8BACjB,UAAU;yBACf,UAAU;;;EAiE9B"}

package/lib/biometric-provider.js

@@ -3,61 +3,91 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createBiometricBindingProvider = exports.getIssuerConfigsForNetwork = exports.getBiometricConfigs = exports.assertConfigs = exports.setBiometricConfigs = void 0;
+exports.createBiometricProvider = exports.IDV_EVENTS = exports.hasProofOfBiometrics = exports.getBiometricConfigs = exports.assertConfigs = exports.isBiometricPluginEnabled = exports.setConfigs = void 0;
 const credential_provider_1 = require("./credential-provider");
 const assert_1 = __importDefault(require("assert"));
-let configs = null;
-function setBiometricConfigs(_configs) {
-    configs = _configs;
+const events_1 = require("events");
+const did_provider_1 = require("./did-provider");
+let currentConfigs = null;
+function setConfigs(configs) {
+    currentConfigs = configs;
 }
-exports.setBiometricConfigs = setBiometricConfigs;
-;
+exports.setConfigs = setConfigs;
+function isBiometricPluginEnabled() {
+    return !!currentConfigs?.biometricMatchCredentialType;
+}
+exports.isBiometricPluginEnabled = isBiometricPluginEnabled;
 function assertConfigs() {
-    (0, assert_1.default)(!!configs, 'Biometrics plugin not configured');
+    (0, assert_1.default)(!!currentConfigs, 'Missing biometric provider configs');
 }
 exports.assertConfigs = assertConfigs;
 function getBiometricConfigs() {
     assertConfigs();
-    return configs;
+    return currentConfigs;
 }
 exports.getBiometricConfigs = getBiometricConfigs;
-function getIssuerConfigsForNetwork(networkId) {
-    return getBiometricConfigs()?.issuerConfigs.find(config => config.networkId === networkId);
+function hasProofOfBiometrics(proofRequest) {
+    const fields = proofRequest.input_descriptors
+        ?.map(input => input.constraints?.fields)
+        .flat();
+    const paths = fields.map(field => field.path).flat();
+    return (paths?.includes('$.credentialSubject.biometric.id') &&
+        paths?.includes('$.credentialSubject.biometric.created'));
 }
-exports.getIssuerConfigsForNetwork = getIssuerConfigsForNetwork;
-function createBiometricBindingProvider({ wallet, onEnroll, onMatch, onCheckBiometryRequired, }) {
+exports.hasProofOfBiometrics = hasProofOfBiometrics;
+// map for events
+exports.IDV_EVENTS = {
+    onDeepLink: 'onDeepLink',
+    onMessage: 'onMessage',
+    onError: 'onError',
+    onCancel: 'onCancel',
+    onComplete: 'onComplete',
+};
+function createBiometricProvider({ wallet, idvProviderFactory, }) {
     const credentialProvider = (0, credential_provider_1.createCredentialProvider)({ wallet });
-    return {
-        enrollBiometry: async () => {
-            const enrollmentCredential = await onEnroll();
-            return await credentialProvider.addCredential(enrollmentCredential);
-        },
-        matchBiometry: async () => {
-            const CREDENTIAL_TYPE = configs.enrollmentCredentialType;
-            const enrollmentCredentials = await wallet.getDocumentsByType(CREDENTIAL_TYPE);
-            if (!enrollmentCredentials.length) {
-                throw new Error('Enrollment credential not found');
+    const didProvider = (0, did_provider_1.createDIDProvider)({ wallet });
+    const eventEmitter = new events_1.EventEmitter();
+    const idvProvider = idvProviderFactory.create(eventEmitter, wallet);
+    async function startIDV(proofRequest) {
+        const walletDID = await didProvider.getDefaultDID();
+        let [enrollmentCredential] = await credentialProvider.getCredentials(currentConfigs.enrollmentCredentialType);
+        // Remove any existing match credentials
+        const existingMatchCredentials = await credentialProvider.getCredentials(currentConfigs.biometricMatchCredentialType);
+        for (const credential of existingMatchCredentials) {
+            await credentialProvider.removeCredential(credential.id);
+        }
+        let matchCredential;
+        if (!enrollmentCredential) {
+            // call IDV to start enrollment process and issue the enrollment credential + match credential
+            const credentials = await idvProvider.enroll(walletDID, proofRequest);
+            // check if credential is already in the credential store
+            const receivedViaDistribution = await credentialProvider.getById(credentials.matchCredential.id);
+            if (!receivedViaDistribution) {
+                await credentialProvider.addCredential(credentials.enrollmentCredential);
+                await credentialProvider.addCredential(credentials.matchCredential);
             }
-            const matchConfirmationCredential = await onMatch(enrollmentCredentials[0]);
-            if (matchConfirmationCredential) {
-                const biometricMatchCredentials = await wallet.getDocumentsByType(configs.biometricMatchCredentialType);
-                for (let i = 0; i < biometricMatchCredentials.length; i++) {
-                    await wallet.removeDocument(biometricMatchCredentials[0].id);
-                }
-                await wallet.addDocument(matchConfirmationCredential);
-                // make the biometric credential valid by default
-                await wallet.addDocument({
-                    id: `${matchConfirmationCredential.id}#status`,
-                    status: credential_provider_1.CredentialStatus.Verified,
-                    type: 'CredentialStatus',
-                    createdAt: new Date().toISOString(),
-                    updatedAt: new Date().toISOString(),
-                });
+            matchCredential = credentials.matchCredential;
+            enrollmentCredential = credentials.enrollmentCredential;
+        }
+        else {
+            // call IDV to match the enrollment credential and issue the match credential
+            const credentials = await idvProvider.match(walletDID, enrollmentCredential, proofRequest);
+            // check if credential is already in the credential store
+            const receivedViaDistribution = await credentialProvider.getById(credentials.matchCredential.id);
+            if (!receivedViaDistribution) {
+                await credentialProvider.addCredential(credentials.matchCredential);
             }
-            return matchConfirmationCredential;
-        },
-        checkIsBiometryRequired: onCheckBiometryRequired,
+            matchCredential = credentials.matchCredential;
+        }
+        return {
+            enrollmentCredential,
+            matchCredential,
+        };
+    }
+    return {
+        startIDV,
+        eventEmitter,
     };
 }
-exports.createBiometricBindingProvider = createBiometricBindingProvider;
+exports.createBiometricProvider = createBiometricProvider;
 //# sourceMappingURL=biometric-provider.js.map

package/lib/biometric-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"biometric-provider.js","sourceRoot":"","sources":["../src/biometric-provider.ts"],"names":[],"mappings":";;;;;;AAEA,+DAAiF;AACjF,oDAA4B;AAgB5B,IAAI,OAAO,GAA4B,IAAI,CAAC;AAE5C,SAAgB,mBAAmB,CAAC,QAAiC;IACnE,OAAO,GAAG,QAAQ,CAAC;AACrB,CAAC;AAFD,kDAEC;AAAA,CAAC;AAEF,SAAgB,aAAa;IAC3B,IAAA,gBAAM,EAAC,CAAC,CAAC,OAAO,EAAE,kCAAkC,CAAC,CAAC;AACxD,CAAC;AAFD,sCAEC;AAED,SAAgB,mBAAmB;IACjC,aAAa,EAAE,CAAC;IAChB,OAAO,OAAO,CAAC;AACjB,CAAC;AAHD,kDAGC;AAED,SAAgB,0BAA0B,CAAC,SAAS;IAClD,OAAO,mBAAmB,EAAE,EAAE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;AAC7F,CAAC;AAFD,gEAEC;AAED,SAAgB,8BAA8B,CAAC,EAC7C,MAAM,EACN,QAAQ,EACR,OAAO,EACP,uBAAuB,GAMxB;IACC,MAAM,kBAAkB,GAAG,IAAA,8CAAwB,EAAC,EAAC,MAAM,EAAC,CAAC,CAAC;IAC9D,OAAO;QACL,cAAc,EAAE,KAAK,IAAI,EAAE;YACzB,MAAM,oBAAoB,GAAG,MAAM,QAAQ,EAAE,CAAC;YAC9C,OAAO,MAAM,kBAAkB,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;QACtE,CAAC;QACD,aAAa,EAAE,KAAK,IAAI,EAAE;YACxB,MAAM,eAAe,GAAG,OAAO,CAAC,wBAAwB,CAAC;YACzD,MAAM,qBAAqB,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAC3D,eAAe,CAChB,CAAC;YAEF,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE;gBACjC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;aACpD;YAED,MAAM,2BAA2B,GAAG,MAAM,OAAO,CAC/C,qBAAqB,CAAC,CAAC,CAAC,CACzB,CAAC;YAEF,IAAI,2BAA2B,EAAE;gBAC/B,MAAM,yBAAyB,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;gBACxG,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,yBAAyB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;oBACzD,MAAM,MAAM,CAAC,cAAc,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;iBAC9D;gBAED,MAAM,MAAM,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC;gBACtD,iDAAiD;gBACjD,MAAM,MAAM,CAAC,WAAW,CAAC;oBACvB,EAAE,EAAE,GAAG,2BAA2B,CAAC,EAAE,SAAS;oBAC9C,MAAM,EAAE,sCAAgB,CAAC,QAAQ;oBACjC,IAAI,EAAE,kBAAkB;oBACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC,CAAC,CAAA;aACH;YAED,OAAO,2BAA2B,CAAC;QACrC,CAAC;QACD,uBAAuB,EAAE,uBAAuB;KACjD,CAAC;AACJ,CAAC;AApDD,wEAoDC"}
+{"version":3,"file":"biometric-provider.js","sourceRoot":"","sources":["../src/biometric-provider.ts"],"names":[],"mappings":"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"}

package/lib/cloud-wallet.d.ts

@@ -1,15 +1,114 @@
+/// <reference types="node" />
 import { DataStore } from '@docknetwork/wallet-sdk-data-store/lib/types';
+import { EDVService } from '@docknetwork/wallet-sdk-wasm/lib/services/edv/service';
 export declare const SYNC_MARKER_TYPE = "SyncMarkerDocument";
+export declare const MNEMONIC_WORD_COUNT = 12;
+export declare const KEY_MAPPING_TYPE = "KeyMappingDocument";
+export declare const HKDF_LENGTH = 32;
+export declare const HKDF_HASH = "SHA-256";
+/**
+ * Derives a key from biometric data using HKDF
+ * @param biometricData Biometric data from provider
+ * @param identifier User's identifier as salt (email, phone number, etc.)
+ * @returns Derived key
+ */
+export declare function deriveBiometricKey(biometricData: Buffer, identifier: string): Buffer;
+/**
+ * Derives EDV keys from biometric data for the KeyMappingVault
+ * @param biometricData Biometric data from the provider
+ * @param identifier User's identifier as additional entropy (email, phone number, etc.)
+ * @returns Keys for accessing the KeyMappingVault
+ */
+export declare function deriveKeyMappingVaultKeys(biometricData: Buffer, identifier: string): Promise<{
+    hmacKey: string;
+    agreementKey: string;
+    verificationKey: string;
+}>;
+/**
+ * Generates a key for encrypting/decrypting the master key
+ * @param biometricData Biometric data from provider
+ * @param identifier User's identifier as salt (email, phone number, etc.)
+ * @returns Encryption key and IV for AES encryption
+ */
+export declare function deriveBiometricEncryptionKey(biometricData: Buffer, identifier: string): Promise<{
+    key: Buffer;
+    iv: Buffer;
+}>;
+/**
+ * Encrypts the master key using a key derived from biometric data
+ * @param masterKey The CloudWalletVault master key to encrypt
+ * @param encryptionKey Key derived from biometric data
+ * @param iv Initialization vector
+ * @returns Encrypted master key
+ */
+export declare function encryptMasterKey(masterKey: Uint8Array, encryptionKey: Buffer, iv: Buffer): Promise<Uint8Array>;
+/**
+ * Decrypts the master key using biometric-derived key
+ * @param encryptedKey The encrypted master key
+ * @param decryptionKey Key derived from biometric data
+ * @param iv Initialization vector
+ * @returns The decrypted master key
+ */
+export declare function decryptMasterKey(encryptedKey: Uint8Array, decryptionKey: Buffer, iv: Buffer): Promise<Uint8Array>;
+/**
+ * Initializes the KeyMappingVault using biometric data
+ * @param edvUrl URL for the edv
+ * @param authKey Auth key for the edv
+ * @param biometricData User's biometric data
+ * @param identifier User's identifier (email, phone number, etc.)
+ * @returns Initialized EDV service
+ */
+export declare function initializeKeyMappingVault(edvUrl: string, authKey: string, biometricData: Buffer, identifier: string): Promise<EDVService>;
+/**
+ * Enrolls a user by creating necessary vaults and keys
+ * @param edvUrl URL for the edv
+ * @param authKey Auth key for the edv
+ * @param biometricData Biometric data from provider
+ * @param identifier User's identifier (email, phone number, etc.)
+ * @returns The master key and mnemonic for backup
+ */
+export declare function enrollUserWithBiometrics(edvUrl: string, authKey: string, biometricData: Buffer, identifier: string): Promise<{
+    masterKey: Uint8Array;
+    mnemonic: string;
+}>;
+/**
+ * Gets the master key from the key mapping vault using provided decryption keys
+ * @param keyMappingEdv Initialized key mapping vault service
+ * @param identifier User's identifier (email, phone number, etc.)
+ * @param decryptionKey Key for decrypting the master key
+ * @param iv Initialization vector for decryption
+ * @returns The decrypted master key for CloudWalletVault
+ */
+export declare function getKeyMappingMasterKey(keyMappingEdv: EDVService, identifier: string, decryptionKey: Buffer): Promise<Uint8Array>;
+/**
+ * Authenticates a user with biometric data and identifier
+ * @param edvUrl URL for the edv
+ * @param authKey Auth key for the edv
+ * @param biometricData Biometric data from the provider
+ * @param identifier User's identifier (email, phone number, etc.)
+ * @returns The decrypted master key for CloudWalletVault
+ */
+export declare function authenticateWithBiometrics(edvUrl: string, authKey: string, biometricData: Buffer, identifier: string): Promise<Uint8Array>;
+/**
+ * Initializes the Cloud Wallet using biometric authentication
+ * @param edvUrl Cloud wallet vault URL
+ * @param authKey Cloud wallet auth key
+ * @param biometricData User's biometric data
+ * @param identifier User's identifier (email, phone number, etc.)
+ * @param dataStore Optional data store for the wallet
+ * @returns Initialized cloud wallet
+ */
+export declare function initializeCloudWalletWithBiometrics(edvUrl: string, authKey: string, biometricData: Buffer, identifier: string, dataStore?: any): Promise<any>;
 export declare function generateCloudWalletMasterKey(): Promise<{
     mnemonic: string;
-    masterKey: string;
+    masterKey: Uint8Array;
 }>;
-export declare function recoverCloudWalletMasterKey(mnemonic: string): Promise<string>;
+export declare function recoverCloudWalletMasterKey(mnemonic: string): Promise<Uint8Array>;
 export declare function initializeCloudWallet({ dataStore, edvUrl, authKey, masterKey, }: {
     dataStore?: DataStore;
     edvUrl: string;
     authKey: string;
-    masterKey: any;
+    masterKey: Uint8Array;
 }): Promise<{
     clearEdvDocuments: () => Promise<void>;
     pushSyncMarker: () => Promise<void>;

package/lib/cloud-wallet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-wallet.d.ts","sourceRoot":"","sources":["../src/cloud-wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAEV,MAAM,8CAA8C,CAAC;AAOtD,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AAarD,wBAAsB,4BAA4B,IAAI,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAUrG;AAED,wBAAsB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKnF;AAED,wBAAsB,qBAAqB,CAAC,EAC1C,SAAS,EACT,MAAM,EACN,OAAO,EACP,SAAS,GACV,EAAE;IACD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,GAAG,CAAC;CAChB;;;;;;0BAoE4B,QAAQ,IAAI,CAAC;;;GA2JzC"}
+{"version":3,"file":"cloud-wallet.d.ts","sourceRoot":"","sources":["../src/cloud-wallet.ts"],"names":[],"mappings":";AAAA,OAAO,EACL,SAAS,EAEV,MAAM,8CAA8C,CAAC;AAEtD,OAAO,EAAc,UAAU,EAAE,MAAM,uDAAuD,CAAC;AAK/F,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AACrD,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AACrD,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,SAAS,YAAY,CAAC;AAGnC;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,MAAM,CAIR;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC,CAI7E;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAUtC;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,UAAU,EACrB,aAAa,EAAE,MAAM,EACrB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,UAAU,CAAC,CAmBrB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,UAAU,EACxB,aAAa,EAAE,MAAM,EACrB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,UAAU,CAAC,CAuBrB;AAED;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC,CAiBrB;AAED;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,SAAS,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA6BtD;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,UAAU,EACzB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,UAAU,CAAC,CA0BrB;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC,CAYrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,mCAAmC,CACvD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,GAAG,GACd,OAAO,CAAC,GAAG,CAAC,CAcd;AAaD,wBAAsB,4BAA4B,IAAI,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,UAAU,CAAA;CAAE,CAAC,CASzG;AAED,wBAAsB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAIvF;AAED,wBAAsB,qBAAqB,CAAC,EAC1C,SAAS,EACT,MAAM,EACN,OAAO,EACP,SAAS,GACV,EAAE;IACD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,UAAU,CAAC;CACvB;;;;;;0BAoE4B,QAAQ,IAAI,CAAC;;;GA2JzC"}