@docknetwork/wallet-sdk-wasm 1.5.14 → 1.7.0

package/generate-docs.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+
+const jsdoc2md = require('jsdoc-to-markdown');
+const fs = require('fs');
+const path = require('path');
+
+async function generateMarkdownDocs() {
+  console.log('Generating markdown documentation...');
+
+  const outputDir = path.resolve('../../docs/api');
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, {recursive: true});
+  }
+
+  const outputFile = path.join(outputDir, 'wasm.md');
+
+  // Get all source files - focusing on main service modules
+  const sourceFiles = [
+    './src/services/blockchain/*.js',
+    './src/services/credential/*.js',
+    './src/services/dids/*.js',
+    './src/services/relay-service/*.js',
+    './src/services/wallet/*.js',
+    './src/services/pex/*.js',
+    './src/services/util-crypto/*.js',
+  ];
+
+  console.log('Processing source files from packages/wasm...');
+
+  const output = await jsdoc2md.render({
+    files: sourceFiles,
+    configure: './jsdoc.conf.json',
+    'no-cache': true,
+    template: `# Wallet SDK WASM API Documentation
+
+{{>main}}
+`,
+  });
+
+  // Ensure we have substantial content
+  fs.writeFileSync(outputFile, output);
+  console.log(`✅ API documentation generated successfully: ${outputFile}`);
+  console.log(`📄 Generated ${output.length} characters of documentation`);
+}
+
+generateMarkdownDocs().catch(error => {
+  console.error('Error generating documentation:', error);
+  process.exit(1);
+});

package/jsdoc.conf.json

@@ -1,8 +1,31 @@
 {
-    "plugins": ["node_modules/jsdoc-babel"],
-    "babel": {
-        "extensions": ["js", "es6", "jsx"],
-        "presets": ["es2015"],
-        "plugins": "transform-flow-strip-types"
-    }
+  "source": {
+    "includePattern": ".+\\.(js|ts)$",
+    "exclude": ["node_modules", "lib", "fixtures", "test", "__tests__"]
+  },
+  "opts": {
+    "destination": "./jsdocs/",
+    "recurse": true
+  },
+  "plugins": [
+    "plugins/markdown",
+    "jsdoc-babel"
+  ],
+  "babel": {
+    "extensions": ["js", "ts"],
+    "ignore": ["**/*.(test|spec).(js|ts)"],
+    "babelrc": false,
+    "presets": [
+      ["@babel/preset-env", { "targets": { "node": "current" } }],
+      ["@babel/preset-typescript", { "allExtensions": true }]
+    ]
+  },
+  "templates": {
+    "cleverLinks": false,
+    "monospaceLinks": false
+  },
+  "tags": {
+    "allowUnknownTags": true,
+    "dictionaries": ["jsdoc", "closure"]
+  }
 }

package/lib/index.js

@@ -26,6 +26,11 @@ require('@scure/bip39');
 require('@scure/bip39/wordlists/english');
 require('./services/util-crypto/configs.js');
 require('@docknetwork/credential-sdk/types');
+require('./services/blockchain/cached-did-resolver.js');
+require('./services/storage/index.js');
+require('./services/storage/service.js');
+require('./services/storage/service-rpc.js');
+require('./services/rpc-service-client.js');
 require('./services/wallet/service.js');
 require('./wallet/memory-storage-wallet.js');
 require('@docknetwork/universal-wallet/storage-wallet');
@@ -34,7 +39,6 @@ require('@docknetwork/universal-wallet/storage/storage-interface');
 require('./services/wallet/configs.js');
 require('./core/validation.js');
 require('./types.js');
-require('./services/storage/service.js');
 require('./services/dids/service.js');
 require('@docknetwork/wallet-sdk-dids/lib');
 require('./services/dids/config.js');
@@ -61,6 +65,9 @@ require('@docknetwork/crypto-wasm-ts/lib/legosnark');
 require('./services/credential/pex-helpers.js');
 require('@astronautlabs/jsonpath');
 require('./services/credential/bbs-revocation.js');
+require('./services/credential/sd-jwt.js');
+require('@sd-jwt/sd-jwt-vc');
+require('@sd-jwt/crypto-nodejs');
 require('./services/relay-service/service.js');
 require('./services/relay-service/configs.js');
 require('@docknetwork/wallet-sdk-relay-service/lib');

package/lib/index.mjs

@@ -24,6 +24,11 @@ import '@scure/bip39';
 import '@scure/bip39/wordlists/english';
 import './services/util-crypto/configs.mjs';
 import '@docknetwork/credential-sdk/types';
