@metamask/shield-controller 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0]
+
+### Added
+
+- Initial release of the shield-controller package ([#6137](https://github.com/MetaMask/core/pull/6137)
+
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/shield-controller@0.1.0...HEAD
+[0.1.0]: https://github.com/MetaMask/core/releases/tag/@metamask/shield-controller@0.1.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 MetaMask
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE

package/README.md

@@ -0,0 +1,15 @@
+# `@metamask/shield-controller`
+
+Controller handling shield transaction coverage logic.
+
+## Installation
+
+`yarn add @metamask/shield-controller`
+
+or
+
+`npm install @metamask/shield-controller`
+
+## Contributing
+
+This package is part of a monorepo. Instructions for contributing can be found in the [monorepo README](https://github.com/MetaMask/core#readme).

package/dist/ShieldController.cjs

@@ -0,0 +1,144 @@
+"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 _ShieldController_instances, _ShieldController_backend, _ShieldController_coverageHistoryLimit, _ShieldController_transactionHistoryLimit, _ShieldController_transactionControllerStateChangeHandler, _ShieldController_handleTransactionControllerStateChange, _ShieldController_fetchCoverageResult, _ShieldController_addCoverageResult;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShieldController = exports.getDefaultShieldControllerState = void 0;
+const base_controller_1 = require("@metamask/base-controller");
+const constants_1 = require("./constants.cjs");
+const logger_1 = require("./logger.cjs");
+const log = (0, logger_1.createModuleLogger)(logger_1.projectLogger, 'ShieldController');
+/**
+ * Get the default state for the ShieldController.
+ *
+ * @returns The default state for the ShieldController.
+ */
+function getDefaultShieldControllerState() {
+    return {
+        coverageResults: {},
+        orderedTransactionHistory: [],
+    };
+}
+exports.getDefaultShieldControllerState = getDefaultShieldControllerState;
+/**
+ * Metadata for the ShieldController state, describing how to "anonymize"
+ * the state and which parts should be persisted.
+ */
+const metadata = {
+    coverageResults: {
+        persist: true,
+        anonymous: false,
+    },
+    orderedTransactionHistory: {
+        persist: true,
+        anonymous: false,
+    },
+};
+class ShieldController extends base_controller_1.BaseController {
+    constructor(options) {
+        const { messenger, state, backend, transactionHistoryLimit = 100, coverageHistoryLimit = 10, } = options;
+        super({
+            name: constants_1.controllerName,
+            metadata,
+            messenger,
+            state: {
+                ...getDefaultShieldControllerState(),
+                ...state,
+            },
+        });
+        _ShieldController_instances.add(this);
+        _ShieldController_backend.set(this, void 0);
+        _ShieldController_coverageHistoryLimit.set(this, void 0);
+        _ShieldController_transactionHistoryLimit.set(this, void 0);
+        _ShieldController_transactionControllerStateChangeHandler.set(this, void 0);
+        __classPrivateFieldSet(this, _ShieldController_backend, backend, "f");
+        __classPrivateFieldSet(this, _ShieldController_coverageHistoryLimit, coverageHistoryLimit, "f");
+        __classPrivateFieldSet(this, _ShieldController_transactionHistoryLimit, transactionHistoryLimit, "f");
+        __classPrivateFieldSet(this, _ShieldController_transactionControllerStateChangeHandler, __classPrivateFieldGet(this, _ShieldController_instances, "m", _ShieldController_handleTransactionControllerStateChange).bind(this), "f");
+    }
+    start() {
+        this.messagingSystem.subscribe('TransactionController:stateChange', __classPrivateFieldGet(this, _ShieldController_transactionControllerStateChangeHandler, "f"), (state) => state.transactions);
+    }
+    stop() {
+        this.messagingSystem.unsubscribe('TransactionController:stateChange', __classPrivateFieldGet(this, _ShieldController_transactionControllerStateChangeHandler, "f"));
+    }
+    /**
+     * Checks the coverage of a transaction.
+     *
+     * @param txMeta - The transaction to check coverage for.
+     * @returns The coverage result.
+     */
+    async checkCoverage(txMeta) {
+        // Check coverage
+        const coverageResult = await __classPrivateFieldGet(this, _ShieldController_instances, "m", _ShieldController_fetchCoverageResult).call(this, txMeta);
+        // Publish coverage result
+        this.messagingSystem.publish(`${constants_1.controllerName}:coverageResultReceived`, coverageResult);
+        // Update state
+        __classPrivateFieldGet(this, _ShieldController_instances, "m", _ShieldController_addCoverageResult).call(this, txMeta.id, coverageResult);
+        return coverageResult;
+    }
+}
+exports.ShieldController = ShieldController;
+_ShieldController_backend = new WeakMap(), _ShieldController_coverageHistoryLimit = new WeakMap(), _ShieldController_transactionHistoryLimit = new WeakMap(), _ShieldController_transactionControllerStateChangeHandler = new WeakMap(), _ShieldController_instances = new WeakSet(), _ShieldController_handleTransactionControllerStateChange = function _ShieldController_handleTransactionControllerStateChange(transactions, previousTransactions) {
+    const previousTransactionsById = new Map(previousTransactions?.map((tx) => [tx.id, tx]) ?? []);
+    for (const transaction of transactions) {
+        const previousTransaction = previousTransactionsById.get(transaction.id);
+        // Check coverage if the transaction is new or if the simulation data has
+        // changed.
+        if (!previousTransaction ||
+            // Checking reference equality is sufficient because this object is
+            // replaced if the simulation data has changed.
+            previousTransaction.simulationData !== transaction.simulationData) {
+            this.checkCoverage(transaction).catch(
+            // istanbul ignore next
+            (error) => log('Error checking coverage:', error));
+        }
+    }
+}, _ShieldController_fetchCoverageResult = async function _ShieldController_fetchCoverageResult(txMeta) {
+    return __classPrivateFieldGet(this, _ShieldController_backend, "f").checkCoverage(txMeta);
+}, _ShieldController_addCoverageResult = function _ShieldController_addCoverageResult(txId, coverageResult) {
+    this.update((draft) => {
+        // Fetch coverage result entry.
+        let newEntry = false;
+        let coverageResultEntry = draft.coverageResults[txId];
+        // Create new entry if necessary.
+        if (!coverageResultEntry) {
+            newEntry = true;
+            coverageResultEntry = {
+                results: [],
+            };
+            draft.coverageResults[txId] = coverageResultEntry;
+        }
+        // Trim coverage history if necessary.
+        if (coverageResultEntry.results.length >= __classPrivateFieldGet(this, _ShieldController_coverageHistoryLimit, "f")) {
+            coverageResultEntry.results.pop();
+        }
+        // Add new result.
+        coverageResultEntry.results.unshift(coverageResult);
+        // Add to history if new entry.
+        const { orderedTransactionHistory } = draft;
+        let removedTxId;
+        if (newEntry) {
+            // Trim transaction history if necessary.
+            if (orderedTransactionHistory.length >= __classPrivateFieldGet(this, _ShieldController_transactionHistoryLimit, "f")) {
+                removedTxId = orderedTransactionHistory.pop();
+                // Delete corresponding coverage result entry.
+                if (removedTxId) {
+                    delete draft.coverageResults[removedTxId];
+                }
+            }
+            // Add to history.
+            orderedTransactionHistory.unshift(txId);
+        }
+    });
+};
+//# sourceMappingURL=ShieldController.cjs.map

package/dist/ShieldController.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShieldController.cjs","sourceRoot":"","sources":["../src/ShieldController.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseController } from '@metamask/base-controller';\nimport type {\n  ControllerStateChangeEvent,\n  RestrictedMessenger,\n} from '@metamask/base-controller';\nimport type {\n  TransactionControllerStateChangeEvent,\n  TransactionMeta,\n} from '@metamask/transaction-controller';\n\nimport { controllerName } from './constants';\nimport { projectLogger, createModuleLogger } from './logger';\nimport type { CoverageResult, ShieldBackend } from './types';\n\nconst log = createModuleLogger(projectLogger, 'ShieldController');\n\nexport type CoverageResultRecordEntry = {\n  results: CoverageResult[]; // history of coverage results, latest first\n};\n\nexport type ShieldControllerState = {\n  coverageResults: Record<\n    string, // txId\n    CoverageResultRecordEntry\n  >;\n  orderedTransactionHistory: string[]; // List of txIds ordered by time, latest first\n};\n\n/**\n * Get the default state for the ShieldController.\n *\n * @returns The default state for the ShieldController.\n */\nexport function getDefaultShieldControllerState(): ShieldControllerState {\n  return {\n    coverageResults: {},\n    orderedTransactionHistory: [],\n  };\n}\n\nexport type ShieldControllerCheckCoverageAction = {\n  type: `${typeof controllerName}:checkCoverage`;\n  handler: ShieldController['checkCoverage'];\n};\n\n/**\n * The internal actions available to the ShieldController.\n */\nexport type ShieldControllerActions = ShieldControllerCheckCoverageAction;\n\nexport type ShieldControllerCoverageResultReceivedEvent = {\n  type: `${typeof controllerName}:coverageResultReceived`;\n  payload: [coverageResult: CoverageResult];\n};\n\nexport type ShieldControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  ShieldControllerState\n>;\n\n/**\n * The internal events available to the ShieldController.\n */\nexport type ShieldControllerEvents =\n  | ShieldControllerCoverageResultReceivedEvent\n  | ShieldControllerStateChangeEvent;\n\n/**\n * The external actions available to the ShieldController.\n */\ntype AllowedActions = never;\n\n/**\n * The external events available to the ShieldController.\n */\ntype AllowedEvents = TransactionControllerStateChangeEvent;\n\n/**\n * The messenger of the {@link ShieldController}.\n */\nexport type ShieldControllerMessenger = RestrictedMessenger<\n  typeof controllerName,\n  ShieldControllerActions | AllowedActions,\n  ShieldControllerEvents | AllowedEvents,\n  AllowedActions['type'],\n  AllowedEvents['type']\n>;\n\n/**\n * Metadata for the ShieldController state, describing how to \"anonymize\"\n * the state and which parts should be persisted.\n */\nconst metadata = {\n  coverageResults: {\n    persist: true,\n    anonymous: false,\n  },\n  orderedTransactionHistory: {\n    persist: true,\n    anonymous: false,\n  },\n};\n\nexport type ShieldControllerOptions = {\n  messenger: ShieldControllerMessenger;\n  state?: Partial<ShieldControllerState>;\n  backend: ShieldBackend;\n  transactionHistoryLimit?: number;\n  coverageHistoryLimit?: number;\n};\n\nexport class ShieldController extends BaseController<\n  typeof controllerName,\n  ShieldControllerState,\n  ShieldControllerMessenger\n> {\n  readonly #backend: ShieldBackend;\n\n  readonly #coverageHistoryLimit: number;\n\n  readonly #transactionHistoryLimit: number;\n\n  readonly #transactionControllerStateChangeHandler: (\n    transactions: TransactionMeta[],\n    previousTransactions: TransactionMeta[] | undefined,\n  ) => void;\n\n  constructor(options: ShieldControllerOptions) {\n    const {\n      messenger,\n      state,\n      backend,\n      transactionHistoryLimit = 100,\n      coverageHistoryLimit = 10,\n    } = options;\n    super({\n      name: controllerName,\n      metadata,\n      messenger,\n      state: {\n        ...getDefaultShieldControllerState(),\n        ...state,\n      },\n    });\n\n    this.#backend = backend;\n    this.#coverageHistoryLimit = coverageHistoryLimit;\n    this.#transactionHistoryLimit = transactionHistoryLimit;\n    this.#transactionControllerStateChangeHandler =\n      this.#handleTransactionControllerStateChange.bind(this);\n  }\n\n  start() {\n    this.messagingSystem.subscribe(\n      'TransactionController:stateChange',\n      this.#transactionControllerStateChangeHandler,\n      (state) => state.transactions,\n    );\n  }\n\n  stop() {\n    this.messagingSystem.unsubscribe(\n      'TransactionController:stateChange',\n      this.#transactionControllerStateChangeHandler,\n    );\n  }\n\n  #handleTransactionControllerStateChange(\n    transactions: TransactionMeta[],\n    previousTransactions: TransactionMeta[] | undefined,\n  ) {\n    const previousTransactionsById = new Map<string, TransactionMeta>(\n      previousTransactions?.map((tx) => [tx.id, tx]) ?? [],\n    );\n    for (const transaction of transactions) {\n      const previousTransaction = previousTransactionsById.get(transaction.id);\n\n      // Check coverage if the transaction is new or if the simulation data has\n      // changed.\n      if (\n        !previousTransaction ||\n        // Checking reference equality is sufficient because this object is\n        // replaced if the simulation data has changed.\n        previousTransaction.simulationData !== transaction.simulationData\n      ) {\n        this.checkCoverage(transaction).catch(\n          // istanbul ignore next\n          (error) => log('Error checking coverage:', error),\n        );\n      }\n    }\n  }\n\n  /**\n   * Checks the coverage of a transaction.\n   *\n   * @param txMeta - The transaction to check coverage for.\n   * @returns The coverage result.\n   */\n  async checkCoverage(txMeta: TransactionMeta): Promise<CoverageResult> {\n    // Check coverage\n    const coverageResult = await this.#fetchCoverageResult(txMeta);\n\n    // Publish coverage result\n    this.messagingSystem.publish(\n      `${controllerName}:coverageResultReceived`,\n      coverageResult,\n    );\n\n    // Update state\n    this.#addCoverageResult(txMeta.id, coverageResult);\n\n    return coverageResult;\n  }\n\n  async #fetchCoverageResult(txMeta: TransactionMeta): Promise<CoverageResult> {\n    return this.#backend.checkCoverage(txMeta);\n  }\n\n  #addCoverageResult(txId: string, coverageResult: CoverageResult) {\n    this.update((draft) => {\n      // Fetch coverage result entry.\n      let newEntry = false;\n      let coverageResultEntry = draft.coverageResults[txId];\n\n      // Create new entry if necessary.\n      if (!coverageResultEntry) {\n        newEntry = true;\n        coverageResultEntry = {\n          results: [],\n        };\n        draft.coverageResults[txId] = coverageResultEntry;\n      }\n\n      // Trim coverage history if necessary.\n      if (coverageResultEntry.results.length >= this.#coverageHistoryLimit) {\n        coverageResultEntry.results.pop();\n      }\n\n      // Add new result.\n      coverageResultEntry.results.unshift(coverageResult);\n\n      // Add to history if new entry.\n      const { orderedTransactionHistory } = draft;\n      let removedTxId: string | undefined;\n      if (newEntry) {\n        // Trim transaction history if necessary.\n        if (orderedTransactionHistory.length >= this.#transactionHistoryLimit) {\n          removedTxId = orderedTransactionHistory.pop();\n          // Delete corresponding coverage result entry.\n          if (removedTxId) {\n            delete draft.coverageResults[removedTxId];\n          }\n        }\n        // Add to history.\n        orderedTransactionHistory.unshift(txId);\n      }\n    });\n  }\n}\n"]}

package/dist/ShieldController.d.cts

@@ -0,0 +1,70 @@
+import { BaseController } from "@metamask/base-controller";
+import type { ControllerStateChangeEvent, RestrictedMessenger } from "@metamask/base-controller";
+import type { TransactionControllerStateChangeEvent, TransactionMeta } from "@metamask/transaction-controller";
+import { controllerName } from "./constants.cjs";
+import type { CoverageResult, ShieldBackend } from "./types.cjs";
+export type CoverageResultRecordEntry = {
+    results: CoverageResult[];
+};
+export type ShieldControllerState = {
+    coverageResults: Record<string, // txId
+    CoverageResultRecordEntry>;
+    orderedTransactionHistory: string[];
+};
+/**
+ * Get the default state for the ShieldController.
+ *
+ * @returns The default state for the ShieldController.
+ */
+export declare function getDefaultShieldControllerState(): ShieldControllerState;
+export type ShieldControllerCheckCoverageAction = {
+    type: `${typeof controllerName}:checkCoverage`;
+    handler: ShieldController['checkCoverage'];
+};
+/**
+ * The internal actions available to the ShieldController.
+ */
+export type ShieldControllerActions = ShieldControllerCheckCoverageAction;
+export type ShieldControllerCoverageResultReceivedEvent = {
+    type: `${typeof controllerName}:coverageResultReceived`;
+    payload: [coverageResult: CoverageResult];
+};
+export type ShieldControllerStateChangeEvent = ControllerStateChangeEvent<typeof controllerName, ShieldControllerState>;
+/**
+ * The internal events available to the ShieldController.
+ */
+export type ShieldControllerEvents = ShieldControllerCoverageResultReceivedEvent | ShieldControllerStateChangeEvent;
+/**
+ * The external actions available to the ShieldController.
+ */
+type AllowedActions = never;
+/**
+ * The external events available to the ShieldController.
+ */
+type AllowedEvents = TransactionControllerStateChangeEvent;
+/**
+ * The messenger of the {@link ShieldController}.
+ */
+export type ShieldControllerMessenger = RestrictedMessenger<typeof controllerName, ShieldControllerActions | AllowedActions, ShieldControllerEvents | AllowedEvents, AllowedActions['type'], AllowedEvents['type']>;
+export type ShieldControllerOptions = {
+    messenger: ShieldControllerMessenger;
+    state?: Partial<ShieldControllerState>;
+    backend: ShieldBackend;
+    transactionHistoryLimit?: number;
+    coverageHistoryLimit?: number;
+};
+export declare class ShieldController extends BaseController<typeof controllerName, ShieldControllerState, ShieldControllerMessenger> {
+    #private;
+    constructor(options: ShieldControllerOptions);
+    start(): void;
+    stop(): void;
+    /**
+     * Checks the coverage of a transaction.
+     *
+     * @param txMeta - The transaction to check coverage for.
+     * @returns The coverage result.
+     */
+    checkCoverage(txMeta: TransactionMeta): Promise<CoverageResult>;
+}
+export {};
+//# sourceMappingURL=ShieldController.d.cts.map

package/dist/ShieldController.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShieldController.d.cts","sourceRoot":"","sources":["../src/ShieldController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EACV,0BAA0B,EAC1B,mBAAmB,EACpB,kCAAkC;AACnC,OAAO,KAAK,EACV,qCAAqC,EACrC,eAAe,EAChB,yCAAyC;AAE1C,OAAO,EAAE,cAAc,EAAE,wBAAoB;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,oBAAgB;AAI7D,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,eAAe,EAAE,MAAM,CACrB,MAAM,EAAE,OAAO;IACf,yBAAyB,CAC1B,CAAC;IACF,yBAAyB,EAAE,MAAM,EAAE,CAAC;CACrC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,+BAA+B,IAAI,qBAAqB,CAKvE;AAED,MAAM,MAAM,mCAAmC,GAAG;IAChD,IAAI,EAAE,GAAG,OAAO,cAAc,gBAAgB,CAAC;IAC/C,OAAO,EAAE,gBAAgB,CAAC,eAAe,CAAC,CAAC;CAC5C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,mCAAmC,CAAC;AAE1E,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,GAAG,OAAO,cAAc,yBAAyB,CAAC;IACxD,OAAO,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG,0BAA0B,CACvE,OAAO,cAAc,EACrB,qBAAqB,CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAC9B,2CAA2C,GAC3C,gCAAgC,CAAC;AAErC;;GAEG;AACH,KAAK,cAAc,GAAG,KAAK,CAAC;AAE5B;;GAEG;AACH,KAAK,aAAa,GAAG,qCAAqC,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,CACzD,OAAO,cAAc,EACrB,uBAAuB,GAAG,cAAc,EACxC,sBAAsB,GAAG,aAAa,EACtC,cAAc,CAAC,MAAM,CAAC,EACtB,aAAa,CAAC,MAAM,CAAC,CACtB,CAAC;AAiBF,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,yBAAyB,CAAC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACvC,OAAO,EAAE,aAAa,CAAC;IACvB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,qBAAa,gBAAiB,SAAQ,cAAc,CAClD,OAAO,cAAc,EACrB,qBAAqB,EACrB,yBAAyB,CAC1B;;gBAYa,OAAO,EAAE,uBAAuB;IAyB5C,KAAK;IAQL,IAAI;IAiCJ;;;;;OAKG;IACG,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CA4DtE"}

package/dist/ShieldController.d.mts

@@ -0,0 +1,70 @@
+import { BaseController } from "@metamask/base-controller";
+import type { ControllerStateChangeEvent, RestrictedMessenger } from "@metamask/base-controller";
+import type { TransactionControllerStateChangeEvent, TransactionMeta } from "@metamask/transaction-controller";
+import { controllerName } from "./constants.mjs";
+import type { CoverageResult, ShieldBackend } from "./types.mjs";
+export type CoverageResultRecordEntry = {
+    results: CoverageResult[];
+};
+export type ShieldControllerState = {
+    coverageResults: Record<string, // txId
+    CoverageResultRecordEntry>;
+    orderedTransactionHistory: string[];
+};
+/**
+ * Get the default state for the ShieldController.
+ *
+ * @returns The default state for the ShieldController.
+ */
+export declare function getDefaultShieldControllerState(): ShieldControllerState;
+export type ShieldControllerCheckCoverageAction = {
+    type: `${typeof controllerName}:checkCoverage`;
+    handler: ShieldController['checkCoverage'];
+};
+/**
+ * The internal actions available to the ShieldController.
+ */
+export type ShieldControllerActions = ShieldControllerCheckCoverageAction;
+export type ShieldControllerCoverageResultReceivedEvent = {
+    type: `${typeof controllerName}:coverageResultReceived`;
+    payload: [coverageResult: CoverageResult];
+};
+export type ShieldControllerStateChangeEvent = ControllerStateChangeEvent<typeof controllerName, ShieldControllerState>;
+/**
+ * The internal events available to the ShieldController.
+ */
+export type ShieldControllerEvents = ShieldControllerCoverageResultReceivedEvent | ShieldControllerStateChangeEvent;
+/**
+ * The external actions available to the ShieldController.
+ */
+type AllowedActions = never;
+/**
+ * The external events available to the ShieldController.
+ */
+type AllowedEvents = TransactionControllerStateChangeEvent;
+/**
+ * The messenger of the {@link ShieldController}.
+ */
+export type ShieldControllerMessenger = RestrictedMessenger<typeof controllerName, ShieldControllerActions | AllowedActions, ShieldControllerEvents | AllowedEvents, AllowedActions['type'], AllowedEvents['type']>;
+export type ShieldControllerOptions = {
+    messenger: ShieldControllerMessenger;
+    state?: Partial<ShieldControllerState>;
+    backend: ShieldBackend;
+    transactionHistoryLimit?: number;
+    coverageHistoryLimit?: number;
+};
+export declare class ShieldController extends BaseController<typeof controllerName, ShieldControllerState, ShieldControllerMessenger> {
+    #private;
+    constructor(options: ShieldControllerOptions);
+    start(): void;
+    stop(): void;
+    /**
+     * Checks the coverage of a transaction.
+     *
+     * @param txMeta - The transaction to check coverage for.
+     * @returns The coverage result.
+     */
+    checkCoverage(txMeta: TransactionMeta): Promise<CoverageResult>;
+}
+export {};
+//# sourceMappingURL=ShieldController.d.mts.map

package/dist/ShieldController.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShieldController.d.mts","sourceRoot":"","sources":["../src/ShieldController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EACV,0BAA0B,EAC1B,mBAAmB,EACpB,kCAAkC;AACnC,OAAO,KAAK,EACV,qCAAqC,EACrC,eAAe,EAChB,yCAAyC;AAE1C,OAAO,EAAE,cAAc,EAAE,wBAAoB;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,oBAAgB;AAI7D,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,eAAe,EAAE,MAAM,CACrB,MAAM,EAAE,OAAO;IACf,yBAAyB,CAC1B,CAAC;IACF,yBAAyB,EAAE,MAAM,EAAE,CAAC;CACrC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,+BAA+B,IAAI,qBAAqB,CAKvE;AAED,MAAM,MAAM,mCAAmC,GAAG;IAChD,IAAI,EAAE,GAAG,OAAO,cAAc,gBAAgB,CAAC;IAC/C,OAAO,EAAE,gBAAgB,CAAC,eAAe,CAAC,CAAC;CAC5C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,mCAAmC,CAAC;AAE1E,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,GAAG,OAAO,cAAc,yBAAyB,CAAC;IACxD,OAAO,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG,0BAA0B,CACvE,OAAO,cAAc,EACrB,qBAAqB,CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAC9B,2CAA2C,GAC3C,gCAAgC,CAAC;AAErC;;GAEG;AACH,KAAK,cAAc,GAAG,KAAK,CAAC;AAE5B;;GAEG;AACH,KAAK,aAAa,GAAG,qCAAqC,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,CACzD,OAAO,cAAc,EACrB,uBAAuB,GAAG,cAAc,EACxC,sBAAsB,GAAG,aAAa,EACtC,cAAc,CAAC,MAAM,CAAC,EACtB,aAAa,CAAC,MAAM,CAAC,CACtB,CAAC;AAiBF,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,yBAAyB,CAAC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACvC,OAAO,EAAE,aAAa,CAAC;IACvB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,qBAAa,gBAAiB,SAAQ,cAAc,CAClD,OAAO,cAAc,EACrB,qBAAqB,EACrB,yBAAyB,CAC1B;;gBAYa,OAAO,EAAE,uBAAuB;IAyB5C,KAAK;IAQL,IAAI;IAiCJ;;;;;OAKG;IACG,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CA4DtE"}

package/dist/ShieldController.mjs

@@ -0,0 +1,139 @@
+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 _ShieldController_instances, _ShieldController_backend, _ShieldController_coverageHistoryLimit, _ShieldController_transactionHistoryLimit, _ShieldController_transactionControllerStateChangeHandler, _ShieldController_handleTransactionControllerStateChange, _ShieldController_fetchCoverageResult, _ShieldController_addCoverageResult;
+import { BaseController } from "@metamask/base-controller";
+import { controllerName } from "./constants.mjs";
+import { projectLogger, createModuleLogger } from "./logger.mjs";
+const log = createModuleLogger(projectLogger, 'ShieldController');
+/**
+ * Get the default state for the ShieldController.
+ *
+ * @returns The default state for the ShieldController.
+ */
+export function getDefaultShieldControllerState() {
+    return {
+        coverageResults: {},
+        orderedTransactionHistory: [],
+    };
+}
+/**
+ * Metadata for the ShieldController state, describing how to "anonymize"
+ * the state and which parts should be persisted.
+ */
+const metadata = {
+    coverageResults: {
+        persist: true,
+        anonymous: false,
+    },
+    orderedTransactionHistory: {
+        persist: true,
+        anonymous: false,
+    },
+};
+export class ShieldController extends BaseController {
+    constructor(options) {
+        const { messenger, state, backend, transactionHistoryLimit = 100, coverageHistoryLimit = 10, } = options;
+        super({
+            name: controllerName,
+            metadata,
+            messenger,
+            state: {
+                ...getDefaultShieldControllerState(),
+                ...state,
+            },
+        });
+        _ShieldController_instances.add(this);
+        _ShieldController_backend.set(this, void 0);
+        _ShieldController_coverageHistoryLimit.set(this, void 0);
+        _ShieldController_transactionHistoryLimit.set(this, void 0);
+        _ShieldController_transactionControllerStateChangeHandler.set(this, void 0);
+        __classPrivateFieldSet(this, _ShieldController_backend, backend, "f");
+        __classPrivateFieldSet(this, _ShieldController_coverageHistoryLimit, coverageHistoryLimit, "f");
+        __classPrivateFieldSet(this, _ShieldController_transactionHistoryLimit, transactionHistoryLimit, "f");
+        __classPrivateFieldSet(this, _ShieldController_transactionControllerStateChangeHandler, __classPrivateFieldGet(this, _ShieldController_instances, "m", _ShieldController_handleTransactionControllerStateChange).bind(this), "f");
+    }
+    start() {
+        this.messagingSystem.subscribe('TransactionController:stateChange', __classPrivateFieldGet(this, _ShieldController_transactionControllerStateChangeHandler, "f"), (state) => state.transactions);
+    }
+    stop() {
+        this.messagingSystem.unsubscribe('TransactionController:stateChange', __classPrivateFieldGet(this, _ShieldController_transactionControllerStateChangeHandler, "f"));
+    }
+    /**
+     * Checks the coverage of a transaction.
+     *
+     * @param txMeta - The transaction to check coverage for.
+     * @returns The coverage result.
+     */
+    async checkCoverage(txMeta) {
+        // Check coverage
+        const coverageResult = await __classPrivateFieldGet(this, _ShieldController_instances, "m", _ShieldController_fetchCoverageResult).call(this, txMeta);
+        // Publish coverage result
+        this.messagingSystem.publish(`${controllerName}:coverageResultReceived`, coverageResult);
+        // Update state
+        __classPrivateFieldGet(this, _ShieldController_instances, "m", _ShieldController_addCoverageResult).call(this, txMeta.id, coverageResult);
+        return coverageResult;
+    }
+}
+_ShieldController_backend = new WeakMap(), _ShieldController_coverageHistoryLimit = new WeakMap(), _ShieldController_transactionHistoryLimit = new WeakMap(), _ShieldController_transactionControllerStateChangeHandler = new WeakMap(), _ShieldController_instances = new WeakSet(), _ShieldController_handleTransactionControllerStateChange = function _ShieldController_handleTransactionControllerStateChange(transactions, previousTransactions) {
+    const previousTransactionsById = new Map(previousTransactions?.map((tx) => [tx.id, tx]) ?? []);
+    for (const transaction of transactions) {
+        const previousTransaction = previousTransactionsById.get(transaction.id);
+        // Check coverage if the transaction is new or if the simulation data has
+        // changed.
+        if (!previousTransaction ||
+            // Checking reference equality is sufficient because this object is
+            // replaced if the simulation data has changed.
+            previousTransaction.simulationData !== transaction.simulationData) {
+            this.checkCoverage(transaction).catch(
+            // istanbul ignore next
+            (error) => log('Error checking coverage:', error));
+        }
+    }
+}, _ShieldController_fetchCoverageResult = async function _ShieldController_fetchCoverageResult(txMeta) {
+    return __classPrivateFieldGet(this, _ShieldController_backend, "f").checkCoverage(txMeta);
+}, _ShieldController_addCoverageResult = function _ShieldController_addCoverageResult(txId, coverageResult) {
+    this.update((draft) => {
+        // Fetch coverage result entry.
+        let newEntry = false;
+        let coverageResultEntry = draft.coverageResults[txId];
+        // Create new entry if necessary.
+        if (!coverageResultEntry) {
+            newEntry = true;
+            coverageResultEntry = {
+                results: [],
+            };
+            draft.coverageResults[txId] = coverageResultEntry;
+        }
+        // Trim coverage history if necessary.
+        if (coverageResultEntry.results.length >= __classPrivateFieldGet(this, _ShieldController_coverageHistoryLimit, "f")) {
+            coverageResultEntry.results.pop();
+        }
+        // Add new result.
+        coverageResultEntry.results.unshift(coverageResult);
+        // Add to history if new entry.
+        const { orderedTransactionHistory } = draft;
+        let removedTxId;
+        if (newEntry) {
+            // Trim transaction history if necessary.
+            if (orderedTransactionHistory.length >= __classPrivateFieldGet(this, _ShieldController_transactionHistoryLimit, "f")) {
+                removedTxId = orderedTransactionHistory.pop();
+                // Delete corresponding coverage result entry.
+                if (removedTxId) {
+                    delete draft.coverageResults[removedTxId];
+                }
+            }
+            // Add to history.
+            orderedTransactionHistory.unshift(txId);
+        }
+    });
+};
+//# sourceMappingURL=ShieldController.mjs.map

package/dist/ShieldController.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShieldController.mjs","sourceRoot":"","sources":["../src/ShieldController.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseController } from '@metamask/base-controller';\nimport type {\n  ControllerStateChangeEvent,\n  RestrictedMessenger,\n} from '@metamask/base-controller';\nimport type {\n  TransactionControllerStateChangeEvent,\n  TransactionMeta,\n} from '@metamask/transaction-controller';\n\nimport { controllerName } from './constants';\nimport { projectLogger, createModuleLogger } from './logger';\nimport type { CoverageResult, ShieldBackend } from './types';\n\nconst log = createModuleLogger(projectLogger, 'ShieldController');\n\nexport type CoverageResultRecordEntry = {\n  results: CoverageResult[]; // history of coverage results, latest first\n};\n\nexport type ShieldControllerState = {\n  coverageResults: Record<\n    string, // txId\n    CoverageResultRecordEntry\n  >;\n  orderedTransactionHistory: string[]; // List of txIds ordered by time, latest first\n};\n\n/**\n * Get the default state for the ShieldController.\n *\n * @returns The default state for the ShieldController.\n */\nexport function getDefaultShieldControllerState(): ShieldControllerState {\n  return {\n    coverageResults: {},\n    orderedTransactionHistory: [],\n  };\n}\n\nexport type ShieldControllerCheckCoverageAction = {\n  type: `${typeof controllerName}:checkCoverage`;\n  handler: ShieldController['checkCoverage'];\n};\n\n/**\n * The internal actions available to the ShieldController.\n */\nexport type ShieldControllerActions = ShieldControllerCheckCoverageAction;\n\nexport type ShieldControllerCoverageResultReceivedEvent = {\n  type: `${typeof controllerName}:coverageResultReceived`;\n  payload: [coverageResult: CoverageResult];\n};\n\nexport type ShieldControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  ShieldControllerState\n>;\n\n/**\n * The internal events available to the ShieldController.\n */\nexport type ShieldControllerEvents =\n  | ShieldControllerCoverageResultReceivedEvent\n  | ShieldControllerStateChangeEvent;\n\n/**\n * The external actions available to the ShieldController.\n */\ntype AllowedActions = never;\n\n/**\n * The external events available to the ShieldController.\n */\ntype AllowedEvents = TransactionControllerStateChangeEvent;\n\n/**\n * The messenger of the {@link ShieldController}.\n */\nexport type ShieldControllerMessenger = RestrictedMessenger<\n  typeof controllerName,\n  ShieldControllerActions | AllowedActions,\n  ShieldControllerEvents | AllowedEvents,\n  AllowedActions['type'],\n  AllowedEvents['type']\n>;\n\n/**\n * Metadata for the ShieldController state, describing how to \"anonymize\"\n * the state and which parts should be persisted.\n */\nconst metadata = {\n  coverageResults: {\n    persist: true,\n    anonymous: false,\n  },\n  orderedTransactionHistory: {\n    persist: true,\n    anonymous: false,\n  },\n};\n\nexport type ShieldControllerOptions = {\n  messenger: ShieldControllerMessenger;\n  state?: Partial<ShieldControllerState>;\n  backend: ShieldBackend;\n  transactionHistoryLimit?: number;\n  coverageHistoryLimit?: number;\n};\n\nexport class ShieldController extends BaseController<\n  typeof controllerName,\n  ShieldControllerState,\n  ShieldControllerMessenger\n> {\n  readonly #backend: ShieldBackend;\n\n  readonly #coverageHistoryLimit: number;\n\n  readonly #transactionHistoryLimit: number;\n\n  readonly #transactionControllerStateChangeHandler: (\n    transactions: TransactionMeta[],\n    previousTransactions: TransactionMeta[] | undefined,\n  ) => void;\n\n  constructor(options: ShieldControllerOptions) {\n    const {\n      messenger,\n      state,\n      backend,\n      transactionHistoryLimit = 100,\n      coverageHistoryLimit = 10,\n    } = options;\n    super({\n      name: controllerName,\n      metadata,\n      messenger,\n      state: {\n        ...getDefaultShieldControllerState(),\n        ...state,\n      },\n    });\n\n    this.#backend = backend;\n    this.#coverageHistoryLimit = coverageHistoryLimit;\n    this.#transactionHistoryLimit = transactionHistoryLimit;\n    this.#transactionControllerStateChangeHandler =\n      this.#handleTransactionControllerStateChange.bind(this);\n  }\n\n  start() {\n    this.messagingSystem.subscribe(\n      'TransactionController:stateChange',\n      this.#transactionControllerStateChangeHandler,\n      (state) => state.transactions,\n    );\n  }\n\n  stop() {\n    this.messagingSystem.unsubscribe(\n      'TransactionController:stateChange',\n      this.#transactionControllerStateChangeHandler,\n    );\n  }\n\n  #handleTransactionControllerStateChange(\n    transactions: TransactionMeta[],\n    previousTransactions: TransactionMeta[] | undefined,\n  ) {\n    const previousTransactionsById = new Map<string, TransactionMeta>(\n      previousTransactions?.map((tx) => [tx.id, tx]) ?? [],\n    );\n    for (const transaction of transactions) {\n      const previousTransaction = previousTransactionsById.get(transaction.id);\n\n      // Check coverage if the transaction is new or if the simulation data has\n      // changed.\n      if (\n        !previousTransaction ||\n        // Checking reference equality is sufficient because this object is\n        // replaced if the simulation data has changed.\n        previousTransaction.simulationData !== transaction.simulationData\n      ) {\n        this.checkCoverage(transaction).catch(\n          // istanbul ignore next\n          (error) => log('Error checking coverage:', error),\n        );\n      }\n    }\n  }\n\n  /**\n   * Checks the coverage of a transaction.\n   *\n   * @param txMeta - The transaction to check coverage for.\n   * @returns The coverage result.\n   */\n  async checkCoverage(txMeta: TransactionMeta): Promise<CoverageResult> {\n    // Check coverage\n    const coverageResult = await this.#fetchCoverageResult(txMeta);\n\n    // Publish coverage result\n    this.messagingSystem.publish(\n      `${controllerName}:coverageResultReceived`,\n      coverageResult,\n    );\n\n    // Update state\n    this.#addCoverageResult(txMeta.id, coverageResult);\n\n    return coverageResult;\n  }\n\n  async #fetchCoverageResult(txMeta: TransactionMeta): Promise<CoverageResult> {\n    return this.#backend.checkCoverage(txMeta);\n  }\n\n  #addCoverageResult(txId: string, coverageResult: CoverageResult) {\n    this.update((draft) => {\n      // Fetch coverage result entry.\n      let newEntry = false;\n      let coverageResultEntry = draft.coverageResults[txId];\n\n      // Create new entry if necessary.\n      if (!coverageResultEntry) {\n        newEntry = true;\n        coverageResultEntry = {\n          results: [],\n        };\n        draft.coverageResults[txId] = coverageResultEntry;\n      }\n\n      // Trim coverage history if necessary.\n      if (coverageResultEntry.results.length >= this.#coverageHistoryLimit) {\n        coverageResultEntry.results.pop();\n      }\n\n      // Add new result.\n      coverageResultEntry.results.unshift(coverageResult);\n\n      // Add to history if new entry.\n      const { orderedTransactionHistory } = draft;\n      let removedTxId: string | undefined;\n      if (newEntry) {\n        // Trim transaction history if necessary.\n        if (orderedTransactionHistory.length >= this.#transactionHistoryLimit) {\n          removedTxId = orderedTransactionHistory.pop();\n          // Delete corresponding coverage result entry.\n          if (removedTxId) {\n            delete draft.coverageResults[removedTxId];\n          }\n        }\n        // Add to history.\n        orderedTransactionHistory.unshift(txId);\n      }\n    });\n  }\n}\n"]}

package/dist/backend.cjs

@@ -0,0 +1,110 @@
+"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 _ShieldRemoteBackend_instances, _ShieldRemoteBackend_getAccessToken, _ShieldRemoteBackend_getCoverageResultTimeout, _ShieldRemoteBackend_getCoverageResultPollInterval, _ShieldRemoteBackend_baseUrl, _ShieldRemoteBackend_fetch, _ShieldRemoteBackend_initCoverageCheck, _ShieldRemoteBackend_getCoverageResult, _ShieldRemoteBackend_createHeaders;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShieldRemoteBackend = exports.BASE_URL = void 0;
+exports.BASE_URL = 'https://rule-engine.metamask.io';
+class ShieldRemoteBackend {
+    constructor({ getAccessToken, getCoverageResultTimeout = 5000, // milliseconds
+    getCoverageResultPollInterval = 1000, // milliseconds
+    baseUrl = exports.BASE_URL, fetch: fetchFn, }) {
+        _ShieldRemoteBackend_instances.add(this);
+        _ShieldRemoteBackend_getAccessToken.set(this, void 0);
+        _ShieldRemoteBackend_getCoverageResultTimeout.set(this, void 0);
+        _ShieldRemoteBackend_getCoverageResultPollInterval.set(this, void 0);
+        _ShieldRemoteBackend_baseUrl.set(this, void 0);
+        _ShieldRemoteBackend_fetch.set(this, void 0);
+        this.checkCoverage = async (txMeta) => {
+            const reqBody = {
+                txParams: [
+                    {
+                        from: txMeta.txParams.from,
+                        to: txMeta.txParams.to,
+                        value: txMeta.txParams.value,
+                        data: txMeta.txParams.data,
+                        nonce: txMeta.txParams.nonce,
+                    },
+                ],
+                chainId: txMeta.chainId,
+                origin: txMeta.origin,
+            };
+            const { coverageId } = await __classPrivateFieldGet(this, _ShieldRemoteBackend_instances, "m", _ShieldRemoteBackend_initCoverageCheck).call(this, reqBody);
+            return __classPrivateFieldGet(this, _ShieldRemoteBackend_instances, "m", _ShieldRemoteBackend_getCoverageResult).call(this, coverageId);
+        };
+        __classPrivateFieldSet(this, _ShieldRemoteBackend_getAccessToken, getAccessToken, "f");
+        __classPrivateFieldSet(this, _ShieldRemoteBackend_getCoverageResultTimeout, getCoverageResultTimeout, "f");
+        __classPrivateFieldSet(this, _ShieldRemoteBackend_getCoverageResultPollInterval, getCoverageResultPollInterval, "f");
+        __classPrivateFieldSet(this, _ShieldRemoteBackend_baseUrl, baseUrl, "f");
+        __classPrivateFieldSet(this, _ShieldRemoteBackend_fetch, fetchFn, "f");
+    }
+}
+exports.ShieldRemoteBackend = ShieldRemoteBackend;
+_ShieldRemoteBackend_getAccessToken = new WeakMap(), _ShieldRemoteBackend_getCoverageResultTimeout = new WeakMap(), _ShieldRemoteBackend_getCoverageResultPollInterval = new WeakMap(), _ShieldRemoteBackend_baseUrl = new WeakMap(), _ShieldRemoteBackend_fetch = new WeakMap(), _ShieldRemoteBackend_instances = new WeakSet(), _ShieldRemoteBackend_initCoverageCheck = async function _ShieldRemoteBackend_initCoverageCheck(reqBody) {
+    const res = await __classPrivateFieldGet(this, _ShieldRemoteBackend_fetch, "f").call(this, `${__classPrivateFieldGet(this, _ShieldRemoteBackend_baseUrl, "f")}/api/v1/coverage/init`, {
+        method: 'POST',
+        headers: await __classPrivateFieldGet(this, _ShieldRemoteBackend_instances, "m", _ShieldRemoteBackend_createHeaders).call(this),
+        body: JSON.stringify(reqBody),
+    });
+    if (res.status !== 200) {
+        throw new Error(`Failed to init coverage check: ${res.status}`);
+    }
+    return (await res.json());
+}, _ShieldRemoteBackend_getCoverageResult = async function _ShieldRemoteBackend_getCoverageResult(coverageId, timeout = __classPrivateFieldGet(this, _ShieldRemoteBackend_getCoverageResultTimeout, "f"), pollInterval = __classPrivateFieldGet(this, _ShieldRemoteBackend_getCoverageResultPollInterval, "f")) {
+    const reqBody = {
+        coverageId,
+    };
+    const headers = await __classPrivateFieldGet(this, _ShieldRemoteBackend_instances, "m", _ShieldRemoteBackend_createHeaders).call(this);
+    return await new Promise((resolve, reject) => {
+        let timeoutReached = false;
+        setTimeout(() => {
+            timeoutReached = true;
+            reject(new Error('Timeout waiting for coverage result'));
+        }, timeout);
+        const poll = async () => {
+            // The timeoutReached variable is modified in the timeout callback.
+            // eslint-disable-next-line no-unmodified-loop-condition
+            while (!timeoutReached) {
+                const startTime = Date.now();
+                const res = await __classPrivateFieldGet(this, _ShieldRemoteBackend_fetch, "f").call(this, `${__classPrivateFieldGet(this, _ShieldRemoteBackend_baseUrl, "f")}/api/v1/coverage/result`, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(reqBody),
+                });
+                if (res.status === 200) {
+                    return (await res.json());
+                }
+                await sleep(pollInterval - (Date.now() - startTime));
+            }
+            // The following line will not have an effect as the upper level promise
+            // will already be rejected by now.
+            throw new Error('unexpected error');
+        };
+        poll().then(resolve).catch(reject);
+    });
+}, _ShieldRemoteBackend_createHeaders = async function _ShieldRemoteBackend_createHeaders() {
+    const accessToken = await __classPrivateFieldGet(this, _ShieldRemoteBackend_getAccessToken, "f").call(this);
+    return {
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${accessToken}`,
+    };
+};
+/**
+ * Sleep for a specified amount of time.
+ *
+ * @param ms - The number of milliseconds to sleep.
+ * @returns A promise that resolves after the specified amount of time.
+ */
+async function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=backend.cjs.map

package/dist/backend.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.cjs","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TransactionMeta } from '@metamask/transaction-controller';\n\nimport type { CoverageResult, CoverageStatus, ShieldBackend } from './types';\n\nexport const BASE_URL = 'https://rule-engine.metamask.io';\n\nexport type InitCoverageCheckRequest = {\n  txParams: [\n    {\n      from: string;\n      to?: string;\n      value?: string;\n      data?: string;\n      nonce?: string;\n    },\n  ];\n  chainId: string;\n  origin?: string;\n};\n\nexport type InitCoverageCheckResponse = {\n  coverageId: string;\n};\n\nexport type GetCoverageResultRequest = {\n  coverageId: string;\n};\n\nexport type GetCoverageResultResponse = {\n  status: CoverageStatus;\n};\n\nexport class ShieldRemoteBackend implements ShieldBackend {\n  readonly #getAccessToken: () => Promise<string>;\n\n  readonly #getCoverageResultTimeout: number;\n\n  readonly #getCoverageResultPollInterval: number;\n\n  readonly #baseUrl: string;\n\n  readonly #fetch: typeof globalThis.fetch;\n\n  constructor({\n    getAccessToken,\n    getCoverageResultTimeout = 5000, // milliseconds\n    getCoverageResultPollInterval = 1000, // milliseconds\n    baseUrl = BASE_URL,\n    fetch: fetchFn,\n  }: {\n    getAccessToken: () => Promise<string>;\n    getCoverageResultTimeout?: number;\n    getCoverageResultPollInterval?: number;\n    baseUrl?: string;\n    fetch: typeof globalThis.fetch;\n  }) {\n    this.#getAccessToken = getAccessToken;\n    this.#getCoverageResultTimeout = getCoverageResultTimeout;\n    this.#getCoverageResultPollInterval = getCoverageResultPollInterval;\n    this.#baseUrl = baseUrl;\n    this.#fetch = fetchFn;\n  }\n\n  checkCoverage: (txMeta: TransactionMeta) => Promise<CoverageResult> = async (\n    txMeta,\n  ) => {\n    const reqBody: InitCoverageCheckRequest = {\n      txParams: [\n        {\n          from: txMeta.txParams.from,\n          to: txMeta.txParams.to,\n          value: txMeta.txParams.value,\n          data: txMeta.txParams.data,\n          nonce: txMeta.txParams.nonce,\n        },\n      ],\n      chainId: txMeta.chainId,\n      origin: txMeta.origin,\n    };\n\n    const { coverageId } = await this.#initCoverageCheck(reqBody);\n\n    return this.#getCoverageResult(coverageId);\n  };\n\n  async #initCoverageCheck(\n    reqBody: InitCoverageCheckRequest,\n  ): Promise<InitCoverageCheckResponse> {\n    const res = await this.#fetch(`${this.#baseUrl}/api/v1/coverage/init`, {\n      method: 'POST',\n      headers: await this.#createHeaders(),\n      body: JSON.stringify(reqBody),\n    });\n    if (res.status !== 200) {\n      throw new Error(`Failed to init coverage check: ${res.status}`);\n    }\n    return (await res.json()) as InitCoverageCheckResponse;\n  }\n\n  async #getCoverageResult(\n    coverageId: string,\n    timeout: number = this.#getCoverageResultTimeout,\n    pollInterval: number = this.#getCoverageResultPollInterval,\n  ): Promise<GetCoverageResultResponse> {\n    const reqBody: GetCoverageResultRequest = {\n      coverageId,\n    };\n\n    const headers = await this.#createHeaders();\n    return await new Promise((resolve, reject) => {\n      let timeoutReached = false;\n      setTimeout(() => {\n        timeoutReached = true;\n        reject(new Error('Timeout waiting for coverage result'));\n      }, timeout);\n\n      const poll = async (): Promise<GetCoverageResultResponse> => {\n        // The timeoutReached variable is modified in the timeout callback.\n        // eslint-disable-next-line no-unmodified-loop-condition\n        while (!timeoutReached) {\n          const startTime = Date.now();\n          const res = await this.#fetch(\n            `${this.#baseUrl}/api/v1/coverage/result`,\n            {\n              method: 'POST',\n              headers,\n              body: JSON.stringify(reqBody),\n            },\n          );\n          if (res.status === 200) {\n            return (await res.json()) as GetCoverageResultResponse;\n          }\n          await sleep(pollInterval - (Date.now() - startTime));\n        }\n        // The following line will not have an effect as the upper level promise\n        // will already be rejected by now.\n        throw new Error('unexpected error');\n      };\n\n      poll().then(resolve).catch(reject);\n    });\n  }\n\n  async #createHeaders() {\n    const accessToken = await this.#getAccessToken();\n    return {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${accessToken}`,\n    };\n  }\n}\n\n/**\n * Sleep for a specified amount of time.\n *\n * @param ms - The number of milliseconds to sleep.\n * @returns A promise that resolves after the specified amount of time.\n */\nasync function sleep(ms: number) {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"]}

package/dist/backend.d.cts

@@ -0,0 +1,39 @@
+import type { TransactionMeta } from "@metamask/transaction-controller";
+import type { CoverageResult, CoverageStatus, ShieldBackend } from "./types.cjs";
+export declare const BASE_URL = "https://rule-engine.metamask.io";
+export type InitCoverageCheckRequest = {
+    txParams: [
+        {
+            from: string;
+            to?: string;
+            value?: string;
+            data?: string;
+            nonce?: string;
+        }
+    ];
+    chainId: string;
+    origin?: string;
+};
+export type InitCoverageCheckResponse = {
+    coverageId: string;
+};
+export type GetCoverageResultRequest = {
+    coverageId: string;
+};
+export type GetCoverageResultResponse = {
+    status: CoverageStatus;
+};
+export declare class ShieldRemoteBackend implements ShieldBackend {
+    #private;
+    constructor({ getAccessToken, getCoverageResultTimeout, // milliseconds
+    getCoverageResultPollInterval, // milliseconds
+    baseUrl, fetch: fetchFn, }: {
+        getAccessToken: () => Promise<string>;
+        getCoverageResultTimeout?: number;
+        getCoverageResultPollInterval?: number;
+        baseUrl?: string;
+        fetch: typeof globalThis.fetch;
+    });
+    checkCoverage: (txMeta: TransactionMeta) => Promise<CoverageResult>;
+}
+//# sourceMappingURL=backend.d.cts.map

package/dist/backend.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.cts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AAExE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,oBAAgB;AAE7E,eAAO,MAAM,QAAQ,oCAAoC,CAAC;AAE1D,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,MAAM,CAAC;YACb,EAAE,CAAC,EAAE,MAAM,CAAC;YACZ,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB;KACF,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF,qBAAa,mBAAoB,YAAW,aAAa;;gBAW3C,EACV,cAAc,EACd,wBAA+B,EAAE,eAAe;IAChD,6BAAoC,EAAE,eAAe;IACrD,OAAkB,EAClB,KAAK,EAAE,OAAO,GACf,EAAE;QACD,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,6BAA6B,CAAC,EAAE,MAAM,CAAC;QACvC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;KAChC;IAQD,aAAa,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAoBjE;CAmEH"}

package/dist/backend.d.mts

@@ -0,0 +1,39 @@
+import type { TransactionMeta } from "@metamask/transaction-controller";
+import type { CoverageResult, CoverageStatus, ShieldBackend } from "./types.mjs";
+export declare const BASE_URL = "https://rule-engine.metamask.io";
+export type InitCoverageCheckRequest = {
+    txParams: [
+        {
+            from: string;
+            to?: string;
+            value?: string;
+            data?: string;
+            nonce?: string;
+        }
+    ];
+    chainId: string;
+    origin?: string;
+};
+export type InitCoverageCheckResponse = {
+    coverageId: string;
+};
+export type GetCoverageResultRequest = {
+    coverageId: string;
+};
+export type GetCoverageResultResponse = {
+    status: CoverageStatus;
+};
+export declare class ShieldRemoteBackend implements ShieldBackend {
+    #private;
+    constructor({ getAccessToken, getCoverageResultTimeout, // milliseconds
+    getCoverageResultPollInterval, // milliseconds
+    baseUrl, fetch: fetchFn, }: {
+        getAccessToken: () => Promise<string>;
+        getCoverageResultTimeout?: number;
+        getCoverageResultPollInterval?: number;
+        baseUrl?: string;
+        fetch: typeof globalThis.fetch;
+    });
+    checkCoverage: (txMeta: TransactionMeta) => Promise<CoverageResult>;
+}
+//# sourceMappingURL=backend.d.mts.map

package/dist/backend.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.mts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AAExE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,oBAAgB;AAE7E,eAAO,MAAM,QAAQ,oCAAoC,CAAC;AAE1D,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,MAAM,CAAC;YACb,EAAE,CAAC,EAAE,MAAM,CAAC;YACZ,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB;KACF,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF,qBAAa,mBAAoB,YAAW,aAAa;;gBAW3C,EACV,cAAc,EACd,wBAA+B,EAAE,eAAe;IAChD,6BAAoC,EAAE,eAAe;IACrD,OAAkB,EAClB,KAAK,EAAE,OAAO,GACf,EAAE;QACD,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,6BAA6B,CAAC,EAAE,MAAM,CAAC;QACvC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;KAChC;IAQD,aAAa,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAoBjE;CAmEH"}

package/dist/backend.mjs

@@ -0,0 +1,106 @@
+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 _ShieldRemoteBackend_instances, _ShieldRemoteBackend_getAccessToken, _ShieldRemoteBackend_getCoverageResultTimeout, _ShieldRemoteBackend_getCoverageResultPollInterval, _ShieldRemoteBackend_baseUrl, _ShieldRemoteBackend_fetch, _ShieldRemoteBackend_initCoverageCheck, _ShieldRemoteBackend_getCoverageResult, _ShieldRemoteBackend_createHeaders;
+export const BASE_URL = 'https://rule-engine.metamask.io';
+export class ShieldRemoteBackend {
+    constructor({ getAccessToken, getCoverageResultTimeout = 5000, // milliseconds
+    getCoverageResultPollInterval = 1000, // milliseconds
+    baseUrl = BASE_URL, fetch: fetchFn, }) {
+        _ShieldRemoteBackend_instances.add(this);
+        _ShieldRemoteBackend_getAccessToken.set(this, void 0);
+        _ShieldRemoteBackend_getCoverageResultTimeout.set(this, void 0);
+        _ShieldRemoteBackend_getCoverageResultPollInterval.set(this, void 0);
+        _ShieldRemoteBackend_baseUrl.set(this, void 0);
+        _ShieldRemoteBackend_fetch.set(this, void 0);
+        this.checkCoverage = async (txMeta) => {
+            const reqBody = {
+                txParams: [
+                    {
+                        from: txMeta.txParams.from,
+                        to: txMeta.txParams.to,
+                        value: txMeta.txParams.value,
+                        data: txMeta.txParams.data,
+                        nonce: txMeta.txParams.nonce,
+                    },
+                ],
+                chainId: txMeta.chainId,
+                origin: txMeta.origin,
+            };
+            const { coverageId } = await __classPrivateFieldGet(this, _ShieldRemoteBackend_instances, "m", _ShieldRemoteBackend_initCoverageCheck).call(this, reqBody);
+            return __classPrivateFieldGet(this, _ShieldRemoteBackend_instances, "m", _ShieldRemoteBackend_getCoverageResult).call(this, coverageId);
+        };
+        __classPrivateFieldSet(this, _ShieldRemoteBackend_getAccessToken, getAccessToken, "f");
+        __classPrivateFieldSet(this, _ShieldRemoteBackend_getCoverageResultTimeout, getCoverageResultTimeout, "f");
+        __classPrivateFieldSet(this, _ShieldRemoteBackend_getCoverageResultPollInterval, getCoverageResultPollInterval, "f");
+        __classPrivateFieldSet(this, _ShieldRemoteBackend_baseUrl, baseUrl, "f");
+        __classPrivateFieldSet(this, _ShieldRemoteBackend_fetch, fetchFn, "f");
+    }
+}
+_ShieldRemoteBackend_getAccessToken = new WeakMap(), _ShieldRemoteBackend_getCoverageResultTimeout = new WeakMap(), _ShieldRemoteBackend_getCoverageResultPollInterval = new WeakMap(), _ShieldRemoteBackend_baseUrl = new WeakMap(), _ShieldRemoteBackend_fetch = new WeakMap(), _ShieldRemoteBackend_instances = new WeakSet(), _ShieldRemoteBackend_initCoverageCheck = async function _ShieldRemoteBackend_initCoverageCheck(reqBody) {
+    const res = await __classPrivateFieldGet(this, _ShieldRemoteBackend_fetch, "f").call(this, `${__classPrivateFieldGet(this, _ShieldRemoteBackend_baseUrl, "f")}/api/v1/coverage/init`, {
+        method: 'POST',
+        headers: await __classPrivateFieldGet(this, _ShieldRemoteBackend_instances, "m", _ShieldRemoteBackend_createHeaders).call(this),
+        body: JSON.stringify(reqBody),
+    });
+    if (res.status !== 200) {
+        throw new Error(`Failed to init coverage check: ${res.status}`);
+    }
+    return (await res.json());
+}, _ShieldRemoteBackend_getCoverageResult = async function _ShieldRemoteBackend_getCoverageResult(coverageId, timeout = __classPrivateFieldGet(this, _ShieldRemoteBackend_getCoverageResultTimeout, "f"), pollInterval = __classPrivateFieldGet(this, _ShieldRemoteBackend_getCoverageResultPollInterval, "f")) {
+    const reqBody = {
+        coverageId,
+    };
+    const headers = await __classPrivateFieldGet(this, _ShieldRemoteBackend_instances, "m", _ShieldRemoteBackend_createHeaders).call(this);
+    return await new Promise((resolve, reject) => {
+        let timeoutReached = false;
+        setTimeout(() => {
+            timeoutReached = true;
+            reject(new Error('Timeout waiting for coverage result'));
+        }, timeout);
+        const poll = async () => {
+            // The timeoutReached variable is modified in the timeout callback.
+            // eslint-disable-next-line no-unmodified-loop-condition
+            while (!timeoutReached) {
+                const startTime = Date.now();
+                const res = await __classPrivateFieldGet(this, _ShieldRemoteBackend_fetch, "f").call(this, `${__classPrivateFieldGet(this, _ShieldRemoteBackend_baseUrl, "f")}/api/v1/coverage/result`, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(reqBody),
+                });
+                if (res.status === 200) {
+                    return (await res.json());
+                }
+                await sleep(pollInterval - (Date.now() - startTime));
+            }
+            // The following line will not have an effect as the upper level promise
+            // will already be rejected by now.
+            throw new Error('unexpected error');
+        };
+        poll().then(resolve).catch(reject);
+    });
+}, _ShieldRemoteBackend_createHeaders = async function _ShieldRemoteBackend_createHeaders() {
+    const accessToken = await __classPrivateFieldGet(this, _ShieldRemoteBackend_getAccessToken, "f").call(this);
+    return {
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${accessToken}`,
+    };
+};
+/**
+ * Sleep for a specified amount of time.
+ *
+ * @param ms - The number of milliseconds to sleep.
+ * @returns A promise that resolves after the specified amount of time.
+ */
+async function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=backend.mjs.map

package/dist/backend.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.mjs","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TransactionMeta } from '@metamask/transaction-controller';\n\nimport type { CoverageResult, CoverageStatus, ShieldBackend } from './types';\n\nexport const BASE_URL = 'https://rule-engine.metamask.io';\n\nexport type InitCoverageCheckRequest = {\n  txParams: [\n    {\n      from: string;\n      to?: string;\n      value?: string;\n      data?: string;\n      nonce?: string;\n    },\n  ];\n  chainId: string;\n  origin?: string;\n};\n\nexport type InitCoverageCheckResponse = {\n  coverageId: string;\n};\n\nexport type GetCoverageResultRequest = {\n  coverageId: string;\n};\n\nexport type GetCoverageResultResponse = {\n  status: CoverageStatus;\n};\n\nexport class ShieldRemoteBackend implements ShieldBackend {\n  readonly #getAccessToken: () => Promise<string>;\n\n  readonly #getCoverageResultTimeout: number;\n\n  readonly #getCoverageResultPollInterval: number;\n\n  readonly #baseUrl: string;\n\n  readonly #fetch: typeof globalThis.fetch;\n\n  constructor({\n    getAccessToken,\n    getCoverageResultTimeout = 5000, // milliseconds\n    getCoverageResultPollInterval = 1000, // milliseconds\n    baseUrl = BASE_URL,\n    fetch: fetchFn,\n  }: {\n    getAccessToken: () => Promise<string>;\n    getCoverageResultTimeout?: number;\n    getCoverageResultPollInterval?: number;\n    baseUrl?: string;\n    fetch: typeof globalThis.fetch;\n  }) {\n    this.#getAccessToken = getAccessToken;\n    this.#getCoverageResultTimeout = getCoverageResultTimeout;\n    this.#getCoverageResultPollInterval = getCoverageResultPollInterval;\n    this.#baseUrl = baseUrl;\n    this.#fetch = fetchFn;\n  }\n\n  checkCoverage: (txMeta: TransactionMeta) => Promise<CoverageResult> = async (\n    txMeta,\n  ) => {\n    const reqBody: InitCoverageCheckRequest = {\n      txParams: [\n        {\n          from: txMeta.txParams.from,\n          to: txMeta.txParams.to,\n          value: txMeta.txParams.value,\n          data: txMeta.txParams.data,\n          nonce: txMeta.txParams.nonce,\n        },\n      ],\n      chainId: txMeta.chainId,\n      origin: txMeta.origin,\n    };\n\n    const { coverageId } = await this.#initCoverageCheck(reqBody);\n\n    return this.#getCoverageResult(coverageId);\n  };\n\n  async #initCoverageCheck(\n    reqBody: InitCoverageCheckRequest,\n  ): Promise<InitCoverageCheckResponse> {\n    const res = await this.#fetch(`${this.#baseUrl}/api/v1/coverage/init`, {\n      method: 'POST',\n      headers: await this.#createHeaders(),\n      body: JSON.stringify(reqBody),\n    });\n    if (res.status !== 200) {\n      throw new Error(`Failed to init coverage check: ${res.status}`);\n    }\n    return (await res.json()) as InitCoverageCheckResponse;\n  }\n\n  async #getCoverageResult(\n    coverageId: string,\n    timeout: number = this.#getCoverageResultTimeout,\n    pollInterval: number = this.#getCoverageResultPollInterval,\n  ): Promise<GetCoverageResultResponse> {\n    const reqBody: GetCoverageResultRequest = {\n      coverageId,\n    };\n\n    const headers = await this.#createHeaders();\n    return await new Promise((resolve, reject) => {\n      let timeoutReached = false;\n      setTimeout(() => {\n        timeoutReached = true;\n        reject(new Error('Timeout waiting for coverage result'));\n      }, timeout);\n\n      const poll = async (): Promise<GetCoverageResultResponse> => {\n        // The timeoutReached variable is modified in the timeout callback.\n        // eslint-disable-next-line no-unmodified-loop-condition\n        while (!timeoutReached) {\n          const startTime = Date.now();\n          const res = await this.#fetch(\n            `${this.#baseUrl}/api/v1/coverage/result`,\n            {\n              method: 'POST',\n              headers,\n              body: JSON.stringify(reqBody),\n            },\n          );\n          if (res.status === 200) {\n            return (await res.json()) as GetCoverageResultResponse;\n          }\n          await sleep(pollInterval - (Date.now() - startTime));\n        }\n        // The following line will not have an effect as the upper level promise\n        // will already be rejected by now.\n        throw new Error('unexpected error');\n      };\n\n      poll().then(resolve).catch(reject);\n    });\n  }\n\n  async #createHeaders() {\n    const accessToken = await this.#getAccessToken();\n    return {\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${accessToken}`,\n    };\n  }\n}\n\n/**\n * Sleep for a specified amount of time.\n *\n * @param ms - The number of milliseconds to sleep.\n * @returns A promise that resolves after the specified amount of time.\n */\nasync function sleep(ms: number) {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"]}

package/dist/constants.cjs

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.controllerName = void 0;
+/**
+ * The name of the {@link ShieldController}.
+ */
+exports.controllerName = 'ShieldController';
+//# sourceMappingURL=constants.cjs.map

package/dist/constants.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.cjs","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,cAAc,GAAG,kBAAkB,CAAC","sourcesContent":["/**\n * The name of the {@link ShieldController}.\n */\nexport const controllerName = 'ShieldController';\n"]}

package/dist/constants.d.cts

@@ -0,0 +1,5 @@
+/**
+ * The name of the {@link ShieldController}.
+ */
+export declare const controllerName = "ShieldController";
+//# sourceMappingURL=constants.d.cts.map

package/dist/constants.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.cts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,cAAc,qBAAqB,CAAC"}

package/dist/constants.d.mts

@@ -0,0 +1,5 @@
+/**
+ * The name of the {@link ShieldController}.
+ */
+export declare const controllerName = "ShieldController";
+//# sourceMappingURL=constants.d.mts.map

package/dist/constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.mts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,cAAc,qBAAqB,CAAC"}

package/dist/constants.mjs

@@ -0,0 +1,5 @@
+/**
+ * The name of the {@link ShieldController}.
+ */
+export const controllerName = 'ShieldController';
+//# sourceMappingURL=constants.mjs.map

package/dist/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.mjs","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,kBAAkB,CAAC","sourcesContent":["/**\n * The name of the {@link ShieldController}.\n */\nexport const controllerName = 'ShieldController';\n"]}

package/dist/index.cjs

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultShieldControllerState = exports.ShieldController = void 0;
+var ShieldController_1 = require("./ShieldController.cjs");
+Object.defineProperty(exports, "ShieldController", { enumerable: true, get: function () { return ShieldController_1.ShieldController; } });
+Object.defineProperty(exports, "getDefaultShieldControllerState", { enumerable: true, get: function () { return ShieldController_1.getDefaultShieldControllerState; } });
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAUA,2DAG4B;AAF1B,oHAAA,gBAAgB,OAAA;AAChB,mIAAA,+BAA+B,OAAA","sourcesContent":["export type { CoverageStatus } from './types';\nexport type {\n  ShieldControllerActions,\n  ShieldControllerEvents,\n  ShieldControllerMessenger,\n  ShieldControllerState,\n  ShieldControllerCheckCoverageAction,\n  ShieldControllerCoverageResultReceivedEvent,\n  ShieldControllerStateChangeEvent,\n} from './ShieldController';\nexport {\n  ShieldController,\n  getDefaultShieldControllerState,\n} from './ShieldController';\n"]}

package/dist/index.d.cts

@@ -0,0 +1,4 @@
+export type { CoverageStatus } from "./types.cjs";
+export type { ShieldControllerActions, ShieldControllerEvents, ShieldControllerMessenger, ShieldControllerState, ShieldControllerCheckCoverageAction, ShieldControllerCoverageResultReceivedEvent, ShieldControllerStateChangeEvent, } from "./ShieldController.cjs";
+export { ShieldController, getDefaultShieldControllerState, } from "./ShieldController.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,oBAAgB;AAC9C,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,mCAAmC,EACnC,2CAA2C,EAC3C,gCAAgC,GACjC,+BAA2B;AAC5B,OAAO,EACL,gBAAgB,EAChB,+BAA+B,GAChC,+BAA2B"}

package/dist/index.d.mts

@@ -0,0 +1,4 @@
+export type { CoverageStatus } from "./types.mjs";
+export type { ShieldControllerActions, ShieldControllerEvents, ShieldControllerMessenger, ShieldControllerState, ShieldControllerCheckCoverageAction, ShieldControllerCoverageResultReceivedEvent, ShieldControllerStateChangeEvent, } from "./ShieldController.mjs";
+export { ShieldController, getDefaultShieldControllerState, } from "./ShieldController.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,oBAAgB;AAC9C,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,mCAAmC,EACnC,2CAA2C,EAC3C,gCAAgC,GACjC,+BAA2B;AAC5B,OAAO,EACL,gBAAgB,EAChB,+BAA+B,GAChC,+BAA2B"}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+export { ShieldController, getDefaultShieldControllerState } from "./ShieldController.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,gBAAgB,EAChB,+BAA+B,EAChC,+BAA2B","sourcesContent":["export type { CoverageStatus } from './types';\nexport type {\n  ShieldControllerActions,\n  ShieldControllerEvents,\n  ShieldControllerMessenger,\n  ShieldControllerState,\n  ShieldControllerCheckCoverageAction,\n  ShieldControllerCoverageResultReceivedEvent,\n  ShieldControllerStateChangeEvent,\n} from './ShieldController';\nexport {\n  ShieldController,\n  getDefaultShieldControllerState,\n} from './ShieldController';\n"]}

package/dist/logger.cjs

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createModuleLogger = exports.projectLogger = void 0;
+const utils_1 = require("@metamask/utils");
+Object.defineProperty(exports, "createModuleLogger", { enumerable: true, get: function () { return utils_1.createModuleLogger; } });
+const constants_1 = require("./constants.cjs");
+exports.projectLogger = (0, utils_1.createProjectLogger)(constants_1.controllerName);
+//# sourceMappingURL=logger.cjs.map

package/dist/logger.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.cjs","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";;;AAAA,2CAA0E;AAMjE,mGANqB,0BAAkB,OAMrB;AAJ3B,+CAA6C;AAEhC,QAAA,aAAa,GAAG,IAAA,2BAAmB,EAAC,0BAAc,CAAC,CAAC","sourcesContent":["import { createProjectLogger, createModuleLogger } from '@metamask/utils';\n\nimport { controllerName } from './constants';\n\nexport const projectLogger = createProjectLogger(controllerName);\n\nexport { createModuleLogger };\n"]}

package/dist/logger.d.cts

@@ -0,0 +1,5 @@
+/// <reference types="debug" />
+import { createModuleLogger } from "@metamask/utils";
+export declare const projectLogger: import("debug").Debugger;
+export { createModuleLogger };
+//# sourceMappingURL=logger.d.cts.map

package/dist/logger.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.cts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";AAAA,OAAO,EAAuB,kBAAkB,EAAE,wBAAwB;AAI1E,eAAO,MAAM,aAAa,0BAAsC,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/logger.d.mts

@@ -0,0 +1,5 @@
+/// <reference types="debug" />
+import { createModuleLogger } from "@metamask/utils";
+export declare const projectLogger: import("debug").Debugger;
+export { createModuleLogger };
+//# sourceMappingURL=logger.d.mts.map

package/dist/logger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.mts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";AAAA,OAAO,EAAuB,kBAAkB,EAAE,wBAAwB;AAI1E,eAAO,MAAM,aAAa,0BAAsC,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/logger.mjs

@@ -0,0 +1,5 @@
+import { createProjectLogger, createModuleLogger } from "@metamask/utils";
+import { controllerName } from "./constants.mjs";
+export const projectLogger = createProjectLogger(controllerName);
+export { createModuleLogger };
+//# sourceMappingURL=logger.mjs.map

package/dist/logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.mjs","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,wBAAwB;AAE1E,OAAO,EAAE,cAAc,EAAE,wBAAoB;AAE7C,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,CAAC","sourcesContent":["import { createProjectLogger, createModuleLogger } from '@metamask/utils';\n\nimport { controllerName } from './constants';\n\nexport const projectLogger = createProjectLogger(controllerName);\n\nexport { createModuleLogger };\n"]}

package/dist/types.cjs

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.coverageStatuses = void 0;
+exports.coverageStatuses = ['covered', 'malicious', 'unknown'];
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAMa,QAAA,gBAAgB,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,CAAU,CAAC","sourcesContent":["import type { TransactionMeta } from '@metamask/transaction-controller';\n\nexport type CoverageResult = {\n  status: CoverageStatus;\n};\n\nexport const coverageStatuses = ['covered', 'malicious', 'unknown'] as const;\nexport type CoverageStatus = (typeof coverageStatuses)[number];\n\nexport type ShieldBackend = {\n  checkCoverage: (txMeta: TransactionMeta) => Promise<CoverageResult>;\n};\n"]}

package/dist/types.d.cts

@@ -0,0 +1,10 @@
+import type { TransactionMeta } from "@metamask/transaction-controller";
+export type CoverageResult = {
+    status: CoverageStatus;
+};
+export declare const coverageStatuses: readonly ["covered", "malicious", "unknown"];
+export type CoverageStatus = (typeof coverageStatuses)[number];
+export type ShieldBackend = {
+    checkCoverage: (txMeta: TransactionMeta) => Promise<CoverageResult>;
+};
+//# sourceMappingURL=types.d.cts.map

package/dist/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AAExE,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,gBAAgB,8CAA+C,CAAC;AAC7E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACrE,CAAC"}

package/dist/types.d.mts

@@ -0,0 +1,10 @@
+import type { TransactionMeta } from "@metamask/transaction-controller";
+export type CoverageResult = {
+    status: CoverageStatus;
+};
+export declare const coverageStatuses: readonly ["covered", "malicious", "unknown"];
+export type CoverageStatus = (typeof coverageStatuses)[number];
+export type ShieldBackend = {
+    checkCoverage: (txMeta: TransactionMeta) => Promise<CoverageResult>;
+};
+//# sourceMappingURL=types.d.mts.map

package/dist/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AAExE,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,gBAAgB,8CAA+C,CAAC;AAC7E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACrE,CAAC"}

package/dist/types.mjs

@@ -0,0 +1,2 @@
+export const coverageStatuses = ['covered', 'malicious', 'unknown'];
+//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,CAAU,CAAC","sourcesContent":["import type { TransactionMeta } from '@metamask/transaction-controller';\n\nexport type CoverageResult = {\n  status: CoverageStatus;\n};\n\nexport const coverageStatuses = ['covered', 'malicious', 'unknown'] as const;\nexport type CoverageStatus = (typeof coverageStatuses)[number];\n\nexport type ShieldBackend = {\n  checkCoverage: (txMeta: TransactionMeta) => Promise<CoverageResult>;\n};\n"]}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@metamask/shield-controller",
+  "version": "0.1.0",
+  "description": "Controller handling shield transaction coverage logic",
+  "keywords": [
+    "MetaMask",
+    "Ethereum"
+  ],
+  "homepage": "https://github.com/MetaMask/core/tree/main/packages/shield-controller#readme",
+  "bugs": {
+    "url": "https://github.com/MetaMask/core/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MetaMask/core.git"
+  },
+  "license": "MIT",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.cts",
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "ts-bridge --project tsconfig.build.json --verbose --clean --no-references",
+    "build:docs": "typedoc",
+    "changelog:update": "../../scripts/update-changelog.sh @metamask/shield-controller",
+    "changelog:validate": "../../scripts/validate-changelog.sh @metamask/shield-controller",
+    "publish:preview": "yarn npm publish --tag preview",
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest --reporters=jest-silent-reporter",
+    "test:clean": "NODE_OPTIONS=--experimental-vm-modules jest --clearCache",
+    "test:verbose": "NODE_OPTIONS=--experimental-vm-modules jest --verbose",
+    "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch",
+    "since-latest-release": "../../scripts/since-latest-release.sh"
+  },
+  "dependencies": {
+    "@metamask/base-controller": "^8.2.0",
+    "@metamask/utils": "^11.4.2"
+  },
+  "devDependencies": {
+    "@babel/runtime": "^7.23.9",
+    "@lavamoat/allow-scripts": "^3.0.4",
+    "@lavamoat/preinstall-always-fail": "^2.1.0",
+    "@metamask/auto-changelog": "^3.4.4",
+    "@metamask/transaction-controller": "^60.1.0",
+    "@ts-bridge/cli": "^0.6.1",
+    "@types/jest": "^27.4.1",
+    "deepmerge": "^4.2.2",
+    "jest": "^27.5.1",
+    "ts-jest": "^27.1.4",
+    "typedoc": "^0.24.8",
+    "typedoc-plugin-missing-exports": "^2.0.0",
+    "typescript": "~5.2.2",
+    "uuid": "^8.3.2"
+  },
+  "peerDependencies": {
+    "@metamask/transaction-controller": "^60.0.0"
+  },
+  "engines": {
+    "node": "^18.18 || >=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "lavamoat": {
+    "allowScripts": {
+      "@lavamoat/allow-scripts>@lavamoat/preinstall-always-fail": false
+    }
+  }
+}