@dynamic-labs-sdk/evm 1.3.0 → 1.5.0

package/dist/metamask.cjs

@@ -0,0 +1,317 @@
+const require_createWalletClientForWalletAccount = require('./createWalletClientForWalletAccount-CTDnbreU.cjs');
+const require_evmTransferAmount = require('./evmTransferAmount-Bb1YvuCX.cjs');
+const require_createWalletProviderFromEIP1193Provider = require('./createWalletProviderFromEIP1193Provider-_EtpThZ6.cjs');
+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_api_core = require("@dynamic-labs/sdk-api-core");
+let _dynamic_labs_sdk_metamask = require("@dynamic-labs-sdk/metamask");
+let _metamask_connect_evm = require("@metamask/connect-evm");
+
+//#region src/utils/getEvmNetworksData/getEvmNetworksData.ts
+/**
+* Returns the network configuration objects for the EVM networks configured
+* on the Dynamic client. Generic helper available to any EVM extension that
+* needs the full network metadata (RPC URLs, native currency, etc.) for the
+* configured EVM chain set — for instance, to build the `supportedNetworks`
+* map required by third-party SDKs such as MetaMask or Base Account.
+*
+* @param client - The Dynamic client whose project settings drive the result.
+* @not-instrumented
+*/
+const getEvmNetworksData = (client) => (0, _dynamic_labs_sdk_client.getNetworksData)(client).filter((network) => network.chain === "EVM");
+
+//#endregion
+//#region src/metamask/utils/getSupportedNetworks/getSupportedNetworks.ts
+/** @not-instrumented */
+const getSupportedNetworks = (client) => {
+	const evmNetworks = getEvmNetworksData(client).sort((a, b) => {
+		if (a.networkId === "1") return -1;
+		if (b.networkId === "1") return 1;
+		return 0;
+	});
+	(0, _dynamic_labs_sdk_client_core.assertNonEmptyArray)(evmNetworks, "No EVM networks have been configured. Make sure to add at least one EVM network to your project settings in the Dynamic Dashboard.");
+	const supportedNetworks = {};
+	for (const network of evmNetworks) {
+		const hexChainId = `0x${Number.parseInt(network.networkId, 10).toString(16)}`;
+		supportedNetworks[hexChainId] = network.rpcUrls.http[0];
+	}
+	return supportedNetworks;
+};
+
+//#endregion
+//#region src/metamask/utils/createMetaMaskEvmController/createMetaMaskEvmController.ts
+/**
+* Builds a fully-initialised `MetaMaskEvmController` for the given Dynamic
+* client. Runs the SDK in headless mode so consumers render their own QR /
+* deep-link surface, and registers `display_uri` handling as an
+* `eventHandlers` callback at construction time so the first URI emission
+* cannot be lost to a subscription race. Dapp metadata is sourced from the
+* client's `getAppMetadata`. Browser-only.
+*
+* @not-instrumented
+*/
+const createMetaMaskEvmController = async (client) => {
+	const supportedNetworks = getSupportedNetworks(client);
+	const { appName, appLogoUrl, appUniversalLink, appNativeLink } = (0, _dynamic_labs_sdk_client_core.getAppMetadata)(client);
+	await (0, _dynamic_labs_sdk_metamask.clearMetaMaskSessionStorage)();
+	const listeners = /* @__PURE__ */ new Set();
+	let latestDisplayUri;
+	const sdk = await (0, _metamask_connect_evm.createEVMClient)({
+		api: { supportedNetworks },
+		dapp: {
+			iconUrl: appLogoUrl,
+			name: appName,
+			nativeScheme: (0, _dynamic_labs_sdk_client_core.getNativeLinkScheme)({ nativeLink: appNativeLink }),
+			url: appUniversalLink ?? ""
+		},
+		debug: false,
+		eventHandlers: {
+			connect: () => {
+				latestDisplayUri = void 0;
+			},
+			disconnect: () => {
+				latestDisplayUri = void 0;
+			},
+			displayUri: (uri) => {
+				latestDisplayUri = uri;
+				for (const listener of listeners) listener(uri);
+			}
+		},
+		ui: {
+			headless: true,
+			preferExtension: true
+		}
+	});
+	latestDisplayUri = void 0;
+	const onDisplayUri = (listener) => {
+		listeners.add(listener);
+		if (latestDisplayUri !== void 0) listener(latestDisplayUri);
+		return () => {
+			listeners.delete(listener);
+		};
+	};
+	const chainIds = Object.keys(supportedNetworks);
+	let inFlightConnect = null;
+	const connect = () => {
+		if (inFlightConnect) return inFlightConnect;
+		inFlightConnect = (async () => {
+			try {
+				if (sdk.status === "connecting") try {
+					await sdk.disconnect();
+				} catch (error) {
+					(0, _dynamic_labs_sdk_client_core.getCore)(client).logger.debug("[metamask] pre-connect disconnect rejected (expected when aborting a pairing the wallet never accepted)", error);
+				}
+				await sdk.connect({ chainIds });
+			} finally {
+				inFlightConnect = null;
+			}
+		})();
+		return inFlightConnect;
+	};
+	return {
+		clearCachedDisplayUri: () => {
+			latestDisplayUri = void 0;
+		},
+		connect,
+		getLatestDisplayUri: () => latestDisplayUri,
+		onDisplayUri,
+		sdk
+	};
+};
+
+//#endregion
+//#region src/metamask/utils/getOrCreateMetaMaskEvmController/getOrCreateMetaMaskEvmController.ts
+const RUNTIME_SERVICE_KEY = "metaMaskEvmController";
+/**
+* Per-`DynamicClient` accessor for the lazily-constructed MetaMask EVM
+* controller. Wraps `createMetaMaskEvmController` with the standard
+* `runtimeServices` cache so every caller — the EIP-1193 wallet-provider
+* façade, the `display_uri` subscription helper, and the
+* `connectWithMetaMaskEvm` URI-returning helper — shares the same
+* controller (and therefore the same SDK instance, display-URI cache, and
+* listener registry) per Dynamic client.
+*
+* This matches the pattern used by the WalletConnect `getSignClient`
+* accessor: the first call triggers construction; subsequent calls
+* (within the same client) return the cached promise without re-running
+* the builder.
+*
+* The cache is **per-Dynamic-client, not per-SDK-instance**:
+* `@metamask/connect-evm`'s `createEVMClient` is itself a singleton —
+* a second call returns the same underlying SDK — so when multiple
+* Dynamic clients coexist they end up sharing the same MetaMask SDK
+* instance (and therefore the same active pairing session) regardless
+* of this cache. The wrapper exists to own the controller's
+* `display_uri` cache and listener registry per Dynamic client, which
+* the SDK itself does not expose.
+*
+* @not-instrumented
+*/
+const getOrCreateMetaMaskEvmController = (0, _dynamic_labs_sdk_client_core.createRuntimeServiceAccessKey)(RUNTIME_SERVICE_KEY, (client) => createMetaMaskEvmController(client));
+
+//#endregion
+//#region src/metamask/utils/subscribeMetaMaskEvmFacadeListener/subscribeMetaMaskEvmFacadeListener.ts
+const NOOP_UNSUBSCRIBE = () => void 0;
+/**
+* Subscribes a facade listener to the underlying MetaMask SDK provider,
+* forwarding events through per-event adapters:
+*
+* - `accountsChanged` — clones the readonly addresses array
+*   `@metamask/connect-evm` hands the listener, since the Dynamic SDK
+*   facade contract emits a mutable `Address[]`.
+* - `chainChanged` — passes the chain id through verbatim.
+* - `disconnected` — bridged to the SDK's canonical `disconnect`
+*   event, which the SDK actually emits.
+*
+* Returns the unsubscribe function returned by the SDK provider so the
+* caller can clean it up later (for example, when the facade's
+* `removeAllListeners` is invoked).
+*
+* @not-instrumented
+*/
+const subscribeMetaMaskEvmFacadeListener = ({ client, pending, provider }) => {
+	if (pending.event === "accountsChanged") return provider.on("accountsChanged", (addresses) => pending.listener([...addresses]));
+	if (pending.event === "chainChanged") return provider.on("chainChanged", (chainId) => pending.listener(chainId));
+	if (pending.event === "disconnected") return provider.on("disconnect", () => pending.listener());
+	const exhaustiveCheck = pending;
+	(0, _dynamic_labs_sdk_client_core.getCore)(client).logger.debug("[metamask] subscribeMetaMaskEvmFacadeListener: unhandled event", exhaustiveCheck.event);
+	return NOOP_UNSUBSCRIBE;
+};
+
+//#endregion
+//#region src/metamask/createMetaMaskEvmWalletProvider/createMetaMaskEvmWalletProvider.ts
+const METAMASK_DISPLAY_NAME = "MetaMask";
+const METAMASK_ICON = `${_dynamic_labs_sdk_client_core.DYNAMIC_ICONIC_SPRITE_URL}#metamask`;
+/**
+* Builds the `EvmWalletProvider` registered AFTER a successful MetaMask
+* SDK URI pairing. Wraps the SDK's EIP-1193 provider behind the Dynamic
+* facade (`disconnect` → `disconnected` event bridge, `removeAllListeners`
+* shim) and drops `connect` so the provider is filtered out of the
+* wallet picker by `getAvailableWalletProvidersData` — mirroring how
+* WalletConnect URI sessions register a signing-only provider.
+*
+* @not-instrumented
+*/
+const createMetaMaskEvmWalletProvider = async (client) => {
+	const controller = await getOrCreateMetaMaskEvmController(client);
+	if (controller.sdk.getAccount() === void 0) throw new _dynamic_labs_sdk_metamask.MetaMaskWalletNotConnectedError();
+	const provider = controller.sdk.getProvider();
+	const subscriberCleanups = /* @__PURE__ */ new Set();
+	return {
+		...require_createWalletProviderFromEIP1193Provider.createWalletProviderFromEIP1193Provider({
+			displayName: METAMASK_DISPLAY_NAME,
+			eip1193: {
+				on: (event, listener) => {
+					const pending = {
+						event,
+						listener
+					};
+					subscriberCleanups.add(subscribeMetaMaskEvmFacadeListener({
+						client,
+						pending,
+						provider
+					}));
+				},
+				removeAllListeners: () => {
+					for (const unsubscribe of subscriberCleanups) try {
+						unsubscribe();
+					} catch (error) {
+						(0, _dynamic_labs_sdk_client_core.getCore)(client).logger.error("[metamask] removeAllListeners: unsubscribe failed", error);
+					}
+					subscriberCleanups.clear();
+				},
+				request: (request) => provider.request(request)
+			},
+			icon: METAMASK_ICON,
+			walletProviderType: _dynamic_labs_sdk_api_core.WalletProviderEnum.QrCode
+		}, client),
+		connect: void 0
+	};
+};
+
+//#endregion
+//#region src/metamask/connectAndVerifyWithMetaMaskUriEvm/connectAndVerifyWithMetaMaskUriEvm.ts
+/**
+* Drives a MetaMask SDK URI pairing for EVM and verifies ownership of the
+* paired wallet account through message signing, returning `{ approval, uri }`
+* so consumers can render the QR / hand the URI to a deeplink.
+*
+* Unlike `connectAndVerifyWithWalletConnectEvm`, the MetaMask SDK does not
+* expose a single-round-trip authenticate primitive, so this drives two
+* sequential interactions on the wallet side: the user first approves the
+* pairing, then approves a sign-in message. The wallet account is added to
+* the Dynamic client as a verified credential (not as an unverified
+* account).
+*
+* @not-instrumented
+*/
+const connectAndVerifyWithMetaMaskUriEvm = async (client = (0, _dynamic_labs_sdk_client.getDefaultClient)()) => {
+	require_evmTransferAmount.registerEvmNetworkProviderBuilder(client);
+	const { approval, uri } = await (0, _dynamic_labs_sdk_metamask.connectWithMetaMaskUri)({
+		addToDynamicWalletAccounts: false,
+		chain: "EVM",
+		getController: getOrCreateMetaMaskEvmController,
+		walletProviderBuilder: createMetaMaskEvmWalletProvider
+	}, client);
+	const verifiedApproval = async () => {
+		const { walletAccounts } = await approval();
+		const [walletAccount] = walletAccounts;
+		if (walletAccount) await (0, _dynamic_labs_sdk_client.verifyWalletAccount)({ walletAccount }, client);
+		return { walletAccounts };
+	};
+	return {
+		approval: verifiedApproval,
+		uri
+	};
+};
+
+//#endregion
+//#region src/metamask/connectWithMetaMaskUriEvm/connectWithMetaMaskUriEvm.ts
+/**
+* Drives a MetaMask SDK URI pairing for EVM and returns `{ approval, uri }` so
+* consumers can render the QR / hand the URI to a deeplink. Logs an advisory
+* warning when the MetaMask extension is announced via EIP-6963; pairing still
+* proceeds, but the consumer is told which announced provider key to route
+* through for the best UX. The resulting wallet provider registers for signing
+* only and is never surfaced in the wallet picker.
+*
+* @not-instrumented
+*/
+const connectWithMetaMaskUriEvm = ({ addToDynamicWalletAccounts = true } = {}, client = (0, _dynamic_labs_sdk_client.getDefaultClient)()) => {
+	require_evmTransferAmount.registerEvmNetworkProviderBuilder(client);
+	return (0, _dynamic_labs_sdk_metamask.connectWithMetaMaskUri)({
+		addToDynamicWalletAccounts,
+		chain: "EVM",
+		getController: getOrCreateMetaMaskEvmController,
+		walletProviderBuilder: createMetaMaskEvmWalletProvider
+	}, client);
+};
+
+//#endregion
+//#region src/metamask/getMetaMaskEvmExtensionWalletProviderKey/getMetaMaskEvmExtensionWalletProviderKey.ts
+/**
+* Returns the wallet provider key of the MetaMask browser extension announced
+* for EVM, or `undefined` when none is announced. Pass the returned key to
+* `connectWithWalletProvider` to route through the announced provider; fall
+* back to `connectWithMetaMaskUriEvm` when `undefined`.
+*
+* @not-instrumented
+*/
+const getMetaMaskEvmExtensionWalletProviderKey = (client = (0, _dynamic_labs_sdk_client.getDefaultClient)()) => (0, _dynamic_labs_sdk_metamask.getMetaMaskExtensionWalletProviderKey)({ chain: "EVM" }, client);
+
+//#endregion
+//#region src/exports/metamask.ts
+(0, _dynamic_labs_sdk_assert_package_version.assertPackageVersion)(require_createWalletClientForWalletAccount.name, require_createWalletClientForWalletAccount.version);
+
+//#endregion
+Object.defineProperty(exports, 'MetaMaskDisplayUriMissingError', {
+  enumerable: true,
+  get: function () {
+    return _dynamic_labs_sdk_metamask.MetaMaskDisplayUriMissingError;
+  }
+});
+exports.connectAndVerifyWithMetaMaskUriEvm = connectAndVerifyWithMetaMaskUriEvm;
+exports.connectWithMetaMaskUriEvm = connectWithMetaMaskUriEvm;
+exports.getMetaMaskEvmExtensionWalletProviderKey = getMetaMaskEvmExtensionWalletProviderKey;
+//# sourceMappingURL=metamask.cjs.map

