@metamask-previews/assets-controller 0.0.0-preview-6dfa4aeba → 0.1.0-preview-8f3469e9c

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.
@@ -1 +1 @@
1
- {"version":3,"file":"initDataSources.cjs","sourceRoot":"","sources":["../../src/data-sources/initDataSources.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ApiPlatformClient } from '@metamask/core-backend';\nimport { Messenger } from '@metamask/messenger';\nimport type { ActionConstraint, EventConstraint } from '@metamask/messenger';\n\nimport { AccountsApiDataSource } from './AccountsApiDataSource';\nimport type {\n AccountsApiDataSourceActions,\n AccountsApiDataSourceAllowedActions,\n AccountsApiDataSourceEvents,\n AccountsApiDataSourceMessenger,\n} from './AccountsApiDataSource';\nimport { BackendWebsocketDataSource } from './BackendWebsocketDataSource';\nimport type {\n BackendWebsocketDataSourceActions,\n BackendWebsocketDataSourceAllowedActions,\n BackendWebsocketDataSourceAllowedEvents,\n BackendWebsocketDataSourceEvents,\n BackendWebsocketDataSourceMessenger,\n} from './BackendWebsocketDataSource';\nimport { PriceDataSource } from './PriceDataSource';\nimport type {\n PriceDataSourceActions,\n PriceDataSourceAllowedActions,\n PriceDataSourceEvents,\n PriceDataSourceMessenger,\n} from './PriceDataSource';\nimport { RpcDataSource } from './RpcDataSource';\nimport type {\n RpcDataSourceActions,\n RpcDataSourceAllowedActions,\n RpcDataSourceAllowedEvents,\n RpcDataSourceEvents,\n RpcDataSourceMessenger,\n} from './RpcDataSource';\nimport { SnapDataSource } from './SnapDataSource';\nimport type {\n SnapDataSourceActions,\n SnapDataSourceEvents,\n SnapDataSourceMessenger,\n} from './SnapDataSource';\nimport { TokenDataSource } from './TokenDataSource';\nimport type {\n TokenDataSourceActions,\n TokenDataSourceMessenger,\n} from './TokenDataSource';\nimport type {\n DetectionMiddlewareActions,\n DetectionMiddlewareMessenger,\n} from '../middlewares';\nimport { DetectionMiddleware } from '../middlewares';\n\n// ============================================================================\n// ACTION & EVENT TYPES\n// ============================================================================\n\n/**\n * All actions from data sources.\n */\nexport type DataSourceActions =\n | RpcDataSourceActions\n | BackendWebsocketDataSourceActions\n | AccountsApiDataSourceActions\n | SnapDataSourceActions\n | TokenDataSourceActions\n | PriceDataSourceActions\n | DetectionMiddlewareActions;\n\n/**\n * All events from data sources.\n */\nexport type DataSourceEvents =\n | RpcDataSourceEvents\n | BackendWebsocketDataSourceEvents\n | AccountsApiDataSourceEvents\n | SnapDataSourceEvents\n | PriceDataSourceEvents;\n\n/**\n * All external actions that data sources need.\n * Note: TokenDataSource, AccountsApiDataSource, and PriceDataSource now use ApiPlatformClient\n * directly, so they don't need BackendApiClient actions delegated.\n */\nexport type DataSourceAllowedActions =\n | RpcDataSourceAllowedActions\n | BackendWebsocketDataSourceAllowedActions\n | AccountsApiDataSourceAllowedActions\n | PriceDataSourceAllowedActions;\n\n/**\n * All external events that data sources need.\n */\nexport type DataSourceAllowedEvents =\n | RpcDataSourceAllowedEvents\n | BackendWebsocketDataSourceAllowedEvents;\n\n/**\n * Root messenger type for all data sources.\n */\nexport type RootMessenger<\n AllowedActions extends ActionConstraint,\n AllowedEvents extends EventConstraint,\n> = Messenger<string, AllowedActions, AllowedEvents>;\n\n// ============================================================================\n// MESSENGER TYPES\n// ============================================================================\n\n/**\n * All messengers for data sources.\n */\nexport type DataSourceMessengers = {\n rpcMessenger: RpcDataSourceMessenger;\n backendWebsocketMessenger: BackendWebsocketDataSourceMessenger;\n accountsApiMessenger: AccountsApiDataSourceMessenger;\n snapMessenger: SnapDataSourceMessenger;\n tokenMessenger: TokenDataSourceMessenger;\n priceMessenger: PriceDataSourceMessenger;\n detectionMessenger: DetectionMiddlewareMessenger;\n};\n\n/**\n * Options for initializing messengers.\n */\nexport type InitMessengersOptions<\n AllowedActions extends ActionConstraint,\n AllowedEvents extends EventConstraint,\n> = {\n /** The root controller messenger */\n messenger: RootMessenger<AllowedActions, AllowedEvents>;\n};\n\n// ============================================================================\n// CONTROLLER TYPES\n// ============================================================================\n\n/**\n * All data source instances.\n */\nexport type DataSources = {\n rpcDataSource: RpcDataSource;\n backendWebsocketDataSource: BackendWebsocketDataSource;\n accountsApiDataSource: AccountsApiDataSource;\n snapDataSource: SnapDataSource;\n tokenDataSource: TokenDataSource;\n priceDataSource: PriceDataSource;\n detectionMiddleware: DetectionMiddleware;\n};\n\n/**\n * Configuration options for RpcDataSource.\n */\nexport type RpcDataSourceConfig = {\n /** Balance polling interval in ms (default: 30s) */\n balanceInterval?: number;\n /** Token detection polling interval in ms (default: 180s / 3 min) */\n detectionInterval?: number;\n /** Whether token detection is enabled (default: false) */\n tokenDetectionEnabled?: boolean;\n /** Request timeout in ms (default: 10s) */\n timeout?: number;\n};\n\n/**\n * Options for initializing data sources.\n */\nexport type InitDataSourcesOptions = {\n /** Messengers for each data source */\n messengers: DataSourceMessengers;\n\n /** ApiPlatformClient for cached API calls */\n queryApiClient: ApiPlatformClient;\n\n /** Optional configuration for RpcDataSource */\n rpcDataSourceConfig?: RpcDataSourceConfig;\n};\n\n// ============================================================================\n// MESSENGER INITIALIZATION\n// ============================================================================\n\n/**\n * Initialize all messengers for data sources.\n *\n * This function creates child messengers for each data source from the root\n * controller messenger, with proper action/event delegation.\n *\n * @example\n * ```typescript\n * import { initMessengers } from '@metamask/assets-controllers';\n *\n * const messengers = initMessengers({ messenger });\n * ```\n *\n * @param options - Configuration options\n * @returns Object containing all messengers\n */\nexport function initMessengers<\n AllowedActions extends ActionConstraint,\n AllowedEvents extends EventConstraint,\n>(\n options: InitMessengersOptions<AllowedActions, AllowedEvents>,\n): DataSourceMessengers {\n const { messenger } = options;\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const rootMessenger = messenger as any;\n\n // RPC Data Source messenger\n const rpcMessenger = new Messenger({\n namespace: 'RpcDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: [\n 'NetworkController:getState',\n 'NetworkController:getNetworkClientById',\n 'AssetsController:activeChainsUpdate',\n 'AssetsController:assetsUpdate',\n 'AssetsController:getState',\n 'TokenListController:getState',\n 'NetworkEnablementController:getState',\n ],\n events: ['NetworkController:stateChange'],\n messenger: rpcMessenger,\n });\n\n // Backend Websocket Data Source messenger\n const backendWebsocketMessenger = new Messenger({\n namespace: 'BackendWebsocketDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: [\n 'BackendWebSocketService:subscribe',\n 'BackendWebSocketService:unsubscribe',\n 'BackendWebSocketService:getState',\n 'BackendWebSocketService:getConnectionInfo',\n 'BackendWebSocketService:findSubscriptionsByChannelPrefix',\n 'AssetsController:activeChainsUpdate',\n 'AssetsController:assetsUpdate',\n ],\n events: [\n 'BackendWebSocketService:stateChange',\n 'BackendWebSocketService:connectionStateChanged',\n 'AccountsApiDataSource:activeChainsUpdated',\n ],\n messenger: backendWebsocketMessenger,\n });\n\n // Accounts API Data Source messenger\n // Note: AccountsApiDataSource uses ApiPlatformClient directly, so no BackendApiClient actions needed\n const accountsApiMessenger = new Messenger({\n namespace: 'AccountsApiDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: [\n 'AssetsController:activeChainsUpdate',\n 'AssetsController:assetsUpdate',\n ],\n messenger: accountsApiMessenger,\n });\n\n // Snap Data Source messenger\n const snapMessenger = new Messenger({\n namespace: 'SnapDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: [\n 'AssetsController:activeChainsUpdate',\n 'AssetsController:assetsUpdate',\n // SnapController actions for direct snap communication\n 'SnapController:getRunnableSnaps',\n 'SnapController:handleRequest',\n // PermissionController action for dynamic snap discovery\n 'PermissionController:getPermissions',\n ],\n events: [\n // Snap keyring balance updates - snaps emit this when balances change\n 'AccountsController:accountBalancesUpdated',\n // Permission changes for runtime snap discovery\n 'PermissionController:stateChange',\n ],\n messenger: snapMessenger,\n });\n\n // Token Data Source messenger\n // Note: TokenDataSource uses ApiPlatformClient directly, so no BackendApiClient actions needed\n const tokenMessenger = new Messenger({\n namespace: 'TokenDataSource',\n parent: rootMessenger,\n });\n\n // Price Data Source messenger\n // Note: PriceDataSource uses ApiPlatformClient directly, so no BackendApiClient actions needed\n const priceMessenger = new Messenger({\n namespace: 'PriceDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: ['AssetsController:getState', 'AssetsController:assetsUpdate'],\n messenger: priceMessenger,\n });\n\n // Detection Middleware messenger\n const detectionMessenger = new Messenger({\n namespace: 'DetectionMiddleware',\n parent: rootMessenger,\n });\n\n return {\n rpcMessenger: rpcMessenger as RpcDataSourceMessenger,\n backendWebsocketMessenger:\n backendWebsocketMessenger as BackendWebsocketDataSourceMessenger,\n accountsApiMessenger:\n accountsApiMessenger as AccountsApiDataSourceMessenger,\n snapMessenger: snapMessenger as SnapDataSourceMessenger,\n tokenMessenger: tokenMessenger as TokenDataSourceMessenger,\n priceMessenger: priceMessenger as PriceDataSourceMessenger,\n detectionMessenger: detectionMessenger as DetectionMiddlewareMessenger,\n };\n}\n\n// ============================================================================\n// DATA SOURCE INITIALIZATION\n// ============================================================================\n\n/**\n * Initialize all data sources and middlewares.\n *\n * This function creates and initializes all data sources, registering their\n * action handlers with the messenger.\n *\n * @example\n * ```typescript\n * import { initMessengers, initDataSources } from '@metamask/assets-controllers';\n *\n * // Initialize messengers first\n * const messengers = initMessengers({ controllerMessenger });\n *\n * // Then initialize data sources\n * const dataSources = initDataSources({\n * messengers,\n * queryApiClient,\n * });\n * ```\n *\n * @param options - Configuration options\n * @returns Object containing all data source instances\n */\nexport function initDataSources(options: InitDataSourcesOptions): DataSources {\n const { messengers, queryApiClient, rpcDataSourceConfig } = options;\n\n // Initialize primary data sources (provide balance data)\n const rpcDataSource = new RpcDataSource({\n messenger: messengers.rpcMessenger,\n ...rpcDataSourceConfig,\n });\n\n const backendWebsocketDataSource = new BackendWebsocketDataSource({\n messenger: messengers.backendWebsocketMessenger,\n });\n\n const accountsApiDataSource = new AccountsApiDataSource({\n messenger: messengers.accountsApiMessenger,\n queryApiClient,\n });\n\n const snapDataSource = new SnapDataSource({\n messenger: messengers.snapMessenger,\n });\n\n // Initialize middleware data sources (enrich responses)\n const tokenDataSource = new TokenDataSource({\n messenger: messengers.tokenMessenger,\n queryApiClient,\n });\n\n const priceDataSource = new PriceDataSource({\n messenger: messengers.priceMessenger,\n queryApiClient,\n });\n\n const detectionMiddleware = new DetectionMiddleware({\n messenger: messengers.detectionMessenger,\n });\n\n return {\n rpcDataSource,\n backendWebsocketDataSource,\n accountsApiDataSource,\n snapDataSource,\n tokenDataSource,\n priceDataSource,\n detectionMiddleware,\n };\n}\n"]}
1
+ {"version":3,"file":"initDataSources.cjs","sourceRoot":"","sources":["../../src/data-sources/initDataSources.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ApiPlatformClient } from '@metamask/core-backend';\nimport { Messenger } from '@metamask/messenger';\nimport type { ActionConstraint, EventConstraint } from '@metamask/messenger';\n\nimport { AccountsApiDataSource } from './AccountsApiDataSource';\nimport type {\n AccountsApiDataSourceActions,\n AccountsApiDataSourceAllowedActions,\n AccountsApiDataSourceEvents,\n AccountsApiDataSourceMessenger,\n} from './AccountsApiDataSource';\nimport { BackendWebsocketDataSource } from './BackendWebsocketDataSource';\nimport type {\n BackendWebsocketDataSourceActions,\n BackendWebsocketDataSourceAllowedActions,\n BackendWebsocketDataSourceAllowedEvents,\n BackendWebsocketDataSourceEvents,\n BackendWebsocketDataSourceMessenger,\n} from './BackendWebsocketDataSource';\nimport { PriceDataSource } from './PriceDataSource';\nimport type {\n PriceDataSourceActions,\n PriceDataSourceAllowedActions,\n PriceDataSourceEvents,\n PriceDataSourceMessenger,\n} from './PriceDataSource';\nimport { RpcDataSource } from './RpcDataSource';\nimport type {\n RpcDataSourceActions,\n RpcDataSourceAllowedActions,\n RpcDataSourceAllowedEvents,\n RpcDataSourceEvents,\n RpcDataSourceMessenger,\n} from './RpcDataSource';\nimport { SnapDataSource } from './SnapDataSource';\nimport type {\n SnapDataSourceActions,\n SnapDataSourceEvents,\n SnapDataSourceMessenger,\n} from './SnapDataSource';\nimport { TokenDataSource } from './TokenDataSource';\nimport type {\n TokenDataSourceActions,\n TokenDataSourceMessenger,\n} from './TokenDataSource';\nimport type {\n DetectionMiddlewareActions,\n DetectionMiddlewareMessenger,\n} from '../middlewares';\nimport { DetectionMiddleware } from '../middlewares';\n\n// ============================================================================\n// ACTION & EVENT TYPES\n// ============================================================================\n\n/**\n * All actions from data sources.\n */\nexport type DataSourceActions =\n | RpcDataSourceActions\n | BackendWebsocketDataSourceActions\n | AccountsApiDataSourceActions\n | SnapDataSourceActions\n | TokenDataSourceActions\n | PriceDataSourceActions\n | DetectionMiddlewareActions;\n\n/**\n * All events from data sources.\n */\nexport type DataSourceEvents =\n | RpcDataSourceEvents\n | BackendWebsocketDataSourceEvents\n | AccountsApiDataSourceEvents\n | SnapDataSourceEvents\n | PriceDataSourceEvents;\n\n/**\n * All external actions that data sources need.\n * Note: TokenDataSource, AccountsApiDataSource, and PriceDataSource now use ApiPlatformClient\n * directly, so they don't need BackendApiClient actions delegated.\n */\nexport type DataSourceAllowedActions =\n | RpcDataSourceAllowedActions\n | BackendWebsocketDataSourceAllowedActions\n | AccountsApiDataSourceAllowedActions\n | PriceDataSourceAllowedActions;\n\n/**\n * All external events that data sources need.\n */\nexport type DataSourceAllowedEvents =\n | RpcDataSourceAllowedEvents\n | BackendWebsocketDataSourceAllowedEvents;\n\n/**\n * Root messenger type for all data sources.\n */\nexport type RootMessenger<\n AllowedActions extends ActionConstraint,\n AllowedEvents extends EventConstraint,\n> = Messenger<string, AllowedActions, AllowedEvents>;\n\n// ============================================================================\n// MESSENGER TYPES\n// ============================================================================\n\n/**\n * All messengers for data sources.\n */\nexport type DataSourceMessengers = {\n rpcMessenger: RpcDataSourceMessenger;\n backendWebsocketMessenger: BackendWebsocketDataSourceMessenger;\n accountsApiMessenger: AccountsApiDataSourceMessenger;\n snapMessenger: SnapDataSourceMessenger;\n tokenMessenger: TokenDataSourceMessenger;\n priceMessenger: PriceDataSourceMessenger;\n detectionMessenger: DetectionMiddlewareMessenger;\n};\n\n/**\n * Options for initializing messengers.\n */\nexport type InitMessengersOptions<\n AllowedActions extends ActionConstraint,\n AllowedEvents extends EventConstraint,\n> = {\n /** The root controller messenger */\n messenger: RootMessenger<AllowedActions, AllowedEvents>;\n /** Function to determine if initialization should proceed. Defaults to true. */\n isEnabled?: () => boolean;\n};\n\n// ============================================================================\n// CONTROLLER TYPES\n// ============================================================================\n\n/**\n * All data source instances.\n */\nexport type DataSources = {\n rpcDataSource: RpcDataSource;\n backendWebsocketDataSource: BackendWebsocketDataSource;\n accountsApiDataSource: AccountsApiDataSource;\n snapDataSource: SnapDataSource;\n tokenDataSource: TokenDataSource;\n priceDataSource: PriceDataSource;\n detectionMiddleware: DetectionMiddleware;\n};\n\n/**\n * Configuration options for RpcDataSource.\n */\nexport type RpcDataSourceConfig = {\n /** Balance polling interval in ms (default: 30s) */\n balanceInterval?: number;\n /** Token detection polling interval in ms (default: 180s / 3 min) */\n detectionInterval?: number;\n /** Whether token detection is enabled (default: false) */\n tokenDetectionEnabled?: boolean;\n /** Request timeout in ms (default: 10s) */\n timeout?: number;\n};\n\n/**\n * Options for initializing data sources.\n */\nexport type InitDataSourcesOptions = {\n /** Messengers for each data source */\n messengers: DataSourceMessengers;\n\n /** ApiPlatformClient for cached API calls */\n queryApiClient: ApiPlatformClient;\n\n /** Optional configuration for RpcDataSource */\n rpcDataSourceConfig?: RpcDataSourceConfig;\n\n /** Function to determine if initialization should proceed. Defaults to true. */\n isEnabled?: () => boolean;\n};\n\n// ============================================================================\n// MESSENGER INITIALIZATION\n// ============================================================================\n\n/**\n * Initialize all messengers for data sources.\n *\n * This function creates child messengers for each data source from the root\n * controller messenger, with proper action/event delegation.\n *\n * @example\n * ```typescript\n * import { initMessengers } from '@metamask/assets-controllers';\n *\n * const messengers = initMessengers({ messenger });\n * ```\n *\n * @param options - Configuration options\n * @returns Object containing all messengers, or null if disabled\n */\nexport function initMessengers<\n AllowedActions extends ActionConstraint,\n AllowedEvents extends EventConstraint,\n>(\n options: InitMessengersOptions<AllowedActions, AllowedEvents>,\n): DataSourceMessengers | null {\n const { messenger, isEnabled = (): boolean => true } = options;\n\n if (!isEnabled()) {\n return null;\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const rootMessenger = messenger as any;\n\n // RPC Data Source messenger\n const rpcMessenger = new Messenger({\n namespace: 'RpcDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: [\n 'NetworkController:getState',\n 'NetworkController:getNetworkClientById',\n 'AssetsController:activeChainsUpdate',\n 'AssetsController:assetsUpdate',\n 'AssetsController:getState',\n 'TokenListController:getState',\n 'NetworkEnablementController:getState',\n ],\n events: ['NetworkController:stateChange'],\n messenger: rpcMessenger,\n });\n\n // Backend Websocket Data Source messenger\n const backendWebsocketMessenger = new Messenger({\n namespace: 'BackendWebsocketDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: [\n 'BackendWebSocketService:subscribe',\n 'BackendWebSocketService:unsubscribe',\n 'BackendWebSocketService:getState',\n 'BackendWebSocketService:getConnectionInfo',\n 'BackendWebSocketService:findSubscriptionsByChannelPrefix',\n 'AssetsController:activeChainsUpdate',\n 'AssetsController:assetsUpdate',\n ],\n events: [\n 'BackendWebSocketService:stateChange',\n 'BackendWebSocketService:connectionStateChanged',\n 'AccountsApiDataSource:activeChainsUpdated',\n ],\n messenger: backendWebsocketMessenger,\n });\n\n // Accounts API Data Source messenger\n // Note: AccountsApiDataSource uses ApiPlatformClient directly, so no BackendApiClient actions needed\n const accountsApiMessenger = new Messenger({\n namespace: 'AccountsApiDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: [\n 'AssetsController:activeChainsUpdate',\n 'AssetsController:assetsUpdate',\n ],\n messenger: accountsApiMessenger,\n });\n\n // Snap Data Source messenger\n const snapMessenger = new Messenger({\n namespace: 'SnapDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: [\n 'AssetsController:activeChainsUpdate',\n 'AssetsController:assetsUpdate',\n // SnapController actions for direct snap communication\n 'SnapController:getRunnableSnaps',\n 'SnapController:handleRequest',\n // PermissionController action for dynamic snap discovery\n 'PermissionController:getPermissions',\n ],\n events: [\n // Snap keyring balance updates - snaps emit this when balances change\n 'AccountsController:accountBalancesUpdated',\n // Permission changes for runtime snap discovery\n 'PermissionController:stateChange',\n ],\n messenger: snapMessenger,\n });\n\n // Token Data Source messenger\n // Note: TokenDataSource uses ApiPlatformClient directly, so no BackendApiClient actions needed\n const tokenMessenger = new Messenger({\n namespace: 'TokenDataSource',\n parent: rootMessenger,\n });\n\n // Price Data Source messenger\n // Note: PriceDataSource uses ApiPlatformClient directly, so no BackendApiClient actions needed\n const priceMessenger = new Messenger({\n namespace: 'PriceDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: ['AssetsController:getState', 'AssetsController:assetsUpdate'],\n messenger: priceMessenger,\n });\n\n // Detection Middleware messenger\n const detectionMessenger = new Messenger({\n namespace: 'DetectionMiddleware',\n parent: rootMessenger,\n });\n\n return {\n rpcMessenger: rpcMessenger as RpcDataSourceMessenger,\n backendWebsocketMessenger:\n backendWebsocketMessenger as BackendWebsocketDataSourceMessenger,\n accountsApiMessenger:\n accountsApiMessenger as AccountsApiDataSourceMessenger,\n snapMessenger: snapMessenger as SnapDataSourceMessenger,\n tokenMessenger: tokenMessenger as TokenDataSourceMessenger,\n priceMessenger: priceMessenger as PriceDataSourceMessenger,\n detectionMessenger: detectionMessenger as DetectionMiddlewareMessenger,\n };\n}\n\n// ============================================================================\n// DATA SOURCE INITIALIZATION\n// ============================================================================\n\n/**\n * Initialize all data sources and middlewares.\n *\n * This function creates and initializes all data sources, registering their\n * action handlers with the messenger.\n *\n * @example\n * ```typescript\n * import { initMessengers, initDataSources } from '@metamask/assets-controllers';\n *\n * // Initialize messengers first\n * const messengers = initMessengers({ controllerMessenger });\n *\n * // Then initialize data sources\n * const dataSources = initDataSources({\n * messengers,\n * queryApiClient,\n * });\n * ```\n *\n * @param options - Configuration options\n * @returns Object containing all data source instances, or null if disabled\n */\nexport function initDataSources(\n options: InitDataSourcesOptions,\n): DataSources | null {\n const {\n messengers,\n queryApiClient,\n rpcDataSourceConfig,\n isEnabled = (): boolean => true,\n } = options;\n\n if (!isEnabled()) {\n return null;\n }\n\n // Initialize primary data sources (provide balance data)\n const rpcDataSource = new RpcDataSource({\n messenger: messengers.rpcMessenger,\n ...rpcDataSourceConfig,\n });\n\n const backendWebsocketDataSource = new BackendWebsocketDataSource({\n messenger: messengers.backendWebsocketMessenger,\n });\n\n const accountsApiDataSource = new AccountsApiDataSource({\n messenger: messengers.accountsApiMessenger,\n queryApiClient,\n });\n\n const snapDataSource = new SnapDataSource({\n messenger: messengers.snapMessenger,\n });\n\n // Initialize middleware data sources (enrich responses)\n const tokenDataSource = new TokenDataSource({\n messenger: messengers.tokenMessenger,\n queryApiClient,\n });\n\n const priceDataSource = new PriceDataSource({\n messenger: messengers.priceMessenger,\n queryApiClient,\n });\n\n const detectionMiddleware = new DetectionMiddleware({\n messenger: messengers.detectionMessenger,\n });\n\n return {\n rpcDataSource,\n backendWebsocketDataSource,\n accountsApiDataSource,\n snapDataSource,\n tokenDataSource,\n priceDataSource,\n detectionMiddleware,\n };\n}\n"]}
@@ -55,6 +55,8 @@ export type DataSourceMessengers = {
55
55
  export type InitMessengersOptions<AllowedActions extends ActionConstraint, AllowedEvents extends EventConstraint> = {
56
56
  /** The root controller messenger */
57
57
  messenger: RootMessenger<AllowedActions, AllowedEvents>;
58
+ /** Function to determine if initialization should proceed. Defaults to true. */
59
+ isEnabled?: () => boolean;
58
60
  };
59
61
  /**
60
62
  * All data source instances.
@@ -91,6 +93,8 @@ export type InitDataSourcesOptions = {
91
93
  queryApiClient: ApiPlatformClient;
92
94
  /** Optional configuration for RpcDataSource */
93
95
  rpcDataSourceConfig?: RpcDataSourceConfig;
96
+ /** Function to determine if initialization should proceed. Defaults to true. */
97
+ isEnabled?: () => boolean;
94
98
  };
