@metamask-previews/controller-utils 12.3.0-preview-4f4c98e → 12.3.0-preview-5b293ee50

package/dist/siwe.cjs

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectSIWE = exports.isValidSIWEOrigin = exports.parseDomainParts = void 0;
+const utils_1 = require("@metamask/utils");
+const siwe_parser_1 = require("@spruceid/siwe-parser");
+const logger_js_1 = require("./logger.cjs");
+const log = (0, logger_js_1.createModuleLogger)(logger_js_1.projectLogger, 'detect-siwe');
+/**
+ * This function strips the hex prefix from a string if it has one.
+ * If the input is not a string, return it unmodified.
+ *
+ * @param str - The string to check
+ * @returns The string without the hex prefix
+ */
+function safeStripHexPrefix(str) {
+    if (typeof str !== 'string') {
+        return str;
+    }
+    return (0, utils_1.remove0x)(str);
+}
+/**
+ * This function converts a hex string to text if it's not a 32 byte hex string.
+ *
+ * @param hexValue - The hex string to convert to text
+ * @returns The text representation of the hex string
+ */
+function msgHexToText(hexValue) {
+    try {
+        const stripped = safeStripHexPrefix(hexValue);
+        // TODO: Use `@metamask/utils` version of this function to avoid Buffer
+        // usage here.
+        // eslint-disable-next-line no-restricted-globals
+        const buff = Buffer.from(stripped, 'hex');
+        return buff.length === 32 ? hexValue : buff.toString('utf8');
+    }
+    catch (error) {
+        log(error);
+        return hexValue;
+    }
+}
+const DEFAULT_PORTS_BY_PROTOCOL = {
+    'http:': '80',
+    'https:': '443',
+};
+/**
+ * Parses parts from RFC 3986 authority from EIP-4361 `domain` field.
+ *
+ * @param domain - input string
+ * @param originProtocol - implied protocol from origin
+ * @returns parsed parts
+ */
+const parseDomainParts = (domain, originProtocol) => {
+    if (domain.match(/^[^/:]*:\/\//u)) {
+        return new URL(domain);
+    }
+    return new URL(`${originProtocol}//${domain}`);
+};
+exports.parseDomainParts = parseDomainParts;
+/**
+ * Validates origin of a Sign-In With Ethereum (SIWE)(EIP-4361) request.
+ * As per spec:
+ * hostname must match.
+ * port and username must match iff specified.
+ * Protocol binding and full same-origin are currently not performed.
+ *
+ * @param req - Signature request
+ * @returns true if origin matches domain; false otherwise
+ */
+const isValidSIWEOrigin = (req) => {
+    try {
+        const { origin, siwe } = req;
+        // origin = scheme://[user[:password]@]domain[:port]
+        // origin is supplied by environment and must match domain claim in message
+        if (!origin || !siwe?.parsedMessage?.domain) {
+            return false;
+        }
+        const originParts = new URL(origin);
+        const domainParts = (0, exports.parseDomainParts)(siwe.parsedMessage.domain, originParts.protocol);
+        if (domainParts.hostname.localeCompare(originParts.hostname, undefined, {
+            sensitivity: 'accent',
+        }) !== 0) {
+            return false;
+        }
+        if (domainParts.port !== '' && domainParts.port !== originParts.port) {
+            // If origin port is not specified, protocol default is implied
+            return (originParts.port === '' &&
+                domainParts.port === DEFAULT_PORTS_BY_PROTOCOL[originParts.protocol]);
+        }
+        if (domainParts.username !== '' &&
+            domainParts.username !== originParts.username) {
+            return false;
+        }
+        return true;
+    }
+    catch (error) {
+        log(error);
+        return false;
+    }
+};
+exports.isValidSIWEOrigin = isValidSIWEOrigin;
+/**
+ * This function intercepts a sign message, detects if it's a
+ * Sign-In With Ethereum (SIWE)(EIP-4361) message, and returns an object with
+ * relevant SIWE data.
+ *
+ * {@see {@link https://eips.ethereum.org/EIPS/eip-4361}}
+ *
+ * @param msgParams - The params of the message to sign
+ * @param msgParams.data - The data of the message to sign
+ * @returns An object with the relevant SIWE data
+ */
+const detectSIWE = (msgParams) => {
+    try {
+        const { data } = msgParams;
+        const message = msgHexToText(data);
+        const parsedMessage = new siwe_parser_1.ParsedMessage(message);
+        return {
+            isSIWEMessage: true,
+            parsedMessage,
+        };
+    }
+    catch {
+        // ignore error, it's not a valid SIWE message
+        return {
+            isSIWEMessage: false,
+            parsedMessage: null,
+        };
+    }
+};
+exports.detectSIWE = detectSIWE;
+//# sourceMappingURL=siwe.cjs.map

package/dist/siwe.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"siwe.cjs","sourceRoot":"","sources":["../src/siwe.ts"],"names":[],"mappings":"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","sourcesContent":["import { remove0x } from '@metamask/utils';\nimport { ParsedMessage } from '@spruceid/siwe-parser';\n\nimport { projectLogger, createModuleLogger } from './logger.js';\n\nconst log = createModuleLogger(projectLogger, 'detect-siwe');\n\n/**\n * This function strips the hex prefix from a string if it has one.\n * If the input is not a string, return it unmodified.\n *\n * @param str - The string to check\n * @returns The string without the hex prefix\n */\nfunction safeStripHexPrefix(str: string): string {\n  if (typeof str !== 'string') {\n    return str;\n  }\n  return remove0x(str);\n}\n\n/**\n * This function converts a hex string to text if it's not a 32 byte hex string.\n *\n * @param hexValue - The hex string to convert to text\n * @returns The text representation of the hex string\n */\nfunction msgHexToText(hexValue: string): string {\n  try {\n    const stripped = safeStripHexPrefix(hexValue);\n    // TODO: Use `@metamask/utils` version of this function to avoid Buffer\n    // usage here.\n    // eslint-disable-next-line no-restricted-globals\n    const buff = Buffer.from(stripped, 'hex');\n    return buff.length === 32 ? hexValue : buff.toString('utf8');\n  } catch (error) {\n    log(error);\n    return hexValue;\n  }\n}\n\n/**\n * @type WrappedSIWERequest\n *\n * Sign-In With Ethereum (SIWE)(EIP-4361) message with request metadata\n *\n * @property from - Subject account address\n * @property origin - The RFC 3986 originating authority of the signing request, including scheme\n * @property siwe - The data parsed from the message\n */\n// This interface was created before this ESLint rule was added.\n// Convert to a `type` in a future major version.\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface WrappedSIWERequest {\n  from: string;\n  origin: string;\n  siwe: SIWEMessage;\n}\n\n// This interface was created before this ESLint rule was added.\n// Convert to a `type` in a future major version.\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\ninterface DomainParts {\n  username?: string;\n  hostname: string;\n  port?: string;\n}\n\nconst DEFAULT_PORTS_BY_PROTOCOL = {\n  'http:': '80',\n  'https:': '443',\n} as Record<string, string>;\n\n/**\n * Parses parts from RFC 3986 authority from EIP-4361 `domain` field.\n *\n * @param domain - input string\n * @param originProtocol - implied protocol from origin\n * @returns parsed parts\n */\nexport const parseDomainParts = (\n  domain: string,\n  originProtocol: string,\n): DomainParts => {\n  if (domain.match(/^[^/:]*:\\/\\//u)) {\n    return new URL(domain);\n  }\n  return new URL(`${originProtocol}//${domain}`);\n};\n\n/**\n * Validates origin of a Sign-In With Ethereum (SIWE)(EIP-4361) request.\n * As per spec:\n * hostname must match.\n * port and username must match iff specified.\n * Protocol binding and full same-origin are currently not performed.\n *\n * @param req - Signature request\n * @returns true if origin matches domain; false otherwise\n */\nexport const isValidSIWEOrigin = (req: WrappedSIWERequest): boolean => {\n  try {\n    const { origin, siwe } = req;\n\n    // origin = scheme://[user[:password]@]domain[:port]\n    // origin is supplied by environment and must match domain claim in message\n    if (!origin || !siwe?.parsedMessage?.domain) {\n      return false;\n    }\n\n    const originParts = new URL(origin);\n    const domainParts = parseDomainParts(\n      siwe.parsedMessage.domain,\n      originParts.protocol,\n    );\n\n    if (\n      domainParts.hostname.localeCompare(originParts.hostname, undefined, {\n        sensitivity: 'accent',\n      }) !== 0\n    ) {\n      return false;\n    }\n\n    if (domainParts.port !== '' && domainParts.port !== originParts.port) {\n      // If origin port is not specified, protocol default is implied\n      return (\n        originParts.port === '' &&\n        domainParts.port === DEFAULT_PORTS_BY_PROTOCOL[originParts.protocol]\n      );\n    }\n\n    if (\n      domainParts.username !== '' &&\n      domainParts.username !== originParts.username\n    ) {\n      return false;\n    }\n\n    return true;\n  } catch (error) {\n    log(error);\n    return false;\n  }\n};\n\n/**\n * A locally defined object used to provide data to identify a Sign-In With Ethereum (SIWE)(EIP-4361) message and provide the parsed message\n *\n * @typedef SIWEMessage\n * @param {boolean} isSIWEMessage - Does the intercepted message conform to the SIWE specification?\n * @param {ParsedMessage} parsedMessage - The data parsed out of the message\n */\nexport type SIWEMessage =\n  | { isSIWEMessage: true; parsedMessage: ParsedMessage }\n  | { isSIWEMessage: false; parsedMessage: null };\n\n/**\n * This function intercepts a sign message, detects if it's a\n * Sign-In With Ethereum (SIWE)(EIP-4361) message, and returns an object with\n * relevant SIWE data.\n *\n * {@see {@link https://eips.ethereum.org/EIPS/eip-4361}}\n *\n * @param msgParams - The params of the message to sign\n * @param msgParams.data - The data of the message to sign\n * @returns An object with the relevant SIWE data\n */\nexport const detectSIWE = (msgParams: { data: string }): SIWEMessage => {\n  try {\n    const { data } = msgParams;\n    const message = msgHexToText(data);\n    const parsedMessage = new ParsedMessage(message);\n\n    return {\n      isSIWEMessage: true,\n      parsedMessage,\n    };\n  } catch {\n    // ignore error, it's not a valid SIWE message\n    return {\n      isSIWEMessage: false,\n      parsedMessage: null,\n    };\n  }\n};\n"]}

