@dynamic-labs/starknet 2.3.7 → 2.3.9

package/CHANGELOG.md

@@ -1,4 +1,19 @@
 
+### [2.3.9](https://github.com/dynamic-labs/DynamicAuth/compare/v2.3.8...v2.3.9) (2024-08-13)
+
+
+### Bug Fixes
+
+* hcaptcha for mobile login ([#6525](https://github.com/dynamic-labs/DynamicAuth/issues/6525)) ([#6539](https://github.com/dynamic-labs/DynamicAuth/issues/6539)) ([9b3676d](https://github.com/dynamic-labs/DynamicAuth/commit/9b3676dd27c65a7e678e720e5648a166b8d514a6))
+
+### [2.3.8](https://github.com/dynamic-labs/DynamicAuth/compare/v2.3.7...v2.3.8) (2024-08-02)
+
+
+### Bug Fixes
+
+* fetch user on refresh from backend when cookie-enabled and user not in local storage ([#6472](https://github.com/dynamic-labs/DynamicAuth/issues/6472)) ([7300a21](https://github.com/dynamic-labs/DynamicAuth/commit/7300a21d81d51ef1fc93af12d1081b5c1d57b578))
+* stop filtering wallet connect on keyword "wallet" ([#6476](https://github.com/dynamic-labs/DynamicAuth/issues/6476)) ([fc1be36](https://github.com/dynamic-labs/DynamicAuth/commit/fc1be36b0370f876dcfe4e84e25ee60cf9682306)), closes [#6475](https://github.com/dynamic-labs/DynamicAuth/issues/6475)
+
 ### [2.3.7](https://github.com/dynamic-labs/DynamicAuth/compare/v2.3.6...v2.3.7) (2024-07-26)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/starknet",
-  "version": "2.3.7",
+  "version": "2.3.9",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/dynamic-labs/dynamic-auth.git",
@@ -31,10 +31,12 @@
     "text-encoding": "0.7.0",
     "starknetkit": "1.1.3",
     "@dynamic-labs/sdk-api-core": "0.0.497",
-    "@dynamic-labs/rpc-provider-starknet": "2.3.7",
-    "@dynamic-labs/utils": "2.3.7",
-    "@dynamic-labs/wallet-book": "2.3.7",
-    "@dynamic-labs/wallet-connector-core": "2.3.7"
+    "@module-federation/runtime": "0.1.19",
+    "@dynamic-labs/logger": "2.3.9",
+    "@dynamic-labs/rpc-provider-starknet": "2.3.9",
+    "@dynamic-labs/utils": "2.3.9",
+    "@dynamic-labs/wallet-book": "2.3.9",
+    "@dynamic-labs/wallet-connector-core": "2.3.9"
   },
   "peerDependencies": {}
 }

package/src/index.cjs

@@ -9,6 +9,7 @@ var argentxMobile = require('./wallets/argentxMobile.cjs');
 var argentxWeb = require('./wallets/argentxWeb.cjs');
 var bitget = require('./wallets/bitget.cjs');
 var okx = require('./wallets/okx.cjs');
+var metamask = require('./wallets/metamask.cjs');
 require('@dynamic-labs/rpc-provider-starknet');
 
 /* eslint-disable @typescript-eslint/no-unused-vars */
@@ -19,6 +20,7 @@ const StarknetWalletConnectors = (props) => [
     argentxWeb.ArgentXWeb,
     okx.Okx,
     bitget.Bitget,
+    metamask.MetaMask,
 ];
 
 exports.StarknetWalletConnectors = StarknetWalletConnectors;

package/src/index.js

@@ -5,6 +5,7 @@ import { ArgentXMobile } from './wallets/argentxMobile.js';
 import { ArgentXWeb } from './wallets/argentxWeb.js';
 import { Bitget } from './wallets/bitget.js';
 import { Okx } from './wallets/okx.js';
+import { MetaMask } from './wallets/metamask.js';
 import '@dynamic-labs/rpc-provider-starknet';
 
 /* eslint-disable @typescript-eslint/no-unused-vars */
@@ -15,6 +16,7 @@ const StarknetWalletConnectors = (props) => [
     ArgentXWeb,
     Okx,
     Bitget,
+    MetaMask,
 ];
 
 export { StarknetWalletConnectors };

package/src/starknetWalletConnector.cjs

@@ -22,6 +22,8 @@ class StarknetWalletConnector extends walletConnectorCore.WalletConnectorBase {
         this.connectedChain = 'STARK';
         this.supportedChains = ['STARK'];
         this.switchNetworkOnlyFromWallet = true;
+        // required for metamask snap integration as MM snaps don't have event listeners
+        this.canSetEventListeners = true;
         this.name = name;
         this.windowKey = windowKey;
         this.starknetNetworks = opts.starknetNetworks;
@@ -182,6 +184,24 @@ class StarknetWalletConnector extends walletConnectorCore.WalletConnectorBase {
             if (!wallet) {
                 return [];
             }
+            try {
+                yield this.reconnectIfNeeded(wallet);
+            }
+            catch (e) {
+                return [];
+            }
+            const getSelectedAddress = () => wallet.selectedAddress
+                ? Promise.resolve([wallet.selectedAddress])
+                : Promise.reject();
+            return utils.retryableFn(getSelectedAddress, {
+                fallbackValue: [],
+                retryIntervalMs: 100,
+                retryStrategy: 'timeout-and-rejection',
+            });
+        });
+    }
+    reconnectIfNeeded(wallet) {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
             const needsReconnection = !this.isProviderConnected() && (yield wallet.isPreauthorized());
             if (needsReconnection) {
                 /**
@@ -199,24 +219,18 @@ class StarknetWalletConnector extends walletConnectorCore.WalletConnectorBase {
                     }
                     catch (_a) {
                         localStorage.removeItem('dynamic_should_have_wallet');
-                        return [];
+                        throw new Error('Could not reconnect');
                     }
                 }
                 else {
                     yield this.connect();
                 }
             }
-            const getSelectedAddress = () => wallet.selectedAddress
-                ? Promise.resolve([wallet.selectedAddress])
-                : Promise.reject();
-            return utils.retryableFn(getSelectedAddress, {
-                fallbackValue: [],
-                retryIntervalMs: 100,
-                retryStrategy: 'timeout-and-rejection',
-            });
         });
     }
     setupEventListeners() {
+        if (!this.canSetEventListeners)
+            return;
         const wallet = this.getWallet();
         if (!wallet) {
             return walletConnectorCore.logger.error('Wallet has not been found');
@@ -245,6 +259,8 @@ class StarknetWalletConnector extends walletConnectorCore.WalletConnectorBase {
     }
     teardownEventListeners() {
         return _tslib.__awaiter(this, void 0, void 0, function* () {
+            if (!this.canSetEventListeners)
+                return;
             const wallet = this.getWallet();
             if (this.handleAccountChange) {
                 wallet === null || wallet === void 0 ? void 0 : wallet.off(ACCOUNT_CHANGED_EVENT_LISTENER, this.handleAccountChange);

package/src/starknetWalletConnector.d.ts

@@ -23,6 +23,7 @@ declare abstract class StarknetWalletConnector extends WalletConnectorBase {
     handleNetworkChange: NetworkChangeEventHandler | undefined;
     switchNetworkOnlyFromWallet: boolean;
     starknetNetworks: NetworkConfiguration[];
+    canSetEventListeners: boolean;
     constructor(name: string, windowKey: StarknetWalletKey, opts: {
         chainRpcProviders: IChainRpcProviders;
         starknetNetworks: NetworkConfiguration[];
@@ -112,6 +113,7 @@ declare abstract class StarknetWalletConnector extends WalletConnectorBase {
     getWallet(): StarknetWindowObject | undefined;
     isInstalledOnBrowser(): boolean;
     getConnectedAccounts(): Promise<string[]>;
+    reconnectIfNeeded(wallet: StarknetWindowObject): Promise<Promise<Promise<void>>>;
     setupEventListeners(): void;
     teardownEventListeners(): Promise<void>;
     mapNetworkNameToChainId(networkNameOrChainId: string): constants.StarknetChainId | undefined;

package/src/starknetWalletConnector.js

@@ -18,6 +18,8 @@ class StarknetWalletConnector extends WalletConnectorBase {
         this.connectedChain = 'STARK';
         this.supportedChains = ['STARK'];
         this.switchNetworkOnlyFromWallet = true;
+        // required for metamask snap integration as MM snaps don't have event listeners
+        this.canSetEventListeners = true;
         this.name = name;
         this.windowKey = windowKey;
         this.starknetNetworks = opts.starknetNetworks;
@@ -178,6 +180,24 @@ class StarknetWalletConnector extends WalletConnectorBase {
             if (!wallet) {
                 return [];
             }
+            try {
+                yield this.reconnectIfNeeded(wallet);
+            }
+            catch (e) {
+                return [];
+            }
+            const getSelectedAddress = () => wallet.selectedAddress
+                ? Promise.resolve([wallet.selectedAddress])
+                : Promise.reject();
+            return retryableFn(getSelectedAddress, {
+                fallbackValue: [],
+                retryIntervalMs: 100,
+                retryStrategy: 'timeout-and-rejection',
+            });
+        });
+    }
+    reconnectIfNeeded(wallet) {
+        return __awaiter(this, void 0, void 0, function* () {
             const needsReconnection = !this.isProviderConnected() && (yield wallet.isPreauthorized());
             if (needsReconnection) {
                 /**
@@ -195,24 +215,18 @@ class StarknetWalletConnector extends WalletConnectorBase {
                     }
                     catch (_a) {
                         localStorage.removeItem('dynamic_should_have_wallet');
-                        return [];
+                        throw new Error('Could not reconnect');
                     }
                 }
                 else {
                     yield this.connect();
                 }
             }
-            const getSelectedAddress = () => wallet.selectedAddress
-                ? Promise.resolve([wallet.selectedAddress])
-                : Promise.reject();
-            return retryableFn(getSelectedAddress, {
-                fallbackValue: [],
-                retryIntervalMs: 100,
-                retryStrategy: 'timeout-and-rejection',
-            });
         });
     }
     setupEventListeners() {
+        if (!this.canSetEventListeners)
+            return;
         const wallet = this.getWallet();
         if (!wallet) {
             return logger.error('Wallet has not been found');
@@ -241,6 +255,8 @@ class StarknetWalletConnector extends WalletConnectorBase {
     }
     teardownEventListeners() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (!this.canSetEventListeners)
+                return;
             const wallet = this.getWallet();
             if (this.handleAccountChange) {
                 wallet === null || wallet === void 0 ? void 0 : wallet.off(ACCOUNT_CHANGED_EVENT_LISTENER, this.handleAccountChange);

package/src/types.d.ts

@@ -1,5 +1,5 @@
 import type { StarknetWindowObject } from 'get-starknet-core';
-export type StarknetWalletKey = 'braavos' | 'argentX' | 'argentXMobile' | 'argentWebWallet' | 'okxwallet' | 'bitkeep';
+export type StarknetWalletKey = 'braavos' | 'argentX' | 'argentXMobile' | 'argentWebWallet' | 'okxwallet' | 'bitkeep' | 'metamask_snap';
 export type StarknetWindowKey = `starknet_${StarknetWalletKey}` | 'starknet';
 type StarknetWindow = {
     [key in StarknetWindowKey]: StarknetWindowObject;

package/src/utils/starknetSnap.cjs

@@ -0,0 +1,112 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../_virtual/_tslib.cjs');
+var moduleFederation = require('@module-federation/runtime/dist/index.cjs.js');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n["default"] = e;
+  return Object.freeze(n);
+}
+
+var moduleFederation__namespace = /*#__PURE__*/_interopNamespace(moduleFederation);
+
+/**
+ *
+ * @param {IEthereum} provider the metamask window provider object
+ * @returns {StarknetWindowObject} the metamask provider wrapper formed into starknet window object
+ */
+const createMetaMaskProviderWrapper = (provider) => {
+    let metaMaskSnapWallet;
+    // using @module-federation to load the get-starknet remoteEntry, as recommended
+    // by the starknet team. this file is a small wrapper around the metamask snap api
+    // to communicate with starknet, which we then wrap into a starknet window object
+    // and use in our starknet connector, just like braavos and argent
+    const initMetaMaskSnapWallet = () => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        if (!metaMaskSnapWallet) {
+            moduleFederation__namespace.init({
+                name: 'MetaMaskStarknetSnapWallet',
+                remotes: [
+                    {
+                        alias: 'MetaMaskStarknetSnapWallet',
+                        entry: 'https://snaps.consensys.io/starknet/get-starknet/v1/remoteEntry.js',
+                        name: 'MetaMaskStarknetSnapWallet',
+                    },
+                ],
+            });
+            const result = yield moduleFederation__namespace.loadRemote('MetaMaskStarknetSnapWallet/index');
+            const { MetaMaskSnapWallet } = result;
+            metaMaskSnapWallet = new MetaMaskSnapWallet(provider, '*');
+        }
+    });
+    const metaMaskProviderWrapper = {
+        get account() {
+            return metaMaskSnapWallet === null || metaMaskSnapWallet === void 0 ? void 0 : metaMaskSnapWallet.account;
+        },
+        get chainId() {
+            return metaMaskSnapWallet === null || metaMaskSnapWallet === void 0 ? void 0 : metaMaskSnapWallet.chainId;
+        },
+        enable: () => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+            yield initMetaMaskSnapWallet();
+            if (!metaMaskSnapWallet) {
+                return [];
+            }
+            return metaMaskSnapWallet.enable();
+        }),
+        icon: '',
+        id: 'MetaMaskStarknetSnapWallet',
+        get isConnected() {
+            return metaMaskSnapWallet === null || metaMaskSnapWallet === void 0 ? void 0 : metaMaskSnapWallet.isConnected;
+        },
+        isPreauthorized: () => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+            var _a;
+            yield initMetaMaskSnapWallet();
+            return (_a = (yield (metaMaskSnapWallet === null || metaMaskSnapWallet === void 0 ? void 0 : metaMaskSnapWallet.isPreauthorized()))) !== null && _a !== void 0 ? _a : false;
+        }),
+        name: 'MetaMaskStarknetSnapWallet',
+        off: (
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        event, 
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        handleEvent) => undefined,
+        on: (
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        event, 
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        handleEvent) => undefined,
+        get provider() {
+            return metaMaskSnapWallet === null || metaMaskSnapWallet === void 0 ? void 0 : metaMaskSnapWallet.provider;
+        },
+        request: (call) => {
+            if (!metaMaskSnapWallet) {
+                throw new Error('Wallet not enabled');
+            }
+            return metaMaskSnapWallet.request(call);
+        },
+        get selectedAddress() {
+            return metaMaskSnapWallet === null || metaMaskSnapWallet === void 0 ? void 0 : metaMaskSnapWallet.selectedAddress;
+        },
+        get version() {
+            var _a;
+            return (_a = metaMaskSnapWallet === null || metaMaskSnapWallet === void 0 ? void 0 : metaMaskSnapWallet.version) !== null && _a !== void 0 ? _a : '0.0.0';
+        },
+    };
+    return metaMaskProviderWrapper;
+};
+
+exports.createMetaMaskProviderWrapper = createMetaMaskProviderWrapper;