95
99
  /**
96
100
  * Initialize all messengers for data sources.
@@ -106,9 +110,9 @@ export type InitDataSourcesOptions = {
106
110
  * ```
107
111
  *
108
112
  * @param options - Configuration options
109
- * @returns Object containing all messengers
113
+ * @returns Object containing all messengers, or null if disabled
110
114
  */
111
- export declare function initMessengers<AllowedActions extends ActionConstraint, AllowedEvents extends EventConstraint>(options: InitMessengersOptions<AllowedActions, AllowedEvents>): DataSourceMessengers;
115
+ export declare function initMessengers<AllowedActions extends ActionConstraint, AllowedEvents extends EventConstraint>(options: InitMessengersOptions<AllowedActions, AllowedEvents>): DataSourceMessengers | null;
112
116
  /**
113
117
  * Initialize all data sources and middlewares.
114
118
  *
@@ -130,7 +134,7 @@ export declare function initMessengers<AllowedActions extends ActionConstraint,
130
134
  * ```
131
135
  *
132
136
  * @param options - Configuration options
133
- * @returns Object containing all data source instances
137
+ * @returns Object containing all data source instances, or null if disabled
134
138
  */
135
- export declare function initDataSources(options: InitDataSourcesOptions): DataSources;
139
+ export declare function initDataSources(options: InitDataSourcesOptions): DataSources | null;
136
140
  //# sourceMappingURL=initDataSources.d.cts.map
