@metamask/client-utils 1.0.0

package/dist/mappers/helpers/caip.cjs

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatAddressToAssetId = exports.getNativeAsset = exports.formatChainIdToCaip = void 0;
+const controller_utils_1 = require("@metamask/controller-utils");
+const utils_1 = require("@metamask/utils");
+const constants_1 = require("../constants.cjs");
+const nativeAssetsByCaipChainId = {
+    'eip155:1': { symbol: 'ETH', decimals: 18, slip44: 60 },
+    'eip155:10': { symbol: 'ETH', decimals: 18, slip44: 60 },
+    'eip155:56': { symbol: 'BNB', decimals: 18, slip44: 714 },
+    'eip155:137': { symbol: 'POL', decimals: 18, slip44: 966 },
+    'eip155:324': { symbol: 'ETH', decimals: 18, slip44: 60 },
+    'eip155:1329': { symbol: 'SEI', decimals: 18, slip44: 19000118 },
+    'eip155:8453': { symbol: 'ETH', decimals: 18, slip44: 60 },
+    'eip155:42161': { symbol: 'ETH', decimals: 18, slip44: 60 },
+    'eip155:43114': { symbol: 'AVAX', decimals: 18, slip44: 9005 },
+    'eip155:59144': { symbol: 'ETH', decimals: 18, slip44: 60 },
+};
+/**
+ * Normalizes a hex, decimal, numeric, or CAIP chain id to its CAIP-2 form.
+ * Only EVM (eip155) chains are normalized here; CAIP ids are returned as-is.
+ *
+ * @param chainId - Hex (`0x1`), numeric, decimal string, or CAIP chain id.
+ * @returns The CAIP-2 chain id, or `undefined` when it can't be normalized.
+ */
+function formatChainIdToCaip(chainId) {
+    if (typeof chainId === 'number') {
+        return `eip155:${chainId}`;
+    }
+    if (chainId.includes(':')) {
+        return chainId;
+    }
+    if (chainId.startsWith('0x')) {
+        const reference = Number.parseInt(chainId, 16);
+        return Number.isNaN(reference) ? undefined : `eip155:${reference}`;
+    }
+    const reference = Number(chainId);
+    return Number.isNaN(reference) ? undefined : `eip155:${reference}`;
+}
+exports.formatChainIdToCaip = formatChainIdToCaip;
+/**
+ * Looks up the native asset metadata for a chain from the canonical table.
+ * Returns `undefined` (never throws) for chains outside the table — callers
+ * degrade gracefully, matching the previous bridge-controller behaviour.
+ *
+ * @param chainId - Hex, numeric, decimal, or CAIP chain id.
+ * @returns Native asset symbol/decimals/assetId, or `undefined` if unsupported.
+ */
+function getNativeAsset(chainId) {
+    const caipChainId = formatChainIdToCaip(chainId);
+    if (!caipChainId) {
+        return undefined;
+    }
+    const entry = nativeAssetsByCaipChainId[caipChainId];
+    if (!entry) {
+        return undefined;
+    }
+    return {
+        symbol: entry.symbol,
+        decimals: entry.decimals,
+        assetId: `${caipChainId}/slip44:${entry.slip44}`,
+    };
+}
+exports.getNativeAsset = getNativeAsset;
+function isNativeAddress(address) {
+    const normalized = address.toLowerCase();
+    return (normalized === constants_1.nativeTokenAddress ||
+        normalized === '0x0' ||
+        /^0x0+$/u.test(normalized));
+}
+/**
+ * Encodes an EVM token address + chain id into a CAIP-19 asset id.
+ *
+ * @param address - Hex contract address, native sentinel, or CAIP asset id.
+ * @param chainId - CAIP-2 or hex chain id.
+ * @returns The CAIP-19 asset id, or `undefined` when it can't be encoded.
+ */
+function formatAddressToAssetId(address, chainId) {
+    if ((0, utils_1.isCaipAssetType)(address)) {
+        return address;
+    }
+    const caipChainId = chainId ? formatChainIdToCaip(chainId) : undefined;
+    if (!caipChainId) {
+        return undefined;
+    }
+    if (isNativeAddress(address)) {
+        const nativeAssetId = getNativeAsset(caipChainId)?.assetId;
+        if (nativeAssetId) {
+            return nativeAssetId;
+        }
+    }
+    const checksummedAddress = (0, controller_utils_1.toChecksumHexAddress)(address);
+    if (!(0, utils_1.isStrictHexString)(checksummedAddress)) {
+        return undefined;
+    }
+    const { namespace, reference } = (0, utils_1.parseCaipChainId)(caipChainId);
+    return (0, utils_1.toCaipAssetType)(namespace, reference, 'erc20', checksummedAddress);
+}
+exports.formatAddressToAssetId = formatAddressToAssetId;
+//# sourceMappingURL=caip.cjs.map

