@multiplatform.one/web3 7.31.1 → 7.32.0

package/dist/cjs/clients/preparedSend.native.js

@@ -0,0 +1,225 @@
+"use strict";
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var preparedSend_exports = {};
+__export(preparedSend_exports, {
+  DEFAULT_PREPARED_SEND_MAX_AGE_MS: () => DEFAULT_PREPARED_SEND_MAX_AGE_MS,
+  PreparedSendStaleError: () => PreparedSendStaleError,
+  prepareEvmSend: () => prepareEvmSend
+});
+module.exports = __toCommonJS(preparedSend_exports);
+var import_viem = require("viem");
+function _assert_this_initialized(self) {
+  if (self === void 0) {
+    throw new ReferenceError("this hasn't been initialised - super() hasn't been called");
+  }
+  return self;
+}
+function _call_super(_this, derived, args) {
+  derived = _get_prototype_of(derived);
+  return _possible_constructor_return(_this, _is_native_reflect_construct() ? Reflect.construct(derived, args || [], _get_prototype_of(_this).constructor) : derived.apply(_this, args));
+}
+function _class_call_check(instance, Constructor) {
+  if (!(instance instanceof Constructor)) {
+    throw new TypeError("Cannot call a class as a function");
+  }
+}
+function _construct(Parent, args, Class) {
+  if (_is_native_reflect_construct()) {
+    _construct = Reflect.construct;
+  } else {
+    _construct = function construct(Parent2, args2, Class2) {
+      var a = [null];
+      a.push.apply(a, args2);
+      var Constructor = Function.bind.apply(Parent2, a);
+      var instance = new Constructor();
+      if (Class2) _set_prototype_of(instance, Class2.prototype);
+      return instance;
+    };
+  }
+  return _construct.apply(null, arguments);
+}
+function _define_property(obj, key, value) {
+  if (key in obj) {
+    Object.defineProperty(obj, key, {
+      value,
+      enumerable: true,
+      configurable: true,
+      writable: true
+    });
+  } else {
+    obj[key] = value;
+  }
+  return obj;
+}
+function _get_prototype_of(o) {
+  _get_prototype_of = Object.setPrototypeOf ? Object.getPrototypeOf : function getPrototypeOf(o2) {
+    return o2.__proto__ || Object.getPrototypeOf(o2);
+  };
+  return _get_prototype_of(o);
+}
+function _inherits(subClass, superClass) {
+  if (typeof superClass !== "function" && superClass !== null) {
+    throw new TypeError("Super expression must either be null or a function");
+  }
+  subClass.prototype = Object.create(superClass && superClass.prototype, {
+    constructor: {
+      value: subClass,
+      writable: true,
+      configurable: true
+    }
+  });
+  if (superClass) _set_prototype_of(subClass, superClass);
+}
+function _is_native_function(fn) {
+  return Function.toString.call(fn).indexOf("[native code]") !== -1;
+}
+function _possible_constructor_return(self, call) {
+  if (call && (_type_of(call) === "object" || typeof call === "function")) {
+    return call;
+  }
+  return _assert_this_initialized(self);
+}
+function _set_prototype_of(o, p) {
+  _set_prototype_of = Object.setPrototypeOf || function setPrototypeOf(o2, p2) {
+    o2.__proto__ = p2;
+    return o2;
+  };
+  return _set_prototype_of(o, p);
+}
+function _type_of(obj) {
+  "@swc/helpers - typeof";
+
+  return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+function _wrap_native_super(Class) {
+  var _cache = typeof Map === "function" ? /* @__PURE__ */new Map() : void 0;
+  _wrap_native_super = function wrapNativeSuper(Class2) {
+    if (Class2 === null || !_is_native_function(Class2)) return Class2;
+    if (typeof Class2 !== "function") {
+      throw new TypeError("Super expression must either be null or a function");
+    }
+    if (typeof _cache !== "undefined") {
+      if (_cache.has(Class2)) return _cache.get(Class2);
+      _cache.set(Class2, Wrapper);
+    }
+    function Wrapper() {
+      return _construct(Class2, arguments, _get_prototype_of(this).constructor);
+    }
+    Wrapper.prototype = Object.create(Class2.prototype, {
+      constructor: {
+        value: Wrapper,
+        enumerable: false,
+        writable: true,
+        configurable: true
+      }
+    });
+    return _set_prototype_of(Wrapper, Class2);
+  };
+  return _wrap_native_super(Class);
+}
+function _is_native_reflect_construct() {
+  try {
+    var result = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {}));
+  } catch (_) {}
+  return (_is_native_reflect_construct = function () {
+    return !!result;
+  })();
+}
+var PreparedSendStaleError = /* @__PURE__ */function (Error1) {
+  "use strict";
+
+  _inherits(PreparedSendStaleError2, Error1);
+  function PreparedSendStaleError2(reason, detail) {
+    _class_call_check(this, PreparedSendStaleError2);
+    var _this;
+    _this = _call_super(this, PreparedSendStaleError2, [`Prepared transaction is stale (${reason}): ${detail}. Prepare it again.`]), _define_property(_this, "reason", void 0);
+    _this.name = "PreparedSendStaleError";
+    _this.reason = reason;
+    return _this;
+  }
+  return PreparedSendStaleError2;
+}(_wrap_native_super(Error));
+var DEFAULT_PREPARED_SEND_MAX_AGE_MS = 6e4;
+var same = function same2(a, b) {
+  return !!a && !!b && a.toLowerCase() === b.toLowerCase();
+};
+async function prepareEvmSend(parameters) {
+  var _parameters_maxAgeMs;
+  var {
+    publicClient,
+    request,
+    from,
+    chainId,
+    current
+  } = parameters;
+  var maxAgeMs = (_parameters_maxAgeMs = parameters.maxAgeMs) !== null && _parameters_maxAgeMs !== void 0 ? _parameters_maxAgeMs : DEFAULT_PREPARED_SEND_MAX_AGE_MS;
+  var prepared = await publicClient.prepareTransactionRequest({
+    account: from,
+    chain: publicClient.chain,
+    to: parameters.to,
+    ...(parameters.data ? {
+      data: parameters.data
+    } : {}),
+    ...(parameters.value !== void 0 ? {
+      value: parameters.value
+    } : {}),
+    ...(parameters.gas !== void 0 ? {
+      gas: parameters.gas
+    } : {}),
+    ...(parameters.nonce !== void 0 ? {
+      nonce: parameters.nonce
+    } : {}),
+    parameters: ["fees", "gas", "nonce", "type"]
+  });
+  var {
+    account: _account,
+    chain: _chain,
+    ...transaction
+  } = prepared;
+  var rpc = {
+    ...(0, import_viem.formatTransactionRequest)(transaction),
+    from,
+    chainId: (0, import_viem.numberToHex)(chainId)
+  };
+  var preparedAt = Date.now();
+  return Object.freeze({
+    request: Object.freeze(rpc),
+    from,
+    chainId,
+    preparedAt,
+    send() {
+      var age = Date.now() - preparedAt;
+      if (age > maxAgeMs) return Promise.reject(new PreparedSendStaleError("expired", `prepared ${age} ms ago, limit ${maxAgeMs} ms`));
+      var now = current === null || current === void 0 ? void 0 : current();
+      if ((now === null || now === void 0 ? void 0 : now.address) !== void 0 && !same(now.address, from)) return Promise.reject(new PreparedSendStaleError("account", `prepared for ${from}, wallet is on ${now.address}`));
+      if ((now === null || now === void 0 ? void 0 : now.chainId) !== void 0 && now.chainId !== chainId) return Promise.reject(new PreparedSendStaleError("chain", `prepared for ${chainId}, wallet is on ${now.chainId}`));
+      return request({
+        method: "eth_sendTransaction",
+        params: [rpc]
+      });
+    }
+  });
+}
+//# sourceMappingURL=preparedSend.native.js.map

