@recoillink/sdk 0.0.0-stage → 45.0.1

package/dist/metadata/blockExplorer.js

@@ -0,0 +1,123 @@
+import { isEVMLike, strip0x } from '@recoillink/utils';
+import { ExplorerFamily } from './chainMetadataTypes.js';
+/**
+ * Converts Etherscan-like API URLs to the new V2 format
+ * @param apiUrl The original API URL
+ * @param chainId The chain ID to use for the V2 API
+ * @returns The converted V2 API URL
+ */
+// https://docs.etherscan.io/etherscan-v2/v2-quickstart
+function convertToEtherscanV2Url(apiUrl, chainId, family) {
+    // Only convert if it's an Etherscan family explorer
+    if (family === ExplorerFamily.Etherscan) {
+        // Convert to Etherscan V2 format
+        const etherscanV2Url = new URL('https://api.etherscan.io/v2/api');
+        // Add chainId parameter if provided
+        if (chainId) {
+            etherscanV2Url.searchParams.set('chainid', chainId.toString());
+        }
+        return etherscanV2Url.toString();
+    }
+    // Return original URL if not an Etherscan family
+    return apiUrl;
+}
+export function getExplorerBaseUrl(metadata, index = 0) {
+    if (!metadata?.blockExplorers?.length)
+        return null;
+    const url = new URL(metadata.blockExplorers[index].url);
+    return url.toString();
+}
+export function getExplorerApi(metadata, index = 0) {
+    const { protocol, blockExplorers } = metadata;
+    // TODO solana + cosmos support here as needed
+    if (!isEVMLike(protocol))
+        return null;
+    if (!blockExplorers?.length || !blockExplorers[index].apiUrl)
+        return null;
+    // Convert to V2 format if it's an Etherscan-like API
+    const chainId = typeof metadata.chainId === 'string'
+        ? parseInt(metadata.chainId)
+        : metadata.chainId;
+    const convertedApiUrl = convertToEtherscanV2Url(blockExplorers[index].apiUrl, chainId, blockExplorers[index].family);
+    return {
+        apiUrl: convertedApiUrl,
+        apiKey: blockExplorers[index].apiKey,
+        family: blockExplorers[index].family,
+    };
+}
+export function getExplorerApiUrl(metadata, index = 0) {
+    const explorer = getExplorerApi(metadata, index);
+    if (!explorer)
+        return null;
+    const { apiUrl, apiKey } = explorer;
+    if (!apiKey)
+        return apiUrl;
+    const url = new URL(apiUrl);
+    url.searchParams.set('apikey', apiKey);
+    return url.toString();
+}
+export function getExplorerTxUrl(metadata, hash) {
+    const baseUrl = getExplorerBaseUrl(metadata);
+    if (!baseUrl)
+        return null;
+    const chainName = metadata.name;
+    // TODO consider move handling of these chain/protocol specific quirks to ChainMetadata
+    const urlPathStub = [
+        'nautilus',
+        'proteustestnet',
+        'radix',
+        'radixtestnet',
+        'aleo',
+        'aleotestnet',
+    ].includes(chainName)
+        ? 'transaction'
+        : 'tx';
+    // TronScan uses 'transaction' instead of 'tx' for transaction URLs and doesn't support the 0x prefix for transaction hashes
+    if (metadata.blockExplorers &&
+        metadata.blockExplorers.length &&
+        metadata.blockExplorers[0].family === ExplorerFamily.TronScan) {
+        return appendToPath(baseUrl, `transaction/${strip0x(hash)}`).toString();
+    }
+    return appendToPath(baseUrl, `${urlPathStub}/${hash}`).toString();
+}
+export function getExplorerAddressUrl(metadata, address) {
+    const baseUrl = getExplorerBaseUrl(metadata);
+    if (!baseUrl)
+        return null;
+    const urlPathStub = getExplorerAddressPathStub(metadata, 0, address);
+    if (!urlPathStub)
+        return null;
+    return appendToPath(baseUrl, `${urlPathStub}/${address}`).toString();
+}
+function appendToPath(baseUrl, pathExtension) {
+    // Handle URLs with hash fragments (e.g., TronScan uses explorer.com/#/path)
+    const hashIndex = baseUrl.indexOf('#');
+    if (hashIndex !== -1) {
+        const urlPart = baseUrl.slice(0, hashIndex);
+        const hashPart = baseUrl.slice(hashIndex + 1);
+        const hashPath = hashPart.endsWith('/') ? hashPart.slice(0, -1) : hashPart;
+        return new URL(`${urlPart}#${hashPath}/${pathExtension}`);
+    }
+    const base = new URL(baseUrl);
+    let currentPath = base.pathname;
+    if (currentPath.endsWith('/'))
+        currentPath = currentPath.slice(0, -1);
+    const newPath = `${currentPath}/${pathExtension}`;
+    const newUrl = new URL(newPath, base);
+    newUrl.search = base.searchParams.toString();
+    return newUrl;
+}
+function getExplorerAddressPathStub(metadata, index = 0, address) {
+    if (!metadata?.blockExplorers?.[index])
+        return null;
+    const blockExplorer = metadata.blockExplorers[index];
+    if (blockExplorer.family === ExplorerFamily.RadixDashboard) {
+        return address?.startsWith('account') ? 'account' : 'component';
+    }
+    if (!blockExplorer.family)
+        return null;
+    return blockExplorer.family === ExplorerFamily.Voyager
+        ? 'contract'
+        : 'address';
+}
+//# sourceMappingURL=blockExplorer.js.map

package/dist/metadata/blockExplorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockExplorer.js","sourceRoot":"","sources":["../../src/metadata/blockExplorer.ts"],"names":[],"mappings":"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"}

package/dist/metadata/blockExplorer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=blockExplorer.test.d.ts.map

package/dist/metadata/blockExplorer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockExplorer.test.d.ts","sourceRoot":"","sources":["../../src/metadata/blockExplorer.test.ts"],"names":[],"mappings":""}

package/dist/metadata/blockExplorer.test.js

@@ -0,0 +1,326 @@
+import { expect } from 'chai';
+import { ProtocolType } from '@recoillink/utils';
+import { test1, testCosmosChain, testSealevelChain, testStarknetChain, } from '../consts/testChains.js';
+import { getExplorerAddressUrl, getExplorerApi, getExplorerApiUrl, getExplorerBaseUrl, getExplorerTxUrl, } from './blockExplorer.js';
+import { ExplorerFamily } from './chainMetadataTypes.js';
+const TEST_CHAINS = [
+    test1,
+    testCosmosChain,
+    testSealevelChain,
+    testStarknetChain,
+];
+const EXPECTED_RESULTS = [
+    [
+        'https://etherscan.io/',
+        'https://api.etherscan.io/v2/api?chainid=9913371&apikey=fakekey',
+        'https://etherscan.io/tx/0x123',
+        'https://etherscan.io/address/0x123',
+    ],
+    [
+        'https://www.mintscan.io/cosmos',
+        null,
+        'https://www.mintscan.io/cosmos/tx/0x123',
+        'https://www.mintscan.io/cosmos/address/0x123',
+    ],
+    [
+        'https://explorer.solana.com/?cluster=devnet',
+        null,
+        'https://explorer.solana.com/tx/0x123?cluster=devnet',
+        'https://explorer.solana.com/address/0x123?cluster=devnet',
+    ],
+    [
+        'https://sepolia.voyager.online/',
+        null,
+        'https://sepolia.voyager.online/tx/0x123',
+        'https://sepolia.voyager.online/contract/0x123',
+    ],
+];
+describe('Block explorer utils', () => {
+    TEST_CHAINS.map((chain, i) => {
+        it(`gets a base url correctly for protocol ${chain.protocol}`, () => {
+            expect(getExplorerBaseUrl(chain)).to.equal(EXPECTED_RESULTS[i][0]);
+        });
+        it(`gets an api url for protocol ${chain.protocol}`, () => {
+            expect(getExplorerApiUrl(chain)).to.equal(EXPECTED_RESULTS[i][1]);
+        });
+        it(`gets a tx url for protocol ${chain.protocol}`, () => {
+            expect(getExplorerTxUrl(chain, '0x123')).to.equal(EXPECTED_RESULTS[i][2]);
+        });
+        it(`gets an address url for protocol ${chain.protocol}`, () => {
+            expect(getExplorerAddressUrl(chain, '0x123')).to.equal(EXPECTED_RESULTS[i][3]);
+        });
+    });
+    describe('Etherscan V2 URL conversion', () => {
+        const etherscanV1Chain = {
+            protocol: ProtocolType.Ethereum,
+            name: 'ethereum',
+            chainId: 1,
+            domainId: 1,
+            rpcUrls: [{ http: 'https://ethereum.test' }],
+            blockExplorers: [
+                {
+                    name: 'Etherscan',
+                    url: 'https://etherscan.io',
+                    apiUrl: 'https://api.etherscan.io/api',
+                    apiKey: 'testkey',
+                    family: ExplorerFamily.Etherscan,
+                },
+            ],
+        };
+        const polygonScanChain = {
+            protocol: ProtocolType.Ethereum,
+            name: 'polygon',
+            chainId: 137,
+            domainId: 137,
+            rpcUrls: [{ http: 'https://polygon.test' }],
+            blockExplorers: [
+                {
+                    name: 'PolygonScan',
+                    url: 'https://polygonscan.com',
+                    apiUrl: 'https://api.polygonscan.com/api',
+                    apiKey: 'polygonkey',
+                    family: ExplorerFamily.Etherscan,
+                },
+            ],
+        };
+        const bscScanChain = {
+            protocol: ProtocolType.Ethereum,
+            name: 'bsc',
+            chainId: 56,
+            domainId: 56,
+            rpcUrls: [{ http: 'https://bsc.test' }],
+            blockExplorers: [
+                {
+                    name: 'BscScan',
+                    url: 'https://bscscan.com',
+                    apiUrl: 'https://api.bscscan.com/api',
+                    apiKey: 'bsckey',
+                    family: ExplorerFamily.Etherscan,
+                },
+            ],
+        };
+        const alreadyV2Chain = {
+            protocol: ProtocolType.Ethereum,
+            name: 'ethereum',
+            chainId: 1,
+            domainId: 1,
+            rpcUrls: [{ http: 'https://ethereum.test' }],
+            blockExplorers: [
+                {
+                    name: 'Etherscan',
+                    url: 'https://etherscan.io',
+                    apiUrl: 'https://api.etherscan.io/v2/api',
+                    apiKey: 'testkey',
+                    family: ExplorerFamily.Etherscan,
+                },
+            ],
+        };
+        const nonScanChain = {
+            protocol: ProtocolType.Ethereum,
+            name: 'custom',
+            chainId: 999,
+            domainId: 999,
+            rpcUrls: [{ http: 'https://custom.test' }],
+            blockExplorers: [
+                {
+                    name: 'Custom Explorer',
+                    url: 'https://custom-explorer.com',
+                    apiUrl: 'https://api.custom-explorer.com/api',
+                    apiKey: 'customkey',
+                    family: ExplorerFamily.Other,
+                },
+            ],
+        };
+        it('converts Etherscan V1 API to V2 format with chainId', () => {
+            const result = getExplorerApi(etherscanV1Chain);
+            expect(result).to.deep.equal({
+                apiUrl: 'https://api.etherscan.io/v2/api?chainid=1',
+                apiKey: 'testkey',
+                family: ExplorerFamily.Etherscan,
+            });
+        });
+        it('converts PolygonScan API to V2 format with chainId', () => {
+            const result = getExplorerApi(polygonScanChain);
+            expect(result).to.deep.equal({
+                apiUrl: 'https://api.etherscan.io/v2/api?chainid=137',
+                apiKey: 'polygonkey',
+                family: ExplorerFamily.Etherscan,
+            });
+        });
+        it('converts BscScan API to V2 format with chainId', () => {
+            const result = getExplorerApi(bscScanChain);
+            expect(result).to.deep.equal({
+                apiUrl: 'https://api.etherscan.io/v2/api?chainid=56',
+                apiKey: 'bsckey',
+                family: ExplorerFamily.Etherscan,
+            });
+        });
+        it('leaves already V2 URLs unchanged', () => {
+            const result = getExplorerApi(alreadyV2Chain);
+            expect(result).to.deep.equal({
+                apiUrl: 'https://api.etherscan.io/v2/api?chainid=1',
+                apiKey: 'testkey',
+                family: ExplorerFamily.Etherscan,
+            });
+        });
+        it('leaves non-scan APIs unchanged', () => {
+            const result = getExplorerApi(nonScanChain);
+            expect(result).to.deep.equal({
+                apiUrl: 'https://api.custom-explorer.com/api',
+                apiKey: 'customkey',
+                family: ExplorerFamily.Other,
+            });
+        });
+        it('handles string chainId conversion', () => {
+            const stringChainIdChain = {
+                ...etherscanV1Chain,
+                chainId: '1',
+            };
+            const result = getExplorerApi(stringChainIdChain);
+            expect(result).to.deep.equal({
+                apiUrl: 'https://api.etherscan.io/v2/api?chainid=1',
+                apiKey: 'testkey',
+                family: ExplorerFamily.Etherscan,
+            });
+        });
+        it('handles missing chainId gracefully', () => {
+            const noChainIdChain = {
+                ...etherscanV1Chain,
+                chainId: 0, // Use 0 instead of undefined to satisfy type requirements
+            };
+            const result = getExplorerApi(noChainIdChain);
+            expect(result).to.deep.equal({
+                apiUrl: 'https://api.etherscan.io/v2/api',
+                apiKey: 'testkey',
+                family: ExplorerFamily.Etherscan,
+            });
+        });
+        it('includes API key in final URL', () => {
+            const result = getExplorerApiUrl(etherscanV1Chain);
+            expect(result).to.equal('https://api.etherscan.io/v2/api?chainid=1&apikey=testkey');
+        });
+        it('handles various explorer families', () => {
+            const testCases = [
+                { family: ExplorerFamily.Etherscan, expected: true },
+                { family: ExplorerFamily.Other, expected: false },
+            ];
+            testCases.forEach(({ family, expected }) => {
+                const testChain = {
+                    ...etherscanV1Chain,
+                    blockExplorers: [
+                        {
+                            ...etherscanV1Chain.blockExplorers[0],
+                            family,
+                        },
+                    ],
+                };
+                const result = getExplorerApi(testChain);
+                if (expected) {
+                    expect(result?.apiUrl).to.include('api.etherscan.io/v2/api');
+                }
+                else {
+                    expect(result?.apiUrl).to.equal('https://api.etherscan.io/api');
+                }
+            });
+        });
+    });
+    describe('Edge cases', () => {
+        const emptyChain = {
+            protocol: ProtocolType.Ethereum,
+            name: 'empty',
+            domainId: 1,
+            chainId: 1,
+            rpcUrls: [{ http: 'https://empty.test' }],
+        };
+        const chainWithoutApi = {
+            protocol: ProtocolType.Ethereum,
+            name: 'noapi',
+            chainId: 1,
+            domainId: 1,
+            rpcUrls: [{ http: 'https://noapi.test' }],
+            blockExplorers: [
+                {
+                    name: 'test',
+                    url: 'https://test.com',
+                    apiUrl: '',
+                },
+            ],
+        };
+        it('handles chain without block explorers', () => {
+            expect(getExplorerBaseUrl(emptyChain)).to.be.null;
+            expect(getExplorerApi(emptyChain)).to.be.null;
+            expect(getExplorerTxUrl(emptyChain, '0x123')).to.be.null;
+            expect(getExplorerAddressUrl(emptyChain, '0x123')).to.be.null;
+        });
+        it('handles chain without api url', () => {
+            expect(getExplorerBaseUrl(chainWithoutApi)).to.equal('https://test.com/');
+            expect(getExplorerApi(chainWithoutApi)).to.be.null;
+        });
+    });
+    describe('Multiple block explorers', () => {
+        const multiExplorerChain = {
+            protocol: ProtocolType.Ethereum,
+            name: 'multi',
+            domainId: 1,
+            chainId: 1,
+            rpcUrls: [{ http: 'https://multi.test' }],
+            blockExplorers: [
+                {
+                    name: 'first',
+                    url: 'https://first.com',
+                    apiUrl: 'https://api.first.com',
+                    apiKey: 'key1',
+                },
+                {
+                    name: 'second',
+                    url: 'https://second.com',
+                    apiUrl: 'https://api.second.com',
+                    apiKey: 'key2',
+                },
+            ],
+        };
+        it('uses correct explorer by index', () => {
+            expect(getExplorerBaseUrl(multiExplorerChain, 1)).to.equal('https://second.com/');
+            expect(getExplorerApiUrl(multiExplorerChain, 1)).to.equal('https://api.second.com/?apikey=key2');
+        });
+    });
+    describe('Special chain names with different common paths', () => {
+        const nautilusChain = {
+            protocol: ProtocolType.Ethereum,
+            name: 'nautilus',
+            chainId: 1,
+            domainId: 1,
+            rpcUrls: [{ http: 'https://nautilus.test' }],
+            blockExplorers: [
+                {
+                    name: 'nautilus',
+                    url: 'https://nautilus.com',
+                    apiUrl: 'https://api.nautilus.com',
+                },
+            ],
+        };
+        it('uses correct transaction path for special chains', () => {
+            expect(getExplorerTxUrl(nautilusChain, '0x123')).to.equal('https://nautilus.com/transaction/0x123');
+        });
+    });
+    describe('URL handling', () => {
+        const chainWithTrailingSlash = {
+            protocol: ProtocolType.Ethereum,
+            name: 'test',
+            domainId: 1,
+            chainId: 1,
+            rpcUrls: [{ http: 'https://test.chain' }],
+            blockExplorers: [
+                {
+                    name: 'test',
+                    url: 'https://test.com/',
+                    apiUrl: 'https://api.test.com',
+                },
+            ],
+        };
+        it('handles trailing slashes correctly', () => {
+            expect(getExplorerTxUrl(chainWithTrailingSlash, '0x123')).to.equal('https://test.com/tx/0x123');
+        });
+    });
+});
+//# sourceMappingURL=blockExplorer.test.js.map

package/dist/metadata/blockExplorer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockExplorer.test.js","sourceRoot":"","sources":["../../src/metadata/blockExplorer.test.ts"],"names":[],"mappings":"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"}

package/dist/metadata/chainIdUtils.d.ts

@@ -0,0 +1,8 @@
+import type { ChainMetadata } from './chainMetadataTypes.js';
+export declare function tryNormalizeNumericChainId(chainId: string | number): number | null;
+export declare function areChainIdsEqual(left: ChainMetadata['chainId'] | null | undefined, right: ChainMetadata['chainId'] | null | undefined): boolean;
+export declare function getEffectiveDomainId(metadata: {
+    chainId: ChainMetadata['chainId'];
+    domainId?: ChainMetadata['domainId'] | null;
+}): number | null;
+//# sourceMappingURL=chainIdUtils.d.ts.map

package/dist/metadata/chainIdUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chainIdUtils.d.ts","sourceRoot":"","sources":["../../src/metadata/chainIdUtils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAM7D,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,GAAG,MAAM,GACvB,MAAM,GAAG,IAAI,CAYf;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,EACjD,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,OAAO,CAQT;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE;IAC7C,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;CAC7C,GAAG,MAAM,GAAG,IAAI,CAMhB"}

package/dist/metadata/chainIdUtils.js

@@ -0,0 +1,33 @@
+import { isNullish } from '@recoillink/utils';
+// Decimal-only canonical chain IDs. Rejects hex, prefixed values, and mixed IDs
+// like cosmoshub-4 so those never alias to numeric domain lookups.
+const NUMERIC_CHAIN_ID_REGEX = /^\d+$/;
+export function tryNormalizeNumericChainId(chainId) {
+    if (typeof chainId === 'number') {
+        return Number.isSafeInteger(chainId) ? chainId : null;
+    }
+    if (!NUMERIC_CHAIN_ID_REGEX.test(chainId))
+        return null;
+    const numericChainId = Number(chainId);
+    if (!Number.isSafeInteger(numericChainId))
+        return null;
+    if (String(numericChainId) !== chainId)
+        return null;
+    return numericChainId;
+}
+export function areChainIdsEqual(left, right) {
+    if (isNullish(left) || isNullish(right))
+        return false;
+    if (left === right)
+        return true;
+    const leftNumeric = tryNormalizeNumericChainId(left);
+    const rightNumeric = tryNormalizeNumericChainId(right);
+    return leftNumeric !== null && leftNumeric === rightNumeric;
+}
+export function getEffectiveDomainId(metadata) {
+    if (!isNullish(metadata.domainId)) {
+        return metadata.domainId;
+    }
+    return tryNormalizeNumericChainId(metadata.chainId);
+}
+//# sourceMappingURL=chainIdUtils.js.map

package/dist/metadata/chainIdUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chainIdUtils.js","sourceRoot":"","sources":["../../src/metadata/chainIdUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAI9C,gFAAgF;AAChF,mEAAmE;AACnE,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAEvC,MAAM,UAAU,0BAA0B,CACxC,OAAwB;IAExB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,CAAC;IAED,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvD,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,MAAM,CAAC,cAAc,CAAC,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAEpD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,IAAiD,EACjD,KAAkD;IAElD,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEtD,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAEhC,MAAM,WAAW,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;IACvD,OAAO,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,YAAY,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAGpC;IACC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,OAAO,QAAQ,CAAC,QAAQ,CAAC;IAC3B,CAAC;IAED,OAAO,0BAA0B,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC"}

package/dist/metadata/chainIdUtils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chainIdUtils.test.d.ts.map

package/dist/metadata/chainIdUtils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chainIdUtils.test.d.ts","sourceRoot":"","sources":["../../src/metadata/chainIdUtils.test.ts"],"names":[],"mappings":""}

package/dist/metadata/chainIdUtils.test.js

@@ -0,0 +1,45 @@
+import { expect } from 'chai';
+import { areChainIdsEqual, getEffectiveDomainId, tryNormalizeNumericChainId, } from './chainIdUtils.js';
+describe(tryNormalizeNumericChainId.name, () => {
+    it('accepts safe integer numbers', () => {
+        expect(tryNormalizeNumericChainId(0)).to.equal(0);
+        expect(tryNormalizeNumericChainId(123)).to.equal(123);
+    });
+    it('accepts canonical numeric strings', () => {
+        expect(tryNormalizeNumericChainId('0')).to.equal(0);
+        expect(tryNormalizeNumericChainId('123')).to.equal(123);
+    });
+    it('rejects non-canonical or invalid inputs', () => {
+        expect(tryNormalizeNumericChainId('00123')).to.equal(null);
+        expect(tryNormalizeNumericChainId('cosmoshub-4')).to.equal(null);
+        expect(tryNormalizeNumericChainId(1.5)).to.equal(null);
+        expect(tryNormalizeNumericChainId(Number.MAX_SAFE_INTEGER + 1)).to.equal(null);
+    });
+});
+describe(areChainIdsEqual.name, () => {
+    it('matches exact values and canonical numeric aliases', () => {
+        expect(areChainIdsEqual(123, 123)).to.equal(true);
+        expect(areChainIdsEqual('123', 123)).to.equal(true);
+    });
+    it('rejects nullish and non-matching values', () => {
+        expect(areChainIdsEqual(undefined, 123)).to.equal(false);
+        expect(areChainIdsEqual(null, '123')).to.equal(false);
+        expect(areChainIdsEqual(5, 10)).to.equal(false);
+        expect(areChainIdsEqual('5', 10)).to.equal(false);
+        expect(areChainIdsEqual('00123', 123)).to.equal(false);
+        expect(areChainIdsEqual('cosmoshub-4', 4)).to.equal(false);
+    });
+});
+describe(getEffectiveDomainId.name, () => {
+    it('prefers explicit domain ids', () => {
+        expect(getEffectiveDomainId({ chainId: 1, domainId: 999 })).to.equal(999);
+    });
+    it('falls back to normalized chain ids when domain id is absent', () => {
+        expect(getEffectiveDomainId({ chainId: 123 })).to.equal(123);
+        expect(getEffectiveDomainId({ chainId: '123' })).to.equal(123);
+    });
+    it('returns null for non-numeric fallback chain ids', () => {
+        expect(getEffectiveDomainId({ chainId: 'cosmoshub-4' })).to.equal(null);
+    });
+});
+//# sourceMappingURL=chainIdUtils.test.js.map

package/dist/metadata/chainIdUtils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chainIdUtils.test.js","sourceRoot":"","sources":["../../src/metadata/chainIdUtils.test.ts"],"names":[],"mappings":"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"}

package/dist/metadata/chainMetadata.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chainMetadata.test.d.ts.map

package/dist/metadata/chainMetadata.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chainMetadata.test.d.ts","sourceRoot":"","sources":["../../src/metadata/chainMetadata.test.ts"],"names":[],"mappings":""}