@dynamic-labs/waas 4.59.2 → 4.60.0

package/CHANGELOG.md

@@ -1,4 +1,14 @@
 
+## [4.60.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.59.2...v4.60.0) (2026-02-05)
+
+
+### Features
+
+* add prompt to unlock wallet when getting encrypted shares ([#10333](https://github.com/dynamic-labs/dynamic-auth/issues/10333)) ([7009dfa](https://github.com/dynamic-labs/dynamic-auth/commit/7009dfa315538f4f4ad27ff37e7902f10e1cf019))
+* add stellar sendBalance method ([#10310](https://github.com/dynamic-labs/dynamic-auth/issues/10310)) ([c083ea0](https://github.com/dynamic-labs/dynamic-auth/commit/c083ea0a7caa0cb9095d32897acf677c1b661cb4))
+* **webview-controller:** add DelegatedAccessController ([#10348](https://github.com/dynamic-labs/dynamic-auth/issues/10348)) ([57599e4](https://github.com/dynamic-labs/dynamic-auth/commit/57599e4dd1ad6f4b22f98d49d7fae1a724b719ee))
+* **webview-messages:** add DelegatedAccessMessages types ([#10347](https://github.com/dynamic-labs/dynamic-auth/issues/10347)) ([b0a1275](https://github.com/dynamic-labs/dynamic-auth/commit/b0a12759016fa6f8a76753c2394d589acb18ccf1))
+
 ### [4.59.2](https://github.com/dynamic-labs/dynamic-auth/compare/v4.59.1...v4.59.2) (2026-02-03)
 
 

package/package.cjs

@@ -3,6 +3,6 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "4.59.2";
+var version = "4.60.0";
 
 exports.version = version;

package/package.js

@@ -1,4 +1,4 @@
 'use client'
-var version = "4.59.2";
+var version = "4.60.0";
 
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/waas",
-  "version": "4.59.2",
+  "version": "4.60.0",
   "type": "module",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -16,15 +16,15 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@dynamic-labs/assert-package-version": "4.59.2",
+    "@dynamic-labs/assert-package-version": "4.60.0",
     "@dynamic-labs/sdk-api-core": "0.0.860",
-    "@dynamic-labs-wallet/browser-wallet-client": "0.0.254",
-    "@dynamic-labs/ethereum-core": "4.59.2",
-    "@dynamic-labs/logger": "4.59.2",
-    "@dynamic-labs/solana-core": "4.59.2",
-    "@dynamic-labs/sui-core": "4.59.2",
-    "@dynamic-labs/utils": "4.59.2",
-    "@dynamic-labs/wallet-book": "4.59.2"
+    "@dynamic-labs-wallet/browser-wallet-client": "0.0.259",
+    "@dynamic-labs/ethereum-core": "4.60.0",
+    "@dynamic-labs/logger": "4.60.0",
+    "@dynamic-labs/solana-core": "4.60.0",
+    "@dynamic-labs/sui-core": "4.60.0",
+    "@dynamic-labs/utils": "4.60.0",
+    "@dynamic-labs/wallet-book": "4.60.0"
   },
   "peerDependencies": {}
 }

package/src/DynamicWaasMixin.cjs

@@ -37,6 +37,43 @@ const withDynamicWaas = (BaseClass) => {
         setGetMfaTokenFunction(getMfaToken) {
             this.getMfaToken = getMfaToken;
         }
+        setGetPasswordForSigningFunction(getPasswordForSigning) {
+            this.getPasswordForSigning = getPasswordForSigning;
+        }
+        /**
+         * Checks if the wallet needs a password for signing operations.
+         * Returns the password if needed, or undefined if the wallet is already unlocked.
+         * Automatically retrieves the signed session ID internally.
+         */
+        getPasswordIfNeeded(_a) {
+            return _tslib.__awaiter(this, arguments, void 0, function* ({ accountAddress, }) {
+                var _b;
+                const signedSessionId = yield ((_b = this.getSignedSessionId) === null || _b === void 0 ? void 0 : _b.call(this));
+                if (!signedSessionId) {
+                    throw new utils.DynamicError('Signed session ID is required');
+                }
+                const recoveryState = yield this.getWalletRecoveryState({
+                    accountAddress,
+                    signedSessionId,
+                });
+                // If wallet is ready (already unlocked), no password needed
+                if (recoveryState.walletReadyState === 'ready') {
+                    return undefined;
+                }
+                // Wallet is encrypted and needs to be unlocked
+                if (!this.getPasswordForSigning) {
+                    throw new utils.DynamicError('Wallet is locked but no password provider is configured');
+                }
+                const password = yield this.getPasswordForSigning({
+                    accountAddress,
+                    chainName: this.chainName,
+                });
+                if (!password) {
+                    throw new utils.DynamicError('Password is required to sign with this wallet');
+                }
+                return password;
+            });
+        }
         setEnvironmentId(environmentId) {
             this.environmentId = environmentId;
         }
@@ -440,10 +477,11 @@ const withDynamicWaas = (BaseClass) => {
             });
         }
         getWalletRecoveryState(_a) {
-            return _tslib.__awaiter(this, arguments, void 0, function* ({ accountAddress, }) {
+            return _tslib.__awaiter(this, arguments, void 0, function* ({ accountAddress, signedSessionId, }) {
                 const walletClient = yield this.getWaasWalletClient();
                 return walletClient.getWalletRecoveryState({
                     accountAddress,
+                    signedSessionId,
                 });
             });
         }

package/src/DynamicWaasMixin.d.ts

@@ -2,6 +2,10 @@ import { BitcoinConfig, DynamicWalletClient } from '@dynamic-labs-wallet/browser
 import { InstrumentOptions, Logger } from '@dynamic-labs/logger';
 import { MFAAction } from '@dynamic-labs/sdk-api-core';
 import { InstrumentContext, InstrumentationTimer, TraceContext } from '../utils/instrumentation';
+export type GetPasswordForSigningFn = (props: {
+    accountAddress: string;
+    chainName: string;
+}) => Promise<string | undefined>;
 export declare class WaasExportHandler {
     private iframeStamper;
     setIframeStamper(iframe: HTMLIFrameElement): void;
@@ -16,6 +20,7 @@ export declare const withDynamicWaas: <T extends abstract new (...args: any[]) =
     getMfaToken?: ((props?: {
         mfaAction?: MFAAction;
     }) => Promise<string | undefined>) | undefined;
+    getPasswordForSigning?: GetPasswordForSigningFn | undefined;
     getAuthToken?: (() => string) | undefined;
     environmentId?: string | undefined;
     baseApiUrl?: string | undefined;
@@ -32,6 +37,15 @@ export declare const withDynamicWaas: <T extends abstract new (...args: any[]) =
     setGetMfaTokenFunction(getMfaToken: (props?: {
         mfaAction?: MFAAction;
     }) => Promise<string | undefined>): void;
+    setGetPasswordForSigningFunction(getPasswordForSigning: GetPasswordForSigningFn): void;
+    /**
+     * Checks if the wallet needs a password for signing operations.
+     * Returns the password if needed, or undefined if the wallet is already unlocked.
+     * Automatically retrieves the signed session ID internally.
+     */
+    getPasswordIfNeeded({ accountAddress, }: {
+        accountAddress: string;
+    }): Promise<string | undefined>;
     setEnvironmentId(environmentId: string): void;
     setBaseApiUrl(baseApiUrl: string): void;
     setBaseClientKeysharesRelayApiUrl(baseClientKeysharesRelayApiUrl?: string): void;
@@ -116,8 +130,9 @@ export declare const withDynamicWaas: <T extends abstract new (...args: any[]) =
         accountAddress: string;
         password: string;
     }): Promise<import("@dynamic-labs-wallet/browser-wallet-client").GetWalletResponse>;
-    getWalletRecoveryState({ accountAddress, }: {
+    getWalletRecoveryState({ accountAddress, signedSessionId, }: {
         accountAddress: string;
+        signedSessionId: string;
     }): Promise<import("@dynamic-labs-wallet/browser-wallet-client").WalletRecoveryState>;
     endSession(): Promise<void>;
     getActiveAccountAddress(): Promise<string | undefined>;

package/src/DynamicWaasMixin.js

@@ -33,6 +33,43 @@ const withDynamicWaas = (BaseClass) => {
         setGetMfaTokenFunction(getMfaToken) {
             this.getMfaToken = getMfaToken;
         }
+        setGetPasswordForSigningFunction(getPasswordForSigning) {
+            this.getPasswordForSigning = getPasswordForSigning;
+        }
+        /**
+         * Checks if the wallet needs a password for signing operations.
+         * Returns the password if needed, or undefined if the wallet is already unlocked.
+         * Automatically retrieves the signed session ID internally.
+         */
+        getPasswordIfNeeded(_a) {
+            return __awaiter(this, arguments, void 0, function* ({ accountAddress, }) {
+                var _b;
+                const signedSessionId = yield ((_b = this.getSignedSessionId) === null || _b === void 0 ? void 0 : _b.call(this));
+                if (!signedSessionId) {
+                    throw new DynamicError('Signed session ID is required');
+                }
+                const recoveryState = yield this.getWalletRecoveryState({
+                    accountAddress,
+                    signedSessionId,
+                });
+                // If wallet is ready (already unlocked), no password needed
+                if (recoveryState.walletReadyState === 'ready') {
+                    return undefined;
+                }
+                // Wallet is encrypted and needs to be unlocked
+                if (!this.getPasswordForSigning) {
+                    throw new DynamicError('Wallet is locked but no password provider is configured');
+                }
+                const password = yield this.getPasswordForSigning({
+                    accountAddress,
+                    chainName: this.chainName,
+                });
+                if (!password) {
+                    throw new DynamicError('Password is required to sign with this wallet');
+                }
+                return password;
+            });
+        }
         setEnvironmentId(environmentId) {
             this.environmentId = environmentId;
         }
@@ -436,10 +473,11 @@ const withDynamicWaas = (BaseClass) => {
             });
         }
         getWalletRecoveryState(_a) {
-            return __awaiter(this, arguments, void 0, function* ({ accountAddress, }) {
+            return __awaiter(this, arguments, void 0, function* ({ accountAddress, signedSessionId, }) {
                 const walletClient = yield this.getWaasWalletClient();
                 return walletClient.getWalletRecoveryState({
                     accountAddress,
+                    signedSessionId,
                 });
             });
         }