@dynamic-labs-sdk/metamask 0.0.0 → 1.5.0

package/README.md

@@ -0,0 +1,19 @@
+# @dynamic-labs-sdk/metamask
+
+Chain-agnostic primitives for integrating the
+[MetaMask SDK](https://docs.metamask.io/sdk/) (`@metamask/connect-multichain`
+and its chain-specific facades such as `@metamask/connect-evm`) with the
+Dynamic JS SDK.
+
+This package is intended to be consumed by Dynamic's chain-specific
+packages (`@dynamic-labs-sdk/evm`, `@dynamic-labs-sdk/solana`, …) and
+exposes the building blocks they share — the extension-installed
+guard, the IndexedDB session reset, the connect orchestration that
+returns a `{ approval, uri }` pair, and a thin `MetaMaskController`
+interface that chain-specific glue implements on top of the
+chain-specific MetaMask SDK.
+
+Application code should usually import from a chain-specific
+sub-entrypoint instead, e.g. `@dynamic-labs-sdk/evm/metamask`, which
+re-exports a chain-bound `connectWithMetaMaskEvm` /
+`isMetaMaskExtensionInstalled` etc.

package/dist/clearMetaMaskSessionStorage/clearMetaMaskSessionStorage.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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
+ * 10-second resume timeout reviving a dead pairing. Safe in SSR (no-op) and
+ * when the DB is held open by another tab (resolves on `blocked`).
+ *
+ * @not-instrumented
+ */
+export declare const clearMetaMaskSessionStorage: () => Promise<void>;
+//# sourceMappingURL=clearMetaMaskSessionStorage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clearMetaMaskSessionStorage.d.ts","sourceRoot":"","sources":["../../src/clearMetaMaskSessionStorage/clearMetaMaskSessionStorage.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,QAAO,OAAO,CAAC,IAAI,CAsB1D,CAAC"}

package/dist/clearMetaMaskSessionStorage/index.d.ts

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

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

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

package/dist/connectWithMetaMaskUri/connectWithMetaMaskUri.d.ts

@@ -0,0 +1,30 @@
+import type { Chain, DynamicClient, WalletProviderUriConnectionResult } from '@dynamic-labs-sdk/client';
+import type { WalletProvider } from '@dynamic-labs-sdk/client/core';
+import type { MetaMaskController } from '../metamask.types';
+export type ConnectWithMetaMaskUriParams = {
+    /** Whether to add the connected wallet account to the Dynamic client. Defaults to `true`. */
+    addToDynamicWalletAccounts?: boolean;
+    /** Chain being connected; used to scope the extension-installed lookup. */
+    chain: Chain;
+    /** Returns the chain-specific `MetaMaskController` that drives the pairing. */
+    getController: (client: DynamicClient) => Promise<MetaMaskController>;
+    /**
+     * Builds the chain-specific `WalletProvider` AFTER the pairing has been
+     * approved. Must NOT include a `connect` method — the provider is registered
+     * purely for signing routing and would otherwise leak into the wallet picker.
+     */
+    walletProviderBuilder: (client: DynamicClient) => Promise<WalletProvider>;
+};
+/**
+ * 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).
+ *
+ * @not-instrumented
+ */
+export declare const connectWithMetaMaskUri: ({ addToDynamicWalletAccounts, chain, getController, walletProviderBuilder, }: ConnectWithMetaMaskUriParams, client?: DynamicClient) => Promise<WalletProviderUriConnectionResult>;
+//# sourceMappingURL=connectWithMetaMaskUri.d.ts.map

package/dist/connectWithMetaMaskUri/connectWithMetaMaskUri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectWithMetaMaskUri.d.ts","sourceRoot":"","sources":["../../src/connectWithMetaMaskUri/connectWithMetaMaskUri.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,aAAa,EAEb,iCAAiC,EAClC,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAapE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,MAAM,4BAA4B,GAAG;IACzC,6FAA6F;IAC7F,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,2EAA2E;IAC3E,KAAK,EAAE,KAAK,CAAC;IACb,+EAA+E;IAC/E,aAAa,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtE;;;;OAIG;IACH,qBAAqB,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CAC3E,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,iFAM9B,4BAA4B,WACvB,aAAa,KACpB,OAAO,CAAC,iCAAiC,CAmF3C,CAAC"}