package/src/utils/starknetSnap.d.ts

@@ -0,0 +1,8 @@
+import { StarknetWindowObject } from 'get-starknet-core';
+import { IEthereum } from '@dynamic-labs/utils';
+/**
+ *
+ * @param {IEthereum} provider the metamask window provider object
+ * @returns {StarknetWindowObject} the metamask provider wrapper formed into starknet window object
+ */
+export declare const createMetaMaskProviderWrapper: (provider: IEthereum) => StarknetWindowObject;

package/src/utils/starknetSnap.js

@@ -0,0 +1,88 @@
+'use client'
+import { __awaiter } from '../../_virtual/_tslib.js';
+import * as moduleFederation from '@module-federation/runtime/dist/index.cjs.js';
+
+/**
+ *
+ * @param {IEthereum} provider the metamask window provider object
+ * @returns {StarknetWindowObject} the metamask provider wrapper formed into starknet window object
+ */
+const createMetaMaskProviderWrapper = (provider) => {
+    let metaMaskSnapWallet;
+    // using @module-federation to load the get-starknet remoteEntry, as recommended
+    // by the starknet team. this file is a small wrapper around the metamask snap api
+    // to communicate with starknet, which we then wrap into a starknet window object
+    // and use in our starknet connector, just like braavos and argent
+    const initMetaMaskSnapWallet = () => __awaiter(void 0, void 0, void 0, function* () {
+        if (!metaMaskSnapWallet) {
+            moduleFederation.init({
+                name: 'MetaMaskStarknetSnapWallet',
+                remotes: [
+                    {
+                        alias: 'MetaMaskStarknetSnapWallet',
+                        entry: 'https://snaps.consensys.io/starknet/get-starknet/v1/remoteEntry.js',
+                        name: 'MetaMaskStarknetSnapWallet',
+                    },
+                ],
+            });
+            const result = yield moduleFederation.loadRemote('MetaMaskStarknetSnapWallet/index');
+            const { MetaMaskSnapWallet } = result;
+            metaMaskSnapWallet = new MetaMaskSnapWallet(provider, '*');
+        }
+    });
+    const metaMaskProviderWrapper = {
+        get account() {
+            return metaMaskSnapWallet === null || metaMaskSnapWallet === void 0 ? void 0 : metaMaskSnapWallet.account;
+        },
+        get chainId() {
+            return metaMaskSnapWallet === null || metaMaskSnapWallet === void 0 ? void 0 : metaMaskSnapWallet.chainId;
+        },
+        enable: () => __awaiter(void 0, void 0, void 0, function* () {
+            yield initMetaMaskSnapWallet();
+            if (!metaMaskSnapWallet) {
+                return [];
+            }
+            return metaMaskSnapWallet.enable();
+        }),
+        icon: '',
+        id: 'MetaMaskStarknetSnapWallet',
+        get isConnected() {
+            return metaMaskSnapWallet === null || metaMaskSnapWallet === void 0 ? void 0 : metaMaskSnapWallet.isConnected;
+        },
+        isPreauthorized: () => __awaiter(void 0, void 0, void 0, function* () {
+            var _a;
+            yield initMetaMaskSnapWallet();
+            return (_a = (yield (metaMaskSnapWallet === null || metaMaskSnapWallet === void 0 ? void 0 : metaMaskSnapWallet.isPreauthorized()))) !== null && _a !== void 0 ? _a : false;
+        }),
+        name: 'MetaMaskStarknetSnapWallet',
+        off: (
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        event, 
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        handleEvent) => undefined,
+        on: (
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        event, 
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        handleEvent) => undefined,
+        get provider() {
+            return metaMaskSnapWallet === null || metaMaskSnapWallet === void 0 ? void 0 : metaMaskSnapWallet.provider;
+        },
+        request: (call) => {
+            if (!metaMaskSnapWallet) {
+                throw new Error('Wallet not enabled');
+            }
+            return metaMaskSnapWallet.request(call);
+        },
+        get selectedAddress() {
+            return metaMaskSnapWallet === null || metaMaskSnapWallet === void 0 ? void 0 : metaMaskSnapWallet.selectedAddress;
+        },
+        get version() {
+            var _a;
+            return (_a = metaMaskSnapWallet === null || metaMaskSnapWallet === void 0 ? void 0 : metaMaskSnapWallet.version) !== null && _a !== void 0 ? _a : '0.0.0';
+        },
+    };
+    return metaMaskProviderWrapper;
+};
+
+export { createMetaMaskProviderWrapper };

