@metamask/assets-controller 9.0.2 → 10.0.0

package/dist/utils/dedupingBatchFetcher.mjs

@@ -0,0 +1,164 @@
+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 _DedupingBatchFetcher_instances, _DedupingBatchFetcher_fetchBatch, _DedupingBatchFetcher_freshnessTtlMs, _DedupingBatchFetcher_fetchedAt, _DedupingBatchFetcher_inflight, _DedupingBatchFetcher_partition, _DedupingBatchFetcher_isFresh, _DedupingBatchFetcher_startBatchFetch, _DedupingBatchFetcher_joinInflight;
+/**
+ * Deduplicates batched fetches by key across two dimensions:
+ *
+ * 1. **Freshness TTL** — keys fetched within `freshnessTtlMs` are skipped
+ *    entirely. Note the freshness window only starts once a fetch *completes*,
+ *    so it does not cover requests that are still in flight.
+ * 2. **Inflight coalescing** — if a fetch is already in progress for a key,
+ *    concurrent callers join the existing promise instead of issuing a new
+ *    request. This covers the request-in-flight window the freshness TTL
+ *    structurally cannot.
+ *
+ * Both layers are per-key, so a call for a partially-overlapping set of keys
+ * reuses the fresh/inflight keys and only fetches the genuinely-missing ones.
+ *
+ * The fetch is batched: all stale, not-inflight keys from a single `fetch()`
+ * call are passed to `fetchBatch` together, then split into per-key results so
+ * each key can be joined independently.
+ */
+export class DedupingBatchFetcher {
+    constructor(options) {
+        _DedupingBatchFetcher_instances.add(this);
+        _DedupingBatchFetcher_fetchBatch.set(this, void 0);
+        _DedupingBatchFetcher_freshnessTtlMs.set(this, void 0);
+        /** Tracks the last successful fetch time per key (freshness gating). */
+        _DedupingBatchFetcher_fetchedAt.set(this, new Map());
+        /**
+         * Per-key inflight fetch promises. Each resolves to the value, or `undefined`
+         * if the batch failed or returned no data for that key.
+         */
+        _DedupingBatchFetcher_inflight.set(this, new Map());
+        __classPrivateFieldSet(this, _DedupingBatchFetcher_fetchBatch, options.fetchBatch, "f");
+        __classPrivateFieldSet(this, _DedupingBatchFetcher_freshnessTtlMs, options.freshnessTtlMs, "f");
+    }
+    /**
+     * Minimum age (ms) before a key is re-fetched.
+     *
+     * @returns The current freshness TTL in milliseconds.
+     */
+    get freshnessTtlMs() {
+        return __classPrivateFieldGet(this, _DedupingBatchFetcher_freshnessTtlMs, "f");
+    }
+    set freshnessTtlMs(ms) {
+        __classPrivateFieldSet(this, _DedupingBatchFetcher_freshnessTtlMs, ms, "f");
+    }
+    /**
+     * Fetch values for the given keys, deduplicating against fresh and inflight
+     * fetches.
+     *
+     * @param keys - The keys to fetch.
+     * @returns Values keyed by key. Only contains entries for keys that were
+     * actually fetched (or joined from inflight) and had a value.
+     */
+    async fetch(keys) {
+        const { staleKeys, inflightKeys } = __classPrivateFieldGet(this, _DedupingBatchFetcher_instances, "m", _DedupingBatchFetcher_partition).call(this, keys);
+        if (staleKeys.length === 0 && inflightKeys.length === 0) {
+            return {};
+        }
+        // Start a fetch for stale keys and join any fetches already in progress.
+        const batchPromise = staleKeys.length > 0 ? __classPrivateFieldGet(this, _DedupingBatchFetcher_instances, "m", _DedupingBatchFetcher_startBatchFetch).call(this, staleKeys) : undefined;
+        const values = await __classPrivateFieldGet(this, _DedupingBatchFetcher_instances, "m", _DedupingBatchFetcher_joinInflight).call(this, inflightKeys);
+        if (batchPromise) {
+            Object.assign(values, await batchPromise);
+        }
+        return values;
+    }
+    /**
+     * Clear the freshness cache, forcing the next fetch to re-request every key
+     * regardless of TTL. Does not affect inflight fetches.
+     */
+    invalidate() {
+        __classPrivateFieldGet(this, _DedupingBatchFetcher_fetchedAt, "f").clear();
+    }
+    /**
+     * Clear freshness for specific keys only, forcing the next fetch to
+     * re-request those keys regardless of TTL. Does not affect inflight fetches.
+     *
+     * @param keys - Keys to mark stale.
+     */
+    invalidateKeys(keys) {
+        for (const key of keys) {
+            __classPrivateFieldGet(this, _DedupingBatchFetcher_fetchedAt, "f").delete(key);
+        }
+    }
+    /** Clear all freshness and inflight state. */
+    destroy() {
+        __classPrivateFieldGet(this, _DedupingBatchFetcher_fetchedAt, "f").clear();
+        __classPrivateFieldGet(this, _DedupingBatchFetcher_inflight, "f").clear();
+    }
+}
+_DedupingBatchFetcher_fetchBatch = new WeakMap(), _DedupingBatchFetcher_freshnessTtlMs = new WeakMap(), _DedupingBatchFetcher_fetchedAt = new WeakMap(), _DedupingBatchFetcher_inflight = new WeakMap(), _DedupingBatchFetcher_instances = new WeakSet(), _DedupingBatchFetcher_partition = function _DedupingBatchFetcher_partition(keys) {
+    const now = Date.now();
+    const staleKeys = [];
+    const inflightKeys = [];
+    for (const key of keys) {
+        if (__classPrivateFieldGet(this, _DedupingBatchFetcher_instances, "m", _DedupingBatchFetcher_isFresh).call(this, key, now)) {
+            continue;
+        }
+        if (__classPrivateFieldGet(this, _DedupingBatchFetcher_inflight, "f").has(key)) {
+            inflightKeys.push(key);
+        }
+        else {
+            staleKeys.push(key);
+        }
+    }
+    return { staleKeys, inflightKeys };
+}, _DedupingBatchFetcher_isFresh = function _DedupingBatchFetcher_isFresh(key, now) {
+    const fetchedAt = __classPrivateFieldGet(this, _DedupingBatchFetcher_fetchedAt, "f").get(key);
+    return fetchedAt !== undefined && now - fetchedAt < __classPrivateFieldGet(this, _DedupingBatchFetcher_freshnessTtlMs, "f");
+}, _DedupingBatchFetcher_startBatchFetch = function _DedupingBatchFetcher_startBatchFetch(staleKeys) {
+    const batchPromise = __classPrivateFieldGet(this, _DedupingBatchFetcher_fetchBatch, "f").call(this, staleKeys).then((values) => {
+        const fetchedAt = Date.now();
+        for (const key of staleKeys) {
+            __classPrivateFieldGet(this, _DedupingBatchFetcher_fetchedAt, "f").set(key, fetchedAt);
+        }
+        return values;
+    });
+    for (const key of staleKeys) {
+        const perKey = batchPromise.then((values) => values[key], () => undefined);
+        __classPrivateFieldGet(this, _DedupingBatchFetcher_inflight, "f").set(key, perKey);
+    }
+    // Clean up inflight entries once the batch settles (success or failure).
+    // Rejection is already surfaced to the caller via the returned batchPromise.
+    batchPromise
+        .finally(() => {
+        for (const key of staleKeys) {
+            __classPrivateFieldGet(this, _DedupingBatchFetcher_inflight, "f").delete(key);
+        }
+    })
+        .catch(() => undefined);
+    return batchPromise;
+}, _DedupingBatchFetcher_joinInflight = 
+/**
+ * Join the inflight fetches for the given keys and collect their values. Keys
+ * whose inflight fetch produced no value are omitted.
+ *
+ * @param inflightKeys - Keys whose fetches are already in progress.
+ * @returns Values keyed by key.
+ */
+async function _DedupingBatchFetcher_joinInflight(inflightKeys) {
+    const values = {};
+    const results = await Promise.all(inflightKeys.map(async (key) => {
+        const value = await __classPrivateFieldGet(this, _DedupingBatchFetcher_inflight, "f").get(key);
+        return [key, value];
+    }));
+    for (const [key, value] of results) {
+        if (value !== undefined) {
+            values[key] = value;
+        }
+    }
+    return values;
+};
+//# sourceMappingURL=dedupingBatchFetcher.mjs.map