package/dist/connectWithMetaMaskUri/index.d.ts

@@ -0,0 +1,3 @@
+export { connectWithMetaMaskUri } from './connectWithMetaMaskUri';
+export type { ConnectWithMetaMaskUriParams } from './connectWithMetaMaskUri';
+//# sourceMappingURL=index.d.ts.map

package/dist/connectWithMetaMaskUri/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connectWithMetaMaskUri/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/errors/MetaMaskDisplayUriMissingError/MetaMaskDisplayUriMissingError.d.ts

@@ -0,0 +1,5 @@
+import { BaseError } from '@dynamic-labs-sdk/client';
+export declare class MetaMaskDisplayUriMissingError extends BaseError {
+    constructor();
+}
+//# sourceMappingURL=MetaMaskDisplayUriMissingError.d.ts.map

package/dist/errors/MetaMaskDisplayUriMissingError/MetaMaskDisplayUriMissingError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetaMaskDisplayUriMissingError.d.ts","sourceRoot":"","sources":["../../../src/errors/MetaMaskDisplayUriMissingError/MetaMaskDisplayUriMissingError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,qBAAa,8BAA+B,SAAQ,SAAS;;CAW5D"}

package/dist/errors/MetaMaskDisplayUriMissingError/index.d.ts

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

package/dist/errors/MetaMaskDisplayUriMissingError/index.d.ts.map

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

package/dist/errors/MetaMaskWalletNotConnectedError/MetaMaskWalletNotConnectedError.d.ts

@@ -0,0 +1,5 @@
+import { BaseError } from '@dynamic-labs-sdk/client';
+export declare class MetaMaskWalletNotConnectedError extends BaseError {
+    constructor();
+}
+//# sourceMappingURL=MetaMaskWalletNotConnectedError.d.ts.map

package/dist/errors/MetaMaskWalletNotConnectedError/MetaMaskWalletNotConnectedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetaMaskWalletNotConnectedError.d.ts","sourceRoot":"","sources":["../../../src/errors/MetaMaskWalletNotConnectedError/MetaMaskWalletNotConnectedError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,qBAAa,+BAAgC,SAAQ,SAAS;;CAW7D"}

package/dist/errors/MetaMaskWalletNotConnectedError/index.d.ts

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

package/dist/errors/MetaMaskWalletNotConnectedError/index.d.ts.map

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

package/dist/exports/index.d.ts

@@ -0,0 +1,8 @@
+export { clearMetaMaskSessionStorage } from '../clearMetaMaskSessionStorage';
+export { connectWithMetaMaskUri } from '../connectWithMetaMaskUri';
+export type { ConnectWithMetaMaskUriParams } from '../connectWithMetaMaskUri';
+export { MetaMaskDisplayUriMissingError } from '../errors/MetaMaskDisplayUriMissingError';
+export { MetaMaskWalletNotConnectedError } from '../errors/MetaMaskWalletNotConnectedError';
+export { getMetaMaskExtensionWalletProviderKey } from '../getMetaMaskExtensionWalletProviderKey';
+export type { DisplayUriListener, MetaMaskController, } from '../metamask.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/exports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exports/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,YAAY,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,8BAA8B,EAAE,MAAM,0CAA0C,CAAC;AAC1F,OAAO,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAAE,qCAAqC,EAAE,MAAM,0CAA0C,CAAC;AACjG,YAAY,EACV,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC"}

package/dist/getMetaMaskExtensionWalletProviderKey/getMetaMaskExtensionWalletProviderKey.d.ts

@@ -0,0 +1,19 @@
+import type { Chain, DynamicClient } from '@dynamic-labs-sdk/client';
+type GetMetaMaskExtensionWalletProviderKeyParams = {
+    /** Chain to scope the lookup to. */
+    chain: Chain;
+};
+/**
+ * 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`.
+ *
+ * @not-instrumented
+ */
+export declare const getMetaMaskExtensionWalletProviderKey: ({ chain }: GetMetaMaskExtensionWalletProviderKeyParams, client?: DynamicClient) => string | undefined;
+export {};
+//# sourceMappingURL=getMetaMaskExtensionWalletProviderKey.d.ts.map

