@metamask-previews/assets-controller 20.4.1-preview-906029d47 → 20.4.1-preview-e80304db4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/README.md +3 -0
  3. package/dist/AssetsController-method-action-types.d.ts +2 -2
  4. package/dist/AssetsController-method-action-types.js.map +1 -1
  5. package/dist/AssetsController.d.ts +6 -12
  6. package/dist/AssetsController.d.ts.map +1 -1
  7. package/dist/AssetsController.js +11 -18
  8. package/dist/AssetsController.js.map +1 -1
  9. package/dist/data-sources/AccountActivityDataSource.d.ts +4 -2
  10. package/dist/data-sources/AccountActivityDataSource.d.ts.map +1 -1
  11. package/dist/data-sources/AccountActivityDataSource.js +3 -1
  12. package/dist/data-sources/AccountActivityDataSource.js.map +1 -1
  13. package/dist/data-sources/MarketStatsPriceStream.d.ts +108 -0
  14. package/dist/data-sources/MarketStatsPriceStream.d.ts.map +1 -0
  15. package/dist/data-sources/MarketStatsPriceStream.js +297 -0
  16. package/dist/data-sources/MarketStatsPriceStream.js.map +1 -0
  17. package/dist/data-sources/PriceDataSource.d.ts +32 -2
  18. package/dist/data-sources/PriceDataSource.d.ts.map +1 -1
  19. package/dist/data-sources/PriceDataSource.js +164 -37
  20. package/dist/data-sources/PriceDataSource.js.map +1 -1
  21. package/dist/data-sources/index.d.ts +1 -1
  22. package/dist/data-sources/index.d.ts.map +1 -1
  23. package/dist/data-sources/index.js.map +1 -1
  24. package/dist/index.d.ts +4 -2
  25. package/dist/index.d.ts.map +1 -1
  26. package/dist/index.js +2 -0
  27. package/dist/index.js.map +1 -1
  28. package/dist/store/MarketStatsStore.d.ts +72 -0
  29. package/dist/store/MarketStatsStore.d.ts.map +1 -0
  30. package/dist/store/MarketStatsStore.js +182 -0
  31. package/dist/store/MarketStatsStore.js.map +1 -0
  32. package/dist/types.d.ts +5 -0
  33. package/dist/types.d.ts.map +1 -1
  34. package/dist/types.js.map +1 -1
  35. package/package.json +3 -3
@@ -2,7 +2,7 @@ import type { AccountActivityServiceBalanceUpdatedEvent, AccountActivityServiceS
2
2
  import type { AssetsControllerMessenger } from '../AssetsController.js';
3
3
  import type { ChainId, DataRequest, DataResponse } from '../types.js';
4
4
  import { AbstractDataSource } from './AbstractDataSource.js';
5
- import type { DataSourceState } from './AbstractDataSource.js';
5
+ import type { DataSourceState, SubscriptionRequest } from './AbstractDataSource.js';
6
6
  declare const CONTROLLER_NAME = "AccountActivityDataSource";
7
7
  /** Allowed events that AccountActivityDataSource subscribes to. */
8
8
  export type AccountActivityDataSourceAllowedEvents = AccountActivityServiceBalanceUpdatedEvent | AccountActivityServiceStatusChangedEvent;
@@ -63,8 +63,10 @@ export declare class AccountActivityDataSource extends AbstractDataSource<typeof
63
63
  * (see `#onBalanceUpdated`), and updates are pushed through the injected
64
64
  * `#onAssetsUpdate` callback. This override exists only to satisfy the
65
65
  * abstract contract and is intentionally a no-op.
66
+ *
67
+ * @param _request - Ignored. Account activity does not subscribe per request.
66
68
  */
67
- subscribe(): Promise<void>;
69
+ subscribe(_request?: SubscriptionRequest): Promise<void>;
68
70
  destroy(): void;
69
71
  }
