@dynamic-labs-sdk/metamask 1.27.0 → 1.27.2

package/dist/clearMetaMaskSessionStorage/clearMetaMaskSessionStorage.d.ts

@@ -1,3 +1,4 @@
+import type { DynamicClient } from '@dynamic-labs-sdk/client';
 /**
  * Deletes the MetaMask SDK's IndexedDB session storage so the next connect call
  * emits a fresh `display_uri` synchronously instead of spending the SDK's
@@ -6,14 +7,17 @@
  *
  * @example
  * ```ts
- * await clearMetaMaskSessionStorage();
+ * await clearMetaMaskSessionStorage(client);
  * // Next connectWithMetaMaskUri call will emit a fresh URI immediately.
  * ```
  *
+ * @param client - The Dynamic client instance. Required (rather than
+ * defaulting to the last-initialized client) so a storage-clear failure is
+ * always logged against the client that actually requested it.
  * @returns A promise that resolves once the database is deleted (or immediately in SSR).
  * @see connectWithMetaMaskUri
  * @see getMetaMaskExtensionWalletProviderKey
  * @notInstrumented
  */
-export declare const clearMetaMaskSessionStorage: () => Promise<void>;
+export declare const clearMetaMaskSessionStorage: (client: DynamicClient) => Promise<void>;
 //# sourceMappingURL=clearMetaMaskSessionStorage.d.ts.map

