@dynamic-labs-sdk/client 0.1.0-alpha.15 → 0.1.0-alpha.17

package/CHANGELOG.md

@@ -1,3 +1,127 @@
+## 0.1.0-alpha.17 (2025-10-02)
+
+### 🩹 Fixes
+
+- add return type to connect with wallet provider ([#497](https://github.com/dynamic-labs/dynamic-sdk/pull/497))
+
+## 0.1.0-alpha.16 (2025-10-01)
+
+### 🚀 Features
+
+- logout user when session expires ([#47](https://github.com/dynamic-labs/dynamic-sdk/pull/47))
+- add sms verification ([#78](https://github.com/dynamic-labs/dynamic-sdk/pull/78))
+- raise changed events for state variables ([#79](https://github.com/dynamic-labs/dynamic-sdk/pull/79))
+- allow extending the client ([#80](https://github.com/dynamic-labs/dynamic-sdk/pull/80))
+- allow manual init of client ([#88](https://github.com/dynamic-labs/dynamic-sdk/pull/88))
+- add signMessage ([#111](https://github.com/dynamic-labs/dynamic-sdk/pull/111))
+- support social sign in ([#123](https://github.com/dynamic-labs/dynamic-sdk/pull/123))
+- add updateUser function ([#138](https://github.com/dynamic-labs/dynamic-sdk/pull/138))
+- add acknowledgeRecoveryCodes function ([#139](https://github.com/dynamic-labs/dynamic-sdk/pull/139))
+- add getMfaDevices function ([#140](https://github.com/dynamic-labs/dynamic-sdk/pull/140))
+- add deleteMfaDevice function ([#141](https://github.com/dynamic-labs/dynamic-sdk/pull/141))
+- add registerTotpMfaDevice function ([#142](https://github.com/dynamic-labs/dynamic-sdk/pull/142))
+- add getMfaRecoveryCodes function ([#143](https://github.com/dynamic-labs/dynamic-sdk/pull/143))
+- cache project settings for connected users ([#148](https://github.com/dynamic-labs/dynamic-sdk/pull/148))
+- add createNewMfaRecoveryCodes function ([#144](https://github.com/dynamic-labs/dynamic-sdk/pull/144))
+- add setDefaultMfaDevice function ([#149](https://github.com/dynamic-labs/dynamic-sdk/pull/149))
+- add support for solana wallet standard ([#133](https://github.com/dynamic-labs/dynamic-sdk/pull/133))
+- add primary wallet account ([#128](https://github.com/dynamic-labs/dynamic-sdk/pull/128))
+- add authTotpMfaDevice function ([#146](https://github.com/dynamic-labs/dynamic-sdk/pull/146))
+- add authMfaRecoveryCode function ([#147](https://github.com/dynamic-labs/dynamic-sdk/pull/147))
+- add new getMultichainBalances api method ([#219](https://github.com/dynamic-labs/dynamic-sdk/pull/219))
+- adds authenticated event ([#222](https://github.com/dynamic-labs/dynamic-sdk/pull/222))
+- raise an error if different dynamic packages are on different versions ([#253](https://github.com/dynamic-labs/dynamic-sdk/pull/253))
+- add signInWithExternalJwt function ([#263](https://github.com/dynamic-labs/dynamic-sdk/pull/263))
+- add network provider registry and API ([#266](https://github.com/dynamic-labs/dynamic-sdk/pull/266))
+- add ethereum netowrk providers ([#267](https://github.com/dynamic-labs/dynamic-sdk/pull/267))
+- add solana network provider ([#268](https://github.com/dynamic-labs/dynamic-sdk/pull/268))
+- add proveWalletAccountOwnership function ([#295](https://github.com/dynamic-labs/dynamic-sdk/pull/295))
+- format evm wallet addresses to conform to eip55 ([#300](https://github.com/dynamic-labs/dynamic-sdk/pull/300))
+- add viem public client ([#272](https://github.com/dynamic-labs/dynamic-sdk/pull/272))
+- add getSolanaConnection ([#275](https://github.com/dynamic-labs/dynamic-sdk/pull/275))
+- add dynamic waas evm extension ([#299](https://github.com/dynamic-labs/dynamic-sdk/pull/299))
+- add refreshUser function ([#332](https://github.com/dynamic-labs/dynamic-sdk/pull/332))
+- add get network method ([#321](https://github.com/dynamic-labs/dynamic-sdk/pull/321))
+- add createWaasWallet function ([#343](https://github.com/dynamic-labs/dynamic-sdk/pull/343))
+- allow switching network ([#323](https://github.com/dynamic-labs/dynamic-sdk/pull/323))
+- introduce getBalance and getBalanceForAddress ([#335](https://github.com/dynamic-labs/dynamic-sdk/pull/335))
+- add delegateWaasKeyShares function ([#353](https://github.com/dynamic-labs/dynamic-sdk/pull/353))
+- add updateWaasPassword function ([#354](https://github.com/dynamic-labs/dynamic-sdk/pull/354))
+- add exportWaasClientKeyshares function ([#355](https://github.com/dynamic-labs/dynamic-sdk/pull/355))
+- add importWaasPrivateKey function ([#356](https://github.com/dynamic-labs/dynamic-sdk/pull/356))
+- add refreshWaasWalletAccountShares function ([#357](https://github.com/dynamic-labs/dynamic-sdk/pull/357))
+- add backupWaasKeySharesToGoogleDrive function ([#358](https://github.com/dynamic-labs/dynamic-sdk/pull/358))
+- add exportWaasPrivateKey function ([#359](https://github.com/dynamic-labs/dynamic-sdk/pull/359))
+- add isWaasWalletAccount function ([#365](https://github.com/dynamic-labs/dynamic-sdk/pull/365))
+- add createWalletClientForWalletAccount function ([#367](https://github.com/dynamic-labs/dynamic-sdk/pull/367))
+- add connectAndVerifyWithWalletProvider function ([#385](https://github.com/dynamic-labs/dynamic-sdk/pull/385))
+- add event listening for wallet providers ([#389](https://github.com/dynamic-labs/dynamic-sdk/pull/389))
+- expose the session expires at date ([#420](https://github.com/dynamic-labs/dynamic-sdk/pull/420))
+- refresh user when cookies are enabled ([#430](https://github.com/dynamic-labs/dynamic-sdk/pull/430))
+- introduce waitForClientInitialized ([#436](https://github.com/dynamic-labs/dynamic-sdk/pull/436))
+- introduce isMobile helper utility ([#441](https://github.com/dynamic-labs/dynamic-sdk/pull/441))
+- persist unverified wallets in local storage ([#448](https://github.com/dynamic-labs/dynamic-sdk/pull/448))
+- **QNTM-3387:** add sui base infrastructure and core client ([#240](https://github.com/dynamic-labs/dynamic-sdk/pull/240))
+- **SIN-7:** Add Signin with Passkey ([#201](https://github.com/dynamic-labs/dynamic-sdk/pull/201))
+- **wallets:** adds methods to connect and verify a wallet ([#99](https://github.com/dynamic-labs/dynamic-sdk/pull/99))
+
+### 🩹 Fixes
+
+- make the client package public ([#74](https://github.com/dynamic-labs/dynamic-sdk/pull/74))
+- properly export state changed events ([#85](https://github.com/dynamic-labs/dynamic-sdk/pull/85))
+- client core accidentally sharing state among different instances ([#89](https://github.com/dynamic-labs/dynamic-sdk/pull/89))
+- support server side rendering ([#92](https://github.com/dynamic-labs/dynamic-sdk/pull/92))
+- use correct import path for commonjs ([#125](https://github.com/dynamic-labs/dynamic-sdk/pull/125))
+- ensure change events are fired only when state changes ([#168](https://github.com/dynamic-labs/dynamic-sdk/pull/168))
+- solana integration ([#169](https://github.com/dynamic-labs/dynamic-sdk/pull/169))
+- throw when attempting to set undefined prop in storage ([#200](https://github.com/dynamic-labs/dynamic-sdk/pull/200))
+- allow the api call to include cookie credentials ([#209](https://github.com/dynamic-labs/dynamic-sdk/pull/209))
+- convert api headers to get api headers ([#211](https://github.com/dynamic-labs/dynamic-sdk/pull/211))
+- import zod mini using namespace ([#214](https://github.com/dynamic-labs/dynamic-sdk/pull/214))
+- bind fetch to window ([#265](https://github.com/dynamic-labs/dynamic-sdk/pull/265))
+- update default API base URL ([#296](https://github.com/dynamic-labs/dynamic-sdk/pull/296))
+- remove version pin on sdk-api-core ([#351](https://github.com/dynamic-labs/dynamic-sdk/pull/351))
+- sending transaction with solana ([#381](https://github.com/dynamic-labs/dynamic-sdk/pull/381))
+- set client version to project settings api call ([#414](https://github.com/dynamic-labs/dynamic-sdk/pull/414))
+- logout with wallet standard sol wallets ([#423](https://github.com/dynamic-labs/dynamic-sdk/pull/423))
+- logout user when any api call fails with 401 ([#432](https://github.com/dynamic-labs/dynamic-sdk/pull/432))
+- logout for connected only wallets ([#437](https://github.com/dynamic-labs/dynamic-sdk/pull/437))
+- ensure server side rendering will not trigger any api call ([#445](https://github.com/dynamic-labs/dynamic-sdk/pull/445))
+- handle 401 when initializing the SDK ([#446](https://github.com/dynamic-labs/dynamic-sdk/pull/446))
+- logout user when any api call fails with 401 " ([#432](https://github.com/dynamic-labs/dynamic-sdk/pull/432), [#450](https://github.com/dynamic-labs/dynamic-sdk/pull/450))
+- logout user only when it fails to refresh user with cookies ([#451](https://github.com/dynamic-labs/dynamic-sdk/pull/451))
+- update how wallet account id is computed to support multiple wallet accounts with the same address ([#481](https://github.com/dynamic-labs/dynamic-sdk/pull/481))
+- **mfa:** make device id optional ([#175](https://github.com/dynamic-labs/dynamic-sdk/pull/175))
+- **mfa:** allow create mfa options to authTotpMfaDevice ([#178](https://github.com/dynamic-labs/dynamic-sdk/pull/178))
+
+### 🔧 Refactors
+
+- rename initializationManager to asyncTrack ([#26](https://github.com/dynamic-labs/dynamic-sdk/pull/26))
+- modularize DynamicCoreState with global interface ([#93](https://github.com/dynamic-labs/dynamic-sdk/pull/93))
+- add setVerifyResponse ([#106](https://github.com/dynamic-labs/dynamic-sdk/pull/106))
+- rename set verify response function ([#122](https://github.com/dynamic-labs/dynamic-sdk/pull/122))
+- clean up social implementation ([#145](https://github.com/dynamic-labs/dynamic-sdk/pull/145))
+- reorganize exports index file ([#303](https://github.com/dynamic-labs/dynamic-sdk/pull/303))
+- rename events folder to clientEvents ([#305](https://github.com/dynamic-labs/dynamic-sdk/pull/305))
+- dry network provider type ([#308](https://github.com/dynamic-labs/dynamic-sdk/pull/308))
+- rename types files to include the features name ([#319](https://github.com/dynamic-labs/dynamic-sdk/pull/319))
+- use evm instead of other terms ([#306](https://github.com/dynamic-labs/dynamic-sdk/pull/306))
+- rename net configuration to net data ([#322](https://github.com/dynamic-labs/dynamic-sdk/pull/322))
+- move waas-utils to client package ([#342](https://github.com/dynamic-labs/dynamic-sdk/pull/342))
+- assert signed session id in getSignedSessionId ([#361](https://github.com/dynamic-labs/dynamic-sdk/pull/361))
+- add consumeMfaTokenIfRequiredForAction function ([#363](https://github.com/dynamic-labs/dynamic-sdk/pull/363))
+- waas sign message defined in waas provider ([#377](https://github.com/dynamic-labs/dynamic-sdk/pull/377))
+- ban chain enum ([#386](https://github.com/dynamic-labs/dynamic-sdk/pull/386))
+- ban misplaced waas exports ([#387](https://github.com/dynamic-labs/dynamic-sdk/pull/387))
+- also apply lint-tsc for specfiles ([#399](https://github.com/dynamic-labs/dynamic-sdk/pull/399))
+- require client to always be passed as a param for internal code ([#401](https://github.com/dynamic-labs/dynamic-sdk/pull/401))
+- linter rule for addExtension functions ([#433](https://github.com/dynamic-labs/dynamic-sdk/pull/433))
+- improve demo ui and organization ([#434](https://github.com/dynamic-labs/dynamic-sdk/pull/434))
+- misc improvements ([#438](https://github.com/dynamic-labs/dynamic-sdk/pull/438))
+- add linter rule for unpinned dependencies ([#439](https://github.com/dynamic-labs/dynamic-sdk/pull/439))
+- rework captcha code for demo ([#449](https://github.com/dynamic-labs/dynamic-sdk/pull/449))
+- rename schemas ([#471](https://github.com/dynamic-labs/dynamic-sdk/pull/471))
+
 ## 0.1.0-alpha.15 (2025-10-01)
 
 This was a version bump only, there were no code changes.

package/constants.cjs.js

@@ -3,9 +3,9 @@
 const DEFAULT_WAAS_BASE_API_URL = 'https://app.dynamicauth.com';
 const DEFAULT_WAAS_BASE_MPC_RELAY_API_URL = 'https://relay.dynamicauth.com';
 const DYNAMIC_WAAS_METADATA = {
+    displayName: 'Dynamic WaaS',
     icon: 'https://iconic.dynamic-static-assets.com/icons/sprite.svg#dynamicwaas',
-    key: 'dynamicwaas',
-    name: 'Dynamic WaaS'
+    normalizedWalletName: 'dynamicwaas'
 };
 
 exports.DEFAULT_WAAS_BASE_API_URL = DEFAULT_WAAS_BASE_API_URL;

package/constants.esm.js

@@ -1,9 +1,9 @@
 const DEFAULT_WAAS_BASE_API_URL = 'https://app.dynamicauth.com';
 const DEFAULT_WAAS_BASE_MPC_RELAY_API_URL = 'https://relay.dynamicauth.com';
 const DYNAMIC_WAAS_METADATA = {
+    displayName: 'Dynamic WaaS',
     icon: 'https://iconic.dynamic-static-assets.com/icons/sprite.svg#dynamicwaas',
-    key: 'dynamicwaas',
-    name: 'Dynamic WaaS'
+    normalizedWalletName: 'dynamicwaas'
 };
 
 export { DYNAMIC_WAAS_METADATA as D, DEFAULT_WAAS_BASE_MPC_RELAY_API_URL as a, DEFAULT_WAAS_BASE_API_URL as b };

package/core.cjs.js

@@ -262,6 +262,7 @@ exports.getVerifiedCredentialForWalletAccount = getNetworkProviderFromNetworkId.
 exports.hasExtension = getNetworkProviderFromNetworkId.hasExtension;
 exports.setCaptchaToken = getNetworkProviderFromNetworkId.setCaptchaToken;
 exports.subscribeWithSelector = getNetworkProviderFromNetworkId.subscribeWithSelector;
+exports.InvalidWalletProviderKeyError = getWalletProviderByKey.InvalidWalletProviderKeyError;
 exports.NoWalletProviderFoundError = getWalletProviderByKey.NoWalletProviderFoundError;
 Object.defineProperty(exports, "WalletProviderPriority", {
   enumerable: true,
@@ -269,10 +270,13 @@ Object.defineProperty(exports, "WalletProviderPriority", {
 });
 exports.createRuntimeServiceAccessKey = getWalletProviderByKey.createRuntimeServiceAccessKey;
 exports.emitEvent = getWalletProviderByKey.emitEvent;
+exports.formatWalletAccountId = getWalletProviderByKey.formatWalletAccountId;
 exports.formatWalletProviderKey = getWalletProviderByKey.formatWalletProviderKey;
 exports.getWalletProviderFromWalletAccount = getWalletProviderByKey.getWalletProviderFromWalletAccount;
 exports.getWalletProviderRegistry = getWalletProviderByKey.getWalletProviderRegistry;
 exports.getWalletProviders = getWalletProviderByKey.getWalletProviders;
+exports.normalizeWalletNameWithChain = getWalletProviderByKey.normalizeWalletNameWithChain;
+exports.splitWalletProviderKey = getWalletProviderByKey.splitWalletProviderKey;
 exports.updateAuthFromVerifyResponse = getWalletProviderByKey.updateAuthFromVerifyResponse;
 exports.consumeMfaTokenIfRequiredForAction = getSignedSessionId.consumeMfaTokenIfRequiredForAction;
 exports.getSignedSessionId = getSignedSessionId.getSignedSessionId;

package/core.esm.js

@@ -3,8 +3,8 @@ import { B as BaseError, a as getCore, e as assertDefined, b as getBuffer, n as
 export { A as APIError, j as ClientNotFoundError, D as DYNAMIC_SDK_API_VERSION, V as ValueMustBeDefinedError, c as createApiClient, k as getChainFromVerifiedCredentialChain, g as getDefaultClient, i as isCookieEnabled } from './getChainFromVerifiedCredentialChain.esm.js';
 import { F as FETCH_PROJECT_SETTINGS_TRACKER_KEY, c as createStorageKeySchema, n as getNetworkProviders, N as NoNetworkProvidersError } from './getNetworkProviderFromNetworkId.esm.js';
 export { C as CannotTrackError, o as InvalidStorageSet, e as consumeCaptchaToken, d as createLocalStorageAdapter, a as createLogger, b as createStorage, f as formatSignInMessage, p as getNetworkProviderBuilderRegistry, j as getNetworkProviderFromNetworkId, g as getVerifiedCredentialForWalletAccount, m as hasExtension, l as setCaptchaToken, s as subscribeWithSelector } from './getNetworkProviderFromNetworkId.esm.js';
-import { b as getWalletProviderByKey, j as createRuntimeServiceAccessKey } from './getWalletProviderByKey.esm.js';
-export { N as NoWalletProviderFoundError, W as WalletProviderPriority, e as emitEvent, k as formatWalletProviderKey, a as getWalletProviderFromWalletAccount, l as getWalletProviderRegistry, f as getWalletProviders, u as updateAuthFromVerifyResponse } from './getWalletProviderByKey.esm.js';
+import { b as getWalletProviderByKey, k as createRuntimeServiceAccessKey } from './getWalletProviderByKey.esm.js';
+export { I as InvalidWalletProviderKeyError, N as NoWalletProviderFoundError, W as WalletProviderPriority, e as emitEvent, f as formatWalletAccountId, l as formatWalletProviderKey, a as getWalletProviderFromWalletAccount, p as getWalletProviderRegistry, h as getWalletProviders, n as normalizeWalletNameWithChain, m as splitWalletProviderKey, u as updateAuthFromVerifyResponse } from './getWalletProviderByKey.esm.js';
 export { c as consumeMfaTokenIfRequiredForAction, g as getSignedSessionId } from './getSignedSessionId.esm.js';
 import * as z from 'zod/mini';
 import EventEmitter from 'eventemitter3';

package/getChainFromVerifiedCredentialChain.cjs.js

@@ -4,9 +4,9 @@ var sdkApiCore = require('@dynamic-labs/sdk-api-core');
 var buffer = require('buffer');
 
 var name = "@dynamic-labs-sdk/client";
-var version = "0.1.0-alpha.15";
+var version = "0.1.0-alpha.17";
 var dependencies = {
-    "@dynamic-labs/sdk-api-core": "0.0.788"};
+    "@dynamic-labs/sdk-api-core": "0.0.791"};
 
 const getCore = (client)=>{
     // @ts-expect-error - this was hidden from the public API

package/getChainFromVerifiedCredentialChain.esm.js

@@ -2,9 +2,9 @@ import { AuthStorageEnum, SDKApi, Configuration } from '@dynamic-labs/sdk-api-co
 import { Buffer as Buffer$1 } from 'buffer';
 
 var name = "@dynamic-labs-sdk/client";
-var version = "0.1.0-alpha.15";
+var version = "0.1.0-alpha.17";
 var dependencies = {
-    "@dynamic-labs/sdk-api-core": "0.0.788"};
+    "@dynamic-labs/sdk-api-core": "0.0.791"};
 
 const getCore = (client)=>{
     // @ts-expect-error - this was hidden from the public API

package/getNetworkProviderFromNetworkId.esm.js

@@ -1,6 +1,6 @@
 import { B as BaseError, g as getDefaultClient, e as assertDefined, a as getCore, f as CHAINS_INFO_MAP } from './getChainFromVerifiedCredentialChain.esm.js';
 import { EventEmitter } from 'eventemitter3';
-import { j as createRuntimeServiceAccessKey } from './getWalletProviderByKey.esm.js';
+import { k as createRuntimeServiceAccessKey } from './getWalletProviderByKey.esm.js';
 
 /**
  * Shallow compare two objects.

package/getWalletProviderByKey.cjs.js

@@ -71,6 +71,30 @@ var sdkApiCore = require('@dynamic-labs/sdk-api-core');
     eventEmitter.emit(event, args);
 };
 
+class InvalidWalletProviderKeyError extends getChainFromVerifiedCredentialChain.BaseError {
+    constructor(value){
+        super({
+            cause: null,
+            code: 'invalid_wallet_provider_key',
+            docsUrl: null,
+            name: 'InvalidWalletProviderKeyError',
+            shortMessage: `Invalid wallet provider key: ${value}. Key must be in the format of <normalizedWalletNameWithChain>:<walletProviderType>[:<suffix>]`
+        });
+    }
+}
+
+const splitWalletProviderKey = (walletProviderKey)=>{
+    const [normalizedWalletNameWithChain, walletProviderType, suffix, ...rest] = walletProviderKey.split(':');
+    if (!normalizedWalletNameWithChain || !Object.values(sdkApiCore.WalletProviderEnum).includes(walletProviderType) || rest.length > 0) {
+        throw new InvalidWalletProviderKeyError(walletProviderKey);
+    }
+    return {
+        normalizedWalletNameWithChain,
+        suffix,
+        walletProviderType: walletProviderType
+    };
+};
+
 const normalizeAddress = (address, chain)=>{
     let normalizedAddress = address;
     if (normalizedAddress == null ? void 0 : normalizedAddress.startsWith('0x')) {
@@ -88,12 +112,16 @@ const normalizeAddress = (address, chain)=>{
     return normalizedAddress;
 };
 
-const createWalletAccountId = ({ address, chain, walletProviderKey })=>`${walletProviderKey}-${normalizeAddress(address, chain)}`;
+const formatWalletAccountId = ({ address, chain, walletProviderKey })=>{
+    const { normalizedWalletNameWithChain } = splitWalletProviderKey(walletProviderKey);
+    const normalizedAddress = normalizeAddress(address, chain);
+    return `${normalizedWalletNameWithChain}:${normalizedAddress}`;
+};
 
-const convertUnverifiedWalletAccountToWalletAccount = (unverifiedWalletAccount)=>({
+const convertUnverifiedWalletAccountToWalletAccount = ({ unverifiedWalletAccount })=>({
         address: unverifiedWalletAccount.address,
         chain: unverifiedWalletAccount.chain,
-        id: createWalletAccountId({
+        id: formatWalletAccountId({
             address: unverifiedWalletAccount.address,
             chain: unverifiedWalletAccount.chain,
             walletProviderKey: unverifiedWalletAccount.walletProviderKey
@@ -104,52 +132,112 @@ const convertUnverifiedWalletAccountToWalletAccount = (unverifiedWalletAccount)=
     });
 
 /**
- * Format the wallet name and chain to get a wallet provider key.
- */ const formatWalletProviderKey = (walletName, chain)=>{
-    const sanitizedWalletName = walletName.replace(/[^a-zA-Z0-9]/g, '').toLowerCase();
-    return `${sanitizedWalletName}${chain.toLocaleLowerCase()}`;
+ * Format the raw wallet name and chain to get the value we can use for
+ * verified credentials' `walletName` field.
+ */ const normalizeWalletNameWithChain = ({ displayName, chain })=>{
+    const sanitizedWalletName = displayName.replace(/[^a-zA-Z0-9]/g, '').toLowerCase();
+    const chainLowered = chain.toLocaleLowerCase();
+    if (sanitizedWalletName.endsWith(chainLowered)) {
+        return sanitizedWalletName;
+    }
+    return `${sanitizedWalletName}${chainLowered}`;
 };
 
-const convertVerifiedCredentialToWalletAccount = (verified)=>{
-    getChainFromVerifiedCredentialChain.assertDefined(verified.address, 'Missing address in verified credential');
-    getChainFromVerifiedCredentialChain.assertDefined(verified.chain, 'Missing chain in verified credential');
-    getChainFromVerifiedCredentialChain.assertDefined(verified.walletName, 'Missing wallet name in verified credential');
-    const chain = getChainFromVerifiedCredentialChain.getChainFromVerifiedCredentialChain(verified.chain);
-    const hasChainInWalletName = verified.walletName.endsWith(chain.toLowerCase());
-    // we need to make sure the walletProviderKey follows the correct format ([walletName][chain])
-    // some walletNames will follow the legacy format (e.g. "phantom" instead of "phantomsol", "metamask" instead of "metamaskevm")
-    // so we need to make sure we parse it correctly
-    const walletProviderKey = hasChainInWalletName ? verified.walletName : formatWalletProviderKey(verified.walletName, chain);
-    var _verified_lastSelectedAt;
+/**
+ * Assembles the wallet provider key from the wallet name, chain, and wallet provider type.
+ *
+ * The suffix is optional and can be used to add a uniquely identifying string to the key, which
+ * might be necessary for some wallet providers (like Wallet Connect).
+ *
+ * IMPORTANT: Do NOT add a suffix unless absolutely necessary, as it will cause the wallet account
+ * to not be able to find its wallet provider when connecting to a new device (it won't be possible
+ * to determine the full key just from the Verified Credential data).
+ */ const formatWalletProviderKey = ({ suffix, chain, displayName, walletProviderType })=>{
+    const normalizedNameWithChain = normalizeWalletNameWithChain({
+        chain,
+        displayName
+    });
+    return `${normalizedNameWithChain}:${walletProviderType}${suffix ? `:${suffix}` : ''}`;
+};
+
+const getWalletProviderKeyFromVerifiedCredential = ({ verifiedCredential }, client)=>{
+    const core = getChainFromVerifiedCredentialChain.getCore(client);
+    const { walletProviderKeyMap } = core.state.get();
+    const storedWalletProviderKey = walletProviderKeyMap[verifiedCredential.id];
+    if (storedWalletProviderKey) {
+        return {
+            walletProviderKey: storedWalletProviderKey
+        };
+    }
+    /**
+   * We fallback to comprising the wallet provider key from walletName and walletProvider.
+   *
+   * Some wallet provider types (like Wallet Connect) also use a special suffix for their wallet provider
+   * keys, so this won't be enough for them.
+   * Therefore, for those specific wallet providers, the wallet account will remain without a wallet provider
+   * and will require reconnection.
+   * Read walletProvider.types.ts for more info.
+   */ getChainFromVerifiedCredentialChain.assertDefined(verifiedCredential.walletName, `Failed to get wallet provider for verified credential with ID ${verifiedCredential.id}: missing walletName`);
+    getChainFromVerifiedCredentialChain.assertDefined(verifiedCredential.walletProvider, `Failed to get wallet provider for verified credential with ID ${verifiedCredential.id}: missing walletProvider`);
+    getChainFromVerifiedCredentialChain.assertDefined(verifiedCredential.chain, `Failed to get wallet provider for verified credential with ID ${verifiedCredential.id}: missing chain`);
+    /**
+   * Historically, walletNames did not include the chain name as a suffix.
+   * This piece of logic simply ensures we normalize any legacy walletNames to conform.
+   */ const chain = getChainFromVerifiedCredentialChain.getChainFromVerifiedCredentialChain(verifiedCredential.chain);
+    const walletProviderKey = formatWalletProviderKey({
+        chain,
+        displayName: verifiedCredential.walletName,
+        walletProviderType: verifiedCredential.walletProvider
+    });
     return {
-        address: verified.address,
+        walletProviderKey
+    };
+};
+
+const convertVerifiedCredentialToWalletAccount = ({ verifiedCredential }, client)=>{
+    getChainFromVerifiedCredentialChain.assertDefined(verifiedCredential.address, 'Missing address in verified credential');
+    getChainFromVerifiedCredentialChain.assertDefined(verifiedCredential.chain, 'Missing chain in verified credential');
+    const chain = getChainFromVerifiedCredentialChain.getChainFromVerifiedCredentialChain(verifiedCredential.chain);
+    const { walletProviderKey } = getWalletProviderKeyFromVerifiedCredential({
+        verifiedCredential
+    }, client);
+    const walletAccountId = formatWalletAccountId({
+        address: verifiedCredential.address,
         chain,
-        id: createWalletAccountId({
-            address: verified.address,
-            chain,
-            walletProviderKey
-        }),
-        lastSelectedAt: (_verified_lastSelectedAt = verified.lastSelectedAt) != null ? _verified_lastSelectedAt : null,
-        verifiedCredentialId: verified.id,
+        walletProviderKey
+    });
+    var _verifiedCredential_lastSelectedAt;
+    return {
+        address: verifiedCredential.address,
+        chain,
+        id: walletAccountId,
+        lastSelectedAt: (_verifiedCredential_lastSelectedAt = verifiedCredential.lastSelectedAt) != null ? _verifiedCredential_lastSelectedAt : null,
+        verifiedCredentialId: verifiedCredential.id,
         walletProviderKey
     };
 };
 
-const getWalletAccountsFromState = (state)=>{
-    const { unverifiedWalletAccounts, user } = state;
+const getWalletAccountsFromState = ({ unverifiedWalletAccounts, user }, client)=>{
     const walletAccountsMap = new Map();
     /**
    * Handle the unverified wallet accounts before the user verified credentials
    * so the later verified wallet accounts can override the unverified wallet accounts
    */ unverifiedWalletAccounts.forEach((unverifiedWalletAccount)=>{
-        const walletAccount = convertUnverifiedWalletAccountToWalletAccount(unverifiedWalletAccount);
+        const walletAccount = convertUnverifiedWalletAccountToWalletAccount({
+            unverifiedWalletAccount
+        });
         walletAccountsMap.set(walletAccount.id, walletAccount);
     });
     var _user_verifiedCredentials;
     /**
    * Handle user verified credentials
    */ const verifiedCredentials = (_user_verifiedCredentials = user == null ? void 0 : user.verifiedCredentials) != null ? _user_verifiedCredentials : [];
-    verifiedCredentials.filter((verified)=>verified.format === sdkApiCore.JwtVerifiedCredentialFormatEnum.Blockchain).map((verifiedWalletAccount)=>convertVerifiedCredentialToWalletAccount(verifiedWalletAccount)).forEach((verifiedWalletAccount)=>walletAccountsMap.set(verifiedWalletAccount.id, verifiedWalletAccount));
+    verifiedCredentials.filter((verified)=>verified.format === sdkApiCore.JwtVerifiedCredentialFormatEnum.Blockchain).forEach((verifiedWalletAccount)=>{
+        const walletAccount = convertVerifiedCredentialToWalletAccount({
+            verifiedCredential: verifiedWalletAccount
+        }, client);
+        walletAccountsMap.set(walletAccount.id, walletAccount);
+    });
     return Array.from(walletAccountsMap.values());
 };
 
@@ -163,7 +251,14 @@ const getWalletAccountsFromState = (state)=>{
  *
  * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
  * @returns An array of wallet accounts associated with the session.
- */ const getWalletAccounts = (client = getChainFromVerifiedCredentialChain.getDefaultClient())=>getWalletAccountsFromState(getChainFromVerifiedCredentialChain.getCore(client).state.get());
+ */ const getWalletAccounts = (client = getChainFromVerifiedCredentialChain.getDefaultClient())=>{
+    const core = getChainFromVerifiedCredentialChain.getCore(client);
+    const { unverifiedWalletAccounts, user } = core.state.get();
+    return getWalletAccountsFromState({
+        unverifiedWalletAccounts,
+        user
+    }, client);
+};
 
 class NoWalletProviderFoundError extends getChainFromVerifiedCredentialChain.BaseError {
     constructor({ walletProviderKey }){
@@ -332,13 +427,13 @@ const DYNAMIC_AUTH_COOKIE_NAME = 'DYNAMIC_JWT_TOKEN';
 
 const checkAndRaiseWalletAccountsChangedEvent = ({ previousState }, client)=>{
     const core = getChainFromVerifiedCredentialChain.getCore(client);
-    const walletAccountsHashBefore = getWalletAccountsHash(previousState);
-    const walletAccountsHashAfter = getWalletAccountsHash(core.state.get());
+    const walletAccountsHashBefore = getWalletAccountsHash(previousState, client);
+    const walletAccountsHashAfter = getWalletAccountsHash(core.state.get(), client);
     if (walletAccountsHashBefore !== walletAccountsHashAfter) {
         emitWalletAccountsChangedEvent(client);
     }
 };
-const getWalletAccountsHash = (state)=>getWalletAccountsFromState(state).map(({ id })=>id).sort().join('-');
+const getWalletAccountsHash = (state, client)=>getWalletAccountsFromState(state, client).map(({ id })=>id).sort().join('-');
 
 const updateAuthFromVerifyResponse = ({ response }, client)=>{
     const core = getChainFromVerifiedCredentialChain.getCore(client);
@@ -385,11 +480,12 @@ const getWalletProviderByKey = ({ walletProviderKey }, client)=>{
 };
 
 exports.DYNAMIC_AUTH_COOKIE_NAME = DYNAMIC_AUTH_COOKIE_NAME;
+exports.InvalidWalletProviderKeyError = InvalidWalletProviderKeyError;
 exports.NoWalletProviderFoundError = NoWalletProviderFoundError;
 exports.createRuntimeServiceAccessKey = createRuntimeServiceAccessKey;
-exports.createWalletAccountId = createWalletAccountId;
 exports.emitEvent = emitEvent;
 exports.emitWalletAccountsChangedEvent = emitWalletAccountsChangedEvent;
+exports.formatWalletAccountId = formatWalletAccountId;
 exports.formatWalletProviderKey = formatWalletProviderKey;
 exports.getWalletAccounts = getWalletAccounts;
 exports.getWalletProviderByKey = getWalletProviderByKey;
@@ -397,8 +493,10 @@ exports.getWalletProviderFromWalletAccount = getWalletProviderFromWalletAccount;
 exports.getWalletProviderRegistry = getWalletProviderRegistry;
 exports.getWalletProviders = getWalletProviders;
 exports.normalizeAddress = normalizeAddress;
+exports.normalizeWalletNameWithChain = normalizeWalletNameWithChain;
 exports.offEvent = offEvent;
 exports.onEvent = onEvent;
 exports.onceEvent = onceEvent;
 exports.setCookie = setCookie;
+exports.splitWalletProviderKey = splitWalletProviderKey;
 exports.updateAuthFromVerifyResponse = updateAuthFromVerifyResponse;