package/dist/cjs/clients/preparedSend.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","preparedSend_exports","__export","DEFAULT_PREPARED_SEND_MAX_AGE_MS","PreparedSendStaleError","prepareEvmSend","module","exports","import_viem","require","_assert_this_initialized","self","ReferenceError","_call_super","_this","derived","args","_get_prototype_of","_possible_constructor_return","_is_native_reflect_construct","Reflect","construct","constructor","apply","_class_call_check","instance","Constructor","TypeError","_construct","Parent","Class","Parent2","args2","Class2","a","push","Function","bind","_set_prototype_of","prototype","arguments","_define_property","obj","key","Object","defineProperty","enumerable","configurable","writable","o","setPrototypeOf","getPrototypeOf","o2","__proto__","_inherits","subClass","superClass","create"],"sources":["../../../src/clients/preparedSend.ts"],"sourcesContent":[null],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,GAAA,IAAAC,WAAA,CAAAC,SAAA;EAAAC,KAAA;AAAA,IAAAH,GAAA;AAAA,IAAAI,oBAAA;AAAAC,QAAA,CAAAD,oBAAA;EAAAE,gCAAA,EAAAA,CAAA,KAAAA,gCAAA;EAAAC,sBAAA,EAAAA,CAAA,KAAAA,sBAAA;EAAAC,cAAA,EAAAA,CAAA,KAAAA;AAAA;AAAAC,MAAA,CAAAC,OAAA,GAAAX,YAQO,CAAAK,oBAAA;AAkCA,IAAAO,WAAM,GAAAC,OAAA;AAAqC,SACvCC,yBAAAC,IAAA;EACT,IAAAA,IAAA,KAAY,QAAiC;IAC3C,MAAM,IAAAC,cAAA,4DAAyE;EAC/E;EACA,OAAKD,IAAA;AAAS;AAElB,SAAAE,YAAAC,KAAA,EAAAC,OAAA,EAAAC,IAAA;EAyBOD,OAAM,GAAAE,iBAAA,CAAAF,OAAA;EAEb,OAAMG,4BAAiD,CAAAJ,KAAE,EAAAK,4BAAgC,KAAAC,OAAA,CAAAC,SAAA,CAAAN,OAAA,EAAAC,IAAA,QAAAC,iBAAA,CAAAH,KAAA,EAAAQ,WAAA,IAAAP,OAAA,CAAAQ,KAAA,CAAAT,KAAA,EAAAE,IAAA;AAOzF;AAGE,SAAMQ,iBAAgBA,CAAAC,QAAS,EAAAC,WAAe;EAC9C,MAAMD,QAAA,YAAWC,WAAW,GAAY;IACxC,MAAM,IAAAC,SAAW,oCAAmB;EAA0B;AACnD;AACW,SAChBC,UAAWA,CAAAC,MAAA,EAAAb,IAAA,EAAAc,KAAA;EAAA,IACfX,4BAA8B;IAC9BS,UAAI,GAAAR,OAAW,CAAAC,SAAU;EAA2C,OAChE;IACJO,UAAI,YAAWP,SAAUA,CAAAU,OAAc,EAAAC,KAAO,EAAAC,MAAW;MACzD,IAAAC,CAAA,IACQ,KACV;MACAA,CAAA,CAAMC,IAAA,CAAAZ,KAAM,CAAAW,CAAA,EAAAF,KAAA;MACV,IAAAN,WAAG,GAAAU,QAAA,CAAAC,IAAA,CAAAd,KAAA,CAAAQ,OAAyB,EAAAG,CAAA;MAC5B,IAAAT,QAAA,OAAAC,WAAA;MACA,IAAAO,MAAA,EAASK,iBAAA,CAAAb,QAAY,EAAAQ,MAAO,CAAAM,SAAA;MAC9B,OAAAd,QAAA;IACA;EAEA;EAAqB,OACnBG,UAAS,CAAOL,KAAA,KAAU,EAAAiB,SAAA;AAAA;AAC1B,SACAC,iBAAAC,GAAA,EAAAC,GAAA,EAAA3C,KAAA;EAAA,IACA2C,GAAA,IAAAD,GAAA;IACAE,MAAA,CAAsBC,cAAA,CAAAH,GAAA,EAAAC,GAAA;MACpB3C,KAAA;MACA8C,UAAU;MACRC,YAAO,MAAQ;MAAAC,QACT;IAAgF;EAExF;IACAN,GAAA,CAAAC,GAAI,IAAK3C,KAAA;EACP;EAAe,OAAA0C,GACb;AAAI;AACF,SAAAzB,iBACAA,CAAAgC,CAAgB;EAAiChC,iBACnD,GAAA2B,MAAA,CAAAM,cAAA,GAAAN,MAAA,CAAAO,cAAA,YAAAA,eAAAC,EAAA;IAAA,OACFA,EAAA,CAAAC,SAAA,IAAAT,MAAA,CAAAO,cAAA,CAAAC,EAAA;EACF;EACE,OAAAnC,iBAAe,CAAAgC,CAAA;AAAA;AACT,SAAAK,SACFA,CAAAC,QAAA,EAAAC,UAAA;EAAA,WACAA,UAAA,KAAgB,UAAO,IAAAA,UAAA,KAAsB;IAAO,MACtD,IAAA7B,SAAA;EAAA;EAEJ4B,QAAA,CAAAhB,SAAO,GAAUK,MAAA,CAAAa,MAAQ,CAAAD,UAAA,IAAAA,UAAuB,CAAQjB,SAAO;IACjEjB,WAAA;MACDtB,KAAA,EAAAuD,QAAA;MACHP,QAAA","ignoreList":[]}