package/dist/mappers/helpers/caip.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip.cjs","sourceRoot":"","sources":["../../../src/mappers/helpers/caip.ts"],"names":[],"mappings":"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","sourcesContent":["import { toChecksumHexAddress } from '@metamask/controller-utils';\nimport type { CaipAssetType, CaipChainId, Hex } from '@metamask/utils';\nimport {\n  isCaipAssetType,\n  isStrictHexString,\n  parseCaipChainId,\n  toCaipAssetType,\n} from '@metamask/utils';\n\nimport { nativeTokenAddress } from '../constants';\n\nexport type NativeAssetMetadata = {\n  symbol: string;\n  decimals: number;\n  assetId: CaipChainId | string;\n};\n\ntype NativeAssetEntry = {\n  symbol: string;\n  decimals: number;\n  slip44: number;\n};\n\nconst nativeAssetsByCaipChainId: Record<string, NativeAssetEntry> = {\n  'eip155:1': { symbol: 'ETH', decimals: 18, slip44: 60 },\n  'eip155:10': { symbol: 'ETH', decimals: 18, slip44: 60 },\n  'eip155:56': { symbol: 'BNB', decimals: 18, slip44: 714 },\n  'eip155:137': { symbol: 'POL', decimals: 18, slip44: 966 },\n  'eip155:324': { symbol: 'ETH', decimals: 18, slip44: 60 },\n  'eip155:1329': { symbol: 'SEI', decimals: 18, slip44: 19000118 },\n  'eip155:8453': { symbol: 'ETH', decimals: 18, slip44: 60 },\n  'eip155:42161': { symbol: 'ETH', decimals: 18, slip44: 60 },\n  'eip155:43114': { symbol: 'AVAX', decimals: 18, slip44: 9005 },\n  'eip155:59144': { symbol: 'ETH', decimals: 18, slip44: 60 },\n};\n\n/**\n * Normalizes a hex, decimal, numeric, or CAIP chain id to its CAIP-2 form.\n * Only EVM (eip155) chains are normalized here; CAIP ids are returned as-is.\n *\n * @param chainId - Hex (`0x1`), numeric, decimal string, or CAIP chain id.\n * @returns The CAIP-2 chain id, or `undefined` when it can't be normalized.\n */\nexport function formatChainIdToCaip(\n  chainId: string | number,\n): CaipChainId | undefined {\n  if (typeof chainId === 'number') {\n    return `eip155:${chainId}`;\n  }\n\n  if (chainId.includes(':')) {\n    return chainId as CaipChainId;\n  }\n\n  if (chainId.startsWith('0x')) {\n    const reference = Number.parseInt(chainId, 16);\n    return Number.isNaN(reference) ? undefined : `eip155:${reference}`;\n  }\n\n  const reference = Number(chainId);\n  return Number.isNaN(reference) ? undefined : `eip155:${reference}`;\n}\n\n/**\n * Looks up the native asset metadata for a chain from the canonical table.\n * Returns `undefined` (never throws) for chains outside the table — callers\n * degrade gracefully, matching the previous bridge-controller behaviour.\n *\n * @param chainId - Hex, numeric, decimal, or CAIP chain id.\n * @returns Native asset symbol/decimals/assetId, or `undefined` if unsupported.\n */\nexport function getNativeAsset(\n  chainId: string | number,\n): NativeAssetMetadata | undefined {\n  const caipChainId = formatChainIdToCaip(chainId);\n\n  if (!caipChainId) {\n    return undefined;\n  }\n\n  const entry = nativeAssetsByCaipChainId[caipChainId];\n\n  if (!entry) {\n    return undefined;\n  }\n\n  return {\n    symbol: entry.symbol,\n    decimals: entry.decimals,\n    assetId: `${caipChainId}/slip44:${entry.slip44}`,\n  };\n}\n\nfunction isNativeAddress(address: string): boolean {\n  const normalized = address.toLowerCase();\n  return (\n    normalized === nativeTokenAddress ||\n    normalized === '0x0' ||\n    /^0x0+$/u.test(normalized)\n  );\n}\n\n/**\n * Encodes an EVM token address + chain id into a CAIP-19 asset id.\n *\n * @param address - Hex contract address, native sentinel, or CAIP asset id.\n * @param chainId - CAIP-2 or hex chain id.\n * @returns The CAIP-19 asset id, or `undefined` when it can't be encoded.\n */\nexport function formatAddressToAssetId(\n  address: Hex | CaipAssetType | string,\n  chainId?: CaipChainId | Hex,\n): CaipAssetType | undefined {\n  if (isCaipAssetType(address)) {\n    return address;\n  }\n\n  const caipChainId = chainId ? formatChainIdToCaip(chainId) : undefined;\n\n  if (!caipChainId) {\n    return undefined;\n  }\n\n  if (isNativeAddress(address)) {\n    const nativeAssetId = getNativeAsset(caipChainId)?.assetId;\n\n    if (nativeAssetId) {\n      return nativeAssetId as CaipAssetType;\n    }\n  }\n\n  const checksummedAddress = toChecksumHexAddress(address);\n\n  if (!isStrictHexString(checksummedAddress)) {\n    return undefined;\n  }\n\n  const { namespace, reference } = parseCaipChainId(caipChainId);\n\n  return toCaipAssetType(namespace, reference, 'erc20', checksummedAddress);\n}\n"]}

package/dist/mappers/helpers/caip.d.cts

@@ -0,0 +1,32 @@
+import type { CaipAssetType, CaipChainId, Hex } from "@metamask/utils";
+export type NativeAssetMetadata = {
+    symbol: string;
+    decimals: number;
+    assetId: CaipChainId | string;
+};
+/**
+ * Normalizes a hex, decimal, numeric, or CAIP chain id to its CAIP-2 form.
+ * Only EVM (eip155) chains are normalized here; CAIP ids are returned as-is.
+ *
+ * @param chainId - Hex (`0x1`), numeric, decimal string, or CAIP chain id.
+ * @returns The CAIP-2 chain id, or `undefined` when it can't be normalized.
+ */
+export declare function formatChainIdToCaip(chainId: string | number): CaipChainId | undefined;
+/**
+ * Looks up the native asset metadata for a chain from the canonical table.
+ * Returns `undefined` (never throws) for chains outside the table — callers
+ * degrade gracefully, matching the previous bridge-controller behaviour.
+ *
+ * @param chainId - Hex, numeric, decimal, or CAIP chain id.
+ * @returns Native asset symbol/decimals/assetId, or `undefined` if unsupported.
+ */
+export declare function getNativeAsset(chainId: string | number): NativeAssetMetadata | undefined;
+/**
+ * Encodes an EVM token address + chain id into a CAIP-19 asset id.
+ *
+ * @param address - Hex contract address, native sentinel, or CAIP asset id.
+ * @param chainId - CAIP-2 or hex chain id.
+ * @returns The CAIP-19 asset id, or `undefined` when it can't be encoded.
+ */
+export declare function formatAddressToAssetId(address: Hex | CaipAssetType | string, chainId?: CaipChainId | Hex): CaipAssetType | undefined;
+//# sourceMappingURL=caip.d.cts.map