package/dist/clearMetaMaskSessionStorage/clearMetaMaskSessionStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clearMetaMaskSessionStorage.d.ts","sourceRoot":"","sources":["../../src/clearMetaMaskSessionStorage/clearMetaMaskSessionStorage.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,2BAA2B,QAAO,OAAO,CAAC,IAAI,CAsB1D,CAAC"}
+{"version":3,"file":"clearMetaMaskSessionStorage.d.ts","sourceRoot":"","sources":["../../src/clearMetaMaskSessionStorage/clearMetaMaskSessionStorage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAY9D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,2BAA2B,WAG9B,aAAa,KACpB,OAAO,CAAC,IAAI,CA2Bd,CAAC"}

package/dist/index.cjs

@@ -1,15 +1,16 @@
 let _dynamic_labs_sdk_assert_package_version = require("@dynamic-labs-sdk/assert-package-version");
-let _dynamic_labs_sdk_client = require("@dynamic-labs-sdk/client");
 let _dynamic_labs_sdk_client_core = require("@dynamic-labs-sdk/client/core");
+let _dynamic_labs_sdk_client = require("@dynamic-labs-sdk/client");
 let _dynamic_labs_sdk_api_core = require("@dynamic-labs/sdk-api-core");
 
 //#region package.json
 var name = "@dynamic-labs-sdk/metamask";
-var version = "1.27.0";
+var version = "1.27.2";
 
 //#endregion
 //#region src/clearMetaMaskSessionStorage/clearMetaMaskSessionStorage.ts
 const METAMASK_SDK_IDB_NAME = "mmconnect-kv-store";
+const FAILED_TO_CLEAR_SESSION_MESSAGE = "[metamask] failed to clear the persisted session from IndexedDB; the next pairing may resume a stale session instead of showing a new one";
 /**
 * Deletes the MetaMask SDK's IndexedDB session storage so the next connect call
 * emits a fresh `display_uri` synchronously instead of spending the SDK's
@@ -18,24 +19,31 @@ const METAMASK_SDK_IDB_NAME = "mmconnect-kv-store";
 *
 * @example
 * ```ts
-* await clearMetaMaskSessionStorage();
+* await clearMetaMaskSessionStorage(client);
 * // Next connectWithMetaMaskUri call will emit a fresh URI immediately.
 * ```
 *
+* @param client - The Dynamic client instance. Required (rather than
+* defaulting to the last-initialized client) so a storage-clear failure is
+* always logged against the client that actually requested it.
 * @returns A promise that resolves once the database is deleted (or immediately in SSR).
 * @see connectWithMetaMaskUri
 * @see getMetaMaskExtensionWalletProviderKey
 * @notInstrumented
 */
-const clearMetaMaskSessionStorage = () => {
+const clearMetaMaskSessionStorage = (client) => {
 	if (typeof indexedDB === "undefined") return Promise.resolve();
 	return new Promise((resolve) => {
 		try {
 			const request = indexedDB.deleteDatabase(METAMASK_SDK_IDB_NAME);
 			request.onsuccess = () => resolve();
-			request.onerror = () => resolve();
+			request.onerror = () => {
+				(0, _dynamic_labs_sdk_client_core.getCore)(client).logger.warn(FAILED_TO_CLEAR_SESSION_MESSAGE, request.error);
+				resolve();
+			};
 			request.onblocked = () => resolve();
-		} catch {
+		} catch (error) {
+			(0, _dynamic_labs_sdk_client_core.getCore)(client).logger.warn(FAILED_TO_CLEAR_SESSION_MESSAGE, error);
 			resolve();
 		}
 	});

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["BaseError","WalletProviderEnum","uri: string","WalletProviderPriority","NoAddressFoundError","BaseError"],"sources":["../package.json","../src/clearMetaMaskSessionStorage/clearMetaMaskSessionStorage.ts","../src/errors/MetaMaskDisplayUriMissingError/MetaMaskDisplayUriMissingError.ts","../src/getMetaMaskExtensionWalletProviderKey/getMetaMaskExtensionWalletProviderKey.ts","../src/connectWithMetaMaskUri/connectWithMetaMaskUri.ts","../src/errors/MetaMaskWalletNotConnectedError/MetaMaskWalletNotConnectedError.ts","../src/exports/index.ts"],"sourcesContent":["","// MetaMask SDK persists session state in this IndexedDB database.\n// Hardcoded inside `@metamask/connect-multichain` (the SDK shared by\n// every chain-specific connect-* facade) as `${DB_NAME}${dbNameSuffix}`\n// → `mmconnect` + `-kv-store` on web.\nconst METAMASK_SDK_IDB_NAME = 'mmconnect-kv-store';\n\n/**\n * Deletes the MetaMask SDK's IndexedDB session storage so the next connect call\n * emits a fresh `display_uri` synchronously instead of spending the SDK's\n * 10-second resume timeout reviving a dead pairing. Safe in SSR (no-op) and\n * when the DB is held open by another tab (resolves on `blocked`).\n *\n * @example\n * ```ts\n * await clearMetaMaskSessionStorage();\n * // Next connectWithMetaMaskUri call will emit a fresh URI immediately.\n * ```\n *\n * @returns A promise that resolves once the database is deleted (or immediately in SSR).\n * @see connectWithMetaMaskUri\n * @see getMetaMaskExtensionWalletProviderKey\n * @notInstrumented\n */\nexport const clearMetaMaskSessionStorage = (): Promise<void> => {\n  if (typeof indexedDB === 'undefined') {\n    return Promise.resolve();\n  }\n\n  return new Promise<void>((resolve) => {\n    try {\n      const request = indexedDB.deleteDatabase(METAMASK_SDK_IDB_NAME);\n      request.onsuccess = () => resolve();\n      // `onerror` / `onblocked` fire when a concurrent tab holds the\n      // DB open. We still resolve so the consumer's connect flow is\n      // not stalled indefinitely; the next tab close drops the lock\n      // and subsequent runs reach the empty database. The Promise\n      // executor already ignores subsequent resolve calls, so no\n      // extra guard is needed when multiple lifecycle events fire on\n      // the same request.\n      request.onerror = () => resolve();\n      request.onblocked = () => resolve();\n    } catch {\n      resolve();\n    }\n  });\n};\n","import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class MetaMaskDisplayUriMissingError extends BaseError {\n  constructor() {\n    super({\n      cause: null,\n      code: 'metamask_display_uri_missing',\n      docsUrl: null,\n      name: 'MetaMaskDisplayUriMissingError',\n      shortMessage:\n        'MetaMask SDK completed the connection without emitting a display_uri. The connect helper requires the SDK to produce a pairing URI. Please reach out to Dynamic about this error.',\n    });\n  }\n}\n","import type { Chain, DynamicClient } from '@dynamic-labs-sdk/client';\nimport {\n  getDefaultClient,\n  getWalletProviderRegistry,\n} from '@dynamic-labs-sdk/client/core';\nimport { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';\n\nconst METAMASK_NAME_NEEDLE = 'metamask';\n\ntype GetMetaMaskExtensionWalletProviderKeyParams = {\n  /** Chain to scope the lookup to. */\n  chain: Chain;\n};\n\n/**\n * Returns the wallet provider key of the MetaMask browser extension announced\n * for the given chain (EIP-6963 on EVM, Wallet Standard on Solana), or\n * `undefined` when none is announced. Matches on normalized display name to\n * cover MetaMask, Flask, and other variants. Synchronous and safe to call from\n * a React render. Pass the returned key to `connectWithWalletProvider` to route\n * the connection through the announced provider; fall back to the chain's\n * `connectWithMetaMaskUri<Chain>` helper when `undefined`.\n *\n * @example\n * ```ts\n * const key = getMetaMaskExtensionWalletProviderKey({ chain: 'EVM' });\n * if (key) {\n *   await connectWithWalletProvider({ walletProviderKey: key });\n * }\n * ```\n *\n * @param params.chain - Chain to scope the lookup to.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns The wallet provider key string, or `undefined` if no MetaMask extension is announced.\n * @see connectWithMetaMaskUri\n * @see clearMetaMaskSessionStorage\n * @notInstrumented\n */\nexport const getMetaMaskExtensionWalletProviderKey = (\n  { chain }: GetMetaMaskExtensionWalletProviderKeyParams,\n  client: DynamicClient = getDefaultClient()\n): string | undefined => {\n  const providers = getWalletProviderRegistry(client).listProviders();\n\n  const match = providers.find(\n    (provider) =>\n      provider.chain === chain &&\n      provider.walletProviderType === WalletProviderEnum.BrowserExtension &&\n      provider.metadata.displayName\n        ?.toLowerCase()\n        .includes(METAMASK_NAME_NEEDLE)\n  );\n\n  return match?.key;\n};\n","import type {\n  Chain,\n  DynamicClient,\n  WalletAccount,\n  WalletProviderUriConnectionResult,\n} from '@dynamic-labs-sdk/client';\nimport { NoAddressFoundError } from '@dynamic-labs-sdk/client';\nimport type { WalletProvider } from '@dynamic-labs-sdk/client/core';\nimport {\n  WalletProviderPriority,\n  createDeferredPromise,\n  formatWalletAccountId,\n  getCore,\n  getDefaultClient,\n  getWalletProviderRegistry,\n  reconcileWalletAccountsAgainstClient,\n} from '@dynamic-labs-sdk/client/core';\n\nimport { MetaMaskDisplayUriMissingError } from '../errors/MetaMaskDisplayUriMissingError';\nimport { getMetaMaskExtensionWalletProviderKey } from '../getMetaMaskExtensionWalletProviderKey';\nimport type { MetaMaskController } from '../metamask.types';\n\nexport type ConnectWithMetaMaskUriParams = {\n  /** Whether to add the connected wallet account to the Dynamic client. Defaults to `true`. */\n  addToDynamicWalletAccounts?: boolean;\n  /** Chain being connected; used to scope the extension-installed lookup. */\n  chain: Chain;\n  /** Returns the chain-specific `MetaMaskController` that drives the pairing. */\n  getController: (client: DynamicClient) => Promise<MetaMaskController>;\n  /**\n   * Builds the chain-specific `WalletProvider` AFTER the pairing has been\n   * approved. Must NOT include a `connect` method — the provider is registered\n   * purely for signing routing and would otherwise leak into the wallet picker.\n   */\n  walletProviderBuilder: (client: DynamicClient) => Promise<WalletProvider>;\n};\n\n/**\n * Drives a MetaMask SDK pairing for any chain and returns `{ approval, uri }`\n * so consumers can render the QR / hand the URI to a deeplink. Logs an\n * advisory warning when the extension is already announced for the chain —\n * pairing still proceeds, but the consumer is told which announced provider\n * key to route through for the best UX. Builds and registers the chain-\n * specific wallet provider only after pairing is approved; the provider\n * therefore never appears in the wallet picker (no `connect` method).\n *\n * @example\n * ```ts\n * const { uri, approval } = await connectWithMetaMaskUri({\n *   chain: 'EVM',\n *   getController: (client) => getEvmMetaMaskController(client),\n *   walletProviderBuilder: (client) => buildEvmWalletProvider(client),\n * });\n * // Render QR code with `uri`, then await approval()\n * ```\n *\n * @param params.chain - Chain being connected; used to scope the extension-installed lookup.\n * @param params.getController - Returns the chain-specific MetaMaskController for the pairing.\n * @param params.walletProviderBuilder - Builds the chain-specific WalletProvider after pairing approval.\n * @param [params.addToDynamicWalletAccounts] - Whether to add the wallet to the client. Defaults to `true`.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns An object with `uri` (the pairing URI) and `approval` (async function resolving to wallet accounts).\n * @throws {MetaMaskDisplayUriMissingError} If `connect` settles before a display_uri is emitted.\n * @throws {NoAddressFoundError} If no address is returned after pairing approval.\n * @see clearMetaMaskSessionStorage\n * @see getMetaMaskExtensionWalletProviderKey\n * @notInstrumented\n */\nexport const connectWithMetaMaskUri = async (\n  {\n    addToDynamicWalletAccounts = true,\n    chain,\n    getController,\n    walletProviderBuilder,\n  }: ConnectWithMetaMaskUriParams,\n  client: DynamicClient = getDefaultClient()\n): Promise<WalletProviderUriConnectionResult> => {\n  const announcedKey = getMetaMaskExtensionWalletProviderKey({ chain }, client);\n\n  if (announcedKey !== undefined) {\n    getCore(client).logger.warn(\n      `[metamask] MetaMask extension is announced for ${chain} as wallet provider \"${announcedKey}\"; proceeding with URI pairing. Consider connectWithWalletProvider({ walletProviderKey: \"${announcedKey}\" }) for the best user experience.`\n    );\n  }\n\n  const controller = await getController(client);\n\n  const uriDeferred = createDeferredPromise<string>();\n\n  const unsubscribe = controller.onDisplayUri((displayUri) => {\n    uriDeferred.resolve(displayUri);\n  });\n\n  const connectPromise = controller.connect();\n\n  // If `connect` settles before a `display_uri` is emitted, no URI was made\n  // available and the pairing is unusable. Reject the deferred so the caller\n  // surfaces `MetaMaskDisplayUriMissingError` (or the underlying failure).\n  connectPromise\n    .then(() => {\n      uriDeferred.reject(new MetaMaskDisplayUriMissingError());\n    })\n    .catch((error: unknown) => {\n      uriDeferred.reject(error);\n    });\n\n  let uri: string;\n  try {\n    uri = await uriDeferred.promise;\n  } finally {\n    unsubscribe();\n  }\n\n  const approval = async (): Promise<{ walletAccounts: WalletAccount[] }> => {\n    await connectPromise;\n\n    const walletProvider = await walletProviderBuilder(client);\n\n    getWalletProviderRegistry(client).register({\n      priority: WalletProviderPriority.WALLET_SDK,\n      walletProvider,\n    });\n\n    const { addresses } = await walletProvider.getConnectedAddresses();\n\n    // MetaMask SDK exposes a single active address per pairing (same model as\n    // EIP-1193 `eth_accounts`); we only materialize the first one.\n    const mainAddress = addresses[0];\n\n    if (mainAddress === undefined) {\n      throw new NoAddressFoundError();\n    }\n\n    const walletAccount: WalletAccount = {\n      address: mainAddress,\n      chain: walletProvider.chain,\n      id: formatWalletAccountId({\n        address: mainAddress,\n        chain: walletProvider.chain,\n        walletProviderKey: walletProvider.key,\n      }),\n      lastSelectedAt: null,\n      verifiedCredentialId: null,\n      walletProviderKey: walletProvider.key,\n    };\n\n    const walletAccounts = reconcileWalletAccountsAgainstClient(\n      {\n        addToDynamicWalletAccounts,\n        walletAccounts: [walletAccount],\n        walletProviderKey: walletProvider.key,\n      },\n      client\n    );\n\n    return { walletAccounts };\n  };\n\n  return { approval, uri };\n};\n","import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class MetaMaskWalletNotConnectedError extends BaseError {\n  constructor() {\n    super({\n      cause: null,\n      code: 'metamask_wallet_not_connected',\n      docsUrl: null,\n      name: 'MetaMaskWalletNotConnectedError',\n      shortMessage:\n        'MetaMask SDK has no connected wallet account. Complete the URI pairing (await the connect approval) before building the MetaMask wallet provider.',\n    });\n  }\n}\n","import { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport { name, version } from '../../package.json';\n\nassertPackageVersion(name, version);\n\nexport { clearMetaMaskSessionStorage } from '../clearMetaMaskSessionStorage';\nexport { connectWithMetaMaskUri } from '../connectWithMetaMaskUri';\nexport type { ConnectWithMetaMaskUriParams } from '../connectWithMetaMaskUri';\nexport { MetaMaskDisplayUriMissingError } from '../errors/MetaMaskDisplayUriMissingError';\nexport { MetaMaskWalletNotConnectedError } from '../errors/MetaMaskWalletNotConnectedError';\nexport { getMetaMaskExtensionWalletProviderKey } from '../getMetaMaskExtensionWalletProviderKey';\nexport type {\n  DisplayUriListener,\n  MetaMaskController,\n} from '../metamask.types';\n"],"mappings":";;;;;;;;;;;ACIA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;AAmB9B,MAAa,oCAAmD;AAC9D,KAAI,OAAO,cAAc,YACvB,QAAO,QAAQ,SAAS;AAG1B,QAAO,IAAI,SAAe,YAAY;AACpC,MAAI;GACF,MAAM,UAAU,UAAU,eAAe,sBAAsB;AAC/D,WAAQ,kBAAkB,SAAS;AAQnC,WAAQ,gBAAgB,SAAS;AACjC,WAAQ,kBAAkB,SAAS;UAC7B;AACN,YAAS;;GAEX;;;;;AC1CJ,IAAa,iCAAb,cAAoDA,mCAAU;CAC5D,cAAc;AACZ,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cACE;GACH,CAAC;;;;;;ACJN,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;AA+B7B,MAAa,yCACX,EAAE,SACF,8DAA0C,KACnB;AAYvB,qEAX4C,OAAO,CAAC,eAAe,CAE3C,MACrB,aACC,SAAS,UAAU,SACnB,SAAS,uBAAuBC,8CAAmB,oBACnD,SAAS,SAAS,aACd,aAAa,CACd,SAAS,qBAAqB,CACpC,EAEa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACehB,MAAa,yBAAyB,OACpC,EACE,6BAA6B,MAC7B,OACA,eACA,yBAEF,8DAA0C,KACK;CAC/C,MAAM,eAAe,sCAAsC,EAAE,OAAO,EAAE,OAAO;AAE7E,KAAI,iBAAiB,OACnB,4CAAQ,OAAO,CAAC,OAAO,KACrB,kDAAkD,MAAM,uBAAuB,aAAa,2FAA2F,aAAa,oCACrM;CAGH,MAAM,aAAa,MAAM,cAAc,OAAO;CAE9C,MAAM,wEAA6C;CAEnD,MAAM,cAAc,WAAW,cAAc,eAAe;AAC1D,cAAY,QAAQ,WAAW;GAC/B;CAEF,MAAM,iBAAiB,WAAW,SAAS;AAK3C,gBACG,WAAW;AACV,cAAY,OAAO,IAAI,gCAAgC,CAAC;GACxD,CACD,OAAO,UAAmB;AACzB,cAAY,OAAO,MAAM;GACzB;CAEJ,IAAIC;AACJ,KAAI;AACF,QAAM,MAAM,YAAY;WAChB;AACR,eAAa;;CAGf,MAAM,WAAW,YAA0D;AACzE,QAAM;EAEN,MAAM,iBAAiB,MAAM,sBAAsB,OAAO;AAE1D,+DAA0B,OAAO,CAAC,SAAS;GACzC,UAAUC,qDAAuB;GACjC;GACD,CAAC;EAEF,MAAM,EAAE,cAAc,MAAM,eAAe,uBAAuB;EAIlE,MAAM,cAAc,UAAU;AAE9B,MAAI,gBAAgB,OAClB,OAAM,IAAIC,8CAAqB;AAyBjC,SAAO,EAAE,wFARP;GACE;GACA,gBAAgB,CAhBiB;IACnC,SAAS;IACT,OAAO,eAAe;IACtB,6DAA0B;KACxB,SAAS;KACT,OAAO,eAAe;KACtB,mBAAmB,eAAe;KACnC,CAAC;IACF,gBAAgB;IAChB,sBAAsB;IACtB,mBAAmB,eAAe;IACnC,CAKkC;GAC/B,mBAAmB,eAAe;GACnC,EACD,OACD,EAEwB;;AAG3B,QAAO;EAAE;EAAU;EAAK;;;;;AC5J1B,IAAa,kCAAb,cAAqDC,mCAAU;CAC7D,cAAc;AACZ,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cACE;GACH,CAAC;;;;;;mECPe,MAAM,QAAQ"}
+{"version":3,"file":"index.cjs","names":["BaseError","WalletProviderEnum","uri: string","WalletProviderPriority","NoAddressFoundError","BaseError"],"sources":["../package.json","../src/clearMetaMaskSessionStorage/clearMetaMaskSessionStorage.ts","../src/errors/MetaMaskDisplayUriMissingError/MetaMaskDisplayUriMissingError.ts","../src/getMetaMaskExtensionWalletProviderKey/getMetaMaskExtensionWalletProviderKey.ts","../src/connectWithMetaMaskUri/connectWithMetaMaskUri.ts","../src/errors/MetaMaskWalletNotConnectedError/MetaMaskWalletNotConnectedError.ts","../src/exports/index.ts"],"sourcesContent":["","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { getCore } from '@dynamic-labs-sdk/client/core';\n\n// MetaMask SDK persists session state in this IndexedDB database.\n// Hardcoded inside `@metamask/connect-multichain` (the SDK shared by\n// every chain-specific connect-* facade) as `${DB_NAME}${dbNameSuffix}`\n// → `mmconnect` + `-kv-store` on web.\nconst METAMASK_SDK_IDB_NAME = 'mmconnect-kv-store';\n\nconst FAILED_TO_CLEAR_SESSION_MESSAGE =\n  '[metamask] failed to clear the persisted session from IndexedDB; the next pairing may resume a stale session instead of showing a new one';\n\n/**\n * Deletes the MetaMask SDK's IndexedDB session storage so the next connect call\n * emits a fresh `display_uri` synchronously instead of spending the SDK's\n * 10-second resume timeout reviving a dead pairing. Safe in SSR (no-op) and\n * when the DB is held open by another tab (resolves on `blocked`).\n *\n * @example\n * ```ts\n * await clearMetaMaskSessionStorage(client);\n * // Next connectWithMetaMaskUri call will emit a fresh URI immediately.\n * ```\n *\n * @param client - The Dynamic client instance. Required (rather than\n * defaulting to the last-initialized client) so a storage-clear failure is\n * always logged against the client that actually requested it.\n * @returns A promise that resolves once the database is deleted (or immediately in SSR).\n * @see connectWithMetaMaskUri\n * @see getMetaMaskExtensionWalletProviderKey\n * @notInstrumented\n */\nexport const clearMetaMaskSessionStorage = (\n  // No default: avoids misattributing the failure-path warning below.\n  // eslint-disable-next-line custom-rules/check-dynamic-client-param-in-external-functions\n  client: DynamicClient\n): Promise<void> => {\n  if (typeof indexedDB === 'undefined') {\n    return Promise.resolve();\n  }\n\n  return new Promise<void>((resolve) => {\n    try {\n      const request = indexedDB.deleteDatabase(METAMASK_SDK_IDB_NAME);\n      request.onsuccess = () => resolve();\n      // `onblocked` fires when a concurrent tab holds the DB open; that is\n      // expected multi-tab behaviour, not a failure, so it resolves quietly.\n      // We still resolve on `onerror` so the consumer's connect flow is not\n      // stalled indefinitely, but it is logged first: a failed delete here\n      // puts the caller back on the stale session it was trying to escape.\n      // The Promise executor already ignores subsequent resolve calls, so no\n      // extra guard is needed when multiple lifecycle events fire on the\n      // same request.\n      request.onerror = () => {\n        getCore(client).logger.warn(FAILED_TO_CLEAR_SESSION_MESSAGE, request.error);\n        resolve();\n      };\n      request.onblocked = () => resolve();\n    } catch (error) {\n      getCore(client).logger.warn(FAILED_TO_CLEAR_SESSION_MESSAGE, error);\n      resolve();\n    }\n  });\n};\n","import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class MetaMaskDisplayUriMissingError extends BaseError {\n  constructor() {\n    super({\n      cause: null,\n      code: 'metamask_display_uri_missing',\n      docsUrl: null,\n      name: 'MetaMaskDisplayUriMissingError',\n      shortMessage:\n        'MetaMask SDK completed the connection without emitting a display_uri. The connect helper requires the SDK to produce a pairing URI. Please reach out to Dynamic about this error.',\n    });\n  }\n}\n","import type { Chain, DynamicClient } from '@dynamic-labs-sdk/client';\nimport {\n  getDefaultClient,\n  getWalletProviderRegistry,\n} from '@dynamic-labs-sdk/client/core';\nimport { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';\n\nconst METAMASK_NAME_NEEDLE = 'metamask';\n\ntype GetMetaMaskExtensionWalletProviderKeyParams = {\n  /** Chain to scope the lookup to. */\n  chain: Chain;\n};\n\n/**\n * Returns the wallet provider key of the MetaMask browser extension announced\n * for the given chain (EIP-6963 on EVM, Wallet Standard on Solana), or\n * `undefined` when none is announced. Matches on normalized display name to\n * cover MetaMask, Flask, and other variants. Synchronous and safe to call from\n * a React render. Pass the returned key to `connectWithWalletProvider` to route\n * the connection through the announced provider; fall back to the chain's\n * `connectWithMetaMaskUri<Chain>` helper when `undefined`.\n *\n * @example\n * ```ts\n * const key = getMetaMaskExtensionWalletProviderKey({ chain: 'EVM' });\n * if (key) {\n *   await connectWithWalletProvider({ walletProviderKey: key });\n * }\n * ```\n *\n * @param params.chain - Chain to scope the lookup to.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns The wallet provider key string, or `undefined` if no MetaMask extension is announced.\n * @see connectWithMetaMaskUri\n * @see clearMetaMaskSessionStorage\n * @notInstrumented\n */\nexport const getMetaMaskExtensionWalletProviderKey = (\n  { chain }: GetMetaMaskExtensionWalletProviderKeyParams,\n  client: DynamicClient = getDefaultClient()\n): string | undefined => {\n  const providers = getWalletProviderRegistry(client).listProviders();\n\n  const match = providers.find(\n    (provider) =>\n      provider.chain === chain &&\n      provider.walletProviderType === WalletProviderEnum.BrowserExtension &&\n      provider.metadata.displayName\n        ?.toLowerCase()\n        .includes(METAMASK_NAME_NEEDLE)\n  );\n\n  return match?.key;\n};\n","import type {\n  Chain,\n  DynamicClient,\n  WalletAccount,\n  WalletProviderUriConnectionResult,\n} from '@dynamic-labs-sdk/client';\nimport { NoAddressFoundError } from '@dynamic-labs-sdk/client';\nimport type { WalletProvider } from '@dynamic-labs-sdk/client/core';\nimport {\n  WalletProviderPriority,\n  createDeferredPromise,\n  formatWalletAccountId,\n  getCore,\n  getDefaultClient,\n  getWalletProviderRegistry,\n  reconcileWalletAccountsAgainstClient,\n} from '@dynamic-labs-sdk/client/core';\n\nimport { MetaMaskDisplayUriMissingError } from '../errors/MetaMaskDisplayUriMissingError';\nimport { getMetaMaskExtensionWalletProviderKey } from '../getMetaMaskExtensionWalletProviderKey';\nimport type { MetaMaskController } from '../metamask.types';\n\nexport type ConnectWithMetaMaskUriParams = {\n  /** Whether to add the connected wallet account to the Dynamic client. Defaults to `true`. */\n  addToDynamicWalletAccounts?: boolean;\n  /** Chain being connected; used to scope the extension-installed lookup. */\n  chain: Chain;\n  /** Returns the chain-specific `MetaMaskController` that drives the pairing. */\n  getController: (client: DynamicClient) => Promise<MetaMaskController>;\n  /**\n   * Builds the chain-specific `WalletProvider` AFTER the pairing has been\n   * approved. Must NOT include a `connect` method — the provider is registered\n   * purely for signing routing and would otherwise leak into the wallet picker.\n   */\n  walletProviderBuilder: (client: DynamicClient) => Promise<WalletProvider>;\n};\n\n/**\n * Drives a MetaMask SDK pairing for any chain and returns `{ approval, uri }`\n * so consumers can render the QR / hand the URI to a deeplink. Logs an\n * advisory warning when the extension is already announced for the chain —\n * pairing still proceeds, but the consumer is told which announced provider\n * key to route through for the best UX. Builds and registers the chain-\n * specific wallet provider only after pairing is approved; the provider\n * therefore never appears in the wallet picker (no `connect` method).\n *\n * @example\n * ```ts\n * const { uri, approval } = await connectWithMetaMaskUri({\n *   chain: 'EVM',\n *   getController: (client) => getEvmMetaMaskController(client),\n *   walletProviderBuilder: (client) => buildEvmWalletProvider(client),\n * });\n * // Render QR code with `uri`, then await approval()\n * ```\n *\n * @param params.chain - Chain being connected; used to scope the extension-installed lookup.\n * @param params.getController - Returns the chain-specific MetaMaskController for the pairing.\n * @param params.walletProviderBuilder - Builds the chain-specific WalletProvider after pairing approval.\n * @param [params.addToDynamicWalletAccounts] - Whether to add the wallet to the client. Defaults to `true`.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns An object with `uri` (the pairing URI) and `approval` (async function resolving to wallet accounts).\n * @throws {MetaMaskDisplayUriMissingError} If `connect` settles before a display_uri is emitted.\n * @throws {NoAddressFoundError} If no address is returned after pairing approval.\n * @see clearMetaMaskSessionStorage\n * @see getMetaMaskExtensionWalletProviderKey\n * @notInstrumented\n */\nexport const connectWithMetaMaskUri = async (\n  {\n    addToDynamicWalletAccounts = true,\n    chain,\n    getController,\n    walletProviderBuilder,\n  }: ConnectWithMetaMaskUriParams,\n  client: DynamicClient = getDefaultClient()\n): Promise<WalletProviderUriConnectionResult> => {\n  const announcedKey = getMetaMaskExtensionWalletProviderKey({ chain }, client);\n\n  if (announcedKey !== undefined) {\n    getCore(client).logger.warn(\n      `[metamask] MetaMask extension is announced for ${chain} as wallet provider \"${announcedKey}\"; proceeding with URI pairing. Consider connectWithWalletProvider({ walletProviderKey: \"${announcedKey}\" }) for the best user experience.`\n    );\n  }\n\n  const controller = await getController(client);\n\n  const uriDeferred = createDeferredPromise<string>();\n\n  const unsubscribe = controller.onDisplayUri((displayUri) => {\n    uriDeferred.resolve(displayUri);\n  });\n\n  const connectPromise = controller.connect();\n\n  // If `connect` settles before a `display_uri` is emitted, no URI was made\n  // available and the pairing is unusable. Reject the deferred so the caller\n  // surfaces `MetaMaskDisplayUriMissingError` (or the underlying failure).\n  connectPromise\n    .then(() => {\n      uriDeferred.reject(new MetaMaskDisplayUriMissingError());\n    })\n    .catch((error: unknown) => {\n      uriDeferred.reject(error);\n    });\n\n  let uri: string;\n  try {\n    uri = await uriDeferred.promise;\n  } finally {\n    unsubscribe();\n  }\n\n  const approval = async (): Promise<{ walletAccounts: WalletAccount[] }> => {\n    await connectPromise;\n\n    const walletProvider = await walletProviderBuilder(client);\n\n    getWalletProviderRegistry(client).register({\n      priority: WalletProviderPriority.WALLET_SDK,\n      walletProvider,\n    });\n\n    const { addresses } = await walletProvider.getConnectedAddresses();\n\n    // MetaMask SDK exposes a single active address per pairing (same model as\n    // EIP-1193 `eth_accounts`); we only materialize the first one.\n    const mainAddress = addresses[0];\n\n    if (mainAddress === undefined) {\n      throw new NoAddressFoundError();\n    }\n\n    const walletAccount: WalletAccount = {\n      address: mainAddress,\n      chain: walletProvider.chain,\n      id: formatWalletAccountId({\n        address: mainAddress,\n        chain: walletProvider.chain,\n        walletProviderKey: walletProvider.key,\n      }),\n      lastSelectedAt: null,\n      verifiedCredentialId: null,\n      walletProviderKey: walletProvider.key,\n    };\n\n    const walletAccounts = reconcileWalletAccountsAgainstClient(\n      {\n        addToDynamicWalletAccounts,\n        walletAccounts: [walletAccount],\n        walletProviderKey: walletProvider.key,\n      },\n      client\n    );\n\n    return { walletAccounts };\n  };\n\n  return { approval, uri };\n};\n","import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class MetaMaskWalletNotConnectedError extends BaseError {\n  constructor() {\n    super({\n      cause: null,\n      code: 'metamask_wallet_not_connected',\n      docsUrl: null,\n      name: 'MetaMaskWalletNotConnectedError',\n      shortMessage:\n        'MetaMask SDK has no connected wallet account. Complete the URI pairing (await the connect approval) before building the MetaMask wallet provider.',\n    });\n  }\n}\n","import { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport { name, version } from '../../package.json';\n\nassertPackageVersion(name, version);\n\nexport { clearMetaMaskSessionStorage } from '../clearMetaMaskSessionStorage';\nexport { connectWithMetaMaskUri } from '../connectWithMetaMaskUri';\nexport type { ConnectWithMetaMaskUriParams } from '../connectWithMetaMaskUri';\nexport { MetaMaskDisplayUriMissingError } from '../errors/MetaMaskDisplayUriMissingError';\nexport { MetaMaskWalletNotConnectedError } from '../errors/MetaMaskWalletNotConnectedError';\nexport { getMetaMaskExtensionWalletProviderKey } from '../getMetaMaskExtensionWalletProviderKey';\nexport type {\n  DisplayUriListener,\n  MetaMaskController,\n} from '../metamask.types';\n"],"mappings":";;;;;;;;;;;ACOA,MAAM,wBAAwB;AAE9B,MAAM,kCACJ;;;;;;;;;;;;;;;;;;;;;AAsBF,MAAa,+BAGX,WACkB;AAClB,KAAI,OAAO,cAAc,YACvB,QAAO,QAAQ,SAAS;AAG1B,QAAO,IAAI,SAAe,YAAY;AACpC,MAAI;GACF,MAAM,UAAU,UAAU,eAAe,sBAAsB;AAC/D,WAAQ,kBAAkB,SAAS;AASnC,WAAQ,gBAAgB;AACtB,+CAAQ,OAAO,CAAC,OAAO,KAAK,iCAAiC,QAAQ,MAAM;AAC3E,aAAS;;AAEX,WAAQ,kBAAkB,SAAS;WAC5B,OAAO;AACd,8CAAQ,OAAO,CAAC,OAAO,KAAK,iCAAiC,MAAM;AACnE,YAAS;;GAEX;;;;;AC5DJ,IAAa,iCAAb,cAAoDA,mCAAU;CAC5D,cAAc;AACZ,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cACE;GACH,CAAC;;;;;;ACJN,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;AA+B7B,MAAa,yCACX,EAAE,SACF,8DAA0C,KACnB;AAYvB,qEAX4C,OAAO,CAAC,eAAe,CAE3C,MACrB,aACC,SAAS,UAAU,SACnB,SAAS,uBAAuBC,8CAAmB,oBACnD,SAAS,SAAS,aACd,aAAa,CACd,SAAS,qBAAqB,CACpC,EAEa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACehB,MAAa,yBAAyB,OACpC,EACE,6BAA6B,MAC7B,OACA,eACA,yBAEF,8DAA0C,KACK;CAC/C,MAAM,eAAe,sCAAsC,EAAE,OAAO,EAAE,OAAO;AAE7E,KAAI,iBAAiB,OACnB,4CAAQ,OAAO,CAAC,OAAO,KACrB,kDAAkD,MAAM,uBAAuB,aAAa,2FAA2F,aAAa,oCACrM;CAGH,MAAM,aAAa,MAAM,cAAc,OAAO;CAE9C,MAAM,wEAA6C;CAEnD,MAAM,cAAc,WAAW,cAAc,eAAe;AAC1D,cAAY,QAAQ,WAAW;GAC/B;CAEF,MAAM,iBAAiB,WAAW,SAAS;AAK3C,gBACG,WAAW;AACV,cAAY,OAAO,IAAI,gCAAgC,CAAC;GACxD,CACD,OAAO,UAAmB;AACzB,cAAY,OAAO,MAAM;GACzB;CAEJ,IAAIC;AACJ,KAAI;AACF,QAAM,MAAM,YAAY;WAChB;AACR,eAAa;;CAGf,MAAM,WAAW,YAA0D;AACzE,QAAM;EAEN,MAAM,iBAAiB,MAAM,sBAAsB,OAAO;AAE1D,+DAA0B,OAAO,CAAC,SAAS;GACzC,UAAUC,qDAAuB;GACjC;GACD,CAAC;EAEF,MAAM,EAAE,cAAc,MAAM,eAAe,uBAAuB;EAIlE,MAAM,cAAc,UAAU;AAE9B,MAAI,gBAAgB,OAClB,OAAM,IAAIC,8CAAqB;AAyBjC,SAAO,EAAE,wFARP;GACE;GACA,gBAAgB,CAhBiB;IACnC,SAAS;IACT,OAAO,eAAe;IACtB,6DAA0B;KACxB,SAAS;KACT,OAAO,eAAe;KACtB,mBAAmB,eAAe;KACnC,CAAC;IACF,gBAAgB;IAChB,sBAAsB;IACtB,mBAAmB,eAAe;IACnC,CAKkC;GAC/B,mBAAmB,eAAe;GACnC,EACD,OACD,EAEwB;;AAG3B,QAAO;EAAE;EAAU;EAAK;;;;;AC5J1B,IAAa,kCAAb,cAAqDC,mCAAU;CAC7D,cAAc;AACZ,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cACE;GACH,CAAC;;;;;;mECPe,MAAM,QAAQ"}

package/dist/index.esm.js

@@ -1,15 +1,16 @@
 import { assertPackageVersion } from "@dynamic-labs-sdk/assert-package-version";
-import { BaseError, NoAddressFoundError } from "@dynamic-labs-sdk/client";
 import { WalletProviderPriority, createDeferredPromise, formatWalletAccountId, getCore, getDefaultClient, getWalletProviderRegistry, reconcileWalletAccountsAgainstClient } from "@dynamic-labs-sdk/client/core";
+import { BaseError, NoAddressFoundError } from "@dynamic-labs-sdk/client";
 import { WalletProviderEnum } from "@dynamic-labs/sdk-api-core";
 
 //#region package.json
 var name = "@dynamic-labs-sdk/metamask";
-var version = "1.27.0";
+var version = "1.27.2";
 
 //#endregion
 //#region src/clearMetaMaskSessionStorage/clearMetaMaskSessionStorage.ts
 const METAMASK_SDK_IDB_NAME = "mmconnect-kv-store";
+const FAILED_TO_CLEAR_SESSION_MESSAGE = "[metamask] failed to clear the persisted session from IndexedDB; the next pairing may resume a stale session instead of showing a new one";
 /**
 * Deletes the MetaMask SDK's IndexedDB session storage so the next connect call
 * emits a fresh `display_uri` synchronously instead of spending the SDK's
@@ -18,24 +19,31 @@ const METAMASK_SDK_IDB_NAME = "mmconnect-kv-store";
 *
 * @example
 * ```ts
-* await clearMetaMaskSessionStorage();
+* await clearMetaMaskSessionStorage(client);
 * // Next connectWithMetaMaskUri call will emit a fresh URI immediately.
 * ```
 *
+* @param client - The Dynamic client instance. Required (rather than
+* defaulting to the last-initialized client) so a storage-clear failure is
+* always logged against the client that actually requested it.
 * @returns A promise that resolves once the database is deleted (or immediately in SSR).
 * @see connectWithMetaMaskUri
 * @see getMetaMaskExtensionWalletProviderKey
 * @notInstrumented
 */
-const clearMetaMaskSessionStorage = () => {
+const clearMetaMaskSessionStorage = (client) => {
 	if (typeof indexedDB === "undefined") return Promise.resolve();
 	return new Promise((resolve) => {
 		try {
 			const request = indexedDB.deleteDatabase(METAMASK_SDK_IDB_NAME);
 			request.onsuccess = () => resolve();
-			request.onerror = () => resolve();
+			request.onerror = () => {
+				getCore(client).logger.warn(FAILED_TO_CLEAR_SESSION_MESSAGE, request.error);
+				resolve();
+			};
 			request.onblocked = () => resolve();
-		} catch {
+		} catch (error) {
+			getCore(client).logger.warn(FAILED_TO_CLEAR_SESSION_MESSAGE, error);
 			resolve();
 		}
 	});

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","names":["uri: string"],"sources":["../package.json","../src/clearMetaMaskSessionStorage/clearMetaMaskSessionStorage.ts","../src/errors/MetaMaskDisplayUriMissingError/MetaMaskDisplayUriMissingError.ts","../src/getMetaMaskExtensionWalletProviderKey/getMetaMaskExtensionWalletProviderKey.ts","../src/connectWithMetaMaskUri/connectWithMetaMaskUri.ts","../src/errors/MetaMaskWalletNotConnectedError/MetaMaskWalletNotConnectedError.ts","../src/exports/index.ts"],"sourcesContent":["","// MetaMask SDK persists session state in this IndexedDB database.\n// Hardcoded inside `@metamask/connect-multichain` (the SDK shared by\n// every chain-specific connect-* facade) as `${DB_NAME}${dbNameSuffix}`\n// → `mmconnect` + `-kv-store` on web.\nconst METAMASK_SDK_IDB_NAME = 'mmconnect-kv-store';\n\n/**\n * Deletes the MetaMask SDK's IndexedDB session storage so the next connect call\n * emits a fresh `display_uri` synchronously instead of spending the SDK's\n * 10-second resume timeout reviving a dead pairing. Safe in SSR (no-op) and\n * when the DB is held open by another tab (resolves on `blocked`).\n *\n * @example\n * ```ts\n * await clearMetaMaskSessionStorage();\n * // Next connectWithMetaMaskUri call will emit a fresh URI immediately.\n * ```\n *\n * @returns A promise that resolves once the database is deleted (or immediately in SSR).\n * @see connectWithMetaMaskUri\n * @see getMetaMaskExtensionWalletProviderKey\n * @notInstrumented\n */\nexport const clearMetaMaskSessionStorage = (): Promise<void> => {\n  if (typeof indexedDB === 'undefined') {\n    return Promise.resolve();\n  }\n\n  return new Promise<void>((resolve) => {\n    try {\n      const request = indexedDB.deleteDatabase(METAMASK_SDK_IDB_NAME);\n      request.onsuccess = () => resolve();\n      // `onerror` / `onblocked` fire when a concurrent tab holds the\n      // DB open. We still resolve so the consumer's connect flow is\n      // not stalled indefinitely; the next tab close drops the lock\n      // and subsequent runs reach the empty database. The Promise\n      // executor already ignores subsequent resolve calls, so no\n      // extra guard is needed when multiple lifecycle events fire on\n      // the same request.\n      request.onerror = () => resolve();\n      request.onblocked = () => resolve();\n    } catch {\n      resolve();\n    }\n  });\n};\n","import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class MetaMaskDisplayUriMissingError extends BaseError {\n  constructor() {\n    super({\n      cause: null,\n      code: 'metamask_display_uri_missing',\n      docsUrl: null,\n      name: 'MetaMaskDisplayUriMissingError',\n      shortMessage:\n        'MetaMask SDK completed the connection without emitting a display_uri. The connect helper requires the SDK to produce a pairing URI. Please reach out to Dynamic about this error.',\n    });\n  }\n}\n","import type { Chain, DynamicClient } from '@dynamic-labs-sdk/client';\nimport {\n  getDefaultClient,\n  getWalletProviderRegistry,\n} from '@dynamic-labs-sdk/client/core';\nimport { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';\n\nconst METAMASK_NAME_NEEDLE = 'metamask';\n\ntype GetMetaMaskExtensionWalletProviderKeyParams = {\n  /** Chain to scope the lookup to. */\n  chain: Chain;\n};\n\n/**\n * Returns the wallet provider key of the MetaMask browser extension announced\n * for the given chain (EIP-6963 on EVM, Wallet Standard on Solana), or\n * `undefined` when none is announced. Matches on normalized display name to\n * cover MetaMask, Flask, and other variants. Synchronous and safe to call from\n * a React render. Pass the returned key to `connectWithWalletProvider` to route\n * the connection through the announced provider; fall back to the chain's\n * `connectWithMetaMaskUri<Chain>` helper when `undefined`.\n *\n * @example\n * ```ts\n * const key = getMetaMaskExtensionWalletProviderKey({ chain: 'EVM' });\n * if (key) {\n *   await connectWithWalletProvider({ walletProviderKey: key });\n * }\n * ```\n *\n * @param params.chain - Chain to scope the lookup to.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns The wallet provider key string, or `undefined` if no MetaMask extension is announced.\n * @see connectWithMetaMaskUri\n * @see clearMetaMaskSessionStorage\n * @notInstrumented\n */\nexport const getMetaMaskExtensionWalletProviderKey = (\n  { chain }: GetMetaMaskExtensionWalletProviderKeyParams,\n  client: DynamicClient = getDefaultClient()\n): string | undefined => {\n  const providers = getWalletProviderRegistry(client).listProviders();\n\n  const match = providers.find(\n    (provider) =>\n      provider.chain === chain &&\n      provider.walletProviderType === WalletProviderEnum.BrowserExtension &&\n      provider.metadata.displayName\n        ?.toLowerCase()\n        .includes(METAMASK_NAME_NEEDLE)\n  );\n\n  return match?.key;\n};\n","import type {\n  Chain,\n  DynamicClient,\n  WalletAccount,\n  WalletProviderUriConnectionResult,\n} from '@dynamic-labs-sdk/client';\nimport { NoAddressFoundError } from '@dynamic-labs-sdk/client';\nimport type { WalletProvider } from '@dynamic-labs-sdk/client/core';\nimport {\n  WalletProviderPriority,\n  createDeferredPromise,\n  formatWalletAccountId,\n  getCore,\n  getDefaultClient,\n  getWalletProviderRegistry,\n  reconcileWalletAccountsAgainstClient,\n} from '@dynamic-labs-sdk/client/core';\n\nimport { MetaMaskDisplayUriMissingError } from '../errors/MetaMaskDisplayUriMissingError';\nimport { getMetaMaskExtensionWalletProviderKey } from '../getMetaMaskExtensionWalletProviderKey';\nimport type { MetaMaskController } from '../metamask.types';\n\nexport type ConnectWithMetaMaskUriParams = {\n  /** Whether to add the connected wallet account to the Dynamic client. Defaults to `true`. */\n  addToDynamicWalletAccounts?: boolean;\n  /** Chain being connected; used to scope the extension-installed lookup. */\n  chain: Chain;\n  /** Returns the chain-specific `MetaMaskController` that drives the pairing. */\n  getController: (client: DynamicClient) => Promise<MetaMaskController>;\n  /**\n   * Builds the chain-specific `WalletProvider` AFTER the pairing has been\n   * approved. Must NOT include a `connect` method — the provider is registered\n   * purely for signing routing and would otherwise leak into the wallet picker.\n   */\n  walletProviderBuilder: (client: DynamicClient) => Promise<WalletProvider>;\n};\n\n/**\n * Drives a MetaMask SDK pairing for any chain and returns `{ approval, uri }`\n * so consumers can render the QR / hand the URI to a deeplink. Logs an\n * advisory warning when the extension is already announced for the chain —\n * pairing still proceeds, but the consumer is told which announced provider\n * key to route through for the best UX. Builds and registers the chain-\n * specific wallet provider only after pairing is approved; the provider\n * therefore never appears in the wallet picker (no `connect` method).\n *\n * @example\n * ```ts\n * const { uri, approval } = await connectWithMetaMaskUri({\n *   chain: 'EVM',\n *   getController: (client) => getEvmMetaMaskController(client),\n *   walletProviderBuilder: (client) => buildEvmWalletProvider(client),\n * });\n * // Render QR code with `uri`, then await approval()\n * ```\n *\n * @param params.chain - Chain being connected; used to scope the extension-installed lookup.\n * @param params.getController - Returns the chain-specific MetaMaskController for the pairing.\n * @param params.walletProviderBuilder - Builds the chain-specific WalletProvider after pairing approval.\n * @param [params.addToDynamicWalletAccounts] - Whether to add the wallet to the client. Defaults to `true`.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns An object with `uri` (the pairing URI) and `approval` (async function resolving to wallet accounts).\n * @throws {MetaMaskDisplayUriMissingError} If `connect` settles before a display_uri is emitted.\n * @throws {NoAddressFoundError} If no address is returned after pairing approval.\n * @see clearMetaMaskSessionStorage\n * @see getMetaMaskExtensionWalletProviderKey\n * @notInstrumented\n */\nexport const connectWithMetaMaskUri = async (\n  {\n    addToDynamicWalletAccounts = true,\n    chain,\n    getController,\n    walletProviderBuilder,\n  }: ConnectWithMetaMaskUriParams,\n  client: DynamicClient = getDefaultClient()\n): Promise<WalletProviderUriConnectionResult> => {\n  const announcedKey = getMetaMaskExtensionWalletProviderKey({ chain }, client);\n\n  if (announcedKey !== undefined) {\n    getCore(client).logger.warn(\n      `[metamask] MetaMask extension is announced for ${chain} as wallet provider \"${announcedKey}\"; proceeding with URI pairing. Consider connectWithWalletProvider({ walletProviderKey: \"${announcedKey}\" }) for the best user experience.`\n    );\n  }\n\n  const controller = await getController(client);\n\n  const uriDeferred = createDeferredPromise<string>();\n\n  const unsubscribe = controller.onDisplayUri((displayUri) => {\n    uriDeferred.resolve(displayUri);\n  });\n\n  const connectPromise = controller.connect();\n\n  // If `connect` settles before a `display_uri` is emitted, no URI was made\n  // available and the pairing is unusable. Reject the deferred so the caller\n  // surfaces `MetaMaskDisplayUriMissingError` (or the underlying failure).\n  connectPromise\n    .then(() => {\n      uriDeferred.reject(new MetaMaskDisplayUriMissingError());\n    })\n    .catch((error: unknown) => {\n      uriDeferred.reject(error);\n    });\n\n  let uri: string;\n  try {\n    uri = await uriDeferred.promise;\n  } finally {\n    unsubscribe();\n  }\n\n  const approval = async (): Promise<{ walletAccounts: WalletAccount[] }> => {\n    await connectPromise;\n\n    const walletProvider = await walletProviderBuilder(client);\n\n    getWalletProviderRegistry(client).register({\n      priority: WalletProviderPriority.WALLET_SDK,\n      walletProvider,\n    });\n\n    const { addresses } = await walletProvider.getConnectedAddresses();\n\n    // MetaMask SDK exposes a single active address per pairing (same model as\n    // EIP-1193 `eth_accounts`); we only materialize the first one.\n    const mainAddress = addresses[0];\n\n    if (mainAddress === undefined) {\n      throw new NoAddressFoundError();\n    }\n\n    const walletAccount: WalletAccount = {\n      address: mainAddress,\n      chain: walletProvider.chain,\n      id: formatWalletAccountId({\n        address: mainAddress,\n        chain: walletProvider.chain,\n        walletProviderKey: walletProvider.key,\n      }),\n      lastSelectedAt: null,\n      verifiedCredentialId: null,\n      walletProviderKey: walletProvider.key,\n    };\n\n    const walletAccounts = reconcileWalletAccountsAgainstClient(\n      {\n        addToDynamicWalletAccounts,\n        walletAccounts: [walletAccount],\n        walletProviderKey: walletProvider.key,\n      },\n      client\n    );\n\n    return { walletAccounts };\n  };\n\n  return { approval, uri };\n};\n","import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class MetaMaskWalletNotConnectedError extends BaseError {\n  constructor() {\n    super({\n      cause: null,\n      code: 'metamask_wallet_not_connected',\n      docsUrl: null,\n      name: 'MetaMaskWalletNotConnectedError',\n      shortMessage:\n        'MetaMask SDK has no connected wallet account. Complete the URI pairing (await the connect approval) before building the MetaMask wallet provider.',\n    });\n  }\n}\n","import { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport { name, version } from '../../package.json';\n\nassertPackageVersion(name, version);\n\nexport { clearMetaMaskSessionStorage } from '../clearMetaMaskSessionStorage';\nexport { connectWithMetaMaskUri } from '../connectWithMetaMaskUri';\nexport type { ConnectWithMetaMaskUriParams } from '../connectWithMetaMaskUri';\nexport { MetaMaskDisplayUriMissingError } from '../errors/MetaMaskDisplayUriMissingError';\nexport { MetaMaskWalletNotConnectedError } from '../errors/MetaMaskWalletNotConnectedError';\nexport { getMetaMaskExtensionWalletProviderKey } from '../getMetaMaskExtensionWalletProviderKey';\nexport type {\n  DisplayUriListener,\n  MetaMaskController,\n} from '../metamask.types';\n"],"mappings":";;;;;;;;;;;ACIA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;AAmB9B,MAAa,oCAAmD;AAC9D,KAAI,OAAO,cAAc,YACvB,QAAO,QAAQ,SAAS;AAG1B,QAAO,IAAI,SAAe,YAAY;AACpC,MAAI;GACF,MAAM,UAAU,UAAU,eAAe,sBAAsB;AAC/D,WAAQ,kBAAkB,SAAS;AAQnC,WAAQ,gBAAgB,SAAS;AACjC,WAAQ,kBAAkB,SAAS;UAC7B;AACN,YAAS;;GAEX;;;;;AC1CJ,IAAa,iCAAb,cAAoD,UAAU;CAC5D,cAAc;AACZ,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cACE;GACH,CAAC;;;;;;ACJN,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;AA+B7B,MAAa,yCACX,EAAE,SACF,SAAwB,kBAAkB,KACnB;AAYvB,QAXkB,0BAA0B,OAAO,CAAC,eAAe,CAE3C,MACrB,aACC,SAAS,UAAU,SACnB,SAAS,uBAAuB,mBAAmB,oBACnD,SAAS,SAAS,aACd,aAAa,CACd,SAAS,qBAAqB,CACpC,EAEa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACehB,MAAa,yBAAyB,OACpC,EACE,6BAA6B,MAC7B,OACA,eACA,yBAEF,SAAwB,kBAAkB,KACK;CAC/C,MAAM,eAAe,sCAAsC,EAAE,OAAO,EAAE,OAAO;AAE7E,KAAI,iBAAiB,OACnB,SAAQ,OAAO,CAAC,OAAO,KACrB,kDAAkD,MAAM,uBAAuB,aAAa,2FAA2F,aAAa,oCACrM;CAGH,MAAM,aAAa,MAAM,cAAc,OAAO;CAE9C,MAAM,cAAc,uBAA+B;CAEnD,MAAM,cAAc,WAAW,cAAc,eAAe;AAC1D,cAAY,QAAQ,WAAW;GAC/B;CAEF,MAAM,iBAAiB,WAAW,SAAS;AAK3C,gBACG,WAAW;AACV,cAAY,OAAO,IAAI,gCAAgC,CAAC;GACxD,CACD,OAAO,UAAmB;AACzB,cAAY,OAAO,MAAM;GACzB;CAEJ,IAAIA;AACJ,KAAI;AACF,QAAM,MAAM,YAAY;WAChB;AACR,eAAa;;CAGf,MAAM,WAAW,YAA0D;AACzE,QAAM;EAEN,MAAM,iBAAiB,MAAM,sBAAsB,OAAO;AAE1D,4BAA0B,OAAO,CAAC,SAAS;GACzC,UAAU,uBAAuB;GACjC;GACD,CAAC;EAEF,MAAM,EAAE,cAAc,MAAM,eAAe,uBAAuB;EAIlE,MAAM,cAAc,UAAU;AAE9B,MAAI,gBAAgB,OAClB,OAAM,IAAI,qBAAqB;AAyBjC,SAAO,EAAE,gBATc,qCACrB;GACE;GACA,gBAAgB,CAhBiB;IACnC,SAAS;IACT,OAAO,eAAe;IACtB,IAAI,sBAAsB;KACxB,SAAS;KACT,OAAO,eAAe;KACtB,mBAAmB,eAAe;KACnC,CAAC;IACF,gBAAgB;IAChB,sBAAsB;IACtB,mBAAmB,eAAe;IACnC,CAKkC;GAC/B,mBAAmB,eAAe;GACnC,EACD,OACD,EAEwB;;AAG3B,QAAO;EAAE;EAAU;EAAK;;;;;AC5J1B,IAAa,kCAAb,cAAqD,UAAU;CAC7D,cAAc;AACZ,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cACE;GACH,CAAC;;;;;;ACPN,qBAAqB,MAAM,QAAQ"}
+{"version":3,"file":"index.esm.js","names":["uri: string"],"sources":["../package.json","../src/clearMetaMaskSessionStorage/clearMetaMaskSessionStorage.ts","../src/errors/MetaMaskDisplayUriMissingError/MetaMaskDisplayUriMissingError.ts","../src/getMetaMaskExtensionWalletProviderKey/getMetaMaskExtensionWalletProviderKey.ts","../src/connectWithMetaMaskUri/connectWithMetaMaskUri.ts","../src/errors/MetaMaskWalletNotConnectedError/MetaMaskWalletNotConnectedError.ts","../src/exports/index.ts"],"sourcesContent":["","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { getCore } from '@dynamic-labs-sdk/client/core';\n\n// MetaMask SDK persists session state in this IndexedDB database.\n// Hardcoded inside `@metamask/connect-multichain` (the SDK shared by\n// every chain-specific connect-* facade) as `${DB_NAME}${dbNameSuffix}`\n// → `mmconnect` + `-kv-store` on web.\nconst METAMASK_SDK_IDB_NAME = 'mmconnect-kv-store';\n\nconst FAILED_TO_CLEAR_SESSION_MESSAGE =\n  '[metamask] failed to clear the persisted session from IndexedDB; the next pairing may resume a stale session instead of showing a new one';\n\n/**\n * Deletes the MetaMask SDK's IndexedDB session storage so the next connect call\n * emits a fresh `display_uri` synchronously instead of spending the SDK's\n * 10-second resume timeout reviving a dead pairing. Safe in SSR (no-op) and\n * when the DB is held open by another tab (resolves on `blocked`).\n *\n * @example\n * ```ts\n * await clearMetaMaskSessionStorage(client);\n * // Next connectWithMetaMaskUri call will emit a fresh URI immediately.\n * ```\n *\n * @param client - The Dynamic client instance. Required (rather than\n * defaulting to the last-initialized client) so a storage-clear failure is\n * always logged against the client that actually requested it.\n * @returns A promise that resolves once the database is deleted (or immediately in SSR).\n * @see connectWithMetaMaskUri\n * @see getMetaMaskExtensionWalletProviderKey\n * @notInstrumented\n */\nexport const clearMetaMaskSessionStorage = (\n  // No default: avoids misattributing the failure-path warning below.\n  // eslint-disable-next-line custom-rules/check-dynamic-client-param-in-external-functions\n  client: DynamicClient\n): Promise<void> => {\n  if (typeof indexedDB === 'undefined') {\n    return Promise.resolve();\n  }\n\n  return new Promise<void>((resolve) => {\n    try {\n      const request = indexedDB.deleteDatabase(METAMASK_SDK_IDB_NAME);\n      request.onsuccess = () => resolve();\n      // `onblocked` fires when a concurrent tab holds the DB open; that is\n      // expected multi-tab behaviour, not a failure, so it resolves quietly.\n      // We still resolve on `onerror` so the consumer's connect flow is not\n      // stalled indefinitely, but it is logged first: a failed delete here\n      // puts the caller back on the stale session it was trying to escape.\n      // The Promise executor already ignores subsequent resolve calls, so no\n      // extra guard is needed when multiple lifecycle events fire on the\n      // same request.\n      request.onerror = () => {\n        getCore(client).logger.warn(FAILED_TO_CLEAR_SESSION_MESSAGE, request.error);\n        resolve();\n      };\n      request.onblocked = () => resolve();\n    } catch (error) {\n      getCore(client).logger.warn(FAILED_TO_CLEAR_SESSION_MESSAGE, error);\n      resolve();\n    }\n  });\n};\n","import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class MetaMaskDisplayUriMissingError extends BaseError {\n  constructor() {\n    super({\n      cause: null,\n      code: 'metamask_display_uri_missing',\n      docsUrl: null,\n      name: 'MetaMaskDisplayUriMissingError',\n      shortMessage:\n        'MetaMask SDK completed the connection without emitting a display_uri. The connect helper requires the SDK to produce a pairing URI. Please reach out to Dynamic about this error.',\n    });\n  }\n}\n","import type { Chain, DynamicClient } from '@dynamic-labs-sdk/client';\nimport {\n  getDefaultClient,\n  getWalletProviderRegistry,\n} from '@dynamic-labs-sdk/client/core';\nimport { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';\n\nconst METAMASK_NAME_NEEDLE = 'metamask';\n\ntype GetMetaMaskExtensionWalletProviderKeyParams = {\n  /** Chain to scope the lookup to. */\n  chain: Chain;\n};\n\n/**\n * Returns the wallet provider key of the MetaMask browser extension announced\n * for the given chain (EIP-6963 on EVM, Wallet Standard on Solana), or\n * `undefined` when none is announced. Matches on normalized display name to\n * cover MetaMask, Flask, and other variants. Synchronous and safe to call from\n * a React render. Pass the returned key to `connectWithWalletProvider` to route\n * the connection through the announced provider; fall back to the chain's\n * `connectWithMetaMaskUri<Chain>` helper when `undefined`.\n *\n * @example\n * ```ts\n * const key = getMetaMaskExtensionWalletProviderKey({ chain: 'EVM' });\n * if (key) {\n *   await connectWithWalletProvider({ walletProviderKey: key });\n * }\n * ```\n *\n * @param params.chain - Chain to scope the lookup to.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns The wallet provider key string, or `undefined` if no MetaMask extension is announced.\n * @see connectWithMetaMaskUri\n * @see clearMetaMaskSessionStorage\n * @notInstrumented\n */\nexport const getMetaMaskExtensionWalletProviderKey = (\n  { chain }: GetMetaMaskExtensionWalletProviderKeyParams,\n  client: DynamicClient = getDefaultClient()\n): string | undefined => {\n  const providers = getWalletProviderRegistry(client).listProviders();\n\n  const match = providers.find(\n    (provider) =>\n      provider.chain === chain &&\n      provider.walletProviderType === WalletProviderEnum.BrowserExtension &&\n      provider.metadata.displayName\n        ?.toLowerCase()\n        .includes(METAMASK_NAME_NEEDLE)\n  );\n\n  return match?.key;\n};\n","import type {\n  Chain,\n  DynamicClient,\n  WalletAccount,\n  WalletProviderUriConnectionResult,\n} from '@dynamic-labs-sdk/client';\nimport { NoAddressFoundError } from '@dynamic-labs-sdk/client';\nimport type { WalletProvider } from '@dynamic-labs-sdk/client/core';\nimport {\n  WalletProviderPriority,\n  createDeferredPromise,\n  formatWalletAccountId,\n  getCore,\n  getDefaultClient,\n  getWalletProviderRegistry,\n  reconcileWalletAccountsAgainstClient,\n} from '@dynamic-labs-sdk/client/core';\n\nimport { MetaMaskDisplayUriMissingError } from '../errors/MetaMaskDisplayUriMissingError';\nimport { getMetaMaskExtensionWalletProviderKey } from '../getMetaMaskExtensionWalletProviderKey';\nimport type { MetaMaskController } from '../metamask.types';\n\nexport type ConnectWithMetaMaskUriParams = {\n  /** Whether to add the connected wallet account to the Dynamic client. Defaults to `true`. */\n  addToDynamicWalletAccounts?: boolean;\n  /** Chain being connected; used to scope the extension-installed lookup. */\n  chain: Chain;\n  /** Returns the chain-specific `MetaMaskController` that drives the pairing. */\n  getController: (client: DynamicClient) => Promise<MetaMaskController>;\n  /**\n   * Builds the chain-specific `WalletProvider` AFTER the pairing has been\n   * approved. Must NOT include a `connect` method — the provider is registered\n   * purely for signing routing and would otherwise leak into the wallet picker.\n   */\n  walletProviderBuilder: (client: DynamicClient) => Promise<WalletProvider>;\n};\n\n/**\n * Drives a MetaMask SDK pairing for any chain and returns `{ approval, uri }`\n * so consumers can render the QR / hand the URI to a deeplink. Logs an\n * advisory warning when the extension is already announced for the chain —\n * pairing still proceeds, but the consumer is told which announced provider\n * key to route through for the best UX. Builds and registers the chain-\n * specific wallet provider only after pairing is approved; the provider\n * therefore never appears in the wallet picker (no `connect` method).\n *\n * @example\n * ```ts\n * const { uri, approval } = await connectWithMetaMaskUri({\n *   chain: 'EVM',\n *   getController: (client) => getEvmMetaMaskController(client),\n *   walletProviderBuilder: (client) => buildEvmWalletProvider(client),\n * });\n * // Render QR code with `uri`, then await approval()\n * ```\n *\n * @param params.chain - Chain being connected; used to scope the extension-installed lookup.\n * @param params.getController - Returns the chain-specific MetaMaskController for the pairing.\n * @param params.walletProviderBuilder - Builds the chain-specific WalletProvider after pairing approval.\n * @param [params.addToDynamicWalletAccounts] - Whether to add the wallet to the client. Defaults to `true`.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns An object with `uri` (the pairing URI) and `approval` (async function resolving to wallet accounts).\n * @throws {MetaMaskDisplayUriMissingError} If `connect` settles before a display_uri is emitted.\n * @throws {NoAddressFoundError} If no address is returned after pairing approval.\n * @see clearMetaMaskSessionStorage\n * @see getMetaMaskExtensionWalletProviderKey\n * @notInstrumented\n */\nexport const connectWithMetaMaskUri = async (\n  {\n    addToDynamicWalletAccounts = true,\n    chain,\n    getController,\n    walletProviderBuilder,\n  }: ConnectWithMetaMaskUriParams,\n  client: DynamicClient = getDefaultClient()\n): Promise<WalletProviderUriConnectionResult> => {\n  const announcedKey = getMetaMaskExtensionWalletProviderKey({ chain }, client);\n\n  if (announcedKey !== undefined) {\n    getCore(client).logger.warn(\n      `[metamask] MetaMask extension is announced for ${chain} as wallet provider \"${announcedKey}\"; proceeding with URI pairing. Consider connectWithWalletProvider({ walletProviderKey: \"${announcedKey}\" }) for the best user experience.`\n    );\n  }\n\n  const controller = await getController(client);\n\n  const uriDeferred = createDeferredPromise<string>();\n\n  const unsubscribe = controller.onDisplayUri((displayUri) => {\n    uriDeferred.resolve(displayUri);\n  });\n\n  const connectPromise = controller.connect();\n\n  // If `connect` settles before a `display_uri` is emitted, no URI was made\n  // available and the pairing is unusable. Reject the deferred so the caller\n  // surfaces `MetaMaskDisplayUriMissingError` (or the underlying failure).\n  connectPromise\n    .then(() => {\n      uriDeferred.reject(new MetaMaskDisplayUriMissingError());\n    })\n    .catch((error: unknown) => {\n      uriDeferred.reject(error);\n    });\n\n  let uri: string;\n  try {\n    uri = await uriDeferred.promise;\n  } finally {\n    unsubscribe();\n  }\n\n  const approval = async (): Promise<{ walletAccounts: WalletAccount[] }> => {\n    await connectPromise;\n\n    const walletProvider = await walletProviderBuilder(client);\n\n    getWalletProviderRegistry(client).register({\n      priority: WalletProviderPriority.WALLET_SDK,\n      walletProvider,\n    });\n\n    const { addresses } = await walletProvider.getConnectedAddresses();\n\n    // MetaMask SDK exposes a single active address per pairing (same model as\n    // EIP-1193 `eth_accounts`); we only materialize the first one.\n    const mainAddress = addresses[0];\n\n    if (mainAddress === undefined) {\n      throw new NoAddressFoundError();\n    }\n\n    const walletAccount: WalletAccount = {\n      address: mainAddress,\n      chain: walletProvider.chain,\n      id: formatWalletAccountId({\n        address: mainAddress,\n        chain: walletProvider.chain,\n        walletProviderKey: walletProvider.key,\n      }),\n      lastSelectedAt: null,\n      verifiedCredentialId: null,\n      walletProviderKey: walletProvider.key,\n    };\n\n    const walletAccounts = reconcileWalletAccountsAgainstClient(\n      {\n        addToDynamicWalletAccounts,\n        walletAccounts: [walletAccount],\n        walletProviderKey: walletProvider.key,\n      },\n      client\n    );\n\n    return { walletAccounts };\n  };\n\n  return { approval, uri };\n};\n","import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class MetaMaskWalletNotConnectedError extends BaseError {\n  constructor() {\n    super({\n      cause: null,\n      code: 'metamask_wallet_not_connected',\n      docsUrl: null,\n      name: 'MetaMaskWalletNotConnectedError',\n      shortMessage:\n        'MetaMask SDK has no connected wallet account. Complete the URI pairing (await the connect approval) before building the MetaMask wallet provider.',\n    });\n  }\n}\n","import { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport { name, version } from '../../package.json';\n\nassertPackageVersion(name, version);\n\nexport { clearMetaMaskSessionStorage } from '../clearMetaMaskSessionStorage';\nexport { connectWithMetaMaskUri } from '../connectWithMetaMaskUri';\nexport type { ConnectWithMetaMaskUriParams } from '../connectWithMetaMaskUri';\nexport { MetaMaskDisplayUriMissingError } from '../errors/MetaMaskDisplayUriMissingError';\nexport { MetaMaskWalletNotConnectedError } from '../errors/MetaMaskWalletNotConnectedError';\nexport { getMetaMaskExtensionWalletProviderKey } from '../getMetaMaskExtensionWalletProviderKey';\nexport type {\n  DisplayUriListener,\n  MetaMaskController,\n} from '../metamask.types';\n"],"mappings":";;;;;;;;;;;ACOA,MAAM,wBAAwB;AAE9B,MAAM,kCACJ;;;;;;;;;;;;;;;;;;;;;AAsBF,MAAa,+BAGX,WACkB;AAClB,KAAI,OAAO,cAAc,YACvB,QAAO,QAAQ,SAAS;AAG1B,QAAO,IAAI,SAAe,YAAY;AACpC,MAAI;GACF,MAAM,UAAU,UAAU,eAAe,sBAAsB;AAC/D,WAAQ,kBAAkB,SAAS;AASnC,WAAQ,gBAAgB;AACtB,YAAQ,OAAO,CAAC,OAAO,KAAK,iCAAiC,QAAQ,MAAM;AAC3E,aAAS;;AAEX,WAAQ,kBAAkB,SAAS;WAC5B,OAAO;AACd,WAAQ,OAAO,CAAC,OAAO,KAAK,iCAAiC,MAAM;AACnE,YAAS;;GAEX;;;;;AC5DJ,IAAa,iCAAb,cAAoD,UAAU;CAC5D,cAAc;AACZ,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cACE;GACH,CAAC;;;;;;ACJN,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;AA+B7B,MAAa,yCACX,EAAE,SACF,SAAwB,kBAAkB,KACnB;AAYvB,QAXkB,0BAA0B,OAAO,CAAC,eAAe,CAE3C,MACrB,aACC,SAAS,UAAU,SACnB,SAAS,uBAAuB,mBAAmB,oBACnD,SAAS,SAAS,aACd,aAAa,CACd,SAAS,qBAAqB,CACpC,EAEa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACehB,MAAa,yBAAyB,OACpC,EACE,6BAA6B,MAC7B,OACA,eACA,yBAEF,SAAwB,kBAAkB,KACK;CAC/C,MAAM,eAAe,sCAAsC,EAAE,OAAO,EAAE,OAAO;AAE7E,KAAI,iBAAiB,OACnB,SAAQ,OAAO,CAAC,OAAO,KACrB,kDAAkD,MAAM,uBAAuB,aAAa,2FAA2F,aAAa,oCACrM;CAGH,MAAM,aAAa,MAAM,cAAc,OAAO;CAE9C,MAAM,cAAc,uBAA+B;CAEnD,MAAM,cAAc,WAAW,cAAc,eAAe;AAC1D,cAAY,QAAQ,WAAW;GAC/B;CAEF,MAAM,iBAAiB,WAAW,SAAS;AAK3C,gBACG,WAAW;AACV,cAAY,OAAO,IAAI,gCAAgC,CAAC;GACxD,CACD,OAAO,UAAmB;AACzB,cAAY,OAAO,MAAM;GACzB;CAEJ,IAAIA;AACJ,KAAI;AACF,QAAM,MAAM,YAAY;WAChB;AACR,eAAa;;CAGf,MAAM,WAAW,YAA0D;AACzE,QAAM;EAEN,MAAM,iBAAiB,MAAM,sBAAsB,OAAO;AAE1D,4BAA0B,OAAO,CAAC,SAAS;GACzC,UAAU,uBAAuB;GACjC;GACD,CAAC;EAEF,MAAM,EAAE,cAAc,MAAM,eAAe,uBAAuB;EAIlE,MAAM,cAAc,UAAU;AAE9B,MAAI,gBAAgB,OAClB,OAAM,IAAI,qBAAqB;AAyBjC,SAAO,EAAE,gBATc,qCACrB;GACE;GACA,gBAAgB,CAhBiB;IACnC,SAAS;IACT,OAAO,eAAe;IACtB,IAAI,sBAAsB;KACxB,SAAS;KACT,OAAO,eAAe;KACtB,mBAAmB,eAAe;KACnC,CAAC;IACF,gBAAgB;IAChB,sBAAsB;IACtB,mBAAmB,eAAe;IACnC,CAKkC;GAC/B,mBAAmB,eAAe;GACnC,EACD,OACD,EAEwB;;AAG3B,QAAO;EAAE;EAAU;EAAK;;;;;AC5J1B,IAAa,kCAAb,cAAqD,UAAU;CAC7D,cAAc;AACZ,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cACE;GACH,CAAC;;;;;;ACPN,qBAAqB,MAAM,QAAQ"}

package/dist/index.native.esm.js

@@ -0,0 +1,225 @@
+import { assertPackageVersion } from "@dynamic-labs-sdk/assert-package-version";
+import { WalletProviderPriority, createDeferredPromise, formatWalletAccountId, getCore, getDefaultClient, getWalletProviderRegistry, reconcileWalletAccountsAgainstClient } from "@dynamic-labs-sdk/client/core";
+import AsyncStorage from "@react-native-async-storage/async-storage";
+import { BaseError, NoAddressFoundError } from "@dynamic-labs-sdk/client";
+import { WalletProviderEnum } from "@dynamic-labs/sdk-api-core";
+
+//#region package.json
+var name = "@dynamic-labs-sdk/metamask";
+var version = "1.27.2";
+
+//#endregion
+//#region src/clearMetaMaskSessionStorage/clearMetaMaskSessionStorage.native.ts
+/**
+* Keys the MetaMask SDK writes verbatim (its RN store adapter applies no
+* namespace) that together make up a pairing. Deliberately excludes `anonId`,
+* `extensionId` and `DEBUG`: those are analytics and logger configuration, not
+* session state, and starting a new pairing is no reason to reset them.
+*/
+const METAMASK_SESSION_KEYS = new Set([
+	"cache_wallet_getSession",
+	"cache_eth_accounts",
+	"cache_eth_chainId",
+	"pending_session_request",
+	"multichain-transport",
+	"websocket-transport-client-id",
+	"sessions:master-list"
+]);
+/**
+* Prefixes whose full keys embed a session id or relay channel, so they cannot
+* be named up front and have to be matched against the stored key list.
+*/
+const METAMASK_SESSION_KEY_PREFIXES = [
+	"session:",
+	"nonce:",
+	"latest-nonces:"
+];
+const FAILED_TO_CLEAR_SESSION_MESSAGE = "[metamask] failed to clear the persisted session from AsyncStorage; the next pairing may resume a stale session instead of showing a new one";
+/**
+* Deletes the MetaMask SDK's persisted pairing session from AsyncStorage, which
+* is where its React Native store adapter keeps it, so the next connect call
+* starts a fresh pairing and emits a `display_uri` instead of silently resuming
+* a session that no longer works.
+*
+* Call this only when a new pairing is actually being requested. The SDK's
+* mobile transport is built to resume a session across app launches, so wiping
+* it on startup would leave a user who is still connected unable to sign
+* without scanning again.
+*
+* @example
+* ```ts
+* await clearMetaMaskSessionStorage(client);
+* // Next connectWithMetaMaskUri call will emit a fresh URI immediately.
+* ```
+*
+* @param client - The Dynamic client instance. Required (rather than
+* defaulting to the last-initialized client) so a storage-clear failure is
+* always logged against the client that actually requested it.
+* @returns A promise that resolves once the keys are removed. Never rejects — a
+* storage failure must not take down the connect flow that depends on it.
+* @see connectWithMetaMaskUri
+* @see getMetaMaskExtensionWalletProviderKey
+* @notInstrumented
+*/
+const clearMetaMaskSessionStorage = async (client) => {
+	try {
+		const keysToRemove = (await AsyncStorage.getAllKeys()).filter((key) => METAMASK_SESSION_KEYS.has(key) || METAMASK_SESSION_KEY_PREFIXES.some((prefix) => key.startsWith(prefix)));
+		if (keysToRemove.length === 0) return;
+		await AsyncStorage.multiRemove(keysToRemove);
+	} catch (error) {
+		getCore(client).logger.warn(FAILED_TO_CLEAR_SESSION_MESSAGE, error);
+	}
+};
+
+//#endregion
+//#region src/errors/MetaMaskDisplayUriMissingError/MetaMaskDisplayUriMissingError.ts
+var MetaMaskDisplayUriMissingError = class extends BaseError {
+	constructor() {
+		super({
+			cause: null,
+			code: "metamask_display_uri_missing",
+			docsUrl: null,
+			name: "MetaMaskDisplayUriMissingError",
+			shortMessage: "MetaMask SDK completed the connection without emitting a display_uri. The connect helper requires the SDK to produce a pairing URI. Please reach out to Dynamic about this error."
+		});
+	}
+};
+
+//#endregion
+//#region src/getMetaMaskExtensionWalletProviderKey/getMetaMaskExtensionWalletProviderKey.ts
+const METAMASK_NAME_NEEDLE = "metamask";
+/**
+* Returns the wallet provider key of the MetaMask browser extension announced
+* for the given chain (EIP-6963 on EVM, Wallet Standard on Solana), or
+* `undefined` when none is announced. Matches on normalized display name to
+* cover MetaMask, Flask, and other variants. Synchronous and safe to call from
+* a React render. Pass the returned key to `connectWithWalletProvider` to route
+* the connection through the announced provider; fall back to the chain's
+* `connectWithMetaMaskUri<Chain>` helper when `undefined`.
+*
+* @example
+* ```ts
+* const key = getMetaMaskExtensionWalletProviderKey({ chain: 'EVM' });
+* if (key) {
+*   await connectWithWalletProvider({ walletProviderKey: key });
+* }
+* ```
+*
+* @param params.chain - Chain to scope the lookup to.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns The wallet provider key string, or `undefined` if no MetaMask extension is announced.
+* @see connectWithMetaMaskUri
+* @see clearMetaMaskSessionStorage
+* @notInstrumented
+*/
+const getMetaMaskExtensionWalletProviderKey = ({ chain }, client = getDefaultClient()) => {
+	return getWalletProviderRegistry(client).listProviders().find((provider) => provider.chain === chain && provider.walletProviderType === WalletProviderEnum.BrowserExtension && provider.metadata.displayName?.toLowerCase().includes(METAMASK_NAME_NEEDLE))?.key;
+};
+
+//#endregion
+//#region src/connectWithMetaMaskUri/connectWithMetaMaskUri.ts
+/**
+* Drives a MetaMask SDK pairing for any chain and returns `{ approval, uri }`
+* so consumers can render the QR / hand the URI to a deeplink. Logs an
+* advisory warning when the extension is already announced for the chain —
+* pairing still proceeds, but the consumer is told which announced provider
+* key to route through for the best UX. Builds and registers the chain-
+* specific wallet provider only after pairing is approved; the provider
+* therefore never appears in the wallet picker (no `connect` method).
+*
+* @example
+* ```ts
+* const { uri, approval } = await connectWithMetaMaskUri({
+*   chain: 'EVM',
+*   getController: (client) => getEvmMetaMaskController(client),
+*   walletProviderBuilder: (client) => buildEvmWalletProvider(client),
+* });
+* // Render QR code with `uri`, then await approval()
+* ```
+*
+* @param params.chain - Chain being connected; used to scope the extension-installed lookup.
+* @param params.getController - Returns the chain-specific MetaMaskController for the pairing.
+* @param params.walletProviderBuilder - Builds the chain-specific WalletProvider after pairing approval.
+* @param [params.addToDynamicWalletAccounts] - Whether to add the wallet to the client. Defaults to `true`.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns An object with `uri` (the pairing URI) and `approval` (async function resolving to wallet accounts).
+* @throws {MetaMaskDisplayUriMissingError} If `connect` settles before a display_uri is emitted.
+* @throws {NoAddressFoundError} If no address is returned after pairing approval.
+* @see clearMetaMaskSessionStorage
+* @see getMetaMaskExtensionWalletProviderKey
+* @notInstrumented
+*/
+const connectWithMetaMaskUri = async ({ addToDynamicWalletAccounts = true, chain, getController, walletProviderBuilder }, client = getDefaultClient()) => {
+	const announcedKey = getMetaMaskExtensionWalletProviderKey({ chain }, client);
+	if (announcedKey !== void 0) getCore(client).logger.warn(`[metamask] MetaMask extension is announced for ${chain} as wallet provider "${announcedKey}"; proceeding with URI pairing. Consider connectWithWalletProvider({ walletProviderKey: "${announcedKey}" }) for the best user experience.`);
+	const controller = await getController(client);
+	const uriDeferred = createDeferredPromise();
+	const unsubscribe = controller.onDisplayUri((displayUri) => {
+		uriDeferred.resolve(displayUri);
+	});
+	const connectPromise = controller.connect();
+	connectPromise.then(() => {
+		uriDeferred.reject(new MetaMaskDisplayUriMissingError());
+	}).catch((error) => {
+		uriDeferred.reject(error);
+	});
+	let uri;
+	try {
+		uri = await uriDeferred.promise;
+	} finally {
+		unsubscribe();
+	}
+	const approval = async () => {
+		await connectPromise;
+		const walletProvider = await walletProviderBuilder(client);
+		getWalletProviderRegistry(client).register({
+			priority: WalletProviderPriority.WALLET_SDK,
+			walletProvider
+		});
+		const { addresses } = await walletProvider.getConnectedAddresses();
+		const mainAddress = addresses[0];
+		if (mainAddress === void 0) throw new NoAddressFoundError();
+		return { walletAccounts: reconcileWalletAccountsAgainstClient({
+			addToDynamicWalletAccounts,
+			walletAccounts: [{
+				address: mainAddress,
+				chain: walletProvider.chain,
+				id: formatWalletAccountId({
+					address: mainAddress,
+					chain: walletProvider.chain,
+					walletProviderKey: walletProvider.key
+				}),
+				lastSelectedAt: null,
+				verifiedCredentialId: null,
+				walletProviderKey: walletProvider.key
+			}],
+			walletProviderKey: walletProvider.key
+		}, client) };
+	};
+	return {
+		approval,
+		uri
+	};
+};
+
+//#endregion
+//#region src/errors/MetaMaskWalletNotConnectedError/MetaMaskWalletNotConnectedError.ts
+var MetaMaskWalletNotConnectedError = class extends BaseError {
+	constructor() {
+		super({
+			cause: null,
+			code: "metamask_wallet_not_connected",
+			docsUrl: null,
+			name: "MetaMaskWalletNotConnectedError",
+			shortMessage: "MetaMask SDK has no connected wallet account. Complete the URI pairing (await the connect approval) before building the MetaMask wallet provider."
+		});
+	}
+};
+
+//#endregion
+//#region src/exports/index.ts
+assertPackageVersion(name, version);
+
+//#endregion
+export { MetaMaskDisplayUriMissingError, MetaMaskWalletNotConnectedError, clearMetaMaskSessionStorage, connectWithMetaMaskUri, getMetaMaskExtensionWalletProviderKey };
+//# sourceMappingURL=index.native.esm.js.map

package/dist/index.native.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.native.esm.js","names":["uri: string"],"sources":["../package.json","../src/clearMetaMaskSessionStorage/clearMetaMaskSessionStorage.native.ts","../src/errors/MetaMaskDisplayUriMissingError/MetaMaskDisplayUriMissingError.ts","../src/getMetaMaskExtensionWalletProviderKey/getMetaMaskExtensionWalletProviderKey.ts","../src/connectWithMetaMaskUri/connectWithMetaMaskUri.ts","../src/errors/MetaMaskWalletNotConnectedError/MetaMaskWalletNotConnectedError.ts","../src/exports/index.ts"],"sourcesContent":["","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { getCore } from '@dynamic-labs-sdk/client/core';\nimport AsyncStorage from '@react-native-async-storage/async-storage';\n\n/**\n * Keys the MetaMask SDK writes verbatim (its RN store adapter applies no\n * namespace) that together make up a pairing. Deliberately excludes `anonId`,\n * `extensionId` and `DEBUG`: those are analytics and logger configuration, not\n * session state, and starting a new pairing is no reason to reset them.\n */\nconst METAMASK_SESSION_KEYS = new Set([\n  // Cached `wallet_getSession` response — the CAIP session (accounts, scopes).\n  'cache_wallet_getSession',\n  'cache_eth_accounts',\n  'cache_eth_chainId',\n  // A `session_request` the wallet never answered, kept so the SDK can resume\n  // the pairing UI after the app was backgrounded mid-scan.\n  'pending_session_request',\n  // Which transport is active; this is what tells the SDK to resume on launch.\n  'multichain-transport',\n  'websocket-transport-client-id',\n  // Index of every `session:<id>` record, used to enumerate and GC them.\n  'sessions:master-list',\n]);\n\n/**\n * Prefixes whose full keys embed a session id or relay channel, so they cannot\n * be named up front and have to be matched against the stored key list.\n */\nconst METAMASK_SESSION_KEY_PREFIXES = ['session:', 'nonce:', 'latest-nonces:'];\n\nconst FAILED_TO_CLEAR_SESSION_MESSAGE =\n  '[metamask] failed to clear the persisted session from AsyncStorage; the next pairing may resume a stale session instead of showing a new one';\n\n/**\n * Deletes the MetaMask SDK's persisted pairing session from AsyncStorage, which\n * is where its React Native store adapter keeps it, so the next connect call\n * starts a fresh pairing and emits a `display_uri` instead of silently resuming\n * a session that no longer works.\n *\n * Call this only when a new pairing is actually being requested. The SDK's\n * mobile transport is built to resume a session across app launches, so wiping\n * it on startup would leave a user who is still connected unable to sign\n * without scanning again.\n *\n * @example\n * ```ts\n * await clearMetaMaskSessionStorage(client);\n * // Next connectWithMetaMaskUri call will emit a fresh URI immediately.\n * ```\n *\n * @param client - The Dynamic client instance. Required (rather than\n * defaulting to the last-initialized client) so a storage-clear failure is\n * always logged against the client that actually requested it.\n * @returns A promise that resolves once the keys are removed. Never rejects — a\n * storage failure must not take down the connect flow that depends on it.\n * @see connectWithMetaMaskUri\n * @see getMetaMaskExtensionWalletProviderKey\n * @notInstrumented\n */\nexport const clearMetaMaskSessionStorage = async (\n  // No default: avoids misattributing the failure-path warning below.\n  // eslint-disable-next-line custom-rules/check-dynamic-client-param-in-external-functions\n  client: DynamicClient\n): Promise<void> => {\n  try {\n    const storedKeys = await AsyncStorage.getAllKeys();\n\n    // Filtering the fixed names against what is actually stored keeps\n    // `multiRemove` off keys that were never written, and lets the no-op case\n    // skip the write entirely.\n    const keysToRemove = storedKeys.filter(\n      (key) =>\n        METAMASK_SESSION_KEYS.has(key) ||\n        METAMASK_SESSION_KEY_PREFIXES.some((prefix) => key.startsWith(prefix))\n    );\n\n    if (keysToRemove.length === 0) {\n      return;\n    }\n\n    await AsyncStorage.multiRemove(keysToRemove);\n  } catch (error) {\n    // Matches the web implementation in resolving anyway, so the caller's\n    // pairing attempt still proceeds. It is logged rather than dropped because\n    // a failure here puts the caller back on the stale session it was trying to\n    // escape, and this is the only trace of why.\n    //\n    getCore(client).logger.warn(FAILED_TO_CLEAR_SESSION_MESSAGE, error);\n  }\n};\n","import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class MetaMaskDisplayUriMissingError extends BaseError {\n  constructor() {\n    super({\n      cause: null,\n      code: 'metamask_display_uri_missing',\n      docsUrl: null,\n      name: 'MetaMaskDisplayUriMissingError',\n      shortMessage:\n        'MetaMask SDK completed the connection without emitting a display_uri. The connect helper requires the SDK to produce a pairing URI. Please reach out to Dynamic about this error.',\n    });\n  }\n}\n","import type { Chain, DynamicClient } from '@dynamic-labs-sdk/client';\nimport {\n  getDefaultClient,\n  getWalletProviderRegistry,\n} from '@dynamic-labs-sdk/client/core';\nimport { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';\n\nconst METAMASK_NAME_NEEDLE = 'metamask';\n\ntype GetMetaMaskExtensionWalletProviderKeyParams = {\n  /** Chain to scope the lookup to. */\n  chain: Chain;\n};\n\n/**\n * Returns the wallet provider key of the MetaMask browser extension announced\n * for the given chain (EIP-6963 on EVM, Wallet Standard on Solana), or\n * `undefined` when none is announced. Matches on normalized display name to\n * cover MetaMask, Flask, and other variants. Synchronous and safe to call from\n * a React render. Pass the returned key to `connectWithWalletProvider` to route\n * the connection through the announced provider; fall back to the chain's\n * `connectWithMetaMaskUri<Chain>` helper when `undefined`.\n *\n * @example\n * ```ts\n * const key = getMetaMaskExtensionWalletProviderKey({ chain: 'EVM' });\n * if (key) {\n *   await connectWithWalletProvider({ walletProviderKey: key });\n * }\n * ```\n *\n * @param params.chain - Chain to scope the lookup to.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns The wallet provider key string, or `undefined` if no MetaMask extension is announced.\n * @see connectWithMetaMaskUri\n * @see clearMetaMaskSessionStorage\n * @notInstrumented\n */\nexport const getMetaMaskExtensionWalletProviderKey = (\n  { chain }: GetMetaMaskExtensionWalletProviderKeyParams,\n  client: DynamicClient = getDefaultClient()\n): string | undefined => {\n  const providers = getWalletProviderRegistry(client).listProviders();\n\n  const match = providers.find(\n    (provider) =>\n      provider.chain === chain &&\n      provider.walletProviderType === WalletProviderEnum.BrowserExtension &&\n      provider.metadata.displayName\n        ?.toLowerCase()\n        .includes(METAMASK_NAME_NEEDLE)\n  );\n\n  return match?.key;\n};\n","import type {\n  Chain,\n  DynamicClient,\n  WalletAccount,\n  WalletProviderUriConnectionResult,\n} from '@dynamic-labs-sdk/client';\nimport { NoAddressFoundError } from '@dynamic-labs-sdk/client';\nimport type { WalletProvider } from '@dynamic-labs-sdk/client/core';\nimport {\n  WalletProviderPriority,\n  createDeferredPromise,\n  formatWalletAccountId,\n  getCore,\n  getDefaultClient,\n  getWalletProviderRegistry,\n  reconcileWalletAccountsAgainstClient,\n} from '@dynamic-labs-sdk/client/core';\n\nimport { MetaMaskDisplayUriMissingError } from '../errors/MetaMaskDisplayUriMissingError';\nimport { getMetaMaskExtensionWalletProviderKey } from '../getMetaMaskExtensionWalletProviderKey';\nimport type { MetaMaskController } from '../metamask.types';\n\nexport type ConnectWithMetaMaskUriParams = {\n  /** Whether to add the connected wallet account to the Dynamic client. Defaults to `true`. */\n  addToDynamicWalletAccounts?: boolean;\n  /** Chain being connected; used to scope the extension-installed lookup. */\n  chain: Chain;\n  /** Returns the chain-specific `MetaMaskController` that drives the pairing. */\n  getController: (client: DynamicClient) => Promise<MetaMaskController>;\n  /**\n   * Builds the chain-specific `WalletProvider` AFTER the pairing has been\n   * approved. Must NOT include a `connect` method — the provider is registered\n   * purely for signing routing and would otherwise leak into the wallet picker.\n   */\n  walletProviderBuilder: (client: DynamicClient) => Promise<WalletProvider>;\n};\n\n/**\n * Drives a MetaMask SDK pairing for any chain and returns `{ approval, uri }`\n * so consumers can render the QR / hand the URI to a deeplink. Logs an\n * advisory warning when the extension is already announced for the chain —\n * pairing still proceeds, but the consumer is told which announced provider\n * key to route through for the best UX. Builds and registers the chain-\n * specific wallet provider only after pairing is approved; the provider\n * therefore never appears in the wallet picker (no `connect` method).\n *\n * @example\n * ```ts\n * const { uri, approval } = await connectWithMetaMaskUri({\n *   chain: 'EVM',\n *   getController: (client) => getEvmMetaMaskController(client),\n *   walletProviderBuilder: (client) => buildEvmWalletProvider(client),\n * });\n * // Render QR code with `uri`, then await approval()\n * ```\n *\n * @param params.chain - Chain being connected; used to scope the extension-installed lookup.\n * @param params.getController - Returns the chain-specific MetaMaskController for the pairing.\n * @param params.walletProviderBuilder - Builds the chain-specific WalletProvider after pairing approval.\n * @param [params.addToDynamicWalletAccounts] - Whether to add the wallet to the client. Defaults to `true`.\n * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.\n * @returns An object with `uri` (the pairing URI) and `approval` (async function resolving to wallet accounts).\n * @throws {MetaMaskDisplayUriMissingError} If `connect` settles before a display_uri is emitted.\n * @throws {NoAddressFoundError} If no address is returned after pairing approval.\n * @see clearMetaMaskSessionStorage\n * @see getMetaMaskExtensionWalletProviderKey\n * @notInstrumented\n */\nexport const connectWithMetaMaskUri = async (\n  {\n    addToDynamicWalletAccounts = true,\n    chain,\n    getController,\n    walletProviderBuilder,\n  }: ConnectWithMetaMaskUriParams,\n  client: DynamicClient = getDefaultClient()\n): Promise<WalletProviderUriConnectionResult> => {\n  const announcedKey = getMetaMaskExtensionWalletProviderKey({ chain }, client);\n\n  if (announcedKey !== undefined) {\n    getCore(client).logger.warn(\n      `[metamask] MetaMask extension is announced for ${chain} as wallet provider \"${announcedKey}\"; proceeding with URI pairing. Consider connectWithWalletProvider({ walletProviderKey: \"${announcedKey}\" }) for the best user experience.`\n    );\n  }\n\n  const controller = await getController(client);\n\n  const uriDeferred = createDeferredPromise<string>();\n\n  const unsubscribe = controller.onDisplayUri((displayUri) => {\n    uriDeferred.resolve(displayUri);\n  });\n\n  const connectPromise = controller.connect();\n\n  // If `connect` settles before a `display_uri` is emitted, no URI was made\n  // available and the pairing is unusable. Reject the deferred so the caller\n  // surfaces `MetaMaskDisplayUriMissingError` (or the underlying failure).\n  connectPromise\n    .then(() => {\n      uriDeferred.reject(new MetaMaskDisplayUriMissingError());\n    })\n    .catch((error: unknown) => {\n      uriDeferred.reject(error);\n    });\n\n  let uri: string;\n  try {\n    uri = await uriDeferred.promise;\n  } finally {\n    unsubscribe();\n  }\n\n  const approval = async (): Promise<{ walletAccounts: WalletAccount[] }> => {\n    await connectPromise;\n\n    const walletProvider = await walletProviderBuilder(client);\n\n    getWalletProviderRegistry(client).register({\n      priority: WalletProviderPriority.WALLET_SDK,\n      walletProvider,\n    });\n\n    const { addresses } = await walletProvider.getConnectedAddresses();\n\n    // MetaMask SDK exposes a single active address per pairing (same model as\n    // EIP-1193 `eth_accounts`); we only materialize the first one.\n    const mainAddress = addresses[0];\n\n    if (mainAddress === undefined) {\n      throw new NoAddressFoundError();\n    }\n\n    const walletAccount: WalletAccount = {\n      address: mainAddress,\n      chain: walletProvider.chain,\n      id: formatWalletAccountId({\n        address: mainAddress,\n        chain: walletProvider.chain,\n        walletProviderKey: walletProvider.key,\n      }),\n      lastSelectedAt: null,\n      verifiedCredentialId: null,\n      walletProviderKey: walletProvider.key,\n    };\n\n    const walletAccounts = reconcileWalletAccountsAgainstClient(\n      {\n        addToDynamicWalletAccounts,\n        walletAccounts: [walletAccount],\n        walletProviderKey: walletProvider.key,\n      },\n      client\n    );\n\n    return { walletAccounts };\n  };\n\n  return { approval, uri };\n};\n","import { BaseError } from '@dynamic-labs-sdk/client';\n\nexport class MetaMaskWalletNotConnectedError extends BaseError {\n  constructor() {\n    super({\n      cause: null,\n      code: 'metamask_wallet_not_connected',\n      docsUrl: null,\n      name: 'MetaMaskWalletNotConnectedError',\n      shortMessage:\n        'MetaMask SDK has no connected wallet account. Complete the URI pairing (await the connect approval) before building the MetaMask wallet provider.',\n    });\n  }\n}\n","import { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport { name, version } from '../../package.json';\n\nassertPackageVersion(name, version);\n\nexport { clearMetaMaskSessionStorage } from '../clearMetaMaskSessionStorage';\nexport { connectWithMetaMaskUri } from '../connectWithMetaMaskUri';\nexport type { ConnectWithMetaMaskUriParams } from '../connectWithMetaMaskUri';\nexport { MetaMaskDisplayUriMissingError } from '../errors/MetaMaskDisplayUriMissingError';\nexport { MetaMaskWalletNotConnectedError } from '../errors/MetaMaskWalletNotConnectedError';\nexport { getMetaMaskExtensionWalletProviderKey } from '../getMetaMaskExtensionWalletProviderKey';\nexport type {\n  DisplayUriListener,\n  MetaMaskController,\n} from '../metamask.types';\n"],"mappings":";;;;;;;;;;;;;;;;;;ACUA,MAAM,wBAAwB,IAAI,IAAI;CAEpC;CACA;CACA;CAGA;CAEA;CACA;CAEA;CACD,CAAC;;;;;AAMF,MAAM,gCAAgC;CAAC;CAAY;CAAU;CAAiB;AAE9E,MAAM,kCACJ;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BF,MAAa,8BAA8B,OAGzC,WACkB;AAClB,KAAI;EAMF,MAAM,gBALa,MAAM,aAAa,YAAY,EAKlB,QAC7B,QACC,sBAAsB,IAAI,IAAI,IAC9B,8BAA8B,MAAM,WAAW,IAAI,WAAW,OAAO,CAAC,CACzE;AAED,MAAI,aAAa,WAAW,EAC1B;AAGF,QAAM,aAAa,YAAY,aAAa;UACrC,OAAO;AAMd,UAAQ,OAAO,CAAC,OAAO,KAAK,iCAAiC,MAAM;;;;;;ACtFvE,IAAa,iCAAb,cAAoD,UAAU;CAC5D,cAAc;AACZ,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cACE;GACH,CAAC;;;;;;ACJN,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;AA+B7B,MAAa,yCACX,EAAE,SACF,SAAwB,kBAAkB,KACnB;AAYvB,QAXkB,0BAA0B,OAAO,CAAC,eAAe,CAE3C,MACrB,aACC,SAAS,UAAU,SACnB,SAAS,uBAAuB,mBAAmB,oBACnD,SAAS,SAAS,aACd,aAAa,CACd,SAAS,qBAAqB,CACpC,EAEa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACehB,MAAa,yBAAyB,OACpC,EACE,6BAA6B,MAC7B,OACA,eACA,yBAEF,SAAwB,kBAAkB,KACK;CAC/C,MAAM,eAAe,sCAAsC,EAAE,OAAO,EAAE,OAAO;AAE7E,KAAI,iBAAiB,OACnB,SAAQ,OAAO,CAAC,OAAO,KACrB,kDAAkD,MAAM,uBAAuB,aAAa,2FAA2F,aAAa,oCACrM;CAGH,MAAM,aAAa,MAAM,cAAc,OAAO;CAE9C,MAAM,cAAc,uBAA+B;CAEnD,MAAM,cAAc,WAAW,cAAc,eAAe;AAC1D,cAAY,QAAQ,WAAW;GAC/B;CAEF,MAAM,iBAAiB,WAAW,SAAS;AAK3C,gBACG,WAAW;AACV,cAAY,OAAO,IAAI,gCAAgC,CAAC;GACxD,CACD,OAAO,UAAmB;AACzB,cAAY,OAAO,MAAM;GACzB;CAEJ,IAAIA;AACJ,KAAI;AACF,QAAM,MAAM,YAAY;WAChB;AACR,eAAa;;CAGf,MAAM,WAAW,YAA0D;AACzE,QAAM;EAEN,MAAM,iBAAiB,MAAM,sBAAsB,OAAO;AAE1D,4BAA0B,OAAO,CAAC,SAAS;GACzC,UAAU,uBAAuB;GACjC;GACD,CAAC;EAEF,MAAM,EAAE,cAAc,MAAM,eAAe,uBAAuB;EAIlE,MAAM,cAAc,UAAU;AAE9B,MAAI,gBAAgB,OAClB,OAAM,IAAI,qBAAqB;AAyBjC,SAAO,EAAE,gBATc,qCACrB;GACE;GACA,gBAAgB,CAhBiB;IACnC,SAAS;IACT,OAAO,eAAe;IACtB,IAAI,sBAAsB;KACxB,SAAS;KACT,OAAO,eAAe;KACtB,mBAAmB,eAAe;KACnC,CAAC;IACF,gBAAgB;IAChB,sBAAsB;IACtB,mBAAmB,eAAe;IACnC,CAKkC;GAC/B,mBAAmB,eAAe;GACnC,EACD,OACD,EAEwB;;AAG3B,QAAO;EAAE;EAAU;EAAK;;;;;AC5J1B,IAAa,kCAAb,cAAqD,UAAU;CAC7D,cAAc;AACZ,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cACE;GACH,CAAC;;;;;;ACPN,qBAAqB,MAAM,QAAQ"}