@metamask/snaps-execution-environments 6.6.1 → 6.7.0

package/dist/common/endowments/console.mjs

@@ -1,13 +1,100 @@
-import {
-  consoleAttenuatedMethods,
-  consoleMethods,
-  console_default
-} from "../../chunk-W7EDURT5.mjs";
-import "../../chunk-IX5S3V47.mjs";
-import "../../chunk-YRZVIDCF.mjs";
-export {
-  consoleAttenuatedMethods,
-  consoleMethods,
-  console_default as default
+import { assert } from "@metamask/utils";
+import { rootRealmGlobal } from "../globalObject.mjs";
+export const consoleAttenuatedMethods = new Set([
+    'log',
+    'assert',
+    'error',
+    'debug',
+    'info',
+    'warn',
+]);
+/**
+ * A set of all the `console` values that will be passed to the snap. This has
+ * all the values that are available in both the browser and Node.js.
+ */
+export const consoleMethods = new Set([
+    'debug',
+    'error',
+    'info',
+    'log',
+    'warn',
+    'dir',
+    'dirxml',
+    'table',
+    'trace',
+    'group',
+    'groupCollapsed',
+    'groupEnd',
+    'clear',
+    'count',
+    'countReset',
+    'assert',
+    'profile',
+    'profileEnd',
+    'time',
+    'timeLog',
+    'timeEnd',
+    'timeStamp',
+    'context',
+]);
+const consoleFunctions = ['log', 'error', 'debug', 'info', 'warn'];
+/**
+ * Gets the appropriate (prepended) message to pass to one of the attenuated
+ * method calls.
+ *
+ * @param snapId - Id of the snap that we're getting a message for.
+ * @param message - The id of the snap that will interact with the endowment.
+ * @param args - The array of additional arguments.
+ * @returns An array of arguments to be passed into an attenuated console method call.
+ */
+function getMessage(snapId, message, ...args) {
+    const prefix = `[Snap: ${snapId}]`;
+    // If the first argument is a string, prepend the prefix to the message, and keep the
+    // rest of the arguments as-is.
+    if (typeof message === 'string') {
+        return [`${prefix} ${message}`, ...args];
+    }
+    // Otherwise, the `message` is an object, array, etc., so add the prefix as a separate
+    // message to the arguments.
+    return [prefix, message, ...args];
+}
+/**
+ * Create a a {@link console} object, with the same properties as the global
+ * {@link console} object, but with some methods replaced.
+ *
+ * @param options - Factory options used in construction of the endowment.
+ * @param options.snapId - The id of the snap that will interact with the endowment.
+ * @returns The {@link console} object with the replaced methods.
+ */
+function createConsole({ snapId } = {}) {
+    assert(snapId !== undefined);
+    const keys = Object.getOwnPropertyNames(rootRealmGlobal.console);
+    const attenuatedConsole = keys.reduce((target, key) => {
+        if (consoleMethods.has(key) && !consoleAttenuatedMethods.has(key)) {
+            return { ...target, [key]: rootRealmGlobal.console[key] };
+        }
+        return target;
+    }, {});
+    return harden({
+        console: {
+            ...attenuatedConsole,
+            assert: (value, message, ...optionalParams) => {
+                rootRealmGlobal.console.assert(value, ...getMessage(snapId, message, ...optionalParams));
+            },
+            ...consoleFunctions.reduce((target, key) => {
+                return {
+                    ...target,
+                    [key]: (message, ...optionalParams) => {
+                        rootRealmGlobal.console[key](...getMessage(snapId, message, ...optionalParams));
+                    },
+                };
+            }, {}),
+        },
+    });
+}
+const endowmentModule = {
+    names: ['console'],
+    factory: createConsole,
 };
+export default endowmentModule;
 //# sourceMappingURL=console.mjs.map

package/dist/common/endowments/console.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"file":"console.mjs","sourceRoot":"","sources":["../../../src/common/endowments/console.ts"],"names":[],"mappings":"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","sourcesContent":["import { assert } from '@metamask/utils';\n\nimport { rootRealmGlobal } from '../globalObject';\nimport type { EndowmentFactoryOptions } from './commonEndowmentFactory';\n\nexport const consoleAttenuatedMethods = new Set([\n  'log',\n  'assert',\n  'error',\n  'debug',\n  'info',\n  'warn',\n]);\n\n/**\n * A set of all the `console` values that will be passed to the snap. This has\n * all the values that are available in both the browser and Node.js.\n */\nexport const consoleMethods = new Set([\n  'debug',\n  'error',\n  'info',\n  'log',\n  'warn',\n  'dir',\n  'dirxml',\n  'table',\n  'trace',\n  'group',\n  'groupCollapsed',\n  'groupEnd',\n  'clear',\n  'count',\n  'countReset',\n  'assert',\n  'profile',\n  'profileEnd',\n  'time',\n  'timeLog',\n  'timeEnd',\n  'timeStamp',\n  'context',\n]);\n\nconst consoleFunctions = ['log', 'error', 'debug', 'info', 'warn'] as const;\n\ntype ConsoleFunctions = {\n  [Key in (typeof consoleFunctions)[number]]: (typeof rootRealmGlobal.console)[Key];\n};\n\n/**\n * Gets the appropriate (prepended) message to pass to one of the attenuated\n * method calls.\n *\n * @param snapId - Id of the snap that we're getting a message for.\n * @param message - The id of the snap that will interact with the endowment.\n * @param args - The array of additional arguments.\n * @returns An array of arguments to be passed into an attenuated console method call.\n */\nfunction getMessage(snapId: string, message: unknown, ...args: unknown[]) {\n  const prefix = `[Snap: ${snapId}]`;\n\n  // If the first argument is a string, prepend the prefix to the message, and keep the\n  // rest of the arguments as-is.\n  if (typeof message === 'string') {\n    return [`${prefix} ${message}`, ...args];\n  }\n\n  // Otherwise, the `message` is an object, array, etc., so add the prefix as a separate\n  // message to the arguments.\n  return [prefix, message, ...args];\n}\n\n/**\n * Create a a {@link console} object, with the same properties as the global\n * {@link console} object, but with some methods replaced.\n *\n * @param options - Factory options used in construction of the endowment.\n * @param options.snapId - The id of the snap that will interact with the endowment.\n * @returns The {@link console} object with the replaced methods.\n */\nfunction createConsole({ snapId }: EndowmentFactoryOptions = {}) {\n  assert(snapId !== undefined);\n  const keys = Object.getOwnPropertyNames(\n    rootRealmGlobal.console,\n  ) as (keyof typeof console)[];\n\n  const attenuatedConsole = keys.reduce((target, key) => {\n    if (consoleMethods.has(key) && !consoleAttenuatedMethods.has(key)) {\n      return { ...target, [key]: rootRealmGlobal.console[key] };\n    }\n\n    return target;\n  }, {});\n\n  return harden({\n    console: {\n      ...attenuatedConsole,\n      assert: (\n        value: any,\n        message?: string | undefined,\n        ...optionalParams: any[]\n      ) => {\n        rootRealmGlobal.console.assert(\n          value,\n          ...getMessage(snapId, message, ...optionalParams),\n        );\n      },\n      ...consoleFunctions.reduce<ConsoleFunctions>((target, key) => {\n        return {\n          ...target,\n          [key]: (message?: unknown, ...optionalParams: any[]) => {\n            rootRealmGlobal.console[key](\n              ...getMessage(snapId, message, ...optionalParams),\n            );\n          },\n        };\n      }, {} as ConsoleFunctions),\n    },\n  });\n}\n\nconst endowmentModule = {\n  names: ['console'] as const,\n  factory: createConsole,\n};\n\nexport default endowmentModule;\n"]}

