@metamask-previews/assets-controller 0.0.0-preview-903db2da → 0.0.0-preview-3ec2a74

package/dist/types.d.mts

@@ -0,0 +1,360 @@
+import type { InternalAccount } from "@metamask/keyring-internal-api";
+import type { CaipAssetType, CaipChainId, Json } from "@metamask/utils";
+/**
+ * CAIP-19 compliant asset identifier
+ * Format: "{chainId}/{assetNamespace}:{assetReference}[/tokenId]"
+ *
+ * Examples:
+ * - Native: "eip155:1/slip44:60" (ETH)
+ * - ERC20: "eip155:1/erc20:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" (USDC)
+ * - ERC721: "eip155:1/erc721:0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D/1234" (BAYC #1234)
+ * - SPL: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/spl:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
+ */
+export type Caip19AssetId = CaipAssetType;
+/**
+ * InternalAccount UUID from AccountsController
+ * Not the blockchain address!
+ */
+export type AccountId = string;
+/**
+ * CAIP-2 chain identifier
+ */
+export type ChainId = CaipChainId;
+/**
+ * Asset types define the metadata structure, not blockchain implementation.
+ * - "fungible" includes: native, erc20, spl - all share balance, symbol, decimals
+ * - "nft" includes: erc721, erc1155 - include tokenId, image, attributes
+ */
+export type AssetType = 'fungible' | 'nft' | 'collectible';
+/**
+ * Token standards - blockchain implementation details
+ */
+export type TokenStandard = 'native' | 'erc20' | 'erc721' | 'erc1155' | 'spl' | string;
+/**
+ * Base metadata attributes shared by ALL asset types.
+ */
+export type BaseAssetMetadata = {
+    /** Token standard - how it's implemented on the blockchain */
+    type: TokenStandard;
+    /** Display symbol (e.g., "ETH", "USDC") */
+    symbol: string;
+    /** Full name (e.g., "Ethereum", "USD Coin") */
+    name: string;
+    /** Token decimals (18 for ETH, 6 for USDC, etc.) */
+    decimals: number;
+    /** Logo URL or data URI */
+    image?: string;
+};
+/**
+ * Metadata for fungible tokens
+ * Asset Type: "fungible"
+ * Includes: native, ERC-20, SPL, and other fungible token standards
+ */
+export type FungibleAssetMetadata = {
+    type: 'native' | 'erc20' | 'spl';
+    /** Spam detection flag */
+    isSpam?: boolean;
+    /** Verification status */
+    verified?: boolean;
+    /** Token list memberships */
+    collections?: string[];
+} & BaseAssetMetadata;
+/**
+ * Metadata for ERC721 NFTs
+ * Asset Type: "nft"
+ */
+export type ERC721AssetMetadata = {
+    type: 'erc721';
+    decimals: 0;
+    /** Collection name */
+    collectionName?: string;
+    /** Collection size */
+    collectionSize?: number;
+    /** NFT traits/attributes - must be Json-serializable */
+    traits?: Record<string, Json>;
+    /** Rarity score */
+    rarity?: number;
+    /** Verification status */
+    verified?: boolean;
+} & BaseAssetMetadata;
+/**
+ * Metadata for ERC1155 multi-tokens
+ */
+export type ERC1155AssetMetadata = {
+    type: 'erc1155';
+    /** Token URI */
+    tokenUri?: string;
+    /** Token category */
+    category?: string;
+    /** Spam detection flag */
+    isSpam?: boolean;
+} & BaseAssetMetadata;
+/**
+ * Union type representing all possible asset metadata types.
+ * All types must be JSON-serializable.
+ */
+export type AssetMetadata = FungibleAssetMetadata | ERC721AssetMetadata | ERC1155AssetMetadata | (BaseAssetMetadata & {
+    [key: string]: Json;
+});
+/**
+ * Base price attributes.
+ */
+export type BaseAssetPrice = {
+    /** Current price in USD */
+    price: number;
+    /** 24h price change percentage */
+    priceChange24h?: number;
+    /** Timestamp of last price update */
+    lastUpdated: number;
+};
+/**
+ * Price data for fungible tokens (native, ERC20, SPL)
+ */
+export type FungibleAssetPrice = {
+    /** Market capitalization */
+    marketCap?: number;
+    /** 24h trading volume */
+    volume24h?: number;
+    /** Circulating supply */
+    circulatingSupply?: number;
+    /** Total supply */
+    totalSupply?: number;
+} & BaseAssetPrice;
+/**
+ * Price data for NFT collections
+ */
+export type NFTAssetPrice = {
+    /** Floor price */
+    floorPrice?: number;
+    /** Last sale price */
+    lastSalePrice?: number;
+    /** Collection trading volume */
+    collectionVolume?: number;
+    /** Average price */
+    averagePrice?: number;
+    /** Number of sales in 24h */
+    sales24h?: number;
+} & BaseAssetPrice;
+/**
+ * Union type representing all possible asset price types.
+ * All types must be JSON-serializable.
+ */
+export type AssetPrice = FungibleAssetPrice | NFTAssetPrice | (BaseAssetPrice & {
+    [key: string]: Json;
+});
+/**
+ * Balance data for fungible tokens (native, ERC20, SPL).
+ */
+export type FungibleAssetBalance = {
+    /** Raw balance amount as string (e.g., "1000000000" for 1000 USDC) */
+    amount: string;
+};
+/**
+ * Balance data for ERC721 NFTs.
+ * Each tokenId has its own CAIP-19 asset ID, so always "1".
+ */
+export type ERC721AssetBalance = {
+    /** Always "1" for ERC721 (non-fungible) */
+    amount: '1';
+};
+/**
+ * Balance data for ERC1155 multi-tokens.
+ */
+export type ERC1155AssetBalance = {
+    /** Quantity owned of this specific tokenId */
+    amount: string;
+};
+/**
+ * Union type representing all possible asset balance types.
+ * All types must be JSON-serializable.
+ */
+export type AssetBalance = FungibleAssetBalance | ERC721AssetBalance | ERC1155AssetBalance | {
+    amount: string;
+    [key: string]: Json;
+};
+/**
+ * Data type dimension - what kind of data
+ */
+export type DataType = 'balance' | 'metadata' | 'price';
+/**
+ * Request for data from data sources
+ */
+export type DataRequest = {
+    /** Accounts to fetch data for */
+    accounts: InternalAccount[];
+    /** CAIP-2 chain IDs */
+    chainIds: ChainId[];
+    /** Filter by asset types */
+    assetTypes?: AssetType[];
+    /** Which data to fetch */
+    dataTypes: DataType[];
+    /** Specific CAIP-19 asset IDs */
+    customAssets?: Caip19AssetId[];
+    /** Force fresh fetch, bypass cache */
+    forceUpdate?: boolean;
+    /** Hint for polling interval (ms) - used by data sources that implement polling */
+    updateInterval?: number;
+};
+/**
+ * Response from data sources
+ */
+export type DataResponse = {
+    /** Metadata for assets (shared across accounts) */
+    assetsMetadata?: Record<Caip19AssetId, AssetMetadata>;
+    /** Price data for assets (shared across accounts) */
+    assetsPrice?: Record<Caip19AssetId, AssetPrice>;
+    /** Balance data per account */
+    assetsBalance?: Record<AccountId, Record<Caip19AssetId, AssetBalance>>;
+    /** Errors encountered, keyed by chain ID */
+    errors?: Record<ChainId, string>;
+    /** Detected assets (assets that do not have metadata) */
+    detectedAssets?: Record<AccountId, Caip19AssetId[]>;
+};
+/**
+ * Internal state structure for AssetsController following normalized design.
+ *
+ * Keys use CAIP identifiers:
+ * - assetsMetadata keys: CAIP-19 asset IDs (e.g., "eip155:1/erc20:0x...")
+ * - assetsBalance outer keys: Account IDs (InternalAccount.id UUIDs)
+ * - assetsBalance inner keys: CAIP-19 asset IDs
+ * - customAssets outer keys: Account IDs (InternalAccount.id UUIDs)
+ * - customAssets inner values: CAIP-19 asset IDs array
+ */
+export type AssetsControllerStateInternal = {
+    /** Shared metadata for all assets (stored once per asset) */
+    assetsMetadata: Record<Caip19AssetId, AssetMetadata>;
+    /** Per-account balance data */
+    assetsBalance: Record<AccountId, Record<Caip19AssetId, AssetBalance>>;
+    /** Custom assets added by users per account */
+    customAssets: Record<AccountId, Caip19AssetId[]>;
+};
+/**
+ * Base context for all middleware operations.
+ * Contains the common interface shared by fetch and subscribe.
+ */
+export type Context = {
+    /** The data request */
+    request: DataRequest;
+    /** The response data (mutated by middlewares) */
+    response: DataResponse;
+    /** Get current assets state */
+    getAssetsState: () => AssetsControllerStateInternal;
+};
+/**
+ * Next function for middleware chain
+ */
+export type NextFunction = (context: Context) => Promise<Context>;
+/**
+ * Middleware function - works for both fetch and subscribe operations.
+ */
+export type Middleware = (context: Context, next: NextFunction) => Promise<Context>;
+/**
+ * Wraps a middleware to only execute if specific dataTypes are requested.
+ *
+ * @param dataTypes - DataTypes that must be in the request for middleware to run
+ * @param middleware - The middleware to conditionally execute
+ * @returns A middleware that skips execution if none of the dataTypes are requested
+ *
+ * @example
+ * ```typescript
+ * // Only runs for metadata requests
+ * const metadataMiddleware = forDataTypes(['metadata'], async (ctx, next) => {
+ *   const result = await next(ctx);
+ *   // Enrich metadata...
+ *   return result;
+ * });
+ *
+ * // Runs for balance or price requests
+ * const balanceOrPriceMiddleware = forDataTypes(['balance', 'price'], async (ctx, next) => {
+ *   const result = await next(ctx);
+ *   // Process balances or prices...
+ *   return result;
+ * });
+ * ```
+ */
+export declare function forDataTypes(dataTypes: DataType[], middleware: Middleware): Middleware;
+/**
+ * Context for fetch operations.
+ * Extends base Context - no additional fields needed for fetch.
+ */
+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
+ */
+export type SubscriptionResponse = {
+    /** Chains actively subscribed */
+    chains: ChainId[];
+    /** Account ID being watched */
+    accountId: AccountId;
+    /** Asset types being watched */
+    assetTypes: AssetType[];
+    /** Data types being kept fresh */
+    dataTypes: DataType[];
+    /** Cleanup function */
+    unsubscribe: () => void;
+};
+/**
+ * Combined asset type matching state structure: balance, metadata, price
+ */
+export type Asset = {
+    /** CAIP-19 asset ID */
+    id: Caip19AssetId;
+    /** CAIP-2 chain ID (extracted from id) */
+    chainId: ChainId;
+    /** Balance data */
+    balance: AssetBalance;
+    /** Metadata (symbol, name, decimals, etc.) */
+    metadata: AssetMetadata;
+    /** Price data */
+    price: AssetPrice;
+    /** Computed fiat value (balance × price) */
+    fiatValue: number;
+};
+/**
+ * Event emitted when balances change
+ */
+export type BalanceChangeEvent = {
+    accountId: AccountId;
+    assetId: Caip19AssetId;
+    previousAmount: string;
+    newAmount: string;
+    timestamp: number;
+};
+/**
+ * Event emitted when prices change
+ */
+export type PriceChangeEvent = {
+    assetIds: Caip19AssetId[];
+    timestamp: number;
+};
+/**
+ * Event emitted when metadata changes
+ */
+export type MetadataChangeEvent = {
+    assetId: Caip19AssetId;
+    changes: Partial<AssetMetadata>;
+};
+/**
+ * Event emitted when assets without metadata are detected
+ */
+export type AssetsDetectedEvent = {
+    accountId: AccountId;
+    assetIds: Caip19AssetId[];
+};
+//# sourceMappingURL=types.d.mts.map

