@metamask/snaps-execution-environments 0.34.1-flask.1 → 0.35.1-flask.1

package/CHANGELOG.md

@@ -6,6 +6,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.35.1-flask.1]
+### Changed
+- No changes this release.
+
+## [0.35.0-flask.1]
+### Changed
+- **BREAKING:** Build packages as both CJS and ESM ([#1519](https://github.com/MetaMask/snaps/pull/1519), ([#1532](https://github.com/MetaMask/snaps/pull/1532)))
+  - This is breaking in the sense that imports to `dist/` will now require you to import either `dist/cjs` or `dist/esm`.
+- Add `sideEffects: false` ([#1486](https://github.com/MetaMask/snaps/pull/1486))
+- Refactored bundling process to reduce bundle size ([#1458](https://github.com/MetaMask/snaps/pull/1458))
+
+### Removed
+- **BREAKING:** Remove support for `keyring` export ([#1527](https://github.com/MetaMask/snaps/pull/1527))
+
 ## [0.34.1-flask.1]
 ### Changed
 - Deploy `iframe-execution-environment` from this repository ([#1406](https://github.com/MetaMask/snaps/pull/1406))
@@ -264,7 +278,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Previously, default endowments were specified in the execution environment itself. Now, all endowments must be specified in the `executeSnap` RPC parameters, except for the `wallet` API object.
 - Add endowments to the global `self` in addition to `window` ([#263](https://github.com/MetaMask/snaps-monorepo/pull/263))
 
-[Unreleased]: https://github.com/MetaMask/snaps/compare/v0.34.1-flask.1...HEAD
+[Unreleased]: https://github.com/MetaMask/snaps/compare/v0.35.1-flask.1...HEAD
+[0.35.1-flask.1]: https://github.com/MetaMask/snaps/compare/v0.35.0-flask.1...v0.35.1-flask.1
+[0.35.0-flask.1]: https://github.com/MetaMask/snaps/compare/v0.34.1-flask.1...v0.35.0-flask.1
 [0.34.1-flask.1]: https://github.com/MetaMask/snaps/compare/v0.34.0-flask.1...v0.34.1-flask.1
 [0.34.0-flask.1]: https://github.com/MetaMask/snaps/compare/v0.33.1-flask.1...v0.34.0-flask.1
 [0.33.1-flask.1]: https://github.com/MetaMask/snaps/compare/v0.33.0-flask.1...v0.33.1-flask.1

package/dist/cjs/common/BaseSnapExecutor.js

@@ -0,0 +1,415 @@
+// eslint-disable-next-line @typescript-eslint/triple-slash-reference, spaced-comment
+/// <reference path="../../../../node_modules/ses/index.d.ts" />
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "BaseSnapExecutor", {
+    enumerable: true,
+    get: function() {
+        return BaseSnapExecutor;
+    }
+});
+const _providers = require("@metamask/providers");
+const _snapsutils = require("@metamask/snaps-utils");
+const _utils = require("@metamask/utils");
+const _ethrpcerrors = require("eth-rpc-errors");
+const _jsonrpcengine = require("json-rpc-engine");
+const _superstruct = require("superstruct");
+const _logging = require("../logging");
+const _openrpcjson = /*#__PURE__*/ _interop_require_default(require("../openrpc.json"));
+const _commands = require("./commands");
+const _endowments = require("./endowments");
+const _globalEvents = require("./globalEvents");
+const _sortParams = require("./sortParams");
+const _utils1 = require("./utils");
+const _validation = require("./validation");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+const fallbackError = {
+    code: _ethrpcerrors.errorCodes.rpc.internal,
+    message: 'Execution Environment Error'
+};
+/**
+ * The supported methods in the execution environment. The validator checks the
+ * incoming JSON-RPC request, and the `params` property is used for sorting the
+ * parameters, if they are an object.
+ */ const EXECUTION_ENVIRONMENT_METHODS = {
+    ping: {
+        struct: _validation.PingRequestArgumentsStruct,
+        params: []
+    },
+    executeSnap: {
+        struct: _validation.ExecuteSnapRequestArgumentsStruct,
+        params: [
+            'snapId',
+            'sourceCode',
+            'endowments'
+        ]
+    },
+    terminate: {
+        struct: _validation.TerminateRequestArgumentsStruct,
+        params: []
+    },
+    snapRpc: {
+        struct: _validation.SnapRpcRequestArgumentsStruct,
+        params: [
+            'target',
+            'handler',
+            'origin',
+            'request'
+        ]
+    }
+};
+class BaseSnapExecutor {
+    errorHandler(error, data) {
+        const constructedError = (0, _utils1.constructError)(error);
+        const serializedError = (0, _ethrpcerrors.serializeError)(constructedError, {
+            fallbackError,
+            shouldIncludeStack: false
+        });
+        // We're setting it this way to avoid sentData.stack = undefined
+        const sentData = {
+            ...data,
+            stack: constructedError?.stack ?? null
+        };
+        this.notify({
+            method: 'UnhandledError',
+            params: {
+                error: {
+                    ...serializedError,
+                    data: sentData
+                }
+            }
+        });
+    }
+    async onCommandRequest(message) {
+        if (!(0, _utils.isJsonRpcRequest)(message)) {
+            throw new Error('Command stream received a non-JSON-RPC request.');
+        }
+        const { id, method, params } = message;
+        if (method === 'rpc.discover') {
+            this.respond(id, {
+                result: _openrpcjson.default
+            });
+            return;
+        }
+        if (!(0, _utils.hasProperty)(EXECUTION_ENVIRONMENT_METHODS, method)) {
+            this.respond(id, {
+                error: _ethrpcerrors.ethErrors.rpc.methodNotFound({
+                    data: {
+                        method
+                    }
+                }).serialize()
+            });
+            return;
+        }
+        const methodObject = EXECUTION_ENVIRONMENT_METHODS[method];
+        // support params by-name and by-position
+        const paramsAsArray = (0, _sortParams.sortParamKeys)(methodObject.params, params);
+        const [error] = (0, _superstruct.validate)(paramsAsArray, methodObject.struct);
+        if (error) {
+            this.respond(id, {
+                error: _ethrpcerrors.ethErrors.rpc.invalidParams({
+                    message: `Invalid parameters for method "${method}": ${error.message}.`,
+                    data: {
+                        method,
+                        params: paramsAsArray
+                    }
+                }).serialize()
+            });
+            return;
+        }
+        try {
+            const result = await this.methods[method](...paramsAsArray);
+            this.respond(id, {
+                result
+            });
+        } catch (rpcError) {
+            this.respond(id, {
+                error: (0, _ethrpcerrors.serializeError)(rpcError, {
+                    fallbackError
+                })
+            });
+        }
+    }
+    notify(requestObject) {
+        if (!(0, _utils.isValidJson)(requestObject) || !(0, _utils.isObject)(requestObject)) {
+            throw new Error('JSON-RPC notifications must be JSON serializable objects');
+        }
+        this.commandStream.write({
+            ...requestObject,
+            jsonrpc: '2.0'
+        });
+    }
+    respond(id, requestObject) {
+        if (!(0, _utils.isValidJson)(requestObject) || !(0, _utils.isObject)(requestObject)) {
+            throw new Error('JSON-RPC responses must be JSON serializable objects.');
+        }
+        this.commandStream.write({
+            ...requestObject,
+            id,
+            jsonrpc: '2.0'
+        });
+    }
+    /**
+   * Attempts to evaluate a snap in SES. Generates APIs for the snap. May throw
+   * on errors.
+   *
+   * @param snapId - The id of the snap.
+   * @param sourceCode - The source code of the snap, in IIFE format.
+   * @param _endowments - An array of the names of the endowments.
+   */ async startSnap(snapId, sourceCode, _endowments1) {
+        (0, _logging.log)(`Starting snap '${snapId}' in worker.`);
+        if (this.snapPromiseErrorHandler) {
+            (0, _globalEvents.removeEventListener)('unhandledrejection', this.snapPromiseErrorHandler);
+        }
+        if (this.snapErrorHandler) {
+            (0, _globalEvents.removeEventListener)('error', this.snapErrorHandler);
+        }
+        this.snapErrorHandler = (error)=>{
+            this.errorHandler(error.error, {
+                snapId
+            });
+        };
+        this.snapPromiseErrorHandler = (error)=>{
+            this.errorHandler(error instanceof Error ? error : error.reason, {
+                snapId
+            });
+        };
+        const provider = new _providers.StreamProvider(this.rpcStream, {
+            jsonRpcStreamName: 'metamask-provider',
+            rpcMiddleware: [
+                (0, _jsonrpcengine.createIdRemapMiddleware)()
+            ]
+        });
+        await provider.initialize();
+        const snap = this.createSnapGlobal(provider);
+        const ethereum = this.createEIP1193Provider(provider);
+        // We specifically use any type because the Snap can modify the object any way they want
+        const snapModule = {
+            exports: {}
+        };
+        try {
+            const { endowments, teardown: endowmentTeardown } = (0, _endowments.createEndowments)(snap, ethereum, snapId, _endowments1);
+            // !!! Ensure that this is the only place the data is being set.
+            // Other methods access the object value and mutate its properties.
+            this.snapData.set(snapId, {
+                idleTeardown: endowmentTeardown,
+                runningEvaluations: new Set(),
+                exports: {}
+            });
+            (0, _globalEvents.addEventListener)('unhandledRejection', this.snapPromiseErrorHandler);
+            (0, _globalEvents.addEventListener)('error', this.snapErrorHandler);
+            const compartment = new Compartment({
+                ...endowments,
+                module: snapModule,
+                exports: snapModule.exports
+            });
+            // All of those are JavaScript runtime specific and self referential,
+            // but we add them for compatibility sake with external libraries.
+            //
+            // We can't do that in the injected globals object above
+            // because SES creates its own globalThis
+            compartment.globalThis.self = compartment.globalThis;
+            compartment.globalThis.global = compartment.globalThis;
+            compartment.globalThis.window = compartment.globalThis;
+            await this.executeInSnapContext(snapId, ()=>{
+                compartment.evaluate(sourceCode);
+                this.registerSnapExports(snapId, snapModule);
+            });
+        } catch (error) {
+            this.removeSnap(snapId);
+            throw new Error(`Error while running snap '${snapId}': ${error.message}`);
+        }
+    }
+    /**
+   * Cancels all running evaluations of all snaps and clears all snap data.
+   * NOTE:** Should only be called in response to the `terminate` RPC command.
+   */ onTerminate() {
+        // `stop()` tears down snap endowments.
+        // Teardown will also be run for each snap as soon as there are
+        // no more running evaluations for that snap.
+        this.snapData.forEach((data)=>data.runningEvaluations.forEach((evaluation)=>evaluation.stop()));
+        this.snapData.clear();
+    }
+    registerSnapExports(snapId, snapModule) {
+        const data = this.snapData.get(snapId);
+        // Somebody deleted the Snap before we could register
+        if (!data) {
+            return;
+        }
+        data.exports = _snapsutils.SNAP_EXPORT_NAMES.reduce((acc, exportName)=>{
+            const snapExport = snapModule.exports[exportName];
+            if ((0, _validation.validateExport)(exportName, snapExport)) {
+                return {
+                    ...acc,
+                    [exportName]: snapExport
+                };
+            }
+            return acc;
+        }, {});
+    }
+    /**
+   * Instantiates a snap API object (i.e. `globalThis.snap`).
+   *
+   * @param provider - A StreamProvider connected to MetaMask.
+   * @returns The snap provider object.
+   */ createSnapGlobal(provider) {
+        const originalRequest = provider.request.bind(provider);
+        const request = async (args)=>{
+            (0, _utils1.assertSnapOutboundRequest)(args);
+            const sanitizedArgs = (0, _utils.getSafeJson)(args);
+            this.notify({
+                method: 'OutboundRequest'
+            });
+            try {
+                return await (0, _utils1.withTeardown)(originalRequest(sanitizedArgs), this);
+            } finally{
+                this.notify({
+                    method: 'OutboundResponse'
+                });
+            }
+        };
+        // Proxy target is intentionally set to be an empty object, to ensure
+        // that access to the prototype chain is not possible.
+        const snapGlobalProxy = new Proxy({}, {
+            has (_target, prop) {
+                return typeof prop === 'string' && [
+                    'request'
+                ].includes(prop);
+            },
+            get (_target, prop) {
+                if (prop === 'request') {
+                    return request;
+                }
+                return undefined;
+            }
+        });
+        return harden(snapGlobalProxy);
+    }
+    /**
+   * Instantiates an EIP-1193 Ethereum provider object (i.e. `globalThis.ethereum`).
+   *
+   * @param provider - A StreamProvider connected to MetaMask.
+   * @returns The EIP-1193 Ethereum provider object.
+   */ createEIP1193Provider(provider) {
+        const originalRequest = provider.request.bind(provider);
+        const request = async (args)=>{
+            (0, _utils1.assertEthereumOutboundRequest)(args);
+            const sanitizedArgs = (0, _utils.getSafeJson)(args);
+            this.notify({
+                method: 'OutboundRequest'
+            });
+            try {
+                return await (0, _utils1.withTeardown)(originalRequest(sanitizedArgs), this);
+            } finally{
+                this.notify({
+                    method: 'OutboundResponse'
+                });
+            }
+        };
+        const streamProviderProxy = (0, _utils1.proxyStreamProvider)(provider, request);
+        return harden(streamProviderProxy);
+    }
+    /**
+   * Removes the snap with the given name.
+   *
+   * @param snapId - The id of the snap to remove.
+   */ removeSnap(snapId) {
+        this.snapData.delete(snapId);
+    }
+    /**
+   * Calls the specified executor function in the context of the specified snap.
+   * Essentially, this means that the operation performed by the executor is
+   * counted as an evaluation of the specified snap. When the count of running
+   * evaluations of a snap reaches zero, its endowments are torn down.
+   *
+   * @param snapId - The id of the snap whose context to execute in.
+   * @param executor - The function that will be executed in the snap's context.
+   * @returns The executor's return value.
+   * @template Result - The return value of the executor.
+   */ async executeInSnapContext(snapId, executor) {
+        const data = this.snapData.get(snapId);
+        if (data === undefined) {
+            throw new Error(`Tried to execute in context of unknown snap: "${snapId}".`);
+        }
+        let stop;
+        const stopPromise = new Promise((_, reject)=>stop = ()=>reject(// TODO(rekmarks): Specify / standardize error code for this case.
+                _ethrpcerrors.ethErrors.rpc.internal(`The snap "${snapId}" has been terminated during execution.`)));
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        const evaluationData = {
+            stop: stop
+        };
+        try {
+            data.runningEvaluations.add(evaluationData);
+            // Notice that we have to await this executor.
+            // If we didn't, we would decrease the amount of running evaluations
+            // before the promise actually resolves
+            return await Promise.race([
+                executor(),
+                stopPromise
+            ]);
+        } finally{
+            data.runningEvaluations.delete(evaluationData);
+            if (data.runningEvaluations.size === 0) {
+                this.lastTeardown += 1;
+                await data.idleTeardown();
+            }
+        }
+    }
+    constructor(commandStream, rpcStream){
+        _define_property(this, "snapData", void 0);
+        _define_property(this, "commandStream", void 0);
+        _define_property(this, "rpcStream", void 0);
+        _define_property(this, "methods", void 0);
+        _define_property(this, "snapErrorHandler", void 0);
+        _define_property(this, "snapPromiseErrorHandler", void 0);
+        _define_property(this, "lastTeardown", 0);
+        this.snapData = new Map();
+        this.commandStream = commandStream;
+        this.commandStream.on('data', (data)=>{
+            this.onCommandRequest(data).catch((error)=>{
+                // TODO: Decide how to handle errors.
+                (0, _snapsutils.logError)(error);
+            });
+        });
+        this.rpcStream = rpcStream;
+        this.methods = (0, _commands.getCommandMethodImplementations)(this.startSnap.bind(this), async (target, handlerName, args)=>{
+            const data = this.snapData.get(target);
+            // We're capturing the handler in case someone modifies the data object before the call
+            const handler = data?.exports[handlerName];
+            (0, _utils.assert)(handler !== undefined, `No ${handlerName} handler exported for snap "${target}`);
+            // TODO: fix handler args type cast
+            let result = await this.executeInSnapContext(target, ()=>handler(args));
+            // The handler might not return anything, but undefined is not valid JSON.
+            if (result === undefined) {
+                result = null;
+            }
+            // /!\ Always return only sanitized JSON to prevent security flaws. /!\
+            try {
+                return (0, _utils.getSafeJson)(result);
+            } catch (error) {
+                throw new TypeError(`Received non-JSON-serializable value: ${error.message.replace(/^Assertion failed: /u, '')}`);
+            }
+        }, this.onTerminate.bind(this));
+    }
+}
+
+//# sourceMappingURL=BaseSnapExecutor.js.map

package/dist/cjs/common/BaseSnapExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/common/BaseSnapExecutor.ts"],"sourcesContent":["// eslint-disable-next-line @typescript-eslint/triple-slash-reference, spaced-comment\n/// <reference path=\"../../../../node_modules/ses/index.d.ts\" />\nimport { StreamProvider } from '@metamask/providers';\nimport { RequestArguments } from '@metamask/providers/dist/BaseProvider';\nimport { SnapsGlobalObject } from '@metamask/rpc-methods';\nimport {\n  SnapExports,\n  HandlerType,\n  SnapExportsParameters,\n  SNAP_EXPORT_NAMES,\n  logError,\n} from '@metamask/snaps-utils';\nimport {\n  isObject,\n  isValidJson,\n  JsonRpcNotification,\n  assert,\n  isJsonRpcRequest,\n  JsonRpcId,\n  JsonRpcRequest,\n  Json,\n  hasProperty,\n  getSafeJson,\n} from '@metamask/utils';\nimport { errorCodes, ethErrors, serializeError } from 'eth-rpc-errors';\nimport { createIdRemapMiddleware } from 'json-rpc-engine';\nimport { Duplex } from 'stream';\nimport { validate } from 'superstruct';\n\nimport { log } from '../logging';\nimport EEOpenRPCDocument from '../openrpc.json';\nimport {\n  CommandMethodsMapping,\n  getCommandMethodImplementations,\n} from './commands';\nimport { createEndowments } from './endowments';\nimport { addEventListener, removeEventListener } from './globalEvents';\nimport { sortParamKeys } from './sortParams';\nimport {\n  assertEthereumOutboundRequest,\n  assertSnapOutboundRequest,\n  constructError,\n  proxyStreamProvider,\n  withTeardown,\n} from './utils';\nimport {\n  ExecuteSnapRequestArgumentsStruct,\n  PingRequestArgumentsStruct,\n  SnapRpcRequestArgumentsStruct,\n  TerminateRequestArgumentsStruct,\n  validateExport,\n} from './validation';\n\ntype EvaluationData = {\n  stop: () => void;\n};\n\ntype SnapData = {\n  exports: SnapExports;\n  runningEvaluations: Set<EvaluationData>;\n  idleTeardown: () => Promise<void>;\n};\n\nconst fallbackError = {\n  code: errorCodes.rpc.internal,\n  message: 'Execution Environment Error',\n};\n\nexport type InvokeSnapArgs = Omit<SnapExportsParameters[0], 'chainId'>;\n\nexport type InvokeSnap = (\n  target: string,\n  handler: HandlerType,\n  args: InvokeSnapArgs | undefined,\n) => Promise<Json>;\n\n/**\n * The supported methods in the execution environment. The validator checks the\n * incoming JSON-RPC request, and the `params` property is used for sorting the\n * parameters, if they are an object.\n */\nconst EXECUTION_ENVIRONMENT_METHODS = {\n  ping: {\n    struct: PingRequestArgumentsStruct,\n    params: [],\n  },\n  executeSnap: {\n    struct: ExecuteSnapRequestArgumentsStruct,\n    params: ['snapId', 'sourceCode', 'endowments'],\n  },\n  terminate: {\n    struct: TerminateRequestArgumentsStruct,\n    params: [],\n  },\n  snapRpc: {\n    struct: SnapRpcRequestArgumentsStruct,\n    params: ['target', 'handler', 'origin', 'request'],\n  },\n};\n\ntype Methods = typeof EXECUTION_ENVIRONMENT_METHODS;\n\nexport class BaseSnapExecutor {\n  private readonly snapData: Map<string, SnapData>;\n\n  private readonly commandStream: Duplex;\n\n  private readonly rpcStream: Duplex;\n\n  private readonly methods: CommandMethodsMapping;\n\n  private snapErrorHandler?: (event: ErrorEvent) => void;\n\n  private snapPromiseErrorHandler?: (event: PromiseRejectionEvent) => void;\n\n  private lastTeardown = 0;\n\n  protected constructor(commandStream: Duplex, rpcStream: Duplex) {\n    this.snapData = new Map();\n    this.commandStream = commandStream;\n    this.commandStream.on('data', (data) => {\n      this.onCommandRequest(data).catch((error) => {\n        // TODO: Decide how to handle errors.\n        logError(error);\n      });\n    });\n    this.rpcStream = rpcStream;\n\n    this.methods = getCommandMethodImplementations(\n      this.startSnap.bind(this),\n      async (target, handlerName, args) => {\n        const data = this.snapData.get(target);\n        // We're capturing the handler in case someone modifies the data object before the call\n        const handler = data?.exports[handlerName];\n        assert(\n          handler !== undefined,\n          `No ${handlerName} handler exported for snap \"${target}`,\n        );\n        // TODO: fix handler args type cast\n        let result = await this.executeInSnapContext(target, () =>\n          handler(args as any),\n        );\n\n        // The handler might not return anything, but undefined is not valid JSON.\n        if (result === undefined) {\n          result = null;\n        }\n\n        // /!\\ Always return only sanitized JSON to prevent security flaws. /!\\\n        try {\n          return getSafeJson(result);\n        } catch (error) {\n          throw new TypeError(\n            `Received non-JSON-serializable value: ${error.message.replace(\n              /^Assertion failed: /u,\n              '',\n            )}`,\n          );\n        }\n      },\n      this.onTerminate.bind(this),\n    );\n  }\n\n  private errorHandler(error: unknown, data: Record<string, Json>) {\n    const constructedError = constructError(error);\n    const serializedError = serializeError(constructedError, {\n      fallbackError,\n      shouldIncludeStack: false,\n    });\n\n    // We're setting it this way to avoid sentData.stack = undefined\n    const sentData: Json = { ...data, stack: constructedError?.stack ?? null };\n\n    this.notify({\n      method: 'UnhandledError',\n      params: {\n        error: {\n          ...serializedError,\n          data: sentData,\n        },\n      },\n    });\n  }\n\n  private async onCommandRequest(message: JsonRpcRequest) {\n    if (!isJsonRpcRequest(message)) {\n      throw new Error('Command stream received a non-JSON-RPC request.');\n    }\n\n    const { id, method, params } = message;\n    if (method === 'rpc.discover') {\n      this.respond(id, {\n        result: EEOpenRPCDocument,\n      });\n      return;\n    }\n\n    if (!hasProperty(EXECUTION_ENVIRONMENT_METHODS, method)) {\n      this.respond(id, {\n        error: ethErrors.rpc\n          .methodNotFound({\n            data: {\n              method,\n            },\n          })\n          .serialize(),\n      });\n      return;\n    }\n\n    const methodObject = EXECUTION_ENVIRONMENT_METHODS[method as keyof Methods];\n\n    // support params by-name and by-position\n    const paramsAsArray = sortParamKeys(methodObject.params, params);\n\n    const [error] = validate<any, any>(paramsAsArray, methodObject.struct);\n    if (error) {\n      this.respond(id, {\n        error: ethErrors.rpc\n          .invalidParams({\n            message: `Invalid parameters for method \"${method}\": ${error.message}.`,\n            data: {\n              method,\n              params: paramsAsArray,\n            },\n          })\n          .serialize(),\n      });\n      return;\n    }\n\n    try {\n      const result = await (this.methods as any)[method](...paramsAsArray);\n      this.respond(id, { result });\n    } catch (rpcError) {\n      this.respond(id, {\n        error: serializeError(rpcError, {\n          fallbackError,\n        }),\n      });\n    }\n  }\n\n  protected notify(requestObject: Omit<JsonRpcNotification, 'jsonrpc'>) {\n    if (!isValidJson(requestObject) || !isObject(requestObject)) {\n      throw new Error(\n        'JSON-RPC notifications must be JSON serializable objects',\n      );\n    }\n\n    this.commandStream.write({\n      ...requestObject,\n      jsonrpc: '2.0',\n    });\n  }\n\n  protected respond(id: JsonRpcId, requestObject: Record<string, unknown>) {\n    if (!isValidJson(requestObject) || !isObject(requestObject)) {\n      throw new Error('JSON-RPC responses must be JSON serializable objects.');\n    }\n\n    this.commandStream.write({\n      ...requestObject,\n      id,\n      jsonrpc: '2.0',\n    });\n  }\n\n  /**\n   * Attempts to evaluate a snap in SES. Generates APIs for the snap. May throw\n   * on errors.\n   *\n   * @param snapId - The id of the snap.\n   * @param sourceCode - The source code of the snap, in IIFE format.\n   * @param _endowments - An array of the names of the endowments.\n   */\n  protected async startSnap(\n    snapId: string,\n    sourceCode: string,\n    _endowments?: string[],\n  ): Promise<void> {\n    log(`Starting snap '${snapId}' in worker.`);\n    if (this.snapPromiseErrorHandler) {\n      removeEventListener('unhandledrejection', this.snapPromiseErrorHandler);\n    }\n\n    if (this.snapErrorHandler) {\n      removeEventListener('error', this.snapErrorHandler);\n    }\n\n    this.snapErrorHandler = (error: ErrorEvent) => {\n      this.errorHandler(error.error, { snapId });\n    };\n\n    this.snapPromiseErrorHandler = (error: PromiseRejectionEvent) => {\n      this.errorHandler(error instanceof Error ? error : error.reason, {\n        snapId,\n      });\n    };\n\n    const provider = new StreamProvider(this.rpcStream, {\n      jsonRpcStreamName: 'metamask-provider',\n      rpcMiddleware: [createIdRemapMiddleware()],\n    });\n\n    await provider.initialize();\n\n    const snap = this.createSnapGlobal(provider);\n    const ethereum = this.createEIP1193Provider(provider);\n    // We specifically use any type because the Snap can modify the object any way they want\n    const snapModule: any = { exports: {} };\n\n    try {\n      const { endowments, teardown: endowmentTeardown } = createEndowments(\n        snap,\n        ethereum,\n        snapId,\n        _endowments,\n      );\n\n      // !!! Ensure that this is the only place the data is being set.\n      // Other methods access the object value and mutate its properties.\n      this.snapData.set(snapId, {\n        idleTeardown: endowmentTeardown,\n        runningEvaluations: new Set(),\n        exports: {},\n      });\n\n      addEventListener('unhandledRejection', this.snapPromiseErrorHandler);\n      addEventListener('error', this.snapErrorHandler);\n\n      const compartment = new Compartment({\n        ...endowments,\n        module: snapModule,\n        exports: snapModule.exports,\n      });\n      // All of those are JavaScript runtime specific and self referential,\n      // but we add them for compatibility sake with external libraries.\n      //\n      // We can't do that in the injected globals object above\n      // because SES creates its own globalThis\n      compartment.globalThis.self = compartment.globalThis;\n      compartment.globalThis.global = compartment.globalThis;\n      compartment.globalThis.window = compartment.globalThis;\n\n      await this.executeInSnapContext(snapId, () => {\n        compartment.evaluate(sourceCode);\n        this.registerSnapExports(snapId, snapModule);\n      });\n    } catch (error) {\n      this.removeSnap(snapId);\n      throw new Error(\n        `Error while running snap '${snapId}': ${(error as Error).message}`,\n      );\n    }\n  }\n\n  /**\n   * Cancels all running evaluations of all snaps and clears all snap data.\n   * NOTE:** Should only be called in response to the `terminate` RPC command.\n   */\n  protected onTerminate() {\n    // `stop()` tears down snap endowments.\n    // Teardown will also be run for each snap as soon as there are\n    // no more running evaluations for that snap.\n    this.snapData.forEach((data) =>\n      data.runningEvaluations.forEach((evaluation) => evaluation.stop()),\n    );\n    this.snapData.clear();\n  }\n\n  private registerSnapExports(snapId: string, snapModule: any) {\n    const data = this.snapData.get(snapId);\n    // Somebody deleted the Snap before we could register\n    if (!data) {\n      return;\n    }\n\n    data.exports = SNAP_EXPORT_NAMES.reduce((acc, exportName) => {\n      const snapExport = snapModule.exports[exportName];\n      if (validateExport(exportName, snapExport)) {\n        return { ...acc, [exportName]: snapExport };\n      }\n      return acc;\n    }, {});\n  }\n\n  /**\n   * Instantiates a snap API object (i.e. `globalThis.snap`).\n   *\n   * @param provider - A StreamProvider connected to MetaMask.\n   * @returns The snap provider object.\n   */\n  private createSnapGlobal(provider: StreamProvider): SnapsGlobalObject {\n    const originalRequest = provider.request.bind(provider);\n\n    const request = async (args: RequestArguments) => {\n      assertSnapOutboundRequest(args);\n      const sanitizedArgs = getSafeJson(args);\n      this.notify({ method: 'OutboundRequest' });\n      try {\n        return await withTeardown(\n          originalRequest(sanitizedArgs as unknown as RequestArguments),\n          this as any,\n        );\n      } finally {\n        this.notify({ method: 'OutboundResponse' });\n      }\n    };\n\n    // Proxy target is intentionally set to be an empty object, to ensure\n    // that access to the prototype chain is not possible.\n    const snapGlobalProxy = new Proxy(\n      {},\n      {\n        has(_target: object, prop: string | symbol) {\n          return typeof prop === 'string' && ['request'].includes(prop);\n        },\n        get(_target, prop: keyof StreamProvider) {\n          if (prop === 'request') {\n            return request;\n          }\n\n          return undefined;\n        },\n      },\n    ) as SnapsGlobalObject;\n\n    return harden(snapGlobalProxy);\n  }\n\n  /**\n   * Instantiates an EIP-1193 Ethereum provider object (i.e. `globalThis.ethereum`).\n   *\n   * @param provider - A StreamProvider connected to MetaMask.\n   * @returns The EIP-1193 Ethereum provider object.\n   */\n  private createEIP1193Provider(provider: StreamProvider): StreamProvider {\n    const originalRequest = provider.request.bind(provider);\n\n    const request = async (args: RequestArguments) => {\n      assertEthereumOutboundRequest(args);\n      const sanitizedArgs = getSafeJson(args);\n      this.notify({ method: 'OutboundRequest' });\n      try {\n        return await withTeardown(\n          originalRequest(sanitizedArgs as unknown as RequestArguments),\n          this as any,\n        );\n      } finally {\n        this.notify({ method: 'OutboundResponse' });\n      }\n    };\n\n    const streamProviderProxy = proxyStreamProvider(provider, request);\n\n    return harden(streamProviderProxy);\n  }\n\n  /**\n   * Removes the snap with the given name.\n   *\n   * @param snapId - The id of the snap to remove.\n   */\n  private removeSnap(snapId: string): void {\n    this.snapData.delete(snapId);\n  }\n\n  /**\n   * Calls the specified executor function in the context of the specified snap.\n   * Essentially, this means that the operation performed by the executor is\n   * counted as an evaluation of the specified snap. When the count of running\n   * evaluations of a snap reaches zero, its endowments are torn down.\n   *\n   * @param snapId - The id of the snap whose context to execute in.\n   * @param executor - The function that will be executed in the snap's context.\n   * @returns The executor's return value.\n   * @template Result - The return value of the executor.\n   */\n  private async executeInSnapContext<Result>(\n    snapId: string,\n    executor: () => Promise<Result> | Result,\n  ): Promise<Result> {\n    const data = this.snapData.get(snapId);\n    if (data === undefined) {\n      throw new Error(\n        `Tried to execute in context of unknown snap: \"${snapId}\".`,\n      );\n    }\n\n    let stop: () => void;\n    const stopPromise = new Promise<never>(\n      (_, reject) =>\n        (stop = () =>\n          reject(\n            // TODO(rekmarks): Specify / standardize error code for this case.\n            ethErrors.rpc.internal(\n              `The snap \"${snapId}\" has been terminated during execution.`,\n            ),\n          )),\n    );\n\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n    const evaluationData = { stop: stop! };\n\n    try {\n      data.runningEvaluations.add(evaluationData);\n      // Notice that we have to await this executor.\n      // If we didn't, we would decrease the amount of running evaluations\n      // before the promise actually resolves\n      return await Promise.race([executor(), stopPromise]);\n    } finally {\n      data.runningEvaluations.delete(evaluationData);\n\n      if (data.runningEvaluations.size === 0) {\n        this.lastTeardown += 1;\n        await data.idleTeardown();\n      }\n    }\n  }\n}\n"],"names":["BaseSnapExecutor","fallbackError","code","errorCodes","rpc","internal","message","EXECUTION_ENVIRONMENT_METHODS","ping","struct","PingRequestArgumentsStruct","params","executeSnap","ExecuteSnapRequestArgumentsStruct","terminate","TerminateRequestArgumentsStruct","snapRpc","SnapRpcRequestArgumentsStruct","errorHandler","error","data","constructedError","constructError","serializedError","serializeError","shouldIncludeStack","sentData","stack","notify","method","onCommandRequest","isJsonRpcRequest","Error","id","respond","result","EEOpenRPCDocument","hasProperty","ethErrors","methodNotFound","serialize","methodObject","paramsAsArray","sortParamKeys","validate","invalidParams","methods","rpcError","requestObject","isValidJson","isObject","commandStream","write","jsonrpc","startSnap","snapId","sourceCode","_endowments","log","snapPromiseErrorHandler","removeEventListener","snapErrorHandler","reason","provider","StreamProvider","rpcStream","jsonRpcStreamName","rpcMiddleware","createIdRemapMiddleware","initialize","snap","createSnapGlobal","ethereum","createEIP1193Provider","snapModule","exports","endowments","teardown","endowmentTeardown","createEndowments","snapData","set","idleTeardown","runningEvaluations","Set","addEventListener","compartment","Compartment","module","globalThis","self","global","window","executeInSnapContext","evaluate","registerSnapExports","removeSnap","onTerminate","forEach","evaluation","stop","clear","get","SNAP_EXPORT_NAMES","reduce","acc","exportName","snapExport","validateExport","originalRequest","request","bind","args","assertSnapOutboundRequest","sanitizedArgs","getSafeJson","withTeardown","snapGlobalProxy","Proxy","has","_target","prop","includes","undefined","harden","assertEthereumOutboundRequest","streamProviderProxy","proxyStreamProvider","delete","executor","stopPromise","Promise","_","reject","evaluationData","add","race","size","lastTeardown","Map","on","catch","logError","getCommandMethodImplementations","target","handlerName","handler","assert","TypeError","replace"],"mappings":"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"}

package/dist/cjs/common/commands.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: all[name]
+    });
+}
+_export(exports, {
+    getHandlerArguments: function() {
+        return getHandlerArguments;
+    },
+    getCommandMethodImplementations: function() {
+        return getCommandMethodImplementations;
+    }
+});
+const _snapsutils = require("@metamask/snaps-utils");
+const _utils = require("@metamask/utils");
+const _validation = require("./validation");
+function getHandlerArguments(origin, handler, request) {
+    // `request` is already validated by the time this function is called.
+    switch(handler){
+        case _snapsutils.HandlerType.OnTransaction:
+            {
+                (0, _validation.assertIsOnTransactionRequestArguments)(request.params);
+                const { transaction, chainId, transactionOrigin } = request.params;
+                return {
+                    transaction,
+                    chainId,
+                    transactionOrigin
+                };
+            }
+        case _snapsutils.HandlerType.OnRpcRequest:
+            return {
+                origin,
+                request
+            };
+        case _snapsutils.HandlerType.OnCronjob:
+            return {
+                request
+            };
+        default:
+            return (0, _utils.assertExhaustive)(handler);
+    }
+}
+function getCommandMethodImplementations(startSnap, invokeSnap, onTerminate) {
+    return {
+        ping: async ()=>Promise.resolve('OK'),
+        terminate: async ()=>{
+            onTerminate();
+            return Promise.resolve('OK');
+        },
+        executeSnap: async (snapId, sourceCode, endowments)=>{
+            await startSnap(snapId, sourceCode, endowments);
+            return 'OK';
+        },
+        snapRpc: async (target, handler, origin, request)=>{
+            return await invokeSnap(target, handler, getHandlerArguments(origin, handler, request)) ?? null;
+        }
+    };
+}
+
+//# sourceMappingURL=commands.js.map

package/dist/cjs/common/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/common/commands.ts"],"sourcesContent":["import { HandlerType } from '@metamask/snaps-utils';\nimport { assertExhaustive } from '@metamask/utils';\n\nimport { InvokeSnap, InvokeSnapArgs } from './BaseSnapExecutor';\nimport {\n  assertIsOnTransactionRequestArguments,\n  ExecuteSnap,\n  JsonRpcRequestWithoutId,\n  Ping,\n  SnapRpc,\n  Terminate,\n} from './validation';\n\nexport type CommandMethodsMapping = {\n  ping: Ping;\n  terminate: Terminate;\n  executeSnap: ExecuteSnap;\n  snapRpc: SnapRpc;\n};\n\n/**\n * Formats the arguments for the given handler.\n *\n * @param origin - The origin of the request.\n * @param handler - The handler to pass the request to.\n * @param request - The request object.\n * @returns The formatted arguments.\n */\nexport function getHandlerArguments(\n  origin: string,\n  handler: HandlerType,\n  request: JsonRpcRequestWithoutId,\n): InvokeSnapArgs {\n  // `request` is already validated by the time this function is called.\n\n  switch (handler) {\n    case HandlerType.OnTransaction: {\n      assertIsOnTransactionRequestArguments(request.params);\n\n      const { transaction, chainId, transactionOrigin } = request.params;\n      return {\n        transaction,\n        chainId,\n        transactionOrigin,\n      };\n    }\n\n    case HandlerType.OnRpcRequest:\n      return { origin, request };\n\n    case HandlerType.OnCronjob:\n      return { request };\n\n    default:\n      return assertExhaustive(handler);\n  }\n}\n\n/**\n * Gets an object mapping internal, \"command\" JSON-RPC method names to their\n * implementations.\n *\n * @param startSnap - A function that starts a snap.\n * @param invokeSnap - A function that invokes the RPC method handler of a\n * snap.\n * @param onTerminate - A function that will be called when this executor is\n * terminated in order to handle cleanup tasks.\n * @returns An object containing the \"command\" method implementations.\n */\nexport function getCommandMethodImplementations(\n  startSnap: (...args: Parameters<ExecuteSnap>) => Promise<void>,\n  invokeSnap: InvokeSnap,\n  onTerminate: () => void,\n): CommandMethodsMapping {\n  return {\n    ping: async () => Promise.resolve('OK'),\n    terminate: async () => {\n      onTerminate();\n      return Promise.resolve('OK');\n    },\n\n    executeSnap: async (snapId, sourceCode, endowments) => {\n      await startSnap(snapId, sourceCode, endowments);\n      return 'OK';\n    },\n\n    snapRpc: async (target, handler, origin, request) => {\n      return (\n        (await invokeSnap(\n          target,\n          handler,\n          getHandlerArguments(origin, handler, request),\n        )) ?? null\n      );\n    },\n  };\n}\n"],"names":["getHandlerArguments","getCommandMethodImplementations","origin","handler","request","HandlerType","OnTransaction","assertIsOnTransactionRequestArguments","params","transaction","chainId","transactionOrigin","OnRpcRequest","OnCronjob","assertExhaustive","startSnap","invokeSnap","onTerminate","ping","Promise","resolve","terminate","executeSnap","snapId","sourceCode","endowments","snapRpc","target"],"mappings":";;;;;;;;;;;IA4BgBA,mBAAmB;eAAnBA;;IAyCAC,+BAA+B;eAA/BA;;;4BArEY;uBACK;4BAU1B;AAiBA,SAASD,oBACdE,MAAc,EACdC,OAAoB,EACpBC,OAAgC;IAEhC,sEAAsE;IAEtE,OAAQD;QACN,KAAKE,uBAAW,CAACC,aAAa;YAAE;gBAC9BC,IAAAA,iDAAqC,EAACH,QAAQI,MAAM;gBAEpD,MAAM,EAAEC,WAAW,EAAEC,OAAO,EAAEC,iBAAiB,EAAE,GAAGP,QAAQI,MAAM;gBAClE,OAAO;oBACLC;oBACAC;oBACAC;gBACF;YACF;QAEA,KAAKN,uBAAW,CAACO,YAAY;YAC3B,OAAO;gBAAEV;gBAAQE;YAAQ;QAE3B,KAAKC,uBAAW,CAACQ,SAAS;YACxB,OAAO;gBAAET;YAAQ;QAEnB;YACE,OAAOU,IAAAA,uBAAgB,EAACX;IAC5B;AACF;AAaO,SAASF,gCACdc,SAA8D,EAC9DC,UAAsB,EACtBC,WAAuB;IAEvB,OAAO;QACLC,MAAM,UAAYC,QAAQC,OAAO,CAAC;QAClCC,WAAW;YACTJ;YACA,OAAOE,QAAQC,OAAO,CAAC;QACzB;QAEAE,aAAa,OAAOC,QAAQC,YAAYC;YACtC,MAAMV,UAAUQ,QAAQC,YAAYC;YACpC,OAAO;QACT;QAEAC,SAAS,OAAOC,QAAQxB,SAASD,QAAQE;YACvC,OACE,AAAC,MAAMY,WACLW,QACAxB,SACAH,oBAAoBE,QAAQC,SAASC,aACjC;QAEV;IACF;AACF"}