70
72
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"AccountActivityDataSource.d.ts","sourceRoot":"","sources":["../../src/data-sources/AccountActivityDataSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yCAAyC,EACzC,wCAAwC,EAEzC,MAAM,wBAAwB,CAAC;AAKhC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAExE,OAAO,KAAK,EAEV,OAAO,EAEP,WAAW,EACX,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAM/D,QAAA,MAAM,eAAe,8BAA8B,CAAC;AAwEpD,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;;;;;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;;IAoBC,YAAY,OAAO,EAAE,gCAAgC,EAYpD;IAqBD;;;;;;;OAOG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/B;IAuJD,OAAO,IAAI,IAAI,CAoBd;CACF;AAMD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,gCAAgC,GACxC,yBAAyB,CAE3B"}
1
+ {"version":3,"file":"AccountActivityDataSource.d.ts","sourceRoot":"","sources":["../../src/data-sources/AccountActivityDataSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yCAAyC,EACzC,wCAAwC,EAEzC,MAAM,wBAAwB,CAAC;AAKhC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAExE,OAAO,KAAK,EAEV,OAAO,EAEP,WAAW,EACX,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAMjC,QAAA,MAAM,eAAe,8BAA8B,CAAC;AAwEpD,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;;;;;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;;IAoBC,YAAY,OAAO,EAAE,gCAAgC,EAYpD;IAqBD;;;;;;;;;OASG;IACG,SAAS,CAAC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D;IAuJD,OAAO,IAAI,IAAI,CAoBd;CACF;AAMD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,gCAAgC,GACxC,yBAAyB,CAE3B"}
@@ -123,8 +123,10 @@ export class AccountActivityDataSource extends AbstractDataSource {
123
123
  * (see `#onBalanceUpdated`), and updates are pushed through the injected
124
124
  * `#onAssetsUpdate` callback. This override exists only to satisfy the
125
125
  * abstract contract and is intentionally a no-op.
126
+ *
127
+ * @param _request - Ignored. Account activity does not subscribe per request.
126
128
  */
127
- async subscribe() {
129
+ async subscribe(_request) {
128
130
  // Intentionally empty — see method doc.
129
131
  }
130
132
  // ============================================================================
@@ -1 +1 @@
1
- {"version":3,"file":"AccountActivityDataSource.js","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 { BigNumber as BigNumberJS } from 'bignumber.js';\n\nimport type { AssetsControllerMessenger } from '../AssetsController.js';\nimport { projectLogger, createModuleLogger } from '../logger.js';\nimport type {\n AssetBalance,\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 * @returns DataResponse with merge mode when balances are present.\n */\nfunction processAccountActivityBalanceUpdates(\n updates: BalanceUpdate[],\n accountId: string,\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\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 ...(postBalance.metadata ? { metadata: postBalance.metadata } : {}),\n };\n }\n\n const response: DataResponse = { updateMode: 'merge' };\n if (Object.keys(assetsBalance[accountId]).length > 0) {\n response.assetsBalance = assetsBalance;\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 /**\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 #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.#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 );\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', 'price'],\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) => isCaipChainId(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"]}
1
+ {"version":3,"file":"AccountActivityDataSource.js","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 { BigNumber as BigNumberJS } from 'bignumber.js';\n\nimport type { AssetsControllerMessenger } from '../AssetsController.js';\nimport { projectLogger, createModuleLogger } from '../logger.js';\nimport type {\n AssetBalance,\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 {\n DataSourceState,\n SubscriptionRequest,\n} 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 * @returns DataResponse with merge mode when balances are present.\n */\nfunction processAccountActivityBalanceUpdates(\n updates: BalanceUpdate[],\n accountId: string,\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\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 ...(postBalance.metadata ? { metadata: postBalance.metadata } : {}),\n };\n }\n\n const response: DataResponse = { updateMode: 'merge' };\n if (Object.keys(assetsBalance[accountId]).length > 0) {\n response.assetsBalance = assetsBalance;\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 /**\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 #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.#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 * @param _request - Ignored. Account activity does not subscribe per request.\n */\n async subscribe(_request?: SubscriptionRequest): 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 );\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', 'price'],\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) => isCaipChainId(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"]}
@@ -0,0 +1,108 @@
1
+ /**
2
+ * Subscribes the price-fetch set when the Price API marks it `wssSupport`.
3
+ *
4
+ * That set is balances and custom assets on the selected accounts and chains,
5
+ * minus hidden assets. Open channels live on MarketStatsService. Reconcile
6
+ * reads `getSubscriptions`. A subscribe that does not open is retried on the
7
+ * next reconcile, and those assets stay on the poll. Chain health is read
8
+ * from `getChainStatuses`. A chain reported down is polled after a short
9
+ * jitter until it recovers. When MarketStatsService is not wired, every
10
+ * asset is polled.
11
+ */
12
+ import type { MarketStatsServiceActions, MarketStatsServiceChainStatusChangedEvent, SupportedCurrency } from '@metamask/core-backend';
13
+ import type { Messenger } from '@metamask/messenger';
14
+ import type { Caip19AssetId } from '../types.js';
15
+ export type MarketStatsPriceStreamMessenger = Messenger<string, MarketStatsServiceActions, MarketStatsServiceChainStatusChangedEvent>;
16
+ export type StreamCandidate = {
17
+ assetId: Caip19AssetId;
18
+ wssSupport: boolean;
19
+ };
20
+ export type MarketStatsPriceStreamOptions = {
21
+ messenger: MarketStatsPriceStreamMessenger;
22
+ getSelectedCurrency: () => SupportedCurrency;
23
+ getPollIntervalMs: () => number;
24
+ requestPoll: (delayMs: number, details: {
25
+ chainIds: string[];
26
+ status: 'up' | 'down';
27
+ }) => void;
28
+ /** Defaults to Math.random. Tests inject a fixed value. */
29
+ random?: () => number;
30
+ };
31
+ /**
32
+ * Read `wssSupport` off a spot-price entry.
33
+ *
34
+ * @param data - One asset's `/v3/spot-prices` entry.
35
+ * @returns Whether the asset can stream.
36
+ */
37
+ export declare function readSpotPriceStreamEligibility(data: object): boolean;
38
+ /**
39
+ * Assets the Price API marks as streamable.
40
+ *
41
+ * @param candidates - Assets learned from the latest spot-price response.
42
+ * @returns Asset ids to subscribe.
43
+ */
44
+ export declare function selectAssetsToStream(candidates: StreamCandidate[]): Caip19AssetId[];
45
+ /**
46
+ * CAIP-2 chain id from a CAIP-19 asset id, or undefined when the id is invalid.
47
+ *
48
+ * @param assetId - CAIP-19 asset identifier.
49
+ * @returns The chain id.
50
+ */
51
+ export declare function chainIdFromAssetId(assetId: string): string | undefined;
52
+ /**
53
+ * True when the messenger has no MarketStatsService handler.
54
+ * Price updates then stay on the poll.
55
+ *
56
+ * @param error - Failure from `messenger.call`.
57
+ * @returns Whether streaming cannot be used in this process.
58
+ */
59
+ export declare function isMarketStatsUnavailable(error: unknown): boolean;
60
+ export declare function fallbackJitterMs(pollIntervalMs: number, random: () => number): number;
61
+ /**
62
+ * Opens market-stats channels for the price-fetch set.
63
+ */
64
+ export declare class MarketStatsPriceStream {
65
+ #private;
66
+ constructor(options: MarketStatsPriceStreamOptions);
67
+ /**
68
+ * Asset ids with an open market-stats channel for the selected currency.
69
+ *
70
+ * @returns Ids the service currently has open. Empty when streaming is off.
71
+ */
72
+ subscribedAssetIds(): Promise<ReadonlySet<string>>;
73
+ /**
74
+ * Chain ids `getChainStatuses` currently reports as down.
75
+ * Empty when MarketStatsService is not registered.
76
+ *
77
+ * @returns Down chain ids.
78
+ */
79
+ downChainIds(): Promise<ReadonlySet<string>>;
80
+ /**
81
+ * Whether this asset should be priced from `/v3/spot-prices` on the poll.
82
+ * Down chains are skipped until their jitter window ends, then polled.
83
+ *
84
+ * @param assetId - CAIP-19 asset id.
85
+ * @param now - Current time in ms.
86
+ * @param subscribed - Asset ids `getSubscriptions` currently has open.
87
+ * @param downChains - Chain ids `getChainStatuses` reports as down.
88
+ * @returns True when the poll should fetch this asset.
89
+ */
90
+ shouldPoll(assetId: Caip19AssetId, now: number, subscribed: ReadonlySet<string>, downChains: ReadonlySet<string>): boolean;
91
+ /**
92
+ * Subscribe price-fetch assets marked `wssSupport`.
93
+ * Drop channels for assets that left that set.
94
+ *
95
+ * @param candidates - Price-fetch assets in the current subscription scope.
96
+ */
97
+ reconcile(candidates: StreamCandidate[]): Promise<void>;
98
+ /**
99
+ * Drop one reference on each open channel for a price-fetch asset.
100
+ * Used when the selected currency changes, and when the price subscription ends.
101
+ */
102
+ releaseSubscriptions(): Promise<void>;
103
+ /**
104
+ * Remove listeners and drop channels this stream opened.
105
+ */
106
+ destroy(): void;
107
+ }
108
+ //# sourceMappingURL=MarketStatsPriceStream.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MarketStatsPriceStream.d.ts","sourceRoot":"","sources":["../../src/data-sources/MarketStatsPriceStream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,yCAAyC,EACzC,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQjD,MAAM,MAAM,+BAA+B,GAAG,SAAS,CACrD,MAAM,EACN,yBAAyB,EACzB,yCAAyC,CAC1C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAOF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,SAAS,EAAE,+BAA+B,CAAC;IAC3C,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;IAC7C,iBAAiB,EAAE,MAAM,MAAM,CAAC;IAChC,WAAW,EAAE,CACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,IAAI,GAAG,MAAM,CAAA;KAAE,KACnD,IAAI,CAAC;IACV,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,eAAe,EAAE,GAC5B,aAAa,EAAE,CAIjB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMtE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMhE;AAED,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,MAAM,GACnB,MAAM,CAMR;AAUD;;GAEG;AACH,qBAAa,sBAAsB;;IA2BjC,YAAY,OAAO,EAAE,6BAA6B,EAejD;IAED;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAavD;IAED;;;;;OAKG;IACG,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAUjD;IAED;;;;;;;;;OASG;IACH,UAAU,CACR,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,EAC/B,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,OAAO,CAST;IAED;;;;;OAKG;IACG,SAAS,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C5D;IAED;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAI1C;IAED;;OAEG;IACH,OAAO,IAAI,IAAI,CAQd;CAkGF"}
@@ -0,0 +1,297 @@
1
+ /**
2
+ * Subscribes the price-fetch set when the Price API marks it `wssSupport`.
3
+ *
4
+ * That set is balances and custom assets on the selected accounts and chains,
5
+ * minus hidden assets. Open channels live on MarketStatsService. Reconcile
6
+ * reads `getSubscriptions`. A subscribe that does not open is retried on the
7
+ * next reconcile, and those assets stay on the poll. Chain health is read
8
+ * from `getChainStatuses`. A chain reported down is polled after a short
9
+ * jitter until it recovers. When MarketStatsService is not wired, every
10
+ * asset is polled.
11
+ */
12
+ import { parseCaipAssetType } from '@metamask/utils';
13
+ import { createModuleLogger, projectLogger } from '../logger.js';
14
+ import { normalizeAssetId } from '../utils/index.js';
15
+ const log = createModuleLogger(projectLogger, 'MarketStatsPriceStream');
16
+ /** Cap on the random delay before a chain-down poll, to avoid a thundering herd. */
17
+ const MAX_FALLBACK_JITTER_MS = 5_000;
18
+ /**
19
+ * Read `wssSupport` off a spot-price entry.
20
+ *
21
+ * @param data - One asset's `/v3/spot-prices` entry.
22
+ * @returns Whether the asset can stream.
23
+ */
24
+ export function readSpotPriceStreamEligibility(data) {
25
+ return data.wssSupport === true;
26
+ }
27
+ /**
28
+ * Assets the Price API marks as streamable.
29
+ *
30
+ * @param candidates - Assets learned from the latest spot-price response.
31
+ * @returns Asset ids to subscribe.
32
+ */
33
+ export function selectAssetsToStream(candidates) {
34
+ return candidates
35
+ .filter((candidate) => candidate.wssSupport)
36
+ .map((candidate) => candidate.assetId);
37
+ }
38
+ /**
39
+ * CAIP-2 chain id from a CAIP-19 asset id, or undefined when the id is invalid.
40
+ *
41
+ * @param assetId - CAIP-19 asset identifier.
42
+ * @returns The chain id.
43
+ */
44
+ export function chainIdFromAssetId(assetId) {
45
+ try {
46
+ return parseCaipAssetType(assetId).chainId;
47
+ }
48
+ catch {
49
+ return undefined;
50
+ }
51
+ }
52
+ /**
53
+ * True when the messenger has no MarketStatsService handler.
54
+ * Price updates then stay on the poll.
55
+ *
56
+ * @param error - Failure from `messenger.call`.
57
+ * @returns Whether streaming cannot be used in this process.
58
+ */
59
+ export function isMarketStatsUnavailable(error) {
60
+ const message = error instanceof Error ? error.message : String(error);
61
+ return (message.includes('has not been registered') ||
62
+ message.includes('has not been delegated'));
63
+ }
64
+ export function fallbackJitterMs(pollIntervalMs, random) {
65
+ const cap = Math.min(Math.max(pollIntervalMs, 0), MAX_FALLBACK_JITTER_MS);
66
+ if (cap === 0) {
67
+ return 0;
68
+ }
69
+ return Math.floor(random() * cap);
70
+ }
71
+ function canonicalAssetId(assetId) {
72
+ try {
73
+ return normalizeAssetId(assetId);
74
+ }
75
+ catch {
76
+ return assetId;
77
+ }
78
+ }
79
+ /**
80
+ * Opens market-stats channels for the price-fetch set.
81
+ */
82
+ export class MarketStatsPriceStream {
83
+ #messenger;
84
+ #getSelectedCurrency;
85
+ #getPollIntervalMs;
86
+ #requestPoll;
87
+ #random;
88
+ #onChainStatus;
89
+ /**
90
+ * Asset ids from the last reconcile. An id that leaves this set is
91
+ * unsubscribed. Channels opened outside the price-fetch set are left open.
92
+ */
93
+ #pricedAssetIds = new Set();
94
+ #pollNotBefore = new Map();
95
+ #lock = Promise.resolve();
96
+ constructor(options) {
97
+ this.#messenger = options.messenger;
98
+ this.#getSelectedCurrency = options.getSelectedCurrency;
99
+ this.#getPollIntervalMs = options.getPollIntervalMs;
100
+ this.#requestPoll = options.requestPoll;
101
+ this.#random = options.random ?? Math.random;
102
+ this.#onChainStatus = (payload) => {
103
+ this.#handleChainStatus(payload);
104
+ };
105
+ this.#messenger.subscribe('MarketStatsService:chainStatusChanged', this.#onChainStatus);
106
+ }
107
+ /**
108
+ * Asset ids with an open market-stats channel for the selected currency.
109
+ *
110
+ * @returns Ids the service currently has open. Empty when streaming is off.
111
+ */
112
+ async subscribedAssetIds() {
113
+ const currency = this.#getSelectedCurrency().toLowerCase();
114
+ const subscriptions = await this.#readSubscriptions();
115
+ if (!subscriptions) {
116
+ return new Set();
117
+ }
118
+ return new Set(subscriptions
119
+ .filter((subscription) => subscription.currency.toLowerCase() === currency)
120
+ .map((subscription) => canonicalAssetId(subscription.assetId)));
121
+ }
122
+ /**
123
+ * Chain ids `getChainStatuses` currently reports as down.
124
+ * Empty when MarketStatsService is not registered.
125
+ *
126
+ * @returns Down chain ids.
127
+ */
128
+ async downChainIds() {
129
+ const statuses = await this.#readChainStatuses();
130
+ if (!statuses) {
131
+ return new Set();
132
+ }
133
+ return new Set(statuses
134
+ .filter((entry) => entry.status === 'down')
135
+ .map((entry) => entry.chainId));
136
+ }
137
+ /**
138
+ * Whether this asset should be priced from `/v3/spot-prices` on the poll.
139
+ * Down chains are skipped until their jitter window ends, then polled.
140
+ *
141
+ * @param assetId - CAIP-19 asset id.
142
+ * @param now - Current time in ms.
143
+ * @param subscribed - Asset ids `getSubscriptions` currently has open.
144
+ * @param downChains - Chain ids `getChainStatuses` reports as down.
145
+ * @returns True when the poll should fetch this asset.
146
+ */
147
+ shouldPoll(assetId, now, subscribed, downChains) {
148
+ const chainId = chainIdFromAssetId(assetId);
149
+ if (chainId && (this.#pollNotBefore.get(chainId) ?? 0) > now) {
150
+ return false;
151
+ }
152
+ if (chainId && downChains.has(chainId)) {
153
+ return true;
154
+ }
155
+ return !subscribed.has(canonicalAssetId(assetId));
156
+ }
157
+ /**
158
+ * Subscribe price-fetch assets marked `wssSupport`.
159
+ * Drop channels for assets that left that set.
160
+ *
161
+ * @param candidates - Price-fetch assets in the current subscription scope.
162
+ */
163
+ async reconcile(candidates) {
164
+ await this.#withLock(async () => {
165
+ const selectedCurrency = this.#getSelectedCurrency();
166
+ const priced = new Set(candidates.map((candidate) => canonicalAssetId(candidate.assetId)));
167
+ const subscribing = selectAssetsToStream(candidates).map((assetId) => ({
168
+ assetId: canonicalAssetId(assetId),
169
+ currency: selectedCurrency,
170
+ }));
171
+ const current = await this.#readSubscriptions();
172
+ if (!current) {
173
+ return;
174
+ }
175
+ const previous = this.#pricedAssetIds;
176
+ this.#pricedAssetIds = priced;
177
+ await this.#unsubscribe(current.filter((subscription) => {
178
+ const assetId = canonicalAssetId(subscription.assetId);
179
+ return previous.has(assetId) && !priced.has(assetId);
180
+ }));
181
+ if (subscribing.length > 0) {
182
+ try {
183
+ await this.#messenger.call('MarketStatsService:subscribe', subscribing);
184
+ }
185
+ catch (error) {
186
+ if (isMarketStatsUnavailable(error)) {
187
+ log('Market stats stream is not available; polling prices');
188
+ }
189
+ else {
190
+ log('Market stats subscribe failed; polling assets the service did not open', { error });
191
+ }
192
+ }
193
+ }
194
+ });
195
+ }
196
+ /**
197
+ * Drop one reference on each open channel for a price-fetch asset.
198
+ * Used when the selected currency changes, and when the price subscription ends.
199
+ */
200
+ async releaseSubscriptions() {
201
+ await this.#withLock(async () => {
202
+ await this.#releaseOpened();
203
+ });
204
+ }
205
+ /**
206
+ * Remove listeners and drop channels this stream opened.
207
+ */
208
+ destroy() {
209
+ this.#messenger.unsubscribe('MarketStatsService:chainStatusChanged', this.#onChainStatus);
210
+ this.#releaseOpened().catch(() => {
211
+ // destroy is sync; a failed unsubscribe is already logged
212
+ });
213
+ }
214
+ async #releaseOpened() {
215
+ if (this.#pricedAssetIds.size === 0) {
216
+ return;
217
+ }
218
+ const current = await this.#readSubscriptions();
219
+ if (!current) {
220
+ return;
221
+ }
222
+ await this.#unsubscribe(current.filter((subscription) => this.#pricedAssetIds.has(canonicalAssetId(subscription.assetId))));
223
+ }
224
+ async #readChainStatuses() {
225
+ try {
226
+ return this.#messenger.call('MarketStatsService:getChainStatuses');
227
+ }
228
+ catch (error) {
229
+ if (isMarketStatsUnavailable(error)) {
230
+ return null;
231
+ }
232
+ throw error;
233
+ }
234
+ }
235
+ async #readSubscriptions() {
236
+ try {
237
+ return this.#messenger.call('MarketStatsService:getSubscriptions');
238
+ }
239
+ catch (error) {
240
+ if (isMarketStatsUnavailable(error)) {
241
+ log('Market stats stream is not available; polling prices');
242
+ return null;
243
+ }
244
+ throw error;
245
+ }
246
+ }
247
+ async #unsubscribe(open) {
248
+ if (open.length === 0) {
249
+ return;
250
+ }
251
+ try {
252
+ await this.#messenger.call('MarketStatsService:unsubscribe', open.map(({ assetId, currency }) => ({
253
+ assetId: canonicalAssetId(assetId),
254
+ currency,
255
+ })));
256
+ }
257
+ catch (error) {
258
+ log('Market stats unsubscribe failed', {
259
+ assetIds: open.map((info) => info.assetId),
260
+ error,
261
+ });
262
+ }
263
+ }
264
+ #handleChainStatus(payload) {
265
+ if (payload.status === 'down') {
266
+ const jitter = fallbackJitterMs(this.#getPollIntervalMs(), this.#random);
267
+ const notBefore = Date.now() + jitter;
268
+ for (const chainId of payload.chainIds) {
269
+ this.#pollNotBefore.set(chainId, notBefore);
270
+ }
271
+ this.#requestPoll(jitter, {
272
+ chainIds: payload.chainIds,
273
+ status: 'down',
274
+ });
275
+ return;
276
+ }
277
+ for (const chainId of payload.chainIds) {
278
+ this.#pollNotBefore.delete(chainId);
279
+ }
280
+ this.#requestPoll(0, { chainIds: payload.chainIds, status: 'up' });
281
+ }
282
+ async #withLock(fn) {
283
+ const previous = this.#lock;
284
+ let release = () => undefined;
285
+ this.#lock = new Promise((resolve) => {
286
+ release = resolve;
287
+ });
288
+ await previous;
289
+ try {
290
+ await fn();
291
+ }
292
+ finally {
293
+ release();
294
+ }
295
+ }
296
+ }
297
+ //# sourceMappingURL=MarketStatsPriceStream.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MarketStatsPriceStream.js","sourceRoot":"","sources":["../../src/data-sources/MarketStatsPriceStream.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Subscribes the price-fetch set when the Price API marks it `wssSupport`.\n *\n * That set is balances and custom assets on the selected accounts and chains,\n * minus hidden assets. Open channels live on MarketStatsService. Reconcile\n * reads `getSubscriptions`. A subscribe that does not open is retried on the\n * next reconcile, and those assets stay on the poll. Chain health is read\n * from `getChainStatuses`. A chain reported down is polled after a short\n * jitter until it recovers. When MarketStatsService is not wired, every\n * asset is polled.\n */\n\nimport type {\n MarketStatsServiceActions,\n MarketStatsServiceChainStatusChangedEvent,\n SupportedCurrency,\n} from '@metamask/core-backend';\nimport type { Messenger } from '@metamask/messenger';\nimport { parseCaipAssetType } from '@metamask/utils';\n\nimport { createModuleLogger, projectLogger } from '../logger.js';\nimport type { Caip19AssetId } from '../types.js';\nimport { normalizeAssetId } from '../utils/index.js';\n\nconst log = createModuleLogger(projectLogger, 'MarketStatsPriceStream');\n\n/** Cap on the random delay before a chain-down poll, to avoid a thundering herd. */\nconst MAX_FALLBACK_JITTER_MS = 5_000;\n\nexport type MarketStatsPriceStreamMessenger = Messenger<\n string,\n MarketStatsServiceActions,\n MarketStatsServiceChainStatusChangedEvent\n>;\n\nexport type StreamCandidate = {\n assetId: Caip19AssetId;\n wssSupport: boolean;\n};\n\ntype MarketStatsSubscription = {\n assetId: string;\n currency: string;\n};\n\nexport type MarketStatsPriceStreamOptions = {\n messenger: MarketStatsPriceStreamMessenger;\n getSelectedCurrency: () => SupportedCurrency;\n getPollIntervalMs: () => number;\n requestPoll: (\n delayMs: number,\n details: { chainIds: string[]; status: 'up' | 'down' },\n ) => void;\n /** Defaults to Math.random. Tests inject a fixed value. */\n random?: () => number;\n};\n\n/**\n * Read `wssSupport` off a spot-price entry.\n *\n * @param data - One asset's `/v3/spot-prices` entry.\n * @returns Whether the asset can stream.\n */\nexport function readSpotPriceStreamEligibility(data: object): boolean {\n return (data as { wssSupport?: unknown }).wssSupport === true;\n}\n\n/**\n * Assets the Price API marks as streamable.\n *\n * @param candidates - Assets learned from the latest spot-price response.\n * @returns Asset ids to subscribe.\n */\nexport function selectAssetsToStream(\n candidates: StreamCandidate[],\n): Caip19AssetId[] {\n return candidates\n .filter((candidate) => candidate.wssSupport)\n .map((candidate) => candidate.assetId);\n}\n\n/**\n * CAIP-2 chain id from a CAIP-19 asset id, or undefined when the id is invalid.\n *\n * @param assetId - CAIP-19 asset identifier.\n * @returns The chain id.\n */\nexport function chainIdFromAssetId(assetId: string): string | undefined {\n try {\n return parseCaipAssetType(assetId as Caip19AssetId).chainId;\n } catch {\n return undefined;\n }\n}\n\n/**\n * True when the messenger has no MarketStatsService handler.\n * Price updates then stay on the poll.\n *\n * @param error - Failure from `messenger.call`.\n * @returns Whether streaming cannot be used in this process.\n */\nexport function isMarketStatsUnavailable(error: unknown): boolean {\n const message = error instanceof Error ? error.message : String(error);\n return (\n message.includes('has not been registered') ||\n message.includes('has not been delegated')\n );\n}\n\nexport function fallbackJitterMs(\n pollIntervalMs: number,\n random: () => number,\n): number {\n const cap = Math.min(Math.max(pollIntervalMs, 0), MAX_FALLBACK_JITTER_MS);\n if (cap === 0) {\n return 0;\n }\n return Math.floor(random() * cap);\n}\n\nfunction canonicalAssetId(assetId: string): string {\n try {\n return normalizeAssetId(assetId as Caip19AssetId);\n } catch {\n return assetId;\n }\n}\n\n/**\n * Opens market-stats channels for the price-fetch set.\n */\nexport class MarketStatsPriceStream {\n readonly #messenger: MarketStatsPriceStreamMessenger;\n\n readonly #getSelectedCurrency: () => SupportedCurrency;\n\n readonly #getPollIntervalMs: () => number;\n\n readonly #requestPoll: MarketStatsPriceStreamOptions['requestPoll'];\n\n readonly #random: () => number;\n\n readonly #onChainStatus: (payload: {\n chainIds: string[];\n status: 'up' | 'down';\n timestamp?: number;\n }) => void;\n\n /**\n * Asset ids from the last reconcile. An id that leaves this set is\n * unsubscribed. Channels opened outside the price-fetch set are left open.\n */\n #pricedAssetIds = new Set<string>();\n\n readonly #pollNotBefore = new Map<string, number>();\n\n #lock: Promise<void> = Promise.resolve();\n\n constructor(options: MarketStatsPriceStreamOptions) {\n this.#messenger = options.messenger;\n this.#getSelectedCurrency = options.getSelectedCurrency;\n this.#getPollIntervalMs = options.getPollIntervalMs;\n this.#requestPoll = options.requestPoll;\n this.#random = options.random ?? Math.random;\n\n this.#onChainStatus = (payload): void => {\n this.#handleChainStatus(payload);\n };\n\n this.#messenger.subscribe(\n 'MarketStatsService:chainStatusChanged',\n this.#onChainStatus,\n );\n }\n\n /**\n * Asset ids with an open market-stats channel for the selected currency.\n *\n * @returns Ids the service currently has open. Empty when streaming is off.\n */\n async subscribedAssetIds(): Promise<ReadonlySet<string>> {\n const currency = this.#getSelectedCurrency().toLowerCase();\n const subscriptions = await this.#readSubscriptions();\n if (!subscriptions) {\n return new Set();\n }\n return new Set(\n subscriptions\n .filter(\n (subscription) => subscription.currency.toLowerCase() === currency,\n )\n .map((subscription) => canonicalAssetId(subscription.assetId)),\n );\n }\n\n /**\n * Chain ids `getChainStatuses` currently reports as down.\n * Empty when MarketStatsService is not registered.\n *\n * @returns Down chain ids.\n */\n async downChainIds(): Promise<ReadonlySet<string>> {\n const statuses = await this.#readChainStatuses();\n if (!statuses) {\n return new Set();\n }\n return new Set(\n statuses\n .filter((entry) => entry.status === 'down')\n .map((entry) => entry.chainId),\n );\n }\n\n /**\n * Whether this asset should be priced from `/v3/spot-prices` on the poll.\n * Down chains are skipped until their jitter window ends, then polled.\n *\n * @param assetId - CAIP-19 asset id.\n * @param now - Current time in ms.\n * @param subscribed - Asset ids `getSubscriptions` currently has open.\n * @param downChains - Chain ids `getChainStatuses` reports as down.\n * @returns True when the poll should fetch this asset.\n */\n shouldPoll(\n assetId: Caip19AssetId,\n now: number,\n subscribed: ReadonlySet<string>,\n downChains: ReadonlySet<string>,\n ): boolean {\n const chainId = chainIdFromAssetId(assetId);\n if (chainId && (this.#pollNotBefore.get(chainId) ?? 0) > now) {\n return false;\n }\n if (chainId && downChains.has(chainId)) {\n return true;\n }\n return !subscribed.has(canonicalAssetId(assetId));\n }\n\n /**\n * Subscribe price-fetch assets marked `wssSupport`.\n * Drop channels for assets that left that set.\n *\n * @param candidates - Price-fetch assets in the current subscription scope.\n */\n async reconcile(candidates: StreamCandidate[]): Promise<void> {\n await this.#withLock(async () => {\n const selectedCurrency = this.#getSelectedCurrency();\n const priced = new Set(\n candidates.map((candidate) => canonicalAssetId(candidate.assetId)),\n );\n const subscribing = selectAssetsToStream(candidates).map((assetId) => ({\n assetId: canonicalAssetId(assetId) as Caip19AssetId,\n currency: selectedCurrency,\n }));\n\n const current = await this.#readSubscriptions();\n if (!current) {\n return;\n }\n\n const previous = this.#pricedAssetIds;\n this.#pricedAssetIds = priced;\n await this.#unsubscribe(\n current.filter((subscription) => {\n const assetId = canonicalAssetId(subscription.assetId);\n return previous.has(assetId) && !priced.has(assetId);\n }),\n );\n if (subscribing.length > 0) {\n try {\n await this.#messenger.call(\n 'MarketStatsService:subscribe',\n subscribing,\n );\n } catch (error) {\n if (isMarketStatsUnavailable(error)) {\n log('Market stats stream is not available; polling prices');\n } else {\n log(\n 'Market stats subscribe failed; polling assets the service did not open',\n { error },\n );\n }\n }\n }\n });\n }\n\n /**\n * Drop one reference on each open channel for a price-fetch asset.\n * Used when the selected currency changes, and when the price subscription ends.\n */\n async releaseSubscriptions(): Promise<void> {\n await this.#withLock(async () => {\n await this.#releaseOpened();\n });\n }\n\n /**\n * Remove listeners and drop channels this stream opened.\n */\n destroy(): void {\n this.#messenger.unsubscribe(\n 'MarketStatsService:chainStatusChanged',\n this.#onChainStatus,\n );\n this.#releaseOpened().catch(() => {\n // destroy is sync; a failed unsubscribe is already logged\n });\n }\n\n async #releaseOpened(): Promise<void> {\n if (this.#pricedAssetIds.size === 0) {\n return;\n }\n const current = await this.#readSubscriptions();\n if (!current) {\n return;\n }\n await this.#unsubscribe(\n current.filter((subscription) =>\n this.#pricedAssetIds.has(canonicalAssetId(subscription.assetId)),\n ),\n );\n }\n\n async #readChainStatuses(): Promise<\n { chainId: string; status: 'up' | 'down' }[] | null\n > {\n try {\n return this.#messenger.call('MarketStatsService:getChainStatuses');\n } catch (error) {\n if (isMarketStatsUnavailable(error)) {\n return null;\n }\n throw error;\n }\n }\n\n async #readSubscriptions(): Promise<MarketStatsSubscription[] | null> {\n try {\n return this.#messenger.call('MarketStatsService:getSubscriptions');\n } catch (error) {\n if (isMarketStatsUnavailable(error)) {\n log('Market stats stream is not available; polling prices');\n return null;\n }\n throw error;\n }\n }\n\n async #unsubscribe(open: readonly MarketStatsSubscription[]): Promise<void> {\n if (open.length === 0) {\n return;\n }\n try {\n await this.#messenger.call(\n 'MarketStatsService:unsubscribe',\n open.map(({ assetId, currency }) => ({\n assetId: canonicalAssetId(assetId),\n currency,\n })),\n );\n } catch (error) {\n log('Market stats unsubscribe failed', {\n assetIds: open.map((info) => info.assetId),\n error,\n });\n }\n }\n\n #handleChainStatus(payload: {\n chainIds: string[];\n status: 'up' | 'down';\n }): void {\n if (payload.status === 'down') {\n const jitter = fallbackJitterMs(this.#getPollIntervalMs(), this.#random);\n const notBefore = Date.now() + jitter;\n for (const chainId of payload.chainIds) {\n this.#pollNotBefore.set(chainId, notBefore);\n }\n this.#requestPoll(jitter, {\n chainIds: payload.chainIds,\n status: 'down',\n });\n return;\n }\n\n for (const chainId of payload.chainIds) {\n this.#pollNotBefore.delete(chainId);\n }\n this.#requestPoll(0, { chainIds: payload.chainIds, status: 'up' });\n }\n\n async #withLock(fn: () => Promise<void>): Promise<void> {\n const previous = this.#lock;\n let release: () => void = () => undefined;\n this.#lock = new Promise<void>((resolve) => {\n release = resolve;\n });\n await previous;\n try {\n await fn();\n } finally {\n release();\n }\n }\n}\n"]}