package/dist/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,uCAAuC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,IAAI,EAAE,wBAAwB;AAExE;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC;AAMlC;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,aAAa,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,SAAS,GACT,KAAK,GACL,MAAM,CAAC;AAMX;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,8DAA8D;IAC9D,IAAI,EAAE,aAAa,CAAC;IACpB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;IACjC,0BAA0B;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,GAAG,iBAAiB,CAAC;AAEtB;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,CAAC,CAAC;IACZ,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9B,mBAAmB;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,iBAAiB,CAAC;AAEtB;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,SAAS,CAAC;IAChB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,iBAAiB,CAAC;AAEtB;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB,qBAAqB,GACrB,mBAAmB,GACnB,oBAAoB,GACpB,CAAC,iBAAiB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC;AAMlD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,cAAc,CAAC;AAEnB;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB,kBAAkB,GAClB,aAAa,GACb,CAAC,cAAc,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC;AAM/C;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,2CAA2C;IAC3C,MAAM,EAAE,GAAG,CAAC;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,oBAAoB,GACpB,kBAAkB,GAClB,mBAAmB,GACnB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAM5C;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,iCAAiC;IACjC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,uBAAuB;IACvB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,0BAA0B;IAC1B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,iCAAiC;IACjC,YAAY,CAAC,EAAE,aAAa,EAAE,CAAC;IAC/B,sCAAsC;IACtC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IACtD,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAChD,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;IACvE,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACjC,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;CACrD,CAAC;AAMF;;;;;;;;;GASG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IACrD,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;IACtE,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;CAClD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,uBAAuB;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,iDAAiD;IACjD,QAAQ,EAAE,YAAY,CAAC;IACvB,+BAA+B;IAC/B,cAAc,EAAE,MAAM,6BAA6B,CAAC;CACrD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CACvB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,YAAY,KACf,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,QAAQ,EAAE,EACrB,UAAU,EAAE,UAAU,GACrB,UAAU,CAWZ;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC;AAGnC,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAC7C,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC;AAEzC;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,iCAAiC;IACjC,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,+BAA+B;IAC/B,SAAS,EAAE,SAAS,CAAC;IACrB,gCAAgC;IAChC,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,kCAAkC;IAClC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,uBAAuB;IACvB,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG;IAClB,uBAAuB;IACvB,EAAE,EAAE,aAAa,CAAC;IAClB,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB;IACnB,OAAO,EAAE,YAAY,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,EAAE,aAAa,CAAC;IACxB,iBAAiB;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B,CAAC"}