package/dist/mappers/helpers/caip.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip.d.cts","sourceRoot":"","sources":["../../../src/mappers/helpers/caip.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,EAAE,wBAAwB;AAUvE,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC;CAC/B,CAAC;AAqBF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,GAAG,MAAM,GACvB,WAAW,GAAG,SAAS,CAgBzB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,GAAG,MAAM,GACvB,mBAAmB,GAAG,SAAS,CAkBjC;AAWD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,GAAG,GAAG,aAAa,GAAG,MAAM,EACrC,OAAO,CAAC,EAAE,WAAW,GAAG,GAAG,GAC1B,aAAa,GAAG,SAAS,CA4B3B"}

package/dist/mappers/helpers/caip.d.mts

@@ -0,0 +1,32 @@
+import type { CaipAssetType, CaipChainId, Hex } from "@metamask/utils";
+export type NativeAssetMetadata = {
+    symbol: string;
+    decimals: number;
+    assetId: CaipChainId | string;
+};
+/**
+ * Normalizes a hex, decimal, numeric, or CAIP chain id to its CAIP-2 form.
+ * Only EVM (eip155) chains are normalized here; CAIP ids are returned as-is.
+ *
+ * @param chainId - Hex (`0x1`), numeric, decimal string, or CAIP chain id.
+ * @returns The CAIP-2 chain id, or `undefined` when it can't be normalized.
+ */
+export declare function formatChainIdToCaip(chainId: string | number): CaipChainId | undefined;
+/**
+ * Looks up the native asset metadata for a chain from the canonical table.
+ * Returns `undefined` (never throws) for chains outside the table — callers
+ * degrade gracefully, matching the previous bridge-controller behaviour.
+ *
+ * @param chainId - Hex, numeric, decimal, or CAIP chain id.
+ * @returns Native asset symbol/decimals/assetId, or `undefined` if unsupported.
+ */
+export declare function getNativeAsset(chainId: string | number): NativeAssetMetadata | undefined;
+/**
+ * Encodes an EVM token address + chain id into a CAIP-19 asset id.
+ *
+ * @param address - Hex contract address, native sentinel, or CAIP asset id.
+ * @param chainId - CAIP-2 or hex chain id.
+ * @returns The CAIP-19 asset id, or `undefined` when it can't be encoded.
+ */
+export declare function formatAddressToAssetId(address: Hex | CaipAssetType | string, chainId?: CaipChainId | Hex): CaipAssetType | undefined;
+//# sourceMappingURL=caip.d.mts.map

package/dist/mappers/helpers/caip.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip.d.mts","sourceRoot":"","sources":["../../../src/mappers/helpers/caip.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,EAAE,wBAAwB;AAUvE,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC;CAC/B,CAAC;AAqBF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,GAAG,MAAM,GACvB,WAAW,GAAG,SAAS,CAgBzB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,GAAG,MAAM,GACvB,mBAAmB,GAAG,SAAS,CAkBjC;AAWD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,GAAG,GAAG,aAAa,GAAG,MAAM,EACrC,OAAO,CAAC,EAAE,WAAW,GAAG,GAAG,GAC1B,aAAa,GAAG,SAAS,CA4B3B"}

package/dist/mappers/helpers/caip.mjs

