@metamask-previews/network-enablement-controller 4.1.0-preview-a196307b6 → 4.1.0-preview-bbc71c9d5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +4 -0
- package/dist/services/Slip44Service.cjs +11 -0
- package/dist/services/Slip44Service.cjs.map +1 -1
- package/dist/services/Slip44Service.d.cts +0 -12
- package/dist/services/Slip44Service.d.cts.map +1 -1
- package/dist/services/Slip44Service.d.mts +0 -12
- package/dist/services/Slip44Service.d.mts.map +1 -1
- package/dist/services/Slip44Service.mjs +11 -0
- package/dist/services/Slip44Service.mjs.map +1 -1
- package/package.json +1 -2
package/CHANGELOG.md
CHANGED
|
@@ -13,6 +13,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
13
13
|
- Bump `@metamask/transaction-controller` from `^62.9.2` to `^62.17.0` ([#7737](https://github.com/MetaMask/core/pull/7737), [#7760](https://github.com/MetaMask/core/pull/7760), [#7775](https://github.com/MetaMask/core/pull/7775), [#7802](https://github.com/MetaMask/core/pull/7802), [#7832](https://github.com/MetaMask/core/pull/7832), [#7854](https://github.com/MetaMask/core/pull/7854), [#7872](https://github.com/MetaMask/core/pull/7872)), ([#7897](https://github.com/MetaMask/core/pull/7897))
|
|
14
14
|
- Bump `@metamask/multichain-network-controller` from `3.0.2` to `3.0.3` ([#7897](https://github.com/MetaMask/core/pull/7897))
|
|
15
15
|
|
|
16
|
+
### Fixed
|
|
17
|
+
|
|
18
|
+
- Override SLIP-44 for HyperEVM (chain ID 999) to 2457 so native asset identifier is `eip155:999/slip44:2457` instead of the incorrect value from chainid.network (chain collision with Wanchain) ([#7975](https://github.com/MetaMask/core/pull/7975))
|
|
19
|
+
|
|
16
20
|
## [4.1.0]
|
|
17
21
|
|
|
18
22
|
### Added
|
|
@@ -32,6 +32,13 @@ const CHAINID_NETWORK_URL = 'https://chainid.network/chains.json';
|
|
|
32
32
|
* @see https://github.com/satoshilabs/slips/blob/master/slip-0044.md
|
|
33
33
|
* @see https://chainid.network/chains.json
|
|
34
34
|
*/
|
|
35
|
+
/**
|
|
36
|
+
* Manual overrides for EVM chain IDs where chainid.network returns
|
|
37
|
+
* an incorrect SLIP-44 value due to chain ID collisions.
|
|
38
|
+
*/
|
|
39
|
+
const EVM_SLIP44_OVERRIDES = new Map([
|
|
40
|
+
[999, 2457], // HyperEVM — chainid.network returns 1 (Wanchain collision)
|
|
41
|
+
]);
|
|
35
42
|
class Slip44Service {
|
|
36
43
|
/**
|
|
37
44
|
* Gets the SLIP-44 coin type identifier for an EVM network by chain ID.
|
|
@@ -58,6 +65,10 @@ class Slip44Service {
|
|
|
58
65
|
* ```
|
|
59
66
|
*/
|
|
60
67
|
static async getEvmSlip44(chainId) {
|
|
68
|
+
const override = EVM_SLIP44_OVERRIDES.get(chainId);
|
|
69
|
+
if (override !== undefined) {
|
|
70
|
+
return override;
|
|
71
|
+
}
|
|
61
72
|
// Ensure chain data is loaded
|
|
62
73
|
await __classPrivateFieldGet(this, _a, "m", _Slip44Service_fetchChainData).call(this);
|
|
63
74
|
// Check chainId cache first
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Slip44Service.cjs","sourceRoot":"","sources":["../../src/services/Slip44Service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,iEAAoE;AACpE,+DAA+D;AAC/D,8DAAsC;AAEtC,MAAM,mBAAmB,GAAG,qCAAqC,CAAC;AAoClE;;;;;;;;;;;GAWG;AACH,MAAa,aAAa;IA+DxB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,OAAe;QACvC,8BAA8B;QAC9B,MAAM,uBAAA,IAAI,yCAAgB,MAApB,IAAI,CAAkB,CAAC;QAE7B,4BAA4B;QAC5B,MAAM,MAAM,GAAG,uBAAA,IAAI,uCAAc,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,qEAAqE;QACrE,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAc;QACrC,oBAAoB;QACpB,IAAI,uBAAA,IAAI,sCAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,OAAO,uBAAA,IAAI,sCAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,UAAU,GAAG,gBAAoB,CAAC;QACxC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAEzC,sDAAsD;QACtD,6DAA6D;QAC7D,6DAA6D;QAC7D,qDAAqD;QACrD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,WAAW,EAAE,CAAC;gBAC/C,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACnC,uBAAA,IAAI,sCAAa,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACxC,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,mDAAmD;QACnD,uBAAA,IAAI,sCAAa,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACzC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,UAAU;QACf,uBAAA,IAAI,sCAAa,CAAC,KAAK,EAAE,CAAC;QAC1B,uBAAA,IAAI,MAAiB,IAAI,mCAAA,CAAC;QAC1B,uBAAA,IAAI,MAAiB,IAAI,mCAAA,CAAC;IAC5B,CAAC;;
|
|
1
|
+
{"version":3,"file":"Slip44Service.cjs","sourceRoot":"","sources":["../../src/services/Slip44Service.ts"],"names":[],"mappings":"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","sourcesContent":["import { fetchWithErrorHandling } from '@metamask/controller-utils';\n// @ts-expect-error: No type definitions for '@metamask/slip44'\nimport slip44 from '@metamask/slip44';\n\nconst CHAINID_NETWORK_URL = 'https://chainid.network/chains.json';\n\n/**\n * Represents a single SLIP-44 entry with its metadata.\n */\nexport type Slip44Entry = {\n index: string;\n symbol: string;\n name: string;\n};\n\n/**\n * Chain data from chainid.network\n */\ntype ChainIdNetworkEntry = {\n chainId: number;\n slip44?: number;\n nativeCurrency?: {\n symbol: string;\n };\n};\n\n/**\n * Internal type for SLIP-44 data from the @metamask/slip44 package.\n * Includes the hex field which we don't expose externally.\n */\ntype Slip44DataEntry = Slip44Entry & {\n // eslint-disable-next-line id-denylist\n hex: `0x${string}`;\n};\n\n/**\n * The SLIP-44 mapping type from the @metamask/slip44 package.\n */\ntype Slip44Data = Record<string, Slip44DataEntry>;\n\n/**\n * Service for looking up SLIP-44 coin type identifiers.\n *\n * SLIP-44 defines registered coin types used in BIP-44 derivation paths.\n *\n * This service provides two lookup methods:\n * 1. `getEvmSlip44` - For EVM networks, uses chainid.network data (recommended for eip155)\n * 2. `getSlip44BySymbol` - Fallback method using @metamask/slip44 package\n *\n * @see https://github.com/satoshilabs/slips/blob/master/slip-0044.md\n * @see https://chainid.network/chains.json\n */\n/**\n * Manual overrides for EVM chain IDs where chainid.network returns\n * an incorrect SLIP-44 value due to chain ID collisions.\n */\nconst EVM_SLIP44_OVERRIDES: ReadonlyMap<number, number> = new Map([\n [999, 2457], // HyperEVM — chainid.network returns 1 (Wanchain collision)\n]);\n\nexport class Slip44Service {\n /**\n * Cache for chainId to slip44 lookups from chainid.network.\n */\n static #chainIdCache: Map<number, number> | null = null;\n\n /**\n * Whether a fetch is currently in progress.\n */\n static #fetchPromise: Promise<void> | null = null;\n\n /**\n * Cache for symbol to slip44 index lookups.\n * This avoids iterating through all entries on repeated lookups.\n */\n static readonly #symbolCache: Map<string, number | undefined> = new Map();\n\n /**\n * Fetches and caches chain data from chainid.network.\n * This is called automatically by getEvmSlip44.\n */\n static async #fetchChainData(): Promise<void> {\n if (this.#chainIdCache !== null) {\n return;\n }\n\n // Avoid duplicate fetches\n if (this.#fetchPromise) {\n await this.#fetchPromise;\n return;\n }\n\n this.#fetchPromise = (async (): Promise<void> => {\n try {\n const chains: ChainIdNetworkEntry[] | undefined =\n await fetchWithErrorHandling({\n url: CHAINID_NETWORK_URL,\n timeout: 10000,\n });\n\n if (chains && Array.isArray(chains)) {\n this.#chainIdCache = new Map(\n chains\n .filter(\n (chain): chain is ChainIdNetworkEntry & { slip44: number } =>\n chain.slip44 !== undefined,\n )\n .map((chain) => [chain.chainId, chain.slip44]),\n );\n } else {\n // Invalid response, initialize empty cache\n this.#chainIdCache = new Map();\n }\n } catch {\n // Network failed, initialize empty cache so we fall back to symbol lookup\n this.#chainIdCache = new Map();\n }\n })();\n\n await this.#fetchPromise;\n this.#fetchPromise = null;\n }\n\n /**\n * Gets the SLIP-44 coin type identifier for an EVM network by chain ID.\n *\n * **IMPORTANT: This method is for EVM networks only (eip155 namespace).**\n * For non-EVM networks (Bitcoin, Solana, Tron, etc.), use `getSlip44BySymbol`.\n *\n * This method checks chainid.network data (which maps chainId directly\n * to slip44). If not found, defaults to 60 (Ethereum).\n *\n * @param chainId - The EVM chain ID as a number (e.g., 1 for Ethereum, 56 for BNB Chain)\n * @returns The SLIP-44 coin type number (defaults to 60 if not found)\n * @example\n * ```typescript\n * // For EVM networks only\n * const ethCoinType = await Slip44Service.getEvmSlip44(1);\n * // Returns 60\n *\n * const bnbCoinType = await Slip44Service.getEvmSlip44(56);\n * // Returns 714\n *\n * const unknownEvmChain = await Slip44Service.getEvmSlip44(99999);\n * // Returns 60 (default for EVM)\n * ```\n */\n static async getEvmSlip44(chainId: number): Promise<number> {\n const override = EVM_SLIP44_OVERRIDES.get(chainId);\n if (override !== undefined) {\n return override;\n }\n\n // Ensure chain data is loaded\n await this.#fetchChainData();\n\n // Check chainId cache first\n const cached = this.#chainIdCache?.get(chainId);\n if (cached !== undefined) {\n return cached;\n }\n\n // Default to 60 (Ethereum) for EVM networks without specific mapping\n return 60;\n }\n\n /**\n * Gets the SLIP-44 coin type identifier for a non-EVM network by symbol.\n *\n * **IMPORTANT: This method is for non-EVM networks only (Bitcoin, Solana, Tron, etc.).**\n * For EVM networks (eip155 namespace), use `getEvmSlip44` instead.\n *\n * Note: Symbol lookup may return incorrect results for duplicate symbols\n * (e.g., CPC is both CPChain and Capricoin).\n *\n * @param symbol - The network symbol (e.g., 'ETH', 'BTC', 'SOL')\n * @returns The SLIP-44 coin type number, or undefined if not found\n * @example\n * ```typescript\n * const ethCoinType = Slip44Service.getSlip44BySymbol('ETH');\n * // Returns 60\n *\n * const btcCoinType = Slip44Service.getSlip44BySymbol('BTC');\n * // Returns 0\n * ```\n */\n static getSlip44BySymbol(symbol: string): number | undefined {\n // Check cache first\n if (this.#symbolCache.has(symbol)) {\n return this.#symbolCache.get(symbol);\n }\n\n const slip44Data = slip44 as Slip44Data;\n const upperSymbol = symbol.toUpperCase();\n\n // Iterate through all entries to find matching symbol\n // Note: Object.keys returns numeric keys in ascending order,\n // so for duplicate symbols we get the lowest coin type first\n // (which is the convention for resolving duplicates)\n for (const key of Object.keys(slip44Data)) {\n const entry = slip44Data[key];\n if (entry.symbol.toUpperCase() === upperSymbol) {\n const coinType = parseInt(key, 10);\n this.#symbolCache.set(symbol, coinType);\n return coinType;\n }\n }\n\n // Cache the miss as well to avoid repeated lookups\n this.#symbolCache.set(symbol, undefined);\n return undefined;\n }\n\n /**\n * Clears all internal caches.\n * Useful for testing or if the underlying data might change.\n */\n static clearCache(): void {\n this.#symbolCache.clear();\n this.#chainIdCache = null;\n this.#fetchPromise = null;\n }\n}\n"]}
|
|
@@ -6,18 +6,6 @@ export type Slip44Entry = {
|
|
|
6
6
|
symbol: string;
|
|
7
7
|
name: string;
|
|
8
8
|
};
|
|
9
|
-
/**
|
|
10
|
-
* Service for looking up SLIP-44 coin type identifiers.
|
|
11
|
-
*
|
|
12
|
-
* SLIP-44 defines registered coin types used in BIP-44 derivation paths.
|
|
13
|
-
*
|
|
14
|
-
* This service provides two lookup methods:
|
|
15
|
-
* 1. `getEvmSlip44` - For EVM networks, uses chainid.network data (recommended for eip155)
|
|
16
|
-
* 2. `getSlip44BySymbol` - Fallback method using @metamask/slip44 package
|
|
17
|
-
*
|
|
18
|
-
* @see https://github.com/satoshilabs/slips/blob/master/slip-0044.md
|
|
19
|
-
* @see https://chainid.network/chains.json
|
|
20
|
-
*/
|
|
21
9
|
export declare class Slip44Service {
|
|
22
10
|
#private;
|
|
23
11
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Slip44Service.d.cts","sourceRoot":"","sources":["../../src/services/Slip44Service.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;
|
|
1
|
+
{"version":3,"file":"Slip44Service.d.cts","sourceRoot":"","sources":["../../src/services/Slip44Service.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AA+CF,qBAAa,aAAa;;IA+DxB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;WACU,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmB3D;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IA2B5D;;;OAGG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;CAK1B"}
|
|
@@ -6,18 +6,6 @@ export type Slip44Entry = {
|
|
|
6
6
|
symbol: string;
|
|
7
7
|
name: string;
|
|
8
8
|
};
|
|
9
|
-
/**
|
|
10
|
-
* Service for looking up SLIP-44 coin type identifiers.
|
|
11
|
-
*
|
|
12
|
-
* SLIP-44 defines registered coin types used in BIP-44 derivation paths.
|
|
13
|
-
*
|
|
14
|
-
* This service provides two lookup methods:
|
|
15
|
-
* 1. `getEvmSlip44` - For EVM networks, uses chainid.network data (recommended for eip155)
|
|
16
|
-
* 2. `getSlip44BySymbol` - Fallback method using @metamask/slip44 package
|
|
17
|
-
*
|
|
18
|
-
* @see https://github.com/satoshilabs/slips/blob/master/slip-0044.md
|
|
19
|
-
* @see https://chainid.network/chains.json
|
|
20
|
-
*/
|
|
21
9
|
export declare class Slip44Service {
|
|
22
10
|
#private;
|
|
23
11
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Slip44Service.d.mts","sourceRoot":"","sources":["../../src/services/Slip44Service.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;
|
|
1
|
+
{"version":3,"file":"Slip44Service.d.mts","sourceRoot":"","sources":["../../src/services/Slip44Service.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AA+CF,qBAAa,aAAa;;IA+DxB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;WACU,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmB3D;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IA2B5D;;;OAGG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;CAK1B"}
|
|
@@ -26,6 +26,13 @@ const CHAINID_NETWORK_URL = 'https://chainid.network/chains.json';
|
|
|
26
26
|
* @see https://github.com/satoshilabs/slips/blob/master/slip-0044.md
|
|
27
27
|
* @see https://chainid.network/chains.json
|
|
28
28
|
*/
|
|
29
|
+
/**
|
|
30
|
+
* Manual overrides for EVM chain IDs where chainid.network returns
|
|
31
|
+
* an incorrect SLIP-44 value due to chain ID collisions.
|
|
32
|
+
*/
|
|
33
|
+
const EVM_SLIP44_OVERRIDES = new Map([
|
|
34
|
+
[999, 2457], // HyperEVM — chainid.network returns 1 (Wanchain collision)
|
|
35
|
+
]);
|
|
29
36
|
export class Slip44Service {
|
|
30
37
|
/**
|
|
31
38
|
* Gets the SLIP-44 coin type identifier for an EVM network by chain ID.
|
|
@@ -52,6 +59,10 @@ export class Slip44Service {
|
|
|
52
59
|
* ```
|
|
53
60
|
*/
|
|
54
61
|
static async getEvmSlip44(chainId) {
|
|
62
|
+
const override = EVM_SLIP44_OVERRIDES.get(chainId);
|
|
63
|
+
if (override !== undefined) {
|
|
64
|
+
return override;
|
|
65
|
+
}
|
|
55
66
|
// Ensure chain data is loaded
|
|
56
67
|
await __classPrivateFieldGet(this, _a, "m", _Slip44Service_fetchChainData).call(this);
|
|
57
68
|
// Check chainId cache first
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Slip44Service.mjs","sourceRoot":"","sources":["../../src/services/Slip44Service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,sBAAsB,EAAE,mCAAmC;AACpE,+DAA+D;AAC/D,OAAO,MAAM,+CAAyB;AAEtC,MAAM,mBAAmB,GAAG,qCAAqC,CAAC;AAoClE;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,aAAa;IA+DxB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,OAAe;QACvC,8BAA8B;QAC9B,MAAM,uBAAA,IAAI,yCAAgB,MAApB,IAAI,CAAkB,CAAC;QAE7B,4BAA4B;QAC5B,MAAM,MAAM,GAAG,uBAAA,IAAI,uCAAc,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,qEAAqE;QACrE,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAc;QACrC,oBAAoB;QACpB,IAAI,uBAAA,IAAI,sCAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,OAAO,uBAAA,IAAI,sCAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,UAAU,GAAG,MAAoB,CAAC;QACxC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAEzC,sDAAsD;QACtD,6DAA6D;QAC7D,6DAA6D;QAC7D,qDAAqD;QACrD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,WAAW,EAAE,CAAC;gBAC/C,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACnC,uBAAA,IAAI,sCAAa,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACxC,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,mDAAmD;QACnD,uBAAA,IAAI,sCAAa,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACzC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,UAAU;QACf,uBAAA,IAAI,sCAAa,CAAC,KAAK,EAAE,CAAC;QAC1B,uBAAA,IAAI,MAAiB,IAAI,mCAAA,CAAC;QAC1B,uBAAA,IAAI,MAAiB,IAAI,mCAAA,CAAC;IAC5B,CAAC;;
|
|
1
|
+
{"version":3,"file":"Slip44Service.mjs","sourceRoot":"","sources":["../../src/services/Slip44Service.ts"],"names":[],"mappings":"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","sourcesContent":["import { fetchWithErrorHandling } from '@metamask/controller-utils';\n// @ts-expect-error: No type definitions for '@metamask/slip44'\nimport slip44 from '@metamask/slip44';\n\nconst CHAINID_NETWORK_URL = 'https://chainid.network/chains.json';\n\n/**\n * Represents a single SLIP-44 entry with its metadata.\n */\nexport type Slip44Entry = {\n index: string;\n symbol: string;\n name: string;\n};\n\n/**\n * Chain data from chainid.network\n */\ntype ChainIdNetworkEntry = {\n chainId: number;\n slip44?: number;\n nativeCurrency?: {\n symbol: string;\n };\n};\n\n/**\n * Internal type for SLIP-44 data from the @metamask/slip44 package.\n * Includes the hex field which we don't expose externally.\n */\ntype Slip44DataEntry = Slip44Entry & {\n // eslint-disable-next-line id-denylist\n hex: `0x${string}`;\n};\n\n/**\n * The SLIP-44 mapping type from the @metamask/slip44 package.\n */\ntype Slip44Data = Record<string, Slip44DataEntry>;\n\n/**\n * Service for looking up SLIP-44 coin type identifiers.\n *\n * SLIP-44 defines registered coin types used in BIP-44 derivation paths.\n *\n * This service provides two lookup methods:\n * 1. `getEvmSlip44` - For EVM networks, uses chainid.network data (recommended for eip155)\n * 2. `getSlip44BySymbol` - Fallback method using @metamask/slip44 package\n *\n * @see https://github.com/satoshilabs/slips/blob/master/slip-0044.md\n * @see https://chainid.network/chains.json\n */\n/**\n * Manual overrides for EVM chain IDs where chainid.network returns\n * an incorrect SLIP-44 value due to chain ID collisions.\n */\nconst EVM_SLIP44_OVERRIDES: ReadonlyMap<number, number> = new Map([\n [999, 2457], // HyperEVM — chainid.network returns 1 (Wanchain collision)\n]);\n\nexport class Slip44Service {\n /**\n * Cache for chainId to slip44 lookups from chainid.network.\n */\n static #chainIdCache: Map<number, number> | null = null;\n\n /**\n * Whether a fetch is currently in progress.\n */\n static #fetchPromise: Promise<void> | null = null;\n\n /**\n * Cache for symbol to slip44 index lookups.\n * This avoids iterating through all entries on repeated lookups.\n */\n static readonly #symbolCache: Map<string, number | undefined> = new Map();\n\n /**\n * Fetches and caches chain data from chainid.network.\n * This is called automatically by getEvmSlip44.\n */\n static async #fetchChainData(): Promise<void> {\n if (this.#chainIdCache !== null) {\n return;\n }\n\n // Avoid duplicate fetches\n if (this.#fetchPromise) {\n await this.#fetchPromise;\n return;\n }\n\n this.#fetchPromise = (async (): Promise<void> => {\n try {\n const chains: ChainIdNetworkEntry[] | undefined =\n await fetchWithErrorHandling({\n url: CHAINID_NETWORK_URL,\n timeout: 10000,\n });\n\n if (chains && Array.isArray(chains)) {\n this.#chainIdCache = new Map(\n chains\n .filter(\n (chain): chain is ChainIdNetworkEntry & { slip44: number } =>\n chain.slip44 !== undefined,\n )\n .map((chain) => [chain.chainId, chain.slip44]),\n );\n } else {\n // Invalid response, initialize empty cache\n this.#chainIdCache = new Map();\n }\n } catch {\n // Network failed, initialize empty cache so we fall back to symbol lookup\n this.#chainIdCache = new Map();\n }\n })();\n\n await this.#fetchPromise;\n this.#fetchPromise = null;\n }\n\n /**\n * Gets the SLIP-44 coin type identifier for an EVM network by chain ID.\n *\n * **IMPORTANT: This method is for EVM networks only (eip155 namespace).**\n * For non-EVM networks (Bitcoin, Solana, Tron, etc.), use `getSlip44BySymbol`.\n *\n * This method checks chainid.network data (which maps chainId directly\n * to slip44). If not found, defaults to 60 (Ethereum).\n *\n * @param chainId - The EVM chain ID as a number (e.g., 1 for Ethereum, 56 for BNB Chain)\n * @returns The SLIP-44 coin type number (defaults to 60 if not found)\n * @example\n * ```typescript\n * // For EVM networks only\n * const ethCoinType = await Slip44Service.getEvmSlip44(1);\n * // Returns 60\n *\n * const bnbCoinType = await Slip44Service.getEvmSlip44(56);\n * // Returns 714\n *\n * const unknownEvmChain = await Slip44Service.getEvmSlip44(99999);\n * // Returns 60 (default for EVM)\n * ```\n */\n static async getEvmSlip44(chainId: number): Promise<number> {\n const override = EVM_SLIP44_OVERRIDES.get(chainId);\n if (override !== undefined) {\n return override;\n }\n\n // Ensure chain data is loaded\n await this.#fetchChainData();\n\n // Check chainId cache first\n const cached = this.#chainIdCache?.get(chainId);\n if (cached !== undefined) {\n return cached;\n }\n\n // Default to 60 (Ethereum) for EVM networks without specific mapping\n return 60;\n }\n\n /**\n * Gets the SLIP-44 coin type identifier for a non-EVM network by symbol.\n *\n * **IMPORTANT: This method is for non-EVM networks only (Bitcoin, Solana, Tron, etc.).**\n * For EVM networks (eip155 namespace), use `getEvmSlip44` instead.\n *\n * Note: Symbol lookup may return incorrect results for duplicate symbols\n * (e.g., CPC is both CPChain and Capricoin).\n *\n * @param symbol - The network symbol (e.g., 'ETH', 'BTC', 'SOL')\n * @returns The SLIP-44 coin type number, or undefined if not found\n * @example\n * ```typescript\n * const ethCoinType = Slip44Service.getSlip44BySymbol('ETH');\n * // Returns 60\n *\n * const btcCoinType = Slip44Service.getSlip44BySymbol('BTC');\n * // Returns 0\n * ```\n */\n static getSlip44BySymbol(symbol: string): number | undefined {\n // Check cache first\n if (this.#symbolCache.has(symbol)) {\n return this.#symbolCache.get(symbol);\n }\n\n const slip44Data = slip44 as Slip44Data;\n const upperSymbol = symbol.toUpperCase();\n\n // Iterate through all entries to find matching symbol\n // Note: Object.keys returns numeric keys in ascending order,\n // so for duplicate symbols we get the lowest coin type first\n // (which is the convention for resolving duplicates)\n for (const key of Object.keys(slip44Data)) {\n const entry = slip44Data[key];\n if (entry.symbol.toUpperCase() === upperSymbol) {\n const coinType = parseInt(key, 10);\n this.#symbolCache.set(symbol, coinType);\n return coinType;\n }\n }\n\n // Cache the miss as well to avoid repeated lookups\n this.#symbolCache.set(symbol, undefined);\n return undefined;\n }\n\n /**\n * Clears all internal caches.\n * Useful for testing or if the underlying data might change.\n */\n static clearCache(): void {\n this.#symbolCache.clear();\n this.#chainIdCache = null;\n this.#fetchPromise = null;\n }\n}\n"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@metamask-previews/network-enablement-controller",
|
|
3
|
-
"version": "4.1.0-preview-
|
|
3
|
+
"version": "4.1.0-preview-bbc71c9d5",
|
|
4
4
|
"description": "Provides an interface to the currently enabled network using a MetaMask-compatible provider object",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"MetaMask",
|
|
@@ -65,7 +65,6 @@
|
|
|
65
65
|
"@types/jest": "^29.5.14",
|
|
66
66
|
"deepmerge": "^4.2.2",
|
|
67
67
|
"jest": "^29.7.0",
|
|
68
|
-
"sinon": "^9.2.4",
|
|
69
68
|
"ts-jest": "^29.2.5",
|
|
70
69
|
"typedoc": "^0.25.13",
|
|
71
70
|
"typedoc-plugin-missing-exports": "^2.0.0",
|