package/dist/types.mjs

@@ -0,0 +1,35 @@
+/**
+ * Wraps a middleware to only execute if specific dataTypes are requested.
+ *
+ * @param dataTypes - DataTypes that must be in the request for middleware to run
+ * @param middleware - The middleware to conditionally execute
+ * @returns A middleware that skips execution if none of the dataTypes are requested
+ *
+ * @example
+ * ```typescript
+ * // Only runs for metadata requests
+ * const metadataMiddleware = forDataTypes(['metadata'], async (ctx, next) => {
+ *   const result = await next(ctx);
+ *   // Enrich metadata...
+ *   return result;
+ * });
+ *
+ * // Runs for balance or price requests
+ * const balanceOrPriceMiddleware = forDataTypes(['balance', 'price'], async (ctx, next) => {
+ *   const result = await next(ctx);
+ *   // Process balances or prices...
+ *   return result;
+ * });
+ * ```
+ */
+export function forDataTypes(dataTypes, middleware) {
+    return async (ctx, next) => {
+        const requestedTypes = ctx.request.dataTypes;
+        const shouldRun = dataTypes.some((dt) => requestedTypes.includes(dt));
+        if (!shouldRun) {
+            return next(ctx);
+        }
+        return middleware(ctx, next);
+    };
+}
+//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAyTA;;;;;;;;;;;;;;;;;;;;;;;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 * 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 * Metadata for fungible tokens\n * Asset Type: \"fungible\"\n * Includes: native, ERC-20, SPL, and other fungible token standards\n */\nexport type FungibleAssetMetadata = {\n  type: 'native' | 'erc20' | 'spl';\n  /** Spam detection flag */\n  isSpam?: boolean;\n  /** Verification status */\n  verified?: boolean;\n  /** Token list memberships */\n  collections?: string[];\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  /** 24h price change percentage */\n  priceChange24h?: number;\n  /** Timestamp of last price update */\n  lastUpdated: number;\n};\n\n/**\n * Price data for fungible tokens (native, ERC20, SPL)\n */\nexport type FungibleAssetPrice = {\n  /** Market capitalization */\n  marketCap?: number;\n  /** 24h trading volume */\n  volume24h?: number;\n  /** Circulating supply */\n  circulatingSupply?: number;\n  /** Total supply */\n  totalSupply?: number;\n} & BaseAssetPrice;\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 * - customAssets outer keys: Account IDs (InternalAccount.id UUIDs)\n * - customAssets inner values: CAIP-19 asset IDs array\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  /** Custom assets added by users per account */\n  customAssets: Record<AccountId, Caip19AssetId[]>;\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"]}