@@ -0,0 +1,94 @@
+import { toChecksumHexAddress } from "@metamask/controller-utils";
+import { isCaipAssetType, isStrictHexString, parseCaipChainId, toCaipAssetType } from "@metamask/utils";
+import { nativeTokenAddress } from "../constants.mjs";
+const nativeAssetsByCaipChainId = {
+    'eip155:1': { symbol: 'ETH', decimals: 18, slip44: 60 },
+    'eip155:10': { symbol: 'ETH', decimals: 18, slip44: 60 },
+    'eip155:56': { symbol: 'BNB', decimals: 18, slip44: 714 },
+    'eip155:137': { symbol: 'POL', decimals: 18, slip44: 966 },
+    'eip155:324': { symbol: 'ETH', decimals: 18, slip44: 60 },
+    'eip155:1329': { symbol: 'SEI', decimals: 18, slip44: 19000118 },
+    'eip155:8453': { symbol: 'ETH', decimals: 18, slip44: 60 },
+    'eip155:42161': { symbol: 'ETH', decimals: 18, slip44: 60 },
+    'eip155:43114': { symbol: 'AVAX', decimals: 18, slip44: 9005 },
+    'eip155:59144': { symbol: 'ETH', decimals: 18, slip44: 60 },
+};
+/**
+ * Normalizes a hex, decimal, numeric, or CAIP chain id to its CAIP-2 form.
+ * Only EVM (eip155) chains are normalized here; CAIP ids are returned as-is.
+ *
+ * @param chainId - Hex (`0x1`), numeric, decimal string, or CAIP chain id.
+ * @returns The CAIP-2 chain id, or `undefined` when it can't be normalized.
+ */
+export function formatChainIdToCaip(chainId) {
+    if (typeof chainId === 'number') {
+        return `eip155:${chainId}`;
+    }
+    if (chainId.includes(':')) {
+        return chainId;
+    }
+    if (chainId.startsWith('0x')) {
+        const reference = Number.parseInt(chainId, 16);
+        return Number.isNaN(reference) ? undefined : `eip155:${reference}`;
+    }
+    const reference = Number(chainId);
+    return Number.isNaN(reference) ? undefined : `eip155:${reference}`;
+}
+/**
+ * Looks up the native asset metadata for a chain from the canonical table.
+ * Returns `undefined` (never throws) for chains outside the table — callers
+ * degrade gracefully, matching the previous bridge-controller behaviour.
+ *
+ * @param chainId - Hex, numeric, decimal, or CAIP chain id.
+ * @returns Native asset symbol/decimals/assetId, or `undefined` if unsupported.
+ */
+export function getNativeAsset(chainId) {
+    const caipChainId = formatChainIdToCaip(chainId);
+    if (!caipChainId) {
+        return undefined;
+    }
+    const entry = nativeAssetsByCaipChainId[caipChainId];
+    if (!entry) {
+        return undefined;
+    }
+    return {
+        symbol: entry.symbol,
+        decimals: entry.decimals,
+        assetId: `${caipChainId}/slip44:${entry.slip44}`,
+    };
+}
+function isNativeAddress(address) {
+    const normalized = address.toLowerCase();
+    return (normalized === nativeTokenAddress ||
+        normalized === '0x0' ||
+        /^0x0+$/u.test(normalized));
+}
+/**
+ * Encodes an EVM token address + chain id into a CAIP-19 asset id.
+ *
+ * @param address - Hex contract address, native sentinel, or CAIP asset id.
+ * @param chainId - CAIP-2 or hex chain id.
+ * @returns The CAIP-19 asset id, or `undefined` when it can't be encoded.
+ */
+export function formatAddressToAssetId(address, chainId) {
+    if (isCaipAssetType(address)) {
+        return address;
+    }
+    const caipChainId = chainId ? formatChainIdToCaip(chainId) : undefined;
+    if (!caipChainId) {
+        return undefined;
+    }
+    if (isNativeAddress(address)) {
+        const nativeAssetId = getNativeAsset(caipChainId)?.assetId;
+        if (nativeAssetId) {
+            return nativeAssetId;
+        }
+    }
+    const checksummedAddress = toChecksumHexAddress(address);
+    if (!isStrictHexString(checksummedAddress)) {
+        return undefined;
+    }
+    const { namespace, reference } = parseCaipChainId(caipChainId);
+    return toCaipAssetType(namespace, reference, 'erc20', checksummedAddress);
+}
+//# sourceMappingURL=caip.mjs.map

package/dist/mappers/helpers/caip.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip.mjs","sourceRoot":"","sources":["../../../src/mappers/helpers/caip.ts"],"names":[],"mappings":"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","sourcesContent":["import { toChecksumHexAddress } from '@metamask/controller-utils';\nimport type { CaipAssetType, CaipChainId, Hex } from '@metamask/utils';\nimport {\n  isCaipAssetType,\n  isStrictHexString,\n  parseCaipChainId,\n  toCaipAssetType,\n} from '@metamask/utils';\n\nimport { nativeTokenAddress } from '../constants';\n\nexport type NativeAssetMetadata = {\n  symbol: string;\n  decimals: number;\n  assetId: CaipChainId | string;\n};\n\ntype NativeAssetEntry = {\n  symbol: string;\n  decimals: number;\n  slip44: number;\n};\n\nconst nativeAssetsByCaipChainId: Record<string, NativeAssetEntry> = {\n  'eip155:1': { symbol: 'ETH', decimals: 18, slip44: 60 },\n  'eip155:10': { symbol: 'ETH', decimals: 18, slip44: 60 },\n  'eip155:56': { symbol: 'BNB', decimals: 18, slip44: 714 },\n  'eip155:137': { symbol: 'POL', decimals: 18, slip44: 966 },\n  'eip155:324': { symbol: 'ETH', decimals: 18, slip44: 60 },\n  'eip155:1329': { symbol: 'SEI', decimals: 18, slip44: 19000118 },\n  'eip155:8453': { symbol: 'ETH', decimals: 18, slip44: 60 },\n  'eip155:42161': { symbol: 'ETH', decimals: 18, slip44: 60 },\n  'eip155:43114': { symbol: 'AVAX', decimals: 18, slip44: 9005 },\n  'eip155:59144': { symbol: 'ETH', decimals: 18, slip44: 60 },\n};\n\n/**\n * Normalizes a hex, decimal, numeric, or CAIP chain id to its CAIP-2 form.\n * Only EVM (eip155) chains are normalized here; CAIP ids are returned as-is.\n *\n * @param chainId - Hex (`0x1`), numeric, decimal string, or CAIP chain id.\n * @returns The CAIP-2 chain id, or `undefined` when it can't be normalized.\n */\nexport function formatChainIdToCaip(\n  chainId: string | number,\n): CaipChainId | undefined {\n  if (typeof chainId === 'number') {\n    return `eip155:${chainId}`;\n  }\n\n  if (chainId.includes(':')) {\n    return chainId as CaipChainId;\n  }\n\n  if (chainId.startsWith('0x')) {\n    const reference = Number.parseInt(chainId, 16);\n    return Number.isNaN(reference) ? undefined : `eip155:${reference}`;\n  }\n\n  const reference = Number(chainId);\n  return Number.isNaN(reference) ? undefined : `eip155:${reference}`;\n}\n\n/**\n * Looks up the native asset metadata for a chain from the canonical table.\n * Returns `undefined` (never throws) for chains outside the table — callers\n * degrade gracefully, matching the previous bridge-controller behaviour.\n *\n * @param chainId - Hex, numeric, decimal, or CAIP chain id.\n * @returns Native asset symbol/decimals/assetId, or `undefined` if unsupported.\n */\nexport function getNativeAsset(\n  chainId: string | number,\n): NativeAssetMetadata | undefined {\n  const caipChainId = formatChainIdToCaip(chainId);\n\n  if (!caipChainId) {\n    return undefined;\n  }\n\n  const entry = nativeAssetsByCaipChainId[caipChainId];\n\n  if (!entry) {\n    return undefined;\n  }\n\n  return {\n    symbol: entry.symbol,\n    decimals: entry.decimals,\n    assetId: `${caipChainId}/slip44:${entry.slip44}`,\n  };\n}\n\nfunction isNativeAddress(address: string): boolean {\n  const normalized = address.toLowerCase();\n  return (\n    normalized === nativeTokenAddress ||\n    normalized === '0x0' ||\n    /^0x0+$/u.test(normalized)\n  );\n}\n\n/**\n * Encodes an EVM token address + chain id into a CAIP-19 asset id.\n *\n * @param address - Hex contract address, native sentinel, or CAIP asset id.\n * @param chainId - CAIP-2 or hex chain id.\n * @returns The CAIP-19 asset id, or `undefined` when it can't be encoded.\n */\nexport function formatAddressToAssetId(\n  address: Hex | CaipAssetType | string,\n  chainId?: CaipChainId | Hex,\n): CaipAssetType | undefined {\n  if (isCaipAssetType(address)) {\n    return address;\n  }\n\n  const caipChainId = chainId ? formatChainIdToCaip(chainId) : undefined;\n\n  if (!caipChainId) {\n    return undefined;\n  }\n\n  if (isNativeAddress(address)) {\n    const nativeAssetId = getNativeAsset(caipChainId)?.assetId;\n\n    if (nativeAssetId) {\n      return nativeAssetId as CaipAssetType;\n    }\n  }\n\n  const checksummedAddress = toChecksumHexAddress(address);\n\n  if (!isStrictHexString(checksummedAddress)) {\n    return undefined;\n  }\n\n  const { namespace, reference } = parseCaipChainId(caipChainId);\n\n  return toCaipAssetType(namespace, reference, 'erc20', checksummedAddress);\n}\n"]}