package/dist/{siwe.d.ts → siwe.d.cts}

@@ -1,4 +1,4 @@
-import { ParsedMessage } from '@spruceid/siwe-parser';
+import { ParsedMessage } from "@spruceid/siwe-parser";
 /**
  * @type WrappedSIWERequest
  *
@@ -66,4 +66,4 @@ export declare const detectSIWE: (msgParams: {
     data: string;
 }) => SIWEMessage;
 export {};
-//# sourceMappingURL=siwe.d.ts.map
+//# sourceMappingURL=siwe.d.cts.map

package/dist/siwe.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"siwe.d.cts","sourceRoot":"","sources":["../src/siwe.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,8BAA8B;AAwCtD;;;;;;;;GAQG;AAIH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;CACnB;AAKD,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAOD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,WACnB,MAAM,kBACE,MAAM,KACrB,WAKF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,QAAS,kBAAkB,KAAG,OA4C3D,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,aAAa,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,aAAa,CAAA;CAAE,GACrD;IAAE,aAAa,EAAE,KAAK,CAAC;IAAC,aAAa,EAAE,IAAI,CAAA;CAAE,CAAC;AAElD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,cAAe;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,KAAG,WAiBxD,CAAC"}

package/dist/siwe.d.mts

@@ -0,0 +1,69 @@
+import { ParsedMessage } from "@spruceid/siwe-parser";
+/**
+ * @type WrappedSIWERequest
+ *
+ * Sign-In With Ethereum (SIWE)(EIP-4361) message with request metadata
+ *
+ * @property from - Subject account address
+ * @property origin - The RFC 3986 originating authority of the signing request, including scheme
+ * @property siwe - The data parsed from the message
+ */
+export interface WrappedSIWERequest {
+    from: string;
+    origin: string;
+    siwe: SIWEMessage;
+}
+interface DomainParts {
+    username?: string;
+    hostname: string;
+    port?: string;
+}
+/**
+ * Parses parts from RFC 3986 authority from EIP-4361 `domain` field.
+ *
+ * @param domain - input string
+ * @param originProtocol - implied protocol from origin
+ * @returns parsed parts
+ */
+export declare const parseDomainParts: (domain: string, originProtocol: string) => DomainParts;
+/**
+ * Validates origin of a Sign-In With Ethereum (SIWE)(EIP-4361) request.
+ * As per spec:
+ * hostname must match.
+ * port and username must match iff specified.
+ * Protocol binding and full same-origin are currently not performed.
+ *
+ * @param req - Signature request
+ * @returns true if origin matches domain; false otherwise
+ */
+export declare const isValidSIWEOrigin: (req: WrappedSIWERequest) => boolean;
+/**
+ * A locally defined object used to provide data to identify a Sign-In With Ethereum (SIWE)(EIP-4361) message and provide the parsed message
+ *
+ * @typedef SIWEMessage
+ * @param {boolean} isSIWEMessage - Does the intercepted message conform to the SIWE specification?
+ * @param {ParsedMessage} parsedMessage - The data parsed out of the message
+ */
+export type SIWEMessage = {
+    isSIWEMessage: true;
+    parsedMessage: ParsedMessage;
+} | {
+    isSIWEMessage: false;
+    parsedMessage: null;
+};
+/**
+ * This function intercepts a sign message, detects if it's a
+ * Sign-In With Ethereum (SIWE)(EIP-4361) message, and returns an object with
+ * relevant SIWE data.
+ *
+ * {@see {@link https://eips.ethereum.org/EIPS/eip-4361}}
+ *
+ * @param msgParams - The params of the message to sign
+ * @param msgParams.data - The data of the message to sign
+ * @returns An object with the relevant SIWE data
+ */
+export declare const detectSIWE: (msgParams: {
+    data: string;
+}) => SIWEMessage;
+export {};
+//# sourceMappingURL=siwe.d.mts.map

