@metamask/assets-controller 0.1.0

package/dist/middlewares/DetectionMiddleware.cjs

@@ -0,0 +1,101 @@
+"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 _DetectionMiddleware_instances, _DetectionMiddleware_messenger, _DetectionMiddleware_registerActionHandlers;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DetectionMiddleware = void 0;
+const logger_1 = require("../logger.cjs");
+const types_1 = require("../types.cjs");
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+const CONTROLLER_NAME = 'DetectionMiddleware';
+// Logger for debugging
+(0, logger_1.createModuleLogger)(logger_1.projectLogger, CONTROLLER_NAME);
+// ============================================================================
+// DETECTION MIDDLEWARE
+// ============================================================================
+/**
+ * DetectionMiddleware identifies assets that do not have metadata.
+ *
+ * This middleware:
+ * - Checks assets in the response for metadata in state
+ * - Assets in response but without metadata are considered "detected"
+ * - Fills response.detectedAssets with asset IDs per account that lack metadata
+ *
+ * Usage:
+ * ```typescript
+ * // Create and initialize (registers messenger actions)
+ * const detectionMiddleware = new DetectionMiddleware({ messenger });
+ *
+ * // Later, get middleware via messenger
+ * const middleware = messenger.call('DetectionMiddleware:getAssetsMiddleware');
+ * ```
+ */
+class DetectionMiddleware {
+    constructor(options) {
+        _DetectionMiddleware_instances.add(this);
+        this.name = CONTROLLER_NAME;
+        _DetectionMiddleware_messenger.set(this, void 0);
+        __classPrivateFieldSet(this, _DetectionMiddleware_messenger, options.messenger, "f");
+        __classPrivateFieldGet(this, _DetectionMiddleware_instances, "m", _DetectionMiddleware_registerActionHandlers).call(this);
+    }
+    /**
+     * Get the middleware for detecting assets without metadata.
+     *
+     * This middleware:
+     * 1. Extracts the response from context
+     * 2. Detects assets from the response that don't have metadata
+     * 3. Fills response.detectedAssets with detected asset IDs per account
+     * 4. Calls next() to continue the middleware chain
+     *
+     * @returns The middleware function for the assets pipeline.
+     */
+    get assetsMiddleware() {
+        return (0, types_1.forDataTypes)(['balance'], async (ctx, next) => {
+            // Extract response from context
+            const { response } = ctx;
+            // If no balances in response, nothing to detect - pass through
+            if (!response.assetsBalance) {
+                return next(ctx);
+            }
+            // Get metadata from state
+            const { assetsMetadata: stateMetadata } = ctx.getAssetsState();
+            const detectedAssets = {};
+            // Detect assets from the response that don't have metadata
+            for (const [accountId, accountBalances] of Object.entries(response.assetsBalance)) {
+                const detected = [];
+                for (const assetId of Object.keys(accountBalances)) {
+                    // Asset is detected if it does not have metadata in state
+                    if (!stateMetadata[assetId]) {
+                        detected.push(assetId);
+                    }
+                }
+                if (detected.length > 0) {
+                    detectedAssets[accountId] = detected;
+                }
+            }
+            // Fill detectedAssets in the response
+            if (Object.keys(detectedAssets).length > 0) {
+                response.detectedAssets = detectedAssets;
+            }
+            // Call next() to continue the middleware chain
+            return next(ctx);
+        });
+    }
+}
+exports.DetectionMiddleware = DetectionMiddleware;
+_DetectionMiddleware_messenger = new WeakMap(), _DetectionMiddleware_instances = new WeakSet(), _DetectionMiddleware_registerActionHandlers = function _DetectionMiddleware_registerActionHandlers() {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    __classPrivateFieldGet(this, _DetectionMiddleware_messenger, "f").registerActionHandler('DetectionMiddleware:getAssetsMiddleware', () => this.assetsMiddleware);
+};
+//# sourceMappingURL=DetectionMiddleware.cjs.map

