@metamask-previews/assets-controller 14.0.2-preview-4f4c98e → 14.0.2-preview-eb263b0ee

package/dist/data-sources/AccountActivityDataSource.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountActivityDataSource.d.cts","sourceRoot":"","sources":["../../src/data-sources/AccountActivityDataSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yCAAyC,EACzC,wCAAwC,EAEzC,+BAA+B;AAKhC,OAAO,KAAK,EAAE,yBAAyB,EAAE,gCAA+B;AAExE,OAAO,KAAK,EAGV,OAAO,EACP,aAAa,EACb,WAAW,EACX,YAAY,EACb,qBAAoB;AAErB,OAAO,EAAE,kBAAkB,EAAE,iCAAgC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,iCAAgC;AAM/D,QAAA,MAAM,eAAe,8BAA8B,CAAC;AAqFpD,mEAAmE;AACnE,MAAM,MAAM,sCAAsC,GAC9C,yCAAyC,GACzC,wCAAwC,CAAC;AAM7C,MAAM,MAAM,8BAA8B,GAAG,eAAe,CAAC;AAU7D,MAAM,MAAM,gCAAgC,GAAG;IAC7C,mEAAmE;IACnE,SAAS,EAAE,yBAAyB,CAAC;IACrC,qGAAqG;IACrG,qBAAqB,EAAE,CACrB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,OAAO,EAAE,EACjB,cAAc,EAAE,OAAO,EAAE,KACtB,IAAI,CAAC;IACV,wFAAwF;IACxF,YAAY,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;IACrE;;;;;OAKG;IACH,cAAc,EAAE,CACd,QAAQ,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE,WAAW,KAClB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC,8BAA8B,CAAC,CAAC;CACjD,CAAC;AAMF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,yBAA0B,SAAQ,kBAAkB,CAC/D,OAAO,eAAe,EACtB,8BAA8B,CAC/B;;gBAwBa,OAAO,EAAE,gCAAgC;IAkCrD;;;;;;;OAOG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IA4JhC,OAAO,IAAI,IAAI;CAqBhB;AAMD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,gCAAgC,GACxC,yBAAyB,CAE3B"}

package/dist/data-sources/AccountActivityDataSource.d.mts