package/dist/cjs/connectkit/connectors/metaMaskConnectConnector.cjs

@@ -35,11 +35,14 @@ var metaMaskConnectConnector_exports = {};
 __export(metaMaskConnectConnector_exports, {
   metaMaskConnect: () => metaMaskConnect,
   metaMaskConnectChainIds: () => metaMaskConnectChainIds,
+  metaMaskMayLackChain: () => metaMaskMayLackChain,
   metaMaskNetworks: () => metaMaskNetworks,
   metaMaskSupportedNetworks: () => metaMaskSupportedNetworks,
+  reopenMetaMask: () => reopenMetaMask,
   resetMetaMaskConnectClient: () => resetMetaMaskConnectClient
 });
 module.exports = __toCommonJS(metaMaskConnectConnector_exports);
+var import_connectkit = require("@multiplatform.one/connectkit");
 var import_wagmi = require("wagmi");
 var import_viem = require("viem");
 var import_chains = require("wagmi/chains");
@@ -93,6 +96,17 @@ function isUrl(value) {
     return false;
   }
 }
+const metaMaskBuiltInTestnets = /* @__PURE__ */new Set([11155111, 59141, 10143, 6342, 6343]);
+function metaMaskMayLackChain(chain) {
+  return chain.testnet === true && !metaMaskBuiltInTestnets.has(chain.id);
+}
+function isUnrecognizedChain(err) {
+  const {
+    code,
+    message
+  } = err ?? {};
+  return code === 4902 || typeof message === "string" && message.includes("Unrecognized chain");
+}
 function metaMaskConnectChainIds(networks, chainId) {
   const ids = Object.keys(networks);
   if (!chainId || (0, import_syntheticChains.isSyntheticChainId)(chainId)) return ids;
@@ -101,6 +115,31 @@ function metaMaskConnectChainIds(networks, chainId) {
 }
 let client;
 let owner;
+const permittedChains = /* @__PURE__ */new Set();
+const unrecognizedChains = /* @__PURE__ */new Set();
+let lastDeeplink;
+function forgetChains() {
+  permittedChains.clear();
+  unrecognizedChains.clear();
+  lastDeeplink = void 0;
+}
+function reopenMetaMask() {
+  if (!lastDeeplink) return false;
+  lastDeeplink.open(lastDeeplink.url, "_self");
+  return true;
+}
+function recordingOpenLink(open) {
+  return (url, target) => {
+    lastDeeplink = {
+      url,
+      open
+    };
+    open(url, target);
+  };
+}
+function navigate(url) {
+  if (typeof window !== "undefined") window.location.href = url;
+}
 function getClient(parameters, networks) {
   if (client) return client;
   client = import("@metamask/connect-evm").then(({
@@ -126,16 +165,19 @@ function getClient(parameters, networks) {
         headless: true
       }
     } : {}),
-    ...(parameters.preferredOpenLink || parameters.useDeeplink !== void 0 ? {
-      mobile: {
-        ...(parameters.preferredOpenLink ? {
-          preferredOpenLink: parameters.preferredOpenLink
-        } : {}),
-        ...(parameters.useDeeplink !== void 0 ? {
-          useDeeplink: parameters.useDeeplink
-        } : {})
-      }
-    } : {}),
+    mobile: {
+      // MetaMask Connect's own opener does the same location change for a
+      // metamask:// link; going through one here keeps the link to reopen.
+      // With useDeeplink false it clicks a universal link instead, left as is.
+      ...(parameters.preferredOpenLink ? {
+        preferredOpenLink: recordingOpenLink(parameters.preferredOpenLink)
+      } : parameters.useDeeplink === false ? {} : {
+        preferredOpenLink: recordingOpenLink(navigate)
+      }),
+      ...(parameters.useDeeplink !== void 0 ? {
+        useDeeplink: parameters.useDeeplink
+      } : {})
+    },
     eventHandlers: {
       // A session approved outside connect(), in another tab say. wagmi drops
       // `change` for a connector it has no connection for, so only `connect`
@@ -150,14 +192,23 @@ function getClient(parameters, networks) {
         });
       },
       accountsChanged: accounts => {
-        if (accounts.length === 0) owner?.emit("disconnect");else owner?.emit("change", {
+        if (accounts.length === 0) {
+          forgetChains();
+          owner?.emit("disconnect");
+        } else owner?.emit("change", {
           accounts: accounts.map(a => (0, import_viem.getAddress)(a))
         });
       },
-      chainChanged: chainId => owner?.emit("change", {
-        chainId: Number(chainId)
-      }),
-      disconnect: () => owner?.emit("disconnect"),
+      chainChanged: chainId => {
+        permittedChains.add(Number(chainId));
+        owner?.emit("change", {
+          chainId: Number(chainId)
+        });
+      },
+      disconnect: () => {
+        forgetChains();
+        owner?.emit("disconnect");
+      },
       displayUri: uri => owner?.emit("message", {
         type: "display_uri",
         data: uri
@@ -172,6 +223,7 @@ function getClient(parameters, networks) {
 function resetMetaMaskConnectClient() {
   client = void 0;
   owner = void 0;
+  forgetChains();
 }
 function rethrow(err) {
   const code = err?.code;
@@ -186,6 +238,8 @@ function metaMaskConnect(parameters) {
     const networks = metaMaskNetworks(config.chains, config.transports);
     const supportedNetworks = metaMaskSupportedNetworks(networks, config.transports);
     const fallbackChainId = Number(Object.keys(networks)[0] ?? 1);
+    const mobile = parameters.mobile ?? (0, import_connectkit.isMobile)();
+    const addChainFirst = parameters.addChainFirst ?? metaMaskMayLackChain;
     const instance = () => getClient(parameters, supportedNetworks);
     let guarded;
     const claim = () => {
@@ -218,15 +272,18 @@ function metaMaskConnect(parameters) {
             });
             accounts = result.accounts.map(a => (0, import_viem.getAddress)(a));
           }
+          const current = chainIdOf(mm);
+          permittedChains.add(current);
           return {
             accounts,
-            chainId: chainIdOf(mm)
+            chainId: current
           };
         } catch (err) {
           rethrow(err);
         }
       },
       async disconnect() {
+        forgetChains();
         await (await claim()).disconnect();
       },
       async getAccounts() {
@@ -257,22 +314,46 @@ function metaMaskConnect(parameters) {
       }) {
         const chain = config.chains.find(c => c.id === chainId);
         if (!chain || !networks[(0, import_viem.numberToHex)(chainId)]) throw new import_viem.SwitchChainError(new import_wagmi.ChainNotConfiguredError());
+        const chainConfiguration = {
+          chainId: (0, import_viem.numberToHex)(chainId),
+          chainName: addEthereumChainParameter?.chainName ?? chain.name,
+          nativeCurrency: addEthereumChainParameter?.nativeCurrency ?? chain.nativeCurrency,
+          rpcUrls: addEthereumChainParameter?.rpcUrls ? [...addEthereumChainParameter.rpcUrls] : [networks[(0, import_viem.numberToHex)(chainId)]],
+          ...(chain.blockExplorers?.default.url ? {
+            blockExplorerUrls: [chain.blockExplorers.default.url]
+          } : {})
+        };
+        const mm = await claim();
+        if (mm.getChainId() === (0, import_viem.numberToHex)(chainId)) return chain;
         try {
-          await (await claim()).switchChain({
-            chainId: (0, import_viem.numberToHex)(chainId),
-            chainConfiguration: {
+          if (!mobile) {
+            await mm.switchChain({
               chainId: (0, import_viem.numberToHex)(chainId),
-              chainName: addEthereumChainParameter?.chainName ?? chain.name,
-              nativeCurrency: addEthereumChainParameter?.nativeCurrency ?? chain.nativeCurrency,
-              rpcUrls: addEthereumChainParameter?.rpcUrls ? [...addEthereumChainParameter.rpcUrls] : [networks[(0, import_viem.numberToHex)(chainId)]],
-              ...(chain.blockExplorers?.default.url ? {
-                blockExplorerUrls: [chain.blockExplorers.default.url]
-              } : {})
-            }
-          });
+              chainConfiguration
+            });
+          } else if (!permittedChains.has(chainId) && (unrecognizedChains.has(chainId) || addChainFirst(chain))) {
+            await mm.getProvider().request({
+              method: "wallet_addEthereumChain",
+              params: [chainConfiguration]
+            });
+          } else {
+            await mm.switchChain({
+              chainId: (0, import_viem.numberToHex)(chainId)
+            });
+          }
+          permittedChains.add(chainId);
+          unrecognizedChains.delete(chainId);
           return chain;
         } catch (err) {
           if (err?.code === import_viem.UserRejectedRequestError.code) throw new import_viem.UserRejectedRequestError(err);
+          if (mobile && isUnrecognizedChain(err)) {
+            unrecognizedChains.add(chainId);
+            throw new import_viem.SwitchChainError(Object.assign(new Error(`MetaMask does not have ${chain.name} yet. Switch again from a tap to add it.`, {
+              cause: err
+            }), {
+              code: 4902
+            }));
+          }
           throw new import_viem.SwitchChainError(err);
         }
       },

package/dist/cjs/connectkit/connectors/metaMaskConnectConnector.native.js

@@ -37,11 +37,14 @@ var metaMaskConnectConnector_exports = {};
 __export(metaMaskConnectConnector_exports, {
   metaMaskConnect: () => metaMaskConnect,
   metaMaskConnectChainIds: () => metaMaskConnectChainIds,
+  metaMaskMayLackChain: () => metaMaskMayLackChain,
   metaMaskNetworks: () => metaMaskNetworks,
   metaMaskSupportedNetworks: () => metaMaskSupportedNetworks,
+  reopenMetaMask: () => reopenMetaMask,
   resetMetaMaskConnectClient: () => resetMetaMaskConnectClient
 });
 module.exports = __toCommonJS(metaMaskConnectConnector_exports);
+var import_connectkit = require("@multiplatform.one/connectkit");
 var import_wagmi = require("wagmi");
 var import_viem = require("viem");
 var import_chains = require("wagmi/chains");
@@ -117,6 +120,17 @@ function isUrl(value) {
     return false;
   }
 }
+var metaMaskBuiltInTestnets = /* @__PURE__ */new Set([11155111, 59141, 10143, 6342, 6343]);
+function metaMaskMayLackChain(chain) {
+  return chain.testnet === true && !metaMaskBuiltInTestnets.has(chain.id);
+}
+function isUnrecognizedChain(err) {
+  var {
+    code,
+    message
+  } = err !== null && err !== void 0 ? err : {};
+  return code === 4902 || typeof message === "string" && message.includes("Unrecognized chain");
+}
 function metaMaskConnectChainIds(networks, chainId) {
   var ids = Object.keys(networks);
   if (!chainId || (0, import_syntheticChains.isSyntheticChainId)(chainId)) return ids;
@@ -127,6 +141,31 @@ function metaMaskConnectChainIds(networks, chainId) {
 }
 var client;
 var owner;
+var permittedChains = /* @__PURE__ */new Set();
+var unrecognizedChains = /* @__PURE__ */new Set();
+var lastDeeplink;
+function forgetChains() {
+  permittedChains.clear();
+  unrecognizedChains.clear();
+  lastDeeplink = void 0;
+}
+function reopenMetaMask() {
+  if (!lastDeeplink) return false;
+  lastDeeplink.open(lastDeeplink.url, "_self");
+  return true;
+}
+function recordingOpenLink(open) {
+  return function (url, target) {
+    lastDeeplink = {
+      url,
+      open
+    };
+    open(url, target);
+  };
+}
+function navigate(url) {
+  if (typeof window !== "undefined") window.location.href = url;
+}
 function getClient(parameters, networks) {
   if (client) return client;
   client = import("@metamask/connect-evm").then(function (param) {
@@ -155,16 +194,19 @@ function getClient(parameters, networks) {
           headless: true
         }
       } : {}),
-      ...(parameters.preferredOpenLink || parameters.useDeeplink !== void 0 ? {
-        mobile: {
-          ...(parameters.preferredOpenLink ? {
-            preferredOpenLink: parameters.preferredOpenLink
-          } : {}),
-          ...(parameters.useDeeplink !== void 0 ? {
-            useDeeplink: parameters.useDeeplink
-          } : {})
-        }
-      } : {}),
+      mobile: {
+        // MetaMask Connect's own opener does the same location change for a
+        // metamask:// link; going through one here keeps the link to reopen.
+        // With useDeeplink false it clicks a universal link instead, left as is.
+        ...(parameters.preferredOpenLink ? {
+          preferredOpenLink: recordingOpenLink(parameters.preferredOpenLink)
+        } : parameters.useDeeplink === false ? {} : {
+          preferredOpenLink: recordingOpenLink(navigate)
+        }),
+        ...(parameters.useDeeplink !== void 0 ? {
+          useDeeplink: parameters.useDeeplink
+        } : {})
+      },
       eventHandlers: {
         // A session approved outside connect(), in another tab say. wagmi drops
         // `change` for a connector it has no connection for, so only `connect`
@@ -182,19 +224,24 @@ function getClient(parameters, networks) {
           });
         },
         accountsChanged: function accountsChanged(accounts) {
-          if (accounts.length === 0) owner === null || owner === void 0 ? void 0 : owner.emit("disconnect");else owner === null || owner === void 0 ? void 0 : owner.emit("change", {
+          if (accounts.length === 0) {
+            forgetChains();
+            owner === null || owner === void 0 ? void 0 : owner.emit("disconnect");
+          } else owner === null || owner === void 0 ? void 0 : owner.emit("change", {
             accounts: accounts.map(function (a) {
               return (0, import_viem.getAddress)(a);
             })
           });
         },
         chainChanged: function chainChanged(chainId) {
-          return owner === null || owner === void 0 ? void 0 : owner.emit("change", {
+          permittedChains.add(Number(chainId));
+          owner === null || owner === void 0 ? void 0 : owner.emit("change", {
             chainId: Number(chainId)
           });
         },
         disconnect: function disconnect() {
-          return owner === null || owner === void 0 ? void 0 : owner.emit("disconnect");
+          forgetChains();
+          owner === null || owner === void 0 ? void 0 : owner.emit("disconnect");
         },
         displayUri: function displayUri(uri) {
           return owner === null || owner === void 0 ? void 0 : owner.emit("message", {
@@ -213,6 +260,7 @@ function getClient(parameters, networks) {
 function resetMetaMaskConnectClient() {
   client = void 0;
   owner = void 0;
+  forgetChains();
 }
 function rethrow(err) {
   var code = err === null || err === void 0 ? void 0 : err.code;
@@ -223,11 +271,13 @@ function rethrow(err) {
 metaMaskConnect.type = "metaMask";
 function metaMaskConnect(parameters) {
   return (0, import_wagmi.createConnector)(function (config) {
-    var _Object_keys_;
+    var _Object_keys_, _parameters_mobile, _parameters_addChainFirst;
     owner !== null && owner !== void 0 ? owner : owner = config.emitter;
     var networks = metaMaskNetworks(config.chains, config.transports);
     var supportedNetworks = metaMaskSupportedNetworks(networks, config.transports);
     var fallbackChainId = Number((_Object_keys_ = Object.keys(networks)[0]) !== null && _Object_keys_ !== void 0 ? _Object_keys_ : 1);
+    var mobile = (_parameters_mobile = parameters.mobile) !== null && _parameters_mobile !== void 0 ? _parameters_mobile : (0, import_connectkit.isMobile)();
+    var addChainFirst = (_parameters_addChainFirst = parameters.addChainFirst) !== null && _parameters_addChainFirst !== void 0 ? _parameters_addChainFirst : metaMaskMayLackChain;
     var instance = function instance2() {
       return getClient(parameters, supportedNetworks);
     };
@@ -271,15 +321,18 @@ function metaMaskConnect(parameters) {
               return (0, import_viem.getAddress)(a);
             });
           }
+          var current = chainIdOf(mm);
+          permittedChains.add(current);
           return {
             accounts,
-            chainId: chainIdOf(mm)
+            chainId: current
           };
         } catch (err) {
           rethrow(err);
         }
       },
       async disconnect() {
+        forgetChains();
         await (await claim()).disconnect();
       },
       async getAccounts() {
@@ -309,28 +362,52 @@ function metaMaskConnect(parameters) {
           addEthereumChainParameter,
           chainId
         } = param;
+        var _ref, _ref1;
+        var _chain_blockExplorers;
         var chain = config.chains.find(function (c) {
           return c.id === chainId;
         });
         if (!chain || !networks[(0, import_viem.numberToHex)(chainId)]) throw new import_viem.SwitchChainError(new import_wagmi.ChainNotConfiguredError());
+        var chainConfiguration = {
+          chainId: (0, import_viem.numberToHex)(chainId),
+          chainName: (_ref = addEthereumChainParameter === null || addEthereumChainParameter === void 0 ? void 0 : addEthereumChainParameter.chainName) !== null && _ref !== void 0 ? _ref : chain.name,
+          nativeCurrency: (_ref1 = addEthereumChainParameter === null || addEthereumChainParameter === void 0 ? void 0 : addEthereumChainParameter.nativeCurrency) !== null && _ref1 !== void 0 ? _ref1 : chain.nativeCurrency,
+          rpcUrls: (addEthereumChainParameter === null || addEthereumChainParameter === void 0 ? void 0 : addEthereumChainParameter.rpcUrls) ? [...addEthereumChainParameter.rpcUrls] : [networks[(0, import_viem.numberToHex)(chainId)]],
+          ...(((_chain_blockExplorers = chain.blockExplorers) === null || _chain_blockExplorers === void 0 ? void 0 : _chain_blockExplorers.default.url) ? {
+            blockExplorerUrls: [chain.blockExplorers.default.url]
+          } : {})
+        };
+        var mm = await claim();
+        if (mm.getChainId() === (0, import_viem.numberToHex)(chainId)) return chain;
         try {
-          var _ref, _ref1;
-          var _chain_blockExplorers;
-          await (await claim()).switchChain({
-            chainId: (0, import_viem.numberToHex)(chainId),
-            chainConfiguration: {
+          if (!mobile) {
+            await mm.switchChain({
               chainId: (0, import_viem.numberToHex)(chainId),
-              chainName: (_ref = addEthereumChainParameter === null || addEthereumChainParameter === void 0 ? void 0 : addEthereumChainParameter.chainName) !== null && _ref !== void 0 ? _ref : chain.name,
-              nativeCurrency: (_ref1 = addEthereumChainParameter === null || addEthereumChainParameter === void 0 ? void 0 : addEthereumChainParameter.nativeCurrency) !== null && _ref1 !== void 0 ? _ref1 : chain.nativeCurrency,
-              rpcUrls: (addEthereumChainParameter === null || addEthereumChainParameter === void 0 ? void 0 : addEthereumChainParameter.rpcUrls) ? [...addEthereumChainParameter.rpcUrls] : [networks[(0, import_viem.numberToHex)(chainId)]],
-              ...(((_chain_blockExplorers = chain.blockExplorers) === null || _chain_blockExplorers === void 0 ? void 0 : _chain_blockExplorers.default.url) ? {
-                blockExplorerUrls: [chain.blockExplorers.default.url]
-              } : {})
-            }
-          });
+              chainConfiguration
+            });
+          } else if (!permittedChains.has(chainId) && (unrecognizedChains.has(chainId) || addChainFirst(chain))) {
+            await mm.getProvider().request({
+              method: "wallet_addEthereumChain",
+              params: [chainConfiguration]
+            });
+          } else {
+            await mm.switchChain({
+              chainId: (0, import_viem.numberToHex)(chainId)
+            });
+          }
+          permittedChains.add(chainId);
+          unrecognizedChains.delete(chainId);
           return chain;
         } catch (err) {
           if ((err === null || err === void 0 ? void 0 : err.code) === import_viem.UserRejectedRequestError.code) throw new import_viem.UserRejectedRequestError(err);
+          if (mobile && isUnrecognizedChain(err)) {
+            unrecognizedChains.add(chainId);
+            throw new import_viem.SwitchChainError(Object.assign(new Error(`MetaMask does not have ${chain.name} yet. Switch again from a tap to add it.`, {
+              cause: err
+            }), {
+              code: 4902
+            }));
+          }
           throw new import_viem.SwitchChainError(err);
         }
       },