package/dist/middlewares/DetectionMiddleware.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetectionMiddleware.cjs","sourceRoot":"","sources":["../../src/middlewares/DetectionMiddleware.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAEA,0CAA8D;AAC9D,wCAAwC;AAGxC,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAE9C,uBAAuB;AACvB,IAAA,2BAAkB,EAAC,sBAAa,EAAE,eAAe,CAAC,CAAC;AAkCnD,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,mBAAmB;IAK9B,YAAY,OAAmC;;QAJtC,SAAI,GAAG,eAAe,CAAC;QAEvB,iDAAyC;QAGhD,uBAAA,IAAI,kCAAc,OAAO,CAAC,SAAS,MAAA,CAAC;QACpC,uBAAA,IAAI,mFAAwB,MAA5B,IAAI,CAA0B,CAAC;IACjC,CAAC;IAUD;;;;;;;;;;OAUG;IACH,IAAI,gBAAgB;QAClB,OAAO,IAAA,oBAAY,EAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YACnD,gCAAgC;YAChC,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;YAEzB,+DAA+D;YAC/D,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;gBAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;YAED,0BAA0B;YAC1B,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC;YAE/D,MAAM,cAAc,GAAuC,EAAE,CAAC;YAE9D,2DAA2D;YAC3D,KAAK,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,IAAI,MAAM,CAAC,OAAO,CACvD,QAAQ,CAAC,aAAa,CACvB,EAAE,CAAC;gBACF,MAAM,QAAQ,GAAoB,EAAE,CAAC;gBAErC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI,CAC/B,eAA0C,CAC3C,EAAE,CAAC;oBACF,0DAA0D;oBAC1D,IAAI,CAAC,aAAa,CAAC,OAAwB,CAAC,EAAE,CAAC;wBAC7C,QAAQ,CAAC,IAAI,CAAC,OAAwB,CAAC,CAAC;oBAC1C,CAAC;gBACH,CAAC;gBAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxB,cAAc,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC;gBACvC,CAAC;YACH,CAAC;YAED,sCAAsC;YACtC,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3C,QAAQ,CAAC,cAAc,GAAG,cAAc,CAAC;YAC3C,CAAC;YAED,+CAA+C;YAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAzED,kDAyEC;;IA9DG,8DAA8D;IAC7D,uBAAA,IAAI,sCAAmB,CAAC,qBAAqB,CAC5C,yCAAyC,EACzC,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAC5B,CAAC;AACJ,CAAC","sourcesContent":["import type { Messenger } from '@metamask/messenger';\n\nimport { projectLogger, createModuleLogger } from '../logger';\nimport { forDataTypes } from '../types';\nimport type { AccountId, Caip19AssetId, Middleware } from '../types';\n\n// ============================================================================\n// CONSTANTS\n// ============================================================================\n\nconst CONTROLLER_NAME = 'DetectionMiddleware';\n\n// Logger for debugging\ncreateModuleLogger(projectLogger, CONTROLLER_NAME);\n\n// ============================================================================\n// MESSENGER TYPES\n// ============================================================================\n\n/**\n * Action to get the DetectionMiddleware middleware.\n */\nexport type DetectionMiddlewareGetAssetsMiddlewareAction = {\n  type: `${typeof CONTROLLER_NAME}:getAssetsMiddleware`;\n  handler: () => Middleware;\n};\n\n/**\n * All actions exposed by DetectionMiddleware.\n */\nexport type DetectionMiddlewareActions =\n  DetectionMiddlewareGetAssetsMiddlewareAction;\n\nexport type DetectionMiddlewareMessenger = Messenger<\n  typeof CONTROLLER_NAME,\n  DetectionMiddlewareActions,\n  never\n>;\n\n// ============================================================================\n// OPTIONS\n// ============================================================================\n\nexport type DetectionMiddlewareOptions = {\n  messenger: DetectionMiddlewareMessenger;\n};\n\n// ============================================================================\n// DETECTION MIDDLEWARE\n// ============================================================================\n\n/**\n * DetectionMiddleware identifies assets that do not have metadata.\n *\n * This middleware:\n * - Checks assets in the response for metadata in state\n * - Assets in response but without metadata are considered \"detected\"\n * - Fills response.detectedAssets with asset IDs per account that lack metadata\n *\n * Usage:\n * ```typescript\n * // Create and initialize (registers messenger actions)\n * const detectionMiddleware = new DetectionMiddleware({ messenger });\n *\n * // Later, get middleware via messenger\n * const middleware = messenger.call('DetectionMiddleware:getAssetsMiddleware');\n * ```\n */\nexport class DetectionMiddleware {\n  readonly name = CONTROLLER_NAME;\n\n  readonly #messenger: DetectionMiddlewareMessenger;\n\n  constructor(options: DetectionMiddlewareOptions) {\n    this.#messenger = options.messenger;\n    this.#registerActionHandlers();\n  }\n\n  #registerActionHandlers(): void {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (this.#messenger as any).registerActionHandler(\n      'DetectionMiddleware:getAssetsMiddleware',\n      () => this.assetsMiddleware,\n    );\n  }\n\n  /**\n   * Get the middleware for detecting assets without metadata.\n   *\n   * This middleware:\n   * 1. Extracts the response from context\n   * 2. Detects assets from the response that don't have metadata\n   * 3. Fills response.detectedAssets with detected asset IDs per account\n   * 4. Calls next() to continue the middleware chain\n   *\n   * @returns The middleware function for the assets pipeline.\n   */\n  get assetsMiddleware(): Middleware {\n    return forDataTypes(['balance'], async (ctx, next) => {\n      // Extract response from context\n      const { response } = ctx;\n\n      // If no balances in response, nothing to detect - pass through\n      if (!response.assetsBalance) {\n        return next(ctx);\n      }\n\n      // Get metadata from state\n      const { assetsMetadata: stateMetadata } = ctx.getAssetsState();\n\n      const detectedAssets: Record<AccountId, Caip19AssetId[]> = {};\n\n      // Detect assets from the response that don't have metadata\n      for (const [accountId, accountBalances] of Object.entries(\n        response.assetsBalance,\n      )) {\n        const detected: Caip19AssetId[] = [];\n\n        for (const assetId of Object.keys(\n          accountBalances as Record<string, unknown>,\n        )) {\n          // Asset is detected if it does not have metadata in state\n          if (!stateMetadata[assetId as Caip19AssetId]) {\n            detected.push(assetId as Caip19AssetId);\n          }\n        }\n\n        if (detected.length > 0) {\n          detectedAssets[accountId] = detected;\n        }\n      }\n\n      // Fill detectedAssets in the response\n      if (Object.keys(detectedAssets).length > 0) {\n        response.detectedAssets = detectedAssets;\n      }\n\n      // Call next() to continue the middleware chain\n      return next(ctx);\n    });\n  }\n}\n"]}

package/dist/middlewares/DetectionMiddleware.d.cts

