@metamask/utils 8.0.0 → 8.2.0

package/CHANGELOG.md

@@ -6,6 +6,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [8.2.0]
+### Added
+- Add struct utils for validating JSON objects with optional values ([#136](https://github.com/MetaMask/utils/pull/136))
+- Add filesystem utils ([#148](https://github.com/MetaMask/utils/pull/148))
+- Add error utils ([#146](https://github.com/MetaMask/utils/pull/146), [#151](https://github.com/MetaMask/utils/pull/151))
+- Add base64 encoding and decoding functions ([#145](https://github.com/MetaMask/utils/pull/145))
+
+### Changed
+- Use `tsup` for bundling ([#144](https://github.com/MetaMask/utils/pull/144))
+  - This makes the package fully compliant with ES modules.
+- Bump `@ethereumjs/tx` from `4.1.2` to `4.2.0` ([#133](https://github.com/MetaMask/utils/pull/133))
+
+## [8.1.0]
+### Changed
+- Make types for JSON-RPC-related structs more accurate ([#134](https://github.com/MetaMask/utils/pull/134))
+  - Aligning `JsonRpcParams` to be optional, yet not `undefined`.
+  - Updated types:
+    - `InferWithParams`
+    - `JsonRpcNotificationStruct`
+    - `JsonRpcParamsStruct`
+    - `JsonRpcRequestStruct`
+
 ## [8.0.0]
 ### Changed
 - **BREAKING:** `JsonRpcParams` type no longer accepts `undefined` as value, as `undefined` is not a valid JSON type ([#130](https://github.com/MetaMask/utils/pull/130))
@@ -182,7 +204,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 - Initial release
 
-[Unreleased]: https://github.com/MetaMask/utils/compare/v8.0.0...HEAD
+[Unreleased]: https://github.com/MetaMask/utils/compare/v8.2.0...HEAD
+[8.2.0]: https://github.com/MetaMask/utils/compare/v8.1.0...v8.2.0
+[8.1.0]: https://github.com/MetaMask/utils/compare/v8.0.0...v8.1.0
 [8.0.0]: https://github.com/MetaMask/utils/compare/v7.1.0...v8.0.0
 [7.1.0]: https://github.com/MetaMask/utils/compare/v7.0.0...v7.1.0
 [7.0.0]: https://github.com/MetaMask/utils/compare/v6.2.0...v7.0.0

package/dist/assert.js

@@ -0,0 +1,16 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+var _chunkVBYRLAP6js = require('./chunk-VBYRLAP6.js');
+require('./chunk-DMPG3H3G.js');
+require('./chunk-QVEKZRZ2.js');
+require('./chunk-3W5G4CYI.js');
+
+
+
+
+
+exports.AssertionError = _chunkVBYRLAP6js.AssertionError; exports.assert = _chunkVBYRLAP6js.assert; exports.assertExhaustive = _chunkVBYRLAP6js.assertExhaustive; exports.assertStruct = _chunkVBYRLAP6js.assertStruct;
+//# sourceMappingURL=assert.js.map

package/dist/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":""}

package/dist/assert.mjs

@@ -0,0 +1,16 @@
+import {
+  AssertionError,
+  assert,
+  assertExhaustive,
+  assertStruct
+} from "./chunk-CSDMTDND.mjs";
+import "./chunk-7S5AWFX7.mjs";
+import "./chunk-H4YFDLB7.mjs";
+import "./chunk-X66SUIEF.mjs";
+export {
+  AssertionError,
+  assert,
+  assertExhaustive,
+  assertStruct
+};
+//# sourceMappingURL=assert.mjs.map

package/dist/assert.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/base64.js

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkWRBN6DWMjs = require('./chunk-WRBN6DWM.js');
+require('./chunk-VBYRLAP6.js');
+require('./chunk-DMPG3H3G.js');
+require('./chunk-QVEKZRZ2.js');
+require('./chunk-3W5G4CYI.js');
+
+
+exports.base64 = _chunkWRBN6DWMjs.base64;
+//# sourceMappingURL=base64.js.map

package/dist/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":""}

package/dist/base64.mjs

@@ -0,0 +1,11 @@
+import {
+  base64
+} from "./chunk-HLDWS2JR.mjs";
+import "./chunk-CSDMTDND.mjs";
+import "./chunk-7S5AWFX7.mjs";
+import "./chunk-H4YFDLB7.mjs";
+import "./chunk-X66SUIEF.mjs";
+export {
+  base64
+};
+//# sourceMappingURL=base64.mjs.map

package/dist/base64.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/bytes.js

@@ -0,0 +1,43 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunkYQJBIHC7js = require('./chunk-YQJBIHC7.js');
+require('./chunk-VBYRLAP6.js');
+require('./chunk-DMPG3H3G.js');
+require('./chunk-QVEKZRZ2.js');
+require('./chunk-3W5G4CYI.js');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.assertIsBytes = _chunkYQJBIHC7js.assertIsBytes; exports.base64ToBytes = _chunkYQJBIHC7js.base64ToBytes; exports.bigIntToBytes = _chunkYQJBIHC7js.bigIntToBytes; exports.bytesToBase64 = _chunkYQJBIHC7js.bytesToBase64; exports.bytesToBigInt = _chunkYQJBIHC7js.bytesToBigInt; exports.bytesToHex = _chunkYQJBIHC7js.bytesToHex; exports.bytesToNumber = _chunkYQJBIHC7js.bytesToNumber; exports.bytesToSignedBigInt = _chunkYQJBIHC7js.bytesToSignedBigInt; exports.bytesToString = _chunkYQJBIHC7js.bytesToString; exports.concatBytes = _chunkYQJBIHC7js.concatBytes; exports.createDataView = _chunkYQJBIHC7js.createDataView; exports.hexToBytes = _chunkYQJBIHC7js.hexToBytes; exports.isBytes = _chunkYQJBIHC7js.isBytes; exports.numberToBytes = _chunkYQJBIHC7js.numberToBytes; exports.signedBigIntToBytes = _chunkYQJBIHC7js.signedBigIntToBytes; exports.stringToBytes = _chunkYQJBIHC7js.stringToBytes; exports.valueToBytes = _chunkYQJBIHC7js.valueToBytes;
+//# sourceMappingURL=bytes.js.map

package/dist/bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":""}

package/dist/bytes.mjs

@@ -0,0 +1,43 @@
+import {
+  assertIsBytes,
+  base64ToBytes,
+  bigIntToBytes,
+  bytesToBase64,
+  bytesToBigInt,
+  bytesToHex,
+  bytesToNumber,
+  bytesToSignedBigInt,
+  bytesToString,
+  concatBytes,
+  createDataView,
+  hexToBytes,
+  isBytes,
+  numberToBytes,
+  signedBigIntToBytes,
+  stringToBytes,
+  valueToBytes
+} from "./chunk-BKR45GQY.mjs";
+import "./chunk-CSDMTDND.mjs";
+import "./chunk-7S5AWFX7.mjs";
+import "./chunk-H4YFDLB7.mjs";
+import "./chunk-X66SUIEF.mjs";
+export {
+  assertIsBytes,
+  base64ToBytes,
+  bigIntToBytes,
+  bytesToBase64,
+  bytesToBigInt,
+  bytesToHex,
+  bytesToNumber,
+  bytesToSignedBigInt,
+  bytesToString,
+  concatBytes,
+  createDataView,
+  hexToBytes,
+  isBytes,
+  numberToBytes,
+  signedBigIntToBytes,
+  stringToBytes,
+  valueToBytes
+};
+//# sourceMappingURL=bytes.mjs.map

package/dist/bytes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/caip-types.js

@@ -0,0 +1,40 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunkU7ZUGCE7js = require('./chunk-U7ZUGCE7.js');
+require('./chunk-3W5G4CYI.js');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.CAIP_ACCOUNT_ADDRESS_REGEX = _chunkU7ZUGCE7js.CAIP_ACCOUNT_ADDRESS_REGEX; exports.CAIP_ACCOUNT_ID_REGEX = _chunkU7ZUGCE7js.CAIP_ACCOUNT_ID_REGEX; exports.CAIP_CHAIN_ID_REGEX = _chunkU7ZUGCE7js.CAIP_CHAIN_ID_REGEX; exports.CAIP_NAMESPACE_REGEX = _chunkU7ZUGCE7js.CAIP_NAMESPACE_REGEX; exports.CAIP_REFERENCE_REGEX = _chunkU7ZUGCE7js.CAIP_REFERENCE_REGEX; exports.CaipAccountAddressStruct = _chunkU7ZUGCE7js.CaipAccountAddressStruct; exports.CaipAccountIdStruct = _chunkU7ZUGCE7js.CaipAccountIdStruct; exports.CaipChainIdStruct = _chunkU7ZUGCE7js.CaipChainIdStruct; exports.CaipNamespaceStruct = _chunkU7ZUGCE7js.CaipNamespaceStruct; exports.CaipReferenceStruct = _chunkU7ZUGCE7js.CaipReferenceStruct; exports.isCaipAccountAddress = _chunkU7ZUGCE7js.isCaipAccountAddress; exports.isCaipAccountId = _chunkU7ZUGCE7js.isCaipAccountId; exports.isCaipChainId = _chunkU7ZUGCE7js.isCaipChainId; exports.isCaipNamespace = _chunkU7ZUGCE7js.isCaipNamespace; exports.isCaipReference = _chunkU7ZUGCE7js.isCaipReference; exports.parseCaipAccountId = _chunkU7ZUGCE7js.parseCaipAccountId; exports.parseCaipChainId = _chunkU7ZUGCE7js.parseCaipChainId;
+//# sourceMappingURL=caip-types.js.map

package/dist/caip-types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":""}

package/dist/caip-types.mjs

@@ -0,0 +1,40 @@
+import {
+  CAIP_ACCOUNT_ADDRESS_REGEX,
+  CAIP_ACCOUNT_ID_REGEX,
+  CAIP_CHAIN_ID_REGEX,
+  CAIP_NAMESPACE_REGEX,
+  CAIP_REFERENCE_REGEX,
+  CaipAccountAddressStruct,
+  CaipAccountIdStruct,
+  CaipChainIdStruct,
+  CaipNamespaceStruct,
+  CaipReferenceStruct,
+  isCaipAccountAddress,
+  isCaipAccountId,
+  isCaipChainId,
+  isCaipNamespace,
+  isCaipReference,
+  parseCaipAccountId,
+  parseCaipChainId
+} from "./chunk-TGOMTREC.mjs";
+import "./chunk-X66SUIEF.mjs";
+export {
+  CAIP_ACCOUNT_ADDRESS_REGEX,
+  CAIP_ACCOUNT_ID_REGEX,
+  CAIP_CHAIN_ID_REGEX,
+  CAIP_NAMESPACE_REGEX,
+  CAIP_REFERENCE_REGEX,
+  CaipAccountAddressStruct,
+  CaipAccountIdStruct,
+  CaipChainIdStruct,
+  CaipNamespaceStruct,
+  CaipReferenceStruct,
+  isCaipAccountAddress,
+  isCaipAccountId,
+  isCaipChainId,
+  isCaipNamespace,
+  isCaipReference,
+  parseCaipAccountId,
+  parseCaipChainId
+};
+//# sourceMappingURL=caip-types.mjs.map

package/dist/caip-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/checksum.js

@@ -0,0 +1,12 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkXYYGZF5Yjs = require('./chunk-XYYGZF5Y.js');
+require('./chunk-WRBN6DWM.js');
+require('./chunk-VBYRLAP6.js');
+require('./chunk-DMPG3H3G.js');
+require('./chunk-QVEKZRZ2.js');
+require('./chunk-3W5G4CYI.js');
+
+
+exports.ChecksumStruct = _chunkXYYGZF5Yjs.ChecksumStruct;
+//# sourceMappingURL=checksum.js.map

package/dist/checksum.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":""}

package/dist/checksum.mjs

@@ -0,0 +1,12 @@
+import {
+  ChecksumStruct
+} from "./chunk-N53OILN6.mjs";
+import "./chunk-HLDWS2JR.mjs";
+import "./chunk-CSDMTDND.mjs";
+import "./chunk-7S5AWFX7.mjs";
+import "./chunk-H4YFDLB7.mjs";
+import "./chunk-X66SUIEF.mjs";
+export {
+  ChecksumStruct
+};
+//# sourceMappingURL=checksum.mjs.map

package/dist/checksum.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-2CY4F77D.mjs

@@ -0,0 +1,95 @@
+import {
+  StrictHexStruct,
+  bytesToHex,
+  hexToBytes
+} from "./chunk-BKR45GQY.mjs";
+import {
+  assert
+} from "./chunk-CSDMTDND.mjs";
+
+// src/coercers.ts
+import {
+  bigint,
+  coerce,
+  create,
+  instance,
+  number,
+  string,
+  StructError,
+  union
+} from "superstruct";
+var NumberLikeStruct = union([number(), bigint(), string(), StrictHexStruct]);
+var NumberCoercer = coerce(number(), NumberLikeStruct, Number);
+var BigIntCoercer = coerce(bigint(), NumberLikeStruct, BigInt);
+var BytesLikeStruct = union([StrictHexStruct, instance(Uint8Array)]);
+var BytesCoercer = coerce(
+  instance(Uint8Array),
+  union([StrictHexStruct]),
+  hexToBytes
+);
+var HexCoercer = coerce(StrictHexStruct, instance(Uint8Array), bytesToHex);
+function createNumber(value) {
+  try {
+    const result = create(value, NumberCoercer);
+    assert(
+      Number.isFinite(result),
+      `Expected a number-like value, got "${value}".`
+    );
+    return result;
+  } catch (error) {
+    if (error instanceof StructError) {
+      throw new Error(`Expected a number-like value, got "${value}".`);
+    }
+    throw error;
+  }
+}
+function createBigInt(value) {
+  try {
+    return create(value, BigIntCoercer);
+  } catch (error) {
+    if (error instanceof StructError) {
+      throw new Error(
+        `Expected a number-like value, got "${String(error.value)}".`
+      );
+    }
+    throw error;
+  }
+}
+function createBytes(value) {
+  if (typeof value === "string" && value.toLowerCase() === "0x") {
+    return new Uint8Array();
+  }
+  try {
+    return create(value, BytesCoercer);
+  } catch (error) {
+    if (error instanceof StructError) {
+      throw new Error(
+        `Expected a bytes-like value, got "${String(error.value)}".`
+      );
+    }
+    throw error;
+  }
+}
+function createHex(value) {
+  if (value instanceof Uint8Array && value.length === 0 || typeof value === "string" && value.toLowerCase() === "0x") {
+    return "0x";
+  }
+  try {
+    return create(value, HexCoercer);
+  } catch (error) {
+    if (error instanceof StructError) {
+      throw new Error(
+        `Expected a bytes-like value, got "${String(error.value)}".`
+      );
+    }
+    throw error;
+  }
+}
+
+export {
+  createNumber,
+  createBigInt,
+  createBytes,
+  createHex
+};
+//# sourceMappingURL=chunk-2CY4F77D.mjs.map

package/dist/chunk-2CY4F77D.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/coercers.ts"],"sourcesContent":["import type { Infer } from 'superstruct';\nimport {\n  bigint,\n  coerce,\n  create,\n  instance,\n  number,\n  string,\n  StructError,\n  union,\n} from 'superstruct';\n\nimport { assert } from './assert';\nimport { bytesToHex, hexToBytes } from './bytes';\nimport type { Hex } from './hex';\nimport { StrictHexStruct } from './hex';\n\nconst NumberLikeStruct = union([number(), bigint(), string(), StrictHexStruct]);\nconst NumberCoercer = coerce(number(), NumberLikeStruct, Number);\nconst BigIntCoercer = coerce(bigint(), NumberLikeStruct, BigInt);\n\nconst BytesLikeStruct = union([StrictHexStruct, instance(Uint8Array)]);\nconst BytesCoercer = coerce(\n  instance(Uint8Array),\n  union([StrictHexStruct]),\n  hexToBytes,\n);\n\nconst HexCoercer = coerce(StrictHexStruct, instance(Uint8Array), bytesToHex);\n\nexport type NumberLike = Infer<typeof NumberLikeStruct>;\nexport type BytesLike = Infer<typeof BytesLikeStruct>;\n\n/**\n * Create a number from a number-like value.\n *\n * - If the value is a number, it is returned as-is.\n * - If the value is a `bigint`, it is converted to a number.\n * - If the value is a string, it is interpreted as a decimal number.\n * - If the value is a hex string (i.e., it starts with \"0x\"), it is\n * interpreted as a hexadecimal number.\n *\n * This validates that the value is a number-like value, and that the resulting\n * number is not `NaN` or `Infinity`.\n *\n * @example\n * ```typescript\n * const value = createNumber('0x010203');\n * console.log(value); // 66051\n *\n * const otherValue = createNumber(123n);\n * console.log(otherValue); // 123\n * ```\n * @param value - The value to create the number from.\n * @returns The created number.\n * @throws If the value is not a number-like value, or if the resulting number\n * is `NaN` or `Infinity`.\n */\nexport function createNumber(value: NumberLike): number {\n  try {\n    const result = create(value, NumberCoercer);\n\n    assert(\n      Number.isFinite(result),\n      `Expected a number-like value, got \"${value}\".`,\n    );\n\n    return result;\n  } catch (error) {\n    if (error instanceof StructError) {\n      throw new Error(`Expected a number-like value, got \"${value}\".`);\n    }\n\n    /* istanbul ignore next */\n    throw error;\n  }\n}\n\n/**\n * Create a `bigint` from a number-like value.\n *\n * - If the value is a number, it is converted to a `bigint`.\n * - If the value is a `bigint`, it is returned as-is.\n * - If the value is a string, it is interpreted as a decimal number and\n * converted to a `bigint`.\n * - If the value is a hex string (i.e., it starts with \"0x\"), it is\n * interpreted as a hexadecimal number and converted to a `bigint`.\n *\n * @example\n * ```typescript\n * const value = createBigInt('0x010203');\n * console.log(value); // 16909060n\n *\n * const otherValue = createBigInt(123);\n * console.log(otherValue); // 123n\n * ```\n * @param value - The value to create the bigint from.\n * @returns The created bigint.\n * @throws If the value is not a number-like value.\n */\nexport function createBigInt(value: NumberLike): bigint {\n  try {\n    // The `BigInt` constructor throws if the value is not a number-like value.\n    // There is no need to validate the value manually.\n    return create(value, BigIntCoercer);\n  } catch (error) {\n    if (error instanceof StructError) {\n      throw new Error(\n        `Expected a number-like value, got \"${String(error.value)}\".`,\n      );\n    }\n\n    /* istanbul ignore next */\n    throw error;\n  }\n}\n\n/**\n * Create a byte array from a bytes-like value.\n *\n * - If the value is a byte array, it is returned as-is.\n * - If the value is a hex string (i.e., it starts with \"0x\"), it is interpreted\n * as a hexadecimal number and converted to a byte array.\n *\n * @example\n * ```typescript\n * const value = createBytes('0x010203');\n * console.log(value); // Uint8Array [ 1, 2, 3 ]\n *\n * const otherValue = createBytes('0x010203');\n * console.log(otherValue); // Uint8Array [ 1, 2, 3 ]\n * ```\n * @param value - The value to create the byte array from.\n * @returns The created byte array.\n * @throws If the value is not a bytes-like value.\n */\nexport function createBytes(value: BytesLike): Uint8Array {\n  if (typeof value === 'string' && value.toLowerCase() === '0x') {\n    return new Uint8Array();\n  }\n\n  try {\n    return create(value, BytesCoercer);\n  } catch (error) {\n    if (error instanceof StructError) {\n      throw new Error(\n        `Expected a bytes-like value, got \"${String(error.value)}\".`,\n      );\n    }\n\n    /* istanbul ignore next */\n    throw error;\n  }\n}\n\n/**\n * Create a hexadecimal string from a bytes-like value.\n *\n * - If the value is a hex string (i.e., it starts with \"0x\"), it is returned\n * as-is.\n * - If the value is a `Uint8Array`, it is converted to a hex string.\n *\n * @example\n * ```typescript\n * const value = createHex(new Uint8Array([1, 2, 3]));\n * console.log(value); // '0x010203'\n *\n * const otherValue = createHex('0x010203');\n * console.log(otherValue); // '0x010203'\n * ```\n * @param value - The value to create the hex string from.\n * @returns The created hex string.\n * @throws If the value is not a bytes-like value.\n */\nexport function createHex(value: BytesLike): Hex {\n  if (\n    (value instanceof Uint8Array && value.length === 0) ||\n    (typeof value === 'string' && value.toLowerCase() === '0x')\n  ) {\n    return '0x';\n  }\n\n  try {\n    return create(value, HexCoercer);\n  } catch (error) {\n    if (error instanceof StructError) {\n      throw new Error(\n        `Expected a bytes-like value, got \"${String(error.value)}\".`,\n      );\n    }\n\n    /* istanbul ignore next */\n    throw error;\n  }\n}\n"],"mappings":";;;;;;;;;;AACA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAOP,IAAM,mBAAmB,MAAM,CAAC,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,eAAe,CAAC;AAC9E,IAAM,gBAAgB,OAAO,OAAO,GAAG,kBAAkB,MAAM;AAC/D,IAAM,gBAAgB,OAAO,OAAO,GAAG,kBAAkB,MAAM;AAE/D,IAAM,kBAAkB,MAAM,CAAC,iBAAiB,SAAS,UAAU,CAAC,CAAC;AACrE,IAAM,eAAe;AAAA,EACnB,SAAS,UAAU;AAAA,EACnB,MAAM,CAAC,eAAe,CAAC;AAAA,EACvB;AACF;AAEA,IAAM,aAAa,OAAO,iBAAiB,SAAS,UAAU,GAAG,UAAU;AA8BpE,SAAS,aAAa,OAA2B;AACtD,MAAI;AACF,UAAM,SAAS,OAAO,OAAO,aAAa;AAE1C;AAAA,MACE,OAAO,SAAS,MAAM;AAAA,MACtB,sCAAsC,KAAK;AAAA,IAC7C;AAEA,WAAO;AAAA,EACT,SAAS,OAAO;AACd,QAAI,iBAAiB,aAAa;AAChC,YAAM,IAAI,MAAM,sCAAsC,KAAK,IAAI;AAAA,IACjE;AAGA,UAAM;AAAA,EACR;AACF;AAwBO,SAAS,aAAa,OAA2B;AACtD,MAAI;AAGF,WAAO,OAAO,OAAO,aAAa;AAAA,EACpC,SAAS,OAAO;AACd,QAAI,iBAAiB,aAAa;AAChC,YAAM,IAAI;AAAA,QACR,sCAAsC,OAAO,MAAM,KAAK,CAAC;AAAA,MAC3D;AAAA,IACF;AAGA,UAAM;AAAA,EACR;AACF;AAqBO,SAAS,YAAY,OAA8B;AACxD,MAAI,OAAO,UAAU,YAAY,MAAM,YAAY,MAAM,MAAM;AAC7D,WAAO,IAAI,WAAW;AAAA,EACxB;AAEA,MAAI;AACF,WAAO,OAAO,OAAO,YAAY;AAAA,EACnC,SAAS,OAAO;AACd,QAAI,iBAAiB,aAAa;AAChC,YAAM,IAAI;AAAA,QACR,qCAAqC,OAAO,MAAM,KAAK,CAAC;AAAA,MAC1D;AAAA,IACF;AAGA,UAAM;AAAA,EACR;AACF;AAqBO,SAAS,UAAU,OAAuB;AAC/C,MACG,iBAAiB,cAAc,MAAM,WAAW,KAChD,OAAO,UAAU,YAAY,MAAM,YAAY,MAAM,MACtD;AACA,WAAO;AAAA,EACT;AAEA,MAAI;AACF,WAAO,OAAO,OAAO,UAAU;AAAA,EACjC,SAAS,OAAO;AACd,QAAI,iBAAiB,aAAa;AAChC,YAAM,IAAI;AAAA,QACR,qCAAqC,OAAO,MAAM,KAAK,CAAC;AAAA,MAC1D;AAAA,IACF;AAGA,UAAM;AAAA,EACR;AACF;","names":[]}

package/dist/chunk-2LBGT4GH.js

@@ -0,0 +1,15 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }// src/logging.ts
+var _debug = require('debug'); var _debug2 = _interopRequireDefault(_debug);
+var globalLogger = _debug2.default.call(void 0, "metamask");
+function createProjectLogger(projectName) {
+  return globalLogger.extend(projectName);
+}
+function createModuleLogger(projectLogger, moduleName) {
+  return projectLogger.extend(moduleName);
+}
+
+
+
+
+exports.createProjectLogger = createProjectLogger; exports.createModuleLogger = createModuleLogger;
+//# sourceMappingURL=chunk-2LBGT4GH.js.map

package/dist/chunk-2LBGT4GH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logging.ts"],"names":[],"mappings":";AACA,OAAO,WAAW;AAElB,IAAM,eAAe,MAAM,UAAU;AAc9B,SAAS,oBAAoB,aAA+B;AACjE,SAAO,aAAa,OAAO,WAAW;AACxC;AAgBO,SAAS,mBACd,eACA,YACU;AACV,SAAO,cAAc,OAAO,UAAU;AACxC","sourcesContent":["import type { Debugger } from 'debug';\nimport debug from 'debug';\n\nconst globalLogger = debug('metamask');\n\n/**\n * Creates a logger via the `debug` library whose log messages will be tagged\n * using the name of your project. By default, such messages will be\n * suppressed, but you can reveal them by setting the `DEBUG` environment\n * variable to `metamask:<projectName>`. You can also set this variable to\n * `metamask:*` if you want to see log messages from all MetaMask projects that\n * are also using this function to create their loggers.\n *\n * @param projectName - The name of your project. This should be the name of\n * your NPM package if you're developing one.\n * @returns An instance of `debug`.\n */\nexport function createProjectLogger(projectName: string): Debugger {\n  return globalLogger.extend(projectName);\n}\n\n/**\n * Creates a logger via the `debug` library which is derived from the logger for\n * the whole project whose log messages will be tagged using the name of your\n * module. By default, such messages will be suppressed, but you can reveal them\n * by setting the `DEBUG` environment variable to\n * `metamask:<projectName>:<moduleName>`. You can also set this variable to\n * `metamask:<projectName>:*` if you want to see log messages from the project,\n * or `metamask:*` if you want to see log messages from all MetaMask projects.\n *\n * @param projectLogger - The logger created via {@link createProjectLogger}.\n * @param moduleName - The name of your module. You could use the name of the\n * file where you're using this logger or some other name.\n * @returns An instance of `debug`.\n */\nexport function createModuleLogger(\n  projectLogger: Debugger,\n  moduleName: string,\n): Debugger {\n  return projectLogger.extend(moduleName);\n}\n"]}

package/dist/chunk-2TBCL6EF.js

@@ -0,0 +1 @@
+"use strict";//# sourceMappingURL=chunk-2TBCL6EF.js.map

package/dist/chunk-2TBCL6EF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":""}

package/dist/chunk-3W5G4CYI.js

@@ -0,0 +1,25 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var __accessCheck = (obj, member, msg) => {
+  if (!member.has(obj))
+    throw TypeError("Cannot " + msg);
+};
+var __privateGet = (obj, member, getter) => {
+  __accessCheck(obj, member, "read from private field");
+  return getter ? getter.call(obj) : member.get(obj);
+};
+var __privateAdd = (obj, member, value) => {
+  if (member.has(obj))
+    throw TypeError("Cannot add the same private member more than once");
+  member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+};
+var __privateSet = (obj, member, value, setter) => {
+  __accessCheck(obj, member, "write to private field");
+  setter ? setter.call(obj, value) : member.set(obj, value);
+  return value;
+};
+
+
+
+
+
+exports.__privateGet = __privateGet; exports.__privateAdd = __privateAdd; exports.__privateSet = __privateSet;
+//# sourceMappingURL=chunk-3W5G4CYI.js.map

package/dist/chunk-3W5G4CYI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":""}

package/dist/chunk-4JNG5UTO.js

@@ -0,0 +1,44 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkYQJBIHC7js = require('./chunk-YQJBIHC7.js');
+
+
+var _chunkVBYRLAP6js = require('./chunk-VBYRLAP6.js');
+
+// src/number.ts
+var numberToHex = (value) => {
+  _chunkVBYRLAP6js.assert.call(void 0, typeof value === "number", "Value must be a number.");
+  _chunkVBYRLAP6js.assert.call(void 0, value >= 0, "Value must be a non-negative number.");
+  _chunkVBYRLAP6js.assert.call(void 0, 
+    Number.isSafeInteger(value),
+    "Value is not a safe integer. Use `bigIntToHex` instead."
+  );
+  return _chunkYQJBIHC7js.add0x.call(void 0, value.toString(16));
+};
+var bigIntToHex = (value) => {
+  _chunkVBYRLAP6js.assert.call(void 0, typeof value === "bigint", "Value must be a bigint.");
+  _chunkVBYRLAP6js.assert.call(void 0, value >= 0, "Value must be a non-negative bigint.");
+  return _chunkYQJBIHC7js.add0x.call(void 0, value.toString(16));
+};
+var hexToNumber = (value) => {
+  _chunkYQJBIHC7js.assertIsHexString.call(void 0, value);
+  const numberValue = parseInt(value, 16);
+  _chunkVBYRLAP6js.assert.call(void 0, 
+    Number.isSafeInteger(numberValue),
+    "Value is not a safe integer. Use `hexToBigInt` instead."
+  );
+  return numberValue;
+};
+var hexToBigInt = (value) => {
+  _chunkYQJBIHC7js.assertIsHexString.call(void 0, value);
+  return BigInt(_chunkYQJBIHC7js.add0x.call(void 0, value));
+};
+
+
+
+
+
+
+exports.numberToHex = numberToHex; exports.bigIntToHex = bigIntToHex; exports.hexToNumber = hexToNumber; exports.hexToBigInt = hexToBigInt;
+//# sourceMappingURL=chunk-4JNG5UTO.js.map

package/dist/chunk-4JNG5UTO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/number.ts"],"names":[],"mappings":";;;;;;;;;AAoBO,IAAM,cAAc,CAAC,UAA0B;AACpD,SAAO,OAAO,UAAU,UAAU,yBAAyB;AAC3D,SAAO,SAAS,GAAG,sCAAsC;AACzD;AAAA,IACE,OAAO,cAAc,KAAK;AAAA,IAC1B;AAAA,EACF;AAEA,SAAO,MAAM,MAAM,SAAS,EAAE,CAAC;AACjC;AAkBO,IAAM,cAAc,CAAC,UAA0B;AACpD,SAAO,OAAO,UAAU,UAAU,yBAAyB;AAC3D,SAAO,SAAS,GAAG,sCAAsC;AAEzD,SAAO,MAAM,MAAM,SAAS,EAAE,CAAC;AACjC;AAqBO,IAAM,cAAc,CAAC,UAA0B;AACpD,oBAAkB,KAAK;AAIvB,QAAM,cAAc,SAAS,OAAO,EAAE;AAEtC;AAAA,IACE,OAAO,cAAc,WAAW;AAAA,IAChC;AAAA,EACF;AAEA,SAAO;AACT;AAkBO,IAAM,cAAc,CAAC,UAA0B;AACpD,oBAAkB,KAAK;AAGvB,SAAO,OAAO,MAAM,KAAK,CAAC;AAC5B","sourcesContent":["import { assert } from './assert';\nimport { add0x, assertIsHexString } from './hex';\n\n/**\n * Convert a number to a hexadecimal string. This verifies that the number is a\n * non-negative safe integer.\n *\n * To convert a `bigint` to a hexadecimal string instead, use\n * {@link bigIntToHex}.\n *\n * @example\n * ```typescript\n * numberToHex(0); // '0x0'\n * numberToHex(1); // '0x1'\n * numberToHex(16); // '0x10'\n * ```\n * @param value - The number to convert to a hexadecimal string.\n * @returns The hexadecimal string, with the \"0x\"-prefix.\n * @throws If the number is not a non-negative safe integer.\n */\nexport const numberToHex = (value: number): string => {\n  assert(typeof value === 'number', 'Value must be a number.');\n  assert(value >= 0, 'Value must be a non-negative number.');\n  assert(\n    Number.isSafeInteger(value),\n    'Value is not a safe integer. Use `bigIntToHex` instead.',\n  );\n\n  return add0x(value.toString(16));\n};\n\n/**\n * Convert a `bigint` to a hexadecimal string. This verifies that the `bigint`\n * is a non-negative integer.\n *\n * To convert a number to a hexadecimal string instead, use {@link numberToHex}.\n *\n * @example\n * ```typescript\n * bigIntToHex(0n); // '0x0'\n * bigIntToHex(1n); // '0x1'\n * bigIntToHex(16n); // '0x10'\n * ```\n * @param value - The `bigint` to convert to a hexadecimal string.\n * @returns The hexadecimal string, with the \"0x\"-prefix.\n * @throws If the `bigint` is not a non-negative integer.\n */\nexport const bigIntToHex = (value: bigint): string => {\n  assert(typeof value === 'bigint', 'Value must be a bigint.');\n  assert(value >= 0, 'Value must be a non-negative bigint.');\n\n  return add0x(value.toString(16));\n};\n\n/**\n * Convert a hexadecimal string to a number. This verifies that the string is a\n * valid hex string, and that the resulting number is a safe integer. Both\n * \"0x\"-prefixed and unprefixed strings are supported.\n *\n * To convert a hexadecimal string to a `bigint` instead, use\n * {@link hexToBigInt}.\n *\n * @example\n * ```typescript\n * hexToNumber('0x0'); // 0\n * hexToNumber('0x1'); // 1\n * hexToNumber('0x10'); // 16\n * ```\n * @param value - The hexadecimal string to convert to a number.\n * @returns The number.\n * @throws If the value is not a valid hexadecimal string, or if the resulting\n * number is not a safe integer.\n */\nexport const hexToNumber = (value: string): number => {\n  assertIsHexString(value);\n\n  // `parseInt` accepts values without the \"0x\"-prefix, whereas `Number` does\n  // not. Using this is slightly faster than `Number(add0x(value))`.\n  const numberValue = parseInt(value, 16);\n\n  assert(\n    Number.isSafeInteger(numberValue),\n    'Value is not a safe integer. Use `hexToBigInt` instead.',\n  );\n\n  return numberValue;\n};\n\n/**\n * Convert a hexadecimal string to a `bigint`. This verifies that the string is\n * a valid hex string. Both \"0x\"-prefixed and unprefixed strings are supported.\n *\n * To convert a hexadecimal string to a number instead, use {@link hexToNumber}.\n *\n * @example\n * ```typescript\n * hexToBigInt('0x0'); // 0n\n * hexToBigInt('0x1'); // 1n\n * hexToBigInt('0x10'); // 16n\n * ```\n * @param value - The hexadecimal string to convert to a `bigint`.\n * @returns The `bigint`.\n * @throws If the value is not a valid hexadecimal string.\n */\nexport const hexToBigInt = (value: string): bigint => {\n  assertIsHexString(value);\n\n  // The `BigInt` constructor requires the \"0x\"-prefix to parse a hex string.\n  return BigInt(add0x(value));\n};\n"]}

package/dist/chunk-4RMX5YWE.js

@@ -0,0 +1,34 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/time.ts
+var Duration = /* @__PURE__ */ ((Duration2) => {
+  Duration2[Duration2["Millisecond"] = 1] = "Millisecond";
+  Duration2[Duration2["Second"] = 1e3] = "Second";
+  Duration2[Duration2["Minute"] = 6e4] = "Minute";
+  Duration2[Duration2["Hour"] = 36e5] = "Hour";
+  Duration2[Duration2["Day"] = 864e5] = "Day";
+  Duration2[Duration2["Week"] = 6048e5] = "Week";
+  Duration2[Duration2["Year"] = 31536e6] = "Year";
+  return Duration2;
+})(Duration || {});
+var isNonNegativeInteger = (number) => Number.isInteger(number) && number >= 0;
+var assertIsNonNegativeInteger = (number, name) => {
+  if (!isNonNegativeInteger(number)) {
+    throw new Error(
+      `"${name}" must be a non-negative integer. Received: "${number}".`
+    );
+  }
+};
+function inMilliseconds(count, duration) {
+  assertIsNonNegativeInteger(count, "count");
+  return count * duration;
+}
+function timeSince(timestamp) {
+  assertIsNonNegativeInteger(timestamp, "timestamp");
+  return Date.now() - timestamp;
+}
+
+
+
+
+
+exports.Duration = Duration; exports.inMilliseconds = inMilliseconds; exports.timeSince = timeSince;
+//# sourceMappingURL=chunk-4RMX5YWE.js.map

package/dist/chunk-4RMX5YWE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/time.ts"],"names":["Duration"],"mappings":";AAGO,IAAK,WAAL,kBAAKA,cAAL;AAIL,EAAAA,oBAAA,iBAAc,KAAd;AAKA,EAAAA,oBAAA,YAAS,OAAT;AAKA,EAAAA,oBAAA,YAAS,OAAT;AAKA,EAAAA,oBAAA,UAAO,QAAP;AAKA,EAAAA,oBAAA,SAAM,SAAN;AAKA,EAAAA,oBAAA,UAAO,UAAP;AAKA,EAAAA,oBAAA,UAAO,WAAP;AAlCU,SAAAA;AAAA,GAAA;AAqCZ,IAAM,uBAAuB,CAAC,WAC5B,OAAO,UAAU,MAAM,KAAK,UAAU;AAExC,IAAM,6BAA6B,CAAC,QAAgB,SAAiB;AACnE,MAAI,CAAC,qBAAqB,MAAM,GAAG;AACjC,UAAM,IAAI;AAAA,MACR,IAAI,IAAI,gDAAgD,MAAM;AAAA,IAChE;AAAA,EACF;AACF;AASO,SAAS,eAAe,OAAe,UAA4B;AACxE,6BAA2B,OAAO,OAAO;AACzC,SAAO,QAAQ;AACjB;AAQO,SAAS,UAAU,WAA2B;AACnD,6BAA2B,WAAW,WAAW;AACjD,SAAO,KAAK,IAAI,IAAI;AACtB","sourcesContent":["/**\n * Common duration constants, in milliseconds.\n */\nexport enum Duration {\n  /**\n   * A millisecond.\n   */\n  Millisecond = 1,\n\n  /**\n   * A second, in milliseconds.\n   */\n  Second = 1000, // Millisecond * 1000\n\n  /**\n   * A minute, in milliseconds.\n   */\n  Minute = 60_000, // Second * 60\n\n  /**\n   * An hour, in milliseconds.\n   */\n  Hour = 3_600_000, // Minute * 60\n\n  /**\n   * A day, in milliseconds.\n   */\n  Day = 86_400_000, // Hour * 24\n\n  /**\n   * A week, in milliseconds.\n   */\n  Week = 604_800_000, // Day * 7\n\n  /**\n   * A year, in milliseconds.\n   */\n  Year = 31_536_000_000, // Day * 365\n}\n\nconst isNonNegativeInteger = (number: number) =>\n  Number.isInteger(number) && number >= 0;\n\nconst assertIsNonNegativeInteger = (number: number, name: string) => {\n  if (!isNonNegativeInteger(number)) {\n    throw new Error(\n      `\"${name}\" must be a non-negative integer. Received: \"${number}\".`,\n    );\n  }\n};\n\n/**\n * Calculates the millisecond value of the specified number of units of time.\n *\n * @param count - The number of units of time.\n * @param duration - The unit of time to count.\n * @returns The count multiplied by the specified duration.\n */\nexport function inMilliseconds(count: number, duration: Duration): number {\n  assertIsNonNegativeInteger(count, 'count');\n  return count * duration;\n}\n\n/**\n * Gets the milliseconds since a particular Unix epoch timestamp.\n *\n * @param timestamp - A Unix millisecond timestamp.\n * @returns The number of milliseconds elapsed since the specified timestamp.\n */\nexport function timeSince(timestamp: number): number {\n  assertIsNonNegativeInteger(timestamp, 'timestamp');\n  return Date.now() - timestamp;\n}\n"]}