@metamask-previews/design-system-shared 0.0.0-preview.374d60e

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+[Unreleased]: https://github.com/MetaMask/metamask-design-system/

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 MetaMask
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE

package/README.md

@@ -0,0 +1,15 @@
+# `@metamask/design-system-shared`
+
+Shared types for design system libraries
+
+## Installation
+
+`yarn add @metamask/design-system-shared`
+
+or
+
+`npm install @metamask/design-system-shared`
+
+## Contributing
+
+This package is part of a monorepo. Instructions for contributing can be found in the [monorepo README](https://github.com/MetaMask/metamask-design-system#readme).

package/dist/index.cjs

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateIconSeed = exports.isEthereumAddress = exports.generateSeedNonEthereum = exports.generateSeedEthereum = exports.extractAccountAddress = void 0;
+/**
+ * Example function that returns a greeting for the given name.
+ *
+ * @param name - The name to greet.
+ * @returns The greeting.
+ */
+function greeter(name) {
+    return `Hello, ${name}!`;
+}
+exports.default = greeter;
+var caip_address_1 = require("./utils/caip-address.cjs");
+Object.defineProperty(exports, "extractAccountAddress", { enumerable: true, get: function () { return caip_address_1.extractAccountAddress; } });
+Object.defineProperty(exports, "generateSeedEthereum", { enumerable: true, get: function () { return caip_address_1.generateSeedEthereum; } });
+Object.defineProperty(exports, "generateSeedNonEthereum", { enumerable: true, get: function () { return caip_address_1.generateSeedNonEthereum; } });
+Object.defineProperty(exports, "isEthereumAddress", { enumerable: true, get: function () { return caip_address_1.isEthereumAddress; } });
+Object.defineProperty(exports, "generateIconSeed", { enumerable: true, get: function () { return caip_address_1.generateIconSeed; } });
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,SAAwB,OAAO,CAAC,IAAY;IAC1C,OAAO,UAAU,IAAI,GAAG,CAAC;AAC3B,CAAC;AAFD,0BAEC;AAED,yDAM8B;AAL5B,qHAAA,qBAAqB,OAAA;AACrB,oHAAA,oBAAoB,OAAA;AACpB,uHAAA,uBAAuB,OAAA;AACvB,iHAAA,iBAAiB,OAAA;AACjB,gHAAA,gBAAgB,OAAA","sourcesContent":["/**\n * Example function that returns a greeting for the given name.\n *\n * @param name - The name to greet.\n * @returns The greeting.\n */\nexport default function greeter(name: string): string {\n  return `Hello, ${name}!`;\n}\n\nexport {\n  extractAccountAddress,\n  generateSeedEthereum,\n  generateSeedNonEthereum,\n  isEthereumAddress,\n  generateIconSeed,\n} from './utils/caip-address';\n"]}

package/dist/index.d.cts

@@ -0,0 +1,9 @@
+/**
+ * Example function that returns a greeting for the given name.
+ *
+ * @param name - The name to greet.
+ * @returns The greeting.
+ */
+export default function greeter(name: string): string;
+export { extractAccountAddress, generateSeedEthereum, generateSeedNonEthereum, isEthereumAddress, generateIconSeed, } from "./utils/caip-address.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,GACjB,iCAA6B"}

package/dist/index.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Example function that returns a greeting for the given name.
+ *
+ * @param name - The name to greet.
+ * @returns The greeting.
+ */
+export default function greeter(name: string): string;
+export { extractAccountAddress, generateSeedEthereum, generateSeedNonEthereum, isEthereumAddress, generateIconSeed, } from "./utils/caip-address.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,GACjB,iCAA6B"}

package/dist/index.mjs

@@ -0,0 +1,11 @@
+/**
+ * Example function that returns a greeting for the given name.
+ *
+ * @param name - The name to greet.
+ * @returns The greeting.
+ */
+export default function greeter(name) {
+    return `Hello, ${name}!`;
+}
+export { extractAccountAddress, generateSeedEthereum, generateSeedNonEthereum, isEthereumAddress, generateIconSeed } from "./utils/caip-address.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,IAAY;IAC1C,OAAO,UAAU,IAAI,GAAG,CAAC;AAC3B,CAAC;AAED,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EACjB,iCAA6B","sourcesContent":["/**\n * Example function that returns a greeting for the given name.\n *\n * @param name - The name to greet.\n * @returns The greeting.\n */\nexport default function greeter(name: string): string {\n  return `Hello, ${name}!`;\n}\n\nexport {\n  extractAccountAddress,\n  generateSeedEthereum,\n  generateSeedNonEthereum,\n  isEthereumAddress,\n  generateIconSeed,\n} from './utils/caip-address';\n"]}