@@ -0,0 +1,54 @@
+import type { Messenger } from "@metamask/messenger";
+import type { Middleware } from "../types.cjs";
+declare const CONTROLLER_NAME = "DetectionMiddleware";
+/**
+ * Action to get the DetectionMiddleware middleware.
+ */
+export type DetectionMiddlewareGetAssetsMiddlewareAction = {
+    type: `${typeof CONTROLLER_NAME}:getAssetsMiddleware`;
+    handler: () => Middleware;
+};
+/**
+ * All actions exposed by DetectionMiddleware.
+ */
+export type DetectionMiddlewareActions = DetectionMiddlewareGetAssetsMiddlewareAction;
+export type DetectionMiddlewareMessenger = Messenger<typeof CONTROLLER_NAME, DetectionMiddlewareActions, never>;
+export type DetectionMiddlewareOptions = {
+    messenger: DetectionMiddlewareMessenger;
+};
+/**
+ * DetectionMiddleware identifies assets that do not have metadata.
+ *
+ * This middleware:
+ * - Checks assets in the response for metadata in state
+ * - Assets in response but without metadata are considered "detected"
+ * - Fills response.detectedAssets with asset IDs per account that lack metadata
+ *
+ * Usage:
+ * ```typescript
+ * // Create and initialize (registers messenger actions)
+ * const detectionMiddleware = new DetectionMiddleware({ messenger });
+ *
+ * // Later, get middleware via messenger
+ * const middleware = messenger.call('DetectionMiddleware:getAssetsMiddleware');
+ * ```
+ */
+export declare class DetectionMiddleware {
+    #private;
+    readonly name = "DetectionMiddleware";
+    constructor(options: DetectionMiddlewareOptions);
+    /**
+     * Get the middleware for detecting assets without metadata.
+     *
+     * This middleware:
+     * 1. Extracts the response from context
+     * 2. Detects assets from the response that don't have metadata
+     * 3. Fills response.detectedAssets with detected asset IDs per account
+     * 4. Calls next() to continue the middleware chain
+     *
+     * @returns The middleware function for the assets pipeline.
+     */
+    get assetsMiddleware(): Middleware;
+}
+export {};
+//# sourceMappingURL=DetectionMiddleware.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DetectionMiddleware.d.cts","sourceRoot":"","sources":["../../src/middlewares/DetectionMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAIrD,OAAO,KAAK,EAA4B,UAAU,EAAE,qBAAiB;AAMrE,QAAA,MAAM,eAAe,wBAAwB,CAAC;AAS9C;;GAEG;AACH,MAAM,MAAM,4CAA4C,GAAG;IACzD,IAAI,EAAE,GAAG,OAAO,eAAe,sBAAsB,CAAC;IACtD,OAAO,EAAE,MAAM,UAAU,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GACpC,4CAA4C,CAAC;AAE/C,MAAM,MAAM,4BAA4B,GAAG,SAAS,CAClD,OAAO,eAAe,EACtB,0BAA0B,EAC1B,KAAK,CACN,CAAC;AAMF,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,4BAA4B,CAAC;CACzC,CAAC;AAMF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,mBAAmB;;IAC9B,QAAQ,CAAC,IAAI,yBAAmB;gBAIpB,OAAO,EAAE,0BAA0B;IAa/C;;;;;;;;;;OAUG;IACH,IAAI,gBAAgB,IAAI,UAAU,CA2CjC;CACF"}

package/dist/middlewares/DetectionMiddleware.d.mts

@@ -0,0 +1,54 @@
+import type { Messenger } from "@metamask/messenger";
+import type { Middleware } from "../types.mjs";
+declare const CONTROLLER_NAME = "DetectionMiddleware";
+/**
+ * Action to get the DetectionMiddleware middleware.
+ */
+export type DetectionMiddlewareGetAssetsMiddlewareAction = {
+    type: `${typeof CONTROLLER_NAME}:getAssetsMiddleware`;
+    handler: () => Middleware;
+};
+/**
+ * All actions exposed by DetectionMiddleware.
+ */
+export type DetectionMiddlewareActions = DetectionMiddlewareGetAssetsMiddlewareAction;
+export type DetectionMiddlewareMessenger = Messenger<typeof CONTROLLER_NAME, DetectionMiddlewareActions, never>;
+export type DetectionMiddlewareOptions = {
+    messenger: DetectionMiddlewareMessenger;
+};
+/**
+ * DetectionMiddleware identifies assets that do not have metadata.
+ *
+ * This middleware:
+ * - Checks assets in the response for metadata in state
+ * - Assets in response but without metadata are considered "detected"
+ * - Fills response.detectedAssets with asset IDs per account that lack metadata
+ *
+ * Usage:
+ * ```typescript
+ * // Create and initialize (registers messenger actions)
+ * const detectionMiddleware = new DetectionMiddleware({ messenger });
+ *
+ * // Later, get middleware via messenger
+ * const middleware = messenger.call('DetectionMiddleware:getAssetsMiddleware');
+ * ```
+ */
+export declare class DetectionMiddleware {
+    #private;
+    readonly name = "DetectionMiddleware";
+    constructor(options: DetectionMiddlewareOptions);
+    /**
+     * Get the middleware for detecting assets without metadata.
+     *
+     * This middleware:
+     * 1. Extracts the response from context
+     * 2. Detects assets from the response that don't have metadata
+     * 3. Fills response.detectedAssets with detected asset IDs per account
+     * 4. Calls next() to continue the middleware chain
+     *
+     * @returns The middleware function for the assets pipeline.
+     */
+    get assetsMiddleware(): Middleware;
+}
+export {};
+//# sourceMappingURL=DetectionMiddleware.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DetectionMiddleware.d.mts","sourceRoot":"","sources":["../../src/middlewares/DetectionMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAIrD,OAAO,KAAK,EAA4B,UAAU,EAAE,qBAAiB;AAMrE,QAAA,MAAM,eAAe,wBAAwB,CAAC;AAS9C;;GAEG;AACH,MAAM,MAAM,4CAA4C,GAAG;IACzD,IAAI,EAAE,GAAG,OAAO,eAAe,sBAAsB,CAAC;IACtD,OAAO,EAAE,MAAM,UAAU,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GACpC,4CAA4C,CAAC;AAE/C,MAAM,MAAM,4BAA4B,GAAG,SAAS,CAClD,OAAO,eAAe,EACtB,0BAA0B,EAC1B,KAAK,CACN,CAAC;AAMF,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,4BAA4B,CAAC;CACzC,CAAC;AAMF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,mBAAmB;;IAC9B,QAAQ,CAAC,IAAI,yBAAmB;gBAIpB,OAAO,EAAE,0BAA0B;IAa/C;;;;;;;;;;OAUG;IACH,IAAI,gBAAgB,IAAI,UAAU,CA2CjC;CACF"}

package/dist/middlewares/DetectionMiddleware.mjs