+import './services/blockchain/cached-did-resolver.mjs';
+import './services/storage/index.mjs';
+import './services/storage/service.mjs';
+import './services/storage/service-rpc.mjs';
+import './services/rpc-service-client.mjs';
 import './services/wallet/service.mjs';
 import './wallet/memory-storage-wallet.mjs';
 import '@docknetwork/universal-wallet/storage-wallet';
@@ -32,7 +37,6 @@ import '@docknetwork/universal-wallet/storage/storage-interface';
 import './services/wallet/configs.mjs';
 import './core/validation.mjs';
 import './types.mjs';
-import './services/storage/service.mjs';
 import './services/dids/service.mjs';
 import '@docknetwork/wallet-sdk-dids/lib';
 import './services/dids/config.mjs';
@@ -59,6 +63,9 @@ import '@docknetwork/crypto-wasm-ts/lib/legosnark';
 import './services/credential/pex-helpers.mjs';
 import '@astronautlabs/jsonpath';
 import './services/credential/bbs-revocation.mjs';
+import './services/credential/sd-jwt.mjs';
+import '@sd-jwt/sd-jwt-vc';
+import '@sd-jwt/crypto-nodejs';
 import './services/relay-service/service.mjs';
 import './services/relay-service/configs.mjs';
 import '@docknetwork/wallet-sdk-relay-service/lib';

package/lib/rpc-server.js

@@ -22,6 +22,13 @@ require('@scure/bip39');
 require('@scure/bip39/wordlists/english');
 require('./services/util-crypto/configs.js');
 require('@docknetwork/credential-sdk/types');
+require('./services/blockchain/cached-did-resolver.js');
+require('./services/storage/index.js');
+require('./services/storage/service.js');
+require('./services/storage/service-rpc.js');
+require('./services/rpc-service-client.js');
+require('./rpc-client.js');
+require('./logger.js');
 require('./services/wallet/service.js');
 require('./wallet/memory-storage-wallet.js');
 require('@docknetwork/universal-wallet/storage-wallet');
@@ -30,7 +37,6 @@ require('@docknetwork/universal-wallet/storage/storage-interface');
 require('./services/wallet/configs.js');
 require('./core/validation.js');
 require('./types.js');
-require('./services/storage/service.js');
 require('./services/dids/service.js');
 require('@docknetwork/wallet-sdk-dids/lib');
 require('./services/dids/config.js');
@@ -57,6 +63,9 @@ require('@docknetwork/crypto-wasm-ts/lib/legosnark');
 require('./services/credential/pex-helpers.js');
 require('@astronautlabs/jsonpath');
 require('./services/credential/bbs-revocation.js');
+require('./services/credential/sd-jwt.js');
+require('@sd-jwt/sd-jwt-vc');
+require('@sd-jwt/crypto-nodejs');
 require('./services/relay-service/service.js');
 require('./services/relay-service/configs.js');
 require('@docknetwork/wallet-sdk-relay-service/lib');

package/lib/rpc-server.mjs

@@ -20,6 +20,13 @@ import '@scure/bip39';
 import '@scure/bip39/wordlists/english';
 import './services/util-crypto/configs.mjs';
 import '@docknetwork/credential-sdk/types';
+import './services/blockchain/cached-did-resolver.mjs';
+import './services/storage/index.mjs';
+import './services/storage/service.mjs';
+import './services/storage/service-rpc.mjs';
+import './services/rpc-service-client.mjs';
+import './rpc-client.mjs';
+import './logger.mjs';
 import './services/wallet/service.mjs';
 import './wallet/memory-storage-wallet.mjs';
 import '@docknetwork/universal-wallet/storage-wallet';
@@ -28,7 +35,6 @@ import '@docknetwork/universal-wallet/storage/storage-interface';
 import './services/wallet/configs.mjs';
 import './core/validation.mjs';
 import './types.mjs';
-import './services/storage/service.mjs';
 import './services/dids/service.mjs';
 import '@docknetwork/wallet-sdk-dids/lib';
 import './services/dids/config.mjs';
@@ -55,6 +61,9 @@ import '@docknetwork/crypto-wasm-ts/lib/legosnark';
 import './services/credential/pex-helpers.mjs';
 import '@astronautlabs/jsonpath';
 import './services/credential/bbs-revocation.mjs';
+import './services/credential/sd-jwt.mjs';
+import '@sd-jwt/sd-jwt-vc';
+import '@sd-jwt/crypto-nodejs';
 import './services/relay-service/service.mjs';
 import './services/relay-service/configs.mjs';
 import '@docknetwork/wallet-sdk-relay-service/lib';

package/lib/services/blockchain/cached-did-resolver.js