package/dist/utils/caip-address.cjs

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateIconSeed = exports.isEthereumAddress = exports.generateSeedNonEthereum = exports.generateSeedEthereum = exports.extractAccountAddress = void 0;
+const utils_1 = require("@metamask/utils");
+/**
+ * Extracts the account address from a CAIP-10 formatted address string.
+ *
+ * For CAIP-10 addresses like "eip155:1:0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8",
+ * this returns just the address part: "0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8".
+ *
+ * This ensures that both legacy addresses and CAIP-10 addresses generate
+ * the same icon, regardless of network specification.
+ *
+ * @param address - The address string (either legacy format or CAIP-10)
+ * @returns The extracted account address
+ *
+ * @example
+ * extractAccountAddress('0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8')
+ * Returns: '0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8'
+ *
+ * @example
+ * extractAccountAddress('eip155:1:0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8')
+ * Returns: '0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8'
+ *
+ * @example
+ * extractAccountAddress('solana:mainnet:4Nd1m3NnENa8h8Xte1Xr7s9jcvKqqm21z3FvY9hKg4s7')
+ * Returns: '4Nd1m3NnENa8h8Xte1Xr7s9jcvKqqm21z3FvY9hKg4s7'
+ */
+function extractAccountAddress(address) {
+    try {
+        // Try to parse as CAIP-10 first
+        if ((0, utils_1.isCaipAccountId)(address)) {
+            const parsed = (0, utils_1.parseCaipAccountId)(address);
+            return parsed.address;
+        }
+    }
+    catch {
+        // If parsing fails, fall through to return original address
+    }
+    // Return the address as-is if it's not CAIP-10 format
+    return address;
+}
+exports.extractAccountAddress = extractAccountAddress;
+/**
+ * Generates a numeric seed for Ethereum (eip155) addresses.
+ *
+ * @param address - The Ethereum address to generate a seed from
+ * @returns A numeric seed for icon generation
+ */
+function generateSeedEthereum(address) {
+    // Parse the first 8 chars of the address after '0x'
+    const addr = address.slice(2, 10);
+    return parseInt(addr, 16);
+}
+exports.generateSeedEthereum = generateSeedEthereum;
+/**
+ * Generates a byte-array seed for non-Ethereum addresses (Solana, Bitcoin, etc.).
+ *
+ * @param address - The address to generate a byte array seed from
+ * @returns An array of numbers representing the bytes of the address
+ */
+function generateSeedNonEthereum(address) {
+    return Array.from((0, utils_1.stringToBytes)(address.normalize('NFKC').toLowerCase()));
+}
+exports.generateSeedNonEthereum = generateSeedNonEthereum;
+/**
+ * Determines if an address is Ethereum format (starts with 0x).
+ *
+ * @param address - The address to check
+ * @returns True if Ethereum format, false otherwise
+ */
+function isEthereumAddress(address) {
+    return address.startsWith('0x');
+}
+exports.isEthereumAddress = isEthereumAddress;
+/**
+ * Generates an appropriate seed for icon generation based on address format.
+ * Ethereum addresses (0x prefix) use hex parsing, others use byte array.
+ *
+ * @param address - The address to generate a seed from (should be extracted first)
+ * @returns A seed for icon generation (number for Ethereum, number[] for others)
+ */
+function generateIconSeed(address) {
+    return isEthereumAddress(address)
+        ? generateSeedEthereum(address)
+        : generateSeedNonEthereum(address);
+}
+exports.generateIconSeed = generateIconSeed;
+//# sourceMappingURL=caip-address.cjs.map