package/dist/utils/dedupingBatchFetcher.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupingBatchFetcher.mjs","sourceRoot":"","sources":["../../src/utils/dedupingBatchFetcher.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Executes the underlying batched fetch for a set of keys. Only keys that have\n * a value need to be present in the returned record; keys the source had no\n * data for are simply omitted (they are still marked fresh — see\n * {@link DedupingBatchFetcher.fetch}).\n *\n * @param keys - The keys to fetch (already filtered to stale, not-inflight keys).\n * @returns The fetched values keyed by key.\n */\nexport type BatchFetchFn<Key extends string, Value> = (\n  keys: Key[],\n) => Promise<Record<Key, Value>>;\n\nexport type DedupingBatchFetcherOptions<Key extends string, Value> = {\n  /** Performs the actual batched fetch for stale, not-inflight keys. */\n  fetchBatch: BatchFetchFn<Key, Value>;\n  /**\n   * Minimum age (ms) before a key is considered stale and re-fetched. Keys\n   * fetched more recently than this are skipped entirely.\n   */\n  freshnessTtlMs: number;\n};\n\n/**\n * Deduplicates batched fetches by key across two dimensions:\n *\n * 1. **Freshness TTL** — keys fetched within `freshnessTtlMs` are skipped\n *    entirely. Note the freshness window only starts once a fetch *completes*,\n *    so it does not cover requests that are still in flight.\n * 2. **Inflight coalescing** — if a fetch is already in progress for a key,\n *    concurrent callers join the existing promise instead of issuing a new\n *    request. This covers the request-in-flight window the freshness TTL\n *    structurally cannot.\n *\n * Both layers are per-key, so a call for a partially-overlapping set of keys\n * reuses the fresh/inflight keys and only fetches the genuinely-missing ones.\n *\n * The fetch is batched: all stale, not-inflight keys from a single `fetch()`\n * call are passed to `fetchBatch` together, then split into per-key results so\n * each key can be joined independently.\n */\nexport class DedupingBatchFetcher<Key extends string, Value> {\n  readonly #fetchBatch: BatchFetchFn<Key, Value>;\n\n  #freshnessTtlMs: number;\n\n  /** Tracks the last successful fetch time per key (freshness gating). */\n  readonly #fetchedAt = new Map<Key, number>();\n\n  /**\n   * Per-key inflight fetch promises. Each resolves to the value, or `undefined`\n   * if the batch failed or returned no data for that key.\n   */\n  readonly #inflight = new Map<Key, Promise<Value | undefined>>();\n\n  constructor(options: DedupingBatchFetcherOptions<Key, Value>) {\n    this.#fetchBatch = options.fetchBatch;\n    this.#freshnessTtlMs = options.freshnessTtlMs;\n  }\n\n  /**\n   * Minimum age (ms) before a key is re-fetched.\n   *\n   * @returns The current freshness TTL in milliseconds.\n   */\n  get freshnessTtlMs(): number {\n    return this.#freshnessTtlMs;\n  }\n\n  set freshnessTtlMs(ms: number) {\n    this.#freshnessTtlMs = ms;\n  }\n\n  /**\n   * Fetch values for the given keys, deduplicating against fresh and inflight\n   * fetches.\n   *\n   * @param keys - The keys to fetch.\n   * @returns Values keyed by key. Only contains entries for keys that were\n   * actually fetched (or joined from inflight) and had a value.\n   */\n  async fetch(keys: Key[]): Promise<Record<Key, Value>> {\n    const { staleKeys, inflightKeys } = this.#partition(keys);\n\n    if (staleKeys.length === 0 && inflightKeys.length === 0) {\n      return {} as Record<Key, Value>;\n    }\n\n    // Start a fetch for stale keys and join any fetches already in progress.\n    const batchPromise =\n      staleKeys.length > 0 ? this.#startBatchFetch(staleKeys) : undefined;\n    const values = await this.#joinInflight(inflightKeys);\n\n    if (batchPromise) {\n      Object.assign(values, await batchPromise);\n    }\n\n    return values;\n  }\n\n  /**\n   * Clear the freshness cache, forcing the next fetch to re-request every key\n   * regardless of TTL. Does not affect inflight fetches.\n   */\n  invalidate(): void {\n    this.#fetchedAt.clear();\n  }\n\n  /**\n   * Clear freshness for specific keys only, forcing the next fetch to\n   * re-request those keys regardless of TTL. Does not affect inflight fetches.\n   *\n   * @param keys - Keys to mark stale.\n   */\n  invalidateKeys(keys: Key[]): void {\n    for (const key of keys) {\n      this.#fetchedAt.delete(key);\n    }\n  }\n\n  /** Clear all freshness and inflight state. */\n  destroy(): void {\n    this.#fetchedAt.clear();\n    this.#inflight.clear();\n  }\n\n  /**\n   * Split keys into those that need a fresh fetch and those already being\n   * fetched by another caller. Keys still within the freshness TTL are dropped.\n   *\n   * @param keys - The keys to classify.\n   * @returns `staleKeys` (need fetching) and `inflightKeys` (join existing fetch).\n   */\n  #partition(keys: Key[]): { staleKeys: Key[]; inflightKeys: Key[] } {\n    const now = Date.now();\n    const staleKeys: Key[] = [];\n    const inflightKeys: Key[] = [];\n\n    for (const key of keys) {\n      if (this.#isFresh(key, now)) {\n        continue;\n      }\n      if (this.#inflight.has(key)) {\n        inflightKeys.push(key);\n      } else {\n        staleKeys.push(key);\n      }\n    }\n\n    return { staleKeys, inflightKeys };\n  }\n\n  /**\n   * Returns true if the key's last fetch is still within the freshness TTL.\n   *\n   * @param key - The key to check.\n   * @param now - Current timestamp (avoids repeated clock reads).\n   * @returns True if the key was fetched within the freshness TTL.\n   */\n  #isFresh(key: Key, now: number): boolean {\n    const fetchedAt = this.#fetchedAt.get(key);\n    return fetchedAt !== undefined && now - fetchedAt < this.#freshnessTtlMs;\n  }\n\n  /**\n   * Launch a batch fetch and register a per-key inflight promise for each key\n   * so concurrent callers can join. On success, all requested keys are marked\n   * fresh — including keys the source returned no value for, since the absence\n   * of a value is itself a valid answer that should not be re-asked until the\n   * TTL expires. A failed batch leaves keys stale so they are retried.\n   *\n   * @param staleKeys - Keys to fetch (none of which are already inflight).\n   * @returns The batch fetch promise.\n   */\n  #startBatchFetch(staleKeys: Key[]): Promise<Record<Key, Value>> {\n    const batchPromise = this.#fetchBatch(staleKeys).then((values) => {\n      const fetchedAt = Date.now();\n      for (const key of staleKeys) {\n        this.#fetchedAt.set(key, fetchedAt);\n      }\n      return values;\n    });\n\n    for (const key of staleKeys) {\n      const perKey = batchPromise.then(\n        (values) => values[key],\n        () => undefined,\n      );\n      this.#inflight.set(key, perKey);\n    }\n\n    // Clean up inflight entries once the batch settles (success or failure).\n    // Rejection is already surfaced to the caller via the returned batchPromise.\n    batchPromise\n      .finally(() => {\n        for (const key of staleKeys) {\n          this.#inflight.delete(key);\n        }\n      })\n      .catch(() => undefined);\n\n    return batchPromise;\n  }\n\n  /**\n   * Join the inflight fetches for the given keys and collect their values. Keys\n   * whose inflight fetch produced no value are omitted.\n   *\n   * @param inflightKeys - Keys whose fetches are already in progress.\n   * @returns Values keyed by key.\n   */\n  async #joinInflight(inflightKeys: Key[]): Promise<Record<Key, Value>> {\n    const values = {} as Record<Key, Value>;\n\n    const results = await Promise.all(\n      inflightKeys.map(async (key) => {\n        const value = await this.#inflight.get(key);\n        return [key, value] as const;\n      }),\n    );\n\n    for (const [key, value] of results) {\n      if (value !== undefined) {\n        values[key] = value;\n      }\n    }\n\n    return values;\n  }\n}\n"]}

package/dist/utils/processAccountActivityBalanceUpdates.cjs

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processAccountActivityBalanceUpdates = void 0;
+const bignumber_js_1 = __importDefault(require("bignumber.js"));
+/**
+ * Convert AccountActivityMessage balance updates into a {@link DataResponse}
+ * for AssetsController (same shape as BackendWebsocketDataSource).
+ *
+ * @param updates - Balance updates from account-activity websocket payload.
+ * @param accountId - Internal account UUID.
+ * @param getAssetType - Resolver for asset metadata type.
+ * @returns DataResponse with merge mode when balances are present.
+ */
+function processAccountActivityBalanceUpdates(updates, accountId, getAssetType) {
+    const assetsBalance = Object.create(null);
+    assetsBalance[accountId] = Object.create(null);
+    const assetsMetadata = Object.create(null);
+    for (const update of updates) {
+        const { asset, postBalance } = update;
+        if (!asset || !postBalance) {
+            continue;
+        }
+        const assetId = asset.type;
+        if (asset.decimals === undefined) {
+            continue;
+        }
+        const rawBalanceStr = postBalance.amount.startsWith('0x')
+            ? BigInt(postBalance.amount).toString()
+            : postBalance.amount;
+        const humanReadableAmount = new bignumber_js_1.default(rawBalanceStr)
+            .dividedBy(new bignumber_js_1.default(10).pow(asset.decimals))
+            .toFixed();
+        assetsBalance[accountId][assetId] = {
+            amount: humanReadableAmount,
+        };
+        assetsMetadata[assetId] = {
+            type: getAssetType(assetId),
+            symbol: asset.unit,
+            name: asset.unit,
+            decimals: asset.decimals,
+        };
+    }
+    const response = { updateMode: 'merge' };
+    if (Object.keys(assetsBalance[accountId]).length > 0) {
+        response.assetsBalance = assetsBalance;
+        response.assetsInfo = assetsMetadata;
+    }
+    return response;
+}
+exports.processAccountActivityBalanceUpdates = processAccountActivityBalanceUpdates;
+//# sourceMappingURL=processAccountActivityBalanceUpdates.cjs.map

package/dist/utils/processAccountActivityBalanceUpdates.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"processAccountActivityBalanceUpdates.cjs","sourceRoot":"","sources":["../../src/utils/processAccountActivityBalanceUpdates.ts"],"names":[],"mappings":";;;;;;AACA,gEAAuC;AASvC;;;;;;;;GAQG;AACH,SAAgB,oCAAoC,CAClD,OAAwB,EACxB,SAAiB,EACjB,YAAoE;IAEpE,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAGvC,CAAC;IACF,aAAa,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAG5C,CAAC;IACF,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAGxC,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;QAEtC,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAqB,CAAC;QAE5C,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QAED,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;YACvD,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;YACvC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC;QAEvB,MAAM,mBAAmB,GAAG,IAAI,sBAAW,CAAC,aAAa,CAAC;aACvD,SAAS,CAAC,IAAI,sBAAW,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;aAClD,OAAO,EAAE,CAAC;QAEb,aAAa,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,GAAG;YAClC,MAAM,EAAE,mBAAmB;SAC5B,CAAC;QAEF,cAAc,CAAC,OAAO,CAAC,GAAG;YACxB,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC;YAC3B,MAAM,EAAE,KAAK,CAAC,IAAI;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAiB,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;IACvD,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,QAAQ,CAAC,aAAa,GAAG,aAAa,CAAC;QACvC,QAAQ,CAAC,UAAU,GAAG,cAAc,CAAC;IACvC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AA1DD,oFA0DC","sourcesContent":["import type { BalanceUpdate } from '@metamask/core-backend';\nimport BigNumberJS from 'bignumber.js';\n\nimport type {\n  AssetBalance,\n  AssetMetadata,\n  Caip19AssetId,\n  DataResponse,\n} from '../types';\n\n/**\n * Convert AccountActivityMessage balance updates into a {@link DataResponse}\n * for AssetsController (same shape as BackendWebsocketDataSource).\n *\n * @param updates - Balance updates from account-activity websocket payload.\n * @param accountId - Internal account UUID.\n * @param getAssetType - Resolver for asset metadata type.\n * @returns DataResponse with merge mode when balances are present.\n */\nexport function processAccountActivityBalanceUpdates(\n  updates: BalanceUpdate[],\n  accountId: string,\n  getAssetType: (assetId: Caip19AssetId) => 'native' | 'erc20' | 'spl',\n): DataResponse {\n  const assetsBalance = Object.create(null) as Record<\n    string,\n    Record<Caip19AssetId, AssetBalance>\n  >;\n  assetsBalance[accountId] = Object.create(null) as Record<\n    Caip19AssetId,\n    AssetBalance\n  >;\n  const assetsMetadata = Object.create(null) as Record<\n    Caip19AssetId,\n    AssetMetadata\n  >;\n\n  for (const update of updates) {\n    const { asset, postBalance } = update;\n\n    if (!asset || !postBalance) {\n      continue;\n    }\n\n    const assetId = asset.type as Caip19AssetId;\n\n    if (asset.decimals === undefined) {\n      continue;\n    }\n\n    const rawBalanceStr = postBalance.amount.startsWith('0x')\n      ? BigInt(postBalance.amount).toString()\n      : postBalance.amount;\n\n    const humanReadableAmount = new BigNumberJS(rawBalanceStr)\n      .dividedBy(new BigNumberJS(10).pow(asset.decimals))\n      .toFixed();\n\n    assetsBalance[accountId][assetId] = {\n      amount: humanReadableAmount,\n    };\n\n    assetsMetadata[assetId] = {\n      type: getAssetType(assetId),\n      symbol: asset.unit,\n      name: asset.unit,\n      decimals: asset.decimals,\n    };\n  }\n\n  const response: DataResponse = { updateMode: 'merge' };\n  if (Object.keys(assetsBalance[accountId]).length > 0) {\n    response.assetsBalance = assetsBalance;\n    response.assetsInfo = assetsMetadata;\n  }\n\n  return response;\n}\n"]}