package/dist/getMetaMaskExtensionWalletProviderKey/getMetaMaskExtensionWalletProviderKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMetaMaskExtensionWalletProviderKey.d.ts","sourceRoot":"","sources":["../../src/getMetaMaskExtensionWalletProviderKey/getMetaMaskExtensionWalletProviderKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AASrE,KAAK,2CAA2C,GAAG;IACjD,oCAAoC;IACpC,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qCAAqC,cACrC,2CAA2C,WAC9C,aAAa,KACpB,MAAM,GAAG,SAaX,CAAC"}

package/dist/getMetaMaskExtensionWalletProviderKey/index.d.ts

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

package/dist/getMetaMaskExtensionWalletProviderKey/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/getMetaMaskExtensionWalletProviderKey/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/index.cjs

@@ -0,0 +1,157 @@
+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");
+
+//#region package.json
+var name = "@dynamic-labs-sdk/metamask";
+var version = "1.5.0";
+
+//#endregion
+//#region src/clearMetaMaskSessionStorage/clearMetaMaskSessionStorage.ts
+const METAMASK_SDK_IDB_NAME = "mmconnect-kv-store";
+/**
+* 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
+* 10-second resume timeout reviving a dead pairing. Safe in SSR (no-op) and
+* when the DB is held open by another tab (resolves on `blocked`).
+*
+* @not-instrumented
+*/
+const clearMetaMaskSessionStorage = () => {
+	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.onblocked = () => resolve();
+		} catch {
+			resolve();
+		}
+	});
+};
+
+//#endregion
+//#region src/errors/MetaMaskDisplayUriMissingError/MetaMaskDisplayUriMissingError.ts
+var MetaMaskDisplayUriMissingError = class extends _dynamic_labs_sdk_client.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`.
+*
+* @not-instrumented
+*/
+const getMetaMaskExtensionWalletProviderKey = ({ chain }, client = (0, _dynamic_labs_sdk_client_core.getDefaultClient)()) => {
+	return (0, _dynamic_labs_sdk_client_core.getWalletProviderRegistry)(client).listProviders().find((provider) => provider.chain === chain && provider.walletProviderType === _dynamic_labs_sdk_api_core.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).
+*
+* @not-instrumented
+*/
+const connectWithMetaMaskUri = async ({ addToDynamicWalletAccounts = true, chain, getController, walletProviderBuilder }, client = (0, _dynamic_labs_sdk_client_core.getDefaultClient)()) => {
+	const announcedKey = getMetaMaskExtensionWalletProviderKey({ chain }, client);
+	if (announcedKey !== void 0) (0, _dynamic_labs_sdk_client_core.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 = (0, _dynamic_labs_sdk_client_core.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);
+		(0, _dynamic_labs_sdk_client_core.getWalletProviderRegistry)(client).register({
+			priority: _dynamic_labs_sdk_client_core.WalletProviderPriority.WALLET_SDK,
+			walletProvider
+		});
+		const { addresses } = await walletProvider.getConnectedAddresses();
+		const mainAddress = addresses[0];
+		if (mainAddress === void 0) throw new _dynamic_labs_sdk_client.NoAddressFoundError();
+		return { walletAccounts: (0, _dynamic_labs_sdk_client_core.reconcileWalletAccountsAgainstClient)({
+			addToDynamicWalletAccounts,
+			walletAccounts: [{
+				address: mainAddress,
+				chain: walletProvider.chain,
+				id: (0, _dynamic_labs_sdk_client_core.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 _dynamic_labs_sdk_client.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
+(0, _dynamic_labs_sdk_assert_package_version.assertPackageVersion)(name, version);
+
+//#endregion
+exports.MetaMaskDisplayUriMissingError = MetaMaskDisplayUriMissingError;
+exports.MetaMaskWalletNotConnectedError = MetaMaskWalletNotConnectedError;
+exports.clearMetaMaskSessionStorage = clearMetaMaskSessionStorage;
+exports.connectWithMetaMaskUri = connectWithMetaMaskUri;
+exports.getMetaMaskExtensionWalletProviderKey = getMetaMaskExtensionWalletProviderKey;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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 * @not-instrumented\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 * @not-instrumented\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 * @not-instrumented\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;;;;;;;;;AAU9B,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;;;;;ACjCJ,IAAa,iCAAb,cAAoDA,mCAAU;CAC5D,cAAc;AACZ,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cACE;GACH,CAAC;;;;;;ACJN,MAAM,uBAAuB;;;;;;;;;;;;AAkB7B,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;;;;;;;;;;;;;;;;ACQhB,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;;;;;ACxI1B,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

@@ -0,0 +1,153 @@
+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 { WalletProviderEnum } from "@dynamic-labs/sdk-api-core";
+
+//#region package.json
+var name = "@dynamic-labs-sdk/metamask";
+var version = "1.5.0";
+
+//#endregion
+//#region src/clearMetaMaskSessionStorage/clearMetaMaskSessionStorage.ts
+const METAMASK_SDK_IDB_NAME = "mmconnect-kv-store";
+/**
+* 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
+* 10-second resume timeout reviving a dead pairing. Safe in SSR (no-op) and
+* when the DB is held open by another tab (resolves on `blocked`).
+*
+* @not-instrumented
+*/
+const clearMetaMaskSessionStorage = () => {
+	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.onblocked = () => resolve();
+		} catch {
+			resolve();
+		}
+	});
+};
+
+//#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`.
+*
+* @not-instrumented
+*/
+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).
+*
+* @not-instrumented
+*/
+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.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +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 * @not-instrumented\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 * @not-instrumented\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 * @not-instrumented\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;;;;;;;;;AAU9B,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;;;;;ACjCJ,IAAa,iCAAb,cAAoD,UAAU;CAC5D,cAAc;AACZ,QAAM;GACJ,OAAO;GACP,MAAM;GACN,SAAS;GACT,MAAM;GACN,cACE;GACH,CAAC;;;;;;ACJN,MAAM,uBAAuB;;;;;;;;;;;;AAkB7B,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;;;;;;;;;;;;;;;;ACQhB,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;;;;;ACxI1B,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/metamask.types.d.ts