@@ -0,0 +1,97 @@
+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 _DetectionMiddleware_instances, _DetectionMiddleware_messenger, _DetectionMiddleware_registerActionHandlers;
+import { projectLogger, createModuleLogger } from "../logger.mjs";
+import { forDataTypes } from "../types.mjs";
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+const CONTROLLER_NAME = 'DetectionMiddleware';
+// Logger for debugging
+createModuleLogger(projectLogger, CONTROLLER_NAME);
+// ============================================================================
+// DETECTION MIDDLEWARE
+// ============================================================================
+/**
+ * DetectionMiddleware identifies assets that do not have metadata.
+ *
+ * This middleware:
+ * - Checks assets in the response for metadata in state
+ * - Assets in response but without metadata are considered "detected"
+ * - Fills response.detectedAssets with asset IDs per account that lack metadata
+ *
+ * Usage:
+ * ```typescript
+ * // Create and initialize (registers messenger actions)
+ * const detectionMiddleware = new DetectionMiddleware({ messenger });
+ *
+ * // Later, get middleware via messenger
+ * const middleware = messenger.call('DetectionMiddleware:getAssetsMiddleware');
+ * ```
+ */
+export class DetectionMiddleware {
+    constructor(options) {
+        _DetectionMiddleware_instances.add(this);
+        this.name = CONTROLLER_NAME;
+        _DetectionMiddleware_messenger.set(this, void 0);
+        __classPrivateFieldSet(this, _DetectionMiddleware_messenger, options.messenger, "f");
+        __classPrivateFieldGet(this, _DetectionMiddleware_instances, "m", _DetectionMiddleware_registerActionHandlers).call(this);
+    }
+    /**
+     * Get the middleware for detecting assets without metadata.
+     *
+     * This middleware:
+     * 1. Extracts the response from context
+     * 2. Detects assets from the response that don't have metadata
+     * 3. Fills response.detectedAssets with detected asset IDs per account
+     * 4. Calls next() to continue the middleware chain
+     *
+     * @returns The middleware function for the assets pipeline.
+     */
+    get assetsMiddleware() {
+        return forDataTypes(['balance'], async (ctx, next) => {
+            // Extract response from context
+            const { response } = ctx;
+            // If no balances in response, nothing to detect - pass through
+            if (!response.assetsBalance) {
+                return next(ctx);
+            }
+            // Get metadata from state
+            const { assetsMetadata: stateMetadata } = ctx.getAssetsState();
+            const detectedAssets = {};
+            // Detect assets from the response that don't have metadata
+            for (const [accountId, accountBalances] of Object.entries(response.assetsBalance)) {
+                const detected = [];
+                for (const assetId of Object.keys(accountBalances)) {
+                    // Asset is detected if it does not have metadata in state
+                    if (!stateMetadata[assetId]) {
+                        detected.push(assetId);
+                    }
+                }
+                if (detected.length > 0) {
+                    detectedAssets[accountId] = detected;
+                }
+            }
+            // Fill detectedAssets in the response
+            if (Object.keys(detectedAssets).length > 0) {
+                response.detectedAssets = detectedAssets;
+            }
+            // Call next() to continue the middleware chain
+            return next(ctx);
+        });
+    }
+}
+_DetectionMiddleware_messenger = new WeakMap(), _DetectionMiddleware_instances = new WeakSet(), _DetectionMiddleware_registerActionHandlers = function _DetectionMiddleware_registerActionHandlers() {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    __classPrivateFieldGet(this, _DetectionMiddleware_messenger, "f").registerActionHandler('DetectionMiddleware:getAssetsMiddleware', () => this.assetsMiddleware);
+};
+//# sourceMappingURL=DetectionMiddleware.mjs.map

