@shapeshiftoss/caip 8.16.4 → 8.16.5

package/dist/cjs/assetId/assetId.d.ts

@@ -0,0 +1,36 @@
+import type { ChainId, ChainNamespace, ChainReference } from '../chainId/chainId';
+import type { ASSET_NAMESPACE, ASSET_REFERENCE } from '../constants';
+import type { Nominal } from '../utils';
+export type AssetId = Nominal<string, 'AssetId'>;
+export type AssetNamespace = (typeof ASSET_NAMESPACE)[keyof typeof ASSET_NAMESPACE];
+export type AssetReference = (typeof ASSET_REFERENCE)[keyof typeof ASSET_REFERENCE];
+type ToAssetIdWithChainId = {
+    chainNamespace?: never;
+    chainReference?: never;
+    chainId: ChainId;
+    assetNamespace: AssetNamespace;
+    assetReference: AssetReference | string;
+};
+type ToAssetIdWithChainIdParts = {
+    chainNamespace: ChainNamespace;
+    chainReference: ChainReference;
+    chainId?: never;
+    assetNamespace: AssetNamespace;
+    assetReference: AssetReference | string;
+};
+export type ToAssetIdArgs = ToAssetIdWithChainId | ToAssetIdWithChainIdParts;
+type ToAssetId = (args: ToAssetIdArgs) => AssetId;
+export declare const toAssetId: ToAssetId;
+type FromAssetIdReturn = {
+    chainNamespace: ChainNamespace;
+    chainReference: ChainReference;
+    chainId: ChainId;
+    assetNamespace: AssetNamespace;
+    assetReference: AssetReference;
+};
+export type FromAssetId = (assetId: AssetId) => FromAssetIdReturn;
+export declare const fromAssetId: FromAssetId;
+export declare const isNft: (assetId: AssetId) => boolean;
+export declare const toCAIP19: ToAssetId;
+export declare const fromCAIP19: FromAssetId;
+export {};

package/dist/cjs/assetId/assetId.js

@@ -0,0 +1,120 @@
+"use strict";
+// https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-19.md
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromCAIP19 = exports.toCAIP19 = exports.isNft = exports.fromAssetId = exports.toAssetId = void 0;
+const chainId_1 = require("../chainId/chainId");
+const constants_1 = require("../constants");
+const typeGuards_1 = require("../typeGuards");
+/**
+ * validate that a value is a string slip44 value
+ * @see https://github.com/satoshilabs/slips/blob/master/slip-0044.md
+ * @param {string} value - possible slip44 value
+ */
+const isValidSlip44 = (value) => {
+    // TCY is a weird AssetId, its asset ref part is not a number
+    if (value === 'tcy')
+        return true;
+    const n = Number(value);
+    // slip44 has a max value of an unsigned 32-bit integer
+    return !isNaN(n) && n >= 0 && n < 4294967296;
+};
+const isToAssetIdWithChainIdArgs = (args) => !!args.chainId;
+const toAssetId = (args) => {
+    const { assetNamespace, assetReference } = args;
+    (0, typeGuards_1.assertIsAssetNamespace)(assetNamespace);
+    if (!assetReference)
+        throw new Error('toAssetId: No assetReference provided');
+    const { chainId, chainNamespace, chainReference } = (() => {
+        if (isToAssetIdWithChainIdArgs(args)) {
+            const fromChainIdResult = (0, chainId_1.fromChainId)(args.chainId);
+            return {
+                chainId: args.chainId,
+                chainNamespace: fromChainIdResult.chainNamespace,
+                chainReference: fromChainIdResult.chainReference,
+            };
+        }
+        else
+            return {
+                chainId: (0, chainId_1.toChainId)({
+                    chainNamespace: args.chainNamespace,
+                    chainReference: args.chainReference,
+                }),
+                chainNamespace: args.chainNamespace,
+                chainReference: args.chainReference,
+            };
+    })();
+    (0, typeGuards_1.assertIsChainNamespace)(chainNamespace);
+    (0, typeGuards_1.assertIsChainReference)(chainReference);
+    (0, typeGuards_1.assertValidChainPartsPair)(chainNamespace, chainReference);
+    if (!constants_1.VALID_ASSET_NAMESPACE[chainNamespace].includes(assetNamespace) ||
+        !(0, typeGuards_1.isAssetNamespace)(assetNamespace))
+        throw new Error(`toAssetId: AssetNamespace ${assetNamespace} not supported for Chain Namespace ${chainNamespace}`);
+    if (assetNamespace === 'slip44' && !isValidSlip44(String(assetReference))) {
+        throw new Error(`Invalid reference for namespace slip44`);
+    }
+    const assetReferenceNormalized = (() => {
+        const assertContractAddress = (address) => {
+            if (!address.startsWith('0x'))
+                throw new Error(`toAssetId: assetReference must start with 0x: ${assetReference}`);
+            if (address.length !== 42)
+                throw new Error(`toAssetId: assetReference length must be 42, length: ${assetReference.length}, ${assetReference}`);
+        };
+        switch (assetNamespace) {
+            case 'erc20':
+                assertContractAddress(assetReference);
+                return assetReference.toLowerCase();
+            case 'erc721':
+            case 'erc1155':
+                // caip-22 (https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-22.md)
+                // caip-29 (https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-29.md)
+                const [address] = assetReference.split('/');
+                assertContractAddress(address);
+                return assetReference.toLowerCase();
+            default:
+                return assetReference;
+        }
+    })();
+    return `${chainId}/${assetNamespace}:${assetReferenceNormalized}`;
+};
+exports.toAssetId = toAssetId;
+// NOTE: perf critical - benchmark any changes
+const fromAssetId = (assetId) => {
+    const slashIdx = assetId.indexOf('/');
+    const chainId = assetId.substring(0, slashIdx);
+    const assetParts = assetId.substring(slashIdx + 1);
+    const { chainNamespace, chainReference } = (0, chainId_1.fromChainId)(chainId);
+    const idx = assetParts.indexOf(':');
+    const assetNamespace = assetParts.substring(0, idx);
+    const assetReference = assetParts.substring(idx + 1);
+    if (!(0, typeGuards_1.isAssetIdParts)(chainNamespace, chainReference, assetNamespace))
+        throw new Error(`fromAssetId: invalid AssetId: ${assetId}`);
+    const assetReferenceNormalized = (() => {
+        switch (assetNamespace) {
+            case 'erc20':
+            case 'erc721':
+            case 'erc1155':
+                return assetReference.toLowerCase();
+            default:
+                return assetReference;
+        }
+    })();
+    return {
+        chainId,
+        chainNamespace: chainNamespace,
+        chainReference: chainReference,
+        assetNamespace: assetNamespace,
+        assetReference: assetReferenceNormalized,
+    };
+};
+exports.fromAssetId = fromAssetId;
+// NOTE: perf critical - benchmark any changes
+const isNft = (assetId) => {
+    const slashIdx = assetId.indexOf('/');
+    const assetParts = assetId.substring(slashIdx + 1);
+    const idx = assetParts.indexOf(':');
+    const assetNamespace = assetParts.substring(0, idx);
+    return ['erc721', 'erc1155'].includes(assetNamespace);
+};
+exports.isNft = isNft;
+exports.toCAIP19 = exports.toAssetId;
+exports.fromCAIP19 = exports.fromAssetId;