package/dist/metamask.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"metamask.cjs","names":["supportedNetworks: MetaMaskSupportedNetworks","latestDisplayUri: string | undefined","inFlightConnect: Promise<void> | null","exhaustiveCheck: never","DYNAMIC_ICONIC_SPRITE_URL","MetaMaskWalletNotConnectedError","createWalletProviderFromEIP1193Provider","WalletProviderEnum","packageName","packageVersion"],"sources":["../src/utils/getEvmNetworksData/getEvmNetworksData.ts","../src/metamask/utils/getSupportedNetworks/getSupportedNetworks.ts","../src/metamask/utils/createMetaMaskEvmController/createMetaMaskEvmController.ts","../src/metamask/utils/getOrCreateMetaMaskEvmController/getOrCreateMetaMaskEvmController.ts","../src/metamask/utils/subscribeMetaMaskEvmFacadeListener/subscribeMetaMaskEvmFacadeListener.ts","../src/metamask/createMetaMaskEvmWalletProvider/createMetaMaskEvmWalletProvider.ts","../src/metamask/connectAndVerifyWithMetaMaskUriEvm/connectAndVerifyWithMetaMaskUriEvm.ts","../src/metamask/connectWithMetaMaskUriEvm/connectWithMetaMaskUriEvm.ts","../src/metamask/getMetaMaskEvmExtensionWalletProviderKey/getMetaMaskEvmExtensionWalletProviderKey.ts","../src/exports/metamask.ts"],"sourcesContent":["import {\n  type DynamicClient,\n  type NetworkData,\n  getNetworksData,\n} from '@dynamic-labs-sdk/client';\n\n/**\n * Returns the network configuration objects for the EVM networks configured\n * on the Dynamic client. Generic helper available to any EVM extension that\n * needs the full network metadata (RPC URLs, native currency, etc.) for the\n * configured EVM chain set — for instance, to build the `supportedNetworks`\n * map required by third-party SDKs such as MetaMask or Base Account.\n *\n * @param client - The Dynamic client whose project settings drive the result.\n * @not-instrumented\n */\nexport const getEvmNetworksData = (client: DynamicClient): NetworkData[] =>\n  getNetworksData(client).filter((network) => network.chain === 'EVM');\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { assertNonEmptyArray } from '@dynamic-labs-sdk/client/core';\n\nimport { getEvmNetworksData } from '../../../utils/getEvmNetworksData';\n\ntype MetaMaskSupportedNetworks = Record<`0x${string}`, string>;\n\n/** @not-instrumented */\nexport const getSupportedNetworks = (\n  client: DynamicClient\n): MetaMaskSupportedNetworks => {\n  // Customer enabled networks, with mainnet first if available.\n  const evmNetworks = getEvmNetworksData(client).sort((a, b) => {\n    if (a.networkId === '1') return -1;\n    if (b.networkId === '1') return 1;\n\n    return 0;\n  });\n\n  assertNonEmptyArray(\n    evmNetworks,\n    'No EVM networks have been configured. Make sure to add at least one EVM network to your project settings in the Dynamic Dashboard.'\n  );\n\n  const supportedNetworks: MetaMaskSupportedNetworks = {};\n\n  for (const network of evmNetworks) {\n    const numericChainId = Number.parseInt(network.networkId, 10);\n    const hexChainId = `0x${numericChainId.toString(16)}` as `0x${string}`;\n    supportedNetworks[hexChainId] = network.rpcUrls.http[0];\n  }\n\n  return supportedNetworks;\n};\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport {\n  getAppMetadata,\n  getCore,\n  getNativeLinkScheme,\n} from '@dynamic-labs-sdk/client/core';\nimport { clearMetaMaskSessionStorage } from '@dynamic-labs-sdk/metamask';\nimport type { DisplayUriListener } from '@dynamic-labs-sdk/metamask';\nimport { createEVMClient } from '@metamask/connect-evm';\nimport type { Hex } from '@metamask/connect-evm';\n\nimport type { MetaMaskEvmController } from '../../metamask.types';\nimport { getSupportedNetworks } from '../getSupportedNetworks';\n\n/**\n * Builds a fully-initialised `MetaMaskEvmController` for the given Dynamic\n * client. Runs the SDK in headless mode so consumers render their own QR /\n * deep-link surface, and registers `display_uri` handling as an\n * `eventHandlers` callback at construction time so the first URI emission\n * cannot be lost to a subscription race. Dapp metadata is sourced from the\n * client's `getAppMetadata`. Browser-only.\n *\n * @not-instrumented\n */\nexport const createMetaMaskEvmController = async (\n  client: DynamicClient\n): Promise<MetaMaskEvmController> => {\n  const supportedNetworks = getSupportedNetworks(client);\n  const { appName, appLogoUrl, appUniversalLink, appNativeLink } =\n    getAppMetadata(client);\n\n  // Drop any IndexedDB session state left behind by a previous tab,\n  // page reload, or abandoned pairing before the SDK initialises. The\n  // SDK's auto-recovery path otherwise picks up a stale transport\n  // descriptor and spends its (non-configurable) 10-second resume\n  // timeout on every controller construction trying to revive a relay\n  // session that no longer exists, surfacing as a long QR skeleton\n  // delay on every page reload that follows an abandoned pairing.\n  await clearMetaMaskSessionStorage();\n\n  const listeners = new Set<DisplayUriListener>();\n  let latestDisplayUri: string | undefined;\n\n  const sdk = await createEVMClient({\n    api: { supportedNetworks },\n    dapp: {\n      iconUrl: appLogoUrl,\n      name: appName,\n      nativeScheme: getNativeLinkScheme({ nativeLink: appNativeLink }),\n      url: appUniversalLink ?? '',\n    },\n    debug: false,\n    eventHandlers: {\n      connect: () => {\n        latestDisplayUri = undefined;\n      },\n      disconnect: () => {\n        latestDisplayUri = undefined;\n      },\n      displayUri: (uri) => {\n        latestDisplayUri = uri;\n        for (const listener of listeners) {\n          listener(uri);\n        }\n      },\n    },\n    ui: {\n      headless: true,\n      preferExtension: true,\n    },\n  });\n\n  // Defensive cleanup: even though we cleared IndexedDB before\n  // constructing the SDK, an in-flight `display_uri` emission could\n  // theoretically race the storage delete on slow devices. Clearing\n  // the cache here guarantees late subscribers cannot replay an URI\n  // that originated from any pairing attempt prior to this\n  // construction.\n  latestDisplayUri = undefined;\n\n  const onDisplayUri = (listener: DisplayUriListener): (() => void) => {\n    listeners.add(listener);\n    if (latestDisplayUri !== undefined) {\n      listener(latestDisplayUri);\n    }\n    return () => {\n      listeners.delete(listener);\n    };\n  };\n\n  const chainIds = Object.keys(supportedNetworks) as Hex[];\n\n  // Tracks an in-flight `connect` call so that overlapping invocations (most\n  // commonly React's StrictMode double-invocation of effects, or a hook that\n  // re-runs while the user is still scanning) await the same underlying\n  // pairing instead of racing two `sdk.connect` calls against each other.\n  // Without this, the second invocation tears down the first via\n  // `sdk.disconnect()` and the SDK throws \"Cannot connect when state is\n  // CONNECTING\".\n  let inFlightConnect: Promise<void> | null = null;\n\n  const connect = (): Promise<void> => {\n    if (inFlightConnect) {\n      return inFlightConnect;\n    }\n\n    inFlightConnect = (async () => {\n      try {\n        // If a previous pairing was cancelled mid-flight the SDK can be left\n        // in `connecting` state with a dead transport descriptor; tear it\n        // down so the next `connect` issues a fresh URI synchronously\n        // instead of waiting for the SDK's (non-configurable) 10-second\n        // resume timeout.\n        if (sdk.status === 'connecting') {\n          try {\n            await sdk.disconnect();\n          } catch (error) {\n            getCore(client).logger.debug(\n              '[metamask] pre-connect disconnect rejected (expected when aborting a pairing the wallet never accepted)',\n              error\n            );\n          }\n        }\n\n        await sdk.connect({ chainIds });\n      } finally {\n        inFlightConnect = null;\n      }\n    })();\n\n    return inFlightConnect;\n  };\n\n  return {\n    clearCachedDisplayUri: () => {\n      latestDisplayUri = undefined;\n    },\n    connect,\n    getLatestDisplayUri: () => latestDisplayUri,\n    onDisplayUri,\n    sdk,\n  };\n};\n","import { createRuntimeServiceAccessKey } from '@dynamic-labs-sdk/client/core';\n\nimport { createMetaMaskEvmController } from '../createMetaMaskEvmController';\n\nconst RUNTIME_SERVICE_KEY = 'metaMaskEvmController';\n\n/**\n * Per-`DynamicClient` accessor for the lazily-constructed MetaMask EVM\n * controller. Wraps `createMetaMaskEvmController` with the standard\n * `runtimeServices` cache so every caller — the EIP-1193 wallet-provider\n * façade, the `display_uri` subscription helper, and the\n * `connectWithMetaMaskEvm` URI-returning helper — shares the same\n * controller (and therefore the same SDK instance, display-URI cache, and\n * listener registry) per Dynamic client.\n *\n * This matches the pattern used by the WalletConnect `getSignClient`\n * accessor: the first call triggers construction; subsequent calls\n * (within the same client) return the cached promise without re-running\n * the builder.\n *\n * The cache is **per-Dynamic-client, not per-SDK-instance**:\n * `@metamask/connect-evm`'s `createEVMClient` is itself a singleton —\n * a second call returns the same underlying SDK — so when multiple\n * Dynamic clients coexist they end up sharing the same MetaMask SDK\n * instance (and therefore the same active pairing session) regardless\n * of this cache. The wrapper exists to own the controller's\n * `display_uri` cache and listener registry per Dynamic client, which\n * the SDK itself does not expose.\n *\n * @not-instrumented\n */\nexport const getOrCreateMetaMaskEvmController = createRuntimeServiceAccessKey(\n  RUNTIME_SERVICE_KEY,\n  (client) => createMetaMaskEvmController(client)\n);\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport { getCore } from '@dynamic-labs-sdk/client/core';\nimport type {\n  Address,\n  Hex,\n  EIP1193Provider as SdkEip1193Provider,\n} from '@metamask/connect-evm';\n\nimport type { EIP1193ProviderEvents } from '../../../EvmWalletProvider.types';\n\nconst NOOP_UNSUBSCRIBE = (): void => undefined;\n\n/**\n * A facade listener captured by the MetaMask EVM wallet-provider facade.\n *\n * The discriminated-union shape (rather than `{ event: string; listener:\n * (...args: unknown[]) => void }`) is what lets\n * `subscribeMetaMaskEvmFacadeListener` narrow the listener type per\n * event, so the per-event adapters stay type-safe without casts.\n */\nexport type PendingMetaMaskEvmFacadeListener = {\n  [E in keyof EIP1193ProviderEvents]: {\n    event: E;\n    listener: EIP1193ProviderEvents[E];\n  };\n}[keyof EIP1193ProviderEvents];\n\n/**\n * Subscribes a facade listener to the underlying MetaMask SDK provider,\n * forwarding events through per-event adapters:\n *\n * - `accountsChanged` — clones the readonly addresses array\n *   `@metamask/connect-evm` hands the listener, since the Dynamic SDK\n *   facade contract emits a mutable `Address[]`.\n * - `chainChanged` — passes the chain id through verbatim.\n * - `disconnected` — bridged to the SDK's canonical `disconnect`\n *   event, which the SDK actually emits.\n *\n * Returns the unsubscribe function returned by the SDK provider so the\n * caller can clean it up later (for example, when the facade's\n * `removeAllListeners` is invoked).\n *\n * @not-instrumented\n */\nexport const subscribeMetaMaskEvmFacadeListener = ({\n  client,\n  pending,\n  provider,\n}: {\n  client: DynamicClient;\n  pending: PendingMetaMaskEvmFacadeListener;\n  provider: SdkEip1193Provider;\n}): (() => void) => {\n  if (pending.event === 'accountsChanged') {\n    return provider.on('accountsChanged', (addresses: readonly Address[]) =>\n      pending.listener([...addresses])\n    );\n  }\n\n  if (pending.event === 'chainChanged') {\n    return provider.on('chainChanged', (chainId: Hex) =>\n      pending.listener(chainId)\n    );\n  }\n\n  if (pending.event === 'disconnected') {\n    // The SDK emits its canonical `disconnect` event, which we bridge\n    // to the facade's `disconnected` contract here.\n    return provider.on('disconnect', () => pending.listener());\n  }\n\n  // Defensive fallthrough: a new entry was added to `EIP1193ProviderEvents`\n  // but the per-event adapter list above was not updated. We log the\n  // unhandled event and return a no-op unsubscribe so the consumer's\n  // teardown loop still runs cleanly.\n  const exhaustiveCheck: never = pending;\n  getCore(client).logger.debug(\n    '[metamask] subscribeMetaMaskEvmFacadeListener: unhandled event',\n    (exhaustiveCheck as { event: unknown }).event\n  );\n  return NOOP_UNSUBSCRIBE;\n};\n","import type { DynamicClient } from '@dynamic-labs-sdk/client';\nimport {\n  DYNAMIC_ICONIC_SPRITE_URL,\n  getCore,\n} from '@dynamic-labs-sdk/client/core';\nimport { MetaMaskWalletNotConnectedError } from '@dynamic-labs-sdk/metamask';\nimport { WalletProviderEnum } from '@dynamic-labs/sdk-api-core';\n\nimport type {\n  EIP1193Provider,\n  EIP1193ProviderEvents,\n  EIP1193ProviderRequest,\n  EvmWalletProvider,\n} from '../../EvmWalletProvider.types';\nimport { createWalletProviderFromEIP1193Provider } from '../../utils/createWalletProviderFromEIP1193Provider';\nimport { getOrCreateMetaMaskEvmController } from '../utils/getOrCreateMetaMaskEvmController';\nimport type { PendingMetaMaskEvmFacadeListener } from '../utils/subscribeMetaMaskEvmFacadeListener';\nimport { subscribeMetaMaskEvmFacadeListener } from '../utils/subscribeMetaMaskEvmFacadeListener';\n\nconst METAMASK_DISPLAY_NAME = 'MetaMask';\nconst METAMASK_ICON = `${DYNAMIC_ICONIC_SPRITE_URL}#metamask`;\n\n/**\n * Builds the `EvmWalletProvider` registered AFTER a successful MetaMask\n * SDK URI pairing. Wraps the SDK's EIP-1193 provider behind the Dynamic\n * facade (`disconnect` → `disconnected` event bridge, `removeAllListeners`\n * shim) and drops `connect` so the provider is filtered out of the\n * wallet picker by `getAvailableWalletProvidersData` — mirroring how\n * WalletConnect URI sessions register a signing-only provider.\n *\n * @not-instrumented\n */\nexport const createMetaMaskEvmWalletProvider = async (\n  client: DynamicClient\n): Promise<EvmWalletProvider> => {\n  const controller = await getOrCreateMetaMaskEvmController(client);\n\n  // The provider is only meaningful once the URI pairing has produced a\n  // connected account; guard so a premature or out-of-order call raises a\n  // readable error instead of building a provider around an unconnected SDK.\n  if (controller.sdk.getAccount() === undefined) {\n    throw new MetaMaskWalletNotConnectedError();\n  }\n\n  const provider = controller.sdk.getProvider();\n\n  const subscriberCleanups = new Set<() => void>();\n\n  const eip1193Provider: EIP1193Provider = {\n    // eslint-disable-next-line custom-rules/require-single-object-param -- EIP-1193 `on` signature is fixed by the interface contract.\n    on: <E extends keyof EIP1193ProviderEvents>(\n      event: E,\n      listener: EIP1193ProviderEvents[E]\n    ) => {\n      const pending = { event, listener } as PendingMetaMaskEvmFacadeListener;\n      subscriberCleanups.add(\n        subscribeMetaMaskEvmFacadeListener({ client, pending, provider })\n      );\n    },\n    removeAllListeners: () => {\n      for (const unsubscribe of subscriberCleanups) {\n        try {\n          unsubscribe();\n        } catch (error) {\n          getCore(client).logger.error(\n            '[metamask] removeAllListeners: unsubscribe failed',\n            error\n          );\n        }\n      }\n      subscriberCleanups.clear();\n    },\n    request: <T = unknown>(request: EIP1193ProviderRequest): Promise<T> =>\n      provider.request(request) as Promise<T>,\n  };\n\n  const walletProvider = createWalletProviderFromEIP1193Provider(\n    {\n      displayName: METAMASK_DISPLAY_NAME,\n      eip1193: eip1193Provider,\n      icon: METAMASK_ICON,\n      walletProviderType: WalletProviderEnum.QrCode,\n    },\n    client\n  );\n\n  return {\n    ...walletProvider,\n    connect: undefined,\n  };\n};\n","import {\n  type WalletAccount,\n  type WalletProviderUriConnectionResult,\n  getDefaultClient,\n  verifyWalletAccount,\n} from '@dynamic-labs-sdk/client';\nimport { connectWithMetaMaskUri } from '@dynamic-labs-sdk/metamask';\n\nimport { registerEvmNetworkProviderBuilder } from '../../registerEvmNetworkProviderBuilder';\nimport { createMetaMaskEvmWalletProvider } from '../createMetaMaskEvmWalletProvider';\nimport { getOrCreateMetaMaskEvmController } from '../utils/getOrCreateMetaMaskEvmController';\n\n/**\n * Drives a MetaMask SDK URI pairing for EVM and verifies ownership of the\n * paired wallet account through message signing, returning `{ approval, uri }`\n * so consumers can render the QR / hand the URI to a deeplink.\n *\n * Unlike `connectAndVerifyWithWalletConnectEvm`, the MetaMask SDK does not\n * expose a single-round-trip authenticate primitive, so this drives two\n * sequential interactions on the wallet side: the user first approves the\n * pairing, then approves a sign-in message. The wallet account is added to\n * the Dynamic client as a verified credential (not as an unverified\n * account).\n *\n * @not-instrumented\n */\nexport const connectAndVerifyWithMetaMaskUriEvm = async (\n  client = getDefaultClient()\n): Promise<WalletProviderUriConnectionResult> => {\n  registerEvmNetworkProviderBuilder(client);\n\n  const { approval, uri } = await connectWithMetaMaskUri(\n    {\n      addToDynamicWalletAccounts: false,\n      chain: 'EVM',\n      getController: getOrCreateMetaMaskEvmController,\n      walletProviderBuilder: createMetaMaskEvmWalletProvider,\n    },\n    client\n  );\n\n  const verifiedApproval = async (): Promise<{\n    walletAccounts: WalletAccount[];\n  }> => {\n    const { walletAccounts } = await approval();\n\n    // MetaMask SDK exposes a single active address per pairing (same\n    // model as EIP-1193 `eth_accounts`), mirroring how the underlying\n    // `connectWithMetaMaskUri` materializes a single account from\n    // `addresses[0]`. Verify it directly.\n    const [walletAccount] = walletAccounts;\n\n    if (walletAccount) {\n      await verifyWalletAccount({ walletAccount }, client);\n    }\n\n    return { walletAccounts };\n  };\n\n  return { approval: verifiedApproval, uri };\n};\n","import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport type { WalletProviderUriConnectionResult } from '@dynamic-labs-sdk/client';\nimport { connectWithMetaMaskUri } from '@dynamic-labs-sdk/metamask';\n\nimport { registerEvmNetworkProviderBuilder } from '../../registerEvmNetworkProviderBuilder';\nimport { createMetaMaskEvmWalletProvider } from '../createMetaMaskEvmWalletProvider';\nimport { getOrCreateMetaMaskEvmController } from '../utils/getOrCreateMetaMaskEvmController';\n\nexport type ConnectWithMetaMaskUriEvmParams = {\n  /** Whether to add the connected wallet account to the Dynamic client. Defaults to `true`. */\n  addToDynamicWalletAccounts?: boolean;\n};\n\n/**\n * Drives a MetaMask SDK URI pairing for EVM and returns `{ approval, uri }` so\n * consumers can render the QR / hand the URI to a deeplink. Logs an advisory\n * warning when the MetaMask extension is announced via EIP-6963; pairing still\n * proceeds, but the consumer is told which announced provider key to route\n * through for the best UX. The resulting wallet provider registers for signing\n * only and is never surfaced in the wallet picker.\n *\n * @not-instrumented\n */\nexport const connectWithMetaMaskUriEvm = (\n  { addToDynamicWalletAccounts = true }: ConnectWithMetaMaskUriEvmParams = {},\n  client = getDefaultClient()\n): Promise<WalletProviderUriConnectionResult> => {\n  registerEvmNetworkProviderBuilder(client);\n\n  return connectWithMetaMaskUri(\n    {\n      addToDynamicWalletAccounts,\n      chain: 'EVM',\n      getController: getOrCreateMetaMaskEvmController,\n      walletProviderBuilder: createMetaMaskEvmWalletProvider,\n    },\n    client\n  );\n};\n","import { getDefaultClient } from '@dynamic-labs-sdk/client';\nimport { getMetaMaskExtensionWalletProviderKey } from '@dynamic-labs-sdk/metamask';\n\n/**\n * Returns the wallet provider key of the MetaMask browser extension announced\n * for EVM, or `undefined` when none is announced. Pass the returned key to\n * `connectWithWalletProvider` to route through the announced provider; fall\n * back to `connectWithMetaMaskUriEvm` when `undefined`.\n *\n * @not-instrumented\n */\nexport const getMetaMaskEvmExtensionWalletProviderKey = (\n  client = getDefaultClient()\n): string | undefined =>\n  getMetaMaskExtensionWalletProviderKey({ chain: 'EVM' }, client);\n","import { assertPackageVersion } from '@dynamic-labs-sdk/assert-package-version';\n\nimport {\n  name as packageName,\n  version as packageVersion,\n} from '../../package.json';\nassertPackageVersion(packageName, packageVersion);\n\nexport { connectAndVerifyWithMetaMaskUriEvm } from '../metamask/connectAndVerifyWithMetaMaskUriEvm';\nexport { connectWithMetaMaskUriEvm } from '../metamask/connectWithMetaMaskUriEvm';\nexport type { ConnectWithMetaMaskUriEvmParams } from '../metamask/connectWithMetaMaskUriEvm/connectWithMetaMaskUriEvm';\nexport { getMetaMaskEvmExtensionWalletProviderKey } from '../metamask/getMetaMaskEvmExtensionWalletProviderKey';\nexport { MetaMaskDisplayUriMissingError } from '@dynamic-labs-sdk/metamask';\n"],"mappings":"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"}