@@ -0,0 +1,113 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var services_storage_index = require('../storage/index.js');
+require('../storage/service.js');
+require('../storage/service-rpc.js');
+require('../rpc-service-client.js');
+require('assert');
+require('../../rpc-client.js');
+require('json-rpc-2.0');
+require('../../core/crypto.js');
+require('crypto');
+require('../../core/logger.js');
+require('../../logger.js');
+require('../../rpc-util.js');
+
+class CachedDIDResolver {
+    router;
+    ttl;
+    CACHE_PREFIX = 'did-cache:';
+    constructor(router, cacheOptions = {}) {
+        this.router = router;
+        // 1 hour default
+        this.ttl = cacheOptions.ttl || 60 * 60 * 1000;
+    }
+    getCacheKey(did) {
+        return `${this.CACHE_PREFIX}${did}`;
+    }
+    async getCacheEntry(did) {
+        const key = this.getCacheKey(did);
+        const data = await services_storage_index.storageService.getItem(key);
+        try {
+            return data ? JSON.parse(data) : null;
+        }
+        catch (error) {
+            console.error('Error parsing cache entry:', error);
+            return null;
+        }
+    }
+    async setCacheEntry(did, entry) {
+        const key = this.getCacheKey(did);
+        await services_storage_index.storageService.setItem(key, JSON.stringify(entry));
+    }
+    async getCachedDIDs() {
+        const allKeys = await services_storage_index.storageService.getAllKeys();
+        const cachedDIDs = [];
+        allKeys.forEach(key => {
+            if (key.startsWith(this.CACHE_PREFIX)) {
+                cachedDIDs.push(key.replace(this.CACHE_PREFIX, ''));
+            }
+        });
+        return cachedDIDs;
+    }
+    async resolve(did) {
+        const cached = await this.getCacheEntry(did);
+        if (cached) {
+            if (Date.now() - cached.timestamp < this.ttl) {
+                console.log('Cache hit for:', did);
+                return cached.value;
+            }
+            else {
+                console.log('Cache expired for:', did, 'returning stale value and refreshing in background');
+                this.refreshInBackground(did);
+                return cached.value;
+            }
+        }
+        console.log('Cache miss, resolving:', did);
+        const result = await this.router.resolve(did);
+        await this.setCacheEntry(result.id, {
+            value: result,
+            id: result.id,
+            timestamp: Date.now()
+        });
+        return result;
+    }
+    async refreshInBackground(did) {
+        try {
+            console.log('Refreshing cache in background for:', did);
+            const result = await this.router.resolve(did);
+            await this.setCacheEntry(did, {
+                value: result,
+                id: did,
+                timestamp: Date.now()
+            });
+            console.log('Background refresh completed for:', did);
+        }
+        catch (error) {
+            console.warn('Background refresh failed for:', did, error);
+        }
+    }
+    /**
+     * if the did is provided, it will remove the specific did from the cache
+     * otherwise, it will clear the entire cache
+     * @param did
+     */
+    async clearCache(did) {
+        if (did) {
+            const key = this.getCacheKey(did);
+            await services_storage_index.storageService.removeItem(key);
+        }
+        else {
+            const allKeys = await services_storage_index.storageService.getAllKeys();
+            const cacheKeys = allKeys.filter(key => key.startsWith(this.CACHE_PREFIX));
+            await Promise.all(cacheKeys.map(key => services_storage_index.storageService.removeItem(key)));
+        }
+    }
+    supports(id) {
+        return this.router.supports(id);
+    }
+}
+
+exports.CachedDIDResolver = CachedDIDResolver;

package/lib/services/blockchain/cached-did-resolver.mjs