@@ -0,0 +1,23 @@
+/** Listener invoked with each MetaMask SDK pairing `display_uri` emission. */
+export type DisplayUriListener = (uri: string) => void;
+/**
+ * Chain-agnostic surface chain-specific packages adapt their MetaMask SDK
+ * instance to (e.g. `@metamask/connect-evm`, `@metamask/connect-solana`).
+ * Owns the SDK pairing drive (`connect`) and the cached-`display_uri`
+ * bookkeeping (`onDisplayUri` / `getLatestDisplayUri` / `clearCachedDisplayUri`).
+ */
+export type MetaMaskController = {
+    /** Drops the cached `display_uri` value without touching the SDK. */
+    clearCachedDisplayUri: () => void;
+    /**
+     * Drives the SDK pairing. Implementations should clear any stale
+     * "connecting" state on the underlying SDK first. Resolves once the
+     * pairing is approved by the wallet; rejects on rejection / timeout.
+     */
+    connect: () => Promise<void>;
+    /** Returns the latest URI captured by the SDK's `displayUri` handler, or `undefined`. */
+    getLatestDisplayUri: () => string | undefined;
+    /** Subscribes to `display_uri` emissions and replays the latest cached URI. Returns an unsubscribe. */
+    onDisplayUri: (listener: DisplayUriListener) => () => void;
+};
+//# sourceMappingURL=metamask.types.d.ts.map

package/dist/metamask.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metamask.types.d.ts","sourceRoot":"","sources":["../src/metamask.types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,qEAAqE;IACrE,qBAAqB,EAAE,MAAM,IAAI,CAAC;IAClC;;;;OAIG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,yFAAyF;IACzF,mBAAmB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC9C,uGAAuG;IACvG,YAAY,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,MAAM,IAAI,CAAC;CAC5D,CAAC"}