@@ -0,0 +1,80 @@
+import type { AccountActivityServiceBalanceUpdatedEvent, AccountActivityServiceStatusChangedEvent } from "@metamask/core-backend";
+import type { AssetsControllerMessenger } from "../AssetsController.mjs";
+import type { ChainId, Caip19AssetId, DataRequest, DataResponse } from "../types.mjs";
+import { AbstractDataSource } from "./AbstractDataSource.mjs";
+import type { DataSourceState } from "./AbstractDataSource.mjs";
+declare const CONTROLLER_NAME = "AccountActivityDataSource";
+/** Allowed events that AccountActivityDataSource subscribes to. */
+export type AccountActivityDataSourceAllowedEvents = AccountActivityServiceBalanceUpdatedEvent | AccountActivityServiceStatusChangedEvent;
+export type AccountActivityDataSourceState = DataSourceState;
+export type AccountActivityDataSourceOptions = {
+    /** The AssetsController messenger (shared by all data sources). */
+    messenger: AssetsControllerMessenger;
+    /** Called when active chains are updated. Pass dataSourceName so the controller knows the source. */
+    onActiveChainsUpdated: (dataSourceName: string, chains: ChainId[], previousChains: ChainId[]) => void;
+    /** Returns the asset type ('native' | 'erc20' | 'spl') for a given CAIP-19 asset ID. */
+    getAssetType: (assetId: Caip19AssetId) => 'native' | 'erc20' | 'spl';
+    /**
+     * Pushes decoded balance updates to the controller (bound to
+     * `AssetsController.handleAssetsUpdate`). AADS is event-driven and never
+     * takes part in the controller's subscribe handoff, so it receives this
+     * callback directly instead of via a `SubscriptionRequest`.
+     */
+    onAssetsUpdate: (response: DataResponse, request?: DataRequest) => void | Promise<void>;
+    state?: Partial<AccountActivityDataSourceState>;
+};
+/**
+ * Data source that consumes real-time updates from `AccountActivityService`.
+ *
+ * `AccountActivityService` owns the WebSocket connection and channel
+ * subscriptions; this data source is a thin consumer of the two high-level
+ * events that it publishes:
+ *
+ * - `AccountActivityService:balanceUpdated` — post-transaction balances for the
+ *   subscribed account(s). The address is resolved against the wallet's
+ *   selected account group, transformed into a {@link DataResponse} (via
+ *   {@link processAccountActivityBalanceUpdates}), and pushed to the controller
+ *   through the injected `onAssetsUpdate` callback.
+ * - `AccountActivityService:statusChanged` — per-chain "up"/"down" notifications.
+ *   A chain reported "up" is claimed as an active chain (WebSocket is providing
+ *   real-time data); a chain reported "down" is released so polling data sources
+ *   can take over. Each change is applied directly via `updateActiveChains`,
+ *   which notifies the controller through `onActiveChainsUpdated`.
+ *
+ * This data source does NOT debounce, jitter, or gate chain updates itself.
+ * Coalescing (collapsing bursts) and jitter (staggering the WS-subscribe herd
+ * across clients) live in `AssetsController`, where the expensive re-subscribe
+ * happens and where updates from all data sources converge. `activeChains` are
+ * never seeded from the accounts API; they only ever reflect live
+ * `statusChanged` events (the service flushes all tracked chains as "down" when
+ * the WebSocket disconnects, releasing them).
+ *
+ * It subscribes to these events in its constructor (the same way
+ * `TokenBalancesController` does). Unlike the polling data sources it does not
+ * take part in the controller's subscribe/unsubscribe handoff: `subscribe` is a
+ * no-op, balance updates are routed by resolving the address against the
+ * wallet, and updates are pushed through the injected `onAssetsUpdate` callback.
+ */
+export declare class AccountActivityDataSource extends AbstractDataSource<typeof CONTROLLER_NAME, AccountActivityDataSourceState> {
+    #private;
+    constructor(options: AccountActivityDataSourceOptions);
+    /**
+     * AADS is event-driven and chain-agnostic: it never participates in the
+     * controller's subscribe/unsubscribe handoff. Incoming `balanceUpdated`
+     * events are routed by resolving the address against the wallet's accounts
+     * (see `#onBalanceUpdated`), and updates are pushed through the injected
+     * `#onAssetsUpdate` callback. This override exists only to satisfy the
+     * abstract contract and is intentionally a no-op.
+     */
+    subscribe(): Promise<void>;
+    destroy(): void;
+}
+/**
+ * Creates an AccountActivityDataSource instance.
+ *
+ * @param options - Configuration options for the data source.
+ * @returns A new AccountActivityDataSource instance.
+ */
+export declare function createAccountActivityDataSource(options: AccountActivityDataSourceOptions): AccountActivityDataSource;
+export {};
+//# sourceMappingURL=AccountActivityDataSource.d.mts.map

package/dist/data-sources/AccountActivityDataSource.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountActivityDataSource.d.mts","sourceRoot":"","sources":["../../src/data-sources/AccountActivityDataSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yCAAyC,EACzC,wCAAwC,EAEzC,+BAA+B;AAKhC,OAAO,KAAK,EAAE,yBAAyB,EAAE,gCAA+B;AAExE,OAAO,KAAK,EAGV,OAAO,EACP,aAAa,EACb,WAAW,EACX,YAAY,EACb,qBAAoB;AAErB,OAAO,EAAE,kBAAkB,EAAE,iCAAgC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,iCAAgC;AAM/D,QAAA,MAAM,eAAe,8BAA8B,CAAC;AAqFpD,mEAAmE;AACnE,MAAM,MAAM,sCAAsC,GAC9C,yCAAyC,GACzC,wCAAwC,CAAC;AAM7C,MAAM,MAAM,8BAA8B,GAAG,eAAe,CAAC;AAU7D,MAAM,MAAM,gCAAgC,GAAG;IAC7C,mEAAmE;IACnE,SAAS,EAAE,yBAAyB,CAAC;IACrC,qGAAqG;IACrG,qBAAqB,EAAE,CACrB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,OAAO,EAAE,EACjB,cAAc,EAAE,OAAO,EAAE,KACtB,IAAI,CAAC;IACV,wFAAwF;IACxF,YAAY,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;IACrE;;;;;OAKG;IACH,cAAc,EAAE,CACd,QAAQ,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE,WAAW,KAClB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC,8BAA8B,CAAC,CAAC;CACjD,CAAC;AAMF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,yBAA0B,SAAQ,kBAAkB,CAC/D,OAAO,eAAe,EACtB,8BAA8B,CAC/B;;gBAwBa,OAAO,EAAE,gCAAgC;IAkCrD;;;;;;;OAOG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IA4JhC,OAAO,IAAI,IAAI;CAqBhB;AAMD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,gCAAgC,GACxC,yBAAyB,CAE3B"}