package/dist/utils/processAccountActivityBalanceUpdates.d.cts

@@ -0,0 +1,13 @@
+import type { BalanceUpdate } from "@metamask/core-backend";
+import type { Caip19AssetId, DataResponse } from "../types.cjs";
+/**
+ * Convert AccountActivityMessage balance updates into a {@link DataResponse}
+ * for AssetsController (same shape as BackendWebsocketDataSource).
+ *
+ * @param updates - Balance updates from account-activity websocket payload.
+ * @param accountId - Internal account UUID.
+ * @param getAssetType - Resolver for asset metadata type.
+ * @returns DataResponse with merge mode when balances are present.
+ */
+export declare function processAccountActivityBalanceUpdates(updates: BalanceUpdate[], accountId: string, getAssetType: (assetId: Caip19AssetId) => 'native' | 'erc20' | 'spl'): DataResponse;
+//# sourceMappingURL=processAccountActivityBalanceUpdates.d.cts.map

package/dist/utils/processAccountActivityBalanceUpdates.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processAccountActivityBalanceUpdates.d.cts","sourceRoot":"","sources":["../../src/utils/processAccountActivityBalanceUpdates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,+BAA+B;AAG5D,OAAO,KAAK,EAGV,aAAa,EACb,YAAY,EACb,qBAAiB;AAElB;;;;;;;;GAQG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,aAAa,EAAE,EACxB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,QAAQ,GAAG,OAAO,GAAG,KAAK,GACnE,YAAY,CAsDd"}