package/dist/cjs/assetId/assetId.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/assetId/assetId.test.js

@@ -0,0 +1,324 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const lodash_1 = require("lodash");
+const vitest_1 = require("vitest");
+const chainId_1 = require("../chainId/chainId");
+const constants_1 = require("../constants");
+const assetId_1 = require("./assetId");
+(0, vitest_1.describe)('assetId', () => {
+    (0, vitest_1.it)('should have matching CAIP19 aliases', () => {
+        (0, vitest_1.expect)(assetId_1.toAssetId).toEqual(assetId_1.toCAIP19);
+        (0, vitest_1.expect)(assetId_1.fromAssetId).toEqual(assetId_1.fromCAIP19);
+    });
+    (0, vitest_1.describe)('toAssetId', () => {
+        (0, vitest_1.describe)('toAssetId(fromAssetId())', () => {
+            vitest_1.it.each([
+                ['eip155:1/slip44:60'],
+                ['eip155:1/erc20:0xc770eefad204b5180df6a14ee197d99d808ee52d'],
+                ['bip122:000000000019d6689c085ae165831e93/slip44:0'],
+                ['cosmos:cosmoshub-4/slip44:118'],
+                ['cosmos:thorchain-1/slip44:tcy'],
+            ])('returns an AssetId from the result of fromAssetId for %s', assetId => {
+                const result = (0, assetId_1.fromAssetId)(assetId);
+                (0, vitest_1.expect)((0, assetId_1.toAssetId)((0, lodash_1.omit)(result, 'chainId'))).toBe(assetId);
+                (0, vitest_1.expect)((0, assetId_1.toAssetId)((0, lodash_1.omit)(result, ['chainNamespace', 'chainReference']))).toBe(assetId);
+            });
+        });
+        (0, vitest_1.it)('can make eth AssetId on mainnet', () => {
+            const chainNamespace = constants_1.CHAIN_NAMESPACE.Evm;
+            const chainReference = constants_1.CHAIN_REFERENCE.EthereumMainnet;
+            const assetIdArgSuperset = {
+                chainNamespace,
+                chainReference,
+                assetNamespace: 'slip44',
+                assetReference: constants_1.ASSET_REFERENCE.Ethereum,
+                chainId: (0, chainId_1.toChainId)({ chainNamespace, chainReference }),
+            };
+            const expected = 'eip155:1/slip44:60';
+            (0, vitest_1.expect)((0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, 'chainId'))).toEqual(expected);
+            (0, vitest_1.expect)((0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, ['chainNamespace', 'chainReference']))).toEqual(expected);
+        });
+        (0, vitest_1.it)('throws with invalid eth network', () => {
+            const chainNamespace = constants_1.CHAIN_NAMESPACE.Evm;
+            const chainReference = constants_1.CHAIN_REFERENCE.CosmosHubMainnet;
+            const assetIdArgSuperset = {
+                chainNamespace,
+                chainReference,
+                assetNamespace: 'slip44',
+                assetReference: constants_1.ASSET_REFERENCE.Ethereum,
+                chainId: `${chainNamespace}:${chainReference}`,
+            };
+            (0, vitest_1.expect)(() => (0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, 'chainId'))).toThrow();
+            (0, vitest_1.expect)(() => (0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, ['chainNamespace', 'chainReference']))).toThrow();
+        });
+        (0, vitest_1.it)('throws with invalid namespace', () => {
+            const chainNamespace = constants_1.CHAIN_NAMESPACE.Evm;
+            const chainReference = constants_1.CHAIN_REFERENCE.EthereumMainnet;
+            const assetIdArgSuperset = {
+                chainNamespace,
+                chainReference,
+                assetNamespace: 'bad',
+                assetReference: constants_1.ASSET_REFERENCE.Ethereum,
+                chainId: `${chainNamespace}:${chainReference}`,
+            };
+            (0, vitest_1.expect)(() => (0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, 'chainId'))).toThrow();
+            (0, vitest_1.expect)(() => (0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, ['chainNamespace', 'chainReference']))).toThrow();
+        });
+        (0, vitest_1.it)('can make Cosmos AssetId on CosmosHub mainnet', () => {
+            const chainNamespace = constants_1.CHAIN_NAMESPACE.CosmosSdk;
+            const chainReference = constants_1.CHAIN_REFERENCE.CosmosHubMainnet;
+            const assetIdArgSuperset = {
+                chainNamespace,
+                chainReference,
+                assetNamespace: 'slip44',
+                assetReference: constants_1.ASSET_REFERENCE.Cosmos,
+                chainId: (0, chainId_1.toChainId)({ chainNamespace, chainReference }),
+            };
+            const expected = 'cosmos:cosmoshub-4/slip44:118';
+            (0, vitest_1.expect)((0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, 'chainId'))).toEqual(expected);
+            (0, vitest_1.expect)((0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, ['chainNamespace', 'chainReference']))).toEqual(expected);
+        });
+        (0, vitest_1.it)('throws with invalid Cosmos network', () => {
+            const chainNamespace = constants_1.CHAIN_NAMESPACE.CosmosSdk;
+            const chainReference = constants_1.CHAIN_REFERENCE.BitcoinMainnet;
+            const assetIdArgSuperset = {
+                chainNamespace,
+                chainReference,
+                assetNamespace: 'slip44',
+                assetReference: constants_1.ASSET_REFERENCE.Cosmos,
+                chainId: `${chainNamespace}:${chainReference}`,
+            };
+            (0, vitest_1.expect)(() => (0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, 'chainId'))).toThrow();
+            (0, vitest_1.expect)(() => (0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, ['chainNamespace', 'chainReference']))).toThrow();
+        });
+        (0, vitest_1.it)('throws with invalid Cosmos slip44 reference', () => {
+            const chainNamespace = constants_1.CHAIN_NAMESPACE.CosmosSdk;
+            const chainReference = constants_1.CHAIN_REFERENCE.CosmosHubMainnet;
+            const assetIdArgSuperset = {
+                chainNamespace,
+                chainReference,
+                assetNamespace: 'slip44',
+                assetReference: 'bad',
+                chainId: `${chainNamespace}:${chainReference}`,
+            };
+            (0, vitest_1.expect)(() => (0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, 'chainId'))).toThrow();
+            (0, vitest_1.expect)(() => (0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, ['chainNamespace', 'chainReference']))).toThrow();
+        });
+        (0, vitest_1.it)('throws with invalid btc network', () => {
+            const chainNamespace = constants_1.CHAIN_NAMESPACE.Utxo;
+            const chainReference = constants_1.CHAIN_REFERENCE.EthereumMainnet;
+            const assetIdArgSuperset = {
+                chainNamespace,
+                chainReference,
+                assetNamespace: 'slip44',
+                assetReference: constants_1.ASSET_REFERENCE.Bitcoin,
+                chainId: `${chainNamespace}:${chainReference}`,
+            };
+            (0, vitest_1.expect)(() => (0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, 'chainId'))).toThrow();
+            (0, vitest_1.expect)(() => (0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, ['chainNamespace', 'chainReference']))).toThrow();
+        });
+        (0, vitest_1.it)('can make FOX AssetId on mainnet', () => {
+            const chainNamespace = constants_1.CHAIN_NAMESPACE.Evm;
+            const chainReference = constants_1.CHAIN_REFERENCE.EthereumMainnet;
+            const assetIdArgSuperset = {
+                chainNamespace,
+                chainReference,
+                assetNamespace: 'erc20',
+                assetReference: '0xc770eefad204b5180df6a14ee197d99d808ee52d',
+                chainId: `${chainNamespace}:${chainReference}`,
+            };
+            const expected = 'eip155:1/erc20:0xc770eefad204b5180df6a14ee197d99d808ee52d';
+            (0, vitest_1.expect)((0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, 'chainId'))).toEqual(expected);
+            (0, vitest_1.expect)((0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, ['chainNamespace', 'chainReference']))).toEqual(expected);
+        });
+        (0, vitest_1.it)('should lower case ERC20 asset references', () => {
+            const chainNamespace = constants_1.CHAIN_NAMESPACE.Evm;
+            const chainReference = constants_1.CHAIN_REFERENCE.EthereumMainnet;
+            const assetIdArgSuperset = {
+                chainNamespace,
+                chainReference,
+                assetNamespace: 'erc20',
+                assetReference: '0xc770EEfAd204B5180dF6a14Ee197D99d808ee52d',
+                chainId: `${chainNamespace}:${chainReference}`,
+            };
+            const expected = 'eip155:1/erc20:0xc770eefad204b5180df6a14ee197d99d808ee52d';
+            (0, vitest_1.expect)((0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, 'chainId'))).toEqual(expected);
+            (0, vitest_1.expect)((0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, ['chainNamespace', 'chainReference']))).toEqual(expected);
+        });
+        (0, vitest_1.it)('should lower case ERC721 asset references', () => {
+            const chainNamespace = constants_1.CHAIN_NAMESPACE.Evm;
+            const chainReference = constants_1.CHAIN_REFERENCE.EthereumMainnet;
+            const assetIdArgSuperset = {
+                chainNamespace,
+                chainReference,
+                assetNamespace: 'erc721',
+                assetReference: '0xc770EEfAd204B5180dF6a14Ee197D99d808ee52d/12345',
+                chainId: `${chainNamespace}:${chainReference}`,
+            };
+            const expected = 'eip155:1/erc721:0xc770eefad204b5180df6a14ee197d99d808ee52d/12345';
+            (0, vitest_1.expect)((0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, 'chainId'))).toEqual(expected);
+            (0, vitest_1.expect)((0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, ['chainNamespace', 'chainReference']))).toEqual(expected);
+        });
+        (0, vitest_1.it)('throws with invalid assetReference length', () => {
+            const chainNamespace = constants_1.CHAIN_NAMESPACE.Evm;
+            const chainReference = constants_1.CHAIN_REFERENCE.EthereumMainnet;
+            const assetIdArgSuperset = {
+                chainNamespace,
+                chainReference,
+                assetNamespace: 'erc20',
+                assetReference: '0xfoo',
+                chainId: `${chainNamespace}:${chainReference}`,
+            };
+            (0, vitest_1.expect)(() => (0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, 'chainId'))).toThrow();
+            (0, vitest_1.expect)(() => (0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, ['chainNamespace', 'chainReference']))).toThrow();
+        });
+        (0, vitest_1.it)('throws with no assetReference string', () => {
+            const chainNamespace = constants_1.CHAIN_NAMESPACE.Evm;
+            const chainReference = constants_1.CHAIN_REFERENCE.EthereumMainnet;
+            const assetIdArgSuperset = {
+                chainNamespace,
+                chainReference,
+                assetNamespace: 'erc20',
+                assetReference: '',
+                chainId: `${chainNamespace}:${chainReference}`,
+            };
+            (0, vitest_1.expect)(() => (0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, 'chainId'))).toThrow();
+            (0, vitest_1.expect)(() => (0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, ['chainNamespace', 'chainReference']))).toThrow();
+        });
+        (0, vitest_1.it)('throws with invalid assetReference string', () => {
+            const chainNamespace = constants_1.CHAIN_NAMESPACE.Evm;
+            const chainReference = constants_1.CHAIN_REFERENCE.EthereumMainnet;
+            const assetIdArgSuperset = {
+                chainNamespace,
+                chainReference,
+                assetNamespace: 'erc20',
+                assetReference: 'gm',
+                chainId: `${chainNamespace}:${chainReference}`,
+            };
+            (0, vitest_1.expect)(() => (0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, 'chainId'))).toThrow();
+            (0, vitest_1.expect)(() => (0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, ['chainNamespace', 'chainReference']))).toThrow();
+        });
+        (0, vitest_1.it)('throws if no asset namespace provided', () => {
+            const chainNamespace = constants_1.CHAIN_NAMESPACE.Evm;
+            const chainReference = constants_1.CHAIN_REFERENCE.EthereumMainnet;
+            const assetIdArgSuperset = {
+                chainNamespace,
+                chainReference,
+                assetNamespace: '',
+                assetReference: '0xdef1cafe',
+                chainId: `${chainNamespace}:${chainReference}`,
+            };
+            (0, vitest_1.expect)(() => (0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, 'chainId'))).toThrow();
+            (0, vitest_1.expect)(() => (0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, ['chainNamespace', 'chainReference']))).toThrow();
+        });
+        (0, vitest_1.it)('can make bitcoin AssetId on mainnet', () => {
+            const chainNamespace = constants_1.CHAIN_NAMESPACE.Utxo;
+            const chainReference = constants_1.CHAIN_REFERENCE.BitcoinMainnet;
+            const assetIdArgSuperset = {
+                chainNamespace,
+                chainReference,
+                assetNamespace: 'slip44',
+                assetReference: constants_1.ASSET_REFERENCE.Bitcoin,
+                chainId: `${chainNamespace}:${chainReference}`,
+            };
+            const expected = 'bip122:000000000019d6689c085ae165831e93/slip44:0';
+            (0, vitest_1.expect)((0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, 'chainId'))).toEqual(expected);
+            (0, vitest_1.expect)((0, assetId_1.toAssetId)((0, lodash_1.omit)(assetIdArgSuperset, ['chainNamespace', 'chainReference']))).toEqual(expected);
+        });
+    });
+    (0, vitest_1.describe)('fromAssetId', () => {
+        (0, vitest_1.describe)('fromAssetId(toAssetId())', () => {
+            const slip44 = 'slip44';
+            const erc20 = 'erc20';
+            vitest_1.it.each([
+                [constants_1.CHAIN_NAMESPACE.Utxo, constants_1.CHAIN_REFERENCE.BitcoinMainnet, slip44, constants_1.ASSET_REFERENCE.Bitcoin],
+                [constants_1.CHAIN_NAMESPACE.Evm, constants_1.CHAIN_REFERENCE.EthereumMainnet, slip44, constants_1.ASSET_REFERENCE.Ethereum],
+                [
+                    constants_1.CHAIN_NAMESPACE.Evm,
+                    constants_1.CHAIN_REFERENCE.EthereumMainnet,
+                    erc20,
+                    '0xc770eefad204b5180df6a14ee197d99d808ee52d',
+                ],
+                [
+                    constants_1.CHAIN_NAMESPACE.CosmosSdk,
+                    constants_1.CHAIN_REFERENCE.CosmosHubMainnet,
+                    slip44,
+                    constants_1.ASSET_REFERENCE.Cosmos,
+                ],
+            ])('returns a AssetId from the result of fromAssetId for %s', (chainNamespace, chainReference, assetNamespace, assetReference) => {
+                (0, vitest_1.expect)((0, assetId_1.fromAssetId)((0, assetId_1.toAssetId)({ chainNamespace, chainReference, assetNamespace, assetReference }))).toStrictEqual({
+                    chainNamespace,
+                    chainReference,
+                    assetReference,
+                    assetNamespace,
+                    chainId: (0, chainId_1.toChainId)({ chainNamespace, chainReference }),
+                });
+            });
+        });
+        (0, vitest_1.it)('can return chain, network from eth AssetId on mainnet', () => {
+            const AssetId = 'eip155:1/slip44:60';
+            const { chainId, chainReference, chainNamespace, assetNamespace, assetReference } = (0, assetId_1.fromAssetId)(AssetId);
+            (0, vitest_1.expect)(chainNamespace).toEqual(constants_1.CHAIN_NAMESPACE.Evm);
+            (0, vitest_1.expect)(chainReference).toEqual(constants_1.CHAIN_REFERENCE.EthereumMainnet);
+            (0, vitest_1.expect)(chainId).toEqual((0, chainId_1.toChainId)({ chainNamespace, chainReference }));
+            (0, vitest_1.expect)(assetNamespace).toEqual('slip44');
+            (0, vitest_1.expect)(assetReference).toEqual(constants_1.ASSET_REFERENCE.Ethereum);
+        });
+        (0, vitest_1.it)('can return chain, network from bitcoin AssetId on mainnet', () => {
+            const AssetId = 'bip122:000000000019d6689c085ae165831e93/slip44:0';
+            const { chainId, chainReference, chainNamespace, assetNamespace, assetReference } = (0, assetId_1.fromAssetId)(AssetId);
+            (0, vitest_1.expect)(chainNamespace).toEqual(constants_1.CHAIN_NAMESPACE.Utxo);
+            (0, vitest_1.expect)(chainReference).toEqual(constants_1.CHAIN_REFERENCE.BitcoinMainnet);
+            (0, vitest_1.expect)(chainId).toEqual((0, chainId_1.toChainId)({ chainNamespace, chainReference }));
+            (0, vitest_1.expect)(assetNamespace).toEqual('slip44');
+            (0, vitest_1.expect)(assetReference).toEqual(constants_1.ASSET_REFERENCE.Bitcoin);
+        });
+        (0, vitest_1.it)('can return chainId, chainReference, chainNamespace, assetNamespace, assetReference from FOX AssetId on mainnet', () => {
+            const AssetId = 'eip155:1/erc20:0xc770eefad204b5180df6a14ee197d99d808ee52d';
+            const { chainId, chainReference, chainNamespace, assetNamespace, assetReference } = (0, assetId_1.fromAssetId)(AssetId);
+            (0, vitest_1.expect)(chainNamespace).toEqual(constants_1.CHAIN_NAMESPACE.Evm);
+            (0, vitest_1.expect)(chainReference).toEqual(constants_1.CHAIN_REFERENCE.EthereumMainnet);
+            (0, vitest_1.expect)(chainId).toEqual((0, chainId_1.toChainId)({ chainNamespace, chainReference }));
+            (0, vitest_1.expect)(assetNamespace).toEqual('erc20');
+            (0, vitest_1.expect)(assetReference).toEqual('0xc770eefad204b5180df6a14ee197d99d808ee52d');
+        });
+        (0, vitest_1.it)('should lower case assetReference for assetNamespace ERC20', () => {
+            const AssetId = 'eip155:1/erc20:0xc770EEfAd204B5180dF6a14Ee197D99d808ee52d';
+            const { chainId, chainReference, chainNamespace, assetNamespace, assetReference } = (0, assetId_1.fromAssetId)(AssetId);
+            (0, vitest_1.expect)(chainNamespace).toEqual(constants_1.CHAIN_NAMESPACE.Evm);
+            (0, vitest_1.expect)(chainReference).toEqual(constants_1.CHAIN_REFERENCE.EthereumMainnet);
+            (0, vitest_1.expect)(chainId).toEqual((0, chainId_1.toChainId)({ chainNamespace, chainReference }));
+            (0, vitest_1.expect)(assetNamespace).toEqual('erc20');
+            (0, vitest_1.expect)(assetReference).toEqual('0xc770eefad204b5180df6a14ee197d99d808ee52d');
+        });
+        (0, vitest_1.it)('should lower case assetReference for assetNamespace ERC721', () => {
+            const AssetId = 'eip155:1/erc721:0xc770EEfAd204B5180dF6a14Ee197D99d808ee52d/12345';
+            const { chainId, chainReference, chainNamespace, assetNamespace, assetReference } = (0, assetId_1.fromAssetId)(AssetId);
+            (0, vitest_1.expect)(chainNamespace).toEqual(constants_1.CHAIN_NAMESPACE.Evm);
+            (0, vitest_1.expect)(chainReference).toEqual(constants_1.CHAIN_REFERENCE.EthereumMainnet);
+            (0, vitest_1.expect)(chainId).toEqual((0, chainId_1.toChainId)({ chainNamespace, chainReference }));
+            (0, vitest_1.expect)(assetNamespace).toEqual('erc721');
+            const [address, id] = assetReference.split('/');
+            (0, vitest_1.expect)(address).toEqual('0xc770eefad204b5180df6a14ee197d99d808ee52d');
+            (0, vitest_1.expect)(id).toEqual('12345');
+        });
+        (0, vitest_1.it)('can parse a cosmoshub native token', () => {
+            const AssetId = 'cosmos:cosmoshub-4/slip44:118';
+            const { chainId, chainReference, chainNamespace, assetNamespace, assetReference } = (0, assetId_1.fromAssetId)(AssetId);
+            (0, vitest_1.expect)(chainNamespace).toEqual(constants_1.CHAIN_NAMESPACE.CosmosSdk);
+            (0, vitest_1.expect)(chainReference).toEqual(constants_1.CHAIN_REFERENCE.CosmosHubMainnet);
+            (0, vitest_1.expect)(chainId).toEqual((0, chainId_1.toChainId)({ chainNamespace, chainReference }));
+            (0, vitest_1.expect)(assetNamespace).toEqual('slip44');
+            (0, vitest_1.expect)(assetReference).toEqual(constants_1.ASSET_REFERENCE.Cosmos);
+        });
+        (0, vitest_1.it)('errors for an invalid AssetId format', () => {
+            (0, vitest_1.expect)(() => (0, assetId_1.fromAssetId)('invalid')).toThrow();
+        });
+        (0, vitest_1.it)('errors for invalid ChainNamespace', () => {
+            (0, vitest_1.expect)(() => (0, assetId_1.fromAssetId)('invalid:cosmoshub-4/slip44:118')).toThrow();
+        });
+        (0, vitest_1.it)('errors for invalid ChainReference type', () => {
+            (0, vitest_1.expect)(() => (0, assetId_1.fromAssetId)('cosmos:invalid/slip44:118')).toThrow();
+        });
+    });
+});

package/dist/cjs/chainId/chainId.d.ts

@@ -0,0 +1,20 @@
+import type { CHAIN_NAMESPACE, CHAIN_REFERENCE } from '../constants';
+import type { Nominal } from '../utils';
+export type ChainId = Nominal<string, 'ChainId'>;
+export type ChainNamespace = (typeof CHAIN_NAMESPACE)[keyof typeof CHAIN_NAMESPACE];
+export type ChainReference = (typeof CHAIN_REFERENCE)[keyof typeof CHAIN_REFERENCE];
+type ToChainIdArgs = {
+    chainNamespace: ChainNamespace;
+    chainReference: ChainReference;
+};
+export declare const toChainId: (args: ToChainIdArgs) => ChainId;
+export declare const fromChainId: (chainId: ChainId) => {
+    chainNamespace: ChainNamespace;
+    chainReference: ChainReference;
+};
+export declare const toCAIP2: (args: ToChainIdArgs) => ChainId;
+export declare const fromCAIP2: (chainId: ChainId) => {
+    chainNamespace: ChainNamespace;
+    chainReference: ChainReference;
+};
+export {};

package/dist/cjs/chainId/chainId.js

@@ -0,0 +1,25 @@
+"use strict";
+// https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-2.md
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromCAIP2 = exports.toCAIP2 = exports.fromChainId = exports.toChainId = void 0;
+const typeGuards_1 = require("../typeGuards");
+const toChainId = (args) => {
+    const { chainNamespace, chainReference } = args;
+    const maybeChainId = `${chainNamespace}:${chainReference}`;
+    (0, typeGuards_1.assertIsChainId)(maybeChainId);
+    return maybeChainId;
+};
+exports.toChainId = toChainId;
+// NOTE: perf critical - benchmark any changes
+const fromChainId = (chainId) => {
+    const idx = chainId.indexOf(':');
+    const chainNamespace = chainId.substring(0, idx);
+    const chainReference = chainId.substring(idx + 1);
+    return {
+        chainNamespace: chainNamespace,
+        chainReference: chainReference,
+    };
+};
+exports.fromChainId = fromChainId;
+exports.toCAIP2 = exports.toChainId;
+exports.fromCAIP2 = exports.fromChainId;

package/dist/cjs/chainId/chainId.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/chainId/chainId.test.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const constants_1 = require("../constants");
+const typeGuards_1 = require("../typeGuards");
+const chainId_1 = require("./chainId");
+(0, vitest_1.describe)('chainId', () => {
+    (0, vitest_1.it)('should have matching CAIP2 aliases', () => {
+        (0, vitest_1.expect)(chainId_1.toChainId).toEqual(chainId_1.toCAIP2);
+        (0, vitest_1.expect)(chainId_1.fromChainId).toEqual(chainId_1.fromCAIP2);
+    });
+    (0, vitest_1.describe)('toChainId', () => {
+        (0, vitest_1.it)('can turn CosmosHub mainnet to ChainId', () => {
+            const chainNamespace = constants_1.CHAIN_NAMESPACE.CosmosSdk;
+            const chainReference = constants_1.CHAIN_REFERENCE.CosmosHubMainnet;
+            const result = (0, chainId_1.toChainId)({ chainNamespace, chainReference });
+            (0, vitest_1.expect)(result).toEqual('cosmos:cosmoshub-4');
+        });
+        (0, vitest_1.it)('can turn Ethereum mainnet to ChainId', () => {
+            const chainNamespace = constants_1.CHAIN_NAMESPACE.Evm;
+            const chainReference = constants_1.CHAIN_REFERENCE.EthereumMainnet;
+            const result = (0, chainId_1.toChainId)({ chainNamespace, chainReference });
+            (0, vitest_1.expect)(result).toEqual('eip155:1');
+        });
+        (0, vitest_1.it)('can turn Bitcoin mainnet to ChainId', () => {
+            const chainNamespace = constants_1.CHAIN_NAMESPACE.Utxo;
+            const chainReference = constants_1.CHAIN_REFERENCE.BitcoinMainnet;
+            const result = (0, chainId_1.toChainId)({ chainNamespace, chainReference });
+            (0, vitest_1.expect)(result).toEqual('bip122:000000000019d6689c085ae165831e93');
+        });
+        (0, vitest_1.it)('should throw an error for an invalid chain', () => {
+            // @ts-ignore
+            (0, vitest_1.expect)(() => (0, chainId_1.toChainId)({
+                chainNamespace: constants_1.CHAIN_NAMESPACE.Utxo,
+                chainReference: constants_1.CHAIN_REFERENCE.CosmosHubMainnet,
+            })).toThrow('assertIsChainId: unsupported ChainId: bip122:cosmoshub-4');
+        });
+    });
+    (0, vitest_1.describe)('fromChainId', () => {
+        (0, vitest_1.it)('can turn Bitcoin mainnet to chain and network', () => {
+            const bitcoinChainId = 'bip122:000000000019d6689c085ae165831e93';
+            const { chainNamespace, chainReference } = (0, chainId_1.fromChainId)(bitcoinChainId);
+            (0, vitest_1.expect)(chainNamespace).toEqual(constants_1.CHAIN_NAMESPACE.Utxo);
+            (0, vitest_1.expect)(chainReference).toEqual(constants_1.CHAIN_REFERENCE.BitcoinMainnet);
+        });
+        (0, vitest_1.it)('can turn CosmosHub mainnet to chain and network', () => {
+            const cosmosHubChainId = 'cosmos:cosmoshub-4';
+            const { chainNamespace, chainReference } = (0, chainId_1.fromChainId)(cosmosHubChainId);
+            (0, vitest_1.expect)(chainNamespace).toEqual(constants_1.CHAIN_NAMESPACE.CosmosSdk);
+            (0, vitest_1.expect)(chainReference).toEqual(constants_1.CHAIN_REFERENCE.CosmosHubMainnet);
+        });
+        (0, vitest_1.it)('can turn Ethereum mainnet to chain and network', () => {
+            const ethereumChainId = 'eip155:1';
+            const { chainNamespace, chainReference } = (0, chainId_1.fromChainId)(ethereumChainId);
+            (0, vitest_1.expect)(chainNamespace).toEqual(constants_1.CHAIN_NAMESPACE.Evm);
+            (0, vitest_1.expect)(chainReference).toEqual(constants_1.CHAIN_REFERENCE.EthereumMainnet);
+        });
+    });
+});
+(0, vitest_1.describe)('isChainId', () => {
+    (0, vitest_1.it)('throws on eip155 without a network reference', () => {
+        (0, vitest_1.expect)(() => (0, typeGuards_1.assertIsChainId)('eip155')).toThrow();
+    });
+    (0, vitest_1.it)('validates eip155:1 mainnet as true', () => {
+        (0, vitest_1.expect)((0, typeGuards_1.isChainId)('eip155:1')).toBe(true);
+    });
+    (0, vitest_1.it)('throws on eip155:2 unsupported network reference', () => {
+        (0, vitest_1.expect)(() => (0, typeGuards_1.assertIsChainId)('eip155:2')).toThrow();
+    });
+    (0, vitest_1.it)('validates bip122:000000000019d6689c085ae165831e93 mainnet as true', () => {
+        (0, vitest_1.expect)((0, typeGuards_1.isChainId)('bip122:000000000019d6689c085ae165831e93')).toBe(true);
+    });
+    (0, vitest_1.it)('throws on bip122 with the wrong network reference', () => {
+        (0, vitest_1.expect)(() => (0, typeGuards_1.assertIsChainId)('bip122:1')).toThrow();
+    });
+    (0, vitest_1.it)('throws on bip122', () => {
+        // missing network
+        (0, vitest_1.expect)(() => (0, typeGuards_1.assertIsChainId)('bip122')).toThrow();
+    });
+    (0, vitest_1.it)('throws on empty string', () => {
+        // missing network
+        (0, vitest_1.expect)(() => (0, typeGuards_1.assertIsChainId)('')).toThrow();
+    });
+    (0, vitest_1.it)('should return true for cosmos', () => {
+        (0, vitest_1.expect)((0, typeGuards_1.isChainId)('cosmos:cosmoshub-4')).toBe(true);
+    });
+    (0, vitest_1.it)('should throw for an unknown cosmos chain', () => {
+        (0, vitest_1.expect)(() => (0, typeGuards_1.assertIsChainId)('cosmos:fakechain-1')).toThrow('assertIsChainId: unsupported ChainId: cosmos:fakechain-1');
+    });
+});