package/dist/siwe.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"siwe.d.mts","sourceRoot":"","sources":["../src/siwe.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,8BAA8B;AAwCtD;;;;;;;;GAQG;AAIH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;CACnB;AAKD,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAOD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,WACnB,MAAM,kBACE,MAAM,KACrB,WAKF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,QAAS,kBAAkB,KAAG,OA4C3D,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,aAAa,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,aAAa,CAAA;CAAE,GACrD;IAAE,aAAa,EAAE,KAAK,CAAC;IAAC,aAAa,EAAE,IAAI,CAAA;CAAE,CAAC;AAElD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,cAAe;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,KAAG,WAiBxD,CAAC"}

package/dist/{siwe.js → siwe.mjs}

@@ -1,6 +1,6 @@
-import { remove0x } from '@metamask/utils';
-import { ParsedMessage } from '@spruceid/siwe-parser';
-import { projectLogger, createModuleLogger } from './logger.js';
+import { remove0x } from "@metamask/utils";
+import { ParsedMessage } from "@spruceid/siwe-parser";
+import { projectLogger, createModuleLogger } from "./logger.mjs";
 const log = createModuleLogger(projectLogger, 'detect-siwe');
 /**
  * This function strips the hex prefix from a string if it has one.
@@ -122,4 +122,4 @@ export const detectSIWE = (msgParams) => {
         };
     }
 };
-//# sourceMappingURL=siwe.js.map
+//# sourceMappingURL=siwe.mjs.map

package/dist/siwe.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"siwe.mjs","sourceRoot":"","sources":["../src/siwe.ts"],"names":[],"mappings":"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","sourcesContent":["import { remove0x } from '@metamask/utils';\nimport { ParsedMessage } from '@spruceid/siwe-parser';\n\nimport { projectLogger, createModuleLogger } from './logger.js';\n\nconst log = createModuleLogger(projectLogger, 'detect-siwe');\n\n/**\n * This function strips the hex prefix from a string if it has one.\n * If the input is not a string, return it unmodified.\n *\n * @param str - The string to check\n * @returns The string without the hex prefix\n */\nfunction safeStripHexPrefix(str: string): string {\n  if (typeof str !== 'string') {\n    return str;\n  }\n  return remove0x(str);\n}\n\n/**\n * This function converts a hex string to text if it's not a 32 byte hex string.\n *\n * @param hexValue - The hex string to convert to text\n * @returns The text representation of the hex string\n */\nfunction msgHexToText(hexValue: string): string {\n  try {\n    const stripped = safeStripHexPrefix(hexValue);\n    // TODO: Use `@metamask/utils` version of this function to avoid Buffer\n    // usage here.\n    // eslint-disable-next-line no-restricted-globals\n    const buff = Buffer.from(stripped, 'hex');\n    return buff.length === 32 ? hexValue : buff.toString('utf8');\n  } catch (error) {\n    log(error);\n    return hexValue;\n  }\n}\n\n/**\n * @type WrappedSIWERequest\n *\n * Sign-In With Ethereum (SIWE)(EIP-4361) message with request metadata\n *\n * @property from - Subject account address\n * @property origin - The RFC 3986 originating authority of the signing request, including scheme\n * @property siwe - The data parsed from the message\n */\n// This interface was created before this ESLint rule was added.\n// Convert to a `type` in a future major version.\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface WrappedSIWERequest {\n  from: string;\n  origin: string;\n  siwe: SIWEMessage;\n}\n\n// This interface was created before this ESLint rule was added.\n// Convert to a `type` in a future major version.\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\ninterface DomainParts {\n  username?: string;\n  hostname: string;\n  port?: string;\n}\n\nconst DEFAULT_PORTS_BY_PROTOCOL = {\n  'http:': '80',\n  'https:': '443',\n} as Record<string, string>;\n\n/**\n * Parses parts from RFC 3986 authority from EIP-4361 `domain` field.\n *\n * @param domain - input string\n * @param originProtocol - implied protocol from origin\n * @returns parsed parts\n */\nexport const parseDomainParts = (\n  domain: string,\n  originProtocol: string,\n): DomainParts => {\n  if (domain.match(/^[^/:]*:\\/\\//u)) {\n    return new URL(domain);\n  }\n  return new URL(`${originProtocol}//${domain}`);\n};\n\n/**\n * Validates origin of a Sign-In With Ethereum (SIWE)(EIP-4361) request.\n * As per spec:\n * hostname must match.\n * port and username must match iff specified.\n * Protocol binding and full same-origin are currently not performed.\n *\n * @param req - Signature request\n * @returns true if origin matches domain; false otherwise\n */\nexport const isValidSIWEOrigin = (req: WrappedSIWERequest): boolean => {\n  try {\n    const { origin, siwe } = req;\n\n    // origin = scheme://[user[:password]@]domain[:port]\n    // origin is supplied by environment and must match domain claim in message\n    if (!origin || !siwe?.parsedMessage?.domain) {\n      return false;\n    }\n\n    const originParts = new URL(origin);\n    const domainParts = parseDomainParts(\n      siwe.parsedMessage.domain,\n      originParts.protocol,\n    );\n\n    if (\n      domainParts.hostname.localeCompare(originParts.hostname, undefined, {\n        sensitivity: 'accent',\n      }) !== 0\n    ) {\n      return false;\n    }\n\n    if (domainParts.port !== '' && domainParts.port !== originParts.port) {\n      // If origin port is not specified, protocol default is implied\n      return (\n        originParts.port === '' &&\n        domainParts.port === DEFAULT_PORTS_BY_PROTOCOL[originParts.protocol]\n      );\n    }\n\n    if (\n      domainParts.username !== '' &&\n      domainParts.username !== originParts.username\n    ) {\n      return false;\n    }\n\n    return true;\n  } catch (error) {\n    log(error);\n    return false;\n  }\n};\n\n/**\n * A locally defined object used to provide data to identify a Sign-In With Ethereum (SIWE)(EIP-4361) message and provide the parsed message\n *\n * @typedef SIWEMessage\n * @param {boolean} isSIWEMessage - Does the intercepted message conform to the SIWE specification?\n * @param {ParsedMessage} parsedMessage - The data parsed out of the message\n */\nexport type SIWEMessage =\n  | { isSIWEMessage: true; parsedMessage: ParsedMessage }\n  | { isSIWEMessage: false; parsedMessage: null };\n\n/**\n * This function intercepts a sign message, detects if it's a\n * Sign-In With Ethereum (SIWE)(EIP-4361) message, and returns an object with\n * relevant SIWE data.\n *\n * {@see {@link https://eips.ethereum.org/EIPS/eip-4361}}\n *\n * @param msgParams - The params of the message to sign\n * @param msgParams.data - The data of the message to sign\n * @returns An object with the relevant SIWE data\n */\nexport const detectSIWE = (msgParams: { data: string }): SIWEMessage => {\n  try {\n    const { data } = msgParams;\n    const message = msgHexToText(data);\n    const parsedMessage = new ParsedMessage(message);\n\n    return {\n      isSIWEMessage: true,\n      parsedMessage,\n    };\n  } catch {\n    // ignore error, it's not a valid SIWE message\n    return {\n      isSIWEMessage: false,\n      parsedMessage: null,\n    };\n  }\n};\n"]}

package/dist/types.cjs

@@ -0,0 +1,232 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkNickname = exports.BlockExplorerUrl = exports.NetworksTicker = exports.ChainId = exports.BuiltInNetworkName = exports.isInfuraNetworkType = exports.isNetworkType = exports.NetworkType = exports.CustomNetworkType = exports.DEFAULT_INFURA_NETWORKS = exports.InfuraNetworkType = void 0;
+/**
+ * The names of built-in Infura networks
+ */
+exports.InfuraNetworkType = {
+    mainnet: 'mainnet',
+    goerli: 'goerli',
+    sepolia: 'sepolia',
+    'linea-goerli': 'linea-goerli',
+    'linea-sepolia': 'linea-sepolia',
+    'linea-mainnet': 'linea-mainnet',
+    'base-mainnet': 'base-mainnet',
+    'arbitrum-mainnet': 'arbitrum-mainnet',
+    'bsc-mainnet': 'bsc-mainnet',
+    'optimism-mainnet': 'optimism-mainnet',
+    'polygon-mainnet': 'polygon-mainnet',
+    'sei-mainnet': 'sei-mainnet',
+    'monad-mainnet': 'monad-mainnet',
+    'megaeth-mainnet': 'megaeth-mainnet',
+    'avalanche-mainnet': 'avalanche-mainnet',
+    'zksync-mainnet': 'zksync-mainnet',
+};
+/**
+ * The default set of Infura networks to include in the wallet.
+ *
+ * This is a subset of the full list of {@link InfuraNetworkType}, and can be used to determine
+ * which Infura networks to enable by default.
+ */
+exports.DEFAULT_INFURA_NETWORKS = [
+    exports.InfuraNetworkType.mainnet,
+    exports.InfuraNetworkType.goerli,
+    exports.InfuraNetworkType.sepolia,
+    exports.InfuraNetworkType['linea-goerli'],
+    exports.InfuraNetworkType['linea-sepolia'],
+    exports.InfuraNetworkType['linea-mainnet'],
+    exports.InfuraNetworkType['base-mainnet'],
+    exports.InfuraNetworkType['arbitrum-mainnet'],
+    exports.InfuraNetworkType['bsc-mainnet'],
+    exports.InfuraNetworkType['optimism-mainnet'],
+    exports.InfuraNetworkType['polygon-mainnet'],
+    exports.InfuraNetworkType['monad-mainnet'],
+];
+/**
+ * Custom network types that are not part of Infura.
+ */
+exports.CustomNetworkType = {
+    /**
+     * @deprecated `megaeth-testnet` is migrated to `megaeth-testnet-v2`.
+     */
+    'megaeth-testnet': 'megaeth-testnet',
+    'megaeth-testnet-v2': 'megaeth-testnet-v2',
+    'monad-testnet': 'monad-testnet',
+};
+/**
+ * The "network type"; either the name of a built-in network, or "rpc" for custom networks.
+ */
+exports.NetworkType = {
+    ...exports.InfuraNetworkType,
+    ...exports.CustomNetworkType,
+    rpc: 'rpc',
+};
+/**
+ * A helper to determine whether a given input is NetworkType.
+ *
+ * @param val - the value to check whether it is NetworkType or not.
+ * @returns boolean indicating whether or not the argument is NetworkType.
+ */
+function isNetworkType(val) {
+    return Object.values(exports.NetworkType).includes(val);
+}
+exports.isNetworkType = isNetworkType;
+/**
+ * A type guard to determine whether the input is an InfuraNetworkType.
+ *
+ * @param value - The value to check.
+ * @returns True if the given value is within the InfuraNetworkType enum,
+ * false otherwise.
+ */
+function isInfuraNetworkType(value) {
+    const infuraNetworkTypes = Object.keys(exports.InfuraNetworkType);
+    return infuraNetworkTypes.includes(value);
+}
+exports.isInfuraNetworkType = isInfuraNetworkType;
+/**
+ * Names of networks built into the wallet.
+ *
+ * This includes both Infura and non-Infura networks.
+ */
+var BuiltInNetworkName;
+(function (BuiltInNetworkName) {
+    BuiltInNetworkName["Mainnet"] = "mainnet";
+    BuiltInNetworkName["Goerli"] = "goerli";
+    BuiltInNetworkName["Sepolia"] = "sepolia";
+    BuiltInNetworkName["LineaGoerli"] = "linea-goerli";
+    BuiltInNetworkName["LineaSepolia"] = "linea-sepolia";
+    BuiltInNetworkName["LineaMainnet"] = "linea-mainnet";
+    BuiltInNetworkName["Aurora"] = "aurora";
+    /**
+     * @deprecated `MegaETHTestnet` is migrated to `MegaETHTestnetV2`.
+     */
+    BuiltInNetworkName["MegaETHTestnet"] = "megaeth-testnet";
+    BuiltInNetworkName["MegaETHTestnetV2"] = "megaeth-testnet-v2";
+    BuiltInNetworkName["MonadTestnet"] = "monad-testnet";
+    BuiltInNetworkName["BaseMainnet"] = "base-mainnet";
+    BuiltInNetworkName["ArbitrumOne"] = "arbitrum-mainnet";
+    BuiltInNetworkName["BscMainnet"] = "bsc-mainnet";
+    BuiltInNetworkName["OptimismMainnet"] = "optimism-mainnet";
+    BuiltInNetworkName["PolygonMainnet"] = "polygon-mainnet";
+    BuiltInNetworkName["SeiMainnet"] = "sei-mainnet";
+    BuiltInNetworkName["MegaETHMainnet"] = "megaeth-mainnet";
+    BuiltInNetworkName["MonadMainnet"] = "monad-mainnet";
+    BuiltInNetworkName["AvalancheMainnet"] = "avalanche-mainnet";
+    BuiltInNetworkName["ZksyncMainnet"] = "zksync-mainnet";
+})(BuiltInNetworkName || (exports.BuiltInNetworkName = BuiltInNetworkName = {}));
+/**
+ * Decimal string chain IDs of built-in networks, by name.
+ *
+ * `toHex` not invoked to avoid cyclic dependency
+ */
+exports.ChainId = {
+    [BuiltInNetworkName.Mainnet]: '0x1', // toHex(1)
+    [BuiltInNetworkName.Goerli]: '0x5', // toHex(5)
+    [BuiltInNetworkName.Sepolia]: '0xaa36a7', // toHex(11155111)
+    [BuiltInNetworkName.Aurora]: '0x4e454152', // toHex(1313161554)
+    [BuiltInNetworkName.LineaGoerli]: '0xe704', // toHex(59140)
+    [BuiltInNetworkName.LineaSepolia]: '0xe705', // toHex(59141)
+    [BuiltInNetworkName.LineaMainnet]: '0xe708', // toHex(59144)
+    /**
+     * @deprecated `MegaETHTestnet` is migrated to `MegaETHTestnetV2`.
+     */
+    [BuiltInNetworkName.MegaETHTestnet]: '0x18c6', // toHex(6342)
+    [BuiltInNetworkName.MegaETHTestnetV2]: '0x18c7', // toHex(6343)
+    [BuiltInNetworkName.MonadTestnet]: '0x279f', // toHex(10143)
+    [BuiltInNetworkName.BaseMainnet]: '0x2105', // toHex(8453)
+    [BuiltInNetworkName.ArbitrumOne]: '0xa4b1', // toHex(42161)
+    [BuiltInNetworkName.BscMainnet]: '0x38', // toHex(56)
+    [BuiltInNetworkName.OptimismMainnet]: '0xa', // toHex(10)
+    [BuiltInNetworkName.PolygonMainnet]: '0x89', // toHex(137)
+    [BuiltInNetworkName.SeiMainnet]: '0x531', // toHex(1329)
+    [BuiltInNetworkName.MegaETHMainnet]: '0x10e6', // toHex(4326)
+    [BuiltInNetworkName.MonadMainnet]: '0x8f', // toHex(143)
+    [BuiltInNetworkName.AvalancheMainnet]: '0xa86a', // toHex(43114)
+    [BuiltInNetworkName.ZksyncMainnet]: '0x144', // toHex(324)
+};
+/* eslint-disable @typescript-eslint/naming-convention */
+var NetworksTicker;
+(function (NetworksTicker) {
+    NetworksTicker["mainnet"] = "ETH";
+    NetworksTicker["goerli"] = "GoerliETH";
+    NetworksTicker["sepolia"] = "SepoliaETH";
+    NetworksTicker["linea-goerli"] = "LineaETH";
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
+    NetworksTicker["linea-sepolia"] = "LineaETH";
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
+    NetworksTicker["linea-mainnet"] = "ETH";
+    /**
+     * @deprecated `megaeth-testnet` is migrated to `megaeth-testnet-v2`.
+     */
+    NetworksTicker["megaeth-testnet"] = "MegaETH";
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
+    NetworksTicker["megaeth-testnet-v2"] = "MegaETH";
+    NetworksTicker["monad-testnet"] = "MON";
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
+    NetworksTicker["base-mainnet"] = "ETH";
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
+    NetworksTicker["arbitrum-mainnet"] = "ETH";
+    NetworksTicker["bsc-mainnet"] = "BNB";
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
+    NetworksTicker["optimism-mainnet"] = "ETH";
+    NetworksTicker["polygon-mainnet"] = "POL";
+    NetworksTicker["sei-mainnet"] = "SEI";
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
+    NetworksTicker["megaeth-mainnet"] = "ETH";
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
+    NetworksTicker["monad-mainnet"] = "MON";
+    NetworksTicker["avalanche-mainnet"] = "AVAX";
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
+    NetworksTicker["zksync-mainnet"] = "ETH";
+    NetworksTicker["rpc"] = "";
+})(NetworksTicker || (exports.NetworksTicker = NetworksTicker = {}));
+/* eslint-enable @typescript-eslint/naming-convention */
+exports.BlockExplorerUrl = {
+    [BuiltInNetworkName.Mainnet]: 'https://etherscan.io',
+    [BuiltInNetworkName.Goerli]: 'https://goerli.etherscan.io',
+    [BuiltInNetworkName.Sepolia]: 'https://sepolia.etherscan.io',
+    [BuiltInNetworkName.LineaGoerli]: 'https://goerli.lineascan.build',
+    [BuiltInNetworkName.LineaSepolia]: 'https://sepolia.lineascan.build',
+    [BuiltInNetworkName.LineaMainnet]: 'https://lineascan.build',
+    /**
+     * @deprecated `MegaETHTestnet` is migrated to `MegaETHTestnetV2`.
+     */
+    [BuiltInNetworkName.MegaETHTestnet]: 'https://megaexplorer.xyz',
+    [BuiltInNetworkName.MegaETHTestnetV2]: 'https://megaeth-testnet-v2.blockscout.com',
+    [BuiltInNetworkName.MonadTestnet]: 'https://testnet.monadexplorer.com',
+    [BuiltInNetworkName.BaseMainnet]: 'https://basescan.org',
+    [BuiltInNetworkName.ArbitrumOne]: 'https://arbiscan.io',
+    [BuiltInNetworkName.BscMainnet]: 'https://bscscan.com',
+    [BuiltInNetworkName.OptimismMainnet]: 'https://optimistic.etherscan.io',
+    [BuiltInNetworkName.PolygonMainnet]: 'https://polygonscan.com',
+    [BuiltInNetworkName.SeiMainnet]: 'https://seiscan.io',
+    [BuiltInNetworkName.MegaETHMainnet]: 'https://megaeth.blockscout.com',
+    [BuiltInNetworkName.MonadMainnet]: 'https://monadscan.com',
+    [BuiltInNetworkName.AvalancheMainnet]: 'https://snowtrace.io',
+    [BuiltInNetworkName.ZksyncMainnet]: 'https://explorer.zksync.io',
+};
+exports.NetworkNickname = {
+    [BuiltInNetworkName.Mainnet]: 'Ethereum',
+    [BuiltInNetworkName.Goerli]: 'Goerli',
+    [BuiltInNetworkName.Sepolia]: 'Sepolia',
+    [BuiltInNetworkName.LineaGoerli]: 'Linea Goerli',
+    [BuiltInNetworkName.LineaSepolia]: 'Linea Sepolia',
+    [BuiltInNetworkName.LineaMainnet]: 'Linea',
+    /**
+     * @deprecated `MegaETHTestnet` is migrated to `MegaETHTestnetV2`.
+     */
+    [BuiltInNetworkName.MegaETHTestnet]: 'Mega Testnet',
+    [BuiltInNetworkName.MegaETHTestnetV2]: 'MegaETH Testnet',
+    [BuiltInNetworkName.MonadTestnet]: 'Monad Testnet',
+    [BuiltInNetworkName.BaseMainnet]: 'Base',
+    [BuiltInNetworkName.ArbitrumOne]: 'Arbitrum',
+    [BuiltInNetworkName.BscMainnet]: 'BNB Chain',
+    [BuiltInNetworkName.OptimismMainnet]: 'OP',
+    [BuiltInNetworkName.PolygonMainnet]: 'Polygon',
+    [BuiltInNetworkName.SeiMainnet]: 'Sei Mainnet',
+    [BuiltInNetworkName.MegaETHMainnet]: 'MegaETH Mainnet',
+    [BuiltInNetworkName.MonadMainnet]: 'Monad',
+    [BuiltInNetworkName.AvalancheMainnet]: 'Avalanche Mainnet',
+    [BuiltInNetworkName.ZksyncMainnet]: 'ZKsync Era',
+};
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The names of built-in Infura networks\n */\nexport const InfuraNetworkType = {\n  mainnet: 'mainnet',\n  goerli: 'goerli',\n  sepolia: 'sepolia',\n  'linea-goerli': 'linea-goerli',\n  'linea-sepolia': 'linea-sepolia',\n  'linea-mainnet': 'linea-mainnet',\n  'base-mainnet': 'base-mainnet',\n  'arbitrum-mainnet': 'arbitrum-mainnet',\n  'bsc-mainnet': 'bsc-mainnet',\n  'optimism-mainnet': 'optimism-mainnet',\n  'polygon-mainnet': 'polygon-mainnet',\n  'sei-mainnet': 'sei-mainnet',\n  'monad-mainnet': 'monad-mainnet',\n  'megaeth-mainnet': 'megaeth-mainnet',\n  'avalanche-mainnet': 'avalanche-mainnet',\n  'zksync-mainnet': 'zksync-mainnet',\n} as const;\n\nexport type InfuraNetworkType =\n  (typeof InfuraNetworkType)[keyof typeof InfuraNetworkType];\n\n/**\n * The default set of Infura networks to include in the wallet.\n *\n * This is a subset of the full list of {@link InfuraNetworkType}, and can be used to determine\n * which Infura networks to enable by default.\n */\nexport const DEFAULT_INFURA_NETWORKS = [\n  InfuraNetworkType.mainnet,\n  InfuraNetworkType.goerli,\n  InfuraNetworkType.sepolia,\n  InfuraNetworkType['linea-goerli'],\n  InfuraNetworkType['linea-sepolia'],\n  InfuraNetworkType['linea-mainnet'],\n  InfuraNetworkType['base-mainnet'],\n  InfuraNetworkType['arbitrum-mainnet'],\n  InfuraNetworkType['bsc-mainnet'],\n  InfuraNetworkType['optimism-mainnet'],\n  InfuraNetworkType['polygon-mainnet'],\n  InfuraNetworkType['monad-mainnet'],\n] as const satisfies InfuraNetworkType[];\n\n/**\n * Custom network types that are not part of Infura.\n */\nexport const CustomNetworkType = {\n  /**\n   * @deprecated `megaeth-testnet` is migrated to `megaeth-testnet-v2`.\n   */\n  'megaeth-testnet': 'megaeth-testnet',\n  'megaeth-testnet-v2': 'megaeth-testnet-v2',\n  'monad-testnet': 'monad-testnet',\n} as const;\nexport type CustomNetworkType =\n  (typeof CustomNetworkType)[keyof typeof CustomNetworkType];\n\n/**\n * Network types supported including both Infura networks and other networks.\n */\nexport type BuiltInNetworkType = InfuraNetworkType | CustomNetworkType;\n\n/**\n * The \"network type\"; either the name of a built-in network, or \"rpc\" for custom networks.\n */\nexport const NetworkType = {\n  ...InfuraNetworkType,\n  ...CustomNetworkType,\n  rpc: 'rpc',\n} as const;\n\nexport type NetworkType = (typeof NetworkType)[keyof typeof NetworkType];\n\n/**\n * A helper to determine whether a given input is NetworkType.\n *\n * @param val - the value to check whether it is NetworkType or not.\n * @returns boolean indicating whether or not the argument is NetworkType.\n */\nexport function isNetworkType(val: string): val is NetworkType {\n  return Object.values(NetworkType).includes(val as NetworkType);\n}\n\n/**\n * A type guard to determine whether the input is an InfuraNetworkType.\n *\n * @param value - The value to check.\n * @returns True if the given value is within the InfuraNetworkType enum,\n * false otherwise.\n */\nexport function isInfuraNetworkType(\n  value: unknown,\n): value is InfuraNetworkType {\n  const infuraNetworkTypes: unknown[] = Object.keys(InfuraNetworkType);\n  return infuraNetworkTypes.includes(value);\n}\n\n/**\n * Names of networks built into the wallet.\n *\n * This includes both Infura and non-Infura networks.\n */\nexport enum BuiltInNetworkName {\n  Mainnet = 'mainnet',\n  Goerli = 'goerli',\n  Sepolia = 'sepolia',\n  LineaGoerli = 'linea-goerli',\n  LineaSepolia = 'linea-sepolia',\n  LineaMainnet = 'linea-mainnet',\n  Aurora = 'aurora',\n  /**\n   * @deprecated `MegaETHTestnet` is migrated to `MegaETHTestnetV2`.\n   */\n  MegaETHTestnet = 'megaeth-testnet',\n  MegaETHTestnetV2 = 'megaeth-testnet-v2',\n  MonadTestnet = 'monad-testnet',\n  BaseMainnet = 'base-mainnet',\n  ArbitrumOne = 'arbitrum-mainnet',\n  BscMainnet = 'bsc-mainnet',\n  OptimismMainnet = 'optimism-mainnet',\n  PolygonMainnet = 'polygon-mainnet',\n  SeiMainnet = 'sei-mainnet',\n  MegaETHMainnet = 'megaeth-mainnet',\n  MonadMainnet = 'monad-mainnet',\n  AvalancheMainnet = 'avalanche-mainnet',\n  ZksyncMainnet = 'zksync-mainnet',\n}\n\n/**\n * Decimal string chain IDs of built-in networks, by name.\n *\n * `toHex` not invoked to avoid cyclic dependency\n */\nexport const ChainId = {\n  [BuiltInNetworkName.Mainnet]: '0x1', // toHex(1)\n  [BuiltInNetworkName.Goerli]: '0x5', // toHex(5)\n  [BuiltInNetworkName.Sepolia]: '0xaa36a7', // toHex(11155111)\n  [BuiltInNetworkName.Aurora]: '0x4e454152', // toHex(1313161554)\n  [BuiltInNetworkName.LineaGoerli]: '0xe704', // toHex(59140)\n  [BuiltInNetworkName.LineaSepolia]: '0xe705', // toHex(59141)\n  [BuiltInNetworkName.LineaMainnet]: '0xe708', // toHex(59144)\n  /**\n   * @deprecated `MegaETHTestnet` is migrated to `MegaETHTestnetV2`.\n   */\n  [BuiltInNetworkName.MegaETHTestnet]: '0x18c6', // toHex(6342)\n  [BuiltInNetworkName.MegaETHTestnetV2]: '0x18c7', // toHex(6343)\n  [BuiltInNetworkName.MonadTestnet]: '0x279f', // toHex(10143)\n  [BuiltInNetworkName.BaseMainnet]: '0x2105', // toHex(8453)\n  [BuiltInNetworkName.ArbitrumOne]: '0xa4b1', // toHex(42161)\n  [BuiltInNetworkName.BscMainnet]: '0x38', // toHex(56)\n  [BuiltInNetworkName.OptimismMainnet]: '0xa', // toHex(10)\n  [BuiltInNetworkName.PolygonMainnet]: '0x89', // toHex(137)\n  [BuiltInNetworkName.SeiMainnet]: '0x531', // toHex(1329)\n  [BuiltInNetworkName.MegaETHMainnet]: '0x10e6', // toHex(4326)\n  [BuiltInNetworkName.MonadMainnet]: '0x8f', // toHex(143)\n  [BuiltInNetworkName.AvalancheMainnet]: '0xa86a', // toHex(43114)\n  [BuiltInNetworkName.ZksyncMainnet]: '0x144', // toHex(324)\n} as const;\nexport type ChainId = (typeof ChainId)[keyof typeof ChainId];\n\n/* eslint-disable @typescript-eslint/naming-convention */\nexport enum NetworksTicker {\n  mainnet = 'ETH',\n  goerli = 'GoerliETH',\n  sepolia = 'SepoliaETH',\n  'linea-goerli' = 'LineaETH',\n  // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values\n  'linea-sepolia' = 'LineaETH',\n  // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values\n  'linea-mainnet' = 'ETH',\n  /**\n   * @deprecated `megaeth-testnet` is migrated to `megaeth-testnet-v2`.\n   */\n  'megaeth-testnet' = 'MegaETH',\n  // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values\n  'megaeth-testnet-v2' = 'MegaETH',\n  'monad-testnet' = 'MON',\n  // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values\n  'base-mainnet' = 'ETH',\n  // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values\n  'arbitrum-mainnet' = 'ETH',\n  'bsc-mainnet' = 'BNB',\n  // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values\n  'optimism-mainnet' = 'ETH',\n  'polygon-mainnet' = 'POL',\n  'sei-mainnet' = 'SEI',\n  // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values\n  'megaeth-mainnet' = 'ETH',\n  // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values\n  'monad-mainnet' = 'MON',\n  'avalanche-mainnet' = 'AVAX',\n  // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values\n  'zksync-mainnet' = 'ETH',\n  rpc = '',\n}\n/* eslint-enable @typescript-eslint/naming-convention */\n\nexport const BlockExplorerUrl = {\n  [BuiltInNetworkName.Mainnet]: 'https://etherscan.io',\n  [BuiltInNetworkName.Goerli]: 'https://goerli.etherscan.io',\n  [BuiltInNetworkName.Sepolia]: 'https://sepolia.etherscan.io',\n  [BuiltInNetworkName.LineaGoerli]: 'https://goerli.lineascan.build',\n  [BuiltInNetworkName.LineaSepolia]: 'https://sepolia.lineascan.build',\n  [BuiltInNetworkName.LineaMainnet]: 'https://lineascan.build',\n  /**\n   * @deprecated `MegaETHTestnet` is migrated to `MegaETHTestnetV2`.\n   */\n  [BuiltInNetworkName.MegaETHTestnet]: 'https://megaexplorer.xyz',\n  [BuiltInNetworkName.MegaETHTestnetV2]:\n    'https://megaeth-testnet-v2.blockscout.com',\n  [BuiltInNetworkName.MonadTestnet]: 'https://testnet.monadexplorer.com',\n  [BuiltInNetworkName.BaseMainnet]: 'https://basescan.org',\n  [BuiltInNetworkName.ArbitrumOne]: 'https://arbiscan.io',\n  [BuiltInNetworkName.BscMainnet]: 'https://bscscan.com',\n  [BuiltInNetworkName.OptimismMainnet]: 'https://optimistic.etherscan.io',\n  [BuiltInNetworkName.PolygonMainnet]: 'https://polygonscan.com',\n  [BuiltInNetworkName.SeiMainnet]: 'https://seiscan.io',\n  [BuiltInNetworkName.MegaETHMainnet]: 'https://megaeth.blockscout.com',\n  [BuiltInNetworkName.MonadMainnet]: 'https://monadscan.com',\n  [BuiltInNetworkName.AvalancheMainnet]: 'https://snowtrace.io',\n  [BuiltInNetworkName.ZksyncMainnet]: 'https://explorer.zksync.io',\n} as const satisfies Record<BuiltInNetworkType, string>;\nexport type BlockExplorerUrl =\n  (typeof BlockExplorerUrl)[keyof typeof BlockExplorerUrl];\n\nexport const NetworkNickname = {\n  [BuiltInNetworkName.Mainnet]: 'Ethereum',\n  [BuiltInNetworkName.Goerli]: 'Goerli',\n  [BuiltInNetworkName.Sepolia]: 'Sepolia',\n  [BuiltInNetworkName.LineaGoerli]: 'Linea Goerli',\n  [BuiltInNetworkName.LineaSepolia]: 'Linea Sepolia',\n  [BuiltInNetworkName.LineaMainnet]: 'Linea',\n  /**\n   * @deprecated `MegaETHTestnet` is migrated to `MegaETHTestnetV2`.\n   */\n  [BuiltInNetworkName.MegaETHTestnet]: 'Mega Testnet',\n  [BuiltInNetworkName.MegaETHTestnetV2]: 'MegaETH Testnet',\n  [BuiltInNetworkName.MonadTestnet]: 'Monad Testnet',\n  [BuiltInNetworkName.BaseMainnet]: 'Base',\n  [BuiltInNetworkName.ArbitrumOne]: 'Arbitrum',\n  [BuiltInNetworkName.BscMainnet]: 'BNB Chain',\n  [BuiltInNetworkName.OptimismMainnet]: 'OP',\n  [BuiltInNetworkName.PolygonMainnet]: 'Polygon',\n  [BuiltInNetworkName.SeiMainnet]: 'Sei Mainnet',\n  [BuiltInNetworkName.MegaETHMainnet]: 'MegaETH Mainnet',\n  [BuiltInNetworkName.MonadMainnet]: 'Monad',\n  [BuiltInNetworkName.AvalancheMainnet]: 'Avalanche Mainnet',\n  [BuiltInNetworkName.ZksyncMainnet]: 'ZKsync Era',\n} as const satisfies Record<BuiltInNetworkType, string>;\nexport type NetworkNickname =\n  (typeof NetworkNickname)[keyof typeof NetworkNickname];\n\n/**\n * Makes a selection of keys in a Record optional.\n *\n * @template Type - The Record that you want to operate on.\n * @template Key - The union of keys you want to make optional.\n */\n// TODO: Move to @metamask/utils\nexport type Partialize<Type, Key extends keyof Type> = Omit<Type, Key> &\n  Partial<Pick<Type, Key>>;\n\n/** A context in which to execute a trace, in order to generate nested timings. */\nexport type TraceContext = unknown;\n\n/** Request to trace an operation. */\nexport type TraceRequest = {\n  /** Additional data to include in the trace. */\n  data?: Record<string, number | string | boolean>;\n\n  /** Name of the operation. */\n  name: string;\n\n  /**\n   * Unique identifier for the trace.\n   * Required if starting a trace and not providing a callback.\n   */\n  id?: string;\n\n  /** Trace context in which to execute the operation. */\n  parentContext?: TraceContext;\n\n  /** Additional tags to include in the trace to filter results. */\n  tags?: Record<string, number | string | boolean>;\n\n  /**\n   * Override the start time of the trace, in milliseconds.\n   * Useful to backdate a span when the traced work has already completed.\n   */\n  startTime?: number;\n};\n\n/** Callback that traces the performance of an operation. */\nexport type TraceCallback = <ReturnType>(\n  /** Request to trace the performance of an operation. */\n  request: TraceRequest,\n\n  /**\n   * Callback to trace.\n   * Thrown errors will not be caught, but the trace will still be recorded.\n   *\n   * @param context - The context in which the operation is running.\n   */\n  fn?: (context?: TraceContext) => ReturnType,\n) => Promise<ReturnType>;\n"]}