package/dist/middlewares/DetectionMiddleware.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetectionMiddleware.mjs","sourceRoot":"","sources":["../../src/middlewares/DetectionMiddleware.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,sBAAkB;AAC9D,OAAO,EAAE,YAAY,EAAE,qBAAiB;AAGxC,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAE9C,uBAAuB;AACvB,kBAAkB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;AAkCnD,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,mBAAmB;IAK9B,YAAY,OAAmC;;QAJtC,SAAI,GAAG,eAAe,CAAC;QAEvB,iDAAyC;QAGhD,uBAAA,IAAI,kCAAc,OAAO,CAAC,SAAS,MAAA,CAAC;QACpC,uBAAA,IAAI,mFAAwB,MAA5B,IAAI,CAA0B,CAAC;IACjC,CAAC;IAUD;;;;;;;;;;OAUG;IACH,IAAI,gBAAgB;QAClB,OAAO,YAAY,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YACnD,gCAAgC;YAChC,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;YAEzB,+DAA+D;YAC/D,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;gBAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;YAED,0BAA0B;YAC1B,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC;YAE/D,MAAM,cAAc,GAAuC,EAAE,CAAC;YAE9D,2DAA2D;YAC3D,KAAK,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,IAAI,MAAM,CAAC,OAAO,CACvD,QAAQ,CAAC,aAAa,CACvB,EAAE,CAAC;gBACF,MAAM,QAAQ,GAAoB,EAAE,CAAC;gBAErC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI,CAC/B,eAA0C,CAC3C,EAAE,CAAC;oBACF,0DAA0D;oBAC1D,IAAI,CAAC,aAAa,CAAC,OAAwB,CAAC,EAAE,CAAC;wBAC7C,QAAQ,CAAC,IAAI,CAAC,OAAwB,CAAC,CAAC;oBAC1C,CAAC;gBACH,CAAC;gBAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxB,cAAc,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC;gBACvC,CAAC;YACH,CAAC;YAED,sCAAsC;YACtC,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3C,QAAQ,CAAC,cAAc,GAAG,cAAc,CAAC;YAC3C,CAAC;YAED,+CAA+C;YAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC;CACF;;IA9DG,8DAA8D;IAC7D,uBAAA,IAAI,sCAAmB,CAAC,qBAAqB,CAC5C,yCAAyC,EACzC,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAC5B,CAAC;AACJ,CAAC","sourcesContent":["import type { Messenger } from '@metamask/messenger';\n\nimport { projectLogger, createModuleLogger } from '../logger';\nimport { forDataTypes } from '../types';\nimport type { AccountId, Caip19AssetId, Middleware } from '../types';\n\n// ============================================================================\n// CONSTANTS\n// ============================================================================\n\nconst CONTROLLER_NAME = 'DetectionMiddleware';\n\n// Logger for debugging\ncreateModuleLogger(projectLogger, CONTROLLER_NAME);\n\n// ============================================================================\n// MESSENGER TYPES\n// ============================================================================\n\n/**\n * Action to get the DetectionMiddleware middleware.\n */\nexport type DetectionMiddlewareGetAssetsMiddlewareAction = {\n  type: `${typeof CONTROLLER_NAME}:getAssetsMiddleware`;\n  handler: () => Middleware;\n};\n\n/**\n * All actions exposed by DetectionMiddleware.\n */\nexport type DetectionMiddlewareActions =\n  DetectionMiddlewareGetAssetsMiddlewareAction;\n\nexport type DetectionMiddlewareMessenger = Messenger<\n  typeof CONTROLLER_NAME,\n  DetectionMiddlewareActions,\n  never\n>;\n\n// ============================================================================\n// OPTIONS\n// ============================================================================\n\nexport type DetectionMiddlewareOptions = {\n  messenger: DetectionMiddlewareMessenger;\n};\n\n// ============================================================================\n// DETECTION MIDDLEWARE\n// ============================================================================\n\n/**\n * DetectionMiddleware identifies assets that do not have metadata.\n *\n * This middleware:\n * - Checks assets in the response for metadata in state\n * - Assets in response but without metadata are considered \"detected\"\n * - Fills response.detectedAssets with asset IDs per account that lack metadata\n *\n * Usage:\n * ```typescript\n * // Create and initialize (registers messenger actions)\n * const detectionMiddleware = new DetectionMiddleware({ messenger });\n *\n * // Later, get middleware via messenger\n * const middleware = messenger.call('DetectionMiddleware:getAssetsMiddleware');\n * ```\n */\nexport class DetectionMiddleware {\n  readonly name = CONTROLLER_NAME;\n\n  readonly #messenger: DetectionMiddlewareMessenger;\n\n  constructor(options: DetectionMiddlewareOptions) {\n    this.#messenger = options.messenger;\n    this.#registerActionHandlers();\n  }\n\n  #registerActionHandlers(): void {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (this.#messenger as any).registerActionHandler(\n      'DetectionMiddleware:getAssetsMiddleware',\n      () => this.assetsMiddleware,\n    );\n  }\n\n  /**\n   * Get the middleware for detecting assets without metadata.\n   *\n   * This middleware:\n   * 1. Extracts the response from context\n   * 2. Detects assets from the response that don't have metadata\n   * 3. Fills response.detectedAssets with detected asset IDs per account\n   * 4. Calls next() to continue the middleware chain\n   *\n   * @returns The middleware function for the assets pipeline.\n   */\n  get assetsMiddleware(): Middleware {\n    return forDataTypes(['balance'], async (ctx, next) => {\n      // Extract response from context\n      const { response } = ctx;\n\n      // If no balances in response, nothing to detect - pass through\n      if (!response.assetsBalance) {\n        return next(ctx);\n      }\n\n      // Get metadata from state\n      const { assetsMetadata: stateMetadata } = ctx.getAssetsState();\n\n      const detectedAssets: Record<AccountId, Caip19AssetId[]> = {};\n\n      // Detect assets from the response that don't have metadata\n      for (const [accountId, accountBalances] of Object.entries(\n        response.assetsBalance,\n      )) {\n        const detected: Caip19AssetId[] = [];\n\n        for (const assetId of Object.keys(\n          accountBalances as Record<string, unknown>,\n        )) {\n          // Asset is detected if it does not have metadata in state\n          if (!stateMetadata[assetId as Caip19AssetId]) {\n            detected.push(assetId as Caip19AssetId);\n          }\n        }\n\n        if (detected.length > 0) {\n          detectedAssets[accountId] = detected;\n        }\n      }\n\n      // Fill detectedAssets in the response\n      if (Object.keys(detectedAssets).length > 0) {\n        response.detectedAssets = detectedAssets;\n      }\n\n      // Call next() to continue the middleware chain\n      return next(ctx);\n    });\n  }\n}\n"]}

package/dist/middlewares/index.cjs

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

package/dist/middlewares/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/middlewares/index.ts"],"names":[],"mappings":";;;AAAA,iEAM+B;AAL7B,0HAAA,mBAAmB,OAAA","sourcesContent":["export {\n  DetectionMiddleware,\n  type DetectionMiddlewareOptions,\n  type DetectionMiddlewareMessenger,\n  type DetectionMiddlewareActions,\n  type DetectionMiddlewareGetAssetsMiddlewareAction,\n} from './DetectionMiddleware';\n"]}

package/dist/middlewares/index.d.cts

@@ -0,0 +1,2 @@
+export { DetectionMiddleware, type DetectionMiddlewareOptions, type DetectionMiddlewareMessenger, type DetectionMiddlewareActions, type DetectionMiddlewareGetAssetsMiddlewareAction, } from "./DetectionMiddleware.cjs";
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/middlewares/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,4CAA4C,GAClD,kCAA8B"}

package/dist/middlewares/index.d.mts

@@ -0,0 +1,2 @@
+export { DetectionMiddleware, type DetectionMiddlewareOptions, type DetectionMiddlewareMessenger, type DetectionMiddlewareActions, type DetectionMiddlewareGetAssetsMiddlewareAction, } from "./DetectionMiddleware.mjs";
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/middlewares/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,4CAA4C,GAClD,kCAA8B"}

package/dist/middlewares/index.mjs

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

package/dist/middlewares/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/middlewares/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EAKpB,kCAA8B","sourcesContent":["export {\n  DetectionMiddleware,\n  type DetectionMiddlewareOptions,\n  type DetectionMiddlewareMessenger,\n  type DetectionMiddlewareActions,\n  type DetectionMiddlewareGetAssetsMiddlewareAction,\n} from './DetectionMiddleware';\n"]}

