@recoillink/sdk 0.0.0-stage → 45.0.1

package/dist/utils/cosmos.js

@@ -0,0 +1,424 @@
+import { z } from 'zod';
+// Generated from https://github.com/cosmos/chain-registry/blob/master/chain.schema.json
+// using https://stefanterdell.github.io/json-schema-to-zod-react/
+export const CosmosChainSchema = z.object({
+    $schema: z
+        .string()
+        .regex(new RegExp('^(\\.\\./)+chain\\.schema\\.json$'))
+        .min(1)
+        .optional(),
+    chain_name: z.string().regex(new RegExp('[a-z0-9]+')).min(1),
+    chain_type: z
+        .enum([
+        'cosmos',
+        'eip155',
+        'bip122',
+        'polkadot',
+        'solana',
+        'algorand',
+        'arweave',
+        'ergo',
+        'fil',
+        'hedera',
+        'monero',
+        'reef',
+        'stacks',
+        'starknet',
+        'stellar',
+        'tezos',
+        'vechain',
+        'waves',
+        'xrpl',
+        'unknown',
+    ])
+        .describe("The 'type' of chain as the corresponding CAIP-2 Namespace value. E.G., 'cosmos' or 'eip155'. Namespaces can be found here: https://github.com/ChainAgnostic/namespaces/tree/main."),
+    chain_id: z.string().min(1).optional(),
+    pre_fork_chain_name: z
+        .string()
+        .regex(new RegExp('[a-z0-9]+'))
+        .min(1)
+        .optional(),
+    pretty_name: z.string().min(1).optional(),
+    website: z.url().min(1).optional(),
+    status: z.enum(['live', 'upcoming', 'killed']).optional(),
+    network_type: z.enum(['mainnet', 'testnet', 'devnet']).optional(),
+    bech32_prefix: z
+        .string()
+        .min(1)
+        .describe("The default prefix for the human-readable part of addresses that identifies the coin type. Must be registered with SLIP-0173. E.g., 'cosmos'")
+        .optional(),
+    bech32_config: z
+        .strictObject({
+        bech32PrefixAccAddr: z
+            .string()
+            .min(1)
+            .describe("e.g., 'cosmos'")
+            .optional(),
+        bech32PrefixAccPub: z
+            .string()
+            .min(1)
+            .describe("e.g., 'cosmospub'")
+            .optional(),
+        bech32PrefixValAddr: z
+            .string()
+            .min(1)
+            .describe("e.g., 'cosmosvaloper'")
+            .optional(),
+        bech32PrefixValPub: z
+            .string()
+            .min(1)
+            .describe("e.g., 'cosmosvaloperpub'")
+            .optional(),
+        bech32PrefixConsAddr: z
+            .string()
+            .min(1)
+            .describe("e.g., 'cosmosvalcons'")
+            .optional(),
+        bech32PrefixConsPub: z
+            .string()
+            .min(1)
+            .describe("e.g., 'cosmosvalconspub'")
+            .optional(),
+    })
+        .describe('Used to override the bech32_prefix for specific uses.')
+        .optional(),
+    daemon_name: z.string().min(1).optional(),
+    node_home: z.string().min(1).optional(),
+    key_algos: z
+        .array(z.enum(['secp256k1', 'ethsecp256k1', 'ed25519', 'sr25519', 'bn254']))
+        .optional(),
+    slip44: z.number().optional(),
+    alternative_slip44s: z.array(z.number()).optional(),
+    fees: z
+        .strictObject({
+        fee_tokens: z.array(z.strictObject({
+            denom: z.string().min(1),
+            fixed_min_gas_price: z.number().optional(),
+            low_gas_price: z.number().optional(),
+            average_gas_price: z.number().optional(),
+            high_gas_price: z.number().optional(),
+            gas_costs: z
+                .strictObject({
+                cosmos_send: z.number().optional(),
+                ibc_transfer: z.number().optional(),
+            })
+                .optional(),
+        })),
+    })
+        .optional(),
+    staking: z
+        .strictObject({
+        staking_tokens: z.array(z.strictObject({ denom: z.string().min(1) })),
+        lock_duration: z
+            .strictObject({
+            blocks: z
+                .number()
+                .describe('The number of blocks for which the staked tokens are locked.')
+                .optional(),
+            time: z
+                .string()
+                .min(1)
+                .describe('The approximate time for which the staked tokens are locked.')
+                .optional(),
+        })
+            .optional(),
+    })
+        .optional(),
+    codebase: z
+        .strictObject({
+        git_repo: z.url().min(1).optional(),
+        recommended_version: z.string().min(1).optional(),
+        compatible_versions: z.array(z.string().min(1)).optional(),
+        tag: z
+            .string()
+            .regex(new RegExp('^[A-Za-z0-9._/@-]+$'))
+            .min(1)
+            .describe('Git Upgrade Tag')
+            .optional(),
+        language: z
+            .strictObject({
+            type: z.enum(['go', 'rust', 'solidity', 'other']),
+            version: z
+                .string()
+                .regex(new RegExp('^v?\\d+(\\.\\d+){0,2}$'))
+                .min(1)
+                .describe("Simple version string (e.g., 'v1.0.0').")
+                .optional(),
+            repo: z
+                .string()
+                .url()
+                .min(1)
+                .describe('URL of the code repository.')
+                .optional(),
+            tag: z
+                .string()
+                .regex(new RegExp('^[A-Za-z0-9._/@-]+$'))
+                .min(1)
+                .describe('Git Upgrade Tag')
+                .optional(),
+        })
+            .optional(),
+        binaries: z
+            .strictObject({
+            'linux/amd64': z.url().min(1).optional(),
+            'linux/arm64': z.url().min(1).optional(),
+            'darwin/amd64': z.url().min(1).optional(),
+            'darwin/arm64': z.url().min(1).optional(),
+            'windows/amd64': z.url().min(1).optional(),
+            'windows/arm64': z.url().min(1).optional(),
+        })
+            .optional(),
+        sdk: z
+            .strictObject({
+            type: z.enum(['cosmos', 'penumbra', 'other']),
+            version: z
+                .string()
+                .regex(new RegExp('^v?\\d+(\\.\\d+){0,2}$'))
+                .min(1)
+                .describe("Simple version string (e.g., 'v1.0.0').")
+                .optional(),
+            repo: z
+                .string()
+                .url()
+                .min(1)
+                .describe('URL of the code repository.')
+                .optional(),
+            tag: z
+                .string()
+                .regex(new RegExp('^[A-Za-z0-9._/@-]+$'))
+                .min(1)
+                .describe('Git Upgrade Tag')
+                .optional(),
+        })
+            .optional(),
+        consensus: z
+            .strictObject({
+            type: z.enum(['tendermint', 'cometbft', 'sei-tendermint']),
+            version: z
+                .string()
+                .regex(new RegExp('^v?\\d+(\\.\\d+){0,2}$'))
+                .min(1)
+                .describe("Simple version string (e.g., 'v1.0.0').")
+                .optional(),
+            repo: z
+                .string()
+                .url()
+                .min(1)
+                .describe('URL of the code repository.')
+                .optional(),
+            tag: z
+                .string()
+                .regex(new RegExp('^[A-Za-z0-9._/@-]+$'))
+                .min(1)
+                .describe('Git Upgrade Tag')
+                .optional(),
+        })
+            .optional(),
+        cosmwasm: z
+            .strictObject({
+            version: z
+                .string()
+                .regex(new RegExp('^v?\\d+(\\.\\d+){0,2}$'))
+                .min(1)
+                .describe("Simple version string (e.g., 'v1.0.0').")
+                .optional(),
+            repo: z
+                .string()
+                .url()
+                .min(1)
+                .describe('URL of the code repository.')
+                .optional(),
+            tag: z
+                .string()
+                .regex(new RegExp('^[A-Za-z0-9._/@-]+$'))
+                .min(1)
+                .describe('Git Upgrade Tag')
+                .optional(),
+            enabled: z.boolean().optional(),
+            path: z
+                .string()
+                .regex(new RegExp('^\\$HOME.*$'))
+                .min(1)
+                .describe('Relative path to the cosmwasm directory. ex. $HOME/.juno/data/wasm')
+                .optional(),
+        })
+            .optional(),
+        ibc: z
+            .strictObject({
+            type: z.enum(['go', 'rust', 'other']),
+            version: z
+                .string()
+                .regex(new RegExp('^v?\\d+(\\.\\d+){0,2}$'))
+                .min(1)
+                .describe("Simple version string (e.g., 'v1.0.0').")
+                .optional(),
+            repo: z
+                .string()
+                .url()
+                .min(1)
+                .describe('URL of the code repository.')
+                .optional(),
+            tag: z
+                .string()
+                .regex(new RegExp('^[A-Za-z0-9._/@-]+$'))
+                .min(1)
+                .describe('Git Upgrade Tag')
+                .optional(),
+            ics_enabled: z
+                .array(z
+                .enum(['ics20-1', 'ics27-1', 'mauth'])
+                .describe('IBC app or ICS standard.'))
+                .describe('List of IBC apps (usually corresponding to a ICS standard) which have been enabled on the network.')
+                .optional(),
+        })
+            .optional(),
+        genesis: z
+            .strictObject({
+            name: z.string().min(1).optional(),
+            genesis_url: z.url().min(1),
+            ics_ccv_url: z.url().min(1).optional(),
+        })
+            .optional(),
+    })
+        .optional(),
+    images: z
+        .array(z
+        .strictObject({
+        image_sync: z
+            .strictObject({
+            chain_name: z
+                .string()
+                .min(1)
+                .describe("The chain name or platform from which the object resides. E.g., 'cosmoshub', 'ethereum', 'forex', or 'nasdaq'"),
+            base_denom: z
+                .string()
+                .min(1)
+                .describe("The base denom of the asset from which the object originates. E.g., when describing ATOM from Cosmos Hub, specify 'uatom', NOT 'atom' nor 'ATOM'; base units are unique per platform.")
+                .optional(),
+        })
+            .describe('The (primary) key used to identify an object within the Chain Registry.')
+            .optional(),
+        png: z
+            .string()
+            .regex(new RegExp('^https://raw\\.githubusercontent\\.com/cosmos/chain-registry/master/(|testnets/|_non-cosmos/)[a-z0-9]+/images/.+\\.png$'))
+            .min(1)
+            .optional(),
+        svg: z
+            .string()
+            .regex(new RegExp('^https://raw\\.githubusercontent\\.com/cosmos/chain-registry/master/(|testnets/|_non-cosmos/)[a-z0-9]+/images/.+\\.svg$'))
+            .min(1)
+            .optional(),
+        theme: z
+            .strictObject({
+            circle: z.boolean().optional(),
+            dark_mode: z.boolean().optional(),
+            monochrome: z.boolean().optional(),
+        })
+            .optional(),
+    })
+        .and(z.union([z.any(), z.any()])))
+        .optional(),
+    logo_URIs: z
+        .strictObject({
+        png: z
+            .string()
+            .regex(new RegExp('^https://raw\\.githubusercontent\\.com/cosmos/chain-registry/master/(|testnets/|_non-cosmos/)[a-z0-9]+/images/.+\\.png$'))
+            .min(1)
+            .optional(),
+        svg: z
+            .string()
+            .regex(new RegExp('^https://raw\\.githubusercontent\\.com/cosmos/chain-registry/master/(|testnets/|_non-cosmos/)[a-z0-9]+/images/.+\\.svg$'))
+            .min(1)
+            .optional(),
+    })
+        .optional(),
+    description: z.string().min(1).max(3000).optional(),
+    peers: z
+        .strictObject({
+        seeds: z
+            .array(z.strictObject({
+            id: z.string().min(1),
+            address: z.string().min(1),
+            provider: z.string().min(1).optional(),
+        }))
+            .optional(),
+        persistent_peers: z
+            .array(z.strictObject({
+            id: z.string().min(1),
+            address: z.string().min(1),
+            provider: z.string().min(1).optional(),
+        }))
+            .optional(),
+    })
+        .optional(),
+    apis: z
+        .strictObject({
+        rpc: z
+            .array(z.strictObject({
+            address: z.string().min(1),
+            provider: z.string().min(1).optional(),
+            archive: z.boolean().default(false),
+        }))
+            .optional(),
+        rest: z
+            .array(z.strictObject({
+            address: z.string().min(1),
+            provider: z.string().min(1).optional(),
+            archive: z.boolean().default(false),
+        }))
+            .optional(),
+        grpc: z
+            .array(z.strictObject({
+            address: z.string().min(1),
+            provider: z.string().min(1).optional(),
+            archive: z.boolean().default(false),
+        }))
+            .optional(),
+        wss: z
+            .array(z.strictObject({
+            address: z.string().min(1),
+            provider: z.string().min(1).optional(),
+            archive: z.boolean().default(false),
+        }))
+            .optional(),
+        'grpc-web': z
+            .array(z.strictObject({
+            address: z.string().min(1),
+            provider: z.string().min(1).optional(),
+            archive: z.boolean().default(false),
+        }))
+            .optional(),
+        'evm-http-jsonrpc': z
+            .array(z.strictObject({
+            address: z.string().min(1),
+            provider: z.string().min(1).optional(),
+            archive: z.boolean().default(false),
+        }))
+            .optional(),
+    })
+        .optional(),
+    explorers: z
+        .array(z.strictObject({
+        kind: z.string().min(1).optional(),
+        url: z.string().min(1).optional(),
+        tx_page: z.string().min(1).optional(),
+        account_page: z.string().min(1).optional(),
+        validator_page: z.string().min(1).optional(),
+        proposal_page: z.string().min(1).optional(),
+        block_page: z.string().min(1).optional(),
+    }))
+        .optional(),
+    keywords: z.array(z.string().min(1)).optional(),
+    extra_codecs: z.array(z.enum(['ethermint', 'injective'])).optional(),
+});
+export async function getCosmosRegistryChain(chain) {
+    const json = await fetch(`https://raw.githubusercontent.com/cosmos/chain-registry/master/${chain}/chain.json`);
+    const data = await json.json();
+    const result = CosmosChainSchema.safeParse(data);
+    if (!result.success) {
+        const errorMessages = result.error.issues.map((issue) => `${issue.path} => ${issue.message}`);
+        throw new Error(`Invalid Cosmos chain ${chain}:\n ${errorMessages.join('\n')}`);
+    }
+    return result.data;
+}
+//# sourceMappingURL=cosmos.js.map

package/dist/utils/cosmos.js.map

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

package/dist/utils/decimals.d.ts

@@ -0,0 +1,53 @@
+import { TokenMetadata, WarpRouteDeployConfigMailboxRequired } from '../token/types.js';
+/**
+ * Lossless scale representation using bigint.
+ * On-chain values and internal comparisons always use this form.
+ */
+export type NormalizedScale = {
+    numerator: bigint;
+    denominator: bigint;
+};
+/**
+ * Any scale variant the Zod schema can produce:
+ * - `number` (e.g. `scale: 1000`)
+ * - `{numerator: number, denominator: number}`
+ * - `{numerator: bigint, denominator: bigint}`
+ */
+export type ScaleInput = TokenMetadata['scale'];
+export declare const DEFAULT_SCALE: NormalizedScale;
+export type ScaleAlignment = {
+    localAmount: bigint;
+    messageAmount: bigint;
+};
+/**
+ * Converts any accepted scale variant to NormalizedScale (bigint).
+ */
+export declare function normalizeScale(scale: ScaleInput | undefined): NormalizedScale;
+export declare function messageAmountFromLocal(localAmount: bigint, scale: ScaleInput | undefined): bigint;
+export declare function localAmountFromMessage(messageAmount: bigint, scale: ScaleInput | undefined): bigint;
+export declare function minLocalAmountForMessage(messageAmount: bigint, scale: ScaleInput | undefined): bigint;
+export declare function alignLocalAmountToMessage(localAmount: bigint, scale: ScaleInput | undefined): ScaleAlignment;
+/**
+ * Compares two scale values for equality without precision loss.
+ * Accepts any scale variant (number, {number,number}, {bigint,bigint}, undefined).
+ * Uses cross-multiplication: a/b === c/d iff a*d === b*c
+ */
+export declare function scalesEqual(a: ScaleInput | undefined, b: ScaleInput | undefined): boolean;
+/**
+ * Verifies that scale configs across chains are mutually consistent.
+ *
+ * A warp route may use either convention:
+ *   - Scale-up: 6-decimal chains carry scale > 1, max-decimal chain carries no scale
+ *   - Scale-down: max-decimal chain carries scale < 1 ({num:1, den:N}), others carry no scale
+ *
+ * Both are valid as long as the effective message amount is identical for every chain:
+ *   scale_A / scale_B == 10^(dec_B - dec_A)  for any pair (A, B)
+ *
+ * Equivalently (avoiding floating point): for a fixed reference chain R,
+ *   scale_A.num * 10^dec_A * scale_R.den  ==  scale_R.num * 10^dec_R * scale_A.den
+ *
+ * This accepts precision loss from scale-down (e.g., BSC 18-decimal USDT
+ * scaled to 6-decimal message encoding loses 12 digits of sub-unit precision).
+ */
+export declare function verifyScale(configMap: Map<string, TokenMetadata> | WarpRouteDeployConfigMailboxRequired): boolean;
+//# sourceMappingURL=decimals.d.ts.map

package/dist/utils/decimals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimals.d.ts","sourceRoot":"","sources":["../../src/utils/decimals.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EACb,oCAAoC,EACrC,MAAM,mBAAmB,CAAC;AAG3B;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;AAEhD,eAAO,MAAM,aAAa,EAAE,eAG3B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,eAAe,CAS7E;AAgBD,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,UAAU,GAAG,SAAS,GAC5B,MAAM,CAKR;AAED,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,UAAU,GAAG,SAAS,GAC5B,MAAM,CAKR;AAED,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,UAAU,GAAG,SAAS,GAC5B,MAAM,CAKR;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,UAAU,GAAG,SAAS,GAC5B,cAAc,CAchB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,CAAC,EAAE,UAAU,GAAG,SAAS,EACzB,CAAC,EAAE,UAAU,GAAG,SAAS,GACxB,OAAO,CAIT;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,oCAAoC,GAC3E,OAAO,CA4CT"}

package/dist/utils/decimals.js

@@ -0,0 +1,131 @@
+import { assert, objMap } from '@recoillink/utils';
+export const DEFAULT_SCALE = {
+    numerator: 1n,
+    denominator: 1n,
+};
+/**
+ * Converts any accepted scale variant to NormalizedScale (bigint).
+ */
+export function normalizeScale(scale) {
+    if (scale === undefined)
+        return DEFAULT_SCALE;
+    if (typeof scale === 'number') {
+        return { numerator: BigInt(scale), denominator: 1n };
+    }
+    return {
+        numerator: BigInt(scale.numerator),
+        denominator: BigInt(scale.denominator),
+    };
+}
+function assertValidScale(scale) {
+    assert(scale.numerator > 0n && scale.denominator > 0n, `Scale must be positive, got ${scale.numerator}/${scale.denominator}`);
+}
+function ceilDiv(numerator, denominator) {
+    assert(denominator > 0n, 'Denominator must be positive');
+    assert(numerator >= 0n, 'Numerator must be non-negative');
+    if (numerator === 0n)
+        return 0n;
+    return (numerator + denominator - 1n) / denominator;
+}
+export function messageAmountFromLocal(localAmount, scale) {
+    assert(localAmount >= 0n, 'Local amount must be non-negative');
+    const normalized = normalizeScale(scale);
+    assertValidScale(normalized);
+    return (localAmount * normalized.numerator) / normalized.denominator;
+}
+export function localAmountFromMessage(messageAmount, scale) {
+    assert(messageAmount >= 0n, 'Message amount must be non-negative');
+    const normalized = normalizeScale(scale);
+    assertValidScale(normalized);
+    return (messageAmount * normalized.denominator) / normalized.numerator;
+}
+export function minLocalAmountForMessage(messageAmount, scale) {
+    assert(messageAmount >= 0n, 'Message amount must be non-negative');
+    const normalized = normalizeScale(scale);
+    assertValidScale(normalized);
+    return ceilDiv(messageAmount * normalized.denominator, normalized.numerator);
+}
+export function alignLocalAmountToMessage(localAmount, scale) {
+    assert(localAmount >= 0n, 'Local amount must be non-negative');
+    const messageAmount = messageAmountFromLocal(localAmount, scale);
+    if (messageAmount === 0n) {
+        return {
+            localAmount: 0n,
+            messageAmount: 0n,
+        };
+    }
+    return {
+        localAmount: minLocalAmountForMessage(messageAmount, scale),
+        messageAmount,
+    };
+}
+/**
+ * Compares two scale values for equality without precision loss.
+ * Accepts any scale variant (number, {number,number}, {bigint,bigint}, undefined).
+ * Uses cross-multiplication: a/b === c/d iff a*d === b*c
+ */
+export function scalesEqual(a, b) {
+    const na = normalizeScale(a);
+    const nb = normalizeScale(b);
+    return na.numerator * nb.denominator === nb.numerator * na.denominator;
+}
+/**
+ * Verifies that scale configs across chains are mutually consistent.
+ *
+ * A warp route may use either convention:
+ *   - Scale-up: 6-decimal chains carry scale > 1, max-decimal chain carries no scale
+ *   - Scale-down: max-decimal chain carries scale < 1 ({num:1, den:N}), others carry no scale
+ *
+ * Both are valid as long as the effective message amount is identical for every chain:
+ *   scale_A / scale_B == 10^(dec_B - dec_A)  for any pair (A, B)
+ *
+ * Equivalently (avoiding floating point): for a fixed reference chain R,
+ *   scale_A.num * 10^dec_A * scale_R.den  ==  scale_R.num * 10^dec_R * scale_A.den
+ *
+ * This accepts precision loss from scale-down (e.g., BSC 18-decimal USDT
+ * scaled to 6-decimal message encoding loses 12 digits of sub-unit precision).
+ */
+export function verifyScale(configMap) {
+    const chainDecimalConfigPairs = configMap instanceof Map
+        ? Object.fromEntries(configMap.entries())
+        : configMap;
+    const entries = Object.entries(objMap(chainDecimalConfigPairs, (chain, config) => {
+        assert(config.decimals != null, `Decimals must be defined for token config on chain ${chain}`);
+        return { decimals: config.decimals, scale: config.scale };
+    }));
+    if (entries.length <= 1)
+        return true;
+    if (areDecimalsUniform(Object.fromEntries(entries))) {
+        const [, refConfig] = entries[0];
+        return entries.every(([, config]) => scalesEqual(refConfig.scale, config.scale));
+    }
+    // Pick the first chain as reference. For every other chain, verify pairwise:
+    //   ref.scale.num * 10^ref.dec * chain.scale.den
+    //     == chain.scale.num * 10^chain.dec * ref.scale.den
+    const [, refConfig] = entries[0];
+    const refNorm = normalizeScale(refConfig.scale);
+    const refEffective = refNorm.numerator * 10n ** BigInt(refConfig.decimals);
+    for (let i = 1; i < entries.length; i++) {
+        const [, config] = entries[i];
+        const norm = normalizeScale(config.scale);
+        const effective = norm.numerator * 10n ** BigInt(config.decimals);
+        // Cross-multiply to compare ratios without division:
+        //   refEffective / refNorm.denominator == effective / norm.denominator
+        //   => refEffective * norm.denominator == effective * refNorm.denominator
+        if (refEffective * norm.denominator !== effective * refNorm.denominator) {
+            return false;
+        }
+    }
+    return true;
+}
+function areDecimalsUniform(configMap) {
+    const values = Object.values(configMap);
+    const [first, ...rest] = values;
+    for (const d of rest) {
+        if (d.decimals !== first.decimals) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=decimals.js.map

package/dist/utils/decimals.js.map

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

package/dist/utils/decimals.test.d.ts

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

package/dist/utils/decimals.test.d.ts.map

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