@metamask/connect-evm 1.3.1 → 2.0.0

package/dist/src/eip6963.js

@@ -0,0 +1,297 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _EIP6963ProviderAnnouncer_instances, _EIP6963ProviderAnnouncer_provider, _EIP6963ProviderAnnouncer_detail, _EIP6963ProviderAnnouncer_suppressed, _EIP6963ProviderAnnouncer_requestHandler, _EIP6963ProviderAnnouncer_announcementPromise, _EIP6963ProviderAnnouncer_announceOnce, _EIP6963ProviderAnnouncer_installRequestProviderListener, _EIP6963ProviderAnnouncer_dispatchAnnouncement;
+import metamaskFoxIcon from './assets/metamask-fox.svg';
+import { logger } from './logger';
+/**
+ * EIP-6963 event name wallets use to announce providers to dapps.
+ */
+export const EIP6963_ANNOUNCE_PROVIDER_EVENT = 'eip6963:announceProvider';
+/**
+ * EIP-6963 event name dapps dispatch to request wallet re-announcements.
+ */
+export const EIP6963_REQUEST_PROVIDER_EVENT = 'eip6963:requestProvider';
+/**
+ * Time to wait after requesting EIP-6963 providers before deciding whether a
+ * native MetaMask provider is present.
+ */
+export const EIP6963_DETECTION_TIMEOUT_MS = 300;
+/**
+ * Display name used for the MMConnect-managed MetaMask EIP-6963 provider.
+ */
+export const CONNECT_EVM_EIP6963_NAME = 'MetaMask';
+/**
+ * Reverse-DNS identifier used for the MMConnect-managed MetaMask EIP-6963 provider.
+ */
+export const CONNECT_EVM_EIP6963_RDNS = 'io.metamask.mmc';
+/**
+ * Native MetaMask EIP-6963 identifiers that should suppress SDK announcement.
+ */
+export const METAMASK_EIP6963_RDNS = [
+    'io.metamask',
+    'io.metamask.mobile',
+];
+/**
+ * Icon URI used for the MMConnect-managed MetaMask EIP-6963 provider.
+ */
+export const CONNECT_EVM_EIP6963_ICON = metamaskFoxIcon;
+/**
+ * Gets the current browser window when EIP-6963 events can be used.
+ *
+ * This intentionally uses the current `window`; it does not attempt to bridge
+ * to `window.top`. EIP-6963 discovery is scoped to the frame where the SDK is
+ * running.
+ *
+ * @returns The current browser window, or undefined outside a browser context.
+ */
+const getBrowserWindow = () => {
+    const { window: browserWindow } = globalThis;
+    return typeof (browserWindow === null || browserWindow === void 0 ? void 0 : browserWindow.dispatchEvent) === 'function'
+        ? browserWindow
+        : undefined;
+};
+const delay = (ms) => __awaiter(void 0, void 0, void 0, function* () { return yield new Promise((resolve) => setTimeout(resolve, ms)); });
+const isNativeMetaMaskRdns = (rdns) => METAMASK_EIP6963_RDNS.some((nativeRdns) => nativeRdns === rdns);
+const getAnnouncementRdns = (event) => {
+    var _a;
+    const { detail } = event;
+    const rdns = (_a = detail === null || detail === void 0 ? void 0 : detail.info) === null || _a === void 0 ? void 0 : _a.rdns;
+    return typeof rdns === 'string' ? rdns : undefined;
+};
+const UUID_BYTE_TO_HEX = Array.from({ length: 256 }, (_, byte) => byte.toString(16).padStart(2, '0'));
+/**
+ * Formats random bytes as an RFC 4122 version 4 UUID.
+ *
+ * @param bytes - Random bytes from a cryptographically secure source.
+ * @returns A UUID string.
+ */
+const formatUuidV4 = (bytes) => {
+    bytes[6] = (bytes[6] % 16) + 64;
+    bytes[8] = (bytes[8] % 64) + 128;
+    return [
+        UUID_BYTE_TO_HEX[bytes[0]],
+        UUID_BYTE_TO_HEX[bytes[1]],
+        UUID_BYTE_TO_HEX[bytes[2]],
+        UUID_BYTE_TO_HEX[bytes[3]],
+        '-',
+        UUID_BYTE_TO_HEX[bytes[4]],
+        UUID_BYTE_TO_HEX[bytes[5]],
+        '-',
+        UUID_BYTE_TO_HEX[bytes[6]],
+        UUID_BYTE_TO_HEX[bytes[7]],
+        '-',
+        UUID_BYTE_TO_HEX[bytes[8]],
+        UUID_BYTE_TO_HEX[bytes[9]],
+        '-',
+        UUID_BYTE_TO_HEX[bytes[10]],
+        UUID_BYTE_TO_HEX[bytes[11]],
+        UUID_BYTE_TO_HEX[bytes[12]],
+        UUID_BYTE_TO_HEX[bytes[13]],
+        UUID_BYTE_TO_HEX[bytes[14]],
+        UUID_BYTE_TO_HEX[bytes[15]],
+    ].join('');
+};
+/**
+ * Creates a UUID for the EIP-6963 provider identity.
+ *
+ * Requires Web Crypto. EIP-6963 discovery is browser-only, and unsupported
+ * browsers should fail this best-effort announcement path rather than receive a
+ * weak UUID.
+ *
+ * @returns A UUID string.
+ */
+const createUuid = () => {
+    const { crypto: cryptoProvider } = globalThis;
+    if (cryptoProvider === null || cryptoProvider === void 0 ? void 0 : cryptoProvider.randomUUID) {
+        return cryptoProvider.randomUUID();
+    }
+    if (cryptoProvider === null || cryptoProvider === void 0 ? void 0 : cryptoProvider.getRandomValues) {
+        const bytes = new Uint8Array(16);
+        cryptoProvider.getRandomValues(bytes);
+        return formatUuidV4(bytes);
+    }
+    throw new Error('Web Crypto API is required for EIP-6963 announcement');
+};
+/**
+ * Creates a DOM custom event with an EIP-6963 announcement payload.
+ *
+ * @param detail - The provider announcement detail.
+ * @returns A custom event containing the announcement detail.
+ */
+const createAnnouncementEvent = (detail) => {
+    const { CustomEvent: CustomEventConstructor } = globalThis;
+    return new CustomEventConstructor(EIP6963_ANNOUNCE_PROVIDER_EVENT, {
+        detail,
+    });
+};
+/**
+ * Creates a DOM event requesting EIP-6963 providers to re-announce.
+ *
+ * @returns A request-provider event.
+ */
+const createRequestProviderEvent = () => {
+    const { Event: EventConstructor } = globalThis;
+    return new EventConstructor(EIP6963_REQUEST_PROVIDER_EVENT);
+};
+/**
+ * Creates immutable metadata for one SDK provider identity.
+ *
+ * @returns Provider metadata for EIP-6963 announcement.
+ */
+const createProviderInfo = () => Object.freeze({
+    uuid: createUuid(),
+    name: CONNECT_EVM_EIP6963_NAME,
+    icon: CONNECT_EVM_EIP6963_ICON,
+    rdns: CONNECT_EVM_EIP6963_RDNS,
+});
+/**
+ * Checks whether native MetaMask has already announced through EIP-6963.
+ *
+ * The listener is installed before dispatching `requestProvider` so wallets
+ * that announce synchronously in response to the request are observed.
+ *
+ * @returns True when a native MetaMask provider rdns was observed.
+ */
+const hasNativeMetaMaskProvider = () => __awaiter(void 0, void 0, void 0, function* () {
+    const browserWindow = getBrowserWindow();
+    if (!browserWindow) {
+        return false;
+    }
+    const announcedRdns = new Set();
+    const handler = (event) => {
+        const rdns = getAnnouncementRdns(event);
+        if (rdns) {
+            announcedRdns.add(rdns);
+        }
+    };
+    browserWindow.addEventListener(EIP6963_ANNOUNCE_PROVIDER_EVENT, handler);
+    try {
+        browserWindow.dispatchEvent(createRequestProviderEvent());
+        yield delay(EIP6963_DETECTION_TIMEOUT_MS);
+    }
+    finally {
+        browserWindow.removeEventListener(EIP6963_ANNOUNCE_PROVIDER_EVENT, handler);
+    }
+    return [...announcedRdns].some(isNativeMetaMaskRdns);
+});
+/**
+ * Announces an MMConnect-managed EIP-1193 provider through EIP-6963.
+ *
+ * Announcement is best-effort and browser-only. Native MetaMask providers with
+ * `io.metamask` or `io.metamask.mobile` suppress this SDK provider to avoid
+ * duplicate MetaMask entries in wallet pickers.
+ */
+export class EIP6963ProviderAnnouncer {
+    /**
+     * Creates an EIP-6963 announcer for one SDK provider instance.
+     *
+     * @param provider - EIP-1193 provider to announce.
+     */
+    constructor(provider) {
+        _EIP6963ProviderAnnouncer_instances.add(this);
+        /** EIP-1193 provider exposed in EIP-6963 announcements. */
+        _EIP6963ProviderAnnouncer_provider.set(this, void 0);
+        /** Stable announcement payload for this SDK provider instance. */
+        _EIP6963ProviderAnnouncer_detail.set(this, void 0);
+        /** Whether native MetaMask detection already suppressed this provider. */
+        _EIP6963ProviderAnnouncer_suppressed.set(this, false);
+        /** Listener used to re-announce the SDK provider on future requests. */
+        _EIP6963ProviderAnnouncer_requestHandler.set(this, void 0);
+        /** In-flight announcement detection promise, shared by concurrent calls. */
+        _EIP6963ProviderAnnouncer_announcementPromise.set(this, void 0);
+        __classPrivateFieldSet(this, _EIP6963ProviderAnnouncer_provider, provider, "f");
+    }
+    /**
+     * Announces the SDK provider unless native MetaMask has already announced.
+     *
+     * Repeated calls are idempotent: once announced, this re-dispatches the same
+     * provider detail and does not install duplicate request listeners. The first
+     * call may take up to `EIP6963_DETECTION_TIMEOUT_MS` while native providers
+     * are requested.
+     *
+     * @returns A promise that resolves once detection and any announcement finish.
+     */
+    announce() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (__classPrivateFieldGet(this, _EIP6963ProviderAnnouncer_suppressed, "f")) {
+                    return;
+                }
+                if (__classPrivateFieldGet(this, _EIP6963ProviderAnnouncer_detail, "f")) {
+                    __classPrivateFieldGet(this, _EIP6963ProviderAnnouncer_instances, "m", _EIP6963ProviderAnnouncer_dispatchAnnouncement).call(this);
+                    return;
+                }
+                if (!__classPrivateFieldGet(this, _EIP6963ProviderAnnouncer_announcementPromise, "f")) {
+                    __classPrivateFieldSet(this, _EIP6963ProviderAnnouncer_announcementPromise, __classPrivateFieldGet(this, _EIP6963ProviderAnnouncer_instances, "m", _EIP6963ProviderAnnouncer_announceOnce).call(this)
+                        .catch((error) => {
+                        logger('EIP-6963 provider announcement failed', error);
+                    })
+                        .finally(() => {
+                        __classPrivateFieldSet(this, _EIP6963ProviderAnnouncer_announcementPromise, undefined, "f");
+                    }), "f");
+                }
+                yield __classPrivateFieldGet(this, _EIP6963ProviderAnnouncer_announcementPromise, "f");
+            }
+            catch (error) {
+                logger('EIP-6963 provider announcement failed', error);
+            }
+        });
+    }
+}
+_EIP6963ProviderAnnouncer_provider = new WeakMap(), _EIP6963ProviderAnnouncer_detail = new WeakMap(), _EIP6963ProviderAnnouncer_suppressed = new WeakMap(), _EIP6963ProviderAnnouncer_requestHandler = new WeakMap(), _EIP6963ProviderAnnouncer_announcementPromise = new WeakMap(), _EIP6963ProviderAnnouncer_instances = new WeakSet(), _EIP6963ProviderAnnouncer_announceOnce = function _EIP6963ProviderAnnouncer_announceOnce() {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!getBrowserWindow()) {
+            return;
+        }
+        if (yield hasNativeMetaMaskProvider()) {
+            logger('MetaMask EIP-6963 provider is already announced. Skipping...');
+            __classPrivateFieldSet(this, _EIP6963ProviderAnnouncer_suppressed, true, "f");
+            return;
+        }
+        __classPrivateFieldSet(this, _EIP6963ProviderAnnouncer_detail, Object.freeze({
+            info: createProviderInfo(),
+            provider: __classPrivateFieldGet(this, _EIP6963ProviderAnnouncer_provider, "f"),
+        }), "f");
+        __classPrivateFieldGet(this, _EIP6963ProviderAnnouncer_instances, "m", _EIP6963ProviderAnnouncer_installRequestProviderListener).call(this);
+        __classPrivateFieldGet(this, _EIP6963ProviderAnnouncer_instances, "m", _EIP6963ProviderAnnouncer_dispatchAnnouncement).call(this);
+    });
+}, _EIP6963ProviderAnnouncer_installRequestProviderListener = function _EIP6963ProviderAnnouncer_installRequestProviderListener() {
+    const browserWindow = getBrowserWindow();
+    if (!browserWindow || __classPrivateFieldGet(this, _EIP6963ProviderAnnouncer_requestHandler, "f")) {
+        return;
+    }
+    __classPrivateFieldSet(this, _EIP6963ProviderAnnouncer_requestHandler, () => {
+        try {
+            __classPrivateFieldGet(this, _EIP6963ProviderAnnouncer_instances, "m", _EIP6963ProviderAnnouncer_dispatchAnnouncement).call(this);
+        }
+        catch (error) {
+            logger('EIP-6963 provider announcement failed', error);
+        }
+    }, "f");
+    browserWindow.addEventListener(EIP6963_REQUEST_PROVIDER_EVENT, __classPrivateFieldGet(this, _EIP6963ProviderAnnouncer_requestHandler, "f"));
+}, _EIP6963ProviderAnnouncer_dispatchAnnouncement = function _EIP6963ProviderAnnouncer_dispatchAnnouncement() {
+    const browserWindow = getBrowserWindow();
+    if (!browserWindow || !__classPrivateFieldGet(this, _EIP6963ProviderAnnouncer_detail, "f")) {
+        return;
+    }
+    browserWindow.dispatchEvent(createAnnouncementEvent(__classPrivateFieldGet(this, _EIP6963ProviderAnnouncer_detail, "f")));
+};
+//# sourceMappingURL=eip6963.js.map