package/dist/types.cjs

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.forDataTypes = void 0;
+/**
+ * Wraps a middleware to only execute if specific dataTypes are requested.
+ *
+ * @param dataTypes - DataTypes that must be in the request for middleware to run
+ * @param middleware - The middleware to conditionally execute
+ * @returns A middleware that skips execution if none of the dataTypes are requested
+ *
+ * @example
+ * ```typescript
+ * // Only runs for metadata requests
+ * const metadataMiddleware = forDataTypes(['metadata'], async (ctx, next) => {
+ *   const result = await next(ctx);
+ *   // Enrich metadata...
+ *   return result;
+ * });
+ *
+ * // Runs for balance or price requests
+ * const balanceOrPriceMiddleware = forDataTypes(['balance', 'price'], async (ctx, next) => {
+ *   const result = await next(ctx);
+ *   // Process balances or prices...
+ *   return result;
+ * });
+ * ```
+ */
+function forDataTypes(dataTypes, middleware) {
+    return async (ctx, next) => {
+        const requestedTypes = ctx.request.dataTypes;
+        const shouldRun = dataTypes.some((dt) => requestedTypes.includes(dt));
+        if (!shouldRun) {
+            return next(ctx);
+        }
+        return middleware(ctx, next);
+    };
+}
+exports.forDataTypes = forDataTypes;
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AA8YA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,YAAY,CAC1B,SAAqB,EACrB,UAAsB;IAEtB,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACzB,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC;QAC7C,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QAEtE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;QAED,OAAO,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC;AACJ,CAAC;AAdD,oCAcC","sourcesContent":["import type { InternalAccount } from '@metamask/keyring-internal-api';\nimport type { CaipAssetType, CaipChainId, Json } from '@metamask/utils';\n\n/**\n * CAIP-19 compliant asset identifier\n * Format: \"{chainId}/{assetNamespace}:{assetReference}[/tokenId]\"\n *\n * Examples:\n * - Native: \"eip155:1/slip44:60\" (ETH)\n * - ERC20: \"eip155:1/erc20:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\" (USDC)\n * - ERC721: \"eip155:1/erc721:0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D/1234\" (BAYC #1234)\n * - SPL: \"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/spl:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\"\n */\nexport type Caip19AssetId = CaipAssetType;\n\n/**\n * InternalAccount UUID from AccountsController\n * Not the blockchain address!\n */\nexport type AccountId = string;\n\n/**\n * CAIP-2 chain identifier\n */\nexport type ChainId = CaipChainId;\n\n// ============================================================================\n// ASSET TYPES - Defined by metadata structure\n// ============================================================================\n\n/**\n * Asset types define the metadata structure, not blockchain implementation.\n * - \"fungible\" includes: native, erc20, spl - all share balance, symbol, decimals\n * - \"nft\" includes: erc721, erc1155 - include tokenId, image, attributes\n */\nexport type AssetType = 'fungible' | 'nft' | 'collectible';\n\n/**\n * Token standards - blockchain implementation details\n */\nexport type TokenStandard =\n  | 'native'\n  | 'erc20'\n  | 'erc721'\n  | 'erc1155'\n  | 'spl'\n  | string;\n\n// ============================================================================\n// METADATA TYPES (vary by asset type)\n// ============================================================================\n\n/**\n * Base metadata attributes shared by ALL asset types.\n */\nexport type BaseAssetMetadata = {\n  /** Token standard - how it's implemented on the blockchain */\n  type: TokenStandard;\n  /** Display symbol (e.g., \"ETH\", \"USDC\") */\n  symbol: string;\n  /** Full name (e.g., \"Ethereum\", \"USD Coin\") */\n  name: string;\n  /** Token decimals (18 for ETH, 6 for USDC, etc.) */\n  decimals: number;\n  /** Logo URL or data URI */\n  image?: string;\n};\n\n// ============================================================================\n// TOKEN CONTRACT DATA TYPES\n// ============================================================================\n\n/** Fee information for token transfers */\nexport type TokenFees = {\n  avgFee: number;\n  maxFee: number;\n  minFee: number;\n};\n\n/** Honeypot detection status */\nexport type HoneypotStatus = {\n  honeypotIs: boolean;\n  goPlus?: boolean;\n};\n\n/** Storage slot information for the contract */\nexport type StorageSlots = {\n  balance: number;\n  approval: number;\n};\n\n/** Localized description */\nexport type LocalizedDescription = {\n  en: string;\n};\n\n// ============================================================================\n// ASSET METADATA TYPES\n// ============================================================================\n\n/**\n * Metadata for fungible tokens.\n * Structure mirrors V3AssetResponse from the Tokens API.\n *\n * Differences from V3AssetResponse:\n * - `type` is derived from assetId namespace (not in API response)\n * - `image` maps from API's `iconUrl`\n * - `assetId` is not stored (used as the key)\n */\nexport type FungibleAssetMetadata = {\n  /** Token type derived from assetId namespace */\n  type: 'native' | 'erc20' | 'spl';\n  /** CoinGecko ID for price lookups */\n  coingeckoId?: string;\n  /** Number of token list occurrences */\n  occurrences?: number;\n  /** DEX/aggregator integrations */\n  aggregators?: string[];\n  /** Asset labels/tags (e.g., \"stable_coin\") */\n  labels?: string[];\n  /** Whether the token supports ERC-20 permit */\n  erc20Permit?: boolean;\n  /** Fee information for token transfers */\n  fees?: TokenFees;\n  /** Honeypot detection status */\n  honeypotStatus?: HoneypotStatus;\n  /** Storage slot information for the contract */\n  storage?: StorageSlots;\n  /** Whether the contract is verified */\n  isContractVerified?: boolean;\n  /** Localized description */\n  description?: LocalizedDescription;\n} & BaseAssetMetadata;\n\n/**\n * Metadata for ERC721 NFTs\n * Asset Type: \"nft\"\n */\nexport type ERC721AssetMetadata = {\n  type: 'erc721';\n  decimals: 0;\n  /** Collection name */\n  collectionName?: string;\n  /** Collection size */\n  collectionSize?: number;\n  /** NFT traits/attributes - must be Json-serializable */\n  traits?: Record<string, Json>;\n  /** Rarity score */\n  rarity?: number;\n  /** Verification status */\n  verified?: boolean;\n} & BaseAssetMetadata;\n\n/**\n * Metadata for ERC1155 multi-tokens\n */\nexport type ERC1155AssetMetadata = {\n  type: 'erc1155';\n  /** Token URI */\n  tokenUri?: string;\n  /** Token category */\n  category?: string;\n  /** Spam detection flag */\n  isSpam?: boolean;\n} & BaseAssetMetadata;\n\n/**\n * Union type representing all possible asset metadata types.\n * All types must be JSON-serializable.\n */\nexport type AssetMetadata =\n  | FungibleAssetMetadata\n  | ERC721AssetMetadata\n  | ERC1155AssetMetadata\n  | (BaseAssetMetadata & { [key: string]: Json });\n\n// ============================================================================\n// PRICE TYPES (vary by asset type)\n// ============================================================================\n\n/**\n * Base price attributes.\n */\nexport type BaseAssetPrice = {\n  /** Current price in USD */\n  price: number;\n  /** Timestamp of last price update */\n  lastUpdated: number;\n};\n\n/**\n * Price data for fungible tokens (native, ERC20, SPL)\n * Matches V3SpotPricesResponse from the Price API.\n */\nexport type FungibleAssetPrice = {\n  /** CoinGecko ID */\n  id?: string;\n  /** Current price in USD */\n  price: number;\n  /** Market capitalization */\n  marketCap?: number;\n  /** All-time high price */\n  allTimeHigh?: number;\n  /** All-time low price */\n  allTimeLow?: number;\n  /** 24h trading volume */\n  totalVolume?: number;\n  /** 24h high price */\n  high1d?: number;\n  /** 24h low price */\n  low1d?: number;\n  /** Circulating supply */\n  circulatingSupply?: number;\n  /** Fully diluted market cap */\n  dilutedMarketCap?: number;\n  /** 24h market cap change percentage */\n  marketCapPercentChange1d?: number;\n  /** 24h price change in USD */\n  priceChange1d?: number;\n  /** 1h price change percentage */\n  pricePercentChange1h?: number;\n  /** 24h price change percentage */\n  pricePercentChange1d?: number;\n  /** 7d price change percentage */\n  pricePercentChange7d?: number;\n  /** 14d price change percentage */\n  pricePercentChange14d?: number;\n  /** 30d price change percentage */\n  pricePercentChange30d?: number;\n  /** 200d price change percentage */\n  pricePercentChange200d?: number;\n  /** 1y price change percentage */\n  pricePercentChange1y?: number;\n  /** Timestamp of last price update (added by client) */\n  lastUpdated: number;\n};\n\n/**\n * Price data for NFT collections\n */\nexport type NFTAssetPrice = {\n  /** Floor price */\n  floorPrice?: number;\n  /** Last sale price */\n  lastSalePrice?: number;\n  /** Collection trading volume */\n  collectionVolume?: number;\n  /** Average price */\n  averagePrice?: number;\n  /** Number of sales in 24h */\n  sales24h?: number;\n} & BaseAssetPrice;\n\n/**\n * Union type representing all possible asset price types.\n * All types must be JSON-serializable.\n */\nexport type AssetPrice =\n  | FungibleAssetPrice\n  | NFTAssetPrice\n  | (BaseAssetPrice & { [key: string]: Json });\n\n// ============================================================================\n// BALANCE TYPES (vary by asset type)\n// ============================================================================\n\n/**\n * Balance data for fungible tokens (native, ERC20, SPL).\n */\nexport type FungibleAssetBalance = {\n  /** Raw balance amount as string (e.g., \"1000000000\" for 1000 USDC) */\n  amount: string;\n};\n\n/**\n * Balance data for ERC721 NFTs.\n * Each tokenId has its own CAIP-19 asset ID, so always \"1\".\n */\nexport type ERC721AssetBalance = {\n  /** Always \"1\" for ERC721 (non-fungible) */\n  amount: '1';\n};\n\n/**\n * Balance data for ERC1155 multi-tokens.\n */\nexport type ERC1155AssetBalance = {\n  /** Quantity owned of this specific tokenId */\n  amount: string;\n};\n\n/**\n * Union type representing all possible asset balance types.\n * All types must be JSON-serializable.\n */\nexport type AssetBalance =\n  | FungibleAssetBalance\n  | ERC721AssetBalance\n  | ERC1155AssetBalance\n  | { amount: string; [key: string]: Json };\n\n// ============================================================================\n// DATA SOURCE TYPES\n// ============================================================================\n\n/**\n * Data type dimension - what kind of data\n */\nexport type DataType = 'balance' | 'metadata' | 'price';\n\n/**\n * Request for data from data sources\n */\nexport type DataRequest = {\n  /** Accounts to fetch data for */\n  accounts: InternalAccount[];\n  /** CAIP-2 chain IDs */\n  chainIds: ChainId[];\n  /** Filter by asset types */\n  assetTypes?: AssetType[];\n  /** Which data to fetch */\n  dataTypes: DataType[];\n  /** Specific CAIP-19 asset IDs */\n  customAssets?: Caip19AssetId[];\n  /** Force fresh fetch, bypass cache */\n  forceUpdate?: boolean;\n  /** Hint for polling interval (ms) - used by data sources that implement polling */\n  updateInterval?: number;\n};\n\n/**\n * Response from data sources\n */\nexport type DataResponse = {\n  /** Metadata for assets (shared across accounts) */\n  assetsMetadata?: Record<Caip19AssetId, AssetMetadata>;\n  /** Price data for assets (shared across accounts) */\n  assetsPrice?: Record<Caip19AssetId, AssetPrice>;\n  /** Balance data per account */\n  assetsBalance?: Record<AccountId, Record<Caip19AssetId, AssetBalance>>;\n  /** Errors encountered, keyed by chain ID */\n  errors?: Record<ChainId, string>;\n  /** Detected assets (assets that do not have metadata) */\n  detectedAssets?: Record<AccountId, Caip19AssetId[]>;\n};\n\n// ============================================================================\n// UNIFIED MIDDLEWARE TYPES\n// ============================================================================\n\n/**\n * Internal state structure for AssetsController following normalized design.\n *\n * Keys use CAIP identifiers:\n * - assetsMetadata keys: CAIP-19 asset IDs (e.g., \"eip155:1/erc20:0x...\")\n * - assetsBalance outer keys: Account IDs (InternalAccount.id UUIDs)\n * - assetsBalance inner keys: CAIP-19 asset IDs\n * - assetsPrice keys: CAIP-19 asset IDs\n * - customAssets outer keys: Account IDs (InternalAccount.id UUIDs)\n * - customAssets inner values: CAIP-19 asset IDs array\n */\nexport type AssetsControllerStateInternal = {\n  /** Shared metadata for all assets (stored once per asset) */\n  assetsMetadata: Record<Caip19AssetId, AssetMetadata>;\n  /** Per-account balance data */\n  assetsBalance: Record<AccountId, Record<Caip19AssetId, AssetBalance>>;\n  /** Price data for assets */\n  assetsPrice: Record<Caip19AssetId, AssetPrice>;\n  /** Custom assets added by users per account */\n  customAssets: Record<AccountId, Caip19AssetId[]>;\n};\n\n/**\n * Base context for all middleware operations.\n * Contains the common interface shared by fetch and subscribe.\n */\nexport type Context = {\n  /** The data request */\n  request: DataRequest;\n  /** The response data (mutated by middlewares) */\n  response: DataResponse;\n  /** Get current assets state */\n  getAssetsState: () => AssetsControllerStateInternal;\n};\n\n/**\n * Next function for middleware chain\n */\nexport type NextFunction = (context: Context) => Promise<Context>;\n\n/**\n * Middleware function - works for both fetch and subscribe operations.\n */\nexport type Middleware = (\n  context: Context,\n  next: NextFunction,\n) => Promise<Context>;\n\n/**\n * Wraps a middleware to only execute if specific dataTypes are requested.\n *\n * @param dataTypes - DataTypes that must be in the request for middleware to run\n * @param middleware - The middleware to conditionally execute\n * @returns A middleware that skips execution if none of the dataTypes are requested\n *\n * @example\n * ```typescript\n * // Only runs for metadata requests\n * const metadataMiddleware = forDataTypes(['metadata'], async (ctx, next) => {\n *   const result = await next(ctx);\n *   // Enrich metadata...\n *   return result;\n * });\n *\n * // Runs for balance or price requests\n * const balanceOrPriceMiddleware = forDataTypes(['balance', 'price'], async (ctx, next) => {\n *   const result = await next(ctx);\n *   // Process balances or prices...\n *   return result;\n * });\n * ```\n */\nexport function forDataTypes(\n  dataTypes: DataType[],\n  middleware: Middleware,\n): Middleware {\n  return async (ctx, next) => {\n    const requestedTypes = ctx.request.dataTypes;\n    const shouldRun = dataTypes.some((dt) => requestedTypes.includes(dt));\n\n    if (!shouldRun) {\n      return next(ctx);\n    }\n\n    return middleware(ctx, next);\n  };\n}\n\n/**\n * Context for fetch operations.\n * Extends base Context - no additional fields needed for fetch.\n */\nexport type FetchContext = Context;\n\n// Legacy aliases for backwards compatibility\nexport type FetchNextFunction = NextFunction;\nexport type FetchMiddleware = Middleware;\n\n/**\n * Data source ID.\n *\n * Data sources follow a standard messenger pattern:\n * - `${id}:getActiveChains` - action to get active chains\n * - `${id}:activeChainsUpdated` - event when chains change\n *\n * Registration order determines subscription order.\n */\nexport type DataSourceDefinition = string;\n\n/**\n * Registered data source\n */\nexport type RegisteredDataSource = DataSourceDefinition;\n\n/**\n * Subscription response\n */\nexport type SubscriptionResponse = {\n  /** Chains actively subscribed */\n  chains: ChainId[];\n  /** Account ID being watched */\n  accountId: AccountId;\n  /** Asset types being watched */\n  assetTypes: AssetType[];\n  /** Data types being kept fresh */\n  dataTypes: DataType[];\n  /** Cleanup function */\n  unsubscribe: () => void;\n};\n\n// ============================================================================\n// COMBINED ASSET TYPE (for UI)\n// ============================================================================\n\n/**\n * Combined asset type matching state structure: balance, metadata, price\n */\nexport type Asset = {\n  /** CAIP-19 asset ID */\n  id: Caip19AssetId;\n  /** CAIP-2 chain ID (extracted from id) */\n  chainId: ChainId;\n  /** Balance data */\n  balance: AssetBalance;\n  /** Metadata (symbol, name, decimals, etc.) */\n  metadata: AssetMetadata;\n  /** Price data */\n  price: AssetPrice;\n  /** Computed fiat value (balance × price) */\n  fiatValue: number;\n};\n\n// ============================================================================\n// EVENT TYPES\n// ============================================================================\n\n/**\n * Event emitted when balances change\n */\nexport type BalanceChangeEvent = {\n  accountId: AccountId;\n  assetId: Caip19AssetId;\n  previousAmount: string;\n  newAmount: string;\n  timestamp: number;\n};\n\n/**\n * Event emitted when prices change\n */\nexport type PriceChangeEvent = {\n  assetIds: Caip19AssetId[];\n  timestamp: number;\n};\n\n/**\n * Event emitted when metadata changes\n */\nexport type MetadataChangeEvent = {\n  assetId: Caip19AssetId;\n  changes: Partial<AssetMetadata>;\n};\n\n/**\n * Event emitted when assets without metadata are detected\n */\nexport type AssetsDetectedEvent = {\n  accountId: AccountId;\n  assetIds: Caip19AssetId[];\n};\n"]}