package/dist/utils/processAccountActivityBalanceUpdates.d.mts

@@ -0,0 +1,13 @@
+import type { BalanceUpdate } from "@metamask/core-backend";
+import type { Caip19AssetId, DataResponse } from "../types.mjs";
+/**
+ * Convert AccountActivityMessage balance updates into a {@link DataResponse}
+ * for AssetsController (same shape as BackendWebsocketDataSource).
+ *
+ * @param updates - Balance updates from account-activity websocket payload.
+ * @param accountId - Internal account UUID.
+ * @param getAssetType - Resolver for asset metadata type.
+ * @returns DataResponse with merge mode when balances are present.
+ */
+export declare function processAccountActivityBalanceUpdates(updates: BalanceUpdate[], accountId: string, getAssetType: (assetId: Caip19AssetId) => 'native' | 'erc20' | 'spl'): DataResponse;
+//# sourceMappingURL=processAccountActivityBalanceUpdates.d.mts.map

package/dist/utils/processAccountActivityBalanceUpdates.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processAccountActivityBalanceUpdates.d.mts","sourceRoot":"","sources":["../../src/utils/processAccountActivityBalanceUpdates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,+BAA+B;AAG5D,OAAO,KAAK,EAGV,aAAa,EACb,YAAY,EACb,qBAAiB;AAElB;;;;;;;;GAQG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,aAAa,EAAE,EACxB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,QAAQ,GAAG,OAAO,GAAG,KAAK,GACnE,YAAY,CAsDd"}

