@metamask-previews/client-utils 1.3.0-preview-6316943cb → 1.3.1-preview-2296abeaf

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add `mapRampsOrder` for mapping ramps buy/sell orders into the shared activity item shape, and add `rampBuy`/`rampSell` to `ActivityKind` and `ActivityItem` ([#9650](https://github.com/MetaMask/core/pull/9650))
+
+## [1.3.1]
+
+### Changed
+
+- Bump `@metamask/core-backend` from `^7.0.0` to `^8.0.0` ([#9693](https://github.com/MetaMask/core/pull/9693))
+- Bump `@metamask/transaction-controller` from `^69.2.1` to `^69.3.0` ([#9693](https://github.com/MetaMask/core/pull/9693))
+
 ## [1.3.0]
 
 ### Added
@@ -60,7 +71,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Bump `@metamask/transaction-controller` from `^68.2.2` to `^68.3.0` ([#9421](https://github.com/MetaMask/core/pull/9421))
 - Bump `@metamask/keyring-api` from `^23.3.0` to `^23.5.0` ([#9390](https://github.com/MetaMask/core/pull/9390))
 
-[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/client-utils@1.3.0...HEAD
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/client-utils@1.3.1...HEAD
+[1.3.1]: https://github.com/MetaMask/core/compare/@metamask/client-utils@1.3.0...@metamask/client-utils@1.3.1
 [1.3.0]: https://github.com/MetaMask/core/compare/@metamask/client-utils@1.2.1...@metamask/client-utils@1.3.0
 [1.2.1]: https://github.com/MetaMask/core/compare/@metamask/client-utils@1.2.0...@metamask/client-utils@1.2.1
 [1.2.0]: https://github.com/MetaMask/core/compare/@metamask/client-utils@1.1.0...@metamask/client-utils@1.2.0

package/dist/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapLocalTransaction = exports.mapKeyringTransaction = exports.mapApiTransaction = exports.createFormatters = void 0;
+exports.mapRampsOrder = exports.mapLocalTransaction = exports.mapKeyringTransaction = exports.mapApiTransaction = exports.createFormatters = void 0;
 var create_formatters_js_1 = require("./formatters/create-formatters.cjs");
 Object.defineProperty(exports, "createFormatters", { enumerable: true, get: function () { return create_formatters_js_1.createFormatters; } });
 var api_transaction_mapper_js_1 = require("./mappers/api-transaction-mapper.cjs");
@@ -9,4 +9,6 @@ var keyring_transaction_mapper_js_1 = require("./mappers/keyring-transaction-map
 Object.defineProperty(exports, "mapKeyringTransaction", { enumerable: true, get: function () { return keyring_transaction_mapper_js_1.mapKeyringTransaction; } });
 var local_transaction_mapper_js_1 = require("./mappers/local-transaction-mapper.cjs");
 Object.defineProperty(exports, "mapLocalTransaction", { enumerable: true, get: function () { return local_transaction_mapper_js_1.mapLocalTransaction; } });
+var ramps_order_mapper_js_1 = require("./mappers/ramps-order-mapper.cjs");
+Object.defineProperty(exports, "mapRampsOrder", { enumerable: true, get: function () { return ramps_order_mapper_js_1.mapRampsOrder; } });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,2EAAqE;AAA5D,wHAAA,gBAAgB,OAAA;AAGzB,kFAAwE;AAA/D,8HAAA,iBAAiB,OAAA;AAC1B,0FAAgF;AAAvE,sIAAA,qBAAqB,OAAA;AAC9B,sFAA4E;AAAnE,kIAAA,mBAAmB,OAAA","sourcesContent":["export { createFormatters } from './formatters/create-formatters.js';\nexport type { Formatters } from './formatters/create-formatters.js';\n\nexport { mapApiTransaction } from './mappers/api-transaction-mapper.js';\nexport { mapKeyringTransaction } from './mappers/keyring-transaction-mapper.js';\nexport { mapLocalTransaction } from './mappers/local-transaction-mapper.js';\n\nexport type * from './types.js';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,2EAAqE;AAA5D,wHAAA,gBAAgB,OAAA;AAGzB,kFAAwE;AAA/D,8HAAA,iBAAiB,OAAA;AAC1B,0FAAgF;AAAvE,sIAAA,qBAAqB,OAAA;AAC9B,sFAA4E;AAAnE,kIAAA,mBAAmB,OAAA;AAC5B,0EAAgE;AAAvD,sHAAA,aAAa,OAAA","sourcesContent":["export { createFormatters } from './formatters/create-formatters.js';\nexport type { Formatters } from './formatters/create-formatters.js';\n\nexport { mapApiTransaction } from './mappers/api-transaction-mapper.js';\nexport { mapKeyringTransaction } from './mappers/keyring-transaction-mapper.js';\nexport { mapLocalTransaction } from './mappers/local-transaction-mapper.js';\nexport { mapRampsOrder } from './mappers/ramps-order-mapper.js';\nexport type { RampsOrderLike } from './mappers/ramps-order-mapper.js';\n\nexport type * from './types.js';\n"]}

package/dist/index.d.cts

@@ -3,5 +3,7 @@ export type { Formatters } from "./formatters/create-formatters.cjs";
 export { mapApiTransaction } from "./mappers/api-transaction-mapper.cjs";
 export { mapKeyringTransaction } from "./mappers/keyring-transaction-mapper.cjs";
 export { mapLocalTransaction } from "./mappers/local-transaction-mapper.cjs";
+export { mapRampsOrder } from "./mappers/ramps-order-mapper.cjs";
+export type { RampsOrderLike } from "./mappers/ramps-order-mapper.cjs";
 export type * from "./types.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,2CAA0C;AACrE,YAAY,EAAE,UAAU,EAAE,2CAA0C;AAEpE,OAAO,EAAE,iBAAiB,EAAE,6CAA4C;AACxE,OAAO,EAAE,qBAAqB,EAAE,iDAAgD;AAChF,OAAO,EAAE,mBAAmB,EAAE,+CAA8C;AAE5E,iCAAgC"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,2CAA0C;AACrE,YAAY,EAAE,UAAU,EAAE,2CAA0C;AAEpE,OAAO,EAAE,iBAAiB,EAAE,6CAA4C;AACxE,OAAO,EAAE,qBAAqB,EAAE,iDAAgD;AAChF,OAAO,EAAE,mBAAmB,EAAE,+CAA8C;AAC5E,OAAO,EAAE,aAAa,EAAE,yCAAwC;AAChE,YAAY,EAAE,cAAc,EAAE,yCAAwC;AAEtE,iCAAgC"}

package/dist/index.d.mts

@@ -3,5 +3,7 @@ export type { Formatters } from "./formatters/create-formatters.mjs";
 export { mapApiTransaction } from "./mappers/api-transaction-mapper.mjs";
 export { mapKeyringTransaction } from "./mappers/keyring-transaction-mapper.mjs";
 export { mapLocalTransaction } from "./mappers/local-transaction-mapper.mjs";
+export { mapRampsOrder } from "./mappers/ramps-order-mapper.mjs";
+export type { RampsOrderLike } from "./mappers/ramps-order-mapper.mjs";
 export type * from "./types.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,2CAA0C;AACrE,YAAY,EAAE,UAAU,EAAE,2CAA0C;AAEpE,OAAO,EAAE,iBAAiB,EAAE,6CAA4C;AACxE,OAAO,EAAE,qBAAqB,EAAE,iDAAgD;AAChF,OAAO,EAAE,mBAAmB,EAAE,+CAA8C;AAE5E,iCAAgC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,2CAA0C;AACrE,YAAY,EAAE,UAAU,EAAE,2CAA0C;AAEpE,OAAO,EAAE,iBAAiB,EAAE,6CAA4C;AACxE,OAAO,EAAE,qBAAqB,EAAE,iDAAgD;AAChF,OAAO,EAAE,mBAAmB,EAAE,+CAA8C;AAC5E,OAAO,EAAE,aAAa,EAAE,yCAAwC;AAChE,YAAY,EAAE,cAAc,EAAE,yCAAwC;AAEtE,iCAAgC"}

package/dist/index.mjs

@@ -2,4 +2,5 @@ export { createFormatters } from "./formatters/create-formatters.mjs";
 export { mapApiTransaction } from "./mappers/api-transaction-mapper.mjs";
 export { mapKeyringTransaction } from "./mappers/keyring-transaction-mapper.mjs";
 export { mapLocalTransaction } from "./mappers/local-transaction-mapper.mjs";
+export { mapRampsOrder } from "./mappers/ramps-order-mapper.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,2CAA0C;AAGrE,OAAO,EAAE,iBAAiB,EAAE,6CAA4C;AACxE,OAAO,EAAE,qBAAqB,EAAE,iDAAgD;AAChF,OAAO,EAAE,mBAAmB,EAAE,+CAA8C","sourcesContent":["export { createFormatters } from './formatters/create-formatters.js';\nexport type { Formatters } from './formatters/create-formatters.js';\n\nexport { mapApiTransaction } from './mappers/api-transaction-mapper.js';\nexport { mapKeyringTransaction } from './mappers/keyring-transaction-mapper.js';\nexport { mapLocalTransaction } from './mappers/local-transaction-mapper.js';\n\nexport type * from './types.js';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,2CAA0C;AAGrE,OAAO,EAAE,iBAAiB,EAAE,6CAA4C;AACxE,OAAO,EAAE,qBAAqB,EAAE,iDAAgD;AAChF,OAAO,EAAE,mBAAmB,EAAE,+CAA8C;AAC5E,OAAO,EAAE,aAAa,EAAE,yCAAwC","sourcesContent":["export { createFormatters } from './formatters/create-formatters.js';\nexport type { Formatters } from './formatters/create-formatters.js';\n\nexport { mapApiTransaction } from './mappers/api-transaction-mapper.js';\nexport { mapKeyringTransaction } from './mappers/keyring-transaction-mapper.js';\nexport { mapLocalTransaction } from './mappers/local-transaction-mapper.js';\nexport { mapRampsOrder } from './mappers/ramps-order-mapper.js';\nexport type { RampsOrderLike } from './mappers/ramps-order-mapper.js';\n\nexport type * from './types.js';\n"]}

package/dist/mappers/helpers/caip.cjs

@@ -22,6 +22,9 @@ function formatChainIdToCaip(chainId) {
         const reference = Number.parseInt(chainId, 16);
         return Number.isNaN(reference) ? undefined : `eip155:${reference}`;
     }
+    if (chainId === '') {
+        return undefined;
+    }
     const reference = Number(chainId);
     return Number.isNaN(reference) ? undefined : `eip155:${reference}`;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"caip.cjs","sourceRoot":"","sources":["../../../src/mappers/helpers/caip.ts"],"names":[],"mappings":";;;AAAA,iEAAkE;AAElE,2CAKyB;AAEzB,mDAAqD;AAErD;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,OAAwB;IAExB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,UAAU,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,OAAsB,CAAC;IAChC,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC/C,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,SAAS,EAAE,CAAC;IACrE,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,SAAS,EAAE,CAAC;AACrE,CAAC;AAlBD,kDAkBC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,CACL,UAAU,KAAK,iCAAkB;QACjC,UAAU,KAAK,KAAK;QACpB,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAC3B,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,sBAAsB,CACpC,OAAqC,EACrC,OAA2B;IAE3B,IAAI,IAAA,uBAAe,EAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEvE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,kBAAkB,GAAG,IAAA,uCAAoB,EAAC,OAAO,CAAC,CAAC;IAEzD,IAAI,CAAC,IAAA,yBAAiB,EAAC,kBAAkB,CAAC,EAAE,CAAC;QAC3C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAAA,wBAAgB,EAAC,WAAW,CAAC,CAAC;IAE/D,OAAO,IAAA,uBAAe,EAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC;AAC5E,CAAC;AA3BD,wDA2BC","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.js';\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\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    return undefined;\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"]}
+{"version":3,"file":"caip.cjs","sourceRoot":"","sources":["../../../src/mappers/helpers/caip.ts"],"names":[],"mappings":";;;AAAA,iEAAkE;AAElE,2CAKyB;AAEzB,mDAAqD;AAErD;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,OAAwB;IAExB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,UAAU,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,OAAsB,CAAC;IAChC,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC/C,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,SAAS,EAAE,CAAC;IACrE,CAAC;IAED,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,SAAS,EAAE,CAAC;AACrE,CAAC;AAtBD,kDAsBC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,CACL,UAAU,KAAK,iCAAkB;QACjC,UAAU,KAAK,KAAK;QACpB,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAC3B,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,sBAAsB,CACpC,OAAqC,EACrC,OAA2B;IAE3B,IAAI,IAAA,uBAAe,EAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEvE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,kBAAkB,GAAG,IAAA,uCAAoB,EAAC,OAAO,CAAC,CAAC;IAEzD,IAAI,CAAC,IAAA,yBAAiB,EAAC,kBAAkB,CAAC,EAAE,CAAC;QAC3C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAAA,wBAAgB,EAAC,WAAW,CAAC,CAAC;IAE/D,OAAO,IAAA,uBAAe,EAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC;AAC5E,CAAC;AA3BD,wDA2BC","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.js';\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  if (chainId === '') {\n    return undefined;\n  }\n\n  const reference = Number(chainId);\n  return Number.isNaN(reference) ? undefined : `eip155:${reference}`;\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    return undefined;\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.map

@@ -1 +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;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,GAAG,MAAM,GACvB,WAAW,GAAG,SAAS,CAgBzB;AAWD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,GAAG,GAAG,aAAa,GAAG,MAAM,EACrC,OAAO,CAAC,EAAE,WAAW,GAAG,GAAG,GAC1B,aAAa,GAAG,SAAS,CAwB3B"}
+{"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;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,GAAG,MAAM,GACvB,WAAW,GAAG,SAAS,CAoBzB;AAWD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,GAAG,GAAG,aAAa,GAAG,MAAM,EACrC,OAAO,CAAC,EAAE,WAAW,GAAG,GAAG,GAC1B,aAAa,GAAG,SAAS,CAwB3B"}

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

@@ -1 +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;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,GAAG,MAAM,GACvB,WAAW,GAAG,SAAS,CAgBzB;AAWD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,GAAG,GAAG,aAAa,GAAG,MAAM,EACrC,OAAO,CAAC,EAAE,WAAW,GAAG,GAAG,GAC1B,aAAa,GAAG,SAAS,CAwB3B"}
+{"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;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,GAAG,MAAM,GACvB,WAAW,GAAG,SAAS,CAoBzB;AAWD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,GAAG,GAAG,aAAa,GAAG,MAAM,EACrC,OAAO,CAAC,EAAE,WAAW,GAAG,GAAG,GAC1B,aAAa,GAAG,SAAS,CAwB3B"}

package/dist/mappers/helpers/caip.mjs

@@ -19,6 +19,9 @@ export function formatChainIdToCaip(chainId) {
         const reference = Number.parseInt(chainId, 16);
         return Number.isNaN(reference) ? undefined : `eip155:${reference}`;
     }
+    if (chainId === '') {
+        return undefined;
+    }
     const reference = Number(chainId);
     return Number.isNaN(reference) ? undefined : `eip155:${reference}`;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"caip.mjs","sourceRoot":"","sources":["../../../src/mappers/helpers/caip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,mCAAmC;AAElE,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAChB,wBAAwB;AAEzB,OAAO,EAAE,kBAAkB,EAAE,yBAAwB;AAErD;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAwB;IAExB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,UAAU,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,OAAsB,CAAC;IAChC,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC/C,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,SAAS,EAAE,CAAC;IACrE,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,SAAS,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,CACL,UAAU,KAAK,kBAAkB;QACjC,UAAU,KAAK,KAAK;QACpB,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAC3B,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAqC,EACrC,OAA2B;IAE3B,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEvE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAEzD,IAAI,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC3C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAE/D,OAAO,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC;AAC5E,CAAC","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.js';\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\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    return undefined;\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"]}
+{"version":3,"file":"caip.mjs","sourceRoot":"","sources":["../../../src/mappers/helpers/caip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,mCAAmC;AAElE,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAChB,wBAAwB;AAEzB,OAAO,EAAE,kBAAkB,EAAE,yBAAwB;AAErD;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAwB;IAExB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,UAAU,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,OAAsB,CAAC;IAChC,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC/C,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,SAAS,EAAE,CAAC;IACrE,CAAC;IAED,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,SAAS,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,CACL,UAAU,KAAK,kBAAkB;QACjC,UAAU,KAAK,KAAK;QACpB,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAC3B,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAqC,EACrC,OAA2B;IAE3B,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEvE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAEzD,IAAI,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC3C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAE/D,OAAO,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC;AAC5E,CAAC","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.js';\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  if (chainId === '') {\n    return undefined;\n  }\n\n  const reference = Number(chainId);\n  return Number.isNaN(reference) ? undefined : `eip155:${reference}`;\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    return undefined;\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/ramps-order-mapper.cjs

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapRampsOrder = void 0;
+const utils_1 = require("@metamask/utils");
+const caip_js_1 = require("./helpers/caip.cjs");
+/**
+ * Extracts the CAIP-2 chain id from a CAIP-19 asset id
+ * (`eip155:1/slip44:60` → `eip155:1`).
+ *
+ * @param assetId - CAIP-19 asset id.
+ * @returns The CAIP-2 chain id, or `undefined` when it can't be extracted.
+ */
+function caipChainIdFromAssetId(assetId) {
+    if (!assetId) {
+        return undefined;
+    }
+    const slash = assetId.indexOf('/');
+    const chainPart = slash === -1 ? assetId : assetId.slice(0, slash);
+    return (0, utils_1.isCaipChainId)(chainPart) ? chainPart : undefined;
+}
+function mapStatus(status) {
+    switch (status) {
+        case 'COMPLETED':
+            return 'success';
+        case 'FAILED':
+            return 'failed';
+        case 'CANCELLED':
+            return 'cancelled';
+        default:
+            return 'pending';
+    }
+}
+// `UNKNOWN`, `ID_EXPIRED`, and `PRECREATED` represent background checkout
+// attempts (e.g. precreated orders that never matched a real order, or whose
+// id expired before the provider assigned one) that the user never knowingly
+// initiated as a distinct order and shouldn't see in their history.
+const HIDDEN_STATUSES = new Set([
+    'UNKNOWN',
+    'ID_EXPIRED',
+    'PRECREATED',
+]);
+/**
+ * Resolves the CAIP-2 chain id for a ramps order.
+ *
+ * Tries each source in order and falls through when a value is present but
+ * unparseable (e.g. Coinbase's network name string `"ethereum"`). Generic
+ * providers often return a free-form network name while still attaching a
+ * real CAIP `cryptoCurrency.chainId` / `assetId`.
+ *
+ * Precedence: `network.chainId` (object) → `network` (string) →
+ * `cryptoCurrency.chainId` → chain segment of `cryptoCurrency.assetId`.
+ *
+ * @param order - The ramps order to resolve a chain id for.
+ * @returns The CAIP-2 chain id, or `undefined` when it can't be resolved.
+ */
+function resolveRampsOrderChainId(order) {
+    const { network } = order;
+    const networkChainId = typeof network === 'string' ? network : network.chainId;
+    return ((0, caip_js_1.formatChainIdToCaip)(networkChainId) ??
+        (order.cryptoCurrency?.chainId
+            ? (0, caip_js_1.formatChainIdToCaip)(order.cryptoCurrency.chainId)
+            : undefined) ??
+        caipChainIdFromAssetId(order.cryptoCurrency?.assetId));
+}
+/**
+ * Returns true when `txHash` looks like a real on-chain hash. Provider
+ * placeholders such as `""`, `"0x"`, and all-zero hashes must not be used as
+ * Activity row keys — they collide across orders whose hash isn't set yet.
+ *
+ * @param txHash - The order's raw `txHash` value.
+ * @returns `true` when the hash looks like a real on-chain hash.
+ */
+function isPlausibleRampTxHash(txHash) {
+    const normalized = txHash.trim().toLowerCase();
+    return normalized !== '' && !/^0x0*$/u.test(normalized);
+}
+/**
+ * Maps a ramps order into the shared activity item shape.
+ *
+ * @param order - The ramps order to map.
+ * @returns The normalized activity item, or `null` if the order's status
+ * should not be surfaced in the activity list.
+ */
+function mapRampsOrder(order) {
+    if (HIDDEN_STATUSES.has(order.status) || order.excludeFromPurchases) {
+        return null;
+    }
+    // The V2 API returns `orderType` uppercased (e.g. `'BUY'`); normalize since
+    // some call sites (e.g. locally-created stub orders) use lowercase. Transak
+    // deposits (`'DEPOSIT'`) are a buy variant, not a sell.
+    const normalizedOrderType = order.orderType.toUpperCase();
+    const isBuy = normalizedOrderType === 'BUY' || normalizedOrderType === 'DEPOSIT';
+    const direction = isBuy ? 'in' : 'out';
+    // `cryptoAmount`/`fiatAmount` are already human-formatted by the API, unlike
+    // `TokenAmount.decimals` elsewhere in this package, which signals a raw
+    // on-chain amount that still needs scaling. Omit `decimals` so clients don't
+    // wrongly re-scale an already-human amount.
+    const token = order.cryptoCurrency
+        ? {
+            amount: String(order.cryptoAmount),
+            symbol: order.cryptoCurrency.symbol,
+            assetId: order.cryptoCurrency.assetId,
+            direction,
+        }
+        : undefined;
+    const fiat = {
+        amount: String(order.fiatAmount),
+        currency: order.fiatCurrency?.symbol,
+    };
+    const fees = [
+        {
+            type: 'total',
+            amount: String(order.totalFeesFiat),
+            symbol: order.fiatCurrency?.symbol,
+        },
+    ];
+    const chainId = resolveRampsOrderChainId(order);
+    return {
+        type: isBuy ? 'rampBuy' : 'rampSell',
+        chainId,
+        status: mapStatus(order.status),
+        timestamp: order.createdAt,
+        hash: isPlausibleRampTxHash(order.txHash) ? order.txHash : undefined,
+        data: {
+            from: order.walletAddress,
+            fiat,
+            token,
+            fees,
+            provider: {
+                id: order.provider?.id,
+                name: order.provider?.name,
+                orderLink: order.providerOrderLink,
+            },
+            statusDescription: order.statusDescription,
+            paymentDetails: order.paymentDetails,
+            id: order.id ?? order.providerOrderId,
+        },
+    };
+}
+exports.mapRampsOrder = mapRampsOrder;
+//# sourceMappingURL=ramps-order-mapper.cjs.map

package/dist/mappers/ramps-order-mapper.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ramps-order-mapper.cjs","sourceRoot":"","sources":["../../src/mappers/ramps-order-mapper.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CaipChainId } from '@metamask/utils';\nimport { isCaipChainId } from '@metamask/utils';\n\nimport type {\n  ActivityItem,\n  Fee,\n  FiatAmount,\n  RampOrderPaymentDetail,\n  Status,\n  TokenAmount,\n} from '../types.js';\nimport { formatChainIdToCaip } from './helpers/caip.js';\n\n/**\n * Extracts the CAIP-2 chain id from a CAIP-19 asset id\n * (`eip155:1/slip44:60` → `eip155:1`).\n *\n * @param assetId - CAIP-19 asset id.\n * @returns The CAIP-2 chain id, or `undefined` when it can't be extracted.\n */\nfunction caipChainIdFromAssetId(\n  assetId: string | undefined,\n): CaipChainId | undefined {\n  if (!assetId) {\n    return undefined;\n  }\n  const slash = assetId.indexOf('/');\n  const chainPart = slash === -1 ? assetId : assetId.slice(0, slash);\n  return isCaipChainId(chainPart) ? chainPart : undefined;\n}\n\ntype RampsOrderStatusLike =\n  | 'UNKNOWN'\n  | 'PRECREATED'\n  | 'CREATED'\n  | 'PENDING'\n  | 'FAILED'\n  | 'COMPLETED'\n  | 'CANCELLED'\n  | 'ID_EXPIRED';\n\n/**\n * The subset of `RampsOrder` (from `@metamask/ramps-controller`) that this\n * mapper depends on. Redeclared locally rather than imported to keep\n * `client-utils` free of a dependency on `ramps-controller`.\n */\nexport type RampsOrderLike = {\n  id?: string;\n  provider?: { id?: string; name?: string };\n  cryptoAmount: string | number;\n  fiatAmount: number;\n  cryptoCurrency?: {\n    assetId?: string;\n    chainId?: string;\n    symbol: string;\n    decimals?: number;\n  };\n  fiatCurrency?: { symbol: string };\n  providerOrderId: string;\n  providerOrderLink: string;\n  createdAt: number;\n  totalFeesFiat: number;\n  txHash: string;\n  walletAddress: string;\n  status: RampsOrderStatusLike;\n  // Declared as an object, but generic providers (e.g. Coinbase) actually send\n  // a free-form network name string at runtime — see `resolveRampsOrderChainId`.\n  network: { chainId: string } | string;\n  statusDescription?: string;\n  orderType: string;\n  excludeFromPurchases?: boolean;\n  paymentDetails?: RampOrderPaymentDetail[];\n};\n\nfunction mapStatus(status: RampsOrderStatusLike): Status {\n  switch (status) {\n    case 'COMPLETED':\n      return 'success';\n    case 'FAILED':\n      return 'failed';\n    case 'CANCELLED':\n      return 'cancelled';\n    default:\n      return 'pending';\n  }\n}\n\n// `UNKNOWN`, `ID_EXPIRED`, and `PRECREATED` represent background checkout\n// attempts (e.g. precreated orders that never matched a real order, or whose\n// id expired before the provider assigned one) that the user never knowingly\n// initiated as a distinct order and shouldn't see in their history.\nconst HIDDEN_STATUSES = new Set<RampsOrderStatusLike>([\n  'UNKNOWN',\n  'ID_EXPIRED',\n  'PRECREATED',\n]);\n\n/**\n * Resolves the CAIP-2 chain id for a ramps order.\n *\n * Tries each source in order and falls through when a value is present but\n * unparseable (e.g. Coinbase's network name string `\"ethereum\"`). Generic\n * providers often return a free-form network name while still attaching a\n * real CAIP `cryptoCurrency.chainId` / `assetId`.\n *\n * Precedence: `network.chainId` (object) → `network` (string) →\n * `cryptoCurrency.chainId` → chain segment of `cryptoCurrency.assetId`.\n *\n * @param order - The ramps order to resolve a chain id for.\n * @returns The CAIP-2 chain id, or `undefined` when it can't be resolved.\n */\nfunction resolveRampsOrderChainId(\n  order: RampsOrderLike,\n): ReturnType<typeof formatChainIdToCaip> {\n  const { network } = order;\n  const networkChainId =\n    typeof network === 'string' ? network : network.chainId;\n\n  return (\n    formatChainIdToCaip(networkChainId) ??\n    (order.cryptoCurrency?.chainId\n      ? formatChainIdToCaip(order.cryptoCurrency.chainId)\n      : undefined) ??\n    caipChainIdFromAssetId(order.cryptoCurrency?.assetId)\n  );\n}\n\n/**\n * Returns true when `txHash` looks like a real on-chain hash. Provider\n * placeholders such as `\"\"`, `\"0x\"`, and all-zero hashes must not be used as\n * Activity row keys — they collide across orders whose hash isn't set yet.\n *\n * @param txHash - The order's raw `txHash` value.\n * @returns `true` when the hash looks like a real on-chain hash.\n */\nfunction isPlausibleRampTxHash(txHash: string): boolean {\n  const normalized = txHash.trim().toLowerCase();\n  return normalized !== '' && !/^0x0*$/u.test(normalized);\n}\n\n/**\n * Maps a ramps order into the shared activity item shape.\n *\n * @param order - The ramps order to map.\n * @returns The normalized activity item, or `null` if the order's status\n * should not be surfaced in the activity list.\n */\nexport function mapRampsOrder(order: RampsOrderLike): ActivityItem | null {\n  if (HIDDEN_STATUSES.has(order.status) || order.excludeFromPurchases) {\n    return null;\n  }\n\n  // The V2 API returns `orderType` uppercased (e.g. `'BUY'`); normalize since\n  // some call sites (e.g. locally-created stub orders) use lowercase. Transak\n  // deposits (`'DEPOSIT'`) are a buy variant, not a sell.\n  const normalizedOrderType = order.orderType.toUpperCase();\n  const isBuy =\n    normalizedOrderType === 'BUY' || normalizedOrderType === 'DEPOSIT';\n  const direction: TokenAmount['direction'] = isBuy ? 'in' : 'out';\n\n  // `cryptoAmount`/`fiatAmount` are already human-formatted by the API, unlike\n  // `TokenAmount.decimals` elsewhere in this package, which signals a raw\n  // on-chain amount that still needs scaling. Omit `decimals` so clients don't\n  // wrongly re-scale an already-human amount.\n  const token: TokenAmount | undefined = order.cryptoCurrency\n    ? {\n        amount: String(order.cryptoAmount),\n        symbol: order.cryptoCurrency.symbol,\n        assetId: order.cryptoCurrency.assetId,\n        direction,\n      }\n    : undefined;\n\n  const fiat: FiatAmount = {\n    amount: String(order.fiatAmount),\n    currency: order.fiatCurrency?.symbol,\n  };\n\n  const fees: Fee[] = [\n    {\n      type: 'total',\n      amount: String(order.totalFeesFiat),\n      symbol: order.fiatCurrency?.symbol,\n    },\n  ];\n\n  const chainId = resolveRampsOrderChainId(order);\n\n  return {\n    type: isBuy ? 'rampBuy' : 'rampSell',\n    chainId,\n    status: mapStatus(order.status),\n    timestamp: order.createdAt,\n    hash: isPlausibleRampTxHash(order.txHash) ? order.txHash : undefined,\n    data: {\n      from: order.walletAddress,\n      fiat,\n      token,\n      fees,\n      provider: {\n        id: order.provider?.id,\n        name: order.provider?.name,\n        orderLink: order.providerOrderLink,\n      },\n      statusDescription: order.statusDescription,\n      paymentDetails: order.paymentDetails,\n      id: order.id ?? order.providerOrderId,\n    },\n  };\n}\n"]}

package/dist/mappers/ramps-order-mapper.d.cts

@@ -0,0 +1,49 @@
+import type { ActivityItem, RampOrderPaymentDetail } from "../types.cjs";
+type RampsOrderStatusLike = 'UNKNOWN' | 'PRECREATED' | 'CREATED' | 'PENDING' | 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'ID_EXPIRED';
+/**
+ * The subset of `RampsOrder` (from `@metamask/ramps-controller`) that this
+ * mapper depends on. Redeclared locally rather than imported to keep
+ * `client-utils` free of a dependency on `ramps-controller`.
+ */
+export type RampsOrderLike = {
+    id?: string;
+    provider?: {
+        id?: string;
+        name?: string;
+    };
+    cryptoAmount: string | number;
+    fiatAmount: number;
+    cryptoCurrency?: {
+        assetId?: string;
+        chainId?: string;
+        symbol: string;
+        decimals?: number;
+    };
+    fiatCurrency?: {
+        symbol: string;
+    };
+    providerOrderId: string;
+    providerOrderLink: string;
+    createdAt: number;
+    totalFeesFiat: number;
+    txHash: string;
+    walletAddress: string;
+    status: RampsOrderStatusLike;
+    network: {
+        chainId: string;
+    } | string;
+    statusDescription?: string;
+    orderType: string;
+    excludeFromPurchases?: boolean;
+    paymentDetails?: RampOrderPaymentDetail[];
+};
+/**
+ * Maps a ramps order into the shared activity item shape.
+ *
+ * @param order - The ramps order to map.
+ * @returns The normalized activity item, or `null` if the order's status
+ * should not be surfaced in the activity list.
+ */
+export declare function mapRampsOrder(order: RampsOrderLike): ActivityItem | null;
+export {};
+//# sourceMappingURL=ramps-order-mapper.d.cts.map

package/dist/mappers/ramps-order-mapper.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ramps-order-mapper.d.cts","sourceRoot":"","sources":["../../src/mappers/ramps-order-mapper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EAGZ,sBAAsB,EAGvB,qBAAoB;AAqBrB,KAAK,oBAAoB,GACrB,SAAS,GACT,YAAY,GACZ,SAAS,GACT,SAAS,GACT,QAAQ,GACR,WAAW,GACX,WAAW,GACX,YAAY,CAAC;AAEjB;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,oBAAoB,CAAC;IAG7B,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,cAAc,CAAC,EAAE,sBAAsB,EAAE,CAAC;CAC3C,CAAC;AAoEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,GAAG,IAAI,CA8DxE"}

package/dist/mappers/ramps-order-mapper.d.mts

@@ -0,0 +1,49 @@
+import type { ActivityItem, RampOrderPaymentDetail } from "../types.mjs";
+type RampsOrderStatusLike = 'UNKNOWN' | 'PRECREATED' | 'CREATED' | 'PENDING' | 'FAILED' | 'COMPLETED' | 'CANCELLED' | 'ID_EXPIRED';
+/**
+ * The subset of `RampsOrder` (from `@metamask/ramps-controller`) that this
+ * mapper depends on. Redeclared locally rather than imported to keep
+ * `client-utils` free of a dependency on `ramps-controller`.
+ */
+export type RampsOrderLike = {
+    id?: string;
+    provider?: {
+        id?: string;
+        name?: string;
+    };
+    cryptoAmount: string | number;
+    fiatAmount: number;
+    cryptoCurrency?: {
+        assetId?: string;
+        chainId?: string;
+        symbol: string;
+        decimals?: number;
+    };
+    fiatCurrency?: {
+        symbol: string;
+    };
+    providerOrderId: string;
+    providerOrderLink: string;
+    createdAt: number;
+    totalFeesFiat: number;
+    txHash: string;
+    walletAddress: string;
+    status: RampsOrderStatusLike;
+    network: {
+        chainId: string;
+    } | string;
+    statusDescription?: string;
+    orderType: string;
+    excludeFromPurchases?: boolean;
+    paymentDetails?: RampOrderPaymentDetail[];
+};
+/**
+ * Maps a ramps order into the shared activity item shape.
+ *
+ * @param order - The ramps order to map.
+ * @returns The normalized activity item, or `null` if the order's status
+ * should not be surfaced in the activity list.
+ */
+export declare function mapRampsOrder(order: RampsOrderLike): ActivityItem | null;
+export {};
+//# sourceMappingURL=ramps-order-mapper.d.mts.map

package/dist/mappers/ramps-order-mapper.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ramps-order-mapper.d.mts","sourceRoot":"","sources":["../../src/mappers/ramps-order-mapper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EAGZ,sBAAsB,EAGvB,qBAAoB;AAqBrB,KAAK,oBAAoB,GACrB,SAAS,GACT,YAAY,GACZ,SAAS,GACT,SAAS,GACT,QAAQ,GACR,WAAW,GACX,WAAW,GACX,YAAY,CAAC;AAEjB;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,oBAAoB,CAAC;IAG7B,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,cAAc,CAAC,EAAE,sBAAsB,EAAE,CAAC;CAC3C,CAAC;AAoEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,GAAG,IAAI,CA8DxE"}

package/dist/mappers/ramps-order-mapper.mjs

@@ -0,0 +1,137 @@
+import { isCaipChainId } from "@metamask/utils";
+import { formatChainIdToCaip } from "./helpers/caip.mjs";
+/**
+ * Extracts the CAIP-2 chain id from a CAIP-19 asset id
+ * (`eip155:1/slip44:60` → `eip155:1`).
+ *
+ * @param assetId - CAIP-19 asset id.
+ * @returns The CAIP-2 chain id, or `undefined` when it can't be extracted.
+ */
+function caipChainIdFromAssetId(assetId) {
+    if (!assetId) {
+        return undefined;
+    }
+    const slash = assetId.indexOf('/');
+    const chainPart = slash === -1 ? assetId : assetId.slice(0, slash);
+    return isCaipChainId(chainPart) ? chainPart : undefined;
+}
+function mapStatus(status) {
+    switch (status) {
+        case 'COMPLETED':
+            return 'success';
+        case 'FAILED':
+            return 'failed';
+        case 'CANCELLED':
+            return 'cancelled';
+        default:
+            return 'pending';
+    }
+}
+// `UNKNOWN`, `ID_EXPIRED`, and `PRECREATED` represent background checkout
+// attempts (e.g. precreated orders that never matched a real order, or whose
+// id expired before the provider assigned one) that the user never knowingly
+// initiated as a distinct order and shouldn't see in their history.
+const HIDDEN_STATUSES = new Set([
+    'UNKNOWN',
+    'ID_EXPIRED',
+    'PRECREATED',
+]);
+/**
+ * Resolves the CAIP-2 chain id for a ramps order.
+ *
+ * Tries each source in order and falls through when a value is present but
+ * unparseable (e.g. Coinbase's network name string `"ethereum"`). Generic
+ * providers often return a free-form network name while still attaching a
+ * real CAIP `cryptoCurrency.chainId` / `assetId`.
+ *
+ * Precedence: `network.chainId` (object) → `network` (string) →
+ * `cryptoCurrency.chainId` → chain segment of `cryptoCurrency.assetId`.
+ *
+ * @param order - The ramps order to resolve a chain id for.
+ * @returns The CAIP-2 chain id, or `undefined` when it can't be resolved.
+ */
+function resolveRampsOrderChainId(order) {
+    const { network } = order;
+    const networkChainId = typeof network === 'string' ? network : network.chainId;
+    return (formatChainIdToCaip(networkChainId) ??
+        (order.cryptoCurrency?.chainId
+            ? formatChainIdToCaip(order.cryptoCurrency.chainId)
+            : undefined) ??
+        caipChainIdFromAssetId(order.cryptoCurrency?.assetId));
+}
+/**
+ * Returns true when `txHash` looks like a real on-chain hash. Provider
+ * placeholders such as `""`, `"0x"`, and all-zero hashes must not be used as
+ * Activity row keys — they collide across orders whose hash isn't set yet.
+ *
+ * @param txHash - The order's raw `txHash` value.
+ * @returns `true` when the hash looks like a real on-chain hash.
+ */
+function isPlausibleRampTxHash(txHash) {
+    const normalized = txHash.trim().toLowerCase();
+    return normalized !== '' && !/^0x0*$/u.test(normalized);
+}
+/**
+ * Maps a ramps order into the shared activity item shape.
+ *
+ * @param order - The ramps order to map.
+ * @returns The normalized activity item, or `null` if the order's status
+ * should not be surfaced in the activity list.
+ */
+export function mapRampsOrder(order) {
+    if (HIDDEN_STATUSES.has(order.status) || order.excludeFromPurchases) {
+        return null;
+    }
+    // The V2 API returns `orderType` uppercased (e.g. `'BUY'`); normalize since
+    // some call sites (e.g. locally-created stub orders) use lowercase. Transak
+    // deposits (`'DEPOSIT'`) are a buy variant, not a sell.
+    const normalizedOrderType = order.orderType.toUpperCase();
+    const isBuy = normalizedOrderType === 'BUY' || normalizedOrderType === 'DEPOSIT';
+    const direction = isBuy ? 'in' : 'out';
+    // `cryptoAmount`/`fiatAmount` are already human-formatted by the API, unlike
+    // `TokenAmount.decimals` elsewhere in this package, which signals a raw
+    // on-chain amount that still needs scaling. Omit `decimals` so clients don't
+    // wrongly re-scale an already-human amount.
+    const token = order.cryptoCurrency
+        ? {
+            amount: String(order.cryptoAmount),
+            symbol: order.cryptoCurrency.symbol,
+            assetId: order.cryptoCurrency.assetId,
+            direction,
+        }
+        : undefined;
+    const fiat = {
+        amount: String(order.fiatAmount),
+        currency: order.fiatCurrency?.symbol,
+    };
+    const fees = [
+        {
+            type: 'total',
+            amount: String(order.totalFeesFiat),
+            symbol: order.fiatCurrency?.symbol,
+        },
+    ];
+    const chainId = resolveRampsOrderChainId(order);
+    return {
+        type: isBuy ? 'rampBuy' : 'rampSell',
+        chainId,
+        status: mapStatus(order.status),
+        timestamp: order.createdAt,
+        hash: isPlausibleRampTxHash(order.txHash) ? order.txHash : undefined,
+        data: {
+            from: order.walletAddress,
+            fiat,
+            token,
+            fees,
+            provider: {
+                id: order.provider?.id,
+                name: order.provider?.name,
+                orderLink: order.providerOrderLink,
+            },
+            statusDescription: order.statusDescription,
+            paymentDetails: order.paymentDetails,
+            id: order.id ?? order.providerOrderId,
+        },
+    };
+}
+//# sourceMappingURL=ramps-order-mapper.mjs.map

package/dist/mappers/ramps-order-mapper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ramps-order-mapper.mjs","sourceRoot":"","sources":["../../src/mappers/ramps-order-mapper.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CaipChainId } from '@metamask/utils';\nimport { isCaipChainId } from '@metamask/utils';\n\nimport type {\n  ActivityItem,\n  Fee,\n  FiatAmount,\n  RampOrderPaymentDetail,\n  Status,\n  TokenAmount,\n} from '../types.js';\nimport { formatChainIdToCaip } from './helpers/caip.js';\n\n/**\n * Extracts the CAIP-2 chain id from a CAIP-19 asset id\n * (`eip155:1/slip44:60` → `eip155:1`).\n *\n * @param assetId - CAIP-19 asset id.\n * @returns The CAIP-2 chain id, or `undefined` when it can't be extracted.\n */\nfunction caipChainIdFromAssetId(\n  assetId: string | undefined,\n): CaipChainId | undefined {\n  if (!assetId) {\n    return undefined;\n  }\n  const slash = assetId.indexOf('/');\n  const chainPart = slash === -1 ? assetId : assetId.slice(0, slash);\n  return isCaipChainId(chainPart) ? chainPart : undefined;\n}\n\ntype RampsOrderStatusLike =\n  | 'UNKNOWN'\n  | 'PRECREATED'\n  | 'CREATED'\n  | 'PENDING'\n  | 'FAILED'\n  | 'COMPLETED'\n  | 'CANCELLED'\n  | 'ID_EXPIRED';\n\n/**\n * The subset of `RampsOrder` (from `@metamask/ramps-controller`) that this\n * mapper depends on. Redeclared locally rather than imported to keep\n * `client-utils` free of a dependency on `ramps-controller`.\n */\nexport type RampsOrderLike = {\n  id?: string;\n  provider?: { id?: string; name?: string };\n  cryptoAmount: string | number;\n  fiatAmount: number;\n  cryptoCurrency?: {\n    assetId?: string;\n    chainId?: string;\n    symbol: string;\n    decimals?: number;\n  };\n  fiatCurrency?: { symbol: string };\n  providerOrderId: string;\n  providerOrderLink: string;\n  createdAt: number;\n  totalFeesFiat: number;\n  txHash: string;\n  walletAddress: string;\n  status: RampsOrderStatusLike;\n  // Declared as an object, but generic providers (e.g. Coinbase) actually send\n  // a free-form network name string at runtime — see `resolveRampsOrderChainId`.\n  network: { chainId: string } | string;\n  statusDescription?: string;\n  orderType: string;\n  excludeFromPurchases?: boolean;\n  paymentDetails?: RampOrderPaymentDetail[];\n};\n\nfunction mapStatus(status: RampsOrderStatusLike): Status {\n  switch (status) {\n    case 'COMPLETED':\n      return 'success';\n    case 'FAILED':\n      return 'failed';\n    case 'CANCELLED':\n      return 'cancelled';\n    default:\n      return 'pending';\n  }\n}\n\n// `UNKNOWN`, `ID_EXPIRED`, and `PRECREATED` represent background checkout\n// attempts (e.g. precreated orders that never matched a real order, or whose\n// id expired before the provider assigned one) that the user never knowingly\n// initiated as a distinct order and shouldn't see in their history.\nconst HIDDEN_STATUSES = new Set<RampsOrderStatusLike>([\n  'UNKNOWN',\n  'ID_EXPIRED',\n  'PRECREATED',\n]);\n\n/**\n * Resolves the CAIP-2 chain id for a ramps order.\n *\n * Tries each source in order and falls through when a value is present but\n * unparseable (e.g. Coinbase's network name string `\"ethereum\"`). Generic\n * providers often return a free-form network name while still attaching a\n * real CAIP `cryptoCurrency.chainId` / `assetId`.\n *\n * Precedence: `network.chainId` (object) → `network` (string) →\n * `cryptoCurrency.chainId` → chain segment of `cryptoCurrency.assetId`.\n *\n * @param order - The ramps order to resolve a chain id for.\n * @returns The CAIP-2 chain id, or `undefined` when it can't be resolved.\n */\nfunction resolveRampsOrderChainId(\n  order: RampsOrderLike,\n): ReturnType<typeof formatChainIdToCaip> {\n  const { network } = order;\n  const networkChainId =\n    typeof network === 'string' ? network : network.chainId;\n\n  return (\n    formatChainIdToCaip(networkChainId) ??\n    (order.cryptoCurrency?.chainId\n      ? formatChainIdToCaip(order.cryptoCurrency.chainId)\n      : undefined) ??\n    caipChainIdFromAssetId(order.cryptoCurrency?.assetId)\n  );\n}\n\n/**\n * Returns true when `txHash` looks like a real on-chain hash. Provider\n * placeholders such as `\"\"`, `\"0x\"`, and all-zero hashes must not be used as\n * Activity row keys — they collide across orders whose hash isn't set yet.\n *\n * @param txHash - The order's raw `txHash` value.\n * @returns `true` when the hash looks like a real on-chain hash.\n */\nfunction isPlausibleRampTxHash(txHash: string): boolean {\n  const normalized = txHash.trim().toLowerCase();\n  return normalized !== '' && !/^0x0*$/u.test(normalized);\n}\n\n/**\n * Maps a ramps order into the shared activity item shape.\n *\n * @param order - The ramps order to map.\n * @returns The normalized activity item, or `null` if the order's status\n * should not be surfaced in the activity list.\n */\nexport function mapRampsOrder(order: RampsOrderLike): ActivityItem | null {\n  if (HIDDEN_STATUSES.has(order.status) || order.excludeFromPurchases) {\n    return null;\n  }\n\n  // The V2 API returns `orderType` uppercased (e.g. `'BUY'`); normalize since\n  // some call sites (e.g. locally-created stub orders) use lowercase. Transak\n  // deposits (`'DEPOSIT'`) are a buy variant, not a sell.\n  const normalizedOrderType = order.orderType.toUpperCase();\n  const isBuy =\n    normalizedOrderType === 'BUY' || normalizedOrderType === 'DEPOSIT';\n  const direction: TokenAmount['direction'] = isBuy ? 'in' : 'out';\n\n  // `cryptoAmount`/`fiatAmount` are already human-formatted by the API, unlike\n  // `TokenAmount.decimals` elsewhere in this package, which signals a raw\n  // on-chain amount that still needs scaling. Omit `decimals` so clients don't\n  // wrongly re-scale an already-human amount.\n  const token: TokenAmount | undefined = order.cryptoCurrency\n    ? {\n        amount: String(order.cryptoAmount),\n        symbol: order.cryptoCurrency.symbol,\n        assetId: order.cryptoCurrency.assetId,\n        direction,\n      }\n    : undefined;\n\n  const fiat: FiatAmount = {\n    amount: String(order.fiatAmount),\n    currency: order.fiatCurrency?.symbol,\n  };\n\n  const fees: Fee[] = [\n    {\n      type: 'total',\n      amount: String(order.totalFeesFiat),\n      symbol: order.fiatCurrency?.symbol,\n    },\n  ];\n\n  const chainId = resolveRampsOrderChainId(order);\n\n  return {\n    type: isBuy ? 'rampBuy' : 'rampSell',\n    chainId,\n    status: mapStatus(order.status),\n    timestamp: order.createdAt,\n    hash: isPlausibleRampTxHash(order.txHash) ? order.txHash : undefined,\n    data: {\n      from: order.walletAddress,\n      fiat,\n      token,\n      fees,\n      provider: {\n        id: order.provider?.id,\n        name: order.provider?.name,\n        orderLink: order.providerOrderLink,\n      },\n      statusDescription: order.statusDescription,\n      paymentDetails: order.paymentDetails,\n      id: order.id ?? order.providerOrderId,\n    },\n  };\n}\n"]}

package/dist/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ValueTransfer as _ValueTransfer } from '@metamask/core-backend';\nimport type { CaipChainId } from '@metamask/utils';\n\nexport type ActivityKind =\n  | 'receive'\n  | 'sell'\n  | 'buy'\n  | 'deposit'\n  | 'swap'\n  | 'claim'\n  | 'claimMusdBonus'\n  | 'send'\n  | 'wrap'\n  | 'unwrap'\n  | 'approveSpendingCap'\n  | 'revokeSpendingCap'\n  | 'increaseSpendingCap'\n  | 'contractInteraction'\n  | 'contractDeployment'\n  | 'bridge'\n  | 'convert'\n  | 'nftBuy'\n  | 'nftMint'\n  | 'nftSell'\n  | 'smartAccountUpgrade'\n  | 'lendingDeposit'\n  | 'lendingWithdrawal'\n  | 'predictionsAddFunds'\n  | 'predictionsWithdrawFunds'\n  | 'predictionClaimWinnings'\n  | 'predictionCashedOut'\n  | 'predictionPlaced'\n  | 'perpsAddFunds'\n  | 'perpsWithdraw'\n  | 'perpsOpenLong'\n  | 'perpsCloseLong'\n  | 'perpsCloseLongLiquidated'\n  | 'perpsCloseLongStopLoss'\n  | 'perpsOpenShort'\n  | 'perpsCloseShort'\n  | 'perpsCloseShortLiquidated'\n  | 'perpsCloseShortStopLoss'\n  | 'perpsPaidFundingFees'\n  | 'perpsReceivedFundingFees'\n  | 'perpsCloseShortTakeProfit'\n  | 'perpsCloseLongTakeProfit'\n  | 'marketShort'\n  | 'stopMarketCloseShort'\n  | 'marketCloseShort'\n  | 'assetActivation'\n  | 'assetDeactivation';\n\nexport type Status = 'pending' | 'success' | 'failed' | 'cancelled';\n\nexport type AssetType = 'native' | 'erc20' | 'erc721' | 'erc1155';\n\nexport type TokenAmount = {\n  amount?: string;\n  decimals?: number;\n  symbol?: string;\n  assetId?: string;\n  assetType?: AssetType;\n  direction: 'in' | 'out';\n};\n\nexport type FiatAmount = {\n  amount: string;\n  currency?: string;\n};\n\nexport type Fee = {\n  type: string;\n  amount?: string;\n  decimals?: number;\n  symbol?: string;\n  assetId?: string;\n  assetType?: AssetType;\n};\n\ntype ActivityData<Type extends ActivityKind, Data> = {\n  type: Type;\n  chainId: CaipChainId;\n  status: Status;\n  timestamp: number;\n  hash?: string;\n  data: Data;\n};\n\nexport type ActivityItem =\n  | ActivityData<\n      'approveSpendingCap' | 'revokeSpendingCap' | 'increaseSpendingCap',\n      {\n        from?: string;\n        token?: TokenAmount;\n        fees?: Fee[];\n      }\n    >\n  | ActivityData<\n      'assetActivation' | 'assetDeactivation',\n      {\n        from?: string;\n        token?: TokenAmount;\n        fees?: Fee[];\n      }\n    >\n  | ActivityData<\n      'send' | 'receive',\n      {\n        from: string;\n        to: string;\n        token?: TokenAmount;\n        fees?: Fee[];\n      }\n    >\n  | ActivityData<\n      'nftBuy' | 'nftMint' | 'nftSell',\n      {\n        from?: string;\n        to?: string;\n        token?: TokenAmount;\n        paymentToken?: TokenAmount;\n      }\n    >\n  | ActivityData<\n      | 'swap'\n      | 'bridge'\n      | 'convert'\n      | 'lendingDeposit'\n      | 'lendingWithdrawal'\n      | 'wrap'\n      | 'unwrap',\n      {\n        from?: string;\n        sourceToken?: TokenAmount;\n        destinationToken?: TokenAmount;\n        fees?: Fee[];\n      }\n    >\n  | ActivityData<\n      'buy' | 'claim' | 'deposit' | 'claimMusdBonus',\n      {\n        from?: string;\n        token?: TokenAmount;\n      }\n    >\n  | ActivityData<\n      'perpsAddFunds' | 'perpsWithdraw',\n      {\n        from?: string;\n        fiat?: FiatAmount;\n        networkFee?: FiatAmount;\n        token?: TokenAmount;\n      }\n    >\n  | ActivityData<\n      'contractInteraction',\n      {\n        from: string;\n        to: string;\n        token?: TokenAmount;\n        fees?: Fee[];\n        methodId?: string;\n        transactionCategory?: string;\n        transactionProtocol?: string;\n      }\n    >;\n\n// Note: Update core-backend\nexport type ValueTransfer = _ValueTransfer & {\n  contractAddress: string;\n  symbol: string;\n  name: string;\n};\n"]}
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ValueTransfer as _ValueTransfer } from '@metamask/core-backend';\nimport type { CaipChainId } from '@metamask/utils';\n\nexport type ActivityKind =\n  | 'receive'\n  | 'sell'\n  | 'buy'\n  | 'deposit'\n  | 'swap'\n  | 'claim'\n  | 'claimMusdBonus'\n  | 'send'\n  | 'wrap'\n  | 'unwrap'\n  | 'approveSpendingCap'\n  | 'revokeSpendingCap'\n  | 'increaseSpendingCap'\n  | 'contractInteraction'\n  | 'contractDeployment'\n  | 'bridge'\n  | 'convert'\n  | 'nftBuy'\n  | 'nftMint'\n  | 'nftSell'\n  | 'smartAccountUpgrade'\n  | 'lendingDeposit'\n  | 'lendingWithdrawal'\n  | 'predictionsAddFunds'\n  | 'predictionsWithdrawFunds'\n  | 'predictionClaimWinnings'\n  | 'predictionCashedOut'\n  | 'predictionPlaced'\n  | 'perpsAddFunds'\n  | 'perpsWithdraw'\n  | 'perpsOpenLong'\n  | 'perpsCloseLong'\n  | 'perpsCloseLongLiquidated'\n  | 'perpsCloseLongStopLoss'\n  | 'perpsOpenShort'\n  | 'perpsCloseShort'\n  | 'perpsCloseShortLiquidated'\n  | 'perpsCloseShortStopLoss'\n  | 'perpsPaidFundingFees'\n  | 'perpsReceivedFundingFees'\n  | 'perpsCloseShortTakeProfit'\n  | 'perpsCloseLongTakeProfit'\n  | 'marketShort'\n  | 'stopMarketCloseShort'\n  | 'marketCloseShort'\n  | 'assetActivation'\n  | 'assetDeactivation'\n  | 'rampBuy'\n  | 'rampSell';\n\nexport type Status = 'pending' | 'success' | 'failed' | 'cancelled';\n\nexport type AssetType = 'native' | 'erc20' | 'erc721' | 'erc1155';\n\nexport type TokenAmount = {\n  amount?: string;\n  decimals?: number;\n  symbol?: string;\n  assetId?: string;\n  assetType?: AssetType;\n  direction: 'in' | 'out';\n};\n\nexport type FiatAmount = {\n  amount: string;\n  currency?: string;\n};\n\nexport type Fee = {\n  type: string;\n  amount?: string;\n  decimals?: number;\n  symbol?: string;\n  assetId?: string;\n  assetType?: AssetType;\n};\n\ntype ActivityData<Type extends ActivityKind, Data> = {\n  type: Type;\n  chainId: CaipChainId;\n  status: Status;\n  timestamp: number;\n  hash?: string;\n  data: Data;\n};\n\n/**\n * Bank transfer instruction fields attached to a ramp order by providers\n * that require manual payment (e.g. SEPA, wire transfer).\n */\nexport type RampOrderPaymentDetail = {\n  fiatCurrency: string;\n  paymentMethod: string;\n  fields: { name: string; id: string; value: string }[];\n};\n\nexport type ActivityItem =\n  | ActivityData<\n      'approveSpendingCap' | 'revokeSpendingCap' | 'increaseSpendingCap',\n      {\n        from?: string;\n        token?: TokenAmount;\n        fees?: Fee[];\n      }\n    >\n  | ActivityData<\n      'assetActivation' | 'assetDeactivation',\n      {\n        from?: string;\n        token?: TokenAmount;\n        fees?: Fee[];\n      }\n    >\n  | ActivityData<\n      'send' | 'receive',\n      {\n        from: string;\n        to: string;\n        token?: TokenAmount;\n        fees?: Fee[];\n      }\n    >\n  | ActivityData<\n      'nftBuy' | 'nftMint' | 'nftSell',\n      {\n        from?: string;\n        to?: string;\n        token?: TokenAmount;\n        paymentToken?: TokenAmount;\n      }\n    >\n  | ActivityData<\n      | 'swap'\n      | 'bridge'\n      | 'convert'\n      | 'lendingDeposit'\n      | 'lendingWithdrawal'\n      | 'wrap'\n      | 'unwrap',\n      {\n        from?: string;\n        sourceToken?: TokenAmount;\n        destinationToken?: TokenAmount;\n        fees?: Fee[];\n      }\n    >\n  | ActivityData<\n      'buy' | 'claim' | 'deposit' | 'claimMusdBonus',\n      {\n        from?: string;\n        token?: TokenAmount;\n      }\n    >\n  | ActivityData<\n      'perpsAddFunds' | 'perpsWithdraw',\n      {\n        from?: string;\n        fiat?: FiatAmount;\n        networkFee?: FiatAmount;\n        token?: TokenAmount;\n      }\n    >\n  | ActivityData<\n      'contractInteraction',\n      {\n        from: string;\n        to: string;\n        token?: TokenAmount;\n        fees?: Fee[];\n        methodId?: string;\n        transactionCategory?: string;\n        transactionProtocol?: string;\n      }\n    >\n  | (Omit<\n      ActivityData<\n        'rampBuy' | 'rampSell',\n        {\n          from?: string;\n          fiat?: FiatAmount;\n          token?: TokenAmount;\n          fees?: Fee[];\n          provider?: {\n            id?: string;\n            name?: string;\n            orderLink?: string;\n          };\n          statusDescription?: string;\n          paymentDetails?: RampOrderPaymentDetail[];\n          // Stable identifier for orders that may not have a hash yet (e.g. a\n          // ramp order pending fiat settlement, where `hash` is empty until it\n          // settles on-chain). Lives in `data` as a ramp-specific property.\n          id?: string;\n        }\n      >,\n      'chainId'\n    > & {\n      // Precreated stub orders (see `RampsController.addPrecreatedOrder`) may\n      // not have an assigned network yet, so unlike every other activity\n      // kind, a ramp order's chain id isn't guaranteed.\n      chainId?: CaipChainId;\n    });\n\n// Note: Update core-backend\nexport type ValueTransfer = _ValueTransfer & {\n  contractAddress: string;\n  symbol: string;\n  name: string;\n};\n"]}

package/dist/types.d.cts

@@ -1,6 +1,6 @@
 import type { ValueTransfer as _ValueTransfer } from "@metamask/core-backend";
 import type { CaipChainId } from "@metamask/utils";
-export type ActivityKind = 'receive' | 'sell' | 'buy' | 'deposit' | 'swap' | 'claim' | 'claimMusdBonus' | 'send' | 'wrap' | 'unwrap' | 'approveSpendingCap' | 'revokeSpendingCap' | 'increaseSpendingCap' | 'contractInteraction' | 'contractDeployment' | 'bridge' | 'convert' | 'nftBuy' | 'nftMint' | 'nftSell' | 'smartAccountUpgrade' | 'lendingDeposit' | 'lendingWithdrawal' | 'predictionsAddFunds' | 'predictionsWithdrawFunds' | 'predictionClaimWinnings' | 'predictionCashedOut' | 'predictionPlaced' | 'perpsAddFunds' | 'perpsWithdraw' | 'perpsOpenLong' | 'perpsCloseLong' | 'perpsCloseLongLiquidated' | 'perpsCloseLongStopLoss' | 'perpsOpenShort' | 'perpsCloseShort' | 'perpsCloseShortLiquidated' | 'perpsCloseShortStopLoss' | 'perpsPaidFundingFees' | 'perpsReceivedFundingFees' | 'perpsCloseShortTakeProfit' | 'perpsCloseLongTakeProfit' | 'marketShort' | 'stopMarketCloseShort' | 'marketCloseShort' | 'assetActivation' | 'assetDeactivation';
+export type ActivityKind = 'receive' | 'sell' | 'buy' | 'deposit' | 'swap' | 'claim' | 'claimMusdBonus' | 'send' | 'wrap' | 'unwrap' | 'approveSpendingCap' | 'revokeSpendingCap' | 'increaseSpendingCap' | 'contractInteraction' | 'contractDeployment' | 'bridge' | 'convert' | 'nftBuy' | 'nftMint' | 'nftSell' | 'smartAccountUpgrade' | 'lendingDeposit' | 'lendingWithdrawal' | 'predictionsAddFunds' | 'predictionsWithdrawFunds' | 'predictionClaimWinnings' | 'predictionCashedOut' | 'predictionPlaced' | 'perpsAddFunds' | 'perpsWithdraw' | 'perpsOpenLong' | 'perpsCloseLong' | 'perpsCloseLongLiquidated' | 'perpsCloseLongStopLoss' | 'perpsOpenShort' | 'perpsCloseShort' | 'perpsCloseShortLiquidated' | 'perpsCloseShortStopLoss' | 'perpsPaidFundingFees' | 'perpsReceivedFundingFees' | 'perpsCloseShortTakeProfit' | 'perpsCloseLongTakeProfit' | 'marketShort' | 'stopMarketCloseShort' | 'marketCloseShort' | 'assetActivation' | 'assetDeactivation' | 'rampBuy' | 'rampSell';
 export type Status = 'pending' | 'success' | 'failed' | 'cancelled';
 export type AssetType = 'native' | 'erc20' | 'erc721' | 'erc1155';
 export type TokenAmount = {
@@ -31,6 +31,19 @@ type ActivityData<Type extends ActivityKind, Data> = {
     hash?: string;
     data: Data;
 };
+/**
+ * Bank transfer instruction fields attached to a ramp order by providers
+ * that require manual payment (e.g. SEPA, wire transfer).
+ */
+export type RampOrderPaymentDetail = {
+    fiatCurrency: string;
+    paymentMethod: string;
+    fields: {
+        name: string;
+        id: string;
+        value: string;
+    }[];
+};
 export type ActivityItem = ActivityData<'approveSpendingCap' | 'revokeSpendingCap' | 'increaseSpendingCap', {
     from?: string;
     token?: TokenAmount;
@@ -70,7 +83,22 @@ export type ActivityItem = ActivityData<'approveSpendingCap' | 'revokeSpendingCa
     methodId?: string;
     transactionCategory?: string;
     transactionProtocol?: string;
-}>;
+}> | (Omit<ActivityData<'rampBuy' | 'rampSell', {
+    from?: string;
+    fiat?: FiatAmount;
+    token?: TokenAmount;
+    fees?: Fee[];
+    provider?: {
+        id?: string;
+        name?: string;
+        orderLink?: string;
+    };
+    statusDescription?: string;
+    paymentDetails?: RampOrderPaymentDetail[];
+    id?: string;
+}>, 'chainId'> & {
+    chainId?: CaipChainId;
+});
 export type ValueTransfer = _ValueTransfer & {
     contractAddress: string;
     symbol: string;

package/dist/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,IAAI,cAAc,EAAE,+BAA+B;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,wBAAwB;AAEnD,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,MAAM,GACN,KAAK,GACL,SAAS,GACT,MAAM,GACN,OAAO,GACP,gBAAgB,GAChB,MAAM,GACN,MAAM,GACN,QAAQ,GACR,oBAAoB,GACpB,mBAAmB,GACnB,qBAAqB,GACrB,qBAAqB,GACrB,oBAAoB,GACpB,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,GACT,qBAAqB,GACrB,gBAAgB,GAChB,mBAAmB,GACnB,qBAAqB,GACrB,0BAA0B,GAC1B,yBAAyB,GACzB,qBAAqB,GACrB,kBAAkB,GAClB,eAAe,GACf,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,0BAA0B,GAC1B,wBAAwB,GACxB,gBAAgB,GAChB,iBAAiB,GACjB,2BAA2B,GAC3B,yBAAyB,GACzB,sBAAsB,GACtB,0BAA0B,GAC1B,2BAA2B,GAC3B,0BAA0B,GAC1B,aAAa,GACb,sBAAsB,GACtB,kBAAkB,GAClB,iBAAiB,GACjB,mBAAmB,GACnB,SAAS,GACT,UAAU,CAAC;AAEf,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEpE,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElE,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,EAAE,IAAI,GAAG,KAAK,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,GAAG,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,KAAK,YAAY,CAAC,IAAI,SAAS,YAAY,EAAE,IAAI,IAAI;IACnD,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,CAAC;CACZ,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB,YAAY,CACV,oBAAoB,GAAG,mBAAmB,GAAG,qBAAqB,EAClE;IACE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;CACd,CACF,GACD,YAAY,CACV,iBAAiB,GAAG,mBAAmB,EACvC;IACE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;CACd,CACF,GACD,YAAY,CACV,MAAM,GAAG,SAAS,EAClB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;CACd,CACF,GACD,YAAY,CACV,QAAQ,GAAG,SAAS,GAAG,SAAS,EAChC;IACE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,YAAY,CAAC,EAAE,WAAW,CAAC;CAC5B,CACF,GACD,YAAY,CACR,MAAM,GACN,QAAQ,GACR,SAAS,GACT,gBAAgB,GAChB,mBAAmB,GACnB,MAAM,GACN,QAAQ,EACV;IACE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,gBAAgB,CAAC,EAAE,WAAW,CAAC;IAC/B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;CACd,CACF,GACD,YAAY,CACV,KAAK,GAAG,OAAO,GAAG,SAAS,GAAG,gBAAgB,EAC9C;IACE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CACF,GACD,YAAY,CACV,eAAe,GAAG,eAAe,EACjC;IACE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CACF,GACD,YAAY,CACV,qBAAqB,EACrB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CACF,GACD,CAAC,IAAI,CACH,YAAY,CACV,SAAS,GAAG,UAAU,EACtB;IACE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACb,QAAQ,CAAC,EAAE;QACT,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,sBAAsB,EAAE,CAAC;IAI1C,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CACF,EACD,SAAS,CACV,GAAG;IAIF,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB,CAAC,CAAC;AAGP,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC"}

package/dist/types.d.mts

@@ -1,6 +1,6 @@
 import type { ValueTransfer as _ValueTransfer } from "@metamask/core-backend";
 import type { CaipChainId } from "@metamask/utils";
-export type ActivityKind = 'receive' | 'sell' | 'buy' | 'deposit' | 'swap' | 'claim' | 'claimMusdBonus' | 'send' | 'wrap' | 'unwrap' | 'approveSpendingCap' | 'revokeSpendingCap' | 'increaseSpendingCap' | 'contractInteraction' | 'contractDeployment' | 'bridge' | 'convert' | 'nftBuy' | 'nftMint' | 'nftSell' | 'smartAccountUpgrade' | 'lendingDeposit' | 'lendingWithdrawal' | 'predictionsAddFunds' | 'predictionsWithdrawFunds' | 'predictionClaimWinnings' | 'predictionCashedOut' | 'predictionPlaced' | 'perpsAddFunds' | 'perpsWithdraw' | 'perpsOpenLong' | 'perpsCloseLong' | 'perpsCloseLongLiquidated' | 'perpsCloseLongStopLoss' | 'perpsOpenShort' | 'perpsCloseShort' | 'perpsCloseShortLiquidated' | 'perpsCloseShortStopLoss' | 'perpsPaidFundingFees' | 'perpsReceivedFundingFees' | 'perpsCloseShortTakeProfit' | 'perpsCloseLongTakeProfit' | 'marketShort' | 'stopMarketCloseShort' | 'marketCloseShort' | 'assetActivation' | 'assetDeactivation';
+export type ActivityKind = 'receive' | 'sell' | 'buy' | 'deposit' | 'swap' | 'claim' | 'claimMusdBonus' | 'send' | 'wrap' | 'unwrap' | 'approveSpendingCap' | 'revokeSpendingCap' | 'increaseSpendingCap' | 'contractInteraction' | 'contractDeployment' | 'bridge' | 'convert' | 'nftBuy' | 'nftMint' | 'nftSell' | 'smartAccountUpgrade' | 'lendingDeposit' | 'lendingWithdrawal' | 'predictionsAddFunds' | 'predictionsWithdrawFunds' | 'predictionClaimWinnings' | 'predictionCashedOut' | 'predictionPlaced' | 'perpsAddFunds' | 'perpsWithdraw' | 'perpsOpenLong' | 'perpsCloseLong' | 'perpsCloseLongLiquidated' | 'perpsCloseLongStopLoss' | 'perpsOpenShort' | 'perpsCloseShort' | 'perpsCloseShortLiquidated' | 'perpsCloseShortStopLoss' | 'perpsPaidFundingFees' | 'perpsReceivedFundingFees' | 'perpsCloseShortTakeProfit' | 'perpsCloseLongTakeProfit' | 'marketShort' | 'stopMarketCloseShort' | 'marketCloseShort' | 'assetActivation' | 'assetDeactivation' | 'rampBuy' | 'rampSell';
 export type Status = 'pending' | 'success' | 'failed' | 'cancelled';
 export type AssetType = 'native' | 'erc20' | 'erc721' | 'erc1155';
 export type TokenAmount = {
@@ -31,6 +31,19 @@ type ActivityData<Type extends ActivityKind, Data> = {
     hash?: string;
     data: Data;
 };
+/**
+ * Bank transfer instruction fields attached to a ramp order by providers
+ * that require manual payment (e.g. SEPA, wire transfer).
+ */
+export type RampOrderPaymentDetail = {
+    fiatCurrency: string;
+    paymentMethod: string;
+    fields: {
+        name: string;
+        id: string;
+        value: string;
+    }[];
+};
 export type ActivityItem = ActivityData<'approveSpendingCap' | 'revokeSpendingCap' | 'increaseSpendingCap', {
     from?: string;
     token?: TokenAmount;
@@ -70,7 +83,22 @@ export type ActivityItem = ActivityData<'approveSpendingCap' | 'revokeSpendingCa
     methodId?: string;
     transactionCategory?: string;
     transactionProtocol?: string;
-}>;
+}> | (Omit<ActivityData<'rampBuy' | 'rampSell', {
+    from?: string;
+    fiat?: FiatAmount;
+    token?: TokenAmount;
+    fees?: Fee[];
+    provider?: {
+        id?: string;
+        name?: string;
+        orderLink?: string;
+    };
+    statusDescription?: string;
+    paymentDetails?: RampOrderPaymentDetail[];
+    id?: string;
+}>, 'chainId'> & {
+    chainId?: CaipChainId;
+});
 export type ValueTransfer = _ValueTransfer & {
     contractAddress: string;
     symbol: string;

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":"","sourcesContent":["import type { ValueTransfer as _ValueTransfer } from '@metamask/core-backend';\nimport type { CaipChainId } from '@metamask/utils';\n\nexport type ActivityKind =\n  | 'receive'\n  | 'sell'\n  | 'buy'\n  | 'deposit'\n  | 'swap'\n  | 'claim'\n  | 'claimMusdBonus'\n  | 'send'\n  | 'wrap'\n  | 'unwrap'\n  | 'approveSpendingCap'\n  | 'revokeSpendingCap'\n  | 'increaseSpendingCap'\n  | 'contractInteraction'\n  | 'contractDeployment'\n  | 'bridge'\n  | 'convert'\n  | 'nftBuy'\n  | 'nftMint'\n  | 'nftSell'\n  | 'smartAccountUpgrade'\n  | 'lendingDeposit'\n  | 'lendingWithdrawal'\n  | 'predictionsAddFunds'\n  | 'predictionsWithdrawFunds'\n  | 'predictionClaimWinnings'\n  | 'predictionCashedOut'\n  | 'predictionPlaced'\n  | 'perpsAddFunds'\n  | 'perpsWithdraw'\n  | 'perpsOpenLong'\n  | 'perpsCloseLong'\n  | 'perpsCloseLongLiquidated'\n  | 'perpsCloseLongStopLoss'\n  | 'perpsOpenShort'\n  | 'perpsCloseShort'\n  | 'perpsCloseShortLiquidated'\n  | 'perpsCloseShortStopLoss'\n  | 'perpsPaidFundingFees'\n  | 'perpsReceivedFundingFees'\n  | 'perpsCloseShortTakeProfit'\n  | 'perpsCloseLongTakeProfit'\n  | 'marketShort'\n  | 'stopMarketCloseShort'\n  | 'marketCloseShort'\n  | 'assetActivation'\n  | 'assetDeactivation';\n\nexport type Status = 'pending' | 'success' | 'failed' | 'cancelled';\n\nexport type AssetType = 'native' | 'erc20' | 'erc721' | 'erc1155';\n\nexport type TokenAmount = {\n  amount?: string;\n  decimals?: number;\n  symbol?: string;\n  assetId?: string;\n  assetType?: AssetType;\n  direction: 'in' | 'out';\n};\n\nexport type FiatAmount = {\n  amount: string;\n  currency?: string;\n};\n\nexport type Fee = {\n  type: string;\n  amount?: string;\n  decimals?: number;\n  symbol?: string;\n  assetId?: string;\n  assetType?: AssetType;\n};\n\ntype ActivityData<Type extends ActivityKind, Data> = {\n  type: Type;\n  chainId: CaipChainId;\n  status: Status;\n  timestamp: number;\n  hash?: string;\n  data: Data;\n};\n\nexport type ActivityItem =\n  | ActivityData<\n      'approveSpendingCap' | 'revokeSpendingCap' | 'increaseSpendingCap',\n      {\n        from?: string;\n        token?: TokenAmount;\n        fees?: Fee[];\n      }\n    >\n  | ActivityData<\n      'assetActivation' | 'assetDeactivation',\n      {\n        from?: string;\n        token?: TokenAmount;\n        fees?: Fee[];\n      }\n    >\n  | ActivityData<\n      'send' | 'receive',\n      {\n        from: string;\n        to: string;\n        token?: TokenAmount;\n        fees?: Fee[];\n      }\n    >\n  | ActivityData<\n      'nftBuy' | 'nftMint' | 'nftSell',\n      {\n        from?: string;\n        to?: string;\n        token?: TokenAmount;\n        paymentToken?: TokenAmount;\n      }\n    >\n  | ActivityData<\n      | 'swap'\n      | 'bridge'\n      | 'convert'\n      | 'lendingDeposit'\n      | 'lendingWithdrawal'\n      | 'wrap'\n      | 'unwrap',\n      {\n        from?: string;\n        sourceToken?: TokenAmount;\n        destinationToken?: TokenAmount;\n        fees?: Fee[];\n      }\n    >\n  | ActivityData<\n      'buy' | 'claim' | 'deposit' | 'claimMusdBonus',\n      {\n        from?: string;\n        token?: TokenAmount;\n      }\n    >\n  | ActivityData<\n      'perpsAddFunds' | 'perpsWithdraw',\n      {\n        from?: string;\n        fiat?: FiatAmount;\n        networkFee?: FiatAmount;\n        token?: TokenAmount;\n      }\n    >\n  | ActivityData<\n      'contractInteraction',\n      {\n        from: string;\n        to: string;\n        token?: TokenAmount;\n        fees?: Fee[];\n        methodId?: string;\n        transactionCategory?: string;\n        transactionProtocol?: string;\n      }\n    >;\n\n// Note: Update core-backend\nexport type ValueTransfer = _ValueTransfer & {\n  contractAddress: string;\n  symbol: string;\n  name: string;\n};\n"]}
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ValueTransfer as _ValueTransfer } from '@metamask/core-backend';\nimport type { CaipChainId } from '@metamask/utils';\n\nexport type ActivityKind =\n  | 'receive'\n  | 'sell'\n  | 'buy'\n  | 'deposit'\n  | 'swap'\n  | 'claim'\n  | 'claimMusdBonus'\n  | 'send'\n  | 'wrap'\n  | 'unwrap'\n  | 'approveSpendingCap'\n  | 'revokeSpendingCap'\n  | 'increaseSpendingCap'\n  | 'contractInteraction'\n  | 'contractDeployment'\n  | 'bridge'\n  | 'convert'\n  | 'nftBuy'\n  | 'nftMint'\n  | 'nftSell'\n  | 'smartAccountUpgrade'\n  | 'lendingDeposit'\n  | 'lendingWithdrawal'\n  | 'predictionsAddFunds'\n  | 'predictionsWithdrawFunds'\n  | 'predictionClaimWinnings'\n  | 'predictionCashedOut'\n  | 'predictionPlaced'\n  | 'perpsAddFunds'\n  | 'perpsWithdraw'\n  | 'perpsOpenLong'\n  | 'perpsCloseLong'\n  | 'perpsCloseLongLiquidated'\n  | 'perpsCloseLongStopLoss'\n  | 'perpsOpenShort'\n  | 'perpsCloseShort'\n  | 'perpsCloseShortLiquidated'\n  | 'perpsCloseShortStopLoss'\n  | 'perpsPaidFundingFees'\n  | 'perpsReceivedFundingFees'\n  | 'perpsCloseShortTakeProfit'\n  | 'perpsCloseLongTakeProfit'\n  | 'marketShort'\n  | 'stopMarketCloseShort'\n  | 'marketCloseShort'\n  | 'assetActivation'\n  | 'assetDeactivation'\n  | 'rampBuy'\n  | 'rampSell';\n\nexport type Status = 'pending' | 'success' | 'failed' | 'cancelled';\n\nexport type AssetType = 'native' | 'erc20' | 'erc721' | 'erc1155';\n\nexport type TokenAmount = {\n  amount?: string;\n  decimals?: number;\n  symbol?: string;\n  assetId?: string;\n  assetType?: AssetType;\n  direction: 'in' | 'out';\n};\n\nexport type FiatAmount = {\n  amount: string;\n  currency?: string;\n};\n\nexport type Fee = {\n  type: string;\n  amount?: string;\n  decimals?: number;\n  symbol?: string;\n  assetId?: string;\n  assetType?: AssetType;\n};\n\ntype ActivityData<Type extends ActivityKind, Data> = {\n  type: Type;\n  chainId: CaipChainId;\n  status: Status;\n  timestamp: number;\n  hash?: string;\n  data: Data;\n};\n\n/**\n * Bank transfer instruction fields attached to a ramp order by providers\n * that require manual payment (e.g. SEPA, wire transfer).\n */\nexport type RampOrderPaymentDetail = {\n  fiatCurrency: string;\n  paymentMethod: string;\n  fields: { name: string; id: string; value: string }[];\n};\n\nexport type ActivityItem =\n  | ActivityData<\n      'approveSpendingCap' | 'revokeSpendingCap' | 'increaseSpendingCap',\n      {\n        from?: string;\n        token?: TokenAmount;\n        fees?: Fee[];\n      }\n    >\n  | ActivityData<\n      'assetActivation' | 'assetDeactivation',\n      {\n        from?: string;\n        token?: TokenAmount;\n        fees?: Fee[];\n      }\n    >\n  | ActivityData<\n      'send' | 'receive',\n      {\n        from: string;\n        to: string;\n        token?: TokenAmount;\n        fees?: Fee[];\n      }\n    >\n  | ActivityData<\n      'nftBuy' | 'nftMint' | 'nftSell',\n      {\n        from?: string;\n        to?: string;\n        token?: TokenAmount;\n        paymentToken?: TokenAmount;\n      }\n    >\n  | ActivityData<\n      | 'swap'\n      | 'bridge'\n      | 'convert'\n      | 'lendingDeposit'\n      | 'lendingWithdrawal'\n      | 'wrap'\n      | 'unwrap',\n      {\n        from?: string;\n        sourceToken?: TokenAmount;\n        destinationToken?: TokenAmount;\n        fees?: Fee[];\n      }\n    >\n  | ActivityData<\n      'buy' | 'claim' | 'deposit' | 'claimMusdBonus',\n      {\n        from?: string;\n        token?: TokenAmount;\n      }\n    >\n  | ActivityData<\n      'perpsAddFunds' | 'perpsWithdraw',\n      {\n        from?: string;\n        fiat?: FiatAmount;\n        networkFee?: FiatAmount;\n        token?: TokenAmount;\n      }\n    >\n  | ActivityData<\n      'contractInteraction',\n      {\n        from: string;\n        to: string;\n        token?: TokenAmount;\n        fees?: Fee[];\n        methodId?: string;\n        transactionCategory?: string;\n        transactionProtocol?: string;\n      }\n    >\n  | (Omit<\n      ActivityData<\n        'rampBuy' | 'rampSell',\n        {\n          from?: string;\n          fiat?: FiatAmount;\n          token?: TokenAmount;\n          fees?: Fee[];\n          provider?: {\n            id?: string;\n            name?: string;\n            orderLink?: string;\n          };\n          statusDescription?: string;\n          paymentDetails?: RampOrderPaymentDetail[];\n          // Stable identifier for orders that may not have a hash yet (e.g. a\n          // ramp order pending fiat settlement, where `hash` is empty until it\n          // settles on-chain). Lives in `data` as a ramp-specific property.\n          id?: string;\n        }\n      >,\n      'chainId'\n    > & {\n      // Precreated stub orders (see `RampsController.addPrecreatedOrder`) may\n      // not have an assigned network yet, so unlike every other activity\n      // kind, a ramp order's chain id isn't guaranteed.\n      chainId?: CaipChainId;\n    });\n\n// Note: Update core-backend\nexport type ValueTransfer = _ValueTransfer & {\n  contractAddress: string;\n  symbol: string;\n  name: string;\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/client-utils",
-  "version": "1.3.0-preview-6316943cb",
+  "version": "1.3.1-preview-2296abeaf",
   "description": "Shared functions and utilities used across MetaMask clients (extension and mobile)",
   "keywords": [
     "Ethereum",
@@ -57,9 +57,9 @@
   "dependencies": {
     "@metamask/contract-metadata": "^2.4.0",
     "@metamask/controller-utils": "^12.3.0",
-    "@metamask/core-backend": "^7.0.0",
+    "@metamask/core-backend": "^8.0.0",
     "@metamask/keyring-api": "^23.7.0",
-    "@metamask/transaction-controller": "^69.2.1",
+    "@metamask/transaction-controller": "^69.3.0",
     "@metamask/utils": "^11.11.0"
   },
   "devDependencies": {