package/dist/src/eip6963.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eip6963.js","sourceRoot":"","sources":["../../src/eip6963.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,eAAe,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,0BAA0B,CAAC;AAE1E;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,yBAAyB,CAAC;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,UAAU,CAAC;AAEnD;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,aAAa;IACb,oBAAoB;CACZ,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CAAC;AA0BxD;;;;;;;;GAQG;AACH,MAAM,gBAAgB,GAAG,GAAuB,EAAE;IAChD,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,UAAU,CAAC;IAC7C,OAAO,OAAO,CAAA,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,aAAa,CAAA,KAAK,UAAU;QACvD,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,CAAO,EAAU,EAAiB,EAAE,kDAChD,OAAA,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA,GAAA,CAAC;AAE1D,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAW,EAAE,CACrD,qBAAqB,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC;AAElE,MAAM,mBAAmB,GAAG,CAAC,KAAY,EAAsB,EAAE;;IAC/D,MAAM,EAAE,MAAM,EAAE,GAAG,KAAoD,CAAC;IACxE,MAAM,IAAI,GAAG,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,0CAAE,IAAI,CAAC;IAEhC,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAC/D,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CACnC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,YAAY,GAAG,CAAC,KAAiB,EAAU,EAAE;IACjD,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;IAChC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;IAEjC,OAAO;QACL,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,GAAG;QACH,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,GAAG;QACH,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,GAAG;QACH,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,GAAG;QACH,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3B,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3B,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3B,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3B,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3B,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;KAC5B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACb,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,GAAG,GAAW,EAAE;IAC9B,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,UAAU,CAAC;IAE9C,IAAI,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAE,UAAU,EAAE,CAAC;QAC/B,OAAO,cAAc,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC;IAED,IAAI,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAE,eAAe,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;QACjC,cAAc,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QACtC,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;AAC1E,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,uBAAuB,GAAG,CAC9B,MAAuC,EACO,EAAE;IAChD,MAAM,EAAE,WAAW,EAAE,sBAAsB,EAAE,GAAG,UAAU,CAAC;IAC3D,OAAO,IAAI,sBAAsB,CAAC,+BAA+B,EAAE;QACjE,MAAM;KACP,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,0BAA0B,GAAG,GAAU,EAAE;IAC7C,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,GAAG,UAAU,CAAC;IAC/C,OAAO,IAAI,gBAAgB,CAAC,8BAA8B,CAAC,CAAC;AAC9D,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,GAAkC,EAAE,CAC7D,MAAM,CAAC,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,EAAE;IAClB,IAAI,EAAE,wBAAwB;IAC9B,IAAI,EAAE,wBAAwB;IAC9B,IAAI,EAAE,wBAAwB;CAC/B,CAAC,CAAC;AAEL;;;;;;;GAOG;AACH,MAAM,yBAAyB,GAAG,GAA2B,EAAE;IAC7D,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IACzC,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IACxC,MAAM,OAAO,GAAG,CAAC,KAAY,EAAQ,EAAE;QACrC,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,IAAI,EAAE,CAAC;YACT,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC;IAEF,aAAa,CAAC,gBAAgB,CAAC,+BAA+B,EAAE,OAAO,CAAC,CAAC;IACzE,IAAI,CAAC;QACH,aAAa,CAAC,aAAa,CAAC,0BAA0B,EAAE,CAAC,CAAC;QAC1D,MAAM,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAC5C,CAAC;YAAS,CAAC;QACT,aAAa,CAAC,mBAAmB,CAAC,+BAA+B,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;AACvD,CAAC,CAAA,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,OAAO,wBAAwB;IAgBnC;;;;OAIG;IACH,YAAY,QAAyB;;QApBrC,2DAA2D;QAClD,qDAA2B;QAEpC,kEAAkE;QAClE,mDAA0C;QAE1C,0EAA0E;QAC1E,+CAAc,KAAK,EAAC;QAEpB,wEAAwE;QACxE,2DAA6B;QAE7B,4EAA4E;QAC5E,gEAAqC;QAQnC,uBAAA,IAAI,sCAAa,QAAQ,MAAA,CAAC;IAC5B,CAAC;IAED;;;;;;;;;OASG;IACG,QAAQ;;YACZ,IAAI,CAAC;gBACH,IAAI,uBAAA,IAAI,4CAAY,EAAE,CAAC;oBACrB,OAAO;gBACT,CAAC;gBAED,IAAI,uBAAA,IAAI,wCAAQ,EAAE,CAAC;oBACjB,uBAAA,IAAI,2FAAsB,MAA1B,IAAI,CAAwB,CAAC;oBAC7B,OAAO;gBACT,CAAC;gBAED,IAAI,CAAC,uBAAA,IAAI,qDAAqB,EAAE,CAAC;oBAC/B,uBAAA,IAAI,iDAAwB,uBAAA,IAAI,mFAAc,MAAlB,IAAI,CAAgB;yBAC7C,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;wBACf,MAAM,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;oBACzD,CAAC,CAAC;yBACD,OAAO,CAAC,GAAG,EAAE;wBACZ,uBAAA,IAAI,iDAAwB,SAAS,MAAA,CAAC;oBACxC,CAAC,CAAC,MAAA,CAAC;gBACP,CAAC;gBAED,MAAM,uBAAA,IAAI,qDAAqB,CAAC;YAClC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;KAAA;CAyDF;;;QAnDG,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QAED,IAAI,MAAM,yBAAyB,EAAE,EAAE,CAAC;YACtC,MAAM,CAAC,8DAA8D,CAAC,CAAC;YACvE,uBAAA,IAAI,wCAAe,IAAI,MAAA,CAAC;YACxB,OAAO;QACT,CAAC;QAED,uBAAA,IAAI,oCAAW,MAAM,CAAC,MAAM,CAAC;YAC3B,IAAI,EAAE,kBAAkB,EAAE;YAC1B,QAAQ,EAAE,uBAAA,IAAI,0CAAU;SACzB,CAAC,MAAA,CAAC;QACH,uBAAA,IAAI,qGAAgC,MAApC,IAAI,CAAkC,CAAC;QACvC,uBAAA,IAAI,2FAAsB,MAA1B,IAAI,CAAwB,CAAC;IAC/B,CAAC;;IAMC,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IACzC,IAAI,CAAC,aAAa,IAAI,uBAAA,IAAI,gDAAgB,EAAE,CAAC;QAC3C,OAAO;IACT,CAAC;IAED,uBAAA,IAAI,4CAAmB,GAAS,EAAE;QAChC,IAAI,CAAC;YACH,uBAAA,IAAI,2FAAsB,MAA1B,IAAI,CAAwB,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,MAAA,CAAC;IACF,aAAa,CAAC,gBAAgB,CAC5B,8BAA8B,EAC9B,uBAAA,IAAI,gDAAgB,CACrB,CAAC;AACJ,CAAC;IAMC,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IACzC,IAAI,CAAC,aAAa,IAAI,CAAC,uBAAA,IAAI,wCAAQ,EAAE,CAAC;QACpC,OAAO;IACT,CAAC;IAED,aAAa,CAAC,aAAa,CAAC,uBAAuB,CAAC,uBAAA,IAAI,wCAAQ,CAAC,CAAC,CAAC;AACrE,CAAC"}