package/dist/utils/processAccountActivityBalanceUpdates.mjs

@@ -0,0 +1,47 @@
+import BigNumberJS from "bignumber.js";
+/**
+ * Convert AccountActivityMessage balance updates into a {@link DataResponse}
+ * for AssetsController (same shape as BackendWebsocketDataSource).
+ *
+ * @param updates - Balance updates from account-activity websocket payload.
+ * @param accountId - Internal account UUID.
+ * @param getAssetType - Resolver for asset metadata type.
+ * @returns DataResponse with merge mode when balances are present.
+ */
+export function processAccountActivityBalanceUpdates(updates, accountId, getAssetType) {
+    const assetsBalance = Object.create(null);
+    assetsBalance[accountId] = Object.create(null);
+    const assetsMetadata = Object.create(null);
+    for (const update of updates) {
+        const { asset, postBalance } = update;
+        if (!asset || !postBalance) {
+            continue;
+        }
+        const assetId = asset.type;
+        if (asset.decimals === undefined) {
+            continue;
+        }
+        const rawBalanceStr = postBalance.amount.startsWith('0x')
+            ? BigInt(postBalance.amount).toString()
+            : postBalance.amount;
+        const humanReadableAmount = new BigNumberJS(rawBalanceStr)
+            .dividedBy(new BigNumberJS(10).pow(asset.decimals))
+            .toFixed();
+        assetsBalance[accountId][assetId] = {
+            amount: humanReadableAmount,
+        };
+        assetsMetadata[assetId] = {
+            type: getAssetType(assetId),
+            symbol: asset.unit,
+            name: asset.unit,
+            decimals: asset.decimals,
+        };
+    }
+    const response = { updateMode: 'merge' };
+    if (Object.keys(assetsBalance[accountId]).length > 0) {
+        response.assetsBalance = assetsBalance;
+        response.assetsInfo = assetsMetadata;
+    }
+    return response;
+}
+//# sourceMappingURL=processAccountActivityBalanceUpdates.mjs.map