package/dist/common/endowments/crypto.cjs

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCrypto = void 0;
+const globalObject_1 = require("../globalObject.cjs");
+const createCrypto = () => {
+    if ('crypto' in globalObject_1.rootRealmGlobal &&
+        typeof globalObject_1.rootRealmGlobal.crypto === 'object' &&
+        'SubtleCrypto' in globalObject_1.rootRealmGlobal &&
+        typeof globalObject_1.rootRealmGlobal.SubtleCrypto === 'function') {
+        return {
+            crypto: harden(globalObject_1.rootRealmGlobal.crypto),
+            SubtleCrypto: harden(globalObject_1.rootRealmGlobal.SubtleCrypto),
+        };
+    }
+    // For now, we expose the experimental webcrypto API for Node.js execution environments
+    // TODO: Figure out if this is enough long-term or if we should use a polyfill.
+    /* eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires, n/global-require */
+    const crypto = require('crypto').webcrypto;
+    return {
+        crypto: harden(crypto),
+        SubtleCrypto: harden(crypto.subtle.constructor),
+    };
+};
+exports.createCrypto = createCrypto;
+const endowmentModule = {
+    names: ['crypto', 'SubtleCrypto'],
+    factory: exports.createCrypto,
+};
+exports.default = endowmentModule;
+//# sourceMappingURL=crypto.cjs.map