package/dist/data-sources/{AccountActivityDataSource.js → AccountActivityDataSource.mjs}

@@ -1,20 +1,20 @@
-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 __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 _AccountActivityDataSource_instances, _AccountActivityDataSource_messenger, _AccountActivityDataSource_onActiveChainsUpdated, _AccountActivityDataSource_getAssetType, _AccountActivityDataSource_onAssetsUpdate, _AccountActivityDataSource_onBalanceUpdatedBound, _AccountActivityDataSource_subscribeToEvents, _AccountActivityDataSource_onBalanceUpdated, _AccountActivityDataSource_findAccountForAddress, _AccountActivityDataSource_getWalletAccounts, _AccountActivityDataSource_onAccountActivityStatusChanged;
-import { isCaipChainId } from '@metamask/utils';
-import { BigNumber as BigNumberJS } from 'bignumber.js';
-import { projectLogger, createModuleLogger } from '../logger.js';
-import { safeNormalizeAssetId } from '../utils/index.js';
-import { AbstractDataSource } from './AbstractDataSource.js';
+import { isCaipChainId } from "@metamask/utils";
+import BigNumberJS from "bignumber.js";
+import { projectLogger, createModuleLogger } from "../logger.mjs";
+import { safeNormalizeAssetId } from "../utils/index.mjs";
+import { AbstractDataSource } from "./AbstractDataSource.mjs";
 // ============================================================================
 // CONSTANTS
 // ============================================================================
@@ -256,4 +256,4 @@ _AccountActivityDataSource_messenger = new WeakMap(), _AccountActivityDataSource
 export function createAccountActivityDataSource(options) {
     return new AccountActivityDataSource(options);
 }
-//# sourceMappingURL=AccountActivityDataSource.js.map
+//# sourceMappingURL=AccountActivityDataSource.mjs.map