@@ -1 +1 @@
1
- {"version":3,"file":"initDataSources.d.cts","sourceRoot":"","sources":["../../src/data-sources/initDataSources.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"initDataSources.d.cts","sourceRoot":"","sources":["../../src/data-sources/initDataSources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,+BAA+B;AAChE,OAAO,EAAE,SAAS,EAAE,4BAA4B;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,4BAA4B;AAE7E,OAAO,EAAE,qBAAqB,EAAE,oCAAgC;AAChE,OAAO,KAAK,EACV,4BAA4B,EAC5B,mCAAmC,EACnC,2BAA2B,EAC3B,8BAA8B,EAC/B,oCAAgC;AACjC,OAAO,EAAE,0BAA0B,EAAE,yCAAqC;AAC1E,OAAO,KAAK,EACV,iCAAiC,EACjC,wCAAwC,EACxC,uCAAuC,EACvC,gCAAgC,EAChC,mCAAmC,EACpC,yCAAqC;AACtC,OAAO,EAAE,eAAe,EAAE,8BAA0B;AACpD,OAAO,KAAK,EACV,sBAAsB,EACtB,6BAA6B,EAC7B,qBAAqB,EACrB,wBAAwB,EACzB,8BAA0B;AAC3B,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAChD,OAAO,KAAK,EACV,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACvB,4BAAwB;AACzB,OAAO,EAAE,cAAc,EAAE,6BAAyB;AAClD,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACxB,6BAAyB;AAC1B,OAAO,EAAE,eAAe,EAAE,8BAA0B;AACpD,OAAO,KAAK,EACV,sBAAsB,EACtB,wBAAwB,EACzB,8BAA0B;AAC3B,OAAO,KAAK,EACV,0BAA0B,EAC1B,4BAA4B,EAC7B,iCAAuB;AACxB,OAAO,EAAE,mBAAmB,EAAE,iCAAuB;AAMrD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,oBAAoB,GACpB,iCAAiC,GACjC,4BAA4B,GAC5B,qBAAqB,GACrB,sBAAsB,GACtB,sBAAsB,GACtB,0BAA0B,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,mBAAmB,GACnB,gCAAgC,GAChC,2BAA2B,GAC3B,oBAAoB,GACpB,qBAAqB,CAAC;AAE1B;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAChC,2BAA2B,GAC3B,wCAAwC,GACxC,mCAAmC,GACnC,6BAA6B,CAAC;AAElC;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B,0BAA0B,GAC1B,uCAAuC,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,aAAa,CACvB,cAAc,SAAS,gBAAgB,EACvC,aAAa,SAAS,eAAe,IACnC,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;AAMrD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,EAAE,sBAAsB,CAAC;IACrC,yBAAyB,EAAE,mCAAmC,CAAC;IAC/D,oBAAoB,EAAE,8BAA8B,CAAC;IACrD,aAAa,EAAE,uBAAuB,CAAC;IACvC,cAAc,EAAE,wBAAwB,CAAC;IACzC,cAAc,EAAE,wBAAwB,CAAC;IACzC,kBAAkB,EAAE,4BAA4B,CAAC;CAClD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,CAC/B,cAAc,SAAS,gBAAgB,EACvC,aAAa,SAAS,eAAe,IACnC;IACF,oCAAoC;IACpC,SAAS,EAAE,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;IACxD,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;CAC3B,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,aAAa,EAAE,aAAa,CAAC;IAC7B,0BAA0B,EAAE,0BAA0B,CAAC;IACvD,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,cAAc,EAAE,cAAc,CAAC;IAC/B,eAAe,EAAE,eAAe,CAAC;IACjC,eAAe,EAAE,eAAe,CAAC;IACjC,mBAAmB,EAAE,mBAAmB,CAAC;CAC1C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0DAA0D;IAC1D,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,sCAAsC;IACtC,UAAU,EAAE,oBAAoB,CAAC;IAEjC,6CAA6C;IAC7C,cAAc,EAAE,iBAAiB,CAAC;IAElC,+CAA+C;IAC/C,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAE1C,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;CAC3B,CAAC;AAMF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,cAAc,SAAS,gBAAgB,EACvC,aAAa,SAAS,eAAe,EAErC,OAAO,EAAE,qBAAqB,CAAC,cAAc,EAAE,aAAa,CAAC,GAC5D,oBAAoB,GAAG,IAAI,CA6H7B;AAMD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,sBAAsB,GAC9B,WAAW,GAAG,IAAI,CAuDpB"}
@@ -55,6 +55,8 @@ export type DataSourceMessengers = {
55
55
  export type InitMessengersOptions<AllowedActions extends ActionConstraint, AllowedEvents extends EventConstraint> = {
56
56
  /** The root controller messenger */
57
57
  messenger: RootMessenger<AllowedActions, AllowedEvents>;
58
+ /** Function to determine if initialization should proceed. Defaults to true. */
59
+ isEnabled?: () => boolean;
58
60
  };
59
61
  /**
60
62
  * All data source instances.
@@ -91,6 +93,8 @@ export type InitDataSourcesOptions = {
91
93
  queryApiClient: ApiPlatformClient;
92
94
  /** Optional configuration for RpcDataSource */
93
95
  rpcDataSourceConfig?: RpcDataSourceConfig;
96
+ /** Function to determine if initialization should proceed. Defaults to true. */
97
+ isEnabled?: () => boolean;
94
98
  };
95
99
  /**
96
100
  * Initialize all messengers for data sources.
@@ -106,9 +110,9 @@ export type InitDataSourcesOptions = {
106
110
  * ```
107
111
  *
108
112
  * @param options - Configuration options
109
- * @returns Object containing all messengers
113
+ * @returns Object containing all messengers, or null if disabled
110
114
  */
111
- export declare function initMessengers<AllowedActions extends ActionConstraint, AllowedEvents extends EventConstraint>(options: InitMessengersOptions<AllowedActions, AllowedEvents>): DataSourceMessengers;
115
+ export declare function initMessengers<AllowedActions extends ActionConstraint, AllowedEvents extends EventConstraint>(options: InitMessengersOptions<AllowedActions, AllowedEvents>): DataSourceMessengers | null;
112
116
  /**
113
117
  * Initialize all data sources and middlewares.
114
118
  *
@@ -130,7 +134,7 @@ export declare function initMessengers<AllowedActions extends ActionConstraint,
130
134
  * ```
131
135
  *
132
136
  * @param options - Configuration options
133
- * @returns Object containing all data source instances
137
+ * @returns Object containing all data source instances, or null if disabled
134
138
  */
135
- export declare function initDataSources(options: InitDataSourcesOptions): DataSources;
139
+ export declare function initDataSources(options: InitDataSourcesOptions): DataSources | null;
136
140
  //# sourceMappingURL=initDataSources.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"initDataSources.d.mts","sourceRoot":"","sources":["../../src/data-sources/initDataSources.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"initDataSources.d.mts","sourceRoot":"","sources":["../../src/data-sources/initDataSources.ts"],"names":[],"mappings":"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"}
@@ -23,10 +23,13 @@ import { DetectionMiddleware } from "../middlewares/index.mjs";
23
23
  * ```
24
24
  *
25
25
  * @param options - Configuration options
26
- * @returns Object containing all messengers
26
+ * @returns Object containing all messengers, or null if disabled
27
27
  */
28
28
  export function initMessengers(options) {
29
- const { messenger } = options;
29
+ const { messenger, isEnabled = () => true } = options;
30
+ if (!isEnabled()) {
31
+ return null;
32
+ }
30
33
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
31
34
  const rootMessenger = messenger;
32
35
  // RPC Data Source messenger
@@ -160,10 +163,13 @@ export function initMessengers(options) {
160
163
  * ```
161
164
  *
162
165
  * @param options - Configuration options
163
- * @returns Object containing all data source instances
166
+ * @returns Object containing all data source instances, or null if disabled
164
167
  */
165
168
  export function initDataSources(options) {
166
- const { messengers, queryApiClient, rpcDataSourceConfig } = options;
169
+ const { messengers, queryApiClient, rpcDataSourceConfig, isEnabled = () => true, } = options;
170
+ if (!isEnabled()) {
171
+ return null;
172
+ }
167
173
  // Initialize primary data sources (provide balance data)
168
174
  const rpcDataSource = new RpcDataSource({
169
175
  messenger: messengers.rpcMessenger,
@@ -1 +1 @@
1
- {"version":3,"file":"initDataSources.mjs","sourceRoot":"","sources":["../../src/data-sources/initDataSources.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ApiPlatformClient } from '@metamask/core-backend';\nimport { Messenger } from '@metamask/messenger';\nimport type { ActionConstraint, EventConstraint } from '@metamask/messenger';\n\nimport { AccountsApiDataSource } from './AccountsApiDataSource';\nimport type {\n AccountsApiDataSourceActions,\n AccountsApiDataSourceAllowedActions,\n AccountsApiDataSourceEvents,\n AccountsApiDataSourceMessenger,\n} from './AccountsApiDataSource';\nimport { BackendWebsocketDataSource } from './BackendWebsocketDataSource';\nimport type {\n BackendWebsocketDataSourceActions,\n BackendWebsocketDataSourceAllowedActions,\n BackendWebsocketDataSourceAllowedEvents,\n BackendWebsocketDataSourceEvents,\n BackendWebsocketDataSourceMessenger,\n} from './BackendWebsocketDataSource';\nimport { PriceDataSource } from './PriceDataSource';\nimport type {\n PriceDataSourceActions,\n PriceDataSourceAllowedActions,\n PriceDataSourceEvents,\n PriceDataSourceMessenger,\n} from './PriceDataSource';\nimport { RpcDataSource } from './RpcDataSource';\nimport type {\n RpcDataSourceActions,\n RpcDataSourceAllowedActions,\n RpcDataSourceAllowedEvents,\n RpcDataSourceEvents,\n RpcDataSourceMessenger,\n} from './RpcDataSource';\nimport { SnapDataSource } from './SnapDataSource';\nimport type {\n SnapDataSourceActions,\n SnapDataSourceEvents,\n SnapDataSourceMessenger,\n} from './SnapDataSource';\nimport { TokenDataSource } from './TokenDataSource';\nimport type {\n TokenDataSourceActions,\n TokenDataSourceMessenger,\n} from './TokenDataSource';\nimport type {\n DetectionMiddlewareActions,\n DetectionMiddlewareMessenger,\n} from '../middlewares';\nimport { DetectionMiddleware } from '../middlewares';\n\n// ============================================================================\n// ACTION & EVENT TYPES\n// ============================================================================\n\n/**\n * All actions from data sources.\n */\nexport type DataSourceActions =\n | RpcDataSourceActions\n | BackendWebsocketDataSourceActions\n | AccountsApiDataSourceActions\n | SnapDataSourceActions\n | TokenDataSourceActions\n | PriceDataSourceActions\n | DetectionMiddlewareActions;\n\n/**\n * All events from data sources.\n */\nexport type DataSourceEvents =\n | RpcDataSourceEvents\n | BackendWebsocketDataSourceEvents\n | AccountsApiDataSourceEvents\n | SnapDataSourceEvents\n | PriceDataSourceEvents;\n\n/**\n * All external actions that data sources need.\n * Note: TokenDataSource, AccountsApiDataSource, and PriceDataSource now use ApiPlatformClient\n * directly, so they don't need BackendApiClient actions delegated.\n */\nexport type DataSourceAllowedActions =\n | RpcDataSourceAllowedActions\n | BackendWebsocketDataSourceAllowedActions\n | AccountsApiDataSourceAllowedActions\n | PriceDataSourceAllowedActions;\n\n/**\n * All external events that data sources need.\n */\nexport type DataSourceAllowedEvents =\n | RpcDataSourceAllowedEvents\n | BackendWebsocketDataSourceAllowedEvents;\n\n/**\n * Root messenger type for all data sources.\n */\nexport type RootMessenger<\n AllowedActions extends ActionConstraint,\n AllowedEvents extends EventConstraint,\n> = Messenger<string, AllowedActions, AllowedEvents>;\n\n// ============================================================================\n// MESSENGER TYPES\n// ============================================================================\n\n/**\n * All messengers for data sources.\n */\nexport type DataSourceMessengers = {\n rpcMessenger: RpcDataSourceMessenger;\n backendWebsocketMessenger: BackendWebsocketDataSourceMessenger;\n accountsApiMessenger: AccountsApiDataSourceMessenger;\n snapMessenger: SnapDataSourceMessenger;\n tokenMessenger: TokenDataSourceMessenger;\n priceMessenger: PriceDataSourceMessenger;\n detectionMessenger: DetectionMiddlewareMessenger;\n};\n\n/**\n * Options for initializing messengers.\n */\nexport type InitMessengersOptions<\n AllowedActions extends ActionConstraint,\n AllowedEvents extends EventConstraint,\n> = {\n /** The root controller messenger */\n messenger: RootMessenger<AllowedActions, AllowedEvents>;\n};\n\n// ============================================================================\n// CONTROLLER TYPES\n// ============================================================================\n\n/**\n * All data source instances.\n */\nexport type DataSources = {\n rpcDataSource: RpcDataSource;\n backendWebsocketDataSource: BackendWebsocketDataSource;\n accountsApiDataSource: AccountsApiDataSource;\n snapDataSource: SnapDataSource;\n tokenDataSource: TokenDataSource;\n priceDataSource: PriceDataSource;\n detectionMiddleware: DetectionMiddleware;\n};\n\n/**\n * Configuration options for RpcDataSource.\n */\nexport type RpcDataSourceConfig = {\n /** Balance polling interval in ms (default: 30s) */\n balanceInterval?: number;\n /** Token detection polling interval in ms (default: 180s / 3 min) */\n detectionInterval?: number;\n /** Whether token detection is enabled (default: false) */\n tokenDetectionEnabled?: boolean;\n /** Request timeout in ms (default: 10s) */\n timeout?: number;\n};\n\n/**\n * Options for initializing data sources.\n */\nexport type InitDataSourcesOptions = {\n /** Messengers for each data source */\n messengers: DataSourceMessengers;\n\n /** ApiPlatformClient for cached API calls */\n queryApiClient: ApiPlatformClient;\n\n /** Optional configuration for RpcDataSource */\n rpcDataSourceConfig?: RpcDataSourceConfig;\n};\n\n// ============================================================================\n// MESSENGER INITIALIZATION\n// ============================================================================\n\n/**\n * Initialize all messengers for data sources.\n *\n * This function creates child messengers for each data source from the root\n * controller messenger, with proper action/event delegation.\n *\n * @example\n * ```typescript\n * import { initMessengers } from '@metamask/assets-controllers';\n *\n * const messengers = initMessengers({ messenger });\n * ```\n *\n * @param options - Configuration options\n * @returns Object containing all messengers\n */\nexport function initMessengers<\n AllowedActions extends ActionConstraint,\n AllowedEvents extends EventConstraint,\n>(\n options: InitMessengersOptions<AllowedActions, AllowedEvents>,\n): DataSourceMessengers {\n const { messenger } = options;\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const rootMessenger = messenger as any;\n\n // RPC Data Source messenger\n const rpcMessenger = new Messenger({\n namespace: 'RpcDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: [\n 'NetworkController:getState',\n 'NetworkController:getNetworkClientById',\n 'AssetsController:activeChainsUpdate',\n 'AssetsController:assetsUpdate',\n 'AssetsController:getState',\n 'TokenListController:getState',\n 'NetworkEnablementController:getState',\n ],\n events: ['NetworkController:stateChange'],\n messenger: rpcMessenger,\n });\n\n // Backend Websocket Data Source messenger\n const backendWebsocketMessenger = new Messenger({\n namespace: 'BackendWebsocketDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: [\n 'BackendWebSocketService:subscribe',\n 'BackendWebSocketService:unsubscribe',\n 'BackendWebSocketService:getState',\n 'BackendWebSocketService:getConnectionInfo',\n 'BackendWebSocketService:findSubscriptionsByChannelPrefix',\n 'AssetsController:activeChainsUpdate',\n 'AssetsController:assetsUpdate',\n ],\n events: [\n 'BackendWebSocketService:stateChange',\n 'BackendWebSocketService:connectionStateChanged',\n 'AccountsApiDataSource:activeChainsUpdated',\n ],\n messenger: backendWebsocketMessenger,\n });\n\n // Accounts API Data Source messenger\n // Note: AccountsApiDataSource uses ApiPlatformClient directly, so no BackendApiClient actions needed\n const accountsApiMessenger = new Messenger({\n namespace: 'AccountsApiDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: [\n 'AssetsController:activeChainsUpdate',\n 'AssetsController:assetsUpdate',\n ],\n messenger: accountsApiMessenger,\n });\n\n // Snap Data Source messenger\n const snapMessenger = new Messenger({\n namespace: 'SnapDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: [\n 'AssetsController:activeChainsUpdate',\n 'AssetsController:assetsUpdate',\n // SnapController actions for direct snap communication\n 'SnapController:getRunnableSnaps',\n 'SnapController:handleRequest',\n // PermissionController action for dynamic snap discovery\n 'PermissionController:getPermissions',\n ],\n events: [\n // Snap keyring balance updates - snaps emit this when balances change\n 'AccountsController:accountBalancesUpdated',\n // Permission changes for runtime snap discovery\n 'PermissionController:stateChange',\n ],\n messenger: snapMessenger,\n });\n\n // Token Data Source messenger\n // Note: TokenDataSource uses ApiPlatformClient directly, so no BackendApiClient actions needed\n const tokenMessenger = new Messenger({\n namespace: 'TokenDataSource',\n parent: rootMessenger,\n });\n\n // Price Data Source messenger\n // Note: PriceDataSource uses ApiPlatformClient directly, so no BackendApiClient actions needed\n const priceMessenger = new Messenger({\n namespace: 'PriceDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: ['AssetsController:getState', 'AssetsController:assetsUpdate'],\n messenger: priceMessenger,\n });\n\n // Detection Middleware messenger\n const detectionMessenger = new Messenger({\n namespace: 'DetectionMiddleware',\n parent: rootMessenger,\n });\n\n return {\n rpcMessenger: rpcMessenger as RpcDataSourceMessenger,\n backendWebsocketMessenger:\n backendWebsocketMessenger as BackendWebsocketDataSourceMessenger,\n accountsApiMessenger:\n accountsApiMessenger as AccountsApiDataSourceMessenger,\n snapMessenger: snapMessenger as SnapDataSourceMessenger,\n tokenMessenger: tokenMessenger as TokenDataSourceMessenger,\n priceMessenger: priceMessenger as PriceDataSourceMessenger,\n detectionMessenger: detectionMessenger as DetectionMiddlewareMessenger,\n };\n}\n\n// ============================================================================\n// DATA SOURCE INITIALIZATION\n// ============================================================================\n\n/**\n * Initialize all data sources and middlewares.\n *\n * This function creates and initializes all data sources, registering their\n * action handlers with the messenger.\n *\n * @example\n * ```typescript\n * import { initMessengers, initDataSources } from '@metamask/assets-controllers';\n *\n * // Initialize messengers first\n * const messengers = initMessengers({ controllerMessenger });\n *\n * // Then initialize data sources\n * const dataSources = initDataSources({\n * messengers,\n * queryApiClient,\n * });\n * ```\n *\n * @param options - Configuration options\n * @returns Object containing all data source instances\n */\nexport function initDataSources(options: InitDataSourcesOptions): DataSources {\n const { messengers, queryApiClient, rpcDataSourceConfig } = options;\n\n // Initialize primary data sources (provide balance data)\n const rpcDataSource = new RpcDataSource({\n messenger: messengers.rpcMessenger,\n ...rpcDataSourceConfig,\n });\n\n const backendWebsocketDataSource = new BackendWebsocketDataSource({\n messenger: messengers.backendWebsocketMessenger,\n });\n\n const accountsApiDataSource = new AccountsApiDataSource({\n messenger: messengers.accountsApiMessenger,\n queryApiClient,\n });\n\n const snapDataSource = new SnapDataSource({\n messenger: messengers.snapMessenger,\n });\n\n // Initialize middleware data sources (enrich responses)\n const tokenDataSource = new TokenDataSource({\n messenger: messengers.tokenMessenger,\n queryApiClient,\n });\n\n const priceDataSource = new PriceDataSource({\n messenger: messengers.priceMessenger,\n queryApiClient,\n });\n\n const detectionMiddleware = new DetectionMiddleware({\n messenger: messengers.detectionMessenger,\n });\n\n return {\n rpcDataSource,\n backendWebsocketDataSource,\n accountsApiDataSource,\n snapDataSource,\n tokenDataSource,\n priceDataSource,\n detectionMiddleware,\n };\n}\n"]}
1
+ {"version":3,"file":"initDataSources.mjs","sourceRoot":"","sources":["../../src/data-sources/initDataSources.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,4BAA4B;AAGhD,OAAO,EAAE,qBAAqB,EAAE,oCAAgC;AAOhE,OAAO,EAAE,0BAA0B,EAAE,yCAAqC;AAQ1E,OAAO,EAAE,eAAe,EAAE,8BAA0B;AAOpD,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAQhD,OAAO,EAAE,cAAc,EAAE,6BAAyB;AAMlD,OAAO,EAAE,eAAe,EAAE,8BAA0B;AASpD,OAAO,EAAE,mBAAmB,EAAE,iCAAuB;AAoIrD,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAI5B,OAA6D;IAE7D,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,GAAY,EAAE,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC;IAE/D,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8DAA8D;IAC9D,MAAM,aAAa,GAAG,SAAgB,CAAC;IAEvC,4BAA4B;IAC5B,MAAM,YAAY,GAAG,IAAI,SAAS,CAAC;QACjC,SAAS,EAAE,eAAe;QAC1B,MAAM,EAAE,aAAa;KACtB,CAAC,CAAC;IACH,aAAa,CAAC,QAAQ,CAAC;QACrB,OAAO,EAAE;YACP,4BAA4B;YAC5B,wCAAwC;YACxC,qCAAqC;YACrC,+BAA+B;YAC/B,2BAA2B;YAC3B,8BAA8B;YAC9B,sCAAsC;SACvC;QACD,MAAM,EAAE,CAAC,+BAA+B,CAAC;QACzC,SAAS,EAAE,YAAY;KACxB,CAAC,CAAC;IAEH,0CAA0C;IAC1C,MAAM,yBAAyB,GAAG,IAAI,SAAS,CAAC;QAC9C,SAAS,EAAE,4BAA4B;QACvC,MAAM,EAAE,aAAa;KACtB,CAAC,CAAC;IACH,aAAa,CAAC,QAAQ,CAAC;QACrB,OAAO,EAAE;YACP,mCAAmC;YACnC,qCAAqC;YACrC,kCAAkC;YAClC,2CAA2C;YAC3C,0DAA0D;YAC1D,qCAAqC;YACrC,+BAA+B;SAChC;QACD,MAAM,EAAE;YACN,qCAAqC;YACrC,gDAAgD;YAChD,2CAA2C;SAC5C;QACD,SAAS,EAAE,yBAAyB;KACrC,CAAC,CAAC;IAEH,qCAAqC;IACrC,qGAAqG;IACrG,MAAM,oBAAoB,GAAG,IAAI,SAAS,CAAC;QACzC,SAAS,EAAE,uBAAuB;QAClC,MAAM,EAAE,aAAa;KACtB,CAAC,CAAC;IACH,aAAa,CAAC,QAAQ,CAAC;QACrB,OAAO,EAAE;YACP,qCAAqC;YACrC,+BAA+B;SAChC;QACD,SAAS,EAAE,oBAAoB;KAChC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,MAAM,aAAa,GAAG,IAAI,SAAS,CAAC;QAClC,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;KACtB,CAAC,CAAC;IACH,aAAa,CAAC,QAAQ,CAAC;QACrB,OAAO,EAAE;YACP,qCAAqC;YACrC,+BAA+B;YAC/B,uDAAuD;YACvD,iCAAiC;YACjC,8BAA8B;YAC9B,yDAAyD;YACzD,qCAAqC;SACtC;QACD,MAAM,EAAE;YACN,sEAAsE;YACtE,2CAA2C;YAC3C,gDAAgD;YAChD,kCAAkC;SACnC;QACD,SAAS,EAAE,aAAa;KACzB,CAAC,CAAC;IAEH,8BAA8B;IAC9B,+FAA+F;IAC/F,MAAM,cAAc,GAAG,IAAI,SAAS,CAAC;QACnC,SAAS,EAAE,iBAAiB;QAC5B,MAAM,EAAE,aAAa;KACtB,CAAC,CAAC;IAEH,8BAA8B;IAC9B,+FAA+F;IAC/F,MAAM,cAAc,GAAG,IAAI,SAAS,CAAC;QACnC,SAAS,EAAE,iBAAiB;QAC5B,MAAM,EAAE,aAAa;KACtB,CAAC,CAAC;IACH,aAAa,CAAC,QAAQ,CAAC;QACrB,OAAO,EAAE,CAAC,2BAA2B,EAAE,+BAA+B,CAAC;QACvE,SAAS,EAAE,cAAc;KAC1B,CAAC,CAAC;IAEH,iCAAiC;IACjC,MAAM,kBAAkB,GAAG,IAAI,SAAS,CAAC;QACvC,SAAS,EAAE,qBAAqB;QAChC,MAAM,EAAE,aAAa;KACtB,CAAC,CAAC;IAEH,OAAO;QACL,YAAY,EAAE,YAAsC;QACpD,yBAAyB,EACvB,yBAAgE;QAClE,oBAAoB,EAClB,oBAAsD;QACxD,aAAa,EAAE,aAAwC;QACvD,cAAc,EAAE,cAA0C;QAC1D,cAAc,EAAE,cAA0C;QAC1D,kBAAkB,EAAE,kBAAkD;KACvE,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,eAAe,CAC7B,OAA+B;IAE/B,MAAM,EACJ,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,SAAS,GAAG,GAAY,EAAE,CAAC,IAAI,GAChC,GAAG,OAAO,CAAC;IAEZ,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,yDAAyD;IACzD,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC;QACtC,SAAS,EAAE,UAAU,CAAC,YAAY;QAClC,GAAG,mBAAmB;KACvB,CAAC,CAAC;IAEH,MAAM,0BAA0B,GAAG,IAAI,0BAA0B,CAAC;QAChE,SAAS,EAAE,UAAU,CAAC,yBAAyB;KAChD,CAAC,CAAC;IAEH,MAAM,qBAAqB,GAAG,IAAI,qBAAqB,CAAC;QACtD,SAAS,EAAE,UAAU,CAAC,oBAAoB;QAC1C,cAAc;KACf,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC;QACxC,SAAS,EAAE,UAAU,CAAC,aAAa;KACpC,CAAC,CAAC;IAEH,wDAAwD;IACxD,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC;QAC1C,SAAS,EAAE,UAAU,CAAC,cAAc;QACpC,cAAc;KACf,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC;QAC1C,SAAS,EAAE,UAAU,CAAC,cAAc;QACpC,cAAc;KACf,CAAC,CAAC;IAEH,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,CAAC;QAClD,SAAS,EAAE,UAAU,CAAC,kBAAkB;KACzC,CAAC,CAAC;IAEH,OAAO;QACL,aAAa;QACb,0BAA0B;QAC1B,qBAAqB;QACrB,cAAc;QACd,eAAe;QACf,eAAe;QACf,mBAAmB;KACpB,CAAC;AACJ,CAAC","sourcesContent":["import type { ApiPlatformClient } from '@metamask/core-backend';\nimport { Messenger } from '@metamask/messenger';\nimport type { ActionConstraint, EventConstraint } from '@metamask/messenger';\n\nimport { AccountsApiDataSource } from './AccountsApiDataSource';\nimport type {\n AccountsApiDataSourceActions,\n AccountsApiDataSourceAllowedActions,\n AccountsApiDataSourceEvents,\n AccountsApiDataSourceMessenger,\n} from './AccountsApiDataSource';\nimport { BackendWebsocketDataSource } from './BackendWebsocketDataSource';\nimport type {\n BackendWebsocketDataSourceActions,\n BackendWebsocketDataSourceAllowedActions,\n BackendWebsocketDataSourceAllowedEvents,\n BackendWebsocketDataSourceEvents,\n BackendWebsocketDataSourceMessenger,\n} from './BackendWebsocketDataSource';\nimport { PriceDataSource } from './PriceDataSource';\nimport type {\n PriceDataSourceActions,\n PriceDataSourceAllowedActions,\n PriceDataSourceEvents,\n PriceDataSourceMessenger,\n} from './PriceDataSource';\nimport { RpcDataSource } from './RpcDataSource';\nimport type {\n RpcDataSourceActions,\n RpcDataSourceAllowedActions,\n RpcDataSourceAllowedEvents,\n RpcDataSourceEvents,\n RpcDataSourceMessenger,\n} from './RpcDataSource';\nimport { SnapDataSource } from './SnapDataSource';\nimport type {\n SnapDataSourceActions,\n SnapDataSourceEvents,\n SnapDataSourceMessenger,\n} from './SnapDataSource';\nimport { TokenDataSource } from './TokenDataSource';\nimport type {\n TokenDataSourceActions,\n TokenDataSourceMessenger,\n} from './TokenDataSource';\nimport type {\n DetectionMiddlewareActions,\n DetectionMiddlewareMessenger,\n} from '../middlewares';\nimport { DetectionMiddleware } from '../middlewares';\n\n// ============================================================================\n// ACTION & EVENT TYPES\n// ============================================================================\n\n/**\n * All actions from data sources.\n */\nexport type DataSourceActions =\n | RpcDataSourceActions\n | BackendWebsocketDataSourceActions\n | AccountsApiDataSourceActions\n | SnapDataSourceActions\n | TokenDataSourceActions\n | PriceDataSourceActions\n | DetectionMiddlewareActions;\n\n/**\n * All events from data sources.\n */\nexport type DataSourceEvents =\n | RpcDataSourceEvents\n | BackendWebsocketDataSourceEvents\n | AccountsApiDataSourceEvents\n | SnapDataSourceEvents\n | PriceDataSourceEvents;\n\n/**\n * All external actions that data sources need.\n * Note: TokenDataSource, AccountsApiDataSource, and PriceDataSource now use ApiPlatformClient\n * directly, so they don't need BackendApiClient actions delegated.\n */\nexport type DataSourceAllowedActions =\n | RpcDataSourceAllowedActions\n | BackendWebsocketDataSourceAllowedActions\n | AccountsApiDataSourceAllowedActions\n | PriceDataSourceAllowedActions;\n\n/**\n * All external events that data sources need.\n */\nexport type DataSourceAllowedEvents =\n | RpcDataSourceAllowedEvents\n | BackendWebsocketDataSourceAllowedEvents;\n\n/**\n * Root messenger type for all data sources.\n */\nexport type RootMessenger<\n AllowedActions extends ActionConstraint,\n AllowedEvents extends EventConstraint,\n> = Messenger<string, AllowedActions, AllowedEvents>;\n\n// ============================================================================\n// MESSENGER TYPES\n// ============================================================================\n\n/**\n * All messengers for data sources.\n */\nexport type DataSourceMessengers = {\n rpcMessenger: RpcDataSourceMessenger;\n backendWebsocketMessenger: BackendWebsocketDataSourceMessenger;\n accountsApiMessenger: AccountsApiDataSourceMessenger;\n snapMessenger: SnapDataSourceMessenger;\n tokenMessenger: TokenDataSourceMessenger;\n priceMessenger: PriceDataSourceMessenger;\n detectionMessenger: DetectionMiddlewareMessenger;\n};\n\n/**\n * Options for initializing messengers.\n */\nexport type InitMessengersOptions<\n AllowedActions extends ActionConstraint,\n AllowedEvents extends EventConstraint,\n> = {\n /** The root controller messenger */\n messenger: RootMessenger<AllowedActions, AllowedEvents>;\n /** Function to determine if initialization should proceed. Defaults to true. */\n isEnabled?: () => boolean;\n};\n\n// ============================================================================\n// CONTROLLER TYPES\n// ============================================================================\n\n/**\n * All data source instances.\n */\nexport type DataSources = {\n rpcDataSource: RpcDataSource;\n backendWebsocketDataSource: BackendWebsocketDataSource;\n accountsApiDataSource: AccountsApiDataSource;\n snapDataSource: SnapDataSource;\n tokenDataSource: TokenDataSource;\n priceDataSource: PriceDataSource;\n detectionMiddleware: DetectionMiddleware;\n};\n\n/**\n * Configuration options for RpcDataSource.\n */\nexport type RpcDataSourceConfig = {\n /** Balance polling interval in ms (default: 30s) */\n balanceInterval?: number;\n /** Token detection polling interval in ms (default: 180s / 3 min) */\n detectionInterval?: number;\n /** Whether token detection is enabled (default: false) */\n tokenDetectionEnabled?: boolean;\n /** Request timeout in ms (default: 10s) */\n timeout?: number;\n};\n\n/**\n * Options for initializing data sources.\n */\nexport type InitDataSourcesOptions = {\n /** Messengers for each data source */\n messengers: DataSourceMessengers;\n\n /** ApiPlatformClient for cached API calls */\n queryApiClient: ApiPlatformClient;\n\n /** Optional configuration for RpcDataSource */\n rpcDataSourceConfig?: RpcDataSourceConfig;\n\n /** Function to determine if initialization should proceed. Defaults to true. */\n isEnabled?: () => boolean;\n};\n\n// ============================================================================\n// MESSENGER INITIALIZATION\n// ============================================================================\n\n/**\n * Initialize all messengers for data sources.\n *\n * This function creates child messengers for each data source from the root\n * controller messenger, with proper action/event delegation.\n *\n * @example\n * ```typescript\n * import { initMessengers } from '@metamask/assets-controllers';\n *\n * const messengers = initMessengers({ messenger });\n * ```\n *\n * @param options - Configuration options\n * @returns Object containing all messengers, or null if disabled\n */\nexport function initMessengers<\n AllowedActions extends ActionConstraint,\n AllowedEvents extends EventConstraint,\n>(\n options: InitMessengersOptions<AllowedActions, AllowedEvents>,\n): DataSourceMessengers | null {\n const { messenger, isEnabled = (): boolean => true } = options;\n\n if (!isEnabled()) {\n return null;\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const rootMessenger = messenger as any;\n\n // RPC Data Source messenger\n const rpcMessenger = new Messenger({\n namespace: 'RpcDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: [\n 'NetworkController:getState',\n 'NetworkController:getNetworkClientById',\n 'AssetsController:activeChainsUpdate',\n 'AssetsController:assetsUpdate',\n 'AssetsController:getState',\n 'TokenListController:getState',\n 'NetworkEnablementController:getState',\n ],\n events: ['NetworkController:stateChange'],\n messenger: rpcMessenger,\n });\n\n // Backend Websocket Data Source messenger\n const backendWebsocketMessenger = new Messenger({\n namespace: 'BackendWebsocketDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: [\n 'BackendWebSocketService:subscribe',\n 'BackendWebSocketService:unsubscribe',\n 'BackendWebSocketService:getState',\n 'BackendWebSocketService:getConnectionInfo',\n 'BackendWebSocketService:findSubscriptionsByChannelPrefix',\n 'AssetsController:activeChainsUpdate',\n 'AssetsController:assetsUpdate',\n ],\n events: [\n 'BackendWebSocketService:stateChange',\n 'BackendWebSocketService:connectionStateChanged',\n 'AccountsApiDataSource:activeChainsUpdated',\n ],\n messenger: backendWebsocketMessenger,\n });\n\n // Accounts API Data Source messenger\n // Note: AccountsApiDataSource uses ApiPlatformClient directly, so no BackendApiClient actions needed\n const accountsApiMessenger = new Messenger({\n namespace: 'AccountsApiDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: [\n 'AssetsController:activeChainsUpdate',\n 'AssetsController:assetsUpdate',\n ],\n messenger: accountsApiMessenger,\n });\n\n // Snap Data Source messenger\n const snapMessenger = new Messenger({\n namespace: 'SnapDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: [\n 'AssetsController:activeChainsUpdate',\n 'AssetsController:assetsUpdate',\n // SnapController actions for direct snap communication\n 'SnapController:getRunnableSnaps',\n 'SnapController:handleRequest',\n // PermissionController action for dynamic snap discovery\n 'PermissionController:getPermissions',\n ],\n events: [\n // Snap keyring balance updates - snaps emit this when balances change\n 'AccountsController:accountBalancesUpdated',\n // Permission changes for runtime snap discovery\n 'PermissionController:stateChange',\n ],\n messenger: snapMessenger,\n });\n\n // Token Data Source messenger\n // Note: TokenDataSource uses ApiPlatformClient directly, so no BackendApiClient actions needed\n const tokenMessenger = new Messenger({\n namespace: 'TokenDataSource',\n parent: rootMessenger,\n });\n\n // Price Data Source messenger\n // Note: PriceDataSource uses ApiPlatformClient directly, so no BackendApiClient actions needed\n const priceMessenger = new Messenger({\n namespace: 'PriceDataSource',\n parent: rootMessenger,\n });\n rootMessenger.delegate({\n actions: ['AssetsController:getState', 'AssetsController:assetsUpdate'],\n messenger: priceMessenger,\n });\n\n // Detection Middleware messenger\n const detectionMessenger = new Messenger({\n namespace: 'DetectionMiddleware',\n parent: rootMessenger,\n });\n\n return {\n rpcMessenger: rpcMessenger as RpcDataSourceMessenger,\n backendWebsocketMessenger:\n backendWebsocketMessenger as BackendWebsocketDataSourceMessenger,\n accountsApiMessenger:\n accountsApiMessenger as AccountsApiDataSourceMessenger,\n snapMessenger: snapMessenger as SnapDataSourceMessenger,\n tokenMessenger: tokenMessenger as TokenDataSourceMessenger,\n priceMessenger: priceMessenger as PriceDataSourceMessenger,\n detectionMessenger: detectionMessenger as DetectionMiddlewareMessenger,\n };\n}\n\n// ============================================================================\n// DATA SOURCE INITIALIZATION\n// ============================================================================\n\n/**\n * Initialize all data sources and middlewares.\n *\n * This function creates and initializes all data sources, registering their\n * action handlers with the messenger.\n *\n * @example\n * ```typescript\n * import { initMessengers, initDataSources } from '@metamask/assets-controllers';\n *\n * // Initialize messengers first\n * const messengers = initMessengers({ controllerMessenger });\n *\n * // Then initialize data sources\n * const dataSources = initDataSources({\n * messengers,\n * queryApiClient,\n * });\n * ```\n *\n * @param options - Configuration options\n * @returns Object containing all data source instances, or null if disabled\n */\nexport function initDataSources(\n options: InitDataSourcesOptions,\n): DataSources | null {\n const {\n messengers,\n queryApiClient,\n rpcDataSourceConfig,\n isEnabled = (): boolean => true,\n } = options;\n\n if (!isEnabled()) {\n return null;\n }\n\n // Initialize primary data sources (provide balance data)\n const rpcDataSource = new RpcDataSource({\n messenger: messengers.rpcMessenger,\n ...rpcDataSourceConfig,\n });\n\n const backendWebsocketDataSource = new BackendWebsocketDataSource({\n messenger: messengers.backendWebsocketMessenger,\n });\n\n const accountsApiDataSource = new AccountsApiDataSource({\n messenger: messengers.accountsApiMessenger,\n queryApiClient,\n });\n\n const snapDataSource = new SnapDataSource({\n messenger: messengers.snapMessenger,\n });\n\n // Initialize middleware data sources (enrich responses)\n const tokenDataSource = new TokenDataSource({\n messenger: messengers.tokenMessenger,\n queryApiClient,\n });\n\n const priceDataSource = new PriceDataSource({\n messenger: messengers.priceMessenger,\n queryApiClient,\n });\n\n const detectionMiddleware = new DetectionMiddleware({\n messenger: messengers.detectionMessenger,\n });\n\n return {\n rpcDataSource,\n backendWebsocketDataSource,\n accountsApiDataSource,\n snapDataSource,\n tokenDataSource,\n priceDataSource,\n detectionMiddleware,\n };\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@metamask-previews/assets-controller",
3
- "version": "0.0.0-preview-6dfa4aeba",
3
+ "version": "0.1.0-preview-8f3469e9c",
4
4
  "description": "Tracks assets balances/prices and handles token detection across all digital assets",
5
5
  "keywords": [
6
6
  "MetaMask",