@dynamic-labs/sdk-react-core 5.0.0-rc.4 → 5.1.0

package/src/lib/utils/hooks/useBusinessAccounts/useBusinessAccounts.d.ts

@@ -2,7 +2,10 @@ export type BusinessAccountMemberRole = 'owner' | 'admin' | 'viewer';
 export type CreateBusinessAccountInput = {
     name?: string;
     externalRef?: string;
-    metadata?: object;
+    metadata?: Record<string, unknown>;
+};
+export type ListBusinessAccountsInput = {
+    externalRefs?: string[];
 };
 export type AddBusinessAccountMemberInput = {
     businessAccountId: string;
@@ -21,6 +24,32 @@ export type AddWalletToBusinessAccountInput = {
     businessAccountId?: string;
     walletId: string;
 };
+export type RemoveBusinessAccountMemberInput = {
+    businessAccountId: string;
+    userId: string;
+};
+export type UpdateBusinessAccountMemberRoleInput = {
+    businessAccountId: string;
+    userId: string;
+    role: 'admin' | 'viewer';
+};
+export type TransferBusinessAccountOwnershipInput = {
+    businessAccountId: string;
+    newOwnerUserId: string;
+};
+export type RemoveBusinessAccountWalletInput = {
+    businessAccountId: string;
+    walletId: string;
+};
+export type RemoveBusinessAccountSignerInput = {
+    businessAccountId: string;
+    walletId: string;
+    signerId: string;
+};
+export type UpdateBusinessAccountInput = {
+    businessAccountId: string;
+    name: string;
+};
 export type BusinessAccountSignerIdentifierType = 'email' | 'phoneNumber' | 'externalUserId' | 'socialUsername' | 'socialAccountId' | 'id';
 export type BusinessAccountSignerType = 'endUser' | 'server';
 export type TargetSignerIdentity = {
@@ -52,6 +81,12 @@ export declare const useBusinessAccounts: () => {
     defaultChainName: string | undefined;
     enabledChainNames: string[];
     getBusinessAccount: (businessAccountId: string) => Promise<any>;
-    listBusinessAccounts: () => Promise<any>;
+    listBusinessAccounts: (input?: ListBusinessAccountsInput) => Promise<any>;
     listMyWalletAccounts: () => Promise<any>;
+    removeBusinessAccountMember: ({ businessAccountId, userId }: RemoveBusinessAccountMemberInput) => Promise<import("@dynamic-labs-sdk/client/waas").BusinessAccountMember>;
+    removeBusinessAccountSigner: (input: RemoveBusinessAccountSignerInput) => Promise<import("@dynamic-labs-sdk/client/waas").BusinessAccountSigner>;
+    removeBusinessAccountWallet: (input: RemoveBusinessAccountWalletInput) => Promise<import("@dynamic-labs-sdk/client/waas").BusinessAccountDetail>;
+    transferBusinessAccountOwnership: (input: TransferBusinessAccountOwnershipInput) => Promise<import("@dynamic-labs-sdk/client/waas").BusinessAccountDetail>;
+    updateBusinessAccount: (input: UpdateBusinessAccountInput) => Promise<import("@dynamic-labs-sdk/client/waas").BusinessAccount>;
+    updateBusinessAccountMemberRole: (input: UpdateBusinessAccountMemberRoleInput) => Promise<import("@dynamic-labs-sdk/client/waas").BusinessAccountMember>;
 };

package/src/lib/utils/hooks/useBusinessAccounts/useBusinessAccounts.js

@@ -1,10 +1,10 @@
 'use client'
 import { __awaiter } from '../../../../../_virtual/_tslib.js';
 import { useMemo, useCallback } from 'react';
+import { removeBusinessAccountMember, updateBusinessAccountMemberRole, transferBusinessAccountOwnership, removeBusinessAccountWallet, removeBusinessAccountSigner, updateBusinessAccount } from '@dynamic-labs-sdk/client/waas';
+import { useDynamicClient } from '../../../client/client.js';
 import '@dynamic-labs-sdk/client/core';
 import '@dynamic-labs/sdk-api-core';
-import 'eventemitter3';
-import '@dynamic-labs/utils';
 import '@dynamic-labs-sdk/client';
 import '../../../config/ApiEndpoint.js';
 import '@dynamic-labs/iconic';
@@ -13,6 +13,7 @@ import 'react/jsx-runtime';
 import '../../../context/ViewContext/ViewContext.js';
 import '../../../shared/logger.js';
 import '@dynamic-labs/wallet-book';
+import '@dynamic-labs/utils';
 import '../../constants/colors.js';
 import '../../constants/values.js';
 import '../../../shared/consts/index.js';
@@ -34,6 +35,7 @@ const NO_CONNECTOR_ERROR = 'WaaS wallet connector not found';
 const useBusinessAccounts = () => {
     const { getWaasWalletConnector } = useDynamicWaas();
     const projectSettings = useProjectSettings();
+    const dynamicClient = useDynamicClient();
     const enabledChainNames = useMemo(() => {
         var _a, _b;
         return ((_b = (_a = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk.embeddedWallets) === null || _a === void 0 ? void 0 : _a.chainConfigurations) !== null && _b !== void 0 ? _b : [])
@@ -62,9 +64,9 @@ const useBusinessAccounts = () => {
         const client = yield getBusinessClient();
         return client.businessAccounts.createBusinessAccount({ request: input });
     }), [getBusinessClient]);
-    const listBusinessAccounts = useCallback(() => __awaiter(void 0, void 0, void 0, function* () {
+    const listBusinessAccounts = useCallback((input) => __awaiter(void 0, void 0, void 0, function* () {
         const client = yield getBusinessClient();
-        return client.businessAccounts.listBusinessAccounts();
+        return client.businessAccounts.listBusinessAccounts({ request: input });
     }), [getBusinessClient]);
     const getBusinessAccount = useCallback((businessAccountId) => __awaiter(void 0, void 0, void 0, function* () {
         const client = yield getBusinessClient();
@@ -128,6 +130,14 @@ const useBusinessAccounts = () => {
         const client = yield getBusinessClient();
         return client.getWallets();
     }), [getBusinessClient]);
+    const removeBusinessAccountMember$1 = useCallback((_c) => __awaiter(void 0, [_c], void 0, function* ({ businessAccountId, userId }) {
+        return removeBusinessAccountMember({ businessAccountId, userId }, dynamicClient);
+    }), [dynamicClient]);
+    const updateBusinessAccountMemberRole$1 = useCallback((input) => __awaiter(void 0, void 0, void 0, function* () { return updateBusinessAccountMemberRole(input, dynamicClient); }), [dynamicClient]);
+    const transferBusinessAccountOwnership$1 = useCallback((input) => __awaiter(void 0, void 0, void 0, function* () { return transferBusinessAccountOwnership(input, dynamicClient); }), [dynamicClient]);
+    const removeBusinessAccountWallet$1 = useCallback((input) => __awaiter(void 0, void 0, void 0, function* () { return removeBusinessAccountWallet(input, dynamicClient); }), [dynamicClient]);
+    const removeBusinessAccountSigner$1 = useCallback((input) => __awaiter(void 0, void 0, void 0, function* () { return removeBusinessAccountSigner(input, dynamicClient); }), [dynamicClient]);
+    const updateBusinessAccount$1 = useCallback((input) => __awaiter(void 0, void 0, void 0, function* () { return updateBusinessAccount(input, dynamicClient); }), [dynamicClient]);
     return {
         addBusinessAccountMember,
         addBusinessAccountSigner,
@@ -139,6 +149,12 @@ const useBusinessAccounts = () => {
         getBusinessAccount,
         listBusinessAccounts,
         listMyWalletAccounts,
+        removeBusinessAccountMember: removeBusinessAccountMember$1,
+        removeBusinessAccountSigner: removeBusinessAccountSigner$1,
+        removeBusinessAccountWallet: removeBusinessAccountWallet$1,
+        transferBusinessAccountOwnership: transferBusinessAccountOwnership$1,
+        updateBusinessAccount: updateBusinessAccount$1,
+        updateBusinessAccountMemberRole: updateBusinessAccountMemberRole$1,
     };
 };
 

package/src/lib/utils/hooks/useDynamicModals/useDynamicModals.cjs

@@ -115,6 +115,7 @@ require('../../../store/state/tokenBalances.cjs');
 require('../../../store/state/multichainBalances.cjs');
 require('@dynamic-labs/store');
 require('../../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
+require('@dynamic-labs-sdk/client/waas');
 
 /**
  * this hook wraps `setShowAuthFlow`. WalletConnect requires initialization

package/src/lib/utils/hooks/useDynamicModals/useDynamicModals.js

@@ -111,6 +111,7 @@ import '../../../store/state/tokenBalances.js';
 import '../../../store/state/multichainBalances.js';
 import '@dynamic-labs/store';
 import '../../../shared/utils/functions/getInitialUrl/getInitialUrl.js';
+import '@dynamic-labs-sdk/client/waas';
 
 /**
  * this hook wraps `setShowAuthFlow`. WalletConnect requires initialization

package/src/lib/utils/hooks/useEmailProvider/useEmailProvider.cjs

@@ -113,6 +113,7 @@ require('../../../store/state/tokenBalances.cjs');
 require('../../../store/state/multichainBalances.cjs');
 require('@dynamic-labs/store');
 require('../../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
+require('@dynamic-labs-sdk/client/waas');
 require('../../../context/ConnectWithOtpContext/ConnectWithOtpContext.cjs');
 var useConnectWithOtp = require('../../../context/ConnectWithOtpContext/useConnectWithOtp.cjs');
 

package/src/lib/utils/hooks/useEmailProvider/useEmailProvider.js

@@ -109,6 +109,7 @@ import '../../../store/state/tokenBalances.js';
 import '../../../store/state/multichainBalances.js';
 import '@dynamic-labs/store';
 import '../../../shared/utils/functions/getInitialUrl/getInitialUrl.js';
+import '@dynamic-labs-sdk/client/waas';
 import '../../../context/ConnectWithOtpContext/ConnectWithOtpContext.js';
 import { useConnectWithOtp } from '../../../context/ConnectWithOtpContext/useConnectWithOtp.js';
 

package/src/lib/utils/hooks/useNetworkNotSupported/useNetworkNotSupported.cjs

@@ -115,6 +115,7 @@ require('../../../store/state/tokenBalances.cjs');
 require('../../../store/state/multichainBalances.cjs');
 require('@dynamic-labs/store');
 require('../../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
+require('@dynamic-labs-sdk/client/waas');
 
 const useNetworkNotSupported = () => {
     const { selectedWalletConnector: walletConnector, setShowAuthFlow, bridgeChainsToConnect, bridgeOnboardingCompleted, isBridgeFlow, user, } = useInternalDynamicContext.useInternalDynamicContext();

package/src/lib/utils/hooks/useNetworkNotSupported/useNetworkNotSupported.js

@@ -111,6 +111,7 @@ import '../../../store/state/tokenBalances.js';
 import '../../../store/state/multichainBalances.js';
 import '@dynamic-labs/store';
 import '../../../shared/utils/functions/getInitialUrl/getInitialUrl.js';
+import '@dynamic-labs-sdk/client/waas';
 
 const useNetworkNotSupported = () => {
     const { selectedWalletConnector: walletConnector, setShowAuthFlow, bridgeChainsToConnect, bridgeOnboardingCompleted, isBridgeFlow, user, } = useInternalDynamicContext();

package/src/lib/utils/hooks/useStepUpAuthentication/useStepUpMfa.cjs

@@ -23,7 +23,7 @@ const useStepUpMfa = ({ stateActions }) => {
                 ? error.message
                 : 'Failed to authenticate passkey for step-up authentication';
             setError(errorMessage);
-            return null;
+            throw error;
         }
     }), [setError, setLoading, setSuccess]);
     const verifyTotpMfa = React.useCallback((_b) => _tslib.__awaiter(void 0, [_b], void 0, function* ({ code, deviceId, requestedScopes, }) {
@@ -42,7 +42,7 @@ const useStepUpMfa = ({ stateActions }) => {
                 ? error.message
                 : 'Failed to authenticate TOTP device for step-up authentication';
             setError(errorMessage);
-            return null;
+            throw error;
         }
     }), [setError, setLoading, setSuccess]);
     const verifyRecoveryCode = React.useCallback((_c) => _tslib.__awaiter(void 0, [_c], void 0, function* ({ code, requestedScopes, }) {
@@ -60,7 +60,7 @@ const useStepUpMfa = ({ stateActions }) => {
                 ? error.message
                 : 'Failed to authenticate recovery code for step-up authentication';
             setError(errorMessage);
-            return null;
+            throw error;
         }
     }), [setError, setLoading, setSuccess]);
     return { verifyPasskeyMfa, verifyRecoveryCode, verifyTotpMfa };

package/src/lib/utils/hooks/useStepUpAuthentication/useStepUpMfa.js

@@ -19,7 +19,7 @@ const useStepUpMfa = ({ stateActions }) => {
                 ? error.message
                 : 'Failed to authenticate passkey for step-up authentication';
             setError(errorMessage);
-            return null;
+            throw error;
         }
     }), [setError, setLoading, setSuccess]);
     const verifyTotpMfa = useCallback((_b) => __awaiter(void 0, [_b], void 0, function* ({ code, deviceId, requestedScopes, }) {
@@ -38,7 +38,7 @@ const useStepUpMfa = ({ stateActions }) => {
                 ? error.message
                 : 'Failed to authenticate TOTP device for step-up authentication';
             setError(errorMessage);
-            return null;
+            throw error;
         }
     }), [setError, setLoading, setSuccess]);
     const verifyRecoveryCode = useCallback((_c) => __awaiter(void 0, [_c], void 0, function* ({ code, requestedScopes, }) {
@@ -56,7 +56,7 @@ const useStepUpMfa = ({ stateActions }) => {
                 ? error.message
                 : 'Failed to authenticate recovery code for step-up authentication';
             setError(errorMessage);
-            return null;
+            throw error;
         }
     }), [setError, setLoading, setSuccess]);
     return { verifyPasskeyMfa, verifyRecoveryCode, verifyTotpMfa };

package/src/lib/utils/hooks/useSubmitExchangeFunding/useSubmitExchangeFunding.cjs

@@ -109,6 +109,7 @@ require('../../../store/state/tokenBalances.cjs');
 require('../../../store/state/multichainBalances.cjs');
 require('@dynamic-labs/store');
 require('../../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
+require('@dynamic-labs-sdk/client/waas');
 var useExchangeAccounts = require('../useExchangeAccounts/useExchangeAccounts.cjs');
 require('../../../components/InlineWidget/InlineWidget.cjs');
 require('../../../components/IsBrowser/IsBrowser.cjs');

package/src/lib/utils/hooks/useSubmitExchangeFunding/useSubmitExchangeFunding.js

@@ -105,6 +105,7 @@ import '../../../store/state/tokenBalances.js';
 import '../../../store/state/multichainBalances.js';
 import '@dynamic-labs/store';
 import '../../../shared/utils/functions/getInitialUrl/getInitialUrl.js';
+import '@dynamic-labs-sdk/client/waas';
 import { useExchangeAccounts } from '../useExchangeAccounts/useExchangeAccounts.js';
 import '../../../components/InlineWidget/InlineWidget.js';
 import '../../../components/IsBrowser/IsBrowser.js';

package/src/lib/utils/hooks/useSyncDynamicWaas/useSyncDynamicWaas.cjs

@@ -44,6 +44,14 @@ var useWalletDelegation = require('../useWalletDelegation/useWalletDelegation.cj
 require('../useWalletDelegation/DelegationError.cjs');
 var instrumentWalletCreation = require('./instrumentWalletCreation.cjs');
 
+const DEFAULT_SDK_LOAD_STATE = {
+    attempt: 0,
+    error: null,
+    maxAttempts: 0,
+    nextRetryAt: null,
+    phase: null,
+    status: 'idle',
+};
 // Validate if all required conditions are met for wallet creation
 const useWalletCreationValidation = () => {
     const user = useOnboardingCompleteUser.useOnboardingCompleteUser();
@@ -160,6 +168,71 @@ const useSyncDynamicWaas = () => {
     const hasWaasInitializedRef = React.useRef(false);
     const sessionIdRef = React.useRef(undefined);
     const initializingWaasRef = React.useRef(false);
+    const sdkLoadStateCacheRef = React.useRef(DEFAULT_SDK_LOAD_STATE);
+    // Track the SDK webview load state so WaaS init can be gated on whether the
+    // webview/iframe is ready, and can be retried after a recovery. Using
+    // useSyncExternalStore instead of useEffect/useState avoids the race between
+    // initial state read and subscription, handles server/client snapshots, and
+    // gives React the standard external-store integration for concurrent renders.
+    const client$1 = client.getDynamicClient();
+    const sdkModule = client$1.sdk;
+    const getSdkLoadState = React.useCallback(() => {
+        if (!sdkModule) {
+            return DEFAULT_SDK_LOAD_STATE;
+        }
+        const next = sdkModule.loadState;
+        const prev = sdkLoadStateCacheRef.current;
+        // The production store allocates a new object on every read, but
+        // useSyncExternalStore requires referential stability between store events.
+        // Return the cached snapshot unless a field actually changed.
+        if (next.status === prev.status &&
+            next.phase === prev.phase &&
+            next.attempt === prev.attempt &&
+            next.maxAttempts === prev.maxAttempts &&
+            next.nextRetryAt === prev.nextRetryAt &&
+            next.error === prev.error) {
+            return prev;
+        }
+        sdkLoadStateCacheRef.current = next;
+        return next;
+    }, [sdkModule]);
+    const subscribeToSdkLoadState = React.useCallback((onStoreChange) => {
+        if (!sdkModule) {
+            return () => { };
+        }
+        const handleLoadStateChanged = () => {
+            onStoreChange();
+        };
+        sdkModule.on('loadStateChanged', handleLoadStateChanged);
+        return () => {
+            sdkModule.off('loadStateChanged', handleLoadStateChanged);
+        };
+    }, [sdkModule]);
+    const sdkLoadState = React.useSyncExternalStore(subscribeToSdkLoadState, getSdkLoadState, getSdkLoadState);
+    const isSdkReadyForWaas = React.useCallback(() => {
+        // No SDK webview load controller is present (e.g. web platform using the
+        // standard React SDK client). WaaS uses its own iframe lifecycle there, so
+        // do not block initialization based on a non-existent webview load state.
+        if (!sdkModule || sdkLoadState.maxAttempts === 0) {
+            return true;
+        }
+        // The webview/iframe is loaded and ready. This covers platforms (RN) whose
+        // load controller reaches the ready state.
+        if (sdkLoadState.status === 'ready') {
+            return true;
+        }
+        return false;
+    }, [sdkLoadState, sdkModule]);
+    React.useEffect(() => {
+        if (sdkLoadState.status === 'failed') {
+            // Mark WaaS as not initialized so a retry can re-run it once the webview
+            // recovers. Do not reset initializingWaasRef here: if an initializeWaas
+            // call is already in flight, the existing guard should remain until its
+            // .finally clears it, otherwise a quick failure-then-recovery could start
+            // a duplicate initialization.
+            hasWaasInitializedRef.current = false;
+        }
+    }, [sdkLoadState.status]);
     useDynamicEvents.useInternalDynamicEvents('logout', () => {
         triggeredCreate.current = false;
         triggeredSettingsProcessing.current = false;
@@ -226,7 +299,7 @@ const useSyncDynamicWaas = () => {
             initializingWaasRef.current = false;
             clearRecoveredWallets();
         }
-        if (shouldInitializeWaas && (user === null || user === void 0 ? void 0 : user.sessionId)) {
+        if (shouldInitializeWaas && (user === null || user === void 0 ? void 0 : user.sessionId) && isSdkReadyForWaas()) {
             const { sessionId, id: userId } = user;
             const shouldInitialize = !initializingWaasRef.current &&
                 (!hasWaasInitializedRef.current || sessionIdRef.current !== sessionId);
@@ -277,7 +350,14 @@ const useSyncDynamicWaas = () => {
                 });
             }
         }
-    }, [initializeWaas, shouldInitializeWaas, user]);
+    }, [
+        initializeWaas,
+        shouldInitializeWaas,
+        user,
+        isSdkReadyForWaas,
+        clearRecoveredWallets,
+        environmentId,
+    ]);
     React.useEffect(() => {
         if (shouldCreateWallets()) {
             handleWalletCreation();

package/src/lib/utils/hooks/useSyncDynamicWaas/useSyncDynamicWaas.js

@@ -1,6 +1,6 @@
 'use client'
 import { __awaiter } from '../../../../../_virtual/_tslib.js';
-import { useRef, useCallback, useEffect } from 'react';
+import { useRef, useCallback, useSyncExternalStore, useEffect } from 'react';
 import { getDynamicClient } from '../../../client/client.js';
 import '@dynamic-labs-sdk/client/core';
 import '@dynamic-labs/sdk-api-core';
@@ -40,6 +40,14 @@ import { useWalletDelegation } from '../useWalletDelegation/useWalletDelegation.
 import '../useWalletDelegation/DelegationError.js';
 import { instrumentWalletCreation } from './instrumentWalletCreation.js';
 
+const DEFAULT_SDK_LOAD_STATE = {
+    attempt: 0,
+    error: null,
+    maxAttempts: 0,
+    nextRetryAt: null,
+    phase: null,
+    status: 'idle',
+};
 // Validate if all required conditions are met for wallet creation
 const useWalletCreationValidation = () => {
     const user = useOnboardingCompleteUser();
@@ -156,6 +164,71 @@ const useSyncDynamicWaas = () => {
     const hasWaasInitializedRef = useRef(false);
     const sessionIdRef = useRef(undefined);
     const initializingWaasRef = useRef(false);
+    const sdkLoadStateCacheRef = useRef(DEFAULT_SDK_LOAD_STATE);
+    // Track the SDK webview load state so WaaS init can be gated on whether the
+    // webview/iframe is ready, and can be retried after a recovery. Using
+    // useSyncExternalStore instead of useEffect/useState avoids the race between
+    // initial state read and subscription, handles server/client snapshots, and
+    // gives React the standard external-store integration for concurrent renders.
+    const client = getDynamicClient();
+    const sdkModule = client.sdk;
+    const getSdkLoadState = useCallback(() => {
+        if (!sdkModule) {
+            return DEFAULT_SDK_LOAD_STATE;
+        }
+        const next = sdkModule.loadState;
+        const prev = sdkLoadStateCacheRef.current;
+        // The production store allocates a new object on every read, but
+        // useSyncExternalStore requires referential stability between store events.
+        // Return the cached snapshot unless a field actually changed.
+        if (next.status === prev.status &&
+            next.phase === prev.phase &&
+            next.attempt === prev.attempt &&
+            next.maxAttempts === prev.maxAttempts &&
+            next.nextRetryAt === prev.nextRetryAt &&
+            next.error === prev.error) {
+            return prev;
+        }
+        sdkLoadStateCacheRef.current = next;
+        return next;
+    }, [sdkModule]);
+    const subscribeToSdkLoadState = useCallback((onStoreChange) => {
+        if (!sdkModule) {
+            return () => { };
+        }
+        const handleLoadStateChanged = () => {
+            onStoreChange();
+        };
+        sdkModule.on('loadStateChanged', handleLoadStateChanged);
+        return () => {
+            sdkModule.off('loadStateChanged', handleLoadStateChanged);
+        };
+    }, [sdkModule]);
+    const sdkLoadState = useSyncExternalStore(subscribeToSdkLoadState, getSdkLoadState, getSdkLoadState);
+    const isSdkReadyForWaas = useCallback(() => {
+        // No SDK webview load controller is present (e.g. web platform using the
+        // standard React SDK client). WaaS uses its own iframe lifecycle there, so
+        // do not block initialization based on a non-existent webview load state.
+        if (!sdkModule || sdkLoadState.maxAttempts === 0) {
+            return true;
+        }
+        // The webview/iframe is loaded and ready. This covers platforms (RN) whose
+        // load controller reaches the ready state.
+        if (sdkLoadState.status === 'ready') {
+            return true;
+        }
+        return false;
+    }, [sdkLoadState, sdkModule]);
+    useEffect(() => {
+        if (sdkLoadState.status === 'failed') {
+            // Mark WaaS as not initialized so a retry can re-run it once the webview
+            // recovers. Do not reset initializingWaasRef here: if an initializeWaas
+            // call is already in flight, the existing guard should remain until its
+            // .finally clears it, otherwise a quick failure-then-recovery could start
+            // a duplicate initialization.
+            hasWaasInitializedRef.current = false;
+        }
+    }, [sdkLoadState.status]);
     useInternalDynamicEvents('logout', () => {
         triggeredCreate.current = false;
         triggeredSettingsProcessing.current = false;
@@ -222,7 +295,7 @@ const useSyncDynamicWaas = () => {
             initializingWaasRef.current = false;
             clearRecoveredWallets();
         }
-        if (shouldInitializeWaas && (user === null || user === void 0 ? void 0 : user.sessionId)) {
+        if (shouldInitializeWaas && (user === null || user === void 0 ? void 0 : user.sessionId) && isSdkReadyForWaas()) {
             const { sessionId, id: userId } = user;
             const shouldInitialize = !initializingWaasRef.current &&
                 (!hasWaasInitializedRef.current || sessionIdRef.current !== sessionId);
@@ -273,7 +346,14 @@ const useSyncDynamicWaas = () => {
                 });
             }
         }
-    }, [initializeWaas, shouldInitializeWaas, user]);
+    }, [
+        initializeWaas,
+        shouldInitializeWaas,
+        user,
+        isSdkReadyForWaas,
+        clearRecoveredWallets,
+        environmentId,
+    ]);
     useEffect(() => {
         if (shouldCreateWallets()) {
             handleWalletCreation();

package/src/lib/utils/hooks/useSyncOnboardingFlow/useSyncOnboardingFlow.cjs

@@ -115,6 +115,7 @@ require('../../../store/state/tokenBalances.cjs');
 require('../../../store/state/multichainBalances.cjs');
 require('@dynamic-labs/store');
 require('../../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
+require('@dynamic-labs-sdk/client/waas');
 require('../useUserUpdateRequest/useUpdateUser/userFieldsSchema.cjs');
 
 const useSyncOnboardingFlow = ({ handler: headlessHandler, } = {}) => {

package/src/lib/utils/hooks/useSyncOnboardingFlow/useSyncOnboardingFlow.js

@@ -111,6 +111,7 @@ import '../../../store/state/tokenBalances.js';
 import '../../../store/state/multichainBalances.js';
 import '@dynamic-labs/store';
 import '../../../shared/utils/functions/getInitialUrl/getInitialUrl.js';
+import '@dynamic-labs-sdk/client/waas';
 import '../useUserUpdateRequest/useUpdateUser/userFieldsSchema.js';
 
 const useSyncOnboardingFlow = ({ handler: headlessHandler, } = {}) => {

package/src/lib/utils/hooks/useVerifyWallet/useVerifyWallet.cjs

@@ -121,6 +121,7 @@ require('../../../store/state/tokenBalances.cjs');
 require('../../../store/state/multichainBalances.cjs');
 require('@dynamic-labs/store');
 require('../../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
+require('@dynamic-labs-sdk/client/waas');
 
 // This logic is used to both verify or link a wallet
 // Since we are re-using the different screens to authenticate or link the wallet.

package/src/lib/utils/hooks/useVerifyWallet/useVerifyWallet.js

@@ -117,6 +117,7 @@ import '../../../store/state/tokenBalances.js';
 import '../../../store/state/multichainBalances.js';
 import '@dynamic-labs/store';
 import '../../../shared/utils/functions/getInitialUrl/getInitialUrl.js';
+import '@dynamic-labs-sdk/client/waas';
 
 // This logic is used to both verify or link a wallet
 // Since we are re-using the different screens to authenticate or link the wallet.

package/src/lib/utils/hooks/useWalletDelegation/useWalletDelegation.cjs

@@ -161,7 +161,9 @@ const useWalletDelegation = () => {
             .filter((wallet) => wallet !== null)
             .filter((wallet) => wallet.chain === sdkApiCore.ChainEnum.Evm || wallet.chain === sdkApiCore.ChainEnum.Sol);
     }, [user === null || user === void 0 ? void 0 : user.verifiedCredentials, userWallets]);
-    const delegateKeyShares = React.useCallback((wallets, password) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+    const delegateKeyShares = React.useCallback((wallets, password, 
+    // Seeds the delegated signer's policy layer with rules at delegation time.
+    initialSignerRules) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         if (!delegatedAccessEnabled) {
             throw new Error('Wallet delegation is not enabled for this project environment. Please check the project settings.');
         }
@@ -185,7 +187,7 @@ const useWalletDelegation = () => {
                 continue;
             }
             try {
-                yield walletConnector.delegateKeyShares(Object.assign({ accountAddress: wallet.accountAddress }, (password && { password })));
+                yield walletConnector.delegateKeyShares(Object.assign(Object.assign({ accountAddress: wallet.accountAddress }, (password && { password })), (initialSignerRules && { initialSignerRules })));
                 successfulWallets.push(wallet);
             }
             catch (error) {

package/src/lib/utils/hooks/useWalletDelegation/useWalletDelegation.d.ts

@@ -1,4 +1,4 @@
-import { ChainEnum } from '@dynamic-labs/sdk-api-core';
+import { ChainEnum, WaasPolicyRule } from '@dynamic-labs/sdk-api-core';
 import { Wallet } from '../../../shared';
 export type WalletDelegationStatus = 'delegated' | 'denied' | 'pending';
 export type WalletWithStatus = Wallet & {
@@ -27,7 +27,7 @@ export declare const useWalletDelegation: () => {
     readonly delegateKeyShares: (wallets?: {
         chainName: ChainEnum;
         accountAddress: string;
-    }[], password?: string) => Promise<void>;
+    }[], password?: string, initialSignerRules?: WaasPolicyRule[]) => Promise<void>;
     readonly delegatedAccessEnabled: boolean | undefined;
     readonly denyWalletDelegation: (walletId: string) => Promise<void>;
     readonly dismissDelegationPrompt: (walletId?: string) => void;

package/src/lib/utils/hooks/useWalletDelegation/useWalletDelegation.js

@@ -157,7 +157,9 @@ const useWalletDelegation = () => {
             .filter((wallet) => wallet !== null)
             .filter((wallet) => wallet.chain === ChainEnum.Evm || wallet.chain === ChainEnum.Sol);
     }, [user === null || user === void 0 ? void 0 : user.verifiedCredentials, userWallets]);
-    const delegateKeyShares = useCallback((wallets, password) => __awaiter(void 0, void 0, void 0, function* () {
+    const delegateKeyShares = useCallback((wallets, password, 
+    // Seeds the delegated signer's policy layer with rules at delegation time.
+    initialSignerRules) => __awaiter(void 0, void 0, void 0, function* () {
         if (!delegatedAccessEnabled) {
             throw new Error('Wallet delegation is not enabled for this project environment. Please check the project settings.');
         }
@@ -181,7 +183,7 @@ const useWalletDelegation = () => {
                 continue;
             }
             try {
-                yield walletConnector.delegateKeyShares(Object.assign({ accountAddress: wallet.accountAddress }, (password && { password })));
+                yield walletConnector.delegateKeyShares(Object.assign(Object.assign({ accountAddress: wallet.accountAddress }, (password && { password })), (initialSignerRules && { initialSignerRules })));
                 successfulWallets.push(wallet);
             }
             catch (error) {

package/src/lib/utils/hooks/useWalletUiUtils/useWalletUiUtils.cjs

@@ -68,6 +68,7 @@ require('../../../context/WalletContext/WalletContext.cjs');
 require('@dynamic-labs/store');
 require('../../../context/WalletGroupContext/WalletGroupContext.cjs');
 require('../../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
+require('@dynamic-labs-sdk/client/waas');
 require('../useWalletDelegation/DelegationError.cjs');
 require('../../../context/OnrampContext/OnrampContext.cjs');
 require('../../../../index.cjs');

package/src/lib/utils/hooks/useWalletUiUtils/useWalletUiUtils.js

@@ -64,6 +64,7 @@ import '../../../context/WalletContext/WalletContext.js';
 import '@dynamic-labs/store';
 import '../../../context/WalletGroupContext/WalletGroupContext.js';
 import '../../../shared/utils/functions/getInitialUrl/getInitialUrl.js';
+import '@dynamic-labs-sdk/client/waas';
 import '../useWalletDelegation/DelegationError.js';
 import '../../../context/OnrampContext/OnrampContext.js';
 import '../../../../index.js';

package/src/lib/views/AccessBlockedView/AccessBlockedView.cjs

@@ -111,6 +111,7 @@ require('../../store/state/tokenBalances.cjs');
 require('../../store/state/multichainBalances.cjs');
 require('@dynamic-labs/store');
 require('../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
+require('@dynamic-labs-sdk/client/waas');
 require('../../components/InlineWidget/InlineWidget.cjs');
 require('../../components/IsBrowser/IsBrowser.cjs');
 require('../../components/Popper/Popper/Popper.cjs');

package/src/lib/views/AccessBlockedView/AccessBlockedView.js

@@ -107,6 +107,7 @@ import '../../store/state/tokenBalances.js';
 import '../../store/state/multichainBalances.js';
 import '@dynamic-labs/store';
 import '../../shared/utils/functions/getInitialUrl/getInitialUrl.js';
+import '@dynamic-labs-sdk/client/waas';
 import '../../components/InlineWidget/InlineWidget.js';
 import '../../components/IsBrowser/IsBrowser.js';
 import '../../components/Popper/Popper/Popper.js';

package/src/lib/views/AccountExistsView/AccountExistsView.cjs

@@ -115,6 +115,7 @@ require('../../store/state/tokenBalances.cjs');
 require('../../store/state/multichainBalances.cjs');
 require('@dynamic-labs/store');
 require('../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
+require('@dynamic-labs-sdk/client/waas');
 var IconListTile = require('../../components/IconListTile/IconListTile.cjs');
 require('../../components/InlineWidget/InlineWidget.cjs');
 require('../../components/IsBrowser/IsBrowser.cjs');

package/src/lib/views/AccountExistsView/AccountExistsView.js

@@ -111,6 +111,7 @@ import '../../store/state/tokenBalances.js';
 import '../../store/state/multichainBalances.js';
 import '@dynamic-labs/store';
 import '../../shared/utils/functions/getInitialUrl/getInitialUrl.js';
+import '@dynamic-labs-sdk/client/waas';
 import { IconListTile } from '../../components/IconListTile/IconListTile.js';
 import '../../components/InlineWidget/InlineWidget.js';
 import '../../components/IsBrowser/IsBrowser.js';