package/dist/utils/processAccountActivityBalanceUpdates.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"processAccountActivityBalanceUpdates.mjs","sourceRoot":"","sources":["../../src/utils/processAccountActivityBalanceUpdates.ts"],"names":[],"mappings":"AACA,OAAO,WAAW,qBAAqB;AASvC;;;;;;;;GAQG;AACH,MAAM,UAAU,oCAAoC,CAClD,OAAwB,EACxB,SAAiB,EACjB,YAAoE;IAEpE,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAGvC,CAAC;IACF,aAAa,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAG5C,CAAC;IACF,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAGxC,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;QAEtC,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAqB,CAAC;QAE5C,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QAED,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;YACvD,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;YACvC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC;QAEvB,MAAM,mBAAmB,GAAG,IAAI,WAAW,CAAC,aAAa,CAAC;aACvD,SAAS,CAAC,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;aAClD,OAAO,EAAE,CAAC;QAEb,aAAa,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,GAAG;YAClC,MAAM,EAAE,mBAAmB;SAC5B,CAAC;QAEF,cAAc,CAAC,OAAO,CAAC,GAAG;YACxB,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC;YAC3B,MAAM,EAAE,KAAK,CAAC,IAAI;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAiB,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;IACvD,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,QAAQ,CAAC,aAAa,GAAG,aAAa,CAAC;QACvC,QAAQ,CAAC,UAAU,GAAG,cAAc,CAAC;IACvC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import type { BalanceUpdate } from '@metamask/core-backend';\nimport BigNumberJS from 'bignumber.js';\n\nimport type {\n  AssetBalance,\n  AssetMetadata,\n  Caip19AssetId,\n  DataResponse,\n} from '../types';\n\n/**\n * Convert AccountActivityMessage balance updates into a {@link DataResponse}\n * for AssetsController (same shape as BackendWebsocketDataSource).\n *\n * @param updates - Balance updates from account-activity websocket payload.\n * @param accountId - Internal account UUID.\n * @param getAssetType - Resolver for asset metadata type.\n * @returns DataResponse with merge mode when balances are present.\n */\nexport function processAccountActivityBalanceUpdates(\n  updates: BalanceUpdate[],\n  accountId: string,\n  getAssetType: (assetId: Caip19AssetId) => 'native' | 'erc20' | 'spl',\n): DataResponse {\n  const assetsBalance = Object.create(null) as Record<\n    string,\n    Record<Caip19AssetId, AssetBalance>\n  >;\n  assetsBalance[accountId] = Object.create(null) as Record<\n    Caip19AssetId,\n    AssetBalance\n  >;\n  const assetsMetadata = Object.create(null) as Record<\n    Caip19AssetId,\n    AssetMetadata\n  >;\n\n  for (const update of updates) {\n    const { asset, postBalance } = update;\n\n    if (!asset || !postBalance) {\n      continue;\n    }\n\n    const assetId = asset.type as Caip19AssetId;\n\n    if (asset.decimals === undefined) {\n      continue;\n    }\n\n    const rawBalanceStr = postBalance.amount.startsWith('0x')\n      ? BigInt(postBalance.amount).toString()\n      : postBalance.amount;\n\n    const humanReadableAmount = new BigNumberJS(rawBalanceStr)\n      .dividedBy(new BigNumberJS(10).pow(asset.decimals))\n      .toFixed();\n\n    assetsBalance[accountId][assetId] = {\n      amount: humanReadableAmount,\n    };\n\n    assetsMetadata[assetId] = {\n      type: getAssetType(assetId),\n      symbol: asset.unit,\n      name: asset.unit,\n      decimals: asset.decimals,\n    };\n  }\n\n  const response: DataResponse = { updateMode: 'merge' };\n  if (Object.keys(assetsBalance[accountId]).length > 0) {\n    response.assetsBalance = assetsBalance;\n    response.assetsInfo = assetsMetadata;\n  }\n\n  return response;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask/assets-controller",
-  "version": "9.0.2",
+  "version": "10.0.0",
   "description": "Tracks assets balances/prices and handles token detection across all digital assets",
   "keywords": [
     "Ethereum",
@@ -56,14 +56,14 @@
     "@ethereumjs/util": "^9.1.0",
     "@ethersproject/abi": "^5.7.0",
     "@ethersproject/providers": "^5.7.0",
-    "@metamask/account-tree-controller": "^7.5.2",
-    "@metamask/accounts-controller": "^39.0.2",
-    "@metamask/assets-controllers": "^109.2.1",
+    "@metamask/account-tree-controller": "^7.5.3",
+    "@metamask/accounts-controller": "^39.0.3",
+    "@metamask/assets-controllers": "^109.2.2",
     "@metamask/base-controller": "^9.1.0",
     "@metamask/client-controller": "^1.0.1",
     "@metamask/controller-utils": "^12.3.0",
-    "@metamask/core-backend": "^6.3.3",
-    "@metamask/keyring-api": "^23.1.0",
+    "@metamask/core-backend": "^6.4.0",
+    "@metamask/keyring-api": "^23.3.0",
     "@metamask/keyring-controller": "^27.1.0",
     "@metamask/keyring-internal-api": "^11.0.1",
     "@metamask/keyring-snap-client": "^9.0.2",
@@ -76,7 +76,7 @@
     "@metamask/preferences-controller": "^23.1.0",
     "@metamask/snaps-controllers": "^19.0.0",
     "@metamask/snaps-utils": "^12.1.2",
-    "@metamask/transaction-controller": "^68.1.1",
+    "@metamask/transaction-controller": "^68.2.0",
     "@metamask/utils": "^11.11.0",
     "async-mutex": "^0.5.0",
     "bignumber.js": "^9.1.2",