package/dist/mappers/helpers/token-metadata.cjs

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getKnownTokenMetadata = void 0;
+const contract_metadata_1 = __importDefault(require("@metamask/contract-metadata"));
+const controller_utils_1 = require("@metamask/controller-utils");
+const caip_1 = require("./caip.cjs");
+const mainnetTokens = contract_metadata_1.default;
+const mainnetAssetIdPrefix = 'eip155:1/';
+function getKnownTokenMetadata(chainId, contractAddress) {
+    if (!contractAddress) {
+        return undefined;
+    }
+    const assetId = (0, caip_1.formatAddressToAssetId)(contractAddress, chainId);
+    if (!assetId?.startsWith(mainnetAssetIdPrefix)) {
+        return undefined;
+    }
+    const entry = mainnetTokens[(0, controller_utils_1.toChecksumHexAddress)(contractAddress)];
+    if (!entry) {
+        return undefined;
+    }
+    return {
+        symbol: entry.symbol,
+        decimals: entry.decimals,
+        assetId,
+    };
+}
+exports.getKnownTokenMetadata = getKnownTokenMetadata;
+//# sourceMappingURL=token-metadata.cjs.map

package/dist/mappers/helpers/token-metadata.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-metadata.cjs","sourceRoot":"","sources":["../../../src/mappers/helpers/token-metadata.ts"],"names":[],"mappings":";;;;;;AAAA,oFAAsD;AACtD,iEAAkE;AAGlE,qCAAgD;AAehD,MAAM,aAAa,GAAG,2BAAoD,CAAC;AAE3E,MAAM,oBAAoB,GAAG,WAAW,CAAC;AAEzC,SAAgB,qBAAqB,CACnC,OAA0B,EAC1B,eAAwB;IAExB,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,6BAAsB,EAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAEjE,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC/C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,CAAC,IAAA,uCAAoB,EAAC,eAAe,CAAC,CAAC,CAAC;IAEnE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO;KACR,CAAC;AACJ,CAAC;AAzBD,sDAyBC","sourcesContent":["import contractMap from '@metamask/contract-metadata';\nimport { toChecksumHexAddress } from '@metamask/controller-utils';\nimport type { CaipChainId, Hex } from '@metamask/utils';\n\nimport { formatAddressToAssetId } from './caip';\n\nexport type KnownTokenMetadata = {\n  symbol?: string;\n  decimals?: number;\n  assetId?: string;\n};\n\ntype ContractMetadataEntry = {\n  name?: string;\n  symbol?: string;\n  decimals?: number;\n  erc20?: boolean;\n};\n\nconst mainnetTokens = contractMap as Record<string, ContractMetadataEntry>;\n\nconst mainnetAssetIdPrefix = 'eip155:1/';\n\nexport function getKnownTokenMetadata(\n  chainId: CaipChainId | Hex,\n  contractAddress?: string,\n): KnownTokenMetadata | undefined {\n  if (!contractAddress) {\n    return undefined;\n  }\n\n  const assetId = formatAddressToAssetId(contractAddress, chainId);\n\n  if (!assetId?.startsWith(mainnetAssetIdPrefix)) {\n    return undefined;\n  }\n\n  const entry = mainnetTokens[toChecksumHexAddress(contractAddress)];\n\n  if (!entry) {\n    return undefined;\n  }\n\n  return {\n    symbol: entry.symbol,\n    decimals: entry.decimals,\n    assetId,\n  };\n}\n"]}