package/src/wallets/metamask.cjs

@@ -0,0 +1,121 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../_virtual/_tslib.cjs');
+var utils = require('@dynamic-labs/utils');
+var logger$1 = require('@dynamic-labs/logger');
+var starknetWalletConnector = require('../starknetWalletConnector.cjs');
+var starknetSnap = require('../utils/starknetSnap.cjs');
+
+const logger = new logger$1.Logger('MetaMask Starknet Snap', logger$1.LogLevel.INFO);
+class MetaMask extends starknetWalletConnector["default"] {
+    constructor(opts) {
+        super('MetaMask Starknet', 'metamask_snap', opts);
+        this.overrideKey = 'metamaskstarknet';
+        const { providers } = utils.Eip6963ProviderSingleton.get();
+        const metamaskProvider = providers.find((p) => ['io.metamask', 'io.metamask.flask'].includes(p.info.rdns));
+        if (metamaskProvider) {
+            this.provider = metamaskProvider.provider;
+        }
+        if (!window.starknet_metamask_snap && metamaskProvider) {
+            window.starknet_metamask_snap = starknetSnap.createMetaMaskProviderWrapper(metamaskProvider.provider);
+        }
+    }
+    getNetwork() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            if (!this.provider) {
+                logger.error('[getNetwork] - No provider found, returning undefined');
+                return undefined;
+            }
+            try {
+                logger.info('[getNetwork] - trying to fetch network using provider');
+                // we are using this method to get the network so that we always "see" the absolute
+                // active network in the companion site. when using the snap wrapper to get the network,
+                // we don't "see" the actual active network in the companion site – instead we see the
+                // network that was active at the time of the snap initialization
+                const result = yield this.provider.request({
+                    method: 'wallet_invokeSnap',
+                    params: {
+                        request: {
+                            method: 'starkNet_getCurrentNetwork',
+                            params: {},
+                        },
+                        snapId: 'npm:@consensys/starknet-snap',
+                    },
+                });
+                if (!('chainId' in result) || typeof result.chainId !== 'string') {
+                    logger.error(`[getNetwork] - result.chainId should be a string, but got: ${
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    result.chainId}`);
+                    return undefined;
+                }
+                if (result.chainId !== this.currentChainId) {
+                    const resultChainName = this.mapChainIdToNetworkName(result.chainId);
+                    const currentChainName = this.currentChainId
+                        ? this.mapChainIdToNetworkName(this.currentChainId)
+                        : undefined;
+                    logger.info(`[getNetwork] - emitting chainChange event. got chainId: ${result.chainId} (${resultChainName}). current chainId: ${this.currentChainId} (${currentChainName})`);
+                    this.emit('chainChange', { chain: result.chainId });
+                }
+                this.currentChainId = result.chainId;
+                return this.currentChainId;
+            }
+            catch (e) {
+                logger.error('[getNetwork] - network fetch request failed, returning undefined', e);
+                return undefined;
+            }
+        });
+    }
+    setupEventListeners() {
+        if (this.intervalId) {
+            return;
+        }
+        this.intervalId = setInterval(() => {
+            this.getNetwork().then((chainId) => {
+                if (!chainId) {
+                    return;
+                }
+                const resultChainName = this.mapChainIdToNetworkName(chainId);
+                const currentChainName = this.currentChainId
+                    ? this.mapChainIdToNetworkName(this.currentChainId)
+                    : undefined;
+                logger.info(`[setupEventListeners] - got network: ${chainId} (${resultChainName}). current network: ${this.currentChainId} (${currentChainName})`);
+                if (chainId !== this.currentChainId) {
+                    logger.info(`[setupEventListeners] - emitting chainChange event: ${chainId}`);
+                    this.emit('chainChange', { chain: chainId });
+                    this.currentChainId = chainId;
+                }
+            });
+        }, 5000);
+    }
+    teardownEventListeners() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            clearInterval(this.intervalId);
+            this.intervalId = undefined;
+        });
+    }
+    endSession() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            this.teardownEventListeners();
+        });
+    }
+    getConnectedAccounts() {
+        return _tslib.__awaiter(this, void 0, void 0, function* () {
+            const wallet = this.getWallet();
+            if (!wallet) {
+                return [];
+            }
+            const isProviderConnected = this.isProviderConnected();
+            const isPreauthorized = yield wallet.isPreauthorized();
+            const shouldReconnect = !isProviderConnected && isPreauthorized;
+            if (shouldReconnect) {
+                yield this.connect();
+            }
+            return wallet.selectedAddress ? [wallet.selectedAddress] : [];
+        });
+    }
+}
+
+exports.MetaMask = MetaMask;

