@dynamic-labs/sdk-react-core 4.36.0 → 4.37.0

package/src/lib/utils/constants/authViewLayoutChecks.cjs

@@ -103,6 +103,7 @@ const viewsThatPreventModalClose = [
     'login-with-sms-verification',
     'backup-unsuccessful',
     'wallet-upgrade-flow-view',
+    'wallet-delegation-view',
 ];
 /**
  * When hasPendingMfaAction returns true, user is not able to close the modal in these views at all

package/src/lib/utils/constants/authViewLayoutChecks.js

@@ -99,6 +99,7 @@ const viewsThatPreventModalClose = [
     'login-with-sms-verification',
     'backup-unsuccessful',
     'wallet-upgrade-flow-view',
+    'wallet-delegation-view',
 ];
 /**
  * When hasPendingMfaAction returns true, user is not able to close the modal in these views at all

package/src/lib/utils/constants/index.d.ts

@@ -1,4 +1,4 @@
-export { STORE_STORAGE_KEY, LAST_USED_WALLET, NETWORKS_STORAGE_KEY, THEME, WALLET_PICKER_SEARCH_KEY, EXCHANGE_PICKER_SEARCH_KEY, PHANTOM_SIGNATURE_STATE, DEVICE_FINGERPRINT, } from './localStorage';
+export { STORE_STORAGE_KEY, LAST_USED_WALLET, NETWORKS_STORAGE_KEY, THEME, WALLET_PICKER_SEARCH_KEY, EXCHANGE_PICKER_SEARCH_KEY, PHANTOM_SIGNATURE_STATE, DEVICE_FINGERPRINT, DELEGATION_DENIED_WALLET_IDS, DELEGATION_PROMPT_DISMISSED, DELEGATION_COMPLETED_WALLET_IDS, DELEGATION_STATE, } from './localStorage';
 export { BASE_LIGHT_1, BASE_LIGHT_2, BASE_LIGHT_3, BASE_LIGHT_4, BASE_LIGHT_5, BASE_DARK_5, TEXT_LIGHT_PRIMARY, TEXT_LIGHT_SECONDARY, TEXT_LIGHT_TERTIARY, TEXT_LIGHT_LINK, CONNECTION_LIGHT_GREEN, CONNECTION_LIGHT_ORANGE, ERROR_LIGHT_1, ERROR_LIGHT_2, OVERLAY_LIGHT, HOVER_LIGHT, LOADING_ANIMATION_GRADIENT_LIGHT, BASE_DARK_1, BASE_DARK_2, BASE_DARK_3, BASE_DARK_4, DYNAMIC_CONNECT_BUTTON_BACKGROUND, DYNAMIC_CONNECT_BUTTON_BORDER, DYNAMIC_CONNECT_BUTTON_COLOR, TEXT_DARK_PRIMARY, TEXT_DARK_SECONDARY, TEXT_DARK_TERTIARY, TEXT_DARK_LINK, BRAND_HOVER, BRAND_PRIMARY, BRAND_SECONDARY, CONNECTION_DARK_GREEN, CONNECTION_DARK_ORANGE, ERROR_DARK_1, ERROR_DARK_2, OVERLAY_DARK, HOVER_DARK, LOADING_ANIMATION_GRADIENT_DARK, SHADOW_DOWN_1, SHADOW_DOWN_2, SHADOW_DOWN_3, SHADOW_UP_1, BRAND_HOVER_COLOR, BRAND_PRIMARY_COLOR, BRAND_SECONDARY_COLOR, } from './colors';
 export { BORDER_SQUARE, BORDER_ROUNDED, BORDER_RADIUS } from './theme';
 export { TITLE, BODY_NORMAL, BODY_SMALL, BODY_MINI, BUTTON_PRIMARY, BUTTON_SECONDARY, NUMBERS_BIG, NUMBERS_MEDIUM, } from './typography';

package/src/lib/utils/constants/localStorage.cjs

@@ -20,6 +20,8 @@ const CAPTCHA_TOKEN = 'dynamic_captcha_token';
  * Used to identify the purpose of a signature after phantom redirects back to the app in mobile
  */
 const PHANTOM_SIGNATURE_STATE = 'phantom_verification_type';
+// Wallet Delegation: unified state container for delegation flow
+const DELEGATION_STATE = 'dynamic_delegation_state';
 const STORE_STORAGE_KEY = 'dynamic_store';
 const SECURE_ENCLAVE_WALLET_SESSION_KEYS = 'dynamic_secure_enclave_session_keys';
 const SECURE_ENCLAVE_WALLET_SESSION_KEYS_STORAGE_OPTIONS = {
@@ -29,6 +31,7 @@ const SECURE_ENCLAVE_WALLET_SESSION_KEYS_STORAGE_OPTIONS = {
 exports.BRIDGE_ONBOARDING_COMPLETED = BRIDGE_ONBOARDING_COMPLETED;
 exports.CAPTCHA_TOKEN = CAPTCHA_TOKEN;
 exports.CONNECTED_WALLET_NAME_SERVICE = CONNECTED_WALLET_NAME_SERVICE;
+exports.DELEGATION_STATE = DELEGATION_STATE;
 exports.DEVICE_FINGERPRINT = DEVICE_FINGERPRINT;
 exports.DYNAMIC_CONTEXT_LAST_SESSION_SETTINGS = DYNAMIC_CONTEXT_LAST_SESSION_SETTINGS;
 exports.EMBEDDED_WALLET_SECURE_BANNER = EMBEDDED_WALLET_SECURE_BANNER;

package/src/lib/utils/constants/localStorage.d.ts

@@ -27,6 +27,10 @@ export type PhantomSignatureState = {
  * Used to identify the purpose of a signature after phantom redirects back to the app in mobile
  */
 export declare const PHANTOM_SIGNATURE_STATE = "phantom_verification_type";
+export declare const DELEGATION_DENIED_WALLET_IDS = "dynamic_delegation_denied_wallet_ids";
+export declare const DELEGATION_PROMPT_DISMISSED = "dynamic_delegation_prompt_dismissed";
+export declare const DELEGATION_COMPLETED_WALLET_IDS = "dynamic_delegation_completed_wallet_ids";
+export declare const DELEGATION_STATE = "dynamic_delegation_state";
 export declare const STORE_STORAGE_KEY = "dynamic_store";
 export declare const IP_LOOKUP_STORAGE_KEY = "dynamic_ip_lookup";
 export declare const SECURE_ENCLAVE_WALLET_SESSION_KEYS = "dynamic_secure_enclave_session_keys";

package/src/lib/utils/constants/localStorage.js

@@ -16,10 +16,12 @@ const CAPTCHA_TOKEN = 'dynamic_captcha_token';
  * Used to identify the purpose of a signature after phantom redirects back to the app in mobile
  */
 const PHANTOM_SIGNATURE_STATE = 'phantom_verification_type';
+// Wallet Delegation: unified state container for delegation flow
+const DELEGATION_STATE = 'dynamic_delegation_state';
 const STORE_STORAGE_KEY = 'dynamic_store';
 const SECURE_ENCLAVE_WALLET_SESSION_KEYS = 'dynamic_secure_enclave_session_keys';
 const SECURE_ENCLAVE_WALLET_SESSION_KEYS_STORAGE_OPTIONS = {
     priority: ['secureStorage', 'localStorage'],
 };
 
-export { BRIDGE_ONBOARDING_COMPLETED, CAPTCHA_TOKEN, CONNECTED_WALLET_NAME_SERVICE, DEVICE_FINGERPRINT, DYNAMIC_CONTEXT_LAST_SESSION_SETTINGS, EMBEDDED_WALLET_SECURE_BANNER, EMBEDDED_WALLET_SESSION_SETTINGS, EXCHANGE_PICKER_SEARCH_KEY, LAST_USED_WALLET, NEWTOWEB3_WALLET_EXTENSION_FLAG_KEY, PHANTOM_SIGNATURE_STATE, PHONE_INPUT_DEFAULT_COUNTRY, SECURE_ENCLAVE_WALLET_SESSION_KEYS, SECURE_ENCLAVE_WALLET_SESSION_KEYS_STORAGE_OPTIONS, STORE_STORAGE_KEY, WAGMI_LAST_SESSION_SETTINGS, WALLET_PICKER_SEARCH_KEY };
+export { BRIDGE_ONBOARDING_COMPLETED, CAPTCHA_TOKEN, CONNECTED_WALLET_NAME_SERVICE, DELEGATION_STATE, DEVICE_FINGERPRINT, DYNAMIC_CONTEXT_LAST_SESSION_SETTINGS, EMBEDDED_WALLET_SECURE_BANNER, EMBEDDED_WALLET_SESSION_SETTINGS, EXCHANGE_PICKER_SEARCH_KEY, LAST_USED_WALLET, NEWTOWEB3_WALLET_EXTENSION_FLAG_KEY, PHANTOM_SIGNATURE_STATE, PHONE_INPUT_DEFAULT_COUNTRY, SECURE_ENCLAVE_WALLET_SESSION_KEYS, SECURE_ENCLAVE_WALLET_SESSION_KEYS_STORAGE_OPTIONS, STORE_STORAGE_KEY, WAGMI_LAST_SESSION_SETTINGS, WALLET_PICKER_SEARCH_KEY };

package/src/lib/utils/functions/getTransactionLink/blockExplorerPatterns.cjs

@@ -0,0 +1,47 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Block explorer URL patterns for different chains
+ * This mapping allows for easy configuration and extension of transaction link formats
+ */
+/**
+ * Predefined patterns for known block explorers
+ * Add new patterns here as needed for different chains
+ */
+const BLOCK_EXPLORER_PATTERNS = [
+    {
+        description: 'TRON - Uses hash fragment format',
+        domain: 'tronscan.org',
+        generateUrl: (baseUrl, hash) => {
+            const url = new URL(baseUrl);
+            return `${url.origin}/#/transaction/${hash}`;
+        },
+    },
+];
+/**
+ * Default pattern for standard block explorers
+ * Used when no specific pattern matches
+ */
+const DEFAULT_PATTERN = {
+    description: 'Standard format used by most block explorers',
+    domain: '*',
+    generateUrl: (baseUrl, hash) => {
+        const url = new URL(baseUrl);
+        url.pathname = `/tx/${hash}`;
+        return url.toString();
+    },
+};
+/**
+ * Find the appropriate pattern for a given block explorer URL
+ */
+const findBlockExplorerPattern = (blockExplorerUrl) => {
+    const pattern = BLOCK_EXPLORER_PATTERNS.find((pattern) => blockExplorerUrl.includes(pattern.domain));
+    return pattern || DEFAULT_PATTERN;
+};
+
+exports.BLOCK_EXPLORER_PATTERNS = BLOCK_EXPLORER_PATTERNS;
+exports.DEFAULT_PATTERN = DEFAULT_PATTERN;
+exports.findBlockExplorerPattern = findBlockExplorerPattern;

package/src/lib/utils/functions/getTransactionLink/blockExplorerPatterns.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Block explorer URL patterns for different chains
+ * This mapping allows for easy configuration and extension of transaction link formats
+ */
+export interface BlockExplorerPattern {
+    /** Domain pattern to match against block explorer URLs */
+    domain: string;
+    /** Function to generate the transaction URL */
+    generateUrl: (baseUrl: string, transactionHash: string) => string;
+    /** Description of the pattern for documentation */
+    description: string;
+}
+/**
+ * Predefined patterns for known block explorers
+ * Add new patterns here as needed for different chains
+ */
+export declare const BLOCK_EXPLORER_PATTERNS: BlockExplorerPattern[];
+/**
+ * Default pattern for standard block explorers
+ * Used when no specific pattern matches
+ */
+export declare const DEFAULT_PATTERN: BlockExplorerPattern;
+/**
+ * Find the appropriate pattern for a given block explorer URL
+ */
+export declare const findBlockExplorerPattern: (blockExplorerUrl: string) => BlockExplorerPattern;

package/src/lib/utils/functions/getTransactionLink/blockExplorerPatterns.js

@@ -0,0 +1,41 @@
+'use client'
+/**
+ * Block explorer URL patterns for different chains
+ * This mapping allows for easy configuration and extension of transaction link formats
+ */
+/**
+ * Predefined patterns for known block explorers
+ * Add new patterns here as needed for different chains
+ */
+const BLOCK_EXPLORER_PATTERNS = [
+    {
+        description: 'TRON - Uses hash fragment format',
+        domain: 'tronscan.org',
+        generateUrl: (baseUrl, hash) => {
+            const url = new URL(baseUrl);
+            return `${url.origin}/#/transaction/${hash}`;
+        },
+    },
+];
+/**
+ * Default pattern for standard block explorers
+ * Used when no specific pattern matches
+ */
+const DEFAULT_PATTERN = {
+    description: 'Standard format used by most block explorers',
+    domain: '*',
+    generateUrl: (baseUrl, hash) => {
+        const url = new URL(baseUrl);
+        url.pathname = `/tx/${hash}`;
+        return url.toString();
+    },
+};
+/**
+ * Find the appropriate pattern for a given block explorer URL
+ */
+const findBlockExplorerPattern = (blockExplorerUrl) => {
+    const pattern = BLOCK_EXPLORER_PATTERNS.find((pattern) => blockExplorerUrl.includes(pattern.domain));
+    return pattern || DEFAULT_PATTERN;
+};
+
+export { BLOCK_EXPLORER_PATTERNS, DEFAULT_PATTERN, findBlockExplorerPattern };

package/src/lib/utils/functions/getTransactionLink/getTransactionLink.cjs

@@ -4,6 +4,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var _tslib = require('../../../../../_virtual/_tslib.cjs');
+var blockExplorerPatterns = require('./blockExplorerPatterns.cjs');
 
 const getTransactionLink = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ walletConnector, transactionHash, }) {
     try {
@@ -13,9 +14,10 @@ const getTransactionLink = (_a) => _tslib.__awaiter(void 0, [_a], void 0, functi
         const [blockExplorerUrl] = yield walletConnector.getBlockExplorerUrlsForCurrentNetwork();
         if (!blockExplorerUrl)
             return undefined;
-        const url = new URL(blockExplorerUrl);
-        url.pathname = `/tx/${transactionHash}`;
-        return url.toString();
+        // Find the appropriate pattern for this block explorer
+        const pattern = blockExplorerPatterns.findBlockExplorerPattern(blockExplorerUrl);
+        // Generate the transaction URL using the pattern
+        return pattern.generateUrl(blockExplorerUrl, transactionHash);
     }
     catch (error) {
         return undefined;

package/src/lib/utils/functions/getTransactionLink/getTransactionLink.js

@@ -1,5 +1,6 @@
 'use client'
 import { __awaiter } from '../../../../../_virtual/_tslib.js';
+import { findBlockExplorerPattern } from './blockExplorerPatterns.js';
 
 const getTransactionLink = (_a) => __awaiter(void 0, [_a], void 0, function* ({ walletConnector, transactionHash, }) {
     try {
@@ -9,9 +10,10 @@ const getTransactionLink = (_a) => __awaiter(void 0, [_a], void 0, function* ({
         const [blockExplorerUrl] = yield walletConnector.getBlockExplorerUrlsForCurrentNetwork();
         if (!blockExplorerUrl)
             return undefined;
-        const url = new URL(blockExplorerUrl);
-        url.pathname = `/tx/${transactionHash}`;
-        return url.toString();
+        // Find the appropriate pattern for this block explorer
+        const pattern = findBlockExplorerPattern(blockExplorerUrl);
+        // Generate the transaction URL using the pattern
+        return pattern.generateUrl(blockExplorerUrl, transactionHash);
     }
     catch (error) {
         return undefined;

package/src/lib/utils/functions/socialStorage/socialStorage.d.ts

@@ -4,6 +4,8 @@ import { PayWithDynamicProps } from '../../hooks/usePayWithDynamic/usePayWithDyn
 export declare const SOCIAL_STORAGE_KEY = "dynamic_social_storage";
 export type SocialStorageItem = {
     provider: ProviderEnum;
+    /** SSO provider id */
+    dynamicOauthSsoProviderId: string | undefined;
     /** State issued to IDP on social authentication */
     state: string;
     /** Code verifier used to generate the code challenge for PKCE */

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

@@ -95,3 +95,4 @@ export { usePromptMfaAuth } from './usePromptMfaAuth';
 export { useUpgradeToDynamicWaasFlow } from './useUpgradeToDynamicWaasFlow';
 export { useGetMfaToken } from './useGetMfaToken';
 export { useIsMfaRequiredForAction } from './useIsMfaRequiredForAction';
+export { useWalletDelegation } from './useWalletDelegation';

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

@@ -207,7 +207,7 @@ const useSocialAuth = ({ onSettled, onError, onFarcasterUrl, }) => {
             verifyFunction: () => apiCall(),
         });
     }), [handleError, initAuth, onSettled]);
-    const completeConnection = React.useCallback((_b) => _tslib.__awaiter(void 0, [_b], void 0, function* ({ authMode, provider, state, authCode, captchaToken, verifier, telegramAuthToken, forceCreateUser = false, }) {
+    const completeConnection = React.useCallback((_b) => _tslib.__awaiter(void 0, [_b], void 0, function* ({ authMode, provider, state, authCode, captchaToken, verifier, telegramAuthToken, forceCreateUser = false, ssoProviderId, }) {
         try {
             let sessionPublicKey = undefined;
             utils.tracing.logEvent('oauth', 'completeConnection', utils.tracing.formatObject({
@@ -245,6 +245,7 @@ const useSocialAuth = ({ onSettled, onError, onFarcasterUrl, }) => {
                         code: authCode,
                         codeVerifier: verifier,
                         sessionPublicKey,
+                        ssoProviderId,
                         state,
                     });
                     yield signInAccount(provider, apiCall);
@@ -371,7 +372,7 @@ const useSocialAuth = ({ onSettled, onError, onFarcasterUrl, }) => {
         shouldRegisterSessionKeysOnSignin,
         signInAccount,
     ]);
-    const connectSocialAccount = React.useCallback((_d) => _tslib.__awaiter(void 0, [_d], void 0, function* ({ authMode, provider, validator, captchaToken, isHeadlessSocialSignIn, payingWithDynamic, triggerFundFromExchangeOnSuccess, redirectUrl, telegramAuthToken, showWidgetAfterConnection, }) {
+    const connectSocialAccount = React.useCallback((_d) => _tslib.__awaiter(void 0, [_d], void 0, function* ({ authMode, provider, validator, captchaToken, isHeadlessSocialSignIn, payingWithDynamic, triggerFundFromExchangeOnSuccess, redirectUrl, telegramAuthToken, showWidgetAfterConnection, ssoProviderId, }) {
         var _e, _f;
         clearError();
         setIsProcessing(true);
@@ -404,6 +405,7 @@ const useSocialAuth = ({ onSettled, onError, onFarcasterUrl, }) => {
         socialStorage.setSocialStorageFor(provider, {
             captchaToken,
             codeVerifier: usingPkce ? verifier : undefined,
+            dynamicOauthSsoProviderId: ssoProviderId,
             isHeadlessSocialSignIn,
             mode: authMode,
             payingWithDynamic,
@@ -451,6 +453,7 @@ const useSocialAuth = ({ onSettled, onError, onFarcasterUrl, }) => {
                 authMode,
                 captchaToken,
                 provider,
+                ssoProviderId,
                 state,
                 telegramAuthToken,
                 verifier,

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

@@ -20,10 +20,12 @@ export type ConnectSocialAccountProps = {
     payingWithDynamic?: PayWithDynamicProps;
     /** marks the flow as initiated by headless sign-in API */
     isHeadlessSocialSignIn?: boolean;
+    /** SSO provider ID for social authentication */
+    ssoProviderId?: string;
 };
 export declare const useSocialAuth: ({ onSettled, onError, onFarcasterUrl, }: UseSocialAuthProps) => {
     readonly checkValidProvider: (provider: ProviderEnum, authMode: SocialAuthMode) => boolean;
-    readonly completeConnection: ({ authMode, provider, state, authCode, captchaToken, verifier, telegramAuthToken, forceCreateUser, }: {
+    readonly completeConnection: ({ authMode, provider, state, authCode, captchaToken, verifier, telegramAuthToken, forceCreateUser, ssoProviderId, }: {
         authMode: SocialAuthMode;
         provider: ProviderEnum;
         state: string;
@@ -32,6 +34,7 @@ export declare const useSocialAuth: ({ onSettled, onError, onFarcasterUrl, }: Us
         verifier?: string | undefined;
         telegramAuthToken?: string | undefined;
         forceCreateUser?: boolean | undefined;
+        ssoProviderId?: string | undefined;
     }) => Promise<void>;
     readonly connectSocialAccount: (props: ConnectSocialAccountProps) => Promise<void>;
     readonly error: SocialOAuthError | undefined;

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

@@ -203,7 +203,7 @@ const useSocialAuth = ({ onSettled, onError, onFarcasterUrl, }) => {
             verifyFunction: () => apiCall(),
         });
     }), [handleError, initAuth$1, onSettled]);
-    const completeConnection = useCallback((_b) => __awaiter(void 0, [_b], void 0, function* ({ authMode, provider, state, authCode, captchaToken, verifier, telegramAuthToken, forceCreateUser = false, }) {
+    const completeConnection = useCallback((_b) => __awaiter(void 0, [_b], void 0, function* ({ authMode, provider, state, authCode, captchaToken, verifier, telegramAuthToken, forceCreateUser = false, ssoProviderId, }) {
         try {
             let sessionPublicKey = undefined;
             tracing.logEvent('oauth', 'completeConnection', tracing.formatObject({
@@ -241,6 +241,7 @@ const useSocialAuth = ({ onSettled, onError, onFarcasterUrl, }) => {
                         code: authCode,
                         codeVerifier: verifier,
                         sessionPublicKey,
+                        ssoProviderId,
                         state,
                     });
                     yield signInAccount(provider, apiCall);
@@ -367,7 +368,7 @@ const useSocialAuth = ({ onSettled, onError, onFarcasterUrl, }) => {
         shouldRegisterSessionKeysOnSignin,
         signInAccount,
     ]);
-    const connectSocialAccount = useCallback((_d) => __awaiter(void 0, [_d], void 0, function* ({ authMode, provider, validator, captchaToken, isHeadlessSocialSignIn, payingWithDynamic, triggerFundFromExchangeOnSuccess, redirectUrl, telegramAuthToken, showWidgetAfterConnection, }) {
+    const connectSocialAccount = useCallback((_d) => __awaiter(void 0, [_d], void 0, function* ({ authMode, provider, validator, captchaToken, isHeadlessSocialSignIn, payingWithDynamic, triggerFundFromExchangeOnSuccess, redirectUrl, telegramAuthToken, showWidgetAfterConnection, ssoProviderId, }) {
         var _e, _f;
         clearError();
         setIsProcessing(true);
@@ -400,6 +401,7 @@ const useSocialAuth = ({ onSettled, onError, onFarcasterUrl, }) => {
         setSocialStorageFor(provider, {
             captchaToken,
             codeVerifier: usingPkce ? verifier : undefined,
+            dynamicOauthSsoProviderId: ssoProviderId,
             isHeadlessSocialSignIn,
             mode: authMode,
             payingWithDynamic,
@@ -447,6 +449,7 @@ const useSocialAuth = ({ onSettled, onError, onFarcasterUrl, }) => {
                 authMode,
                 captchaToken,
                 provider,
+                ssoProviderId,
                 state,
                 telegramAuthToken,
                 verifier,

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

@@ -93,6 +93,7 @@ require('../../../views/MfaChooseDeviceView/useGetMfaOptions/useGetMfaOptions.cj
 require('../../../context/PasskeyContext/PasskeyContext.cjs');
 require('../../../context/OnrampContext/OnrampContext.cjs');
 var useDynamicWaas = require('../useDynamicWaas/useDynamicWaas.cjs');
+var useWalletDelegation = require('../useWalletDelegation/useWalletDelegation.cjs');
 require('../../../store/state/sendBalances.cjs');
 require('../../../store/state/connectorsInitializing/connectorsInitializing.cjs');
 require('../../../components/OverlayCardBase/OverlayCardTarget/OverlayCardTarget.cjs');
@@ -208,6 +209,7 @@ const useSyncDynamicWaas = () => {
     const validateWalletCreation = useWalletCreationValidation();
     const { mutate: createWallets, isLoading: isCreatingWallets } = useWalletCreation();
     const { mutate: processSettings, isLoading: isProcessingSettings } = useWalletSettingsProcessor();
+    const { initDelegationProcess, shouldPromptWalletDelegation } = useWalletDelegation.useWalletDelegation();
     const triggeredCreate = React.useRef(false);
     const triggeredSettingsProcessing = React.useRef(false);
     useDynamicEvents.useInternalDynamicEvents('logout', () => {
@@ -264,6 +266,11 @@ const useSyncDynamicWaas = () => {
             handleWalletCreation();
         }
     }, [shouldCreateWallets, handleWalletCreation]);
+    React.useEffect(() => {
+        if (shouldPromptWalletDelegation()) {
+            initDelegationProcess();
+        }
+    }, [shouldPromptWalletDelegation, initDelegationProcess]);
 };
 
 exports.useSyncDynamicWaas = useSyncDynamicWaas;

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

@@ -89,6 +89,7 @@ import '../../../views/MfaChooseDeviceView/useGetMfaOptions/useGetMfaOptions.js'
 import '../../../context/PasskeyContext/PasskeyContext.js';
 import '../../../context/OnrampContext/OnrampContext.js';
 import { useDynamicWaas } from '../useDynamicWaas/useDynamicWaas.js';
+import { useWalletDelegation } from '../useWalletDelegation/useWalletDelegation.js';
 import '../../../store/state/sendBalances.js';
 import '../../../store/state/connectorsInitializing/connectorsInitializing.js';
 import '../../../components/OverlayCardBase/OverlayCardTarget/OverlayCardTarget.js';
@@ -204,6 +205,7 @@ const useSyncDynamicWaas = () => {
     const validateWalletCreation = useWalletCreationValidation();
     const { mutate: createWallets, isLoading: isCreatingWallets } = useWalletCreation();
     const { mutate: processSettings, isLoading: isProcessingSettings } = useWalletSettingsProcessor();
+    const { initDelegationProcess, shouldPromptWalletDelegation } = useWalletDelegation();
     const triggeredCreate = useRef(false);
     const triggeredSettingsProcessing = useRef(false);
     useInternalDynamicEvents('logout', () => {
@@ -260,6 +262,11 @@ const useSyncDynamicWaas = () => {
             handleWalletCreation();
         }
     }, [shouldCreateWallets, handleWalletCreation]);
+    useEffect(() => {
+        if (shouldPromptWalletDelegation()) {
+            initDelegationProcess();
+        }
+    }, [shouldPromptWalletDelegation, initDelegationProcess]);
 };
 
 export { useSyncDynamicWaas };

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

@@ -5,6 +5,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var _tslib = require('../../../../../_virtual/_tslib.cjs');
 var React = require('react');
+var utils = require('@dynamic-labs/utils');
 require('../../../context/DynamicContext/DynamicContext.cjs');
 require('../../../store/state/loadingAndLifecycle/loadingAndLifecycle.cjs');
 require('@dynamic-labs/iconic');
@@ -13,7 +14,7 @@ require('react/jsx-runtime');
 var ViewContext = require('../../../context/ViewContext/ViewContext.cjs');
 require('../../../shared/logger.cjs');
 require('@dynamic-labs/wallet-book');
-require('@dynamic-labs/utils');
+var localStorage = require('../../constants/localStorage.cjs');
 require('../../constants/colors.cjs');
 require('../../constants/values.cjs');
 require('@dynamic-labs/sdk-api-core');
@@ -29,13 +30,14 @@ require('@dynamic-labs-sdk/client/core');
 require('../../../client/client.cjs');
 require('@dynamic-labs-sdk/client');
 require('../../../config/ApiEndpoint.cjs');
+var useProjectSettings = require('../../../client/extension/projectSettings/useProjectSettings/useProjectSettings.cjs');
 require('../../../locale/locale.cjs');
 require('../../../store/state/dynamicContextProps/dynamicContextProps.cjs');
 require('../../../store/state/primaryWalletId/primaryWalletId.cjs');
 require('../../../store/state/connectedWalletsInfo/connectedWalletsInfo.cjs');
 require('../../../context/AccessDeniedContext/AccessDeniedContext.cjs');
 require('../../../context/AccountExistsContext/AccountExistsContext.cjs');
-require('../../../context/UserWalletsContext/UserWalletsContext.cjs');
+var UserWalletsContext = require('../../../context/UserWalletsContext/UserWalletsContext.cjs');
 require('../../../store/state/authMode/authMode.cjs');
 require('../../../context/VerificationContext/VerificationContext.cjs');
 require('react-dom');
@@ -104,9 +106,35 @@ var useInternalDynamicContext = require('../../../context/DynamicContext/useDyna
 
 // Hook to trigger wallet delegation modal
 const useWalletDelegation = () => {
+    var _a, _b, _c;
     const { primaryWallet, user, setShowAuthFlow } = useInternalDynamicContext.useInternalDynamicContext();
+    const { userWallets } = UserWalletsContext.useInternalUserWallets();
     const { pushView } = ViewContext.useViewContext();
-    const initDelegationProcess = React.useCallback(() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+    const projectSettings = useProjectSettings.useProjectSettings();
+    const waasSettings = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk.waas;
+    const delegatedAccessEnabled = (_a = waasSettings === null || waasSettings === void 0 ? void 0 : waasSettings.delegatedAccess) === null || _a === void 0 ? void 0 : _a.enabled;
+    const promptUsersOnSignIn = (_b = waasSettings === null || waasSettings === void 0 ? void 0 : waasSettings.delegatedAccess) === null || _b === void 0 ? void 0 : _b.promptUsersOnSignIn;
+    const requiresDelegation = (_c = waasSettings === null || waasSettings === void 0 ? void 0 : waasSettings.delegatedAccess) === null || _c === void 0 ? void 0 : _c.requiresDelegation;
+    const shouldPromptWalletDelegation = React.useCallback(() => {
+        var _a, _b;
+        if (!delegatedAccessEnabled || !promptUsersOnSignIn) {
+            return false;
+        }
+        // If the prompt was dismissed, do not show again until logout
+        // Unified state first, then legacy dismissed flag
+        const state = utils.StorageService.getItem(localStorage.DELEGATION_STATE);
+        const dismissed = state === null || state === void 0 ? void 0 : state.dismissed;
+        if (dismissed) {
+            return false;
+        }
+        const userId = (user === null || user === void 0 ? void 0 : user.userId) || 'anonymous';
+        const deniedForUser = new Set(((_a = state === null || state === void 0 ? void 0 : state.denied) === null || _a === void 0 ? void 0 : _a[userId]) || []);
+        const completedForUser = new Set(((_b = state === null || state === void 0 ? void 0 : state.completed) === null || _b === void 0 ? void 0 : _b[userId]) || []);
+        const waasWallets = userWallets.filter((wallet) => wallet.connector.key.startsWith('dynamicwaas'));
+        const hasUndeniedWaasWallet = waasWallets.some((wallet) => !deniedForUser.has(wallet.id) && !completedForUser.has(wallet.id));
+        return hasUndeniedWaasWallet;
+    }, [user === null || user === void 0 ? void 0 : user.userId, userWallets, delegatedAccessEnabled, promptUsersOnSignIn]);
+    const initDelegationProcess = React.useCallback((options) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         if (!primaryWallet) {
             throw new Error('No primary wallet');
         }
@@ -118,15 +146,41 @@ const useWalletDelegation = () => {
             ignoreIfIsEmbeddedWidget: false,
             performMultiWalletChecks: false,
         });
-        // Push the wallet delegation view
-        pushView('wallet-delegation-view', {});
+        // Push the wallet delegation view with optional wallets override
+        pushView('wallet-delegation-view', {
+            wallets: options === null || options === void 0 ? void 0 : options.wallets,
+        });
         return new Promise((resolve, reject) => {
             dynamicEvents.dynamicEvents.once('embeddedWalletDelegationCompleted', () => resolve());
             dynamicEvents.dynamicEvents.once('embeddedWalletDelegationFailed', (error) => reject(error));
         });
     }), [primaryWallet, setShowAuthFlow, pushView, user]);
+    const getWalletsDelegatedStatus = React.useCallback(() => {
+        var _a, _b;
+        if (!primaryWallet) {
+            return [];
+        }
+        const state = utils.StorageService.getItem(localStorage.DELEGATION_STATE);
+        const userId = (user === null || user === void 0 ? void 0 : user.userId) || 'anonymous';
+        const completedForUser = new Set(((_a = state === null || state === void 0 ? void 0 : state.completed) === null || _a === void 0 ? void 0 : _a[userId]) || []);
+        const deniedForUser = new Set(((_b = state === null || state === void 0 ? void 0 : state.denied) === null || _b === void 0 ? void 0 : _b[userId]) || []);
+        return userWallets.map((wallet) => {
+            let status = 'pending';
+            if (completedForUser.has(wallet.id)) {
+                status = 'delegated';
+            }
+            else if (deniedForUser.has(wallet.id)) {
+                status = 'denied';
+            }
+            return Object.assign(Object.assign({}, wallet), { status });
+        });
+    }, [primaryWallet, user === null || user === void 0 ? void 0 : user.userId, userWallets]);
     return {
+        delegatedAccessEnabled,
+        getWalletsDelegatedStatus,
         initDelegationProcess,
+        requiresDelegation,
+        shouldPromptWalletDelegation,
     };
 };
 

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

@@ -1,3 +1,14 @@
+import { Wallet } from '../../../shared';
+export type WalletDelegationStatus = 'delegated' | 'denied' | 'pending';
+export type WalletWithStatus = Wallet & {
+    status: WalletDelegationStatus;
+};
 export declare const useWalletDelegation: () => {
-    readonly initDelegationProcess: () => Promise<void>;
+    readonly delegatedAccessEnabled: boolean | undefined;
+    readonly getWalletsDelegatedStatus: () => WalletWithStatus[];
+    readonly initDelegationProcess: (options?: {
+        wallets?: Wallet[];
+    }) => Promise<void>;
+    readonly requiresDelegation: boolean | undefined;
+    readonly shouldPromptWalletDelegation: () => boolean;
 };