package/dist/utils.cjs

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeAssetId = void 0;
+const util_1 = require("@ethereumjs/util");
+const utils_1 = require("@metamask/utils");
+/**
+ * Normalizes a CAIP-19 asset ID by checksumming EVM addresses.
+ * This ensures consistent asset IDs regardless of the data source format.
+ *
+ * For EVM ERC20 tokens (e.g., "eip155:1/erc20:0x..."), the address is checksummed.
+ * All other asset types are returned unchanged.
+ *
+ * @param assetId - The CAIP-19 asset ID to normalize
+ * @returns The normalized asset ID with checksummed address (for EVM tokens)
+ */
+function normalizeAssetId(assetId) {
+    const parsed = (0, utils_1.parseCaipAssetType)(assetId);
+    const chainIdParsed = (0, utils_1.parseCaipChainId)(parsed.chainId);
+    // Only checksum EVM ERC20 addresses
+    if (chainIdParsed.namespace === 'eip155' &&
+        parsed.assetNamespace === 'erc20') {
+        const checksummedAddress = (0, util_1.toChecksumAddress)(parsed.assetReference);
+        return `${parsed.chainId}/${parsed.assetNamespace}:${checksummedAddress}`;
+    }
+    return assetId;
+}
+exports.normalizeAssetId = normalizeAssetId;
+//# sourceMappingURL=utils.cjs.map