package/src/wallets/metamask.d.ts

@@ -0,0 +1,14 @@
+import { type WalletConnector } from '@dynamic-labs/wallet-connector-core';
+import StarknetProvider from '../starknetWalletConnector';
+export declare class MetaMask extends StarknetProvider implements WalletConnector {
+    overrideKey: string;
+    private currentChainId;
+    private intervalId;
+    private provider;
+    constructor(opts: any);
+    getNetwork(): Promise<string | undefined>;
+    setupEventListeners(): void;
+    teardownEventListeners(): Promise<void>;
+    endSession(): Promise<void>;
+    getConnectedAccounts(): Promise<string[]>;
+}

package/src/wallets/metamask.js

@@ -0,0 +1,117 @@
+'use client'
+import { __awaiter } from '../../_virtual/_tslib.js';
+import { Eip6963ProviderSingleton } from '@dynamic-labs/utils';
+import { Logger, LogLevel } from '@dynamic-labs/logger';
+import StarknetWalletConnector from '../starknetWalletConnector.js';
+import { createMetaMaskProviderWrapper } from '../utils/starknetSnap.js';
+
+const logger = new Logger('MetaMask Starknet Snap', LogLevel.INFO);
+class MetaMask extends StarknetWalletConnector {
+    constructor(opts) {
+        super('MetaMask Starknet', 'metamask_snap', opts);
+        this.overrideKey = 'metamaskstarknet';
+        const { providers } = Eip6963ProviderSingleton.get();
+        const metamaskProvider = providers.find((p) => ['io.metamask', 'io.metamask.flask'].includes(p.info.rdns));
+        if (metamaskProvider) {
+            this.provider = metamaskProvider.provider;
+        }
+        if (!window.starknet_metamask_snap && metamaskProvider) {
+            window.starknet_metamask_snap = createMetaMaskProviderWrapper(metamaskProvider.provider);
+        }
+    }
+    getNetwork() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.provider) {
+                logger.error('[getNetwork] - No provider found, returning undefined');
+                return undefined;
+            }
+            try {
+                logger.info('[getNetwork] - trying to fetch network using provider');
+                // we are using this method to get the network so that we always "see" the absolute
+                // active network in the companion site. when using the snap wrapper to get the network,
+                // we don't "see" the actual active network in the companion site – instead we see the
+                // network that was active at the time of the snap initialization
+                const result = yield this.provider.request({
+                    method: 'wallet_invokeSnap',
+                    params: {
+                        request: {
+                            method: 'starkNet_getCurrentNetwork',
+                            params: {},
+                        },
+                        snapId: 'npm:@consensys/starknet-snap',
+                    },
+                });
+                if (!('chainId' in result) || typeof result.chainId !== 'string') {
+                    logger.error(`[getNetwork] - result.chainId should be a string, but got: ${
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    result.chainId}`);
+                    return undefined;
+                }
+                if (result.chainId !== this.currentChainId) {
+                    const resultChainName = this.mapChainIdToNetworkName(result.chainId);
+                    const currentChainName = this.currentChainId
+                        ? this.mapChainIdToNetworkName(this.currentChainId)
+                        : undefined;
+                    logger.info(`[getNetwork] - emitting chainChange event. got chainId: ${result.chainId} (${resultChainName}). current chainId: ${this.currentChainId} (${currentChainName})`);
+                    this.emit('chainChange', { chain: result.chainId });
+                }
+                this.currentChainId = result.chainId;
+                return this.currentChainId;
+            }
+            catch (e) {
+                logger.error('[getNetwork] - network fetch request failed, returning undefined', e);
+                return undefined;
+            }
+        });
+    }
+    setupEventListeners() {
+        if (this.intervalId) {
+            return;
+        }
+        this.intervalId = setInterval(() => {
+            this.getNetwork().then((chainId) => {
+                if (!chainId) {
+                    return;
+                }
+                const resultChainName = this.mapChainIdToNetworkName(chainId);
+                const currentChainName = this.currentChainId
+                    ? this.mapChainIdToNetworkName(this.currentChainId)
+                    : undefined;
+                logger.info(`[setupEventListeners] - got network: ${chainId} (${resultChainName}). current network: ${this.currentChainId} (${currentChainName})`);
+                if (chainId !== this.currentChainId) {
+                    logger.info(`[setupEventListeners] - emitting chainChange event: ${chainId}`);
+                    this.emit('chainChange', { chain: chainId });
+                    this.currentChainId = chainId;
+                }
+            });
+        }, 5000);
+    }
+    teardownEventListeners() {
+        return __awaiter(this, void 0, void 0, function* () {
+            clearInterval(this.intervalId);
+            this.intervalId = undefined;
+        });
+    }
+    endSession() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.teardownEventListeners();
+        });
+    }
+    getConnectedAccounts() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const wallet = this.getWallet();
+            if (!wallet) {
+                return [];
+            }
+            const isProviderConnected = this.isProviderConnected();
+            const isPreauthorized = yield wallet.isPreauthorized();
+            const shouldReconnect = !isProviderConnected && isPreauthorized;
+            if (shouldReconnect) {
+                yield this.connect();
+            }
+            return wallet.selectedAddress ? [wallet.selectedAddress] : [];
+        });
+    }
+}
+
+export { MetaMask };