@metamask/assets-controller 0.2.0 → 1.0.0

package/dist/types.d.mts

@@ -253,13 +253,22 @@ export type AssetBalance = FungibleAssetBalance | ERC721AssetBalance | ERC1155As
  * Data type dimension - what kind of data
  */
 export type DataType = 'balance' | 'metadata' | 'price';
+/**
+ * Account with its supported chains (enabled chains ∩ account scope).
+ * Pre-computed by the controller so data sources do not need to implement
+ * account-scope logic; they iterate over supportedChains for each account.
+ */
+export type AccountWithSupportedChains = {
+    account: InternalAccount;
+    supportedChains: ChainId[];
+};
 /**
  * Request for data from data sources
  */
 export type DataRequest = {
-    /** Accounts to fetch data for */
-    accounts: InternalAccount[];
-    /** CAIP-2 chain IDs */
+    /** Accounts with their supported chains (enabled ∩ account scope). Data sources use this instead of computing accountSupportsChain. */
+    accountsWithSupportedChains: AccountWithSupportedChains[];
+    /** CAIP-2 chain IDs (union of chains in this request) */
     chainIds: ChainId[];
     /** Filter by asset types */
     assetTypes?: AssetType[];
@@ -287,6 +296,46 @@ export type DataResponse = {
     /** Detected assets (assets that do not have metadata) */
     detectedAssets?: Record<AccountId, Caip19AssetId[]>;
 };
+/**
+ * Callbacks for data sources to report to AssetsController.
+ * Passed to data sources so they report by direct call instead of messenger.
+ */
+export type AssetsControllerReport = {
+    onActiveChainsUpdate: (dataSourceId: string, activeChains: ChainId[]) => void;
+    onAssetsUpdate: (response: DataResponse, sourceId: string) => Promise<void>;
+};
+/** Request passed from controller to data source when subscribing */
+export type DataSourceSubscriptionRequest = {
+    request: DataRequest;
+    subscriptionId: string;
+    isUpdate: boolean;
+};
+/**
+ * Interface for balance data sources that the controller calls directly.
+ * No messenger is required for controller <-> data source communication.
+ */
+export type BalanceDataSource = {
+    getAssetsMiddleware: () => Middleware;
+    subscribe: (request: DataSourceSubscriptionRequest) => Promise<void>;
+    unsubscribe: (subscriptionId: string) => Promise<void>;
+    getName: () => string;
+};
+/**
+ * Interface for the price data source (subscribe/unsubscribe + middleware).
+ * Controller calls these methods directly.
+ */
+export type PriceDataSourceInterface = {
+    getAssetsMiddleware: () => Middleware;
+    subscribe: (request: DataSourceSubscriptionRequest) => Promise<void>;
+    unsubscribe: (subscriptionId: string) => Promise<void>;
+};
+/**
+ * Middleware-only source (e.g. detection, token enrichment).
+ * Controller calls getAssetsMiddleware() directly.
+ */
+export type MiddlewareDataSource = {
+    getAssetsMiddleware: () => Middleware;
+};
 /**
  * Internal state structure for AssetsController following normalized design.
  *
@@ -364,21 +413,7 @@ export type FetchContext = Context;
 export type FetchNextFunction = NextFunction;
 export type FetchMiddleware = Middleware;
 /**
- * Data source ID.
- *
- * Data sources follow a standard messenger pattern:
- * - `${id}:getActiveChains` - action to get active chains
- * - `${id}:activeChainsUpdated` - event when chains change
- *
- * Registration order determines subscription order.
- */
-export type DataSourceDefinition = string;
-/**
- * Registered data source
- */
-export type RegisteredDataSource = DataSourceDefinition;
-/**
- * Subscription response
+ * Subscription response returned when subscribing to asset updates.
  */
 export type SubscriptionResponse = {
     /** Chains actively subscribed */

package/dist/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.mjs.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask/assets-controller",
-  "version": "0.2.0",
+  "version": "1.0.0",
   "description": "Tracks assets balances/prices and handles token detection across all digital assets",
   "keywords": [
     "MetaMask",
@@ -51,7 +51,7 @@
     "@ethereumjs/util": "^9.1.0",
     "@ethersproject/abi": "^5.7.0",
     "@ethersproject/providers": "^5.7.0",
-    "@metamask/account-tree-controller": "^4.0.0",
+    "@metamask/account-tree-controller": "^4.1.0",
     "@metamask/base-controller": "^9.0.0",
     "@metamask/controller-utils": "^11.18.0",
     "@metamask/core-backend": "^5.1.0",

package/dist/data-sources/initDataSources.cjs

@@ -1,215 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.initDataSources = exports.initMessengers = void 0;
-const messenger_1 = require("@metamask/messenger");
-const AccountsApiDataSource_1 = require("./AccountsApiDataSource.cjs");
-const BackendWebsocketDataSource_1 = require("./BackendWebsocketDataSource.cjs");
-const PriceDataSource_1 = require("./PriceDataSource.cjs");
-const RpcDataSource_1 = require("./RpcDataSource.cjs");
-const SnapDataSource_1 = require("./SnapDataSource.cjs");
-const TokenDataSource_1 = require("./TokenDataSource.cjs");
-const middlewares_1 = require("../middlewares/index.cjs");
-// ============================================================================
-// MESSENGER INITIALIZATION
-// ============================================================================
-/**
- * Initialize all messengers for data sources.
- *
- * This function creates child messengers for each data source from the root
- * controller messenger, with proper action/event delegation.
- *
- * @example
- * ```typescript
- * import { initMessengers } from '@metamask/assets-controllers';
- *
- * const messengers = initMessengers({ messenger });
- * ```
- *
- * @param options - Configuration options
- * @returns Object containing all messengers, or null if disabled
- */
-function initMessengers(options) {
-    const { messenger, isEnabled = () => true } = options;
-    if (!isEnabled()) {
-        return null;
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const rootMessenger = messenger;
-    // RPC Data Source messenger
-    const rpcMessenger = new messenger_1.Messenger({
-        namespace: 'RpcDataSource',
-        parent: rootMessenger,
-    });
-    rootMessenger.delegate({
-        actions: [
-            'NetworkController:getState',
-            'NetworkController:getNetworkClientById',
-            'AssetsController:activeChainsUpdate',
-            'AssetsController:assetsUpdate',
-            'AssetsController:getState',
-            'TokenListController:getState',
-            'NetworkEnablementController:getState',
-        ],
-        events: ['NetworkController:stateChange'],
-        messenger: rpcMessenger,
-    });
-    // Backend Websocket Data Source messenger
-    const backendWebsocketMessenger = new messenger_1.Messenger({
-        namespace: 'BackendWebsocketDataSource',
-        parent: rootMessenger,
-    });
-    rootMessenger.delegate({
-        actions: [
-            'BackendWebSocketService:subscribe',
-            'BackendWebSocketService:unsubscribe',
-            'BackendWebSocketService:getState',
-            'BackendWebSocketService:getConnectionInfo',
-            'BackendWebSocketService:findSubscriptionsByChannelPrefix',
-            'AssetsController:activeChainsUpdate',
-            'AssetsController:assetsUpdate',
-        ],
-        events: [
-            'BackendWebSocketService:stateChange',
-            'BackendWebSocketService:connectionStateChanged',
-            'AccountsApiDataSource:activeChainsUpdated',
-        ],
-        messenger: backendWebsocketMessenger,
-    });
-    // Accounts API Data Source messenger
-    // Note: AccountsApiDataSource uses ApiPlatformClient directly, so no BackendApiClient actions needed
-    const accountsApiMessenger = new messenger_1.Messenger({
-        namespace: 'AccountsApiDataSource',
-        parent: rootMessenger,
-    });
-    rootMessenger.delegate({
-        actions: [
-            'AssetsController:activeChainsUpdate',
-            'AssetsController:assetsUpdate',
-        ],
-        messenger: accountsApiMessenger,
-    });
-    // Snap Data Source messenger
-    const snapMessenger = new messenger_1.Messenger({
-        namespace: 'SnapDataSource',
-        parent: rootMessenger,
-    });
-    rootMessenger.delegate({
-        actions: [
-            'AssetsController:activeChainsUpdate',
-            'AssetsController:assetsUpdate',
-            // SnapController actions for direct snap communication
-            'SnapController:getRunnableSnaps',
-            'SnapController:handleRequest',
-            // PermissionController action for dynamic snap discovery
-            'PermissionController:getPermissions',
-        ],
-        events: [
-            // Snap keyring balance updates - snaps emit this when balances change
-            'AccountsController:accountBalancesUpdated',
-            // Permission changes for runtime snap discovery
-            'PermissionController:stateChange',
-        ],
-        messenger: snapMessenger,
-    });
-    // Token Data Source messenger
-    // Note: TokenDataSource uses ApiPlatformClient directly, so no BackendApiClient actions needed
-    const tokenMessenger = new messenger_1.Messenger({
-        namespace: 'TokenDataSource',
-        parent: rootMessenger,
-    });
-    // Price Data Source messenger
-    // Note: PriceDataSource uses ApiPlatformClient directly, so no BackendApiClient actions needed
-    const priceMessenger = new messenger_1.Messenger({
-        namespace: 'PriceDataSource',
-        parent: rootMessenger,
-    });
-    rootMessenger.delegate({
-        actions: ['AssetsController:getState', 'AssetsController:assetsUpdate'],
-        messenger: priceMessenger,
-    });
-    // Detection Middleware messenger
-    const detectionMessenger = new messenger_1.Messenger({
-        namespace: 'DetectionMiddleware',
-        parent: rootMessenger,
-    });
-    return {
-        rpcMessenger: rpcMessenger,
-        backendWebsocketMessenger: backendWebsocketMessenger,
-        accountsApiMessenger: accountsApiMessenger,
-        snapMessenger: snapMessenger,
-        tokenMessenger: tokenMessenger,
-        priceMessenger: priceMessenger,
-        detectionMessenger: detectionMessenger,
-    };
-}
-exports.initMessengers = initMessengers;
-// ============================================================================
-// DATA SOURCE INITIALIZATION
-// ============================================================================
-/**
- * Initialize all data sources and middlewares.
- *
- * This function creates and initializes all data sources, registering their
- * action handlers with the messenger.
- *
- * @example
- * ```typescript
- * import { initMessengers, initDataSources } from '@metamask/assets-controllers';
- *
- * // Initialize messengers first
- * const messengers = initMessengers({ controllerMessenger });
- *
- * // Then initialize data sources
- * const dataSources = initDataSources({
- *   messengers,
- *   queryApiClient,
- * });
- * ```
- *
- * @param options - Configuration options
- * @returns Object containing all data source instances, or null if disabled
- */
-function initDataSources(options) {
-    const { messengers, queryApiClient, rpcDataSourceConfig, isEnabled = () => true, } = options;
-    if (!isEnabled()) {
-        return null;
-    }
-    // Initialize primary data sources (provide balance data)
-    const rpcDataSource = new RpcDataSource_1.RpcDataSource({
-        messenger: messengers.rpcMessenger,
-        ...rpcDataSourceConfig,
-    });
-    const backendWebsocketDataSource = new BackendWebsocketDataSource_1.BackendWebsocketDataSource({
-        messenger: messengers.backendWebsocketMessenger,
-    });
-    const accountsApiDataSource = new AccountsApiDataSource_1.AccountsApiDataSource({
-        messenger: messengers.accountsApiMessenger,
-        queryApiClient,
-    });
-    const snapDataSource = new SnapDataSource_1.SnapDataSource({
-        messenger: messengers.snapMessenger,
-    });
-    // Initialize middleware data sources (enrich responses)
-    const tokenDataSource = new TokenDataSource_1.TokenDataSource({
-        messenger: messengers.tokenMessenger,
-        queryApiClient,
-    });
-    const priceDataSource = new PriceDataSource_1.PriceDataSource({
-        messenger: messengers.priceMessenger,
-        queryApiClient,
-    });
-    const detectionMiddleware = new middlewares_1.DetectionMiddleware({
-        messenger: messengers.detectionMessenger,
-    });
-    return {
-        rpcDataSource,
-        backendWebsocketDataSource,
-        accountsApiDataSource,
-        snapDataSource,
-        tokenDataSource,
-        priceDataSource,
-        detectionMiddleware,
-    };
-}
-exports.initDataSources = initDataSources;
-//# sourceMappingURL=initDataSources.cjs.map

package/dist/data-sources/initDataSources.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"initDataSources.cjs","sourceRoot":"","sources":["../../src/data-sources/initDataSources.ts"],"names":[],"mappings":";;;AACA,mDAAgD;AAGhD,uEAAgE;AAOhE,iFAA0E;AAQ1E,2DAAoD;AAOpD,uDAAgD;AAQhD,yDAAkD;AAMlD,2DAAoD;AASpD,0DAAqD;AAoIrD,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,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,qBAAS,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,qBAAS,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,qBAAS,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,qBAAS,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,qBAAS,CAAC;QACnC,SAAS,EAAE,iBAAiB;QAC5B,MAAM,EAAE,aAAa;KACtB,CAAC,CAAC;IAEH,8BAA8B;IAC9B,+FAA+F;IAC/F,MAAM,cAAc,GAAG,IAAI,qBAAS,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,qBAAS,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;AAlID,wCAkIC;AAED,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,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,6BAAa,CAAC;QACtC,SAAS,EAAE,UAAU,CAAC,YAAY;QAClC,GAAG,mBAAmB;KACvB,CAAC,CAAC;IAEH,MAAM,0BAA0B,GAAG,IAAI,uDAA0B,CAAC;QAChE,SAAS,EAAE,UAAU,CAAC,yBAAyB;KAChD,CAAC,CAAC;IAEH,MAAM,qBAAqB,GAAG,IAAI,6CAAqB,CAAC;QACtD,SAAS,EAAE,UAAU,CAAC,oBAAoB;QAC1C,cAAc;KACf,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,IAAI,+BAAc,CAAC;QACxC,SAAS,EAAE,UAAU,CAAC,aAAa;KACpC,CAAC,CAAC;IAEH,wDAAwD;IACxD,MAAM,eAAe,GAAG,IAAI,iCAAe,CAAC;QAC1C,SAAS,EAAE,UAAU,CAAC,cAAc;QACpC,cAAc;KACf,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,IAAI,iCAAe,CAAC;QAC1C,SAAS,EAAE,UAAU,CAAC,cAAc;QACpC,cAAc;KACf,CAAC,CAAC;IAEH,MAAM,mBAAmB,GAAG,IAAI,iCAAmB,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;AAzDD,0CAyDC","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/dist/data-sources/initDataSources.d.cts

@@ -1,140 +0,0 @@
-import type { ApiPlatformClient } from "@metamask/core-backend";
-import { Messenger } from "@metamask/messenger";
-import type { ActionConstraint, EventConstraint } from "@metamask/messenger";
-import { AccountsApiDataSource } from "./AccountsApiDataSource.cjs";
-import type { AccountsApiDataSourceActions, AccountsApiDataSourceAllowedActions, AccountsApiDataSourceEvents, AccountsApiDataSourceMessenger } from "./AccountsApiDataSource.cjs";
-import { BackendWebsocketDataSource } from "./BackendWebsocketDataSource.cjs";
-import type { BackendWebsocketDataSourceActions, BackendWebsocketDataSourceAllowedActions, BackendWebsocketDataSourceAllowedEvents, BackendWebsocketDataSourceEvents, BackendWebsocketDataSourceMessenger } from "./BackendWebsocketDataSource.cjs";
-import { PriceDataSource } from "./PriceDataSource.cjs";
-import type { PriceDataSourceActions, PriceDataSourceAllowedActions, PriceDataSourceEvents, PriceDataSourceMessenger } from "./PriceDataSource.cjs";
-import { RpcDataSource } from "./RpcDataSource.cjs";
-import type { RpcDataSourceActions, RpcDataSourceAllowedActions, RpcDataSourceAllowedEvents, RpcDataSourceEvents, RpcDataSourceMessenger } from "./RpcDataSource.cjs";
-import { SnapDataSource } from "./SnapDataSource.cjs";
-import type { SnapDataSourceActions, SnapDataSourceEvents, SnapDataSourceMessenger } from "./SnapDataSource.cjs";
-import { TokenDataSource } from "./TokenDataSource.cjs";
-import type { TokenDataSourceActions, TokenDataSourceMessenger } from "./TokenDataSource.cjs";
-import type { DetectionMiddlewareActions, DetectionMiddlewareMessenger } from "../middlewares/index.cjs";
-import { DetectionMiddleware } from "../middlewares/index.cjs";
-/**
- * All actions from data sources.
- */
-export type DataSourceActions = RpcDataSourceActions | BackendWebsocketDataSourceActions | AccountsApiDataSourceActions | SnapDataSourceActions | TokenDataSourceActions | PriceDataSourceActions | DetectionMiddlewareActions;
-/**
- * All events from data sources.
- */
-export type DataSourceEvents = RpcDataSourceEvents | BackendWebsocketDataSourceEvents | AccountsApiDataSourceEvents | SnapDataSourceEvents | PriceDataSourceEvents;
-/**
- * All external actions that data sources need.
- * Note: TokenDataSource, AccountsApiDataSource, and PriceDataSource now use ApiPlatformClient
- * directly, so they don't need BackendApiClient actions delegated.
- */
-export type DataSourceAllowedActions = RpcDataSourceAllowedActions | BackendWebsocketDataSourceAllowedActions | AccountsApiDataSourceAllowedActions | PriceDataSourceAllowedActions;
-/**
- * All external events that data sources need.
- */
-export type DataSourceAllowedEvents = RpcDataSourceAllowedEvents | BackendWebsocketDataSourceAllowedEvents;
-/**
- * Root messenger type for all data sources.
- */
-export type RootMessenger<AllowedActions extends ActionConstraint, AllowedEvents extends EventConstraint> = Messenger<string, AllowedActions, AllowedEvents>;
-/**
- * All messengers for data sources.
- */
-export type DataSourceMessengers = {
-    rpcMessenger: RpcDataSourceMessenger;
-    backendWebsocketMessenger: BackendWebsocketDataSourceMessenger;
-    accountsApiMessenger: AccountsApiDataSourceMessenger;
-    snapMessenger: SnapDataSourceMessenger;
-    tokenMessenger: TokenDataSourceMessenger;
-    priceMessenger: PriceDataSourceMessenger;
-    detectionMessenger: DetectionMiddlewareMessenger;
-};
-/**
- * Options for initializing messengers.
- */
-export type InitMessengersOptions<AllowedActions extends ActionConstraint, AllowedEvents extends EventConstraint> = {
-    /** The root controller messenger */
-    messenger: RootMessenger<AllowedActions, AllowedEvents>;
-    /** Function to determine if initialization should proceed. Defaults to true. */
-    isEnabled?: () => boolean;
-};
-/**
- * All data source instances.
- */
-export type DataSources = {
-    rpcDataSource: RpcDataSource;
-    backendWebsocketDataSource: BackendWebsocketDataSource;
-    accountsApiDataSource: AccountsApiDataSource;
-    snapDataSource: SnapDataSource;
-    tokenDataSource: TokenDataSource;
-    priceDataSource: PriceDataSource;
-    detectionMiddleware: DetectionMiddleware;
-};
-/**
- * Configuration options for RpcDataSource.
- */
-export type RpcDataSourceConfig = {
-    /** Balance polling interval in ms (default: 30s) */
-    balanceInterval?: number;
-    /** Token detection polling interval in ms (default: 180s / 3 min) */
-    detectionInterval?: number;
-    /** Whether token detection is enabled (default: false) */
-    tokenDetectionEnabled?: boolean;
-    /** Request timeout in ms (default: 10s) */
-    timeout?: number;
-};
-/**
- * Options for initializing data sources.
- */
-export type InitDataSourcesOptions = {
-    /** Messengers for each data source */
-    messengers: DataSourceMessengers;
-    /** ApiPlatformClient for cached API calls */
-    queryApiClient: ApiPlatformClient;
-    /** Optional configuration for RpcDataSource */
-    rpcDataSourceConfig?: RpcDataSourceConfig;
-    /** Function to determine if initialization should proceed. Defaults to true. */
-    isEnabled?: () => boolean;
-};
-/**
- * Initialize all messengers for data sources.
- *
- * This function creates child messengers for each data source from the root
- * controller messenger, with proper action/event delegation.
- *
- * @example
- * ```typescript
- * import { initMessengers } from '@metamask/assets-controllers';
- *
- * const messengers = initMessengers({ messenger });
- * ```
- *
- * @param options - Configuration options
- * @returns Object containing all messengers, or null if disabled
- */
-export declare function initMessengers<AllowedActions extends ActionConstraint, AllowedEvents extends EventConstraint>(options: InitMessengersOptions<AllowedActions, AllowedEvents>): DataSourceMessengers | null;
-/**
- * Initialize all data sources and middlewares.
- *
- * This function creates and initializes all data sources, registering their
- * action handlers with the messenger.
- *
- * @example
- * ```typescript
- * import { initMessengers, initDataSources } from '@metamask/assets-controllers';
- *
- * // Initialize messengers first
- * const messengers = initMessengers({ controllerMessenger });
- *
- * // Then initialize data sources
- * const dataSources = initDataSources({
- *   messengers,
- *   queryApiClient,
- * });
- * ```
- *
- * @param options - Configuration options
- * @returns Object containing all data source instances, or null if disabled
- */
-export declare function initDataSources(options: InitDataSourcesOptions): DataSources | null;
-//# sourceMappingURL=initDataSources.d.cts.map