package/dist/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;AAAA,2CAAqD;AACrD,2CAAuE;AAIvE;;;;;;;;;GASG;AACH,SAAgB,gBAAgB,CAAC,OAAsB;IACrD,MAAM,MAAM,GAAG,IAAA,0BAAkB,EAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,IAAA,wBAAgB,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEvD,oCAAoC;IACpC,IACE,aAAa,CAAC,SAAS,KAAK,QAAQ;QACpC,MAAM,CAAC,cAAc,KAAK,OAAO,EACjC,CAAC;QACD,MAAM,kBAAkB,GAAG,IAAA,wBAAiB,EAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACpE,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,cAAc,IAAI,kBAAkB,EAAmB,CAAC;IAC7F,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAdD,4CAcC","sourcesContent":["import { toChecksumAddress } from '@ethereumjs/util';\nimport { parseCaipAssetType, parseCaipChainId } from '@metamask/utils';\n\nimport type { Caip19AssetId } from './types';\n\n/**\n * Normalizes a CAIP-19 asset ID by checksumming EVM addresses.\n * This ensures consistent asset IDs regardless of the data source format.\n *\n * For EVM ERC20 tokens (e.g., \"eip155:1/erc20:0x...\"), the address is checksummed.\n * All other asset types are returned unchanged.\n *\n * @param assetId - The CAIP-19 asset ID to normalize\n * @returns The normalized asset ID with checksummed address (for EVM tokens)\n */\nexport function normalizeAssetId(assetId: Caip19AssetId): Caip19AssetId {\n  const parsed = parseCaipAssetType(assetId);\n  const chainIdParsed = parseCaipChainId(parsed.chainId);\n\n  // Only checksum EVM ERC20 addresses\n  if (\n    chainIdParsed.namespace === 'eip155' &&\n    parsed.assetNamespace === 'erc20'\n  ) {\n    const checksummedAddress = toChecksumAddress(parsed.assetReference);\n    return `${parsed.chainId}/${parsed.assetNamespace}:${checksummedAddress}` as Caip19AssetId;\n  }\n\n  return assetId;\n}\n"]}

package/dist/utils.d.cts

@@ -0,0 +1,13 @@
+import type { Caip19AssetId } from "./types.cjs";
+/**
+ * Normalizes a CAIP-19 asset ID by checksumming EVM addresses.
+ * This ensures consistent asset IDs regardless of the data source format.
+ *
+ * For EVM ERC20 tokens (e.g., "eip155:1/erc20:0x..."), the address is checksummed.
+ * All other asset types are returned unchanged.
+ *
+ * @param assetId - The CAIP-19 asset ID to normalize
+ * @returns The normalized asset ID with checksummed address (for EVM tokens)
+ */
+export declare function normalizeAssetId(assetId: Caip19AssetId): Caip19AssetId;
+//# sourceMappingURL=utils.d.cts.map

package/dist/utils.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAgB;AAE7C;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CActE"}

package/dist/utils.d.mts

@@ -0,0 +1,13 @@
+import type { Caip19AssetId } from "./types.mjs";
+/**
+ * Normalizes a CAIP-19 asset ID by checksumming EVM addresses.
+ * This ensures consistent asset IDs regardless of the data source format.
+ *
+ * For EVM ERC20 tokens (e.g., "eip155:1/erc20:0x..."), the address is checksummed.
+ * All other asset types are returned unchanged.
+ *
+ * @param assetId - The CAIP-19 asset ID to normalize
+ * @returns The normalized asset ID with checksummed address (for EVM tokens)
+ */
+export declare function normalizeAssetId(assetId: Caip19AssetId): Caip19AssetId;
+//# sourceMappingURL=utils.d.mts.map

package/dist/utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAgB;AAE7C;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CActE"}

package/dist/utils.mjs

@@ -0,0 +1,24 @@
+import { toChecksumAddress } from "@ethereumjs/util";
+import { parseCaipAssetType, parseCaipChainId } from "@metamask/utils";
+/**
+ * Normalizes a CAIP-19 asset ID by checksumming EVM addresses.
+ * This ensures consistent asset IDs regardless of the data source format.
+ *
+ * For EVM ERC20 tokens (e.g., "eip155:1/erc20:0x..."), the address is checksummed.
+ * All other asset types are returned unchanged.
+ *
+ * @param assetId - The CAIP-19 asset ID to normalize
+ * @returns The normalized asset ID with checksummed address (for EVM tokens)
+ */
+export function normalizeAssetId(assetId) {
+    const parsed = parseCaipAssetType(assetId);
+    const chainIdParsed = parseCaipChainId(parsed.chainId);
+    // Only checksum EVM ERC20 addresses
+    if (chainIdParsed.namespace === 'eip155' &&
+        parsed.assetNamespace === 'erc20') {
+        const checksummedAddress = toChecksumAddress(parsed.assetReference);
+        return `${parsed.chainId}/${parsed.assetNamespace}:${checksummedAddress}`;
+    }
+    return assetId;
+}
+//# sourceMappingURL=utils.mjs.map

package/dist/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,yBAAyB;AACrD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,wBAAwB;AAIvE;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAsB;IACrD,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEvD,oCAAoC;IACpC,IACE,aAAa,CAAC,SAAS,KAAK,QAAQ;QACpC,MAAM,CAAC,cAAc,KAAK,OAAO,EACjC,CAAC;QACD,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACpE,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,cAAc,IAAI,kBAAkB,EAAmB,CAAC;IAC7F,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import { toChecksumAddress } from '@ethereumjs/util';\nimport { parseCaipAssetType, parseCaipChainId } from '@metamask/utils';\n\nimport type { Caip19AssetId } from './types';\n\n/**\n * Normalizes a CAIP-19 asset ID by checksumming EVM addresses.\n * This ensures consistent asset IDs regardless of the data source format.\n *\n * For EVM ERC20 tokens (e.g., \"eip155:1/erc20:0x...\"), the address is checksummed.\n * All other asset types are returned unchanged.\n *\n * @param assetId - The CAIP-19 asset ID to normalize\n * @returns The normalized asset ID with checksummed address (for EVM tokens)\n */\nexport function normalizeAssetId(assetId: Caip19AssetId): Caip19AssetId {\n  const parsed = parseCaipAssetType(assetId);\n  const chainIdParsed = parseCaipChainId(parsed.chainId);\n\n  // Only checksum EVM ERC20 addresses\n  if (\n    chainIdParsed.namespace === 'eip155' &&\n    parsed.assetNamespace === 'erc20'\n  ) {\n    const checksummedAddress = toChecksumAddress(parsed.assetReference);\n    return `${parsed.chainId}/${parsed.assetNamespace}:${checksummedAddress}` as Caip19AssetId;\n  }\n\n  return assetId;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/assets-controller",
-  "version": "0.0.0-preview-903db2da",
+  "version": "0.0.0-preview-3ec2a74",
   "description": "Tracks assets balances/prices and handles token detection across all digital assets",
   "keywords": [
     "MetaMask",
@@ -48,13 +48,26 @@
     "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch"
   },
   "dependencies": {
+    "@ethereumjs/util": "^9.1.0",
+    "@ethersproject/providers": "^5.7.0",
+    "@metamask/account-tree-controller": "^4.0.0",
     "@metamask/base-controller": "^9.0.0",
-    "@metamask/messenger": "^0.3.0"
+    "@metamask/core-backend": "^5.0.0",
+    "@metamask/keyring-controller": "^25.0.0",
+    "@metamask/keyring-internal-api": "^9.0.0",
+    "@metamask/messenger": "^0.3.0",
+    "@metamask/network-enablement-controller": "^4.1.0",
+    "@metamask/utils": "^11.9.0",
+    "async-mutex": "^0.5.0",
+    "bignumber.js": "^9.1.2",
+    "lodash": "^4.17.21",
+    "viem": "^2.44.4"
   },
   "devDependencies": {
     "@metamask/auto-changelog": "^3.4.4",
     "@ts-bridge/cli": "^0.6.4",
     "@types/jest": "^27.4.1",
+    "@types/lodash": "^4.14.191",
     "deepmerge": "^4.2.2",
     "jest": "^27.5.1",
     "ts-jest": "^27.1.4",