@@ -0,0 +1,109 @@
+import { storageService } from '../storage/index.mjs';
+import '../storage/service.mjs';
+import '../storage/service-rpc.mjs';
+import '../rpc-service-client.mjs';
+import 'assert';
+import '../../rpc-client.mjs';
+import 'json-rpc-2.0';
+import '../../core/crypto.mjs';
+import 'crypto';
+import '../../core/logger.mjs';
+import '../../logger.mjs';
+import '../../rpc-util.mjs';
+
+class CachedDIDResolver {
+    router;
+    ttl;
+    CACHE_PREFIX = 'did-cache:';
+    constructor(router, cacheOptions = {}) {
+        this.router = router;
+        // 1 hour default
+        this.ttl = cacheOptions.ttl || 60 * 60 * 1000;
+    }
+    getCacheKey(did) {
+        return `${this.CACHE_PREFIX}${did}`;
+    }
+    async getCacheEntry(did) {
+        const key = this.getCacheKey(did);
+        const data = await storageService.getItem(key);
+        try {
+            return data ? JSON.parse(data) : null;
+        }
+        catch (error) {
+            console.error('Error parsing cache entry:', error);
+            return null;
+        }
+    }
+    async setCacheEntry(did, entry) {
+        const key = this.getCacheKey(did);
+        await storageService.setItem(key, JSON.stringify(entry));
+    }
+    async getCachedDIDs() {
+        const allKeys = await storageService.getAllKeys();
+        const cachedDIDs = [];
+        allKeys.forEach(key => {
+            if (key.startsWith(this.CACHE_PREFIX)) {
+                cachedDIDs.push(key.replace(this.CACHE_PREFIX, ''));
+            }
+        });
+        return cachedDIDs;
+    }
+    async resolve(did) {
+        const cached = await this.getCacheEntry(did);
+        if (cached) {
+            if (Date.now() - cached.timestamp < this.ttl) {
+                console.log('Cache hit for:', did);
+                return cached.value;
+            }
+            else {
+                console.log('Cache expired for:', did, 'returning stale value and refreshing in background');
+                this.refreshInBackground(did);
+                return cached.value;
+            }
+        }
+        console.log('Cache miss, resolving:', did);
+        const result = await this.router.resolve(did);
+        await this.setCacheEntry(result.id, {
+            value: result,
+            id: result.id,
+            timestamp: Date.now()
+        });
+        return result;
+    }
+    async refreshInBackground(did) {
+        try {
+            console.log('Refreshing cache in background for:', did);
+            const result = await this.router.resolve(did);
+            await this.setCacheEntry(did, {
+                value: result,
+                id: did,
+                timestamp: Date.now()
+            });
+            console.log('Background refresh completed for:', did);
+        }
+        catch (error) {
+            console.warn('Background refresh failed for:', did, error);
+        }
+    }
+    /**
+     * if the did is provided, it will remove the specific did from the cache
+     * otherwise, it will clear the entire cache
+     * @param did
+     */
+    async clearCache(did) {
+        if (did) {
+            const key = this.getCacheKey(did);
+            await storageService.removeItem(key);
+        }
+        else {
+            const allKeys = await storageService.getAllKeys();
+            const cacheKeys = allKeys.filter(key => key.startsWith(this.CACHE_PREFIX));
+            await Promise.all(cacheKeys.map(key => storageService.removeItem(key)));
+        }
+    }
+    supports(id) {
+        return this.router.supports(id);
+    }
+}
+
+export { CachedDIDResolver };

package/lib/services/blockchain/index.js

@@ -19,6 +19,17 @@ require('@scure/bip39');
 require('@scure/bip39/wordlists/english');
 require('../util-crypto/configs.js');
 require('@docknetwork/credential-sdk/types');
+require('./cached-did-resolver.js');
+require('../storage/index.js');
+require('../storage/service.js');
+require('../storage/service-rpc.js');
+require('../rpc-service-client.js');
+require('../../rpc-client.js');
+require('json-rpc-2.0');
+require('../../core/crypto.js');
+require('crypto');
+require('../../logger.js');
+require('../../rpc-util.js');
 
 
 

package/lib/services/blockchain/index.mjs

@@ -15,3 +15,14 @@ import '@scure/bip39';
 import '@scure/bip39/wordlists/english';
 import '../util-crypto/configs.mjs';
 import '@docknetwork/credential-sdk/types';
+import './cached-did-resolver.mjs';
+import '../storage/index.mjs';
+import '../storage/service.mjs';
+import '../storage/service-rpc.mjs';
+import '../rpc-service-client.mjs';
+import '../../rpc-client.mjs';
+import 'json-rpc-2.0';
+import '../../core/crypto.mjs';
+import 'crypto';
+import '../../logger.mjs';
+import '../../rpc-util.mjs';

package/lib/services/blockchain/service-rpc.js

@@ -55,6 +55,18 @@ class BlockchainServiceRpc extends services_rpcServiceClient.RpcService {
   resolveDID(did        )               {
     return this.call('resolveDID', did);
   }
+
+  getCachedDIDs()               {
+    return this.call('getCachedDIDs');
+  }
+
+  getCacheEntry(did        )               {
+    return this.call('getCacheEntry', did);
+  }
+
+  clearCache(did         )               {
+    return this.call('clearCache', did);
+  }
 }
 
 exports.BlockchainServiceRpc = BlockchainServiceRpc;

package/lib/services/blockchain/service-rpc.mjs

@@ -51,6 +51,18 @@ class BlockchainServiceRpc extends RpcService {
   resolveDID(did        )               {
     return this.call('resolveDID', did);
   }
+
+  getCachedDIDs()               {
+    return this.call('getCachedDIDs');
+  }
+
+  getCacheEntry(did        )               {
+    return this.call('getCacheEntry', did);
+  }
+
+  clearCache(did         )               {
+    return this.call('clearCache', did);
+  }
 }
 
 export { BlockchainServiceRpc };