package/dist/data-sources/AccountActivityDataSource.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountActivityDataSource.mjs","sourceRoot":"","sources":["../../src/data-sources/AccountActivityDataSource.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  AccountActivityServiceBalanceUpdatedEvent,\n  AccountActivityServiceStatusChangedEvent,\n  BalanceUpdate,\n} from '@metamask/core-backend';\nimport type { InternalAccount } from '@metamask/keyring-internal-api';\nimport { isCaipChainId } from '@metamask/utils';\nimport BigNumberJS from 'bignumber.js';\n\nimport type { AssetsControllerMessenger } from '../AssetsController.js';\nimport { projectLogger, createModuleLogger } from '../logger.js';\nimport type {\n  AssetBalance,\n  AssetMetadata,\n  ChainId,\n  Caip19AssetId,\n  DataRequest,\n  DataResponse,\n} from '../types.js';\nimport { safeNormalizeAssetId } from '../utils/index.js';\nimport { AbstractDataSource } from './AbstractDataSource.js';\nimport type { DataSourceState } from './AbstractDataSource.js';\n\n// ============================================================================\n// CONSTANTS\n// ============================================================================\n\nconst CONTROLLER_NAME = 'AccountActivityDataSource';\n\nconst log = createModuleLogger(projectLogger, CONTROLLER_NAME);\n\n// ============================================================================\n// BALANCE UPDATE PROCESSING\n// ============================================================================\n\n/**\n * Convert AccountActivityMessage balance updates into a {@link DataResponse}\n * for AssetsController.\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 */\nfunction 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    // The websocket sends lower-case ERC-20 addresses, while state and the\n    // rest of the pipeline key assets by their checksummed ID. Normalizing\n    // here keeps middleware comparisons (detection, custom-asset graduation,\n    // occurrence filtering) from treating an existing holding as brand new.\n    const assetId = safeNormalizeAssetId(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\n// ============================================================================\n// MESSENGER TYPES\n// ============================================================================\n\n/** Allowed events that AccountActivityDataSource subscribes to. */\nexport type AccountActivityDataSourceAllowedEvents =\n  | AccountActivityServiceBalanceUpdatedEvent\n  | AccountActivityServiceStatusChangedEvent;\n\n// ============================================================================\n// STATE\n// ============================================================================\n\nexport type AccountActivityDataSourceState = DataSourceState;\n\nconst defaultState: AccountActivityDataSourceState = {\n  activeChains: [],\n};\n\n// ============================================================================\n// OPTIONS\n// ============================================================================\n\nexport type AccountActivityDataSourceOptions = {\n  /** The AssetsController messenger (shared by all data sources). */\n  messenger: AssetsControllerMessenger;\n  /** Called when active chains are updated. Pass dataSourceName so the controller knows the source. */\n  onActiveChainsUpdated: (\n    dataSourceName: string,\n    chains: ChainId[],\n    previousChains: ChainId[],\n  ) => void;\n  /** Returns the asset type ('native' | 'erc20' | 'spl') for a given CAIP-19 asset ID. */\n  getAssetType: (assetId: Caip19AssetId) => 'native' | 'erc20' | 'spl';\n  /**\n   * Pushes decoded balance updates to the controller (bound to\n   * `AssetsController.handleAssetsUpdate`). AADS is event-driven and never\n   * takes part in the controller's subscribe handoff, so it receives this\n   * callback directly instead of via a `SubscriptionRequest`.\n   */\n  onAssetsUpdate: (\n    response: DataResponse,\n    request?: DataRequest,\n  ) => void | Promise<void>;\n  state?: Partial<AccountActivityDataSourceState>;\n};\n\n// ============================================================================\n// ACCOUNT ACTIVITY DATA SOURCE\n// ============================================================================\n\n/**\n * Data source that consumes real-time updates from `AccountActivityService`.\n *\n * `AccountActivityService` owns the WebSocket connection and channel\n * subscriptions; this data source is a thin consumer of the two high-level\n * events that it publishes:\n *\n * - `AccountActivityService:balanceUpdated` — post-transaction balances for the\n *   subscribed account(s). The address is resolved against the wallet's\n *   selected account group, transformed into a {@link DataResponse} (via\n *   {@link processAccountActivityBalanceUpdates}), and pushed to the controller\n *   through the injected `onAssetsUpdate` callback.\n * - `AccountActivityService:statusChanged` — per-chain \"up\"/\"down\" notifications.\n *   A chain reported \"up\" is claimed as an active chain (WebSocket is providing\n *   real-time data); a chain reported \"down\" is released so polling data sources\n *   can take over. Each change is applied directly via `updateActiveChains`,\n *   which notifies the controller through `onActiveChainsUpdated`.\n *\n * This data source does NOT debounce, jitter, or gate chain updates itself.\n * Coalescing (collapsing bursts) and jitter (staggering the WS-subscribe herd\n * across clients) live in `AssetsController`, where the expensive re-subscribe\n * happens and where updates from all data sources converge. `activeChains` are\n * never seeded from the accounts API; they only ever reflect live\n * `statusChanged` events (the service flushes all tracked chains as \"down\" when\n * the WebSocket disconnects, releasing them).\n *\n * It subscribes to these events in its constructor (the same way\n * `TokenBalancesController` does). Unlike the polling data sources it does not\n * take part in the controller's subscribe/unsubscribe handoff: `subscribe` is a\n * no-op, balance updates are routed by resolving the address against the\n * wallet, and updates are pushed through the injected `onAssetsUpdate` callback.\n */\nexport class AccountActivityDataSource extends AbstractDataSource<\n  typeof CONTROLLER_NAME,\n  AccountActivityDataSourceState\n> {\n  readonly #messenger: AssetsControllerMessenger;\n\n  readonly #onActiveChainsUpdated: (\n    dataSourceName: string,\n    chains: ChainId[],\n    previousChains: ChainId[],\n  ) => void;\n\n  readonly #getAssetType: (\n    assetId: Caip19AssetId,\n  ) => 'native' | 'erc20' | 'spl';\n\n  readonly #onAssetsUpdate: (\n    response: DataResponse,\n    request?: DataRequest,\n  ) => void | Promise<void>;\n\n  readonly #onBalanceUpdatedBound: (event: {\n    address: string;\n    chain: string;\n    updates: BalanceUpdate[];\n  }) => void;\n\n  constructor(options: AccountActivityDataSourceOptions) {\n    super(CONTROLLER_NAME, {\n      ...defaultState,\n      ...options.state,\n    });\n\n    this.#messenger = options.messenger;\n    this.#onActiveChainsUpdated = options.onActiveChainsUpdated;\n    this.#getAssetType = options.getAssetType;\n    this.#onAssetsUpdate = options.onAssetsUpdate;\n    this.#onBalanceUpdatedBound = this.#onBalanceUpdated.bind(this);\n\n    this.#subscribeToEvents();\n  }\n\n  // ============================================================================\n  // EVENT SUBSCRIPTIONS\n  // ============================================================================\n\n  #subscribeToEvents(): void {\n    this.#messenger.subscribe(\n      'AccountActivityService:balanceUpdated',\n      this.#onBalanceUpdatedBound,\n    );\n    this.#messenger.subscribe(\n      'AccountActivityService:statusChanged',\n      this.#onAccountActivityStatusChanged,\n    );\n  }\n\n  // ============================================================================\n  // SUBSCRIBE / UNSUBSCRIBE\n  // ============================================================================\n\n  /**\n   * AADS is event-driven and chain-agnostic: it never participates in the\n   * controller's subscribe/unsubscribe handoff. Incoming `balanceUpdated`\n   * events are routed by resolving the address against the wallet's accounts\n   * (see `#onBalanceUpdated`), and updates are pushed through the injected\n   * `#onAssetsUpdate` callback. This override exists only to satisfy the\n   * abstract contract and is intentionally a no-op.\n   */\n  async subscribe(): Promise<void> {\n    // Intentionally empty — see method doc.\n  }\n\n  // ============================================================================\n  // BALANCE UPDATES\n  // ============================================================================\n\n  #onBalanceUpdated({\n    address,\n    chain,\n    updates,\n  }: {\n    address: string;\n    chain: string;\n    updates: BalanceUpdate[];\n  }): void {\n    try {\n      if (!address || !chain || !updates || updates.length === 0) {\n        return;\n      }\n\n      const account = this.#findAccountForAddress(address);\n      if (!account) {\n        return;\n      }\n\n      const chainId = chain as ChainId;\n\n      const response = processAccountActivityBalanceUpdates(\n        updates,\n        account.id,\n        (assetId) => this.#getAssetType(assetId),\n      );\n\n      if (!response.assetsBalance) {\n        return;\n      }\n\n      const request: DataRequest = {\n        accountsWithSupportedChains: [{ account, supportedChains: [chainId] }],\n        chainIds: [chainId],\n        dataTypes: ['balance', 'metadata'],\n      };\n\n      Promise.resolve(this.#onAssetsUpdate(response, request)).catch(\n        (error) => {\n          log('Failed to report balance update', { error });\n        },\n      );\n    } catch (error) {\n      log('Error handling balance update', error);\n    }\n  }\n\n  /**\n   * Find the wallet account matching the given activity address. EVM addresses\n   * are matched case-insensitively; other namespaces are matched exactly.\n   *\n   * The candidate set is the accounts of the selected account group, resolved\n   * from the wallet at event time (rather than from a stored subscription), so\n   * AADS does not need to be re-subscribed whenever the account set changes.\n   *\n   * @param address - The account address from the activity message.\n   * @returns The matching account, or null.\n   */\n  #findAccountForAddress(address: string): InternalAccount | null {\n    const isEvm = address.startsWith('0x');\n\n    return (\n      this.#getWalletAccounts().find((candidate) =>\n        isEvm\n          ? candidate.address.toLowerCase() === address.toLowerCase()\n          : candidate.address === address,\n      ) ?? null\n    );\n  }\n\n  /**\n   * Resolve the accounts of the selected account group from the wallet,\n   * mirroring `AssetsController.#getSelectedAccounts`.\n   *\n   * @returns The accounts of the selected account group.\n   */\n  #getWalletAccounts(): InternalAccount[] {\n    const accounts = this.#messenger.call(\n      'AccountTreeController:getAccountsFromSelectedAccountGroup',\n    );\n    if (accounts.length > 0) {\n      return accounts;\n    }\n\n    const selectedAccount = this.#messenger.call(\n      'AccountsController:getSelectedAccount',\n    );\n    return selectedAccount ? [selectedAccount] : [];\n  }\n\n  // ============================================================================\n  // STATUS CHANGES\n  // ============================================================================\n\n  /**\n   * Handle a `statusChanged` notification. Chains reported \"up\" are claimed as\n   * active (WebSocket provides real-time data); chains reported \"down\" are\n   * released so polling data sources take over. The change is applied directly;\n   * coalescing and jitter are handled by `AssetsController`.\n   *\n   * @param options - The status change notification.\n   * @param options.chainIds - The CAIP-2 chain IDs whose status changed.\n   * @param options.status - Whether the chains are `up` or `down`.\n   * @param options.timestamp - Optional timestamp of the status change.\n   */\n  readonly #onAccountActivityStatusChanged = ({\n    chainIds,\n    status,\n  }: {\n    chainIds: string[];\n    status: 'up' | 'down';\n    timestamp?: number;\n  }): void => {\n    try {\n      // Act on every namespace (eip155, solana, etc.); AssetsController is\n      // multichain. Only skip identifiers that are not valid CAIP-2 chain IDs.\n      const validChains = chainIds.filter((chainId) =>\n        isCaipChainId(chainId),\n      ) as ChainId[];\n\n      if (validChains.length === 0) {\n        return;\n      }\n\n      const next = new Set(this.state.activeChains);\n      if (status === 'up') {\n        for (const chainId of validChains) {\n          next.add(chainId);\n        }\n      } else {\n        for (const chainId of validChains) {\n          next.delete(chainId);\n        }\n      }\n\n      const previous = [...this.state.activeChains];\n      this.updateActiveChains(Array.from(next), (updatedChains) =>\n        this.#onActiveChainsUpdated(this.getName(), updatedChains, previous),\n      );\n    } catch (error) {\n      log('Error handling status change', error);\n    }\n  };\n\n  // ============================================================================\n  // CLEANUP\n  // ============================================================================\n\n  destroy(): void {\n    try {\n      this.#messenger.unsubscribe(\n        'AccountActivityService:balanceUpdated',\n        this.#onBalanceUpdatedBound,\n      );\n    } catch (error) {\n      log('Failed to unsubscribe from balanceUpdated', { error });\n    }\n\n    try {\n      this.#messenger.unsubscribe(\n        'AccountActivityService:statusChanged',\n        this.#onAccountActivityStatusChanged,\n      );\n    } catch (error) {\n      log('Failed to unsubscribe from statusChanged', { error });\n    }\n\n    super.destroy();\n  }\n}\n\n// ============================================================================\n// FACTORY FUNCTION\n// ============================================================================\n\n/**\n * Creates an AccountActivityDataSource instance.\n *\n * @param options - Configuration options for the data source.\n * @returns A new AccountActivityDataSource instance.\n */\nexport function createAccountActivityDataSource(\n  options: AccountActivityDataSourceOptions,\n): AccountActivityDataSource {\n  return new AccountActivityDataSource(options);\n}\n"]}