package/dist/common/endowments/crypto.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.cjs","sourceRoot":"","sources":["../../../src/common/endowments/crypto.ts"],"names":[],"mappings":";;;AAAA,sDAAkD;AAE3C,MAAM,YAAY,GAAG,GAAG,EAAE;IAC/B,IACE,QAAQ,IAAI,8BAAe;QAC3B,OAAO,8BAAe,CAAC,MAAM,KAAK,QAAQ;QAC1C,cAAc,IAAI,8BAAe;QACjC,OAAO,8BAAe,CAAC,YAAY,KAAK,UAAU,EAClD,CAAC;QACD,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,8BAAe,CAAC,MAAM,CAAC;YACtC,YAAY,EAAE,MAAM,CAAC,8BAAe,CAAC,YAAY,CAAC;SACnD,CAAC;IACJ,CAAC;IACD,uFAAuF;IACvF,+EAA+E;IAC/E,0HAA0H;IAC1H,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC;IAC3C,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;KACvC,CAAC;AACb,CAAC,CAAC;AApBW,QAAA,YAAY,gBAoBvB;AAEF,MAAM,eAAe,GAAG;IACtB,KAAK,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAU;IAC1C,OAAO,EAAE,oBAAY;CACtB,CAAC;AACF,kBAAe,eAAe,CAAC","sourcesContent":["import { rootRealmGlobal } from '../globalObject';\n\nexport const createCrypto = () => {\n  if (\n    'crypto' in rootRealmGlobal &&\n    typeof rootRealmGlobal.crypto === 'object' &&\n    'SubtleCrypto' in rootRealmGlobal &&\n    typeof rootRealmGlobal.SubtleCrypto === 'function'\n  ) {\n    return {\n      crypto: harden(rootRealmGlobal.crypto),\n      SubtleCrypto: harden(rootRealmGlobal.SubtleCrypto),\n    };\n  }\n  // For now, we expose the experimental webcrypto API for Node.js execution environments\n  // TODO: Figure out if this is enough long-term or if we should use a polyfill.\n  /* eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires, n/global-require */\n  const crypto = require('crypto').webcrypto;\n  return {\n    crypto: harden(crypto),\n    SubtleCrypto: harden(crypto.subtle.constructor),\n  } as const;\n};\n\nconst endowmentModule = {\n  names: ['crypto', 'SubtleCrypto'] as const,\n  factory: createCrypto,\n};\nexport default endowmentModule;\n"]}

package/dist/{types/common/endowments/crypto.d.ts → common/endowments/crypto.d.cts}

@@ -10,3 +10,4 @@ declare const endowmentModule: {
     };
 };
 export default endowmentModule;
+//# sourceMappingURL=crypto.d.cts.map

package/dist/common/endowments/crypto.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.cts","sourceRoot":"","sources":["../../../src/common/endowments/crypto.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY;;;CAoBxB,CAAC;AAEF,QAAA,MAAM,eAAe;;;;;;CAGpB,CAAC;AACF,eAAe,eAAe,CAAC"}

package/dist/common/endowments/crypto.d.mts

@@ -0,0 +1,13 @@
+export declare const createCrypto: () => {
+    readonly crypto: any;
+    readonly SubtleCrypto: any;
+};
+declare const endowmentModule: {
+    names: readonly ["crypto", "SubtleCrypto"];
+    factory: () => {
+        readonly crypto: any;
+        readonly SubtleCrypto: any;
+    };
+};
+export default endowmentModule;
+//# sourceMappingURL=crypto.d.mts.map

package/dist/common/endowments/crypto.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.mts","sourceRoot":"","sources":["../../../src/common/endowments/crypto.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY;;;CAoBxB,CAAC;AAEF,QAAA,MAAM,eAAe;;;;;;CAGpB,CAAC;AACF,eAAe,eAAe,CAAC"}

package/dist/common/endowments/crypto.mjs

@@ -1,11 +1,26 @@
-import {
-  createCrypto,
-  crypto_default
-} from "../../chunk-Q42NNJFY.mjs";
-import "../../chunk-IX5S3V47.mjs";
-import "../../chunk-YRZVIDCF.mjs";
-export {
-  createCrypto,
-  crypto_default as default
+import { rootRealmGlobal } from "../globalObject.mjs";
+export const createCrypto = () => {
+    if ('crypto' in rootRealmGlobal &&
+        typeof rootRealmGlobal.crypto === 'object' &&
+        'SubtleCrypto' in rootRealmGlobal &&
+        typeof rootRealmGlobal.SubtleCrypto === 'function') {
+        return {
+            crypto: harden(rootRealmGlobal.crypto),
+            SubtleCrypto: harden(rootRealmGlobal.SubtleCrypto),
+        };
+    }
+    // For now, we expose the experimental webcrypto API for Node.js execution environments
+    // TODO: Figure out if this is enough long-term or if we should use a polyfill.
+    /* eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires, n/global-require */
+    const crypto = require('crypto').webcrypto;
+    return {
+        crypto: harden(crypto),
+        SubtleCrypto: harden(crypto.subtle.constructor),
+    };
 };
+const endowmentModule = {
+    names: ['crypto', 'SubtleCrypto'],
+    factory: createCrypto,
+};
+export default endowmentModule;
 //# sourceMappingURL=crypto.mjs.map

package/dist/common/endowments/crypto.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"file":"crypto.mjs","sourceRoot":"","sources":["../../../src/common/endowments/crypto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,4BAAwB;AAElD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE;IAC/B,IACE,QAAQ,IAAI,eAAe;QAC3B,OAAO,eAAe,CAAC,MAAM,KAAK,QAAQ;QAC1C,cAAc,IAAI,eAAe;QACjC,OAAO,eAAe,CAAC,YAAY,KAAK,UAAU,EAClD,CAAC;QACD,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC;YACtC,YAAY,EAAE,MAAM,CAAC,eAAe,CAAC,YAAY,CAAC;SACnD,CAAC;IACJ,CAAC;IACD,uFAAuF;IACvF,+EAA+E;IAC/E,0HAA0H;IAC1H,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC;IAC3C,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;KACvC,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG;IACtB,KAAK,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAU;IAC1C,OAAO,EAAE,YAAY;CACtB,CAAC;AACF,eAAe,eAAe,CAAC","sourcesContent":["import { rootRealmGlobal } from '../globalObject';\n\nexport const createCrypto = () => {\n  if (\n    'crypto' in rootRealmGlobal &&\n    typeof rootRealmGlobal.crypto === 'object' &&\n    'SubtleCrypto' in rootRealmGlobal &&\n    typeof rootRealmGlobal.SubtleCrypto === 'function'\n  ) {\n    return {\n      crypto: harden(rootRealmGlobal.crypto),\n      SubtleCrypto: harden(rootRealmGlobal.SubtleCrypto),\n    };\n  }\n  // For now, we expose the experimental webcrypto API for Node.js execution environments\n  // TODO: Figure out if this is enough long-term or if we should use a polyfill.\n  /* eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires, n/global-require */\n  const crypto = require('crypto').webcrypto;\n  return {\n    crypto: harden(crypto),\n    SubtleCrypto: harden(crypto.subtle.constructor),\n  } as const;\n};\n\nconst endowmentModule = {\n  names: ['crypto', 'SubtleCrypto'] as const,\n  factory: createCrypto,\n};\nexport default endowmentModule;\n"]}

package/dist/common/endowments/date.cjs

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globalObject_1 = require("../globalObject.cjs");
+/**
+ * Creates a {@link Date} constructor, with most of the same properties as the global object.
+ * The Date.now() function has added noise as to limit its precision and prevent potential timing attacks.
+ * The Date constructor uses this now() function to seed itself if no arguments are given to the constructor.
+ *
+ * @returns A modified {@link Date} constructor with limited precision.
+ */
+function createDate() {
+    const keys = Object.getOwnPropertyNames(globalObject_1.rootRealmGlobal.Date);
+    let currentTime = 0;
+    const now = () => {
+        const actual = globalObject_1.rootRealmGlobal.Date.now();
+        const newTime = Math.round(actual + Math.random());
+        if (newTime > currentTime) {
+            currentTime = newTime;
+        }
+        return currentTime;
+    };
+    const NewDate = function (...args) {
+        return Reflect.construct(globalObject_1.rootRealmGlobal.Date, args.length === 0 ? [now()] : args, new.target);
+    };
+    keys.forEach((key) => {
+        Reflect.defineProperty(NewDate, key, {
+            configurable: false,
+            writable: false,
+            value: key === 'now' ? now : globalObject_1.rootRealmGlobal.Date[key],
+        });
+    });
+    return { Date: harden(NewDate) };
+}
+const endowmentModule = {
+    names: ['Date'],
+    factory: createDate,
+};
+exports.default = endowmentModule;
+//# sourceMappingURL=date.cjs.map

package/dist/common/endowments/date.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.cjs","sourceRoot":"","sources":["../../../src/common/endowments/date.ts"],"names":[],"mappings":";;AAAA,sDAAkD;AAElD;;;;;;GAMG;AACH,SAAS,UAAU;IACjB,MAAM,IAAI,GAAG,MAAM,CAAC,mBAAmB,CACrC,8BAAe,CAAC,IAAI,CACI,CAAC;IAE3B,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,MAAM,GAAG,GAAG,GAAG,EAAE;QACf,MAAM,MAAM,GAAG,8BAAe,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACnD,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;YAC1B,WAAW,GAAG,OAAO,CAAC;QACxB,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,UAAU,GAAG,IAAe;QAC1C,OAAO,OAAO,CAAC,SAAS,CACtB,8BAAe,CAAC,IAAI,EACpB,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAClC,GAAG,CAAC,MAAM,CACX,CAAC;IACJ,CAAoB,CAAC;IAErB,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACnB,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,EAAE;YACnC,YAAY,EAAE,KAAK;YACnB,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,8BAAe,CAAC,IAAI,CAAC,GAAG,CAAC;SACvD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,eAAe,GAAG;IACtB,KAAK,EAAE,CAAC,MAAM,CAAU;IACxB,OAAO,EAAE,UAAU;CACpB,CAAC;AAEF,kBAAe,eAAe,CAAC","sourcesContent":["import { rootRealmGlobal } from '../globalObject';\n\n/**\n * Creates a {@link Date} constructor, with most of the same properties as the global object.\n * The Date.now() function has added noise as to limit its precision and prevent potential timing attacks.\n * The Date constructor uses this now() function to seed itself if no arguments are given to the constructor.\n *\n * @returns A modified {@link Date} constructor with limited precision.\n */\nfunction createDate() {\n  const keys = Object.getOwnPropertyNames(\n    rootRealmGlobal.Date,\n  ) as (keyof typeof Date)[];\n\n  let currentTime = 0;\n  const now = () => {\n    const actual = rootRealmGlobal.Date.now();\n    const newTime = Math.round(actual + Math.random());\n    if (newTime > currentTime) {\n      currentTime = newTime;\n    }\n    return currentTime;\n  };\n\n  const NewDate = function (...args: unknown[]) {\n    return Reflect.construct(\n      rootRealmGlobal.Date,\n      args.length === 0 ? [now()] : args,\n      new.target,\n    );\n  } as DateConstructor;\n\n  keys.forEach((key) => {\n    Reflect.defineProperty(NewDate, key, {\n      configurable: false,\n      writable: false,\n      value: key === 'now' ? now : rootRealmGlobal.Date[key],\n    });\n  });\n\n  return { Date: harden(NewDate) };\n}\n\nconst endowmentModule = {\n  names: ['Date'] as const,\n  factory: createDate,\n};\n\nexport default endowmentModule;\n"]}

package/dist/{types/common/endowments/date.d.ts → common/endowments/date.d.cts}

@@ -13,3 +13,4 @@ declare const endowmentModule: {
     factory: typeof createDate;
 };
 export default endowmentModule;
+//# sourceMappingURL=date.d.cts.map

package/dist/common/endowments/date.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.cts","sourceRoot":"","sources":["../../../src/common/endowments/date.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,iBAAS,UAAU;;EAgClB;AAED,QAAA,MAAM,eAAe;;;CAGpB,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/common/endowments/date.d.mts

@@ -0,0 +1,16 @@
+/**
+ * Creates a {@link Date} constructor, with most of the same properties as the global object.
+ * The Date.now() function has added noise as to limit its precision and prevent potential timing attacks.
+ * The Date constructor uses this now() function to seed itself if no arguments are given to the constructor.
+ *
+ * @returns A modified {@link Date} constructor with limited precision.
+ */
+declare function createDate(): {
+    Date: DateConstructor;
+};
+declare const endowmentModule: {
+    names: readonly ["Date"];
+    factory: typeof createDate;
+};
+export default endowmentModule;
+//# sourceMappingURL=date.d.mts.map

package/dist/common/endowments/date.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.mts","sourceRoot":"","sources":["../../../src/common/endowments/date.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,iBAAS,UAAU;;EAgClB;AAED,QAAA,MAAM,eAAe;;;CAGpB,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/common/endowments/date.mjs

@@ -1,9 +1,37 @@
-import {
-  date_default
-} from "../../chunk-UOPIRTJX.mjs";
-import "../../chunk-IX5S3V47.mjs";
-import "../../chunk-YRZVIDCF.mjs";
-export {
-  date_default as default
+import { rootRealmGlobal } from "../globalObject.mjs";
+/**
+ * Creates a {@link Date} constructor, with most of the same properties as the global object.
+ * The Date.now() function has added noise as to limit its precision and prevent potential timing attacks.
+ * The Date constructor uses this now() function to seed itself if no arguments are given to the constructor.
+ *
+ * @returns A modified {@link Date} constructor with limited precision.
+ */
+function createDate() {
+    const keys = Object.getOwnPropertyNames(rootRealmGlobal.Date);
+    let currentTime = 0;
+    const now = () => {
+        const actual = rootRealmGlobal.Date.now();
+        const newTime = Math.round(actual + Math.random());
+        if (newTime > currentTime) {
+            currentTime = newTime;
+        }
+        return currentTime;
+    };
+    const NewDate = function (...args) {
+        return Reflect.construct(rootRealmGlobal.Date, args.length === 0 ? [now()] : args, new.target);
+    };
+    keys.forEach((key) => {
+        Reflect.defineProperty(NewDate, key, {
+            configurable: false,
+            writable: false,
+            value: key === 'now' ? now : rootRealmGlobal.Date[key],
+        });
+    });
+    return { Date: harden(NewDate) };
+}
+const endowmentModule = {
+    names: ['Date'],
+    factory: createDate,
 };
+export default endowmentModule;
 //# sourceMappingURL=date.mjs.map

package/dist/common/endowments/date.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"file":"date.mjs","sourceRoot":"","sources":["../../../src/common/endowments/date.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,4BAAwB;AAElD;;;;;;GAMG;AACH,SAAS,UAAU;IACjB,MAAM,IAAI,GAAG,MAAM,CAAC,mBAAmB,CACrC,eAAe,CAAC,IAAI,CACI,CAAC;IAE3B,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,MAAM,GAAG,GAAG,GAAG,EAAE;QACf,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACnD,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;YAC1B,WAAW,GAAG,OAAO,CAAC;QACxB,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,UAAU,GAAG,IAAe;QAC1C,OAAO,OAAO,CAAC,SAAS,CACtB,eAAe,CAAC,IAAI,EACpB,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAClC,GAAG,CAAC,MAAM,CACX,CAAC;IACJ,CAAoB,CAAC;IAErB,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACnB,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,EAAE;YACnC,YAAY,EAAE,KAAK;YACnB,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC;SACvD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,eAAe,GAAG;IACtB,KAAK,EAAE,CAAC,MAAM,CAAU;IACxB,OAAO,EAAE,UAAU;CACpB,CAAC;AAEF,eAAe,eAAe,CAAC","sourcesContent":["import { rootRealmGlobal } from '../globalObject';\n\n/**\n * Creates a {@link Date} constructor, with most of the same properties as the global object.\n * The Date.now() function has added noise as to limit its precision and prevent potential timing attacks.\n * The Date constructor uses this now() function to seed itself if no arguments are given to the constructor.\n *\n * @returns A modified {@link Date} constructor with limited precision.\n */\nfunction createDate() {\n  const keys = Object.getOwnPropertyNames(\n    rootRealmGlobal.Date,\n  ) as (keyof typeof Date)[];\n\n  let currentTime = 0;\n  const now = () => {\n    const actual = rootRealmGlobal.Date.now();\n    const newTime = Math.round(actual + Math.random());\n    if (newTime > currentTime) {\n      currentTime = newTime;\n    }\n    return currentTime;\n  };\n\n  const NewDate = function (...args: unknown[]) {\n    return Reflect.construct(\n      rootRealmGlobal.Date,\n      args.length === 0 ? [now()] : args,\n      new.target,\n    );\n  } as DateConstructor;\n\n  keys.forEach((key) => {\n    Reflect.defineProperty(NewDate, key, {\n      configurable: false,\n      writable: false,\n      value: key === 'now' ? now : rootRealmGlobal.Date[key],\n    });\n  });\n\n  return { Date: harden(NewDate) };\n}\n\nconst endowmentModule = {\n  names: ['Date'] as const,\n  factory: createDate,\n};\n\nexport default endowmentModule;\n"]}

package/dist/common/endowments/index.cjs

@@ -0,0 +1,93 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEndowments = void 0;
+const rpc_errors_1 = require("@metamask/rpc-errors");
+const snaps_utils_1 = require("@metamask/snaps-utils");
+const utils_1 = require("@metamask/utils");
+const globalObject_1 = require("../globalObject.cjs");
+const commonEndowmentFactory_1 = __importDefault(require("./commonEndowmentFactory.cjs"));
+/**
+ * Retrieve consolidated endowment factories for common endowments.
+ */
+const registeredEndowments = (0, commonEndowmentFactory_1.default)();
+/**
+ * A map of endowment names to their factory functions. Some endowments share
+ * the same factory function, but we only call each factory once for each snap.
+ * See {@link createEndowments} for details.
+ */
+const endowmentFactories = registeredEndowments.reduce((factories, builder) => {
+    builder.names.forEach((name) => {
+        factories.set(name, builder.factory);
+    });
+    return factories;
+}, new Map());
+/**
+ * Gets the endowments for a particular Snap. Some endowments, like `setTimeout`
+ * and `clearTimeout`, must be attenuated so that they can only affect behavior
+ * within the Snap's own realm. Therefore, we use factory functions to create
+ * such attenuated / modified endowments. Otherwise, the value that's on the
+ * root realm global will be used.
+ *
+ * @param options - An options bag.
+ * @param options.snap - The Snaps global API object.
+ * @param options.ethereum - The Snap's EIP-1193 provider object.
+ * @param options.snapId - The id of the snap that will use the created endowments.
+ * @param options.endowments - The list of endowments to provide to the snap.
+ * @param options.notify - A reference to the notify function of the snap executor.
+ * @returns An object containing the Snap's endowments.
+ */
+function createEndowments({ snap, ethereum, snapId, endowments, notify, }) {
+    const attenuatedEndowments = {};
+    // TODO: All endowments should be hardened to prevent covert communication
+    // channels. Hardening the returned objects breaks tests elsewhere in the
+    // monorepo, so further research is needed.
+    const result = endowments.reduce(({ allEndowments, teardowns }, endowmentName) => {
+        // First, check if the endowment has a factory, and default to that.
+        if (endowmentFactories.has(endowmentName)) {
+            if (!(0, utils_1.hasProperty)(attenuatedEndowments, endowmentName)) {
+                // Call the endowment factory for the current endowment. If the factory
+                // creates multiple endowments, they will all be assigned to the
+                // `attenuatedEndowments` object, but will only be passed on to the snap
+                // if explicitly listed among its endowment.
+                // This may not have an actual use case, but, safety first.
+                // We just confirmed that endowmentFactories has the specified key.
+                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                const { teardownFunction, ...endowment } = endowmentFactories.get(endowmentName)({ snapId, notify });
+                Object.assign(attenuatedEndowments, endowment);
+                if (teardownFunction) {
+                    teardowns.push(teardownFunction);
+                }
+            }
+            allEndowments[endowmentName] = attenuatedEndowments[endowmentName];
+        }
+        else if (endowmentName === 'ethereum') {
+            // Special case for adding the EIP-1193 provider.
+            allEndowments[endowmentName] = ethereum;
+        }
+        else if (endowmentName in globalObject_1.rootRealmGlobal) {
+            (0, snaps_utils_1.logWarning)(`Access to unhardened global ${endowmentName}.`);
+            // If the endowment doesn't have a factory, just use whatever is on the
+            // global object.
+            const globalValue = globalObject_1.rootRealmGlobal[endowmentName];
+            allEndowments[endowmentName] = globalValue;
+        }
+        else {
+            // If we get to this point, we've been passed an endowment that doesn't
+            // exist in our current environment.
+            throw rpc_errors_1.rpcErrors.internal(`Unknown endowment: "${endowmentName}".`);
+        }
+        return { allEndowments, teardowns };
+    }, {
+        allEndowments: { snap },
+        teardowns: [],
+    });
+    const teardown = async () => {
+        await Promise.all(result.teardowns.map((teardownFunction) => teardownFunction()));
+    };
+    return { endowments: result.allEndowments, teardown };
+}
+exports.createEndowments = createEndowments;
+//# sourceMappingURL=index.cjs.map

package/dist/common/endowments/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/common/endowments/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { StreamProvider } from '@metamask/providers';\nimport { rpcErrors } from '@metamask/rpc-errors';\nimport type { SnapsProvider } from '@metamask/snaps-sdk';\nimport { logWarning } from '@metamask/snaps-utils';\nimport { hasProperty } from '@metamask/utils';\n\nimport type { NotifyFunction } from '../BaseSnapExecutor';\nimport { rootRealmGlobal } from '../globalObject';\nimport type { EndowmentFactoryOptions } from './commonEndowmentFactory';\nimport buildCommonEndowments from './commonEndowmentFactory';\n\ntype EndowmentFactoryResult = {\n  /**\n   * A function that performs any necessary teardown when the snap becomes idle.\n   *\n   * NOTE:** The endowments are not reconstructed if the snap is re-invoked\n   * before being terminated, so the teardown operation must not render the\n   * endowments unusable; it should simply restore the endowments to their\n   * original state.\n   */\n  teardownFunction?: () => Promise<void> | void;\n  [key: string]: unknown;\n};\n\n/**\n * Retrieve consolidated endowment factories for common endowments.\n */\nconst registeredEndowments = buildCommonEndowments();\n\n/**\n * A map of endowment names to their factory functions. Some endowments share\n * the same factory function, but we only call each factory once for each snap.\n * See {@link createEndowments} for details.\n */\nconst endowmentFactories = registeredEndowments.reduce((factories, builder) => {\n  builder.names.forEach((name) => {\n    factories.set(name, builder.factory);\n  });\n  return factories;\n}, new Map<string, (options?: EndowmentFactoryOptions) => EndowmentFactoryResult>());\n\n/**\n * Gets the endowments for a particular Snap. Some endowments, like `setTimeout`\n * and `clearTimeout`, must be attenuated so that they can only affect behavior\n * within the Snap's own realm. Therefore, we use factory functions to create\n * such attenuated / modified endowments. Otherwise, the value that's on the\n * root realm global will be used.\n *\n * @param options - An options bag.\n * @param options.snap - The Snaps global API object.\n * @param options.ethereum - The Snap's EIP-1193 provider object.\n * @param options.snapId - The id of the snap that will use the created endowments.\n * @param options.endowments - The list of endowments to provide to the snap.\n * @param options.notify - A reference to the notify function of the snap executor.\n * @returns An object containing the Snap's endowments.\n */\nexport function createEndowments({\n  snap,\n  ethereum,\n  snapId,\n  endowments,\n  notify,\n}: {\n  snap: SnapsProvider;\n  ethereum: StreamProvider;\n  snapId: string;\n  endowments: string[];\n  notify: NotifyFunction;\n}): { endowments: Record<string, unknown>; teardown: () => Promise<void> } {\n  const attenuatedEndowments: Record<string, unknown> = {};\n\n  // TODO: All endowments should be hardened to prevent covert communication\n  // channels. Hardening the returned objects breaks tests elsewhere in the\n  // monorepo, so further research is needed.\n  const result = endowments.reduce<{\n    allEndowments: Record<string, unknown>;\n    teardowns: (() => Promise<void> | void)[];\n  }>(\n    ({ allEndowments, teardowns }, endowmentName) => {\n      // First, check if the endowment has a factory, and default to that.\n      if (endowmentFactories.has(endowmentName)) {\n        if (!hasProperty(attenuatedEndowments, endowmentName)) {\n          // Call the endowment factory for the current endowment. If the factory\n          // creates multiple endowments, they will all be assigned to the\n          // `attenuatedEndowments` object, but will only be passed on to the snap\n          // if explicitly listed among its endowment.\n          // This may not have an actual use case, but, safety first.\n\n          // We just confirmed that endowmentFactories has the specified key.\n          // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n          const { teardownFunction, ...endowment } = endowmentFactories.get(\n            endowmentName,\n          )!({ snapId, notify });\n          Object.assign(attenuatedEndowments, endowment);\n          if (teardownFunction) {\n            teardowns.push(teardownFunction);\n          }\n        }\n        allEndowments[endowmentName] = attenuatedEndowments[endowmentName];\n      } else if (endowmentName === 'ethereum') {\n        // Special case for adding the EIP-1193 provider.\n        allEndowments[endowmentName] = ethereum;\n      } else if (endowmentName in rootRealmGlobal) {\n        logWarning(`Access to unhardened global ${endowmentName}.`);\n        // If the endowment doesn't have a factory, just use whatever is on the\n        // global object.\n        const globalValue = (rootRealmGlobal as Record<string, unknown>)[\n          endowmentName\n        ];\n        allEndowments[endowmentName] = globalValue;\n      } else {\n        // If we get to this point, we've been passed an endowment that doesn't\n        // exist in our current environment.\n        throw rpcErrors.internal(`Unknown endowment: \"${endowmentName}\".`);\n      }\n      return { allEndowments, teardowns };\n    },\n    {\n      allEndowments: { snap },\n      teardowns: [],\n    },\n  );\n\n  const teardown = async () => {\n    await Promise.all(\n      result.teardowns.map((teardownFunction) => teardownFunction()),\n    );\n  };\n  return { endowments: result.allEndowments, teardown };\n}\n"]}

package/dist/{types/common/endowments/index.d.ts → common/endowments/index.d.cts}

@@ -1,6 +1,6 @@
-import type { StreamProvider } from '@metamask/providers';
-import type { SnapsProvider } from '@metamask/snaps-sdk';
-import type { NotifyFunction } from '../BaseSnapExecutor';
+import type { StreamProvider } from "@metamask/providers";
+import type { SnapsProvider } from "@metamask/snaps-sdk";
+import type { NotifyFunction } from "../BaseSnapExecutor.cjs";
 /**
  * Gets the endowments for a particular Snap. Some endowments, like `setTimeout`
  * and `clearTimeout`, must be attenuated so that they can only affect behavior
@@ -26,3 +26,4 @@ export declare function createEndowments({ snap, ethereum, snapId, endowments, n
     endowments: Record<string, unknown>;
     teardown: () => Promise<void>;
 };
+//# sourceMappingURL=index.d.cts.map

package/dist/common/endowments/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/common/endowments/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,4BAA4B;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,4BAA4B;AAIzD,OAAO,KAAK,EAAE,cAAc,EAAE,gCAA4B;AAmC1D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,UAAU,EACV,MAAM,GACP,EAAE;IACD,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;CACxB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CA6DzE"}

package/dist/common/endowments/index.d.mts

@@ -0,0 +1,29 @@
+import type { StreamProvider } from "@metamask/providers";
+import type { SnapsProvider } from "@metamask/snaps-sdk";
+import type { NotifyFunction } from "../BaseSnapExecutor.mjs";
+/**
+ * Gets the endowments for a particular Snap. Some endowments, like `setTimeout`
+ * and `clearTimeout`, must be attenuated so that they can only affect behavior
+ * within the Snap's own realm. Therefore, we use factory functions to create
+ * such attenuated / modified endowments. Otherwise, the value that's on the
+ * root realm global will be used.
+ *
+ * @param options - An options bag.
+ * @param options.snap - The Snaps global API object.
+ * @param options.ethereum - The Snap's EIP-1193 provider object.
+ * @param options.snapId - The id of the snap that will use the created endowments.
+ * @param options.endowments - The list of endowments to provide to the snap.
+ * @param options.notify - A reference to the notify function of the snap executor.
+ * @returns An object containing the Snap's endowments.
+ */
+export declare function createEndowments({ snap, ethereum, snapId, endowments, notify, }: {
+    snap: SnapsProvider;
+    ethereum: StreamProvider;
+    snapId: string;
+    endowments: string[];
+    notify: NotifyFunction;
+}): {
+    endowments: Record<string, unknown>;
+    teardown: () => Promise<void>;
+};
+//# sourceMappingURL=index.d.mts.map

package/dist/common/endowments/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/common/endowments/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,4BAA4B;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,4BAA4B;AAIzD,OAAO,KAAK,EAAE,cAAc,EAAE,gCAA4B;AAmC1D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,UAAU,EACV,MAAM,GACP,EAAE;IACD,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;CACxB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CA6DzE"}