package/dist/mappers/helpers/token-metadata.d.cts

@@ -0,0 +1,8 @@
+import type { CaipChainId, Hex } from "@metamask/utils";
+export type KnownTokenMetadata = {
+    symbol?: string;
+    decimals?: number;
+    assetId?: string;
+};
+export declare function getKnownTokenMetadata(chainId: CaipChainId | Hex, contractAddress?: string): KnownTokenMetadata | undefined;
+//# sourceMappingURL=token-metadata.d.cts.map

package/dist/mappers/helpers/token-metadata.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-metadata.d.cts","sourceRoot":"","sources":["../../../src/mappers/helpers/token-metadata.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,wBAAwB;AAIxD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAaF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,WAAW,GAAG,GAAG,EAC1B,eAAe,CAAC,EAAE,MAAM,GACvB,kBAAkB,GAAG,SAAS,CAsBhC"}

package/dist/mappers/helpers/token-metadata.d.mts

@@ -0,0 +1,8 @@
+import type { CaipChainId, Hex } from "@metamask/utils";
+export type KnownTokenMetadata = {
+    symbol?: string;
+    decimals?: number;
+    assetId?: string;
+};
+export declare function getKnownTokenMetadata(chainId: CaipChainId | Hex, contractAddress?: string): KnownTokenMetadata | undefined;
+//# sourceMappingURL=token-metadata.d.mts.map

package/dist/mappers/helpers/token-metadata.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-metadata.d.mts","sourceRoot":"","sources":["../../../src/mappers/helpers/token-metadata.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,wBAAwB;AAIxD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAaF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,WAAW,GAAG,GAAG,EAC1B,eAAe,CAAC,EAAE,MAAM,GACvB,kBAAkB,GAAG,SAAS,CAsBhC"}

package/dist/mappers/helpers/token-metadata.mjs

@@ -0,0 +1,31 @@
+function $importDefault(module) {
+    if (module?.__esModule) {
+        return module.default;
+    }
+    return module;
+}
+import $contractMap from "@metamask/contract-metadata";
+const contractMap = $importDefault($contractMap);
+import { toChecksumHexAddress } from "@metamask/controller-utils";
+import { formatAddressToAssetId } from "./caip.mjs";
+const mainnetTokens = contractMap;
+const mainnetAssetIdPrefix = 'eip155:1/';
+export function getKnownTokenMetadata(chainId, contractAddress) {
+    if (!contractAddress) {
+        return undefined;
+    }
+    const assetId = formatAddressToAssetId(contractAddress, chainId);
+    if (!assetId?.startsWith(mainnetAssetIdPrefix)) {
+        return undefined;
+    }
+    const entry = mainnetTokens[toChecksumHexAddress(contractAddress)];
+    if (!entry) {
+        return undefined;
+    }
+    return {
+        symbol: entry.symbol,
+        decimals: entry.decimals,
+        assetId,
+    };
+}
+//# sourceMappingURL=token-metadata.mjs.map

package/dist/mappers/helpers/token-metadata.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-metadata.mjs","sourceRoot":"","sources":["../../../src/mappers/helpers/token-metadata.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,YAAW,oCAAoC;;AACtD,OAAO,EAAE,oBAAoB,EAAE,mCAAmC;AAGlE,OAAO,EAAE,sBAAsB,EAAE,mBAAe;AAehD,MAAM,aAAa,GAAG,WAAoD,CAAC;AAE3E,MAAM,oBAAoB,GAAG,WAAW,CAAC;AAEzC,MAAM,UAAU,qBAAqB,CACnC,OAA0B,EAC1B,eAAwB;IAExB,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,sBAAsB,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAEjE,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC/C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,CAAC,oBAAoB,CAAC,eAAe,CAAC,CAAC,CAAC;IAEnE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO;KACR,CAAC;AACJ,CAAC","sourcesContent":["import contractMap from '@metamask/contract-metadata';\nimport { toChecksumHexAddress } from '@metamask/controller-utils';\nimport type { CaipChainId, Hex } from '@metamask/utils';\n\nimport { formatAddressToAssetId } from './caip';\n\nexport type KnownTokenMetadata = {\n  symbol?: string;\n  decimals?: number;\n  assetId?: string;\n};\n\ntype ContractMetadataEntry = {\n  name?: string;\n  symbol?: string;\n  decimals?: number;\n  erc20?: boolean;\n};\n\nconst mainnetTokens = contractMap as Record<string, ContractMetadataEntry>;\n\nconst mainnetAssetIdPrefix = 'eip155:1/';\n\nexport function getKnownTokenMetadata(\n  chainId: CaipChainId | Hex,\n  contractAddress?: string,\n): KnownTokenMetadata | undefined {\n  if (!contractAddress) {\n    return undefined;\n  }\n\n  const assetId = formatAddressToAssetId(contractAddress, chainId);\n\n  if (!assetId?.startsWith(mainnetAssetIdPrefix)) {\n    return undefined;\n  }\n\n  const entry = mainnetTokens[toChecksumHexAddress(contractAddress)];\n\n  if (!entry) {\n    return undefined;\n  }\n\n  return {\n    symbol: entry.symbol,\n    decimals: entry.decimals,\n    assetId,\n  };\n}\n"]}

package/dist/mappers/helpers/transactions.cjs