package/dist/src/index.d.ts

@@ -1,5 +1,6 @@
 export { getInfuraRpcUrls } from './utils/infura';
 export { createEVMClient, type MetamaskConnectEVM } from './connect';
+export { EIP6963_ANNOUNCE_PROVIDER_EVENT, EIP6963_REQUEST_PROVIDER_EVENT, } from './eip6963';
 export type { EIP1193Provider } from './provider';
 export type * from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACrE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,mBAAmB,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,mBAAmB,SAAS,CAAC"}

package/dist/src/index.js

@@ -1,3 +1,4 @@
 export { getInfuraRpcUrls } from './utils/infura';
 export { createEVMClient } from './connect';
+export { EIP6963_ANNOUNCE_PROVIDER_EVENT, EIP6963_REQUEST_PROVIDER_EVENT, } from './eip6963';
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAA2B,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAA2B,MAAM,WAAW,CAAC;AACrE,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,WAAW,CAAC"}

package/dist/src/utils/infura.js.map

@@ -1 +1 @@
-{"version":3,"file":"infura.js","sourceRoot":"","sources":["../../../src/utils/infura.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,IAAI,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE9F,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,EAC/B,YAAY,EACZ,QAAQ,GAIT,EAAuB,EAAE;IACxB,MAAM,YAAY,GAAG,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,GAAG,CAChC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,WAAW,CAAC,OAAO,CAAC,EAAiB,CAC7D,CAAC;IAEF,MAAM,OAAO,GAAG,0BAA0B,CAAC;QACzC,YAAY;QACZ,YAAY;KACb,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CACnC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE;QAClB,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,gBAAgB,CAAC,GAAkB,CAAC,CAAC;QACtE,IAAI,SAAS,KAAK,kBAAkB,CAAC,MAAM,EAAE,CAAC;YAC5C,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;QACrD,GAAG,CAAC,OAAO,CAAC,GAAG,GAAa,CAAC;QAC7B,OAAO,GAAG,CAAC;IACb,CAAC,EACD,EAAE,CACH,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"infura.js","sourceRoot":"","sources":["../../../src/utils/infura.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,IAAI,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE9F,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,EAC/B,YAAY,EACZ,QAAQ,GAIT,EAAuB,EAAE;IACxB,MAAM,YAAY,GAAG,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,GAAG,CAChC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,WAAW,CAAC,OAAO,CAAC,EAAiB,CAC7D,CAAC;IAEF,MAAM,OAAO,GAAG,0BAA0B,CAAC;QACzC,YAAY;QACZ,YAAY;KACb,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CACnC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE;QAClB,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,gBAAgB,CAAC,GAAkB,CAAC,CAAC;QACtE,IAAI,SAAS,KAAK,kBAAkB,CAAC,MAAM,EAAE,CAAC;YAC5C,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;QACrD,GAAG,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC;QACnB,OAAO,GAAG,CAAC;IACb,CAAC,EACD,EAAE,CACH,CAAC;AACJ,CAAC,CAAC"}

package/dist/types/index.d.ts

@@ -314,6 +314,14 @@ declare class MetamaskConnectEVM {
      * @returns The EIP-1193 provider instance
      */
     getProvider(): EIP1193Provider;
+    /**
+     * Announces the EIP-1193 provider through EIP-6963 wallet discovery.
+     *
+     * This is a no-op when a native MetaMask EIP-6963 provider has already
+     * announced, or when running outside a browser environment. The first call
+     * may take up to 300 ms while native providers are requested.
+     */
+    announceProvider(): Promise<void>;
     /**
      * Gets the currently selected chain ID on the wallet
      *
@@ -358,6 +366,7 @@ declare class MetamaskConnectEVM {
  * @param options.dapp - Dapp identification and branding settings
  * @param options.api - API configuration including read-only RPC map
  * @param options.api.supportedNetworks - A map of hex chain IDs to RPC URLs for read-only requests
+ * @param [options.analytics.enabled] - Whether to enable dapp-side analytics (defaults to true)
  * @param [options.analytics.integrationType] - Integration type for analytics
  * @param [options.ui] - UI configuration options
  * @param [options.ui.headless] - Whether to run without UI
@@ -366,11 +375,11 @@ declare class MetamaskConnectEVM {
  * @param [options.mobile] - Mobile configuration options
  * @param [options.mobile.preferredOpenLink] - Custom handler for opening deeplinks (useful for React Native, etc.)
  * @param [options.mobile.useDeeplink] - Whether to use native deeplinks instead of universal links
- * @param [options.transport] - Transport configuration (e.g., extensionId, notification handler)
+ * @param [options.transport] - Transport configuration (e.g., extensionId)
  * @param [options.transport.extensionId] - Extension ID for browser extension transport
- * @param [options.transport.onNotification] - Callback for receiving transport notifications
  * @param [options.eventHandlers] - Event handlers for the Metamask Connect/EVM layer
  * @param [options.debug] - Enable debug logging
+ * @param [options.skipAutoAnnounce] - Skip automatic EIP-6963 provider announcement
  * @returns The Metamask-Connect EVM client instance
  */
 declare function createEVMClient(options: Pick<MultichainOptions, 'dapp' | 'mobile' | 'transport' | 'analytics'> & {
@@ -378,9 +387,19 @@ declare function createEVMClient(options: Pick<MultichainOptions, 'dapp' | 'mobi
 } & {
     eventHandlers?: Partial<EventHandlers>;
     debug?: boolean;
+    skipAutoAnnounce?: boolean;
     api: {
         supportedNetworks: Record<Hex, string>;
     };
 }): Promise<MetamaskConnectEVM>;
 
-export { type AddEthereumChainParameter, type Address, type CaipAccountId, type CaipChainId, EIP1193Provider, type EIP1193ProviderEvents, type EventHandlers, type Hex, type JsonRpcCallback, type JsonRpcRequest, type JsonRpcResponse, MetamaskConnectEVM, type MetamaskConnectEVMOptions, type ProviderRequest, type ProviderRequestInterceptor, createEVMClient, getInfuraRpcUrls };
+/**
+ * EIP-6963 event name wallets use to announce providers to dapps.
+ */
+declare const EIP6963_ANNOUNCE_PROVIDER_EVENT = "eip6963:announceProvider";
+/**
+ * EIP-6963 event name dapps dispatch to request wallet re-announcements.
+ */
+declare const EIP6963_REQUEST_PROVIDER_EVENT = "eip6963:requestProvider";
+
+export { type AddEthereumChainParameter, type Address, type CaipAccountId, type CaipChainId, EIP1193Provider, type EIP1193ProviderEvents, EIP6963_ANNOUNCE_PROVIDER_EVENT, EIP6963_REQUEST_PROVIDER_EVENT, type EventHandlers, type Hex, type JsonRpcCallback, type JsonRpcRequest, type JsonRpcResponse, MetamaskConnectEVM, type MetamaskConnectEVMOptions, type ProviderRequest, type ProviderRequestInterceptor, createEVMClient, getInfuraRpcUrls };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@metamask/connect-evm",
-  "version": "1.3.1",
-  "description": "EVM Layer for MetaMask Connect",
+  "version": "2.0.0",
+  "description": "MetaMask Connect EVM adapter — EIP-1193 provider over the multichain client",
   "keywords": [
     "MetaMask",
     "Ethereum"
@@ -54,13 +54,15 @@
     "test:watch": "vitest watch"
   },
   "dependencies": {
-    "@metamask/analytics": "^0.5.0",
-    "@metamask/connect-multichain": "^0.14.0",
-    "@metamask/utils": "^11.8.1"
+    "@metamask/analytics": "^0.6.0",
+    "@metamask/utils": "^11.8.1",
+    "semver": "^7.7.4"
   },
   "devDependencies": {
     "@metamask/auto-changelog": "^3.4.4",
+    "@metamask/connect-multichain": "^1.0.0",
     "@types/jsdom": "^21.1.7",
+    "@types/semver": "^7.7.1",
     "@vitest/coverage-v8": "^3.2.4",
     "jsdom": "^26.1.0",
     "prettier": "^3.3.3",
@@ -70,6 +72,9 @@
     "typescript": "^5.9.3",
     "vitest": "^3.1.2"
   },
+  "peerDependencies": {
+    "@metamask/connect-multichain": "^1.0.0"
+  },
   "engines": {
     "node": ">=20.19.0"
   },