package/dist/utils/caip-address.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip-address.cjs","sourceRoot":"","sources":["../../src/utils/caip-address.ts"],"names":[],"mappings":";;;AAAA,2CAIyB;AAEzB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,qBAAqB,CAAC,OAAe;IACnD,IAAI;QACF,gCAAgC;QAChC,IAAI,IAAA,uBAAe,EAAC,OAAO,CAAC,EAAE;YAC5B,MAAM,MAAM,GAAG,IAAA,0BAAkB,EAAC,OAAO,CAAC,CAAC;YAC3C,OAAO,MAAM,CAAC,OAAO,CAAC;SACvB;KACF;IAAC,MAAM;QACN,4DAA4D;KAC7D;IAED,sDAAsD;IACtD,OAAO,OAAO,CAAC;AACjB,CAAC;AAbD,sDAaC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,OAAe;IAClD,oDAAoD;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClC,OAAO,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC5B,CAAC;AAJD,oDAIC;AAED;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAC,OAAe;IACrD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAA,qBAAa,EAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AAC5E,CAAC;AAFD,0DAEC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,OAAe;IAC/C,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAFD,8CAEC;AAED;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,OAAe;IAC9C,OAAO,iBAAiB,CAAC,OAAO,CAAC;QAC/B,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC;QAC/B,CAAC,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAJD,4CAIC","sourcesContent":["import {\n  parseCaipAccountId,\n  isCaipAccountId,\n  stringToBytes,\n} from '@metamask/utils';\n\n/**\n * Extracts the account address from a CAIP-10 formatted address string.\n *\n * For CAIP-10 addresses like \"eip155:1:0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8\",\n * this returns just the address part: \"0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8\".\n *\n * This ensures that both legacy addresses and CAIP-10 addresses generate\n * the same icon, regardless of network specification.\n *\n * @param address - The address string (either legacy format or CAIP-10)\n * @returns The extracted account address\n *\n * @example\n * extractAccountAddress('0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8')\n * Returns: '0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8'\n *\n * @example\n * extractAccountAddress('eip155:1:0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8')\n * Returns: '0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8'\n *\n * @example\n * extractAccountAddress('solana:mainnet:4Nd1m3NnENa8h8Xte1Xr7s9jcvKqqm21z3FvY9hKg4s7')\n * Returns: '4Nd1m3NnENa8h8Xte1Xr7s9jcvKqqm21z3FvY9hKg4s7'\n */\nexport function extractAccountAddress(address: string): string {\n  try {\n    // Try to parse as CAIP-10 first\n    if (isCaipAccountId(address)) {\n      const parsed = parseCaipAccountId(address);\n      return parsed.address;\n    }\n  } catch {\n    // If parsing fails, fall through to return original address\n  }\n\n  // Return the address as-is if it's not CAIP-10 format\n  return address;\n}\n\n/**\n * Generates a numeric seed for Ethereum (eip155) addresses.\n *\n * @param address - The Ethereum address to generate a seed from\n * @returns A numeric seed for icon generation\n */\nexport function generateSeedEthereum(address: string): number {\n  // Parse the first 8 chars of the address after '0x'\n  const addr = address.slice(2, 10);\n  return parseInt(addr, 16);\n}\n\n/**\n * Generates a byte-array seed for non-Ethereum addresses (Solana, Bitcoin, etc.).\n *\n * @param address - The address to generate a byte array seed from\n * @returns An array of numbers representing the bytes of the address\n */\nexport function generateSeedNonEthereum(address: string): number[] {\n  return Array.from(stringToBytes(address.normalize('NFKC').toLowerCase()));\n}\n\n/**\n * Determines if an address is Ethereum format (starts with 0x).\n *\n * @param address - The address to check\n * @returns True if Ethereum format, false otherwise\n */\nexport function isEthereumAddress(address: string): boolean {\n  return address.startsWith('0x');\n}\n\n/**\n * Generates an appropriate seed for icon generation based on address format.\n * Ethereum addresses (0x prefix) use hex parsing, others use byte array.\n *\n * @param address - The address to generate a seed from (should be extracted first)\n * @returns A seed for icon generation (number for Ethereum, number[] for others)\n */\nexport function generateIconSeed(address: string): number | number[] {\n  return isEthereumAddress(address)\n    ? generateSeedEthereum(address)\n    : generateSeedNonEthereum(address);\n}\n"]}

package/dist/utils/caip-address.d.cts

@@ -0,0 +1,55 @@
+/**
+ * Extracts the account address from a CAIP-10 formatted address string.
+ *
+ * For CAIP-10 addresses like "eip155:1:0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8",
+ * this returns just the address part: "0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8".
+ *
+ * This ensures that both legacy addresses and CAIP-10 addresses generate
+ * the same icon, regardless of network specification.
+ *
+ * @param address - The address string (either legacy format or CAIP-10)
+ * @returns The extracted account address
+ *
+ * @example
+ * extractAccountAddress('0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8')
+ * Returns: '0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8'
+ *
+ * @example
+ * extractAccountAddress('eip155:1:0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8')
+ * Returns: '0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8'
+ *
+ * @example
+ * extractAccountAddress('solana:mainnet:4Nd1m3NnENa8h8Xte1Xr7s9jcvKqqm21z3FvY9hKg4s7')
+ * Returns: '4Nd1m3NnENa8h8Xte1Xr7s9jcvKqqm21z3FvY9hKg4s7'
+ */
+export declare function extractAccountAddress(address: string): string;
+/**
+ * Generates a numeric seed for Ethereum (eip155) addresses.
+ *
+ * @param address - The Ethereum address to generate a seed from
+ * @returns A numeric seed for icon generation
+ */
+export declare function generateSeedEthereum(address: string): number;
+/**
+ * Generates a byte-array seed for non-Ethereum addresses (Solana, Bitcoin, etc.).
+ *
+ * @param address - The address to generate a byte array seed from
+ * @returns An array of numbers representing the bytes of the address
+ */
+export declare function generateSeedNonEthereum(address: string): number[];
+/**
+ * Determines if an address is Ethereum format (starts with 0x).
+ *
+ * @param address - The address to check
+ * @returns True if Ethereum format, false otherwise
+ */
+export declare function isEthereumAddress(address: string): boolean;
+/**
+ * Generates an appropriate seed for icon generation based on address format.
+ * Ethereum addresses (0x prefix) use hex parsing, others use byte array.
+ *
+ * @param address - The address to generate a seed from (should be extracted first)
+ * @returns A seed for icon generation (number for Ethereum, number[] for others)
+ */
+export declare function generateIconSeed(address: string): number | number[];
+//# sourceMappingURL=caip-address.d.cts.map

package/dist/utils/caip-address.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip-address.d.cts","sourceRoot":"","sources":["../../src/utils/caip-address.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAa7D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAInE"}

package/dist/utils/caip-address.d.mts

@@ -0,0 +1,55 @@
+/**
+ * Extracts the account address from a CAIP-10 formatted address string.
+ *
+ * For CAIP-10 addresses like "eip155:1:0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8",
+ * this returns just the address part: "0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8".
+ *
+ * This ensures that both legacy addresses and CAIP-10 addresses generate
+ * the same icon, regardless of network specification.
+ *
+ * @param address - The address string (either legacy format or CAIP-10)
+ * @returns The extracted account address
+ *
+ * @example
+ * extractAccountAddress('0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8')
+ * Returns: '0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8'
+ *
+ * @example
+ * extractAccountAddress('eip155:1:0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8')
+ * Returns: '0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8'
+ *
+ * @example
+ * extractAccountAddress('solana:mainnet:4Nd1m3NnENa8h8Xte1Xr7s9jcvKqqm21z3FvY9hKg4s7')
+ * Returns: '4Nd1m3NnENa8h8Xte1Xr7s9jcvKqqm21z3FvY9hKg4s7'
+ */
+export declare function extractAccountAddress(address: string): string;
+/**
+ * Generates a numeric seed for Ethereum (eip155) addresses.
+ *
+ * @param address - The Ethereum address to generate a seed from
+ * @returns A numeric seed for icon generation
+ */
+export declare function generateSeedEthereum(address: string): number;
+/**
+ * Generates a byte-array seed for non-Ethereum addresses (Solana, Bitcoin, etc.).
+ *
+ * @param address - The address to generate a byte array seed from
+ * @returns An array of numbers representing the bytes of the address
+ */
+export declare function generateSeedNonEthereum(address: string): number[];
+/**
+ * Determines if an address is Ethereum format (starts with 0x).
+ *
+ * @param address - The address to check
+ * @returns True if Ethereum format, false otherwise
+ */
+export declare function isEthereumAddress(address: string): boolean;
+/**
+ * Generates an appropriate seed for icon generation based on address format.
+ * Ethereum addresses (0x prefix) use hex parsing, others use byte array.
+ *
+ * @param address - The address to generate a seed from (should be extracted first)
+ * @returns A seed for icon generation (number for Ethereum, number[] for others)
+ */
+export declare function generateIconSeed(address: string): number | number[];
+//# sourceMappingURL=caip-address.d.mts.map

package/dist/utils/caip-address.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip-address.d.mts","sourceRoot":"","sources":["../../src/utils/caip-address.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAa7D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAInE"}

package/dist/utils/caip-address.mjs

@@ -0,0 +1,81 @@
+import { parseCaipAccountId, isCaipAccountId, stringToBytes } from "@metamask/utils";
+/**
+ * Extracts the account address from a CAIP-10 formatted address string.
+ *
+ * For CAIP-10 addresses like "eip155:1:0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8",
+ * this returns just the address part: "0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8".
+ *
+ * This ensures that both legacy addresses and CAIP-10 addresses generate
+ * the same icon, regardless of network specification.
+ *
+ * @param address - The address string (either legacy format or CAIP-10)
+ * @returns The extracted account address
+ *
+ * @example
+ * extractAccountAddress('0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8')
+ * Returns: '0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8'
+ *
+ * @example
+ * extractAccountAddress('eip155:1:0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8')
+ * Returns: '0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8'
+ *
+ * @example
+ * extractAccountAddress('solana:mainnet:4Nd1m3NnENa8h8Xte1Xr7s9jcvKqqm21z3FvY9hKg4s7')
+ * Returns: '4Nd1m3NnENa8h8Xte1Xr7s9jcvKqqm21z3FvY9hKg4s7'
+ */
+export function extractAccountAddress(address) {
+    try {
+        // Try to parse as CAIP-10 first
+        if (isCaipAccountId(address)) {
+            const parsed = parseCaipAccountId(address);
+            return parsed.address;
+        }
+    }
+    catch {
+        // If parsing fails, fall through to return original address
+    }
+    // Return the address as-is if it's not CAIP-10 format
+    return address;
+}
+/**
+ * Generates a numeric seed for Ethereum (eip155) addresses.
+ *
+ * @param address - The Ethereum address to generate a seed from
+ * @returns A numeric seed for icon generation
+ */
+export function generateSeedEthereum(address) {
+    // Parse the first 8 chars of the address after '0x'
+    const addr = address.slice(2, 10);
+    return parseInt(addr, 16);
+}
+/**
+ * Generates a byte-array seed for non-Ethereum addresses (Solana, Bitcoin, etc.).
+ *
+ * @param address - The address to generate a byte array seed from
+ * @returns An array of numbers representing the bytes of the address
+ */
+export function generateSeedNonEthereum(address) {
+    return Array.from(stringToBytes(address.normalize('NFKC').toLowerCase()));
+}
+/**
+ * Determines if an address is Ethereum format (starts with 0x).
+ *
+ * @param address - The address to check
+ * @returns True if Ethereum format, false otherwise
+ */
+export function isEthereumAddress(address) {
+    return address.startsWith('0x');
+}
+/**
+ * Generates an appropriate seed for icon generation based on address format.
+ * Ethereum addresses (0x prefix) use hex parsing, others use byte array.
+ *
+ * @param address - The address to generate a seed from (should be extracted first)
+ * @returns A seed for icon generation (number for Ethereum, number[] for others)
+ */
+export function generateIconSeed(address) {
+    return isEthereumAddress(address)
+        ? generateSeedEthereum(address)
+        : generateSeedNonEthereum(address);
+}
+//# sourceMappingURL=caip-address.mjs.map

package/dist/utils/caip-address.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip-address.mjs","sourceRoot":"","sources":["../../src/utils/caip-address.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,aAAa,EACd,wBAAwB;AAEzB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,IAAI;QACF,gCAAgC;QAChC,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE;YAC5B,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;YAC3C,OAAO,MAAM,CAAC,OAAO,CAAC;SACvB;KACF;IAAC,MAAM;QACN,4DAA4D;KAC7D;IAED,sDAAsD;IACtD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,oDAAoD;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClC,OAAO,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,iBAAiB,CAAC,OAAO,CAAC;QAC/B,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC;QAC/B,CAAC,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC","sourcesContent":["import {\n  parseCaipAccountId,\n  isCaipAccountId,\n  stringToBytes,\n} from '@metamask/utils';\n\n/**\n * Extracts the account address from a CAIP-10 formatted address string.\n *\n * For CAIP-10 addresses like \"eip155:1:0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8\",\n * this returns just the address part: \"0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8\".\n *\n * This ensures that both legacy addresses and CAIP-10 addresses generate\n * the same icon, regardless of network specification.\n *\n * @param address - The address string (either legacy format or CAIP-10)\n * @returns The extracted account address\n *\n * @example\n * extractAccountAddress('0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8')\n * Returns: '0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8'\n *\n * @example\n * extractAccountAddress('eip155:1:0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8')\n * Returns: '0x9Cbf7c41B7787F6c621115010D3B044029FE2Ce8'\n *\n * @example\n * extractAccountAddress('solana:mainnet:4Nd1m3NnENa8h8Xte1Xr7s9jcvKqqm21z3FvY9hKg4s7')\n * Returns: '4Nd1m3NnENa8h8Xte1Xr7s9jcvKqqm21z3FvY9hKg4s7'\n */\nexport function extractAccountAddress(address: string): string {\n  try {\n    // Try to parse as CAIP-10 first\n    if (isCaipAccountId(address)) {\n      const parsed = parseCaipAccountId(address);\n      return parsed.address;\n    }\n  } catch {\n    // If parsing fails, fall through to return original address\n  }\n\n  // Return the address as-is if it's not CAIP-10 format\n  return address;\n}\n\n/**\n * Generates a numeric seed for Ethereum (eip155) addresses.\n *\n * @param address - The Ethereum address to generate a seed from\n * @returns A numeric seed for icon generation\n */\nexport function generateSeedEthereum(address: string): number {\n  // Parse the first 8 chars of the address after '0x'\n  const addr = address.slice(2, 10);\n  return parseInt(addr, 16);\n}\n\n/**\n * Generates a byte-array seed for non-Ethereum addresses (Solana, Bitcoin, etc.).\n *\n * @param address - The address to generate a byte array seed from\n * @returns An array of numbers representing the bytes of the address\n */\nexport function generateSeedNonEthereum(address: string): number[] {\n  return Array.from(stringToBytes(address.normalize('NFKC').toLowerCase()));\n}\n\n/**\n * Determines if an address is Ethereum format (starts with 0x).\n *\n * @param address - The address to check\n * @returns True if Ethereum format, false otherwise\n */\nexport function isEthereumAddress(address: string): boolean {\n  return address.startsWith('0x');\n}\n\n/**\n * Generates an appropriate seed for icon generation based on address format.\n * Ethereum addresses (0x prefix) use hex parsing, others use byte array.\n *\n * @param address - The address to generate a seed from (should be extracted first)\n * @returns A seed for icon generation (number for Ethereum, number[] for others)\n */\nexport function generateIconSeed(address: string): number | number[] {\n  return isEthereumAddress(address)\n    ? generateSeedEthereum(address)\n    : generateSeedNonEthereum(address);\n}\n"]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@metamask-previews/design-system-shared",
+  "version": "0.0.0-preview.374d60e",
+  "description": "Shared types for design system libraries",
+  "keywords": [
+    "MetaMask",
+    "Ethereum"
+  ],
+  "homepage": "https://github.com/MetaMask/metamask-design-system/tree/main/packages/design-system-shared#readme",
+  "bugs": {
+    "url": "https://github.com/MetaMask/metamask-design-system/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MetaMask/metamask-design-system.git"
+  },
+  "license": "MIT",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.cts",
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "ts-bridge --project tsconfig.build.json --verbose --clean --no-references",
+    "changelog:update": "../../scripts/update-changelog.sh @metamask/design-system-shared",
+    "changelog:validate": "../../scripts/validate-changelog.sh @metamask/design-system-shared",
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest --reporters=jest-silent-reporter",
+    "test:clean": "NODE_OPTIONS=--experimental-vm-modules jest --clearCache",
+    "test:verbose": "NODE_OPTIONS=--experimental-vm-modules jest --verbose",
+    "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch",
+    "since-latest-release": "../../scripts/since-latest-release.sh",
+    "publish:preview": "yarn npm publish --tag preview"
+  },
+  "dependencies": {
+    "@metamask/utils": "^11.7.0"
+  },
+  "devDependencies": {
+    "@metamask/auto-changelog": "^5.0.2",
+    "@ts-bridge/cli": "^0.6.3",
+    "@types/jest": "^27.4.1",
+    "deepmerge": "^4.2.2",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.5",
+    "typescript": "~5.2.2"
+  },
+  "engines": {
+    "node": "^18.18 || >=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}