@@ -0,0 +1,240 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withFallbackTokenAssetId = exports.getTokenMetadataFromKnownToken = exports.getTokenAmountFromTransfer = exports.parseValueTransfers = exports.getNftPaymentTransfer = exports.isNftStandard = exports.getLocalTransactionStatus = exports.getLocalTransactionFees = exports.getFees = void 0;
+const controller_utils_1 = require("@metamask/controller-utils");
+const transaction_controller_1 = require("@metamask/transaction-controller");
+const constants_1 = require("../constants.cjs");
+const caip_1 = require("./caip.cjs");
+const token_metadata_1 = require("./token-metadata.cjs");
+const nativeTokenDecimals = 18;
+function toNetworkFeeAmount(gasUsed, gasPrice) {
+    if (gasUsed === undefined || gasPrice === undefined) {
+        return undefined;
+    }
+    try {
+        return String(BigInt(gasUsed) * BigInt(gasPrice));
+    }
+    catch {
+        return undefined;
+    }
+}
+function buildBaseNetworkFee(amount, chainId) {
+    const nativeAsset = (0, caip_1.getNativeAsset)(chainId);
+    return {
+        type: 'base',
+        amount,
+        ...(nativeAsset?.decimals === undefined
+            ? { decimals: nativeTokenDecimals }
+            : { decimals: nativeAsset.decimals }),
+        ...(nativeAsset?.symbol ? { symbol: nativeAsset.symbol } : {}),
+        ...(nativeAsset?.assetId ? { assetId: nativeAsset.assetId } : {}),
+    };
+}
+function getNetworkFee(transaction, chainId) {
+    const amount = toNetworkFeeAmount(transaction.gasUsed, transaction.effectiveGasPrice);
+    return amount ? buildBaseNetworkFee(amount, chainId) : undefined;
+}
+function getFees(transaction, chainId) {
+    const networkFee = getNetworkFee(transaction, chainId);
+    return networkFee ? [networkFee] : undefined;
+}
+exports.getFees = getFees;
+function getLocalTransactionFees(transactionGroup) {
+    const { primaryTransaction } = transactionGroup;
+    const amount = toNetworkFeeAmount(primaryTransaction.txReceipt?.gasUsed, primaryTransaction.txReceipt?.effectiveGasPrice ??
+        primaryTransaction.txParams?.gasPrice);
+    return amount
+        ? [buildBaseNetworkFee(amount, primaryTransaction.chainId)]
+        : undefined;
+}
+exports.getLocalTransactionFees = getLocalTransactionFees;
+const inProgressTransactionStatuses = [
+    transaction_controller_1.TransactionStatus.unapproved,
+    transaction_controller_1.TransactionStatus.approved,
+    transaction_controller_1.TransactionStatus.signed,
+    transaction_controller_1.TransactionStatus.submitted,
+];
+const transactionGroupCancelledStatus = 'cancelled';
+const smartTransactionStatus = {
+    cancelled: 'cancelled',
+    pending: 'pending',
+    success: 'success',
+};
+function getTransactionStatusKey(transaction) {
+    const { type, status } = transaction;
+    const receiptStatus = transaction.txReceipt?.status;
+    if (receiptStatus === '0x0') {
+        return transaction_controller_1.TransactionStatus.failed;
+    }
+    if (status === transaction_controller_1.TransactionStatus.confirmed &&
+        type === transaction_controller_1.TransactionType.cancel) {
+        return transactionGroupCancelledStatus;
+    }
+    return transaction.status;
+}
+function getLocalTransactionStatus({ primaryTransaction, initialTransaction, }) {
+    if (initialTransaction.isSmartTransaction) {
+        const smartStatus = initialTransaction.status;
+        if (smartStatus === smartTransactionStatus.pending) {
+            return 'pending';
+        }
+        if (smartStatus === smartTransactionStatus.success) {
+            return 'success';
+        }
+        if (smartStatus === smartTransactionStatus.cancelled) {
+            return 'failed';
+        }
+        return 'pending';
+    }
+    const statusKey = getTransactionStatusKey(primaryTransaction);
+    if (statusKey === transaction_controller_1.TransactionStatus.confirmed) {
+        return 'success';
+    }
+    if (statusKey === transaction_controller_1.TransactionStatus.cancelled ||
+        statusKey === transactionGroupCancelledStatus ||
+        statusKey === transaction_controller_1.TransactionStatus.dropped ||
+        statusKey === transaction_controller_1.TransactionStatus.failed ||
+        statusKey === transaction_controller_1.TransactionStatus.rejected) {
+        return 'failed';
+    }
+    if (inProgressTransactionStatuses.includes(statusKey)) {
+        return 'pending';
+    }
+    return 'pending';
+}
+exports.getLocalTransactionStatus = getLocalTransactionStatus;
+function isNftStandard(value) {
+    return value === controller_utils_1.ERC721.toLowerCase() || value === controller_utils_1.ERC1155.toLowerCase();
+}
+exports.isNftStandard = isNftStandard;
+function getNftPaymentTransfer({ side, sentTransfer, receivedTransfer, sentNativeTransfer, nftCounterparty, transactionFrom, transactionTo, subjectAddress, }) {
+    const isFungible = (transfer) => Boolean(transfer && !isNftStandard(transfer.transferType));
+    if (side === 'buy') {
+        for (const transfer of [sentNativeTransfer, sentTransfer]) {
+            if (!transfer || !isFungible(transfer)) {
+                continue;
+            }
+            // Only count a payment that goes to the NFT counterparty (direct sale) or
+            // to the contract being called (marketplace/router). This avoids treating
+            // an unrelated native send in the same transaction as the NFT payment.
+            if ((0, controller_utils_1.isEqualCaseInsensitive)(transfer.to, nftCounterparty) ||
+                (0, controller_utils_1.isEqualCaseInsensitive)(transfer.to, transactionTo)) {
+                return transfer;
+            }
+        }
+        return undefined;
+    }
+    if (!receivedTransfer || !isFungible(receivedTransfer)) {
+        return undefined;
+    }
+    if ((0, controller_utils_1.isEqualCaseInsensitive)(receivedTransfer.from, nftCounterparty) ||
+        (transactionFrom &&
+            !(0, controller_utils_1.isEqualCaseInsensitive)(transactionFrom, subjectAddress) &&
+            (0, controller_utils_1.isEqualCaseInsensitive)(receivedTransfer.from, transactionFrom))) {
+        return receivedTransfer;
+    }
+    return undefined;
+}
+exports.getNftPaymentTransfer = getNftPaymentTransfer;
+const resolveAssetId = (chainId, { contractAddress, transferType, }) => {
+    if (contractAddress) {
+        return (0, caip_1.formatAddressToAssetId)(contractAddress, chainId);
+    }
+    if (transferType === 'normal' || transferType === 'internal') {
+        return (0, caip_1.formatAddressToAssetId)(constants_1.nativeTokenAddress, chainId);
+    }
+    return undefined;
+};
+/**
+ * Resolves the user's primary send and receive legs from indexed value transfers.
+ * Prefers a receive whose symbol differs from the sent leg so dust does not win.
+ *
+ * @param valueTransfers - Indexed value transfers from the Accounts API.
+ * @param subjectAddress - The account address to match transfers against.
+ * @returns The primary sent and received transfers for the account.
+ */
+function parseValueTransfers(valueTransfers, subjectAddress) {
+    const sent = valueTransfers?.filter(({ from }) => (0, controller_utils_1.isEqualCaseInsensitive)(from, subjectAddress));
+    const received = valueTransfers?.filter(({ to }) => (0, controller_utils_1.isEqualCaseInsensitive)(to, subjectAddress));
+    const sentTransfer = sent?.[0];
+    const receivedTransfer = received?.find(({ symbol }) => symbol !== sentTransfer?.symbol) ??
+        received?.[0];
+    const sentNativeTransfer = sent?.find(({ transferType }) => transferType === 'normal');
+    const sentNftTransfer = sent?.find(({ transferType }) => isNftStandard(transferType));
+    const receivedNftTransfer = received?.find(({ transferType }) => isNftStandard(transferType));
+    return {
+        sentTransfer,
+        receivedTransfer,
+        sentNativeTransfer,
+        sentNftTransfer,
+        receivedNftTransfer,
+    };
+}
+exports.parseValueTransfers = parseValueTransfers;
+function getTokenAmountFromTransfer(transfer, direction, chainId) {
+    if (!transfer) {
+        return undefined;
+    }
+    const { transferType, amount } = transfer;
+    const isNftTransfer = isNftStandard(transferType);
+    const symbol = isNftTransfer
+        ? transfer.name || transfer.symbol
+        : transfer.symbol;
+    if (!symbol && amount === undefined) {
+        return undefined;
+    }
+    const assetId = transfer && !isNftTransfer
+        ? resolveAssetId(chainId, {
+            contractAddress: transfer.contractAddress,
+            transferType: transfer.transferType,
+        })
+        : undefined;
+    const hasTransferAmount = !isNftTransfer && amount !== null && amount !== undefined;
+    return {
+        direction,
+        ...(hasTransferAmount ? { amount: String(amount) } : {}),
+        ...(transfer.decimal === undefined ? {} : { decimals: transfer.decimal }),
+        ...(symbol ? { symbol } : {}),
+        ...(assetId ? { assetId } : {}),
+    };
+}
+exports.getTokenAmountFromTransfer = getTokenAmountFromTransfer;
+function getTokenMetadataFromKnownToken(contractAddress, direction, chainId) {
+    const tokenMetadata = (0, token_metadata_1.getKnownTokenMetadata)(chainId, contractAddress);
+    if (!tokenMetadata) {
+        return undefined;
+    }
+    return {
+        direction,
+        ...(tokenMetadata.symbol ? { symbol: tokenMetadata.symbol } : {}),
+        ...(tokenMetadata.decimals === undefined
+            ? {}
+            : { decimals: tokenMetadata.decimals }),
+        ...(tokenMetadata.assetId ? { assetId: tokenMetadata.assetId } : {}),
+    };
+}
+exports.getTokenMetadataFromKnownToken = getTokenMetadataFromKnownToken;
+/**
+ * When the transfer omits contractAddress, fall back to the indexed tx `to` field.
+ *
+ * @param token - Parsed token amount from the value transfer.
+ * @param fallbackContractAddress - Indexed transaction `to` address used as ERC-20 fallback.
+ * @param transferType - Value transfer type; native (`normal`) transfers skip the fallback.
+ * @param chainId - CAIP-2 chain id for asset id encoding.
+ * @returns Token amount with `assetId` set when a fallback address applies.
+ */
+function withFallbackTokenAssetId(token, fallbackContractAddress, transferType, chainId) {
+    if (!token ||
+        token.assetId ||
+        transferType === 'normal' ||
+        !fallbackContractAddress) {
+        return token;
+    }
+    const assetId = (0, caip_1.formatAddressToAssetId)(fallbackContractAddress, chainId);
+    if (!assetId) {
+        return token;
+    }
+    return { ...token, assetId };
+}
+exports.withFallbackTokenAssetId = withFallbackTokenAssetId;
+//# sourceMappingURL=transactions.cjs.map