@dynamic-labs-sdk/wallet-connect 0.1.0-alpha.19 → 0.1.0-alpha.21

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## 0.1.0-alpha.21 (2025-10-16)
+
+### 🩹 Fixes
+
+- don't refetch project settings on page refresh if there are connected wallets ([#571](https://github.com/dynamic-labs/dynamic-sdk/pull/571))
+
+## 0.1.0-alpha.20 (2025-10-15)
+
+This was a version bump only, there were no code changes.
+
 ## 0.1.0-alpha.19 (2025-10-10)
 
 This was a version bump only, there were no code changes.

package/core.cjs.js

@@ -5,6 +5,7 @@ var isWalletConnectWalletProvider = require('./isWalletConnectWalletProvider.cjs
 var client = require('@dynamic-labs-sdk/client');
 var core = require('@dynamic-labs-sdk/client/core');
 var z = require('zod/mini');
+var utils = require('@walletconnect/utils');
 var SignClient = require('@walletconnect/sign-client');
 var sdkApiCore = require('@dynamic-labs/sdk-api-core');
 
@@ -135,15 +136,6 @@ const sessionTopicsStorageKeySchema = core.createStorageKeySchema({
     return sessionTopicsData != null ? sessionTopicsData : {};
 };
 
-/**
- * Reason for disconnection when the user disconnects from a WalletConnect session.
- *
- * Source: https://github.com/WalletConnect/walletconnect-monorepo/blob/cc3a9d26dcbd05c92d5ded935b29dc3b6063d147/packages/utils/src/errors.ts#L87
- */ const USER_DISCONNECTED_REASON = {
-    code: 6000,
-    message: 'User disconnected.'
-};
-
 const createSignClient = async (client)=>{
     var _client_projectSettings_sdk_walletConnect, _core_metadata, _core_metadata1;
     const core$1 = core.getCore(client);
@@ -209,7 +201,11 @@ const addMissingWalletProvidersForSessions = async ({ sessions, allowOverridingW
     /**
    * Keep record on which wallet account IDs already exist but will have
    * their wallet provider keys overridden to use the new WC wallet provider key.
-   */ const walletAccountsToOverride = new Set();
+   *
+   * This will only ever be the case for unverified wallet accounts, however. That is
+   * because verified wallets will already override the wallet provider key on the verification
+   * step, which happens at the call to verifyWalletConnectAuths, which happens before this function.
+   */ const unverifiedWalletAccountsToOverride = new Set();
     for (const session of sessions){
         const namespaceKeys = Object.keys(session.namespaces);
         for (const namespaceKey of namespaceKeys){
@@ -219,7 +215,12 @@ const addMissingWalletProvidersForSessions = async ({ sessions, allowOverridingW
                 continue;
             }
             const walletProviderBuilder = namespaceRegistry.getWalletProviderBuilder(namespaceKey);
-            if (!walletProviderBuilder) {
+            /**
+       * There being no wallet provider builder for this namespace simply means the customer
+       * didn't add an extension for the corresponding chain.
+       * For instance, if we get a namespace for Solana but only have an Evm extension,
+       * the solana namespace would fall here. No need to throw.
+       */ if (!walletProviderBuilder) {
                 continue;
             }
             const walletProvider = await walletProviderBuilder({
@@ -257,17 +258,27 @@ const addMissingWalletProvidersForSessions = async ({ sessions, allowOverridingW
                 const existingWalletIsWalletConnect = core.splitWalletProviderKey(existingAccount.walletProviderKey).walletProviderType === sdkApiCore.WalletProviderEnum.WalletConnect;
                 if (allowOverridingWalletProviders || existingWalletIsWalletConnect) {
                     createdWalletAccounts[createdWalletAccount.id] = createdWalletAccount;
-                    walletAccountsToOverride.add(createdWalletAccount.id);
+                    if (existingAccount.verifiedCredentialId) {
+                        /**
+             * A verified wallet account only arrives here when its wallet provider key is lacking the suffix,
+             * which should be the sessionTopic. So we just need to add its entry to the verifiedCredentialId map.
+             */ core.updateWalletProviderKeysForVerifiedCredentials({
+                            keysToUpdate: {
+                                [existingAccount.verifiedCredentialId]: walletProvider.key
+                            }
+                        }, client$1);
+                    } else {
+                        unverifiedWalletAccountsToOverride.add(createdWalletAccount.id);
+                    }
                 }
             }
         }
     }
-    if (walletAccountsToOverride.size === 0 && brandNewWalletAccounts.size === 0) {
+    if (unverifiedWalletAccountsToOverride.size === 0 && brandNewWalletAccounts.size === 0) {
         return {
             walletProvidersWithActiveSession
         };
     }
-    // For now we only support connect only, so we only need to worry about unverified wallet accounts.
     core.setUnverifiedWalletAccounts({
         unverifiedWalletAccountsToUpdate: Object.values(createdWalletAccounts)
     }, client$1);
@@ -295,7 +306,7 @@ const doSyncSessionsToWalletProviders = async ({ allowOverridingWalletProviders
         }
         // If we don't have data for this session, it is corrupted and we need to disconnect
         void signClient.disconnect({
-            reason: USER_DISCONNECTED_REASON,
+            reason: utils.SDK_ERRORS.USER_DISCONNECTED,
             topic: session.topic
         });
         return false;
@@ -335,14 +346,15 @@ const doSyncSessionsToWalletProviders = async ({ allowOverridingWalletProviders
         }
     }
     // Step 4: kill sessions and their wallet providers if they have no more wallet accounts
+    // Ignore sessions that are NOT marked as shouldAddToDynamicWalletAccounts
     for (const [sessionTopic, hasWalletAccount] of sessionTopicHasWalletAccountMap){
-        if (hasWalletAccount) {
+        if (hasWalletAccount || !sessionTopicsData[sessionTopic].shouldAddToDynamicWalletAccounts) {
             continue;
         }
         const session = sessions.find((session)=>session.topic === sessionTopic);
         if (session) {
             void signClient.disconnect({
-                reason: USER_DISCONNECTED_REASON,
+                reason: utils.SDK_ERRORS.USER_DISCONNECTED,
                 topic: session.topic
             });
         }
@@ -382,7 +394,7 @@ const syncSessionsToWalletProviders = async ({ debounceTime = 0, allowOverriding
  * @param addToDynamicWalletAccounts - Whether to add the wallet accounts to the dynamic's wallet accounts.
  * @param client - The Dynamic client instance. Only required when using multiple Dynamic clients.
  * @returns The wallet accounts.
- */ const connectWalletConnectSession = async ({ addToDynamicWalletAccounts = true, session }, client$1)=>{
+ */ const importWalletConnectSession = async ({ addToDynamicWalletAccounts = true, session }, client$1)=>{
     /**
    * You would normally get the session from the signClient.connect method. It takes the optionalNamespaces as an argument.
    *
@@ -455,6 +467,125 @@ const syncSessionsToWalletProviders = async ({ debounceTime = 0, allowOverriding
     };
 };
 
+const getAddressFromIss = (iss)=>iss.split(':')[4];
+const verifyWalletConnectAuths = async ({ auths, chain, walletDisplayName }, client)=>{
+    /**
+   * The only differences between each auth object will be the signature (auth.s.s)
+   * and the iss (auth.p.iss).
+   *
+   * The iss is comprised of 2 WC fields that are irrelevant to us and then the CAIP-10 token
+   * of the address, where the first 2 fields are also split by the ":" character.
+   *
+   * Usually, there will be multiple auths if the wallet app bundles signatures for multiple
+   * networks at once, so the only field that will change among auth iss will be the networkId under iss.
+   */ const visitedAddresses = new Set();
+    const authsFilteredByAddress = auths.filter((auth)=>{
+        const address = getAddressFromIss(auth.p.iss);
+        if (!address || visitedAddresses.has(address)) {
+            return false;
+        }
+        visitedAddresses.add(address);
+        return true;
+    });
+    let lastResponse = undefined;
+    /**
+   * WalletConnect's auth object is what they call a "Cacao" object, with data on the SIWE message
+   * and the signature itself.
+   * By consulting how they implemented their "validateSignedCacao" function,
+   * we are able to reconstruct the original message which can be used to verify the signature
+   * in our backend.
+   */ for (const auth of authsFilteredByAddress){
+        const publicWalletAddress = getAddressFromIss(auth.p.iss);
+        core.assertDefined(publicWalletAddress, `Unable to get public wallet address from WalletConnect Cacao object iss: ${auth.p.iss}`);
+        const messageToSign = utils.formatMessage(auth.p, auth.p.iss);
+        const signature = auth.s.s;
+        lastResponse = await core.verifySignInMessage({
+            chain,
+            messageToSign,
+            signature,
+            walletAddress: publicWalletAddress,
+            walletDisplayName,
+            walletProviderType: sdkApiCore.WalletProviderEnum.WalletConnect
+        }, client);
+    }
+    if (!lastResponse) {
+        return;
+    }
+    /**
+   * Adds the user with the new wallet verified credentials
+   * This will add the new verified wallet accounts to the client`s state
+   */ core.updateAuthFromVerifyResponse({
+        response: lastResponse
+    }, client);
+};
+
+/**
+ * A low level function that is used to connect a WalletConnect authenticate response to the Dynamic SDK.
+ * It will generate the wallet providers and wallet accounts for all accounts in the session.
+ *
+ * @see WalletConnect's docs on [session authentication](https://docs.reown.com/advanced/api/sign/dapp-usage#session-authenticate-with-recaps)
+ * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+ * @returns A promise that resolves to the connected and verified wallet account.
+ */ const importWalletConnectAuthResponse = async ({ authResponse, chain }, client$1)=>{
+    const { session, auths } = authResponse;
+    /**
+   * Some wallets do not support WC's authenticate method (such as Rainbow).
+   * For these wallets, the authenticate method will act as a regular connect method.
+   * Therefore we must call verify individually.
+   */ if (!auths || auths.length === 0) {
+        /**
+     * Set addToDynamicWalletAccounts to false to avoid adding the wallet accounts to the dynamic's wallet accounts
+     * while we are still verifying them.
+     * After verifying, we set addToDynamicWalletAccounts back to true.
+     */ const { walletAccounts } = await importWalletConnectSession({
+            addToDynamicWalletAccounts: false,
+            session
+        }, client$1);
+        // This should not be concurrent because the first will be a verify and the rest will be a link
+        for (const walletAccount of walletAccounts){
+            await client.verifyWalletAccount({
+                walletAccount
+            }, client$1);
+        }
+        await setSessionTopicsData({
+            update: (sessionTopicsData)=>_extends({}, sessionTopicsData, {
+                    [session.topic]: {
+                        shouldAddToDynamicWalletAccounts: true
+                    }
+                })
+        }, client$1);
+        return {
+            walletAccounts
+        };
+    }
+    /**
+   * This reconstructs the message that was signed by the wallet and verifies the signature
+   * in the backend. It will update the user with the new verified credentials.
+   */ await verifyWalletConnectAuths({
+        auths,
+        chain,
+        walletDisplayName: session.peer.metadata.name
+    }, client$1);
+    const { walletAccounts } = await importWalletConnectSession({
+        addToDynamicWalletAccounts: true,
+        session
+    }, client$1);
+    const verifiedCredentialWalletProviderKeyMap = Object.fromEntries(walletAccounts.map((walletAccount)=>{
+        const { verifiedCredentialId } = walletAccount;
+        core.assertDefined(verifiedCredentialId, `Wallet account of ID ${walletAccount.id} still has no verified credential after being verified`);
+        return [
+            verifiedCredentialId,
+            walletAccount.walletProviderKey
+        ];
+    }));
+    core.updateWalletProviderKeysForVerifiedCredentials({
+        keysToUpdate: verifiedCredentialWalletProviderKeyMap
+    }, client$1);
+    return {
+        walletAccounts
+    };
+};
+
 /**
  * Clears all temporary sessions and disconnects from them.
  *
@@ -473,7 +604,7 @@ const syncSessionsToWalletProviders = async ({ debounceTime = 0, allowOverriding
     }
     for (const topic of temporarySessionTopics){
         await signClient.disconnect({
-            reason: USER_DISCONNECTED_REASON,
+            reason: utils.SDK_ERRORS.USER_DISCONNECTED,
             topic
         });
     }
@@ -496,10 +627,10 @@ const initializeWalletConnectExtension = async (client)=>{
 
 assertPackageVersion.assertPackageVersion(isWalletConnectWalletProvider.name, isWalletConnectWalletProvider.version);
 
-exports.USER_DISCONNECTED_REASON = USER_DISCONNECTED_REASON;
-exports.connectWalletConnectSession = connectWalletConnectSession;
 exports.getNamespaceRegistry = getNamespaceRegistry;
 exports.getSignClient = getSignClient;
+exports.importWalletConnectAuthResponse = importWalletConnectAuthResponse;
+exports.importWalletConnectSession = importWalletConnectSession;
 exports.initializeWalletConnectExtension = initializeWalletConnectExtension;
 exports.splitCaip10Token = splitCaip10Token;
 exports.syncSessionsToWalletProviders = syncSessionsToWalletProviders;

package/core.esm.js

@@ -1,8 +1,9 @@
 import { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';
 import { i as isWalletConnectWalletProvider, n as name, v as version } from './isWalletConnectWalletProvider.esm.js';
-import { getWalletAccounts } from '@dynamic-labs-sdk/client';
-import { assertDefined, filterDuplicates, formatWalletAccountId, createStorageKeySchema, getCore, createRuntimeServiceAccessKey, getWalletProviderRegistry, WalletProviderPriority, splitWalletProviderKey, setUnverifiedWalletAccounts, createVisit, emitWalletAccountsChangedEvent, waitForProjectSettings, getWalletProviders } from '@dynamic-labs-sdk/client/core';
+import { getWalletAccounts, verifyWalletAccount } from '@dynamic-labs-sdk/client';
+import { assertDefined, filterDuplicates, formatWalletAccountId, createStorageKeySchema, getCore, createRuntimeServiceAccessKey, getWalletProviderRegistry, WalletProviderPriority, splitWalletProviderKey, updateWalletProviderKeysForVerifiedCredentials, setUnverifiedWalletAccounts, createVisit, emitWalletAccountsChangedEvent, waitForProjectSettings, getWalletProviders, verifySignInMessage, updateAuthFromVerifyResponse } from '@dynamic-labs-sdk/client/core';
 import * as z from 'zod/mini';
+import { SDK_ERRORS, formatMessage } from '@walletconnect/utils';
 import SignClient from '@walletconnect/sign-client';
 import { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';
 
@@ -114,15 +115,6 @@ const sessionTopicsStorageKeySchema = createStorageKeySchema({
     return sessionTopicsData != null ? sessionTopicsData : {};
 };
 
-/**
- * Reason for disconnection when the user disconnects from a WalletConnect session.
- *
- * Source: https://github.com/WalletConnect/walletconnect-monorepo/blob/cc3a9d26dcbd05c92d5ded935b29dc3b6063d147/packages/utils/src/errors.ts#L87
- */ const USER_DISCONNECTED_REASON = {
-    code: 6000,
-    message: 'User disconnected.'
-};
-
 const createSignClient = async (client)=>{
     var _client_projectSettings_sdk_walletConnect, _core_metadata, _core_metadata1;
     const core = getCore(client);
@@ -188,7 +180,11 @@ const addMissingWalletProvidersForSessions = async ({ sessions, allowOverridingW
     /**
    * Keep record on which wallet account IDs already exist but will have
    * their wallet provider keys overridden to use the new WC wallet provider key.
-   */ const walletAccountsToOverride = new Set();
+   *
+   * This will only ever be the case for unverified wallet accounts, however. That is
+   * because verified wallets will already override the wallet provider key on the verification
+   * step, which happens at the call to verifyWalletConnectAuths, which happens before this function.
+   */ const unverifiedWalletAccountsToOverride = new Set();
     for (const session of sessions){
         const namespaceKeys = Object.keys(session.namespaces);
         for (const namespaceKey of namespaceKeys){
@@ -198,7 +194,12 @@ const addMissingWalletProvidersForSessions = async ({ sessions, allowOverridingW
                 continue;
             }
             const walletProviderBuilder = namespaceRegistry.getWalletProviderBuilder(namespaceKey);
-            if (!walletProviderBuilder) {
+            /**
+       * There being no wallet provider builder for this namespace simply means the customer
+       * didn't add an extension for the corresponding chain.
+       * For instance, if we get a namespace for Solana but only have an Evm extension,
+       * the solana namespace would fall here. No need to throw.
+       */ if (!walletProviderBuilder) {
                 continue;
             }
             const walletProvider = await walletProviderBuilder({
@@ -236,17 +237,27 @@ const addMissingWalletProvidersForSessions = async ({ sessions, allowOverridingW
                 const existingWalletIsWalletConnect = splitWalletProviderKey(existingAccount.walletProviderKey).walletProviderType === WalletProviderEnum.WalletConnect;
                 if (allowOverridingWalletProviders || existingWalletIsWalletConnect) {
                     createdWalletAccounts[createdWalletAccount.id] = createdWalletAccount;
-                    walletAccountsToOverride.add(createdWalletAccount.id);
+                    if (existingAccount.verifiedCredentialId) {
+                        /**
+             * A verified wallet account only arrives here when its wallet provider key is lacking the suffix,
+             * which should be the sessionTopic. So we just need to add its entry to the verifiedCredentialId map.
+             */ updateWalletProviderKeysForVerifiedCredentials({
+                            keysToUpdate: {
+                                [existingAccount.verifiedCredentialId]: walletProvider.key
+                            }
+                        }, client);
+                    } else {
+                        unverifiedWalletAccountsToOverride.add(createdWalletAccount.id);
+                    }
                 }
             }
         }
     }
-    if (walletAccountsToOverride.size === 0 && brandNewWalletAccounts.size === 0) {
+    if (unverifiedWalletAccountsToOverride.size === 0 && brandNewWalletAccounts.size === 0) {
         return {
             walletProvidersWithActiveSession
         };
     }
-    // For now we only support connect only, so we only need to worry about unverified wallet accounts.
     setUnverifiedWalletAccounts({
         unverifiedWalletAccountsToUpdate: Object.values(createdWalletAccounts)
     }, client);
@@ -274,7 +285,7 @@ const doSyncSessionsToWalletProviders = async ({ allowOverridingWalletProviders
         }
         // If we don't have data for this session, it is corrupted and we need to disconnect
         void signClient.disconnect({
-            reason: USER_DISCONNECTED_REASON,
+            reason: SDK_ERRORS.USER_DISCONNECTED,
             topic: session.topic
         });
         return false;
@@ -314,14 +325,15 @@ const doSyncSessionsToWalletProviders = async ({ allowOverridingWalletProviders
         }
     }
     // Step 4: kill sessions and their wallet providers if they have no more wallet accounts
+    // Ignore sessions that are NOT marked as shouldAddToDynamicWalletAccounts
     for (const [sessionTopic, hasWalletAccount] of sessionTopicHasWalletAccountMap){
-        if (hasWalletAccount) {
+        if (hasWalletAccount || !sessionTopicsData[sessionTopic].shouldAddToDynamicWalletAccounts) {
             continue;
         }
         const session = sessions.find((session)=>session.topic === sessionTopic);
         if (session) {
             void signClient.disconnect({
-                reason: USER_DISCONNECTED_REASON,
+                reason: SDK_ERRORS.USER_DISCONNECTED,
                 topic: session.topic
             });
         }
@@ -361,7 +373,7 @@ const syncSessionsToWalletProviders = async ({ debounceTime = 0, allowOverriding
  * @param addToDynamicWalletAccounts - Whether to add the wallet accounts to the dynamic's wallet accounts.
  * @param client - The Dynamic client instance. Only required when using multiple Dynamic clients.
  * @returns The wallet accounts.
- */ const connectWalletConnectSession = async ({ addToDynamicWalletAccounts = true, session }, client)=>{
+ */ const importWalletConnectSession = async ({ addToDynamicWalletAccounts = true, session }, client)=>{
     /**
    * You would normally get the session from the signClient.connect method. It takes the optionalNamespaces as an argument.
    *
@@ -434,6 +446,125 @@ const syncSessionsToWalletProviders = async ({ debounceTime = 0, allowOverriding
     };
 };
 
+const getAddressFromIss = (iss)=>iss.split(':')[4];
+const verifyWalletConnectAuths = async ({ auths, chain, walletDisplayName }, client)=>{
+    /**
+   * The only differences between each auth object will be the signature (auth.s.s)
+   * and the iss (auth.p.iss).
+   *
+   * The iss is comprised of 2 WC fields that are irrelevant to us and then the CAIP-10 token
+   * of the address, where the first 2 fields are also split by the ":" character.
+   *
+   * Usually, there will be multiple auths if the wallet app bundles signatures for multiple
+   * networks at once, so the only field that will change among auth iss will be the networkId under iss.
+   */ const visitedAddresses = new Set();
+    const authsFilteredByAddress = auths.filter((auth)=>{
+        const address = getAddressFromIss(auth.p.iss);
+        if (!address || visitedAddresses.has(address)) {
+            return false;
+        }
+        visitedAddresses.add(address);
+        return true;
+    });
+    let lastResponse = undefined;
+    /**
+   * WalletConnect's auth object is what they call a "Cacao" object, with data on the SIWE message
+   * and the signature itself.
+   * By consulting how they implemented their "validateSignedCacao" function,
+   * we are able to reconstruct the original message which can be used to verify the signature
+   * in our backend.
+   */ for (const auth of authsFilteredByAddress){
+        const publicWalletAddress = getAddressFromIss(auth.p.iss);
+        assertDefined(publicWalletAddress, `Unable to get public wallet address from WalletConnect Cacao object iss: ${auth.p.iss}`);
+        const messageToSign = formatMessage(auth.p, auth.p.iss);
+        const signature = auth.s.s;
+        lastResponse = await verifySignInMessage({
+            chain,
+            messageToSign,
+            signature,
+            walletAddress: publicWalletAddress,
+            walletDisplayName,
+            walletProviderType: WalletProviderEnum.WalletConnect
+        }, client);
+    }
+    if (!lastResponse) {
+        return;
+    }
+    /**
+   * Adds the user with the new wallet verified credentials
+   * This will add the new verified wallet accounts to the client`s state
+   */ updateAuthFromVerifyResponse({
+        response: lastResponse
+    }, client);
+};
+
+/**
+ * A low level function that is used to connect a WalletConnect authenticate response to the Dynamic SDK.
+ * It will generate the wallet providers and wallet accounts for all accounts in the session.
+ *
+ * @see WalletConnect's docs on [session authentication](https://docs.reown.com/advanced/api/sign/dapp-usage#session-authenticate-with-recaps)
+ * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+ * @returns A promise that resolves to the connected and verified wallet account.
+ */ const importWalletConnectAuthResponse = async ({ authResponse, chain }, client)=>{
+    const { session, auths } = authResponse;
+    /**
+   * Some wallets do not support WC's authenticate method (such as Rainbow).
+   * For these wallets, the authenticate method will act as a regular connect method.
+   * Therefore we must call verify individually.
+   */ if (!auths || auths.length === 0) {
+        /**
+     * Set addToDynamicWalletAccounts to false to avoid adding the wallet accounts to the dynamic's wallet accounts
+     * while we are still verifying them.
+     * After verifying, we set addToDynamicWalletAccounts back to true.
+     */ const { walletAccounts } = await importWalletConnectSession({
+            addToDynamicWalletAccounts: false,
+            session
+        }, client);
+        // This should not be concurrent because the first will be a verify and the rest will be a link
+        for (const walletAccount of walletAccounts){
+            await verifyWalletAccount({
+                walletAccount
+            }, client);
+        }
+        await setSessionTopicsData({
+            update: (sessionTopicsData)=>_extends({}, sessionTopicsData, {
+                    [session.topic]: {
+                        shouldAddToDynamicWalletAccounts: true
+                    }
+                })
+        }, client);
+        return {
+            walletAccounts
+        };
+    }
+    /**
+   * This reconstructs the message that was signed by the wallet and verifies the signature
+   * in the backend. It will update the user with the new verified credentials.
+   */ await verifyWalletConnectAuths({
+        auths,
+        chain,
+        walletDisplayName: session.peer.metadata.name
+    }, client);
+    const { walletAccounts } = await importWalletConnectSession({
+        addToDynamicWalletAccounts: true,
+        session
+    }, client);
+    const verifiedCredentialWalletProviderKeyMap = Object.fromEntries(walletAccounts.map((walletAccount)=>{
+        const { verifiedCredentialId } = walletAccount;
+        assertDefined(verifiedCredentialId, `Wallet account of ID ${walletAccount.id} still has no verified credential after being verified`);
+        return [
+            verifiedCredentialId,
+            walletAccount.walletProviderKey
+        ];
+    }));
+    updateWalletProviderKeysForVerifiedCredentials({
+        keysToUpdate: verifiedCredentialWalletProviderKeyMap
+    }, client);
+    return {
+        walletAccounts
+    };
+};
+
 /**
  * Clears all temporary sessions and disconnects from them.
  *
@@ -452,7 +583,7 @@ const syncSessionsToWalletProviders = async ({ debounceTime = 0, allowOverriding
     }
     for (const topic of temporarySessionTopics){
         await signClient.disconnect({
-            reason: USER_DISCONNECTED_REASON,
+            reason: SDK_ERRORS.USER_DISCONNECTED,
             topic
         });
     }
@@ -475,4 +606,4 @@ const initializeWalletConnectExtension = async (client)=>{
 
 assertPackageVersion(name, version);
 
-export { USER_DISCONNECTED_REASON, connectWalletConnectSession, getNamespaceRegistry, getSignClient, initializeWalletConnectExtension, splitCaip10Token, syncSessionsToWalletProviders };
+export { getNamespaceRegistry, getSignClient, importWalletConnectAuthResponse, importWalletConnectSession, initializeWalletConnectExtension, splitCaip10Token, syncSessionsToWalletProviders };

package/isWalletConnectWalletProvider.cjs.js

@@ -1,7 +1,7 @@
 'use strict';
 
 var name = "@dynamic-labs-sdk/wallet-connect";
-var version = "0.1.0-alpha.19";
+var version = "0.1.0-alpha.21";
 
 /**
  * This is a way to ensure Typescript will guard that all keys defined in

package/isWalletConnectWalletProvider.esm.js

@@ -1,5 +1,5 @@
 var name = "@dynamic-labs-sdk/wallet-connect";
-var version = "0.1.0-alpha.19";
+var version = "0.1.0-alpha.21";
 
 /**
  * This is a way to ensure Typescript will guard that all keys defined in

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs-sdk/wallet-connect",
-  "version": "0.1.0-alpha.19",
+  "version": "0.1.0-alpha.21",
   "type": "module",
   "main": "./index.cjs.js",
   "module": "./index.esm.js",
@@ -19,10 +19,11 @@
     }
   },
   "dependencies": {
-    "@dynamic-labs-sdk/assert-package-version": "0.1.0-alpha.19",
-    "@dynamic-labs-sdk/client": "0.1.0-alpha.19",
+    "@dynamic-labs-sdk/assert-package-version": "0.1.0-alpha.21",
+    "@dynamic-labs-sdk/client": "0.1.0-alpha.21",
     "@walletconnect/sign-client": "2.21.8",
     "@walletconnect/types": "2.21.8",
+    "@walletconnect/utils": "2.21.8",
     "@dynamic-labs/sdk-api-core": "0.0.805",
     "zod": "4.0.5"
   },

package/src/exports/core.d.ts

@@ -1,8 +1,8 @@
-export { connectWalletConnectSession } from '../connectWalletConnectSession';
+export { importWalletConnectAuthResponse } from '../importWalletConnectAuthResponse';
+export { importWalletConnectSession } from '../importWalletConnectSession';
 export { initializeWalletConnectExtension } from '../initializeWalletConnectExtension';
 export { getNamespaceRegistry } from '../namespaceRegistry';
 export type { NamespaceRegistry } from '../namespaceRegistry/namespaceRegistry.types';
-export { USER_DISCONNECTED_REASON } from '../signClient/consts';
 export { getSignClient } from '../signClient/getSignClient';
 export { splitCaip10Token } from '../splitCaip10Token';
 export { syncSessionsToWalletProviders } from '../syncSessionsToWalletProviders';

package/src/exports/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../../packages/wallet-connect/src/exports/core.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAC;AACvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AACjF,YAAY,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../../packages/wallet-connect/src/exports/core.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,+BAA+B,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAC;AACvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AACjF,YAAY,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC"}

package/src/importWalletConnectAuthResponse/importWalletConnectAuthResponse.d.ts

@@ -0,0 +1,26 @@
+import type { Chain, DynamicClient } from '@dynamic-labs-sdk/client';
+import { type WalletAccount } from '@dynamic-labs-sdk/client';
+import type { AuthTypes } from '@walletconnect/types';
+type ImportWalletConnectAuthResponseParams = {
+    /**
+     * The response from the WalletConnect authenticate method.
+     */
+    authResponse: AuthTypes.AuthenticateResponseResult;
+    /**
+     * The chain with which the wallet account is associated.
+     */
+    chain: Chain;
+};
+/**
+ * A low level function that is used to connect a WalletConnect authenticate response to the Dynamic SDK.
+ * It will generate the wallet providers and wallet accounts for all accounts in the session.
+ *
+ * @see WalletConnect's docs on [session authentication](https://docs.reown.com/advanced/api/sign/dapp-usage#session-authenticate-with-recaps)
+ * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+ * @returns A promise that resolves to the connected and verified wallet account.
+ */
+export declare const importWalletConnectAuthResponse: ({ authResponse, chain }: ImportWalletConnectAuthResponseParams, client: DynamicClient) => Promise<{
+    walletAccounts: WalletAccount[];
+}>;
+export {};
+//# sourceMappingURL=importWalletConnectAuthResponse.d.ts.map

package/src/importWalletConnectAuthResponse/importWalletConnectAuthResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importWalletConnectAuthResponse.d.ts","sourceRoot":"","sources":["../../../../../packages/wallet-connect/src/importWalletConnectAuthResponse/importWalletConnectAuthResponse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,0BAA0B,CAAC;AAKlC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAMtD,KAAK,qCAAqC,GAAG;IAC3C;;OAEG;IACH,YAAY,EAAE,SAAS,CAAC,0BAA0B,CAAC;IAEnD;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,4BACjB,qCAAqC,UACtD,aAAa,KACpB,OAAO,CAAC;IAAE,cAAc,EAAE,aAAa,EAAE,CAAA;CAAE,CA4E7C,CAAC"}

package/src/importWalletConnectAuthResponse/index.d.ts

@@ -0,0 +1,2 @@
+export { importWalletConnectAuthResponse } from './importWalletConnectAuthResponse';
+//# sourceMappingURL=index.d.ts.map

package/src/importWalletConnectAuthResponse/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/wallet-connect/src/importWalletConnectAuthResponse/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC"}

package/src/importWalletConnectAuthResponse/verifyWalletConnectAuths/index.d.ts

@@ -0,0 +1,2 @@
+export { verifyWalletConnectAuths } from './verifyWalletConnectAuths';
+//# sourceMappingURL=index.d.ts.map

package/src/importWalletConnectAuthResponse/verifyWalletConnectAuths/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/wallet-connect/src/importWalletConnectAuthResponse/verifyWalletConnectAuths/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC"}

package/src/importWalletConnectAuthResponse/verifyWalletConnectAuths/verifyWalletConnectAuths.d.ts

@@ -0,0 +1,10 @@
+import type { Chain, DynamicClient } from '@dynamic-labs-sdk/client';
+import type { AuthTypes } from '@walletconnect/types';
+type VerifyWalletConnectAuthsParams = {
+    auths: AuthTypes.Cacao[];
+    chain: Chain;
+    walletDisplayName: string;
+};
+export declare const verifyWalletConnectAuths: ({ auths, chain, walletDisplayName }: VerifyWalletConnectAuthsParams, client: DynamicClient) => Promise<void>;
+export {};
+//# sourceMappingURL=verifyWalletConnectAuths.d.ts.map

package/src/importWalletConnectAuthResponse/verifyWalletConnectAuths/verifyWalletConnectAuths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifyWalletConnectAuths.d.ts","sourceRoot":"","sources":["../../../../../../packages/wallet-connect/src/importWalletConnectAuthResponse/verifyWalletConnectAuths/verifyWalletConnectAuths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,aAAa,EAEd,MAAM,0BAA0B,CAAC;AAOlC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAKtD,KAAK,8BAA8B,GAAG;IACpC,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,wBAAwB,wCACE,8BAA8B,UAC3D,aAAa,kBAqEtB,CAAC"}

package/src/{connectWalletConnectSession/connectWalletConnectSession.d.ts → importWalletConnectSession/importWalletConnectSession.d.ts}

@@ -1,7 +1,7 @@
 import type { DynamicClient } from '@dynamic-labs-sdk/client';
 import { type WalletAccount } from '@dynamic-labs-sdk/client';
 import type { SessionTypes } from '@walletconnect/types';
-type ConnectWithWalletConnectParams = {
+type ImportWalletConnectSessionParams = {
     /**
      * Whether this session's wallet accounts should be added to the dynamic's wallet accounts.
      */
@@ -20,8 +20,8 @@ type ConnectWithWalletConnectParams = {
  * @param client - The Dynamic client instance. Only required when using multiple Dynamic clients.
  * @returns The wallet accounts.
  */
-export declare const connectWalletConnectSession: ({ addToDynamicWalletAccounts, session, }: ConnectWithWalletConnectParams, client: DynamicClient) => Promise<{
+export declare const importWalletConnectSession: ({ addToDynamicWalletAccounts, session, }: ImportWalletConnectSessionParams, client: DynamicClient) => Promise<{
     walletAccounts: WalletAccount[];
 }>;
 export {};
-//# sourceMappingURL=connectWalletConnectSession.d.ts.map
+//# sourceMappingURL=importWalletConnectSession.d.ts.map

package/src/importWalletConnectSession/importWalletConnectSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importWalletConnectSession.d.ts","sourceRoot":"","sources":["../../../../../packages/wallet-connect/src/importWalletConnectSession/importWalletConnectSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAQzD,KAAK,gCAAgC,GAAG;IACtC;;OAEG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC;CAC9B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,6CAIlC,gCAAgC,UAC3B,aAAa,KACpB,OAAO,CAAC;IAAE,cAAc,EAAE,aAAa,EAAE,CAAA;CAAE,CA6F7C,CAAC"}

package/src/importWalletConnectSession/index.d.ts

@@ -0,0 +1,2 @@
+export { importWalletConnectSession } from './importWalletConnectSession';
+//# sourceMappingURL=index.d.ts.map

package/src/importWalletConnectSession/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/wallet-connect/src/importWalletConnectSession/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC"}

package/src/sessionTopicsData/clearTemporarySessions/clearTemporarySessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clearTemporarySessions.d.ts","sourceRoot":"","sources":["../../../../../../packages/wallet-connect/src/sessionTopicsData/clearTemporarySessions/clearTemporarySessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAO9D;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,WAAkB,aAAa,kBAyBjE,CAAC"}
+{"version":3,"file":"clearTemporarySessions.d.ts","sourceRoot":"","sources":["../../../../../../packages/wallet-connect/src/sessionTopicsData/clearTemporarySessions/clearTemporarySessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAO9D;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,WAAkB,aAAa,kBA4BjE,CAAC"}

package/src/syncSessionsToWalletProviders/addMissingWalletProvidersForSessions/addMissingWalletProvidersForSessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addMissingWalletProvidersForSessions.d.ts","sourceRoot":"","sources":["../../../../../../packages/wallet-connect/src/syncSessionsToWalletProviders/addMissingWalletProvidersForSessions/addMissingWalletProvidersForSessions.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,0BAA0B,CAAC;AAUlC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAMzD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAE3F,KAAK,0CAA0C,GAAG;IAChD,8BAA8B,EAAE,OAAO,CAAC;IACxC,QAAQ,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,oCAAoC,kDAI5C,0CAA0C,UACrC,aAAa,KACpB,OAAO,CAAC;IACT,gCAAgC,EAAE,2BAA2B,EAAE,CAAC;CACjE,CAwJA,CAAC"}
+{"version":3,"file":"addMissingWalletProvidersForSessions.d.ts","sourceRoot":"","sources":["../../../../../../packages/wallet-connect/src/syncSessionsToWalletProviders/addMissingWalletProvidersForSessions/addMissingWalletProvidersForSessions.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,0BAA0B,CAAC;AAWlC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAMzD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAE3F,KAAK,0CAA0C,GAAG;IAChD,8BAA8B,EAAE,OAAO,CAAC;IACxC,QAAQ,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,oCAAoC,kDAI5C,0CAA0C,UACrC,aAAa,KACpB,OAAO,CAAC;IACT,gCAAgC,EAAE,2BAA2B,EAAE,CAAC;CACjE,CAkLA,CAAC"}

package/src/syncSessionsToWalletProviders/syncSessionsToWalletProviders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"syncSessionsToWalletProviders.d.ts","sourceRoot":"","sources":["../../../../../packages/wallet-connect/src/syncSessionsToWalletProviders/syncSessionsToWalletProviders.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,0BAA0B,CAAC;AAmJlC,KAAK,mCAAmC,GAAG;IACzC,8BAA8B,EAAE,OAAO,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,6BAA6B,sDAIrC,mCAAmC,UAC9B,aAAa,iBAetB,CAAC"}
+{"version":3,"file":"syncSessionsToWalletProviders.d.ts","sourceRoot":"","sources":["../../../../../packages/wallet-connect/src/syncSessionsToWalletProviders/syncSessionsToWalletProviders.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,0BAA0B,CAAC;AAuJlC,KAAK,mCAAmC,GAAG;IACzC,8BAA8B,EAAE,OAAO,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,6BAA6B,sDAIrC,mCAAmC,UAC9B,aAAa,iBAetB,CAAC"}

package/src/connectWalletConnectSession/connectWalletConnectSession.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"connectWalletConnectSession.d.ts","sourceRoot":"","sources":["../../../../../packages/wallet-connect/src/connectWalletConnectSession/connectWalletConnectSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAQzD,KAAK,8BAA8B,GAAG;IACpC;;OAEG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC;CAC9B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,6CAInC,8BAA8B,UACzB,aAAa,KACpB,OAAO,CAAC;IAAE,cAAc,EAAE,aAAa,EAAE,CAAA;CAAE,CA6F7C,CAAC"}

package/src/connectWalletConnectSession/index.d.ts

@@ -1,2 +0,0 @@
-export { connectWalletConnectSession } from './connectWalletConnectSession';
-//# sourceMappingURL=index.d.ts.map

package/src/connectWalletConnectSession/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/wallet-connect/src/connectWalletConnectSession/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC"}

package/src/signClient/consts.d.ts

@@ -1,10 +0,0 @@
-/**
- * Reason for disconnection when the user disconnects from a WalletConnect session.
- *
- * Source: https://github.com/WalletConnect/walletconnect-monorepo/blob/cc3a9d26dcbd05c92d5ded935b29dc3b6063d147/packages/utils/src/errors.ts#L87
- */
-export declare const USER_DISCONNECTED_REASON: {
-    readonly code: 6000;
-    readonly message: "User disconnected.";
-};
-//# sourceMappingURL=consts.d.ts.map

package/src/signClient/consts.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../../../../packages/wallet-connect/src/signClient/consts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;CAG3B,CAAC"}