@metamask/multichain-api-middleware 0.1.0

package/dist/middlewares/MultichainSubscriptionManager.cjs

@@ -0,0 +1,117 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _MultichainSubscriptionManager_instances, _MultichainSubscriptionManager_findNetworkClientIdByChainId, _MultichainSubscriptionManager_getNetworkClientById, _MultichainSubscriptionManager_subscriptions, _MultichainSubscriptionManager_getSubscriptionEntry, _MultichainSubscriptionManager_removeSubscriptionEntry, _MultichainSubscriptionManager_unsubscribe;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultichainSubscriptionManager = void 0;
+const controller_utils_1 = require("@metamask/controller-utils");
+const subscriptionManager_1 = __importDefault(require("@metamask/eth-json-rpc-filters/subscriptionManager.js"));
+const safe_event_emitter_1 = __importDefault(require("@metamask/safe-event-emitter"));
+const utils_1 = require("@metamask/utils");
+/**
+ * A helper that facilates the lifecycle of a SubscriptionManager instance that
+ * is meant to handle subscriptons for only one specific scope, origin, and tabId combination.
+ */
+class MultichainSubscriptionManager extends safe_event_emitter_1.default {
+    /**
+     * Construct a MultichainSubscriptionManager.
+     *
+     * @param options - The controller options.
+     * @param options.findNetworkClientIdByChainId - The hook to get the networkClientId from a chainId.
+     * @param options.getNetworkClientById - The hook to get the network client instance by its networkClientId.
+     */
+    constructor(options) {
+        super();
+        _MultichainSubscriptionManager_instances.add(this);
+        _MultichainSubscriptionManager_findNetworkClientIdByChainId.set(this, void 0);
+        _MultichainSubscriptionManager_getNetworkClientById.set(this, void 0);
+        _MultichainSubscriptionManager_subscriptions.set(this, []);
+        __classPrivateFieldSet(this, _MultichainSubscriptionManager_findNetworkClientIdByChainId, options.findNetworkClientIdByChainId, "f");
+        __classPrivateFieldSet(this, _MultichainSubscriptionManager_getNetworkClientById, options.getNetworkClientById, "f");
+    }
+    notify({ scope, origin, tabId }, { method, params }) {
+        this.emit('notification', origin, tabId, {
+            method: 'wallet_notify',
+            params: {
+                scope,
+                notification: { method, params },
+            },
+        });
+    }
+    subscribe(subscriptionKey) {
+        const subscriptionEntry = __classPrivateFieldGet(this, _MultichainSubscriptionManager_instances, "m", _MultichainSubscriptionManager_getSubscriptionEntry).call(this, subscriptionKey);
+        if (subscriptionEntry) {
+            return subscriptionEntry.subscriptionManager;
+        }
+        const networkClientId = __classPrivateFieldGet(this, _MultichainSubscriptionManager_findNetworkClientIdByChainId, "f").call(this, (0, controller_utils_1.toHex)((0, utils_1.parseCaipChainId)(subscriptionKey.scope).reference));
+        const networkClient = __classPrivateFieldGet(this, _MultichainSubscriptionManager_getNetworkClientById, "f").call(this, networkClientId);
+        const subscriptionManager = (0, subscriptionManager_1.default)({
+            blockTracker: networkClient.blockTracker,
+            provider: networkClient.provider,
+        });
+        subscriptionManager.events.on('notification', (message) => {
+            this.notify(subscriptionKey, message);
+        });
+        const newSubscriptionManagerEntry = {
+            ...subscriptionKey,
+            subscriptionManager,
+        };
+        subscriptionManager.destroy = subscriptionManager.middleware.destroy;
+        subscriptionManager.middleware.destroy = __classPrivateFieldGet(this, _MultichainSubscriptionManager_instances, "m", _MultichainSubscriptionManager_unsubscribe).bind(this, newSubscriptionManagerEntry);
+        __classPrivateFieldGet(this, _MultichainSubscriptionManager_subscriptions, "f").push(newSubscriptionManagerEntry);
+        return subscriptionManager;
+    }
+    unsubscribeByScope(scope) {
+        __classPrivateFieldGet(this, _MultichainSubscriptionManager_subscriptions, "f").forEach((subscriptionEntry) => {
+            if (subscriptionEntry.scope === scope) {
+                __classPrivateFieldGet(this, _MultichainSubscriptionManager_instances, "m", _MultichainSubscriptionManager_unsubscribe).call(this, subscriptionEntry);
+            }
+        });
+    }
+    unsubscribeByScopeAndOrigin(scope, origin) {
+        __classPrivateFieldGet(this, _MultichainSubscriptionManager_subscriptions, "f").forEach((subscriptionEntry) => {
+            if (subscriptionEntry.scope === scope &&
+                subscriptionEntry.origin === origin) {
+                __classPrivateFieldGet(this, _MultichainSubscriptionManager_instances, "m", _MultichainSubscriptionManager_unsubscribe).call(this, subscriptionEntry);
+            }
+        });
+    }
+    unsubscribeByOriginAndTabId(origin, tabId) {
+        __classPrivateFieldGet(this, _MultichainSubscriptionManager_subscriptions, "f").forEach((subscriptionEntry) => {
+            if (subscriptionEntry.origin === origin &&
+                subscriptionEntry.tabId === tabId) {
+                __classPrivateFieldGet(this, _MultichainSubscriptionManager_instances, "m", _MultichainSubscriptionManager_unsubscribe).call(this, subscriptionEntry);
+            }
+        });
+    }
+}
+exports.MultichainSubscriptionManager = MultichainSubscriptionManager;
+_MultichainSubscriptionManager_findNetworkClientIdByChainId = new WeakMap(), _MultichainSubscriptionManager_getNetworkClientById = new WeakMap(), _MultichainSubscriptionManager_subscriptions = new WeakMap(), _MultichainSubscriptionManager_instances = new WeakSet(), _MultichainSubscriptionManager_getSubscriptionEntry = function _MultichainSubscriptionManager_getSubscriptionEntry({ scope, origin, tabId, }) {
+    return __classPrivateFieldGet(this, _MultichainSubscriptionManager_subscriptions, "f").find((subscriptionEntry) => {
+        return (subscriptionEntry.scope === scope &&
+            subscriptionEntry.origin === origin &&
+            subscriptionEntry.tabId === tabId);
+    });
+}, _MultichainSubscriptionManager_removeSubscriptionEntry = function _MultichainSubscriptionManager_removeSubscriptionEntry({ scope, origin, tabId }) {
+    __classPrivateFieldSet(this, _MultichainSubscriptionManager_subscriptions, __classPrivateFieldGet(this, _MultichainSubscriptionManager_subscriptions, "f").filter((subscriptionEntry) => {
+        return (subscriptionEntry.scope !== scope ||
+            subscriptionEntry.origin !== origin ||
+            subscriptionEntry.tabId !== tabId);
+    }), "f");
+}, _MultichainSubscriptionManager_unsubscribe = function _MultichainSubscriptionManager_unsubscribe(subscriptionEntry) {
+    subscriptionEntry.subscriptionManager.destroy?.();
+    __classPrivateFieldGet(this, _MultichainSubscriptionManager_instances, "m", _MultichainSubscriptionManager_removeSubscriptionEntry).call(this, subscriptionEntry);
+};
+//# sourceMappingURL=MultichainSubscriptionManager.cjs.map

package/dist/middlewares/MultichainSubscriptionManager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainSubscriptionManager.cjs","sourceRoot":"","sources":["../../src/middlewares/MultichainSubscriptionManager.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExternalScopeString } from '@metamask/chain-agnostic-permission';\nimport { toHex } from '@metamask/controller-utils';\nimport createSubscriptionManager from '@metamask/eth-json-rpc-filters/subscriptionManager';\nimport type { NetworkController } from '@metamask/network-controller';\nimport SafeEventEmitter from '@metamask/safe-event-emitter';\nimport type { CaipChainId, Hex } from '@metamask/utils';\nimport { parseCaipChainId } from '@metamask/utils';\n\nimport type { ExtendedJsonRpcMiddleware } from './MultichainMiddlewareManager';\n\nexport type SubscriptionManager = {\n  events: SafeEventEmitter;\n  destroy?: () => void;\n  middleware: ExtendedJsonRpcMiddleware;\n};\n\ntype SubscriptionNotificationEvent = {\n  jsonrpc: '2.0';\n  method: 'eth_subscription';\n  params: {\n    subscription: Hex;\n    result: unknown;\n  };\n};\n\ntype SubscriptionKey = {\n  scope: ExternalScopeString;\n  origin: string;\n  tabId?: number;\n};\ntype SubscriptionEntry = SubscriptionKey & {\n  subscriptionManager: SubscriptionManager;\n};\n\ntype MultichainSubscriptionManagerOptions = {\n  findNetworkClientIdByChainId: NetworkController['findNetworkClientIdByChainId'];\n  getNetworkClientById: NetworkController['getNetworkClientById'];\n};\n\n/**\n * A helper that facilates the lifecycle of a SubscriptionManager instance that\n * is meant to handle subscriptons for only one specific scope, origin, and tabId combination.\n */\nexport class MultichainSubscriptionManager extends SafeEventEmitter {\n  readonly #findNetworkClientIdByChainId: NetworkController['findNetworkClientIdByChainId'];\n\n  readonly #getNetworkClientById: NetworkController['getNetworkClientById'];\n\n  #subscriptions: SubscriptionEntry[] = [];\n\n  /**\n   * Construct a MultichainSubscriptionManager.\n   *\n   * @param options - The controller options.\n   * @param options.findNetworkClientIdByChainId - The hook to get the networkClientId from a chainId.\n   * @param options.getNetworkClientById - The hook to get the network client instance by its networkClientId.\n   */\n  constructor(options: MultichainSubscriptionManagerOptions) {\n    super();\n    this.#findNetworkClientIdByChainId = options.findNetworkClientIdByChainId;\n    this.#getNetworkClientById = options.getNetworkClientById;\n  }\n\n  notify(\n    { scope, origin, tabId }: SubscriptionKey,\n    { method, params }: SubscriptionNotificationEvent,\n  ) {\n    this.emit('notification', origin, tabId, {\n      method: 'wallet_notify',\n      params: {\n        scope,\n        notification: { method, params },\n      },\n    });\n  }\n\n  #getSubscriptionEntry({\n    scope,\n    origin,\n    tabId,\n  }: SubscriptionKey): SubscriptionEntry | undefined {\n    return this.#subscriptions.find((subscriptionEntry) => {\n      return (\n        subscriptionEntry.scope === scope &&\n        subscriptionEntry.origin === origin &&\n        subscriptionEntry.tabId === tabId\n      );\n    });\n  }\n\n  #removeSubscriptionEntry({ scope, origin, tabId }: SubscriptionEntry) {\n    this.#subscriptions = this.#subscriptions.filter((subscriptionEntry) => {\n      return (\n        subscriptionEntry.scope !== scope ||\n        subscriptionEntry.origin !== origin ||\n        subscriptionEntry.tabId !== tabId\n      );\n    });\n  }\n\n  subscribe(subscriptionKey: SubscriptionKey) {\n    const subscriptionEntry = this.#getSubscriptionEntry(subscriptionKey);\n    if (subscriptionEntry) {\n      return subscriptionEntry.subscriptionManager;\n    }\n\n    const networkClientId = this.#findNetworkClientIdByChainId(\n      toHex(parseCaipChainId(subscriptionKey.scope as CaipChainId).reference),\n    );\n    const networkClient = this.#getNetworkClientById(networkClientId);\n    const subscriptionManager = createSubscriptionManager({\n      blockTracker: networkClient.blockTracker,\n      provider: networkClient.provider,\n    });\n\n    subscriptionManager.events.on(\n      'notification',\n      (message: SubscriptionNotificationEvent) => {\n        this.notify(subscriptionKey, message);\n      },\n    );\n\n    const newSubscriptionManagerEntry = {\n      ...subscriptionKey,\n      subscriptionManager,\n    };\n    subscriptionManager.destroy = subscriptionManager.middleware.destroy;\n    subscriptionManager.middleware.destroy = this.#unsubscribe.bind(\n      this,\n      newSubscriptionManagerEntry,\n    );\n\n    this.#subscriptions.push(newSubscriptionManagerEntry);\n\n    return subscriptionManager;\n  }\n\n  #unsubscribe(subscriptionEntry: SubscriptionEntry) {\n    subscriptionEntry.subscriptionManager.destroy?.();\n\n    this.#removeSubscriptionEntry(subscriptionEntry);\n  }\n\n  unsubscribeByScope(scope: ExternalScopeString) {\n    this.#subscriptions.forEach((subscriptionEntry) => {\n      if (subscriptionEntry.scope === scope) {\n        this.#unsubscribe(subscriptionEntry);\n      }\n    });\n  }\n\n  unsubscribeByScopeAndOrigin(scope: ExternalScopeString, origin: string) {\n    this.#subscriptions.forEach((subscriptionEntry) => {\n      if (\n        subscriptionEntry.scope === scope &&\n        subscriptionEntry.origin === origin\n      ) {\n        this.#unsubscribe(subscriptionEntry);\n      }\n    });\n  }\n\n  unsubscribeByOriginAndTabId(origin: string, tabId?: number) {\n    this.#subscriptions.forEach((subscriptionEntry) => {\n      if (\n        subscriptionEntry.origin === origin &&\n        subscriptionEntry.tabId === tabId\n      ) {\n        this.#unsubscribe(subscriptionEntry);\n      }\n    });\n  }\n}\n"]}

package/dist/middlewares/MultichainSubscriptionManager.d.cts

@@ -0,0 +1,49 @@
+import type { ExternalScopeString } from "@metamask/chain-agnostic-permission";
+import type { NetworkController } from "@metamask/network-controller";
+import SafeEventEmitter from "@metamask/safe-event-emitter";
+import type { Hex } from "@metamask/utils";
+import type { ExtendedJsonRpcMiddleware } from "./MultichainMiddlewareManager.cjs";
+export type SubscriptionManager = {
+    events: SafeEventEmitter;
+    destroy?: () => void;
+    middleware: ExtendedJsonRpcMiddleware;
+};
+type SubscriptionNotificationEvent = {
+    jsonrpc: '2.0';
+    method: 'eth_subscription';
+    params: {
+        subscription: Hex;
+        result: unknown;
+    };
+};
+type SubscriptionKey = {
+    scope: ExternalScopeString;
+    origin: string;
+    tabId?: number;
+};
+type MultichainSubscriptionManagerOptions = {
+    findNetworkClientIdByChainId: NetworkController['findNetworkClientIdByChainId'];
+    getNetworkClientById: NetworkController['getNetworkClientById'];
+};
+/**
+ * A helper that facilates the lifecycle of a SubscriptionManager instance that
+ * is meant to handle subscriptons for only one specific scope, origin, and tabId combination.
+ */
+export declare class MultichainSubscriptionManager extends SafeEventEmitter {
+    #private;
+    /**
+     * Construct a MultichainSubscriptionManager.
+     *
+     * @param options - The controller options.
+     * @param options.findNetworkClientIdByChainId - The hook to get the networkClientId from a chainId.
+     * @param options.getNetworkClientById - The hook to get the network client instance by its networkClientId.
+     */
+    constructor(options: MultichainSubscriptionManagerOptions);
+    notify({ scope, origin, tabId }: SubscriptionKey, { method, params }: SubscriptionNotificationEvent): void;
+    subscribe(subscriptionKey: SubscriptionKey): any;
+    unsubscribeByScope(scope: ExternalScopeString): void;
+    unsubscribeByScopeAndOrigin(scope: ExternalScopeString, origin: string): void;
+    unsubscribeByOriginAndTabId(origin: string, tabId?: number): void;
+}
+export {};
+//# sourceMappingURL=MultichainSubscriptionManager.d.cts.map

package/dist/middlewares/MultichainSubscriptionManager.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainSubscriptionManager.d.cts","sourceRoot":"","sources":["../../src/middlewares/MultichainSubscriptionManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,4CAA4C;AAG/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,qCAAqC;AACtE,OAAO,gBAAgB,qCAAqC;AAC5D,OAAO,KAAK,EAAe,GAAG,EAAE,wBAAwB;AAGxD,OAAO,KAAK,EAAE,yBAAyB,EAAE,0CAAsC;AAE/E,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,EAAE,yBAAyB,CAAC;CACvC,CAAC;AAEF,KAAK,6BAA6B,GAAG;IACnC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE;QACN,YAAY,EAAE,GAAG,CAAC;QAClB,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAKF,KAAK,oCAAoC,GAAG;IAC1C,4BAA4B,EAAE,iBAAiB,CAAC,8BAA8B,CAAC,CAAC;IAChF,oBAAoB,EAAE,iBAAiB,CAAC,sBAAsB,CAAC,CAAC;CACjE,CAAC;AAEF;;;GAGG;AACH,qBAAa,6BAA8B,SAAQ,gBAAgB;;IAOjE;;;;;;OAMG;gBACS,OAAO,EAAE,oCAAoC;IAMzD,MAAM,CACJ,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,eAAe,EACzC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,6BAA6B;IAmCnD,SAAS,CAAC,eAAe,EAAE,eAAe;IA2C1C,kBAAkB,CAAC,KAAK,EAAE,mBAAmB;IAQ7C,2BAA2B,CAAC,KAAK,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM;IAWtE,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAU3D"}

package/dist/middlewares/MultichainSubscriptionManager.d.mts

@@ -0,0 +1,49 @@
+import type { ExternalScopeString } from "@metamask/chain-agnostic-permission";
+import type { NetworkController } from "@metamask/network-controller";
+import SafeEventEmitter from "@metamask/safe-event-emitter";
+import type { Hex } from "@metamask/utils";
+import type { ExtendedJsonRpcMiddleware } from "./MultichainMiddlewareManager.mjs";
+export type SubscriptionManager = {
+    events: SafeEventEmitter;
+    destroy?: () => void;
+    middleware: ExtendedJsonRpcMiddleware;
+};
+type SubscriptionNotificationEvent = {
+    jsonrpc: '2.0';
+    method: 'eth_subscription';
+    params: {
+        subscription: Hex;
+        result: unknown;
+    };
+};
+type SubscriptionKey = {
+    scope: ExternalScopeString;
+    origin: string;
+    tabId?: number;
+};
+type MultichainSubscriptionManagerOptions = {
+    findNetworkClientIdByChainId: NetworkController['findNetworkClientIdByChainId'];
+    getNetworkClientById: NetworkController['getNetworkClientById'];
+};
+/**
+ * A helper that facilates the lifecycle of a SubscriptionManager instance that
+ * is meant to handle subscriptons for only one specific scope, origin, and tabId combination.
+ */
+export declare class MultichainSubscriptionManager extends SafeEventEmitter {
+    #private;
+    /**
+     * Construct a MultichainSubscriptionManager.
+     *
+     * @param options - The controller options.
+     * @param options.findNetworkClientIdByChainId - The hook to get the networkClientId from a chainId.
+     * @param options.getNetworkClientById - The hook to get the network client instance by its networkClientId.
+     */
+    constructor(options: MultichainSubscriptionManagerOptions);
+    notify({ scope, origin, tabId }: SubscriptionKey, { method, params }: SubscriptionNotificationEvent): void;
+    subscribe(subscriptionKey: SubscriptionKey): any;
+    unsubscribeByScope(scope: ExternalScopeString): void;
+    unsubscribeByScopeAndOrigin(scope: ExternalScopeString, origin: string): void;
+    unsubscribeByOriginAndTabId(origin: string, tabId?: number): void;
+}
+export {};
+//# sourceMappingURL=MultichainSubscriptionManager.d.mts.map

package/dist/middlewares/MultichainSubscriptionManager.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainSubscriptionManager.d.mts","sourceRoot":"","sources":["../../src/middlewares/MultichainSubscriptionManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,4CAA4C;AAG/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,qCAAqC;AACtE,OAAO,gBAAgB,qCAAqC;AAC5D,OAAO,KAAK,EAAe,GAAG,EAAE,wBAAwB;AAGxD,OAAO,KAAK,EAAE,yBAAyB,EAAE,0CAAsC;AAE/E,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,EAAE,yBAAyB,CAAC;CACvC,CAAC;AAEF,KAAK,6BAA6B,GAAG;IACnC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE;QACN,YAAY,EAAE,GAAG,CAAC;QAClB,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAKF,KAAK,oCAAoC,GAAG;IAC1C,4BAA4B,EAAE,iBAAiB,CAAC,8BAA8B,CAAC,CAAC;IAChF,oBAAoB,EAAE,iBAAiB,CAAC,sBAAsB,CAAC,CAAC;CACjE,CAAC;AAEF;;;GAGG;AACH,qBAAa,6BAA8B,SAAQ,gBAAgB;;IAOjE;;;;;;OAMG;gBACS,OAAO,EAAE,oCAAoC;IAMzD,MAAM,CACJ,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,eAAe,EACzC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,6BAA6B;IAmCnD,SAAS,CAAC,eAAe,EAAE,eAAe;IA2C1C,kBAAkB,CAAC,KAAK,EAAE,mBAAmB;IAQ7C,2BAA2B,CAAC,KAAK,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM;IAWtE,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAU3D"}

package/dist/middlewares/MultichainSubscriptionManager.mjs

@@ -0,0 +1,117 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _MultichainSubscriptionManager_instances, _MultichainSubscriptionManager_findNetworkClientIdByChainId, _MultichainSubscriptionManager_getNetworkClientById, _MultichainSubscriptionManager_subscriptions, _MultichainSubscriptionManager_getSubscriptionEntry, _MultichainSubscriptionManager_removeSubscriptionEntry, _MultichainSubscriptionManager_unsubscribe;
+function $importDefault(module) {
+    if (module?.__esModule) {
+        return module.default;
+    }
+    return module;
+}
+import { toHex } from "@metamask/controller-utils";
+import $createSubscriptionManager from "@metamask/eth-json-rpc-filters/subscriptionManager.js";
+const createSubscriptionManager = $importDefault($createSubscriptionManager);
+import SafeEventEmitter from "@metamask/safe-event-emitter";
+import { parseCaipChainId } from "@metamask/utils";
+/**
+ * A helper that facilates the lifecycle of a SubscriptionManager instance that
+ * is meant to handle subscriptons for only one specific scope, origin, and tabId combination.
+ */
+export class MultichainSubscriptionManager extends SafeEventEmitter {
+    /**
+     * Construct a MultichainSubscriptionManager.
+     *
+     * @param options - The controller options.
+     * @param options.findNetworkClientIdByChainId - The hook to get the networkClientId from a chainId.
+     * @param options.getNetworkClientById - The hook to get the network client instance by its networkClientId.
+     */
+    constructor(options) {
+        super();
+        _MultichainSubscriptionManager_instances.add(this);
+        _MultichainSubscriptionManager_findNetworkClientIdByChainId.set(this, void 0);
+        _MultichainSubscriptionManager_getNetworkClientById.set(this, void 0);
+        _MultichainSubscriptionManager_subscriptions.set(this, []);
+        __classPrivateFieldSet(this, _MultichainSubscriptionManager_findNetworkClientIdByChainId, options.findNetworkClientIdByChainId, "f");
+        __classPrivateFieldSet(this, _MultichainSubscriptionManager_getNetworkClientById, options.getNetworkClientById, "f");
+    }
+    notify({ scope, origin, tabId }, { method, params }) {
+        this.emit('notification', origin, tabId, {
+            method: 'wallet_notify',
+            params: {
+                scope,
+                notification: { method, params },
+            },
+        });
+    }
+    subscribe(subscriptionKey) {
+        const subscriptionEntry = __classPrivateFieldGet(this, _MultichainSubscriptionManager_instances, "m", _MultichainSubscriptionManager_getSubscriptionEntry).call(this, subscriptionKey);
+        if (subscriptionEntry) {
+            return subscriptionEntry.subscriptionManager;
+        }
+        const networkClientId = __classPrivateFieldGet(this, _MultichainSubscriptionManager_findNetworkClientIdByChainId, "f").call(this, toHex(parseCaipChainId(subscriptionKey.scope).reference));
+        const networkClient = __classPrivateFieldGet(this, _MultichainSubscriptionManager_getNetworkClientById, "f").call(this, networkClientId);
+        const subscriptionManager = createSubscriptionManager({
+            blockTracker: networkClient.blockTracker,
+            provider: networkClient.provider,
+        });
+        subscriptionManager.events.on('notification', (message) => {
+            this.notify(subscriptionKey, message);
+        });
+        const newSubscriptionManagerEntry = {
+            ...subscriptionKey,
+            subscriptionManager,
+        };
+        subscriptionManager.destroy = subscriptionManager.middleware.destroy;
+        subscriptionManager.middleware.destroy = __classPrivateFieldGet(this, _MultichainSubscriptionManager_instances, "m", _MultichainSubscriptionManager_unsubscribe).bind(this, newSubscriptionManagerEntry);
+        __classPrivateFieldGet(this, _MultichainSubscriptionManager_subscriptions, "f").push(newSubscriptionManagerEntry);
+        return subscriptionManager;
+    }
+    unsubscribeByScope(scope) {
+        __classPrivateFieldGet(this, _MultichainSubscriptionManager_subscriptions, "f").forEach((subscriptionEntry) => {
+            if (subscriptionEntry.scope === scope) {
+                __classPrivateFieldGet(this, _MultichainSubscriptionManager_instances, "m", _MultichainSubscriptionManager_unsubscribe).call(this, subscriptionEntry);
+            }
+        });
+    }
+    unsubscribeByScopeAndOrigin(scope, origin) {
+        __classPrivateFieldGet(this, _MultichainSubscriptionManager_subscriptions, "f").forEach((subscriptionEntry) => {
+            if (subscriptionEntry.scope === scope &&
+                subscriptionEntry.origin === origin) {
+                __classPrivateFieldGet(this, _MultichainSubscriptionManager_instances, "m", _MultichainSubscriptionManager_unsubscribe).call(this, subscriptionEntry);
+            }
+        });
+    }
+    unsubscribeByOriginAndTabId(origin, tabId) {
+        __classPrivateFieldGet(this, _MultichainSubscriptionManager_subscriptions, "f").forEach((subscriptionEntry) => {
+            if (subscriptionEntry.origin === origin &&
+                subscriptionEntry.tabId === tabId) {
+                __classPrivateFieldGet(this, _MultichainSubscriptionManager_instances, "m", _MultichainSubscriptionManager_unsubscribe).call(this, subscriptionEntry);
+            }
+        });
+    }
+}
+_MultichainSubscriptionManager_findNetworkClientIdByChainId = new WeakMap(), _MultichainSubscriptionManager_getNetworkClientById = new WeakMap(), _MultichainSubscriptionManager_subscriptions = new WeakMap(), _MultichainSubscriptionManager_instances = new WeakSet(), _MultichainSubscriptionManager_getSubscriptionEntry = function _MultichainSubscriptionManager_getSubscriptionEntry({ scope, origin, tabId, }) {
+    return __classPrivateFieldGet(this, _MultichainSubscriptionManager_subscriptions, "f").find((subscriptionEntry) => {
+        return (subscriptionEntry.scope === scope &&
+            subscriptionEntry.origin === origin &&
+            subscriptionEntry.tabId === tabId);
+    });
+}, _MultichainSubscriptionManager_removeSubscriptionEntry = function _MultichainSubscriptionManager_removeSubscriptionEntry({ scope, origin, tabId }) {
+    __classPrivateFieldSet(this, _MultichainSubscriptionManager_subscriptions, __classPrivateFieldGet(this, _MultichainSubscriptionManager_subscriptions, "f").filter((subscriptionEntry) => {
+        return (subscriptionEntry.scope !== scope ||
+            subscriptionEntry.origin !== origin ||
+            subscriptionEntry.tabId !== tabId);
+    }), "f");
+}, _MultichainSubscriptionManager_unsubscribe = function _MultichainSubscriptionManager_unsubscribe(subscriptionEntry) {
+    subscriptionEntry.subscriptionManager.destroy?.();
+    __classPrivateFieldGet(this, _MultichainSubscriptionManager_instances, "m", _MultichainSubscriptionManager_removeSubscriptionEntry).call(this, subscriptionEntry);
+};
+//# sourceMappingURL=MultichainSubscriptionManager.mjs.map

package/dist/middlewares/MultichainSubscriptionManager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultichainSubscriptionManager.mjs","sourceRoot":"","sources":["../../src/middlewares/MultichainSubscriptionManager.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExternalScopeString } from '@metamask/chain-agnostic-permission';\nimport { toHex } from '@metamask/controller-utils';\nimport createSubscriptionManager from '@metamask/eth-json-rpc-filters/subscriptionManager';\nimport type { NetworkController } from '@metamask/network-controller';\nimport SafeEventEmitter from '@metamask/safe-event-emitter';\nimport type { CaipChainId, Hex } from '@metamask/utils';\nimport { parseCaipChainId } from '@metamask/utils';\n\nimport type { ExtendedJsonRpcMiddleware } from './MultichainMiddlewareManager';\n\nexport type SubscriptionManager = {\n  events: SafeEventEmitter;\n  destroy?: () => void;\n  middleware: ExtendedJsonRpcMiddleware;\n};\n\ntype SubscriptionNotificationEvent = {\n  jsonrpc: '2.0';\n  method: 'eth_subscription';\n  params: {\n    subscription: Hex;\n    result: unknown;\n  };\n};\n\ntype SubscriptionKey = {\n  scope: ExternalScopeString;\n  origin: string;\n  tabId?: number;\n};\ntype SubscriptionEntry = SubscriptionKey & {\n  subscriptionManager: SubscriptionManager;\n};\n\ntype MultichainSubscriptionManagerOptions = {\n  findNetworkClientIdByChainId: NetworkController['findNetworkClientIdByChainId'];\n  getNetworkClientById: NetworkController['getNetworkClientById'];\n};\n\n/**\n * A helper that facilates the lifecycle of a SubscriptionManager instance that\n * is meant to handle subscriptons for only one specific scope, origin, and tabId combination.\n */\nexport class MultichainSubscriptionManager extends SafeEventEmitter {\n  readonly #findNetworkClientIdByChainId: NetworkController['findNetworkClientIdByChainId'];\n\n  readonly #getNetworkClientById: NetworkController['getNetworkClientById'];\n\n  #subscriptions: SubscriptionEntry[] = [];\n\n  /**\n   * Construct a MultichainSubscriptionManager.\n   *\n   * @param options - The controller options.\n   * @param options.findNetworkClientIdByChainId - The hook to get the networkClientId from a chainId.\n   * @param options.getNetworkClientById - The hook to get the network client instance by its networkClientId.\n   */\n  constructor(options: MultichainSubscriptionManagerOptions) {\n    super();\n    this.#findNetworkClientIdByChainId = options.findNetworkClientIdByChainId;\n    this.#getNetworkClientById = options.getNetworkClientById;\n  }\n\n  notify(\n    { scope, origin, tabId }: SubscriptionKey,\n    { method, params }: SubscriptionNotificationEvent,\n  ) {\n    this.emit('notification', origin, tabId, {\n      method: 'wallet_notify',\n      params: {\n        scope,\n        notification: { method, params },\n      },\n    });\n  }\n\n  #getSubscriptionEntry({\n    scope,\n    origin,\n    tabId,\n  }: SubscriptionKey): SubscriptionEntry | undefined {\n    return this.#subscriptions.find((subscriptionEntry) => {\n      return (\n        subscriptionEntry.scope === scope &&\n        subscriptionEntry.origin === origin &&\n        subscriptionEntry.tabId === tabId\n      );\n    });\n  }\n\n  #removeSubscriptionEntry({ scope, origin, tabId }: SubscriptionEntry) {\n    this.#subscriptions = this.#subscriptions.filter((subscriptionEntry) => {\n      return (\n        subscriptionEntry.scope !== scope ||\n        subscriptionEntry.origin !== origin ||\n        subscriptionEntry.tabId !== tabId\n      );\n    });\n  }\n\n  subscribe(subscriptionKey: SubscriptionKey) {\n    const subscriptionEntry = this.#getSubscriptionEntry(subscriptionKey);\n    if (subscriptionEntry) {\n      return subscriptionEntry.subscriptionManager;\n    }\n\n    const networkClientId = this.#findNetworkClientIdByChainId(\n      toHex(parseCaipChainId(subscriptionKey.scope as CaipChainId).reference),\n    );\n    const networkClient = this.#getNetworkClientById(networkClientId);\n    const subscriptionManager = createSubscriptionManager({\n      blockTracker: networkClient.blockTracker,\n      provider: networkClient.provider,\n    });\n\n    subscriptionManager.events.on(\n      'notification',\n      (message: SubscriptionNotificationEvent) => {\n        this.notify(subscriptionKey, message);\n      },\n    );\n\n    const newSubscriptionManagerEntry = {\n      ...subscriptionKey,\n      subscriptionManager,\n    };\n    subscriptionManager.destroy = subscriptionManager.middleware.destroy;\n    subscriptionManager.middleware.destroy = this.#unsubscribe.bind(\n      this,\n      newSubscriptionManagerEntry,\n    );\n\n    this.#subscriptions.push(newSubscriptionManagerEntry);\n\n    return subscriptionManager;\n  }\n\n  #unsubscribe(subscriptionEntry: SubscriptionEntry) {\n    subscriptionEntry.subscriptionManager.destroy?.();\n\n    this.#removeSubscriptionEntry(subscriptionEntry);\n  }\n\n  unsubscribeByScope(scope: ExternalScopeString) {\n    this.#subscriptions.forEach((subscriptionEntry) => {\n      if (subscriptionEntry.scope === scope) {\n        this.#unsubscribe(subscriptionEntry);\n      }\n    });\n  }\n\n  unsubscribeByScopeAndOrigin(scope: ExternalScopeString, origin: string) {\n    this.#subscriptions.forEach((subscriptionEntry) => {\n      if (\n        subscriptionEntry.scope === scope &&\n        subscriptionEntry.origin === origin\n      ) {\n        this.#unsubscribe(subscriptionEntry);\n      }\n    });\n  }\n\n  unsubscribeByOriginAndTabId(origin: string, tabId?: number) {\n    this.#subscriptions.forEach((subscriptionEntry) => {\n      if (\n        subscriptionEntry.origin === origin &&\n        subscriptionEntry.tabId === tabId\n      ) {\n        this.#unsubscribe(subscriptionEntry);\n      }\n    });\n  }\n}\n"]}

package/dist/middlewares/multichainMethodCallValidatorMiddleware.cjs

@@ -0,0 +1,74 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.multichainMethodCallValidatorMiddleware = void 0;
+const api_specs_1 = require("@metamask/api-specs");
+const json_rpc_engine_1 = require("@metamask/json-rpc-engine");
+const rpc_errors_1 = require("@metamask/rpc-errors");
+const utils_1 = require("@metamask/utils");
+const dereference_document_1 = __importDefault(require("@open-rpc/schema-utils-js/build/dereference-document.js"));
+const parse_open_rpc_document_1 = require("@open-rpc/schema-utils-js/build/parse-open-rpc-document.js");
+const jsonschema_1 = require("jsonschema");
+const transformError = (error, param, got) => {
+    // if there is a path, add it to the message
+    const message = `${param.name}${error.path.length > 0 ? `.${error.path.join('.')}` : ''} ${error.message}`;
+    return rpc_errors_1.rpcErrors.invalidParams({
+        message,
+        data: {
+            param: param.name,
+            path: error.path,
+            schema: error.schema,
+            got,
+        },
+    });
+};
+const v = new jsonschema_1.Validator();
+const dereffedPromise = (0, dereference_document_1.default)(api_specs_1.MultiChainOpenRPCDocument, (0, parse_open_rpc_document_1.makeCustomResolver)({}));
+/**
+ * Helper that utilizes the Multichain method specifications from `@metamask/api-specs`
+ * to validate the params of a Multichain request.
+ *
+ * @param method - The request's method.
+ * @param params - The request's optional JsonRpcParams object.
+ * @returns an array of error objects for each validation error or an empty array if no errors.
+ */
+const multichainMethodCallValidator = async (method, params) => {
+    const dereffed = await dereffedPromise;
+    const methodToCheck = dereffed.methods.find((m) => m.name === method);
+    if (!methodToCheck ||
+        !(0, utils_1.isObject)(methodToCheck) ||
+        !('params' in methodToCheck)) {
+        return [rpc_errors_1.rpcErrors.methodNotFound({ data: { method } })];
+    }
+    const errors = [];
+    for (const param of methodToCheck.params) {
+        if (!(0, utils_1.isObject)(params)) {
+            return [rpc_errors_1.rpcErrors.invalidParams()];
+        }
+        const p = param;
+        const paramToCheck = params[p.name];
+        const result = v.validate(paramToCheck, p.schema, {
+            required: p.required,
+        });
+        if (result.errors) {
+            errors.push(...result.errors.map((e) => {
+                return transformError(e, p, paramToCheck);
+            }));
+        }
+    }
+    return errors;
+};
+/**
+ * Middleware that validates the params of a Multichain method request
+ * using the specifications from `@metamask/api-specs`.
+ */
+exports.multichainMethodCallValidatorMiddleware = (0, json_rpc_engine_1.createAsyncMiddleware)(async (request, _response, next) => {
+    const errors = await multichainMethodCallValidator(request.method, request.params);
+    if (errors.length > 0) {
+        throw rpc_errors_1.rpcErrors.invalidParams({ data: errors });
+    }
+    return await next();
+});
+//# sourceMappingURL=multichainMethodCallValidatorMiddleware.cjs.map

package/dist/middlewares/multichainMethodCallValidatorMiddleware.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"multichainMethodCallValidatorMiddleware.cjs","sourceRoot":"","sources":["../../src/middlewares/multichainMethodCallValidatorMiddleware.ts"],"names":[],"mappings":"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","sourcesContent":["import { MultiChainOpenRPCDocument } from '@metamask/api-specs';\nimport { createAsyncMiddleware } from '@metamask/json-rpc-engine';\nimport { rpcErrors } from '@metamask/rpc-errors';\nimport { isObject } from '@metamask/utils';\nimport type { JsonRpcError, JsonRpcParams } from '@metamask/utils';\nimport type {\n  ContentDescriptorObject,\n  MethodObject,\n  OpenrpcDocument,\n  ReferenceObject,\n} from '@open-rpc/meta-schema';\nimport dereferenceDocument from '@open-rpc/schema-utils-js/build/dereference-document';\nimport { makeCustomResolver } from '@open-rpc/schema-utils-js/build/parse-open-rpc-document';\nimport type { Schema, ValidationError } from 'jsonschema';\nimport { Validator } from 'jsonschema';\n\nconst transformError = (\n  error: ValidationError,\n  param: ContentDescriptorObject,\n  got: unknown,\n) => {\n  // if there is a path, add it to the message\n  const message = `${param.name}${\n    error.path.length > 0 ? `.${error.path.join('.')}` : ''\n  } ${error.message}`;\n\n  return rpcErrors.invalidParams({\n    message,\n    data: {\n      param: param.name,\n      path: error.path,\n      schema: error.schema,\n      got,\n    },\n  });\n};\n\nconst v = new Validator();\n\nconst dereffedPromise = dereferenceDocument(\n  MultiChainOpenRPCDocument as unknown as OpenrpcDocument,\n  makeCustomResolver({}),\n);\n\n/**\n * Helper that utilizes the Multichain method specifications from `@metamask/api-specs`\n * to validate the params of a Multichain request.\n *\n * @param method - The request's method.\n * @param params - The request's optional JsonRpcParams object.\n * @returns an array of error objects for each validation error or an empty array if no errors.\n */\nconst multichainMethodCallValidator = async (\n  method: string,\n  params: JsonRpcParams | undefined,\n) => {\n  const dereffed = await dereffedPromise;\n\n  const methodToCheck = dereffed.methods.find(\n    (m: MethodObject | ReferenceObject) => (m as MethodObject).name === method,\n  ) as MethodObject | undefined;\n\n  if (\n    !methodToCheck ||\n    !isObject(methodToCheck) ||\n    !('params' in methodToCheck)\n  ) {\n    return [rpcErrors.methodNotFound({ data: { method } })] as JsonRpcError[];\n  }\n\n  const errors: JsonRpcError[] = [];\n  for (const param of methodToCheck.params) {\n    if (!isObject(params)) {\n      return [rpcErrors.invalidParams()] as JsonRpcError[];\n    }\n    const p = param as ContentDescriptorObject;\n    const paramToCheck = params[p.name];\n\n    const result = v.validate(paramToCheck, p.schema as unknown as Schema, {\n      required: p.required,\n    });\n    if (result.errors) {\n      errors.push(\n        ...result.errors.map((e) => {\n          return transformError(e, p, paramToCheck) as JsonRpcError;\n        }),\n      );\n    }\n  }\n  return errors;\n};\n\n/**\n * Middleware that validates the params of a Multichain method request\n * using the specifications from `@metamask/api-specs`.\n */\nexport const multichainMethodCallValidatorMiddleware = createAsyncMiddleware(\n  async (request, _response, next) => {\n    const errors = await multichainMethodCallValidator(\n      request.method,\n      request.params,\n    );\n    if (errors.length > 0) {\n      throw rpcErrors.invalidParams<JsonRpcError[]>({ data: errors });\n    }\n    return await next();\n  },\n);\n"]}

package/dist/middlewares/multichainMethodCallValidatorMiddleware.d.cts

@@ -0,0 +1,7 @@
+import type { JsonRpcParams } from "@metamask/utils";
+/**
+ * Middleware that validates the params of a Multichain method request
+ * using the specifications from `@metamask/api-specs`.
+ */
+export declare const multichainMethodCallValidatorMiddleware: import("@metamask/json-rpc-engine").JsonRpcMiddleware<JsonRpcParams, import("@metamask/utils").Json>;
+//# sourceMappingURL=multichainMethodCallValidatorMiddleware.d.cts.map

package/dist/middlewares/multichainMethodCallValidatorMiddleware.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multichainMethodCallValidatorMiddleware.d.cts","sourceRoot":"","sources":["../../src/middlewares/multichainMethodCallValidatorMiddleware.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,aAAa,EAAE,wBAAwB;AAwFnE;;;GAGG;AACH,eAAO,MAAM,uCAAuC,sGAWnD,CAAC"}

package/dist/middlewares/multichainMethodCallValidatorMiddleware.d.mts

@@ -0,0 +1,7 @@
+import type { JsonRpcParams } from "@metamask/utils";
+/**
+ * Middleware that validates the params of a Multichain method request
+ * using the specifications from `@metamask/api-specs`.
+ */
+export declare const multichainMethodCallValidatorMiddleware: import("@metamask/json-rpc-engine").JsonRpcMiddleware<JsonRpcParams, import("@metamask/utils").Json>;
+//# sourceMappingURL=multichainMethodCallValidatorMiddleware.d.mts.map

package/dist/middlewares/multichainMethodCallValidatorMiddleware.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multichainMethodCallValidatorMiddleware.d.mts","sourceRoot":"","sources":["../../src/middlewares/multichainMethodCallValidatorMiddleware.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,aAAa,EAAE,wBAAwB;AAwFnE;;;GAGG;AACH,eAAO,MAAM,uCAAuC,sGAWnD,CAAC"}

package/dist/middlewares/multichainMethodCallValidatorMiddleware.mjs

@@ -0,0 +1,75 @@
+function $importDefault(module) {
+    if (module?.__esModule) {
+        return module.default;
+    }
+    return module;
+}
+import { MultiChainOpenRPCDocument } from "@metamask/api-specs";
+import { createAsyncMiddleware } from "@metamask/json-rpc-engine";
+import { rpcErrors } from "@metamask/rpc-errors";
+import { isObject } from "@metamask/utils";
+import $dereferenceDocument from "@open-rpc/schema-utils-js/build/dereference-document.js";
+const dereferenceDocument = $importDefault($dereferenceDocument);
+import { makeCustomResolver } from "@open-rpc/schema-utils-js/build/parse-open-rpc-document.js";
+import { Validator } from "jsonschema";
+const transformError = (error, param, got) => {
+    // if there is a path, add it to the message
+    const message = `${param.name}${error.path.length > 0 ? `.${error.path.join('.')}` : ''} ${error.message}`;
+    return rpcErrors.invalidParams({
+        message,
+        data: {
+            param: param.name,
+            path: error.path,
+            schema: error.schema,
+            got,
+        },
+    });
+};
+const v = new Validator();
+const dereffedPromise = dereferenceDocument(MultiChainOpenRPCDocument, makeCustomResolver({}));
+/**
+ * Helper that utilizes the Multichain method specifications from `@metamask/api-specs`
+ * to validate the params of a Multichain request.
+ *
+ * @param method - The request's method.
+ * @param params - The request's optional JsonRpcParams object.
+ * @returns an array of error objects for each validation error or an empty array if no errors.
+ */
+const multichainMethodCallValidator = async (method, params) => {
+    const dereffed = await dereffedPromise;
+    const methodToCheck = dereffed.methods.find((m) => m.name === method);
+    if (!methodToCheck ||
+        !isObject(methodToCheck) ||
+        !('params' in methodToCheck)) {
+        return [rpcErrors.methodNotFound({ data: { method } })];
+    }
+    const errors = [];
+    for (const param of methodToCheck.params) {
+        if (!isObject(params)) {
+            return [rpcErrors.invalidParams()];
+        }
+        const p = param;
+        const paramToCheck = params[p.name];
+        const result = v.validate(paramToCheck, p.schema, {
+            required: p.required,
+        });
+        if (result.errors) {
+            errors.push(...result.errors.map((e) => {
+                return transformError(e, p, paramToCheck);
+            }));
+        }
+    }
+    return errors;
+};
+/**
+ * Middleware that validates the params of a Multichain method request
+ * using the specifications from `@metamask/api-specs`.
+ */
+export const multichainMethodCallValidatorMiddleware = createAsyncMiddleware(async (request, _response, next) => {
+    const errors = await multichainMethodCallValidator(request.method, request.params);
+    if (errors.length > 0) {
+        throw rpcErrors.invalidParams({ data: errors });
+    }
+    return await next();
+});
+//# sourceMappingURL=multichainMethodCallValidatorMiddleware.mjs.map

package/dist/middlewares/multichainMethodCallValidatorMiddleware.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"multichainMethodCallValidatorMiddleware.mjs","sourceRoot":"","sources":["../../src/middlewares/multichainMethodCallValidatorMiddleware.ts"],"names":[],"mappings":"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","sourcesContent":["import { MultiChainOpenRPCDocument } from '@metamask/api-specs';\nimport { createAsyncMiddleware } from '@metamask/json-rpc-engine';\nimport { rpcErrors } from '@metamask/rpc-errors';\nimport { isObject } from '@metamask/utils';\nimport type { JsonRpcError, JsonRpcParams } from '@metamask/utils';\nimport type {\n  ContentDescriptorObject,\n  MethodObject,\n  OpenrpcDocument,\n  ReferenceObject,\n} from '@open-rpc/meta-schema';\nimport dereferenceDocument from '@open-rpc/schema-utils-js/build/dereference-document';\nimport { makeCustomResolver } from '@open-rpc/schema-utils-js/build/parse-open-rpc-document';\nimport type { Schema, ValidationError } from 'jsonschema';\nimport { Validator } from 'jsonschema';\n\nconst transformError = (\n  error: ValidationError,\n  param: ContentDescriptorObject,\n  got: unknown,\n) => {\n  // if there is a path, add it to the message\n  const message = `${param.name}${\n    error.path.length > 0 ? `.${error.path.join('.')}` : ''\n  } ${error.message}`;\n\n  return rpcErrors.invalidParams({\n    message,\n    data: {\n      param: param.name,\n      path: error.path,\n      schema: error.schema,\n      got,\n    },\n  });\n};\n\nconst v = new Validator();\n\nconst dereffedPromise = dereferenceDocument(\n  MultiChainOpenRPCDocument as unknown as OpenrpcDocument,\n  makeCustomResolver({}),\n);\n\n/**\n * Helper that utilizes the Multichain method specifications from `@metamask/api-specs`\n * to validate the params of a Multichain request.\n *\n * @param method - The request's method.\n * @param params - The request's optional JsonRpcParams object.\n * @returns an array of error objects for each validation error or an empty array if no errors.\n */\nconst multichainMethodCallValidator = async (\n  method: string,\n  params: JsonRpcParams | undefined,\n) => {\n  const dereffed = await dereffedPromise;\n\n  const methodToCheck = dereffed.methods.find(\n    (m: MethodObject | ReferenceObject) => (m as MethodObject).name === method,\n  ) as MethodObject | undefined;\n\n  if (\n    !methodToCheck ||\n    !isObject(methodToCheck) ||\n    !('params' in methodToCheck)\n  ) {\n    return [rpcErrors.methodNotFound({ data: { method } })] as JsonRpcError[];\n  }\n\n  const errors: JsonRpcError[] = [];\n  for (const param of methodToCheck.params) {\n    if (!isObject(params)) {\n      return [rpcErrors.invalidParams()] as JsonRpcError[];\n    }\n    const p = param as ContentDescriptorObject;\n    const paramToCheck = params[p.name];\n\n    const result = v.validate(paramToCheck, p.schema as unknown as Schema, {\n      required: p.required,\n    });\n    if (result.errors) {\n      errors.push(\n        ...result.errors.map((e) => {\n          return transformError(e, p, paramToCheck) as JsonRpcError;\n        }),\n      );\n    }\n  }\n  return errors;\n};\n\n/**\n * Middleware that validates the params of a Multichain method request\n * using the specifications from `@metamask/api-specs`.\n */\nexport const multichainMethodCallValidatorMiddleware = createAsyncMiddleware(\n  async (request, _response, next) => {\n    const errors = await multichainMethodCallValidator(\n      request.method,\n      request.params,\n    );\n    if (errors.length > 0) {\n      throw rpcErrors.invalidParams<JsonRpcError[]>({ data: errors });\n    }\n    return await next();\n  },\n);\n"]}