@nradko/metric-omm-sdk-v1 0.0.16

package/dist/stateView/read.js

@@ -0,0 +1,249 @@
+/**
+ * MetricAMM SDK - StateView Read Functions
+ * Efficient batch read functions using the StateView contract
+ */
+import { STATE_VIEW_ABI } from "../constants.js";
+/**
+ * Get slot0 data efficiently (all in one call)
+ */
+export async function getSlot0(publicClient, stateViewAddress, poolAddress) {
+    const result = (await publicClient.readContract({
+        address: stateViewAddress,
+        abi: STATE_VIEW_ABI,
+        functionName: "slot0",
+        args: [poolAddress],
+    }));
+    return {
+        pauseLevel: Number(result[0]),
+        curBinIdx: Number(result[1]),
+        curPosInBin: result[2],
+        curBinDistFromProvidedPrice: Number(result[3]),
+        spreadFeeE6: Number(result[4]),
+        notionalFeeE8: Number(result[5]),
+    };
+}
+/**
+ * Get slot1 data (total scaled token amounts in bins)
+ */
+export async function getSlot1(publicClient, stateViewAddress, poolAddress) {
+    const result = (await publicClient.readContract({
+        address: stateViewAddress,
+        abi: STATE_VIEW_ABI,
+        functionName: "slot1",
+        args: [poolAddress],
+    }));
+    return {
+        totalScaledToken0InBins: result[0],
+        totalScaledToken1InBins: result[1],
+    };
+}
+/**
+ * Get bin state with balances in external (native token decimal) units
+ */
+export async function getBinStateExternal(publicClient, stateViewAddress, poolAddress, binIdx) {
+    const result = (await publicClient.readContract({
+        address: stateViewAddress,
+        abi: STATE_VIEW_ABI,
+        functionName: "binState",
+        args: [poolAddress, binIdx],
+    }));
+    return {
+        token0Balance: result[0],
+        token1Balance: result[1],
+        lengthE6: result[2],
+        addFeeBuyE6: result[3],
+        addFeeSellE6: result[4],
+    };
+}
+/**
+ * Get multiple bin states efficiently (batch read)
+ */
+export async function getBinStatesExternal(publicClient, stateViewAddress, poolAddress, binIndices) {
+    const result = (await publicClient.readContract({
+        address: stateViewAddress,
+        abi: STATE_VIEW_ABI,
+        functionName: "binStates",
+        args: [poolAddress, binIndices],
+    }));
+    return {
+        token0Balances: result[0],
+        token1Balances: result[1],
+        lengthsInUnits: result[2],
+        addFeeBuysE6: result[3],
+        addFeeSellsE6: result[4],
+        totalShares: result[5],
+    };
+}
+/**
+ * Get multiple bin states in scaled (internal) units (parallel reads).
+ */
+export async function getBinStatesScaled(publicClient, stateViewAddress, poolAddress, binIndices) {
+    const scaledReads = binIndices.map((binIdx) => publicClient.readContract({
+        address: stateViewAddress,
+        abi: STATE_VIEW_ABI,
+        functionName: "binStateScaled",
+        args: [poolAddress, binIdx],
+    }));
+    const shareReads = binIndices.map((binIdx) => publicClient.readContract({
+        address: stateViewAddress,
+        abi: STATE_VIEW_ABI,
+        functionName: "binTotalShares",
+        args: [poolAddress, binIdx],
+    }));
+    const [scaled, shares] = await Promise.all([Promise.all(scaledReads), Promise.all(shareReads)]);
+    return {
+        token0BalancesScaled: scaled.map((r) => r[0]),
+        token1BalancesScaled: scaled.map((r) => r[1]),
+        lengthsInUnits: scaled.map((r) => r[2]),
+        addFeeBuysE6: scaled.map((r) => r[3]),
+        addFeeSellsE6: scaled.map((r) => r[4]),
+        totalShares: shares,
+    };
+}
+/**
+ * Get bin total shares
+ */
+export async function getBinTotalShares(publicClient, stateViewAddress, poolAddress, binIdx) {
+    return (await publicClient.readContract({
+        address: stateViewAddress,
+        abi: STATE_VIEW_ABI,
+        functionName: "binTotalShares",
+        args: [poolAddress, binIdx],
+    }));
+}
+/**
+ * Get user position shares via StateView
+ */
+export async function getPositionBinSharesFromStateView(publicClient, stateViewAddress, poolAddress, owner, salt, binIdx) {
+    return (await publicClient.readContract({
+        address: stateViewAddress,
+        abi: STATE_VIEW_ABI,
+        functionName: "positionBinShares",
+        args: [poolAddress, owner, salt, binIdx],
+    }));
+}
+/**
+ * Create a position bin key (matches Solidity's toPositionBinKey)
+ * Layout: [address(160)] | [salt(80)] | [bin(16)] = 256 bits
+ */
+export function toPositionBinKey(owner, salt, bin) {
+    // Convert owner address to bigint (160 bits)
+    const ownerBigInt = BigInt(owner);
+    // Salt is 80 bits, bin is 16 bits (signed, convert to uint16)
+    const binUint16 = bin < 0 ? BigInt(bin + 0x10000) : BigInt(bin);
+    // Pack: owner << 96 | salt << 16 | bin
+    const packed = (ownerBigInt << 96n) | ((salt & 0xffffffffffffffffffffn) << 16n) | (binUint16 & 0xffffn);
+    return `0x${packed.toString(16).padStart(64, "0")}`;
+}
+/**
+ * Get user position shares for a range of bins via StateView batch call
+ *
+ * @param publicClient - Viem public client
+ * @param stateViewAddress - StateView contract address
+ * @param poolAddress - Pool address
+ * @param owner - Position owner (e.g., NFTPositionManager address)
+ * @param salt - Position salt (e.g., NFT token ID)
+ * @param lowerBin - Lower bin index (inclusive)
+ * @param upperBin - Upper bin index (inclusive)
+ * @returns Array of { binIdx, shares } for bins with non-zero shares
+ */
+export async function getPositionBinSharesRange(publicClient, stateViewAddress, poolAddress, owner, salt, lowerBin, upperBin) {
+    const binIndices = [];
+    const positionBinKeys = [];
+    for (let bin = lowerBin; bin <= upperBin; bin++) {
+        binIndices.push(bin);
+        positionBinKeys.push(toPositionBinKey(owner, salt, bin));
+    }
+    // Batch read all bin shares using the new positionBinSharesBatch function
+    const results = (await publicClient.readContract({
+        address: stateViewAddress,
+        abi: STATE_VIEW_ABI,
+        functionName: "positionBinSharesBatch",
+        args: [poolAddress, positionBinKeys],
+    }));
+    const positionShares = [];
+    for (let i = 0; i < binIndices.length; i++) {
+        const shares = results[i];
+        if (shares > 0n) {
+            positionShares.push({
+                binIdx: binIndices[i],
+                shares,
+            });
+        }
+    }
+    return positionShares;
+}
+/**
+ * Get user position shares for specific (possibly non-contiguous) bins via StateView batch call.
+ *
+ * Unlike getPositionBinSharesRange which scans a contiguous range,
+ * this function queries exact bin indices you specify.
+ *
+ * @param publicClient - Viem public client
+ * @param stateViewAddress - StateView contract address
+ * @param poolAddress - Pool address
+ * @param owner - Position owner address
+ * @param salt - Position salt
+ * @param bins - Array of specific bin indices to query (e.g., [-3, 1, 2])
+ * @returns Array of { binIdx, shares } for bins with non-zero shares
+ */
+export async function getPositionBinSharesForBins(publicClient, stateViewAddress, poolAddress, owner, salt, bins) {
+    const positionBinKeys = bins.map((bin) => toPositionBinKey(owner, salt, bin));
+    const results = (await publicClient.readContract({
+        address: stateViewAddress,
+        abi: STATE_VIEW_ABI,
+        functionName: "positionBinSharesBatch",
+        args: [poolAddress, positionBinKeys],
+    }));
+    const positionShares = [];
+    for (let i = 0; i < bins.length; i++) {
+        const shares = results[i];
+        if (shares > 0n) {
+            positionShares.push({
+                binIdx: bins[i],
+                shares,
+            });
+        }
+    }
+    return positionShares;
+}
+/**
+ * Get fee configuration
+ */
+export async function getFeeConfig(publicClient, stateViewAddress, poolAddress) {
+    const result = (await publicClient.readContract({
+        address: stateViewAddress,
+        abi: STATE_VIEW_ABI,
+        functionName: "feeConfig",
+        args: [poolAddress],
+    }));
+    return {
+        adminAddr: result[0],
+        protocolFee: result[1],
+        adminFee: result[2],
+        adminFeeDest: result[3],
+    };
+}
+/**
+ * Get price provider address
+ */
+export async function getPriceProvider(publicClient, stateViewAddress, poolAddress) {
+    return (await publicClient.readContract({
+        address: stateViewAddress,
+        abi: STATE_VIEW_ABI,
+        functionName: "priceProvider",
+        args: [poolAddress],
+    }));
+}
+/**
+ * Get last trade timestamp
+ */
+export async function getLastTradeTimestamp(publicClient, stateViewAddress, poolAddress) {
+    return (await publicClient.readContract({
+        address: stateViewAddress,
+        abi: STATE_VIEW_ABI,
+        functionName: "lastTradeTimestamp",
+        args: [poolAddress],
+    }));
+}
+//# sourceMappingURL=read.js.map

package/dist/stateView/read.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * MetricAMM SDK Types
+ * All interfaces and type definitions
+ */
+import type { Address } from "viem";
+export interface LiquidityDelta {
+    bin: number;
+    deltaShares: bigint;
+}
+/**
+ * v1 pool and LiquidityAdder payload: parallel arrays of bin indices and share magnitudes (add or remove).
+ */
+export interface PoolLiquidityDelta {
+    binIdxs: readonly bigint[];
+    shares: readonly bigint[];
+}
+/**
+ * Bin configuration for pool creation.
+ * All values are in E6 format (1e6 = 100%).
+ *
+ * @example
+ * // Bin with 1% length, 0.3% buy fee, 0.1% sell fee
+ * { lengthE6: 10000, addFeeBuyE6: 3000, addFeeSellE6: 1000 }
+ */
+export interface BinData {
+    /** Bin length in E6 format (10000 = 1%, 1000000 = 100%) */
+    lengthE6: number;
+    /** Additional buy fee in E6 format */
+    addFeeBuyE6: number;
+    /** Additional sell fee in E6 format */
+    addFeeSellE6: number;
+}
+export interface PoolImmutables {
+    factory: Address;
+    token0: Address;
+    token1: Address;
+    token0ScaleMultiplier: bigint;
+    token1ScaleMultiplier: bigint;
+    initialScaledToken0PerShareE18: bigint;
+    initialScaledToken1PerShareE18: bigint;
+    minimalMintableLiquidity: bigint;
+    maxDriftE8: bigint;
+    maxDriftDecayPerSecondE8: bigint;
+    lowestBin: number;
+    highestBin: number;
+}
+export interface PoolState {
+    pauseLevel: number;
+    curBinIdx: number;
+    curPosInBin: bigint;
+    curBinDistFromProvidedPrice: number;
+    spreadFeeE6: number;
+    notionalFeeE8: number;
+    totalScaledToken0InBins: bigint;
+    totalScaledToken1InBins: bigint;
+}
+export interface BinState {
+    token0BalanceScaled: bigint;
+    token1BalanceScaled: bigint;
+    lengthE6: number;
+    addFeeBuyE6: number;
+    addFeeSellE6: number;
+}
+export interface BinStateExternal {
+    token0Balance: bigint;
+    token1Balance: bigint;
+    lengthE6: number;
+    addFeeBuyE6: number;
+    addFeeSellE6: number;
+}
+export interface BinStatesExternal {
+    token0Balances: bigint[];
+    token1Balances: bigint[];
+    lengthsInUnits: number[];
+    addFeeBuysE6: number[];
+    addFeeSellsE6: number[];
+    totalShares: bigint[];
+}
+export interface BinStatesScaled {
+    token0BalancesScaled: bigint[];
+    token1BalancesScaled: bigint[];
+    lengthsInUnits: number[];
+    addFeeBuysE6: number[];
+    addFeeSellsE6: number[];
+    totalShares: bigint[];
+}
+export interface Slot0 {
+    pauseLevel: number;
+    curBinIdx: number;
+    curPosInBin: bigint;
+    curBinDistFromProvidedPrice: number;
+    spreadFeeE6: number;
+    notionalFeeE8: number;
+}
+export interface Slot1 {
+    totalScaledToken0InBins: bigint;
+    totalScaledToken1InBins: bigint;
+}
+export interface FeeConfig {
+    adminAddr: Address;
+    protocolFee: number;
+    adminFee: number;
+    adminFeeDest: Address;
+}
+/**
+ * Result type for getPositionBinSharesRange
+ */
+export interface PositionBinSharesResult {
+    binIdx: number;
+    shares: bigint;
+}
+export interface CalculateUniformLiquidityParams {
+    valuePerBinInToken: bigint;
+    valueIsInToken0: boolean;
+    currentPrice: number;
+    lowerBin: number;
+    upperBin: number;
+}
+export interface LiquidityBinValueInput {
+    bin: number;
+    targetValueInToken: bigint;
+    targetValueInToken0: boolean;
+}
+export interface CalculateAnyLiquidityParams {
+    bins: LiquidityBinValueInput[];
+    currentPrice: number;
+}
+export interface PreparedLiquidityDistribution {
+    deltas: LiquidityDelta[];
+    specAmount0: bigint;
+    specAmount1: bigint;
+}
+export type CalculatedLiquidityDistribution = PreparedLiquidityDistribution;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * MetricAMM SDK Types
+ * All interfaces and type definitions
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/utils/binData.d.ts

@@ -0,0 +1,65 @@
+/**
+ * MetricAMM SDK - Bin Data Utilities
+ * Functions for packing/unpacking bin data
+ */
+import type { BinData } from "../types.js";
+/**
+ * Pack bin data into 48-bit representation
+ * Layout: [lengthE6: 16 bits][addFeeBuyE6: 16 bits][addFeeSellE6: 16 bits]
+ */
+export declare function packBinData(binData: BinData): bigint;
+/**
+ * Pack 5 bins into a single uint256
+ * Each bin takes 48 bits, total 240 bits used, 16 bits unused
+ */
+export declare function packBins5(bins: BinData[]): bigint;
+/**
+ * Pack an array of bin data into uint256 array (5 bins per uint256)
+ * Pads with zero bins if length is not divisible by 5
+ */
+export declare function packBinDataArray(bins: BinData[]): bigint[];
+/**
+ * Unpack 48-bit bin data
+ */
+export declare function unpackBinData(packed: bigint): BinData;
+/**
+ * Pack bin data array into uint256 array ready for contract calls.
+ *
+ * @param bins Array of bin configurations
+ * @returns Packed uint256 array ready for contract calls
+ *
+ * @example
+ * // Create 3 bins: 1% length with default fees
+ * const bins = createBins([
+ *   { lengthE6: 10000, addFeeBuyE6: 0, addFeeSellE6: 0 },
+ *   { lengthE6: 10000, addFeeBuyE6: 0, addFeeSellE6: 0 },
+ *   { lengthE6: 10000, addFeeBuyE6: 0, addFeeSellE6: 0 },
+ * ]);
+ *
+ * @example
+ * // Create bins with custom fees
+ * const bins = createBins([
+ *   { lengthE6: 10000, addFeeBuyE6: 500, addFeeSellE6: 200 },   // 1% length, +0.05% buy, +0.02% sell
+ *   { lengthE6: 20000, addFeeBuyE6: 0, addFeeSellE6: 0 },       // 2% length, no extra fees
+ * ]);
+ */
+export declare function createBins(bins: BinData[]): bigint[];
+/**
+ * Create uniform bins with the same configuration.
+ *
+ * @param count Number of bins to create
+ * @param lengthE6 Bin length in E6 format (10000 = 1%)
+ * @param addFeeBuyE6 Additional buy fee in E6 format (default: 0)
+ * @param addFeeSellE6 Additional sell fee in E6 format (default: 0)
+ * @returns Packed uint256 array ready for contract calls
+ *
+ * @example
+ * // Create 20 uniform bins, each 1% length
+ * const bins = createUniformBins(20, 10000);
+ *
+ * @example
+ * // Create 10 bins with 0.5% length and +0.1% buy fee
+ * const bins = createUniformBins(10, 5000, 1000);
+ */
+export declare function createUniformBins(count: number, lengthE6: number, addFeeBuyE6?: number, addFeeSellE6?: number): bigint[];
+//# sourceMappingURL=binData.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binData.d.ts","sourceRoot":"","sources":["../../src/utils/binData.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAMpD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAYjD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAc1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAUrD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAEpD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,MAAU,EACvB,YAAY,GAAE,MAAU,GACvB,MAAM,EAAE,CAOV"}

package/dist/utils/binData.js

@@ -0,0 +1,109 @@
+/**
+ * MetricAMM SDK - Bin Data Utilities
+ * Functions for packing/unpacking bin data
+ */
+/**
+ * Pack bin data into 48-bit representation
+ * Layout: [lengthE6: 16 bits][addFeeBuyE6: 16 bits][addFeeSellE6: 16 bits]
+ */
+export function packBinData(binData) {
+    const length = BigInt(binData.lengthE6) & 0xffffn;
+    const buyFee = BigInt(binData.addFeeBuyE6) & 0xffffn;
+    const sellFee = BigInt(binData.addFeeSellE6) & 0xffffn;
+    return length | (buyFee << 16n) | (sellFee << 32n);
+}
+/**
+ * Pack 5 bins into a single uint256
+ * Each bin takes 48 bits, total 240 bits used, 16 bits unused
+ */
+export function packBins5(bins) {
+    if (bins.length !== 5) {
+        throw new Error("Must provide exactly 5 bins");
+    }
+    let packed = 0n;
+    for (let i = 0; i < 5; i++) {
+        const binPacked = packBinData(bins[i]);
+        packed |= binPacked << (BigInt(i) * 48n);
+    }
+    return packed;
+}
+/**
+ * Pack an array of bin data into uint256 array (5 bins per uint256)
+ * Pads with zero bins if length is not divisible by 5
+ */
+export function packBinDataArray(bins) {
+    const zeroBin = { lengthE6: 0, addFeeBuyE6: 0, addFeeSellE6: 0 };
+    const result = [];
+    // Process in chunks of 5
+    for (let i = 0; i < bins.length; i += 5) {
+        const chunk = [];
+        for (let j = 0; j < 5; j++) {
+            chunk.push(bins[i + j] || zeroBin);
+        }
+        result.push(packBins5(chunk));
+    }
+    return result;
+}
+/**
+ * Unpack 48-bit bin data
+ */
+export function unpackBinData(packed) {
+    const lengthE6 = Number(packed & 0xffffn);
+    const addFeeBuyE6 = Number((packed >> 16n) & 0xffffn);
+    const addFeeSellE6 = Number((packed >> 32n) & 0xffffn);
+    return {
+        lengthE6,
+        addFeeBuyE6,
+        addFeeSellE6,
+    };
+}
+/**
+ * Pack bin data array into uint256 array ready for contract calls.
+ *
+ * @param bins Array of bin configurations
+ * @returns Packed uint256 array ready for contract calls
+ *
+ * @example
+ * // Create 3 bins: 1% length with default fees
+ * const bins = createBins([
+ *   { lengthE6: 10000, addFeeBuyE6: 0, addFeeSellE6: 0 },
+ *   { lengthE6: 10000, addFeeBuyE6: 0, addFeeSellE6: 0 },
+ *   { lengthE6: 10000, addFeeBuyE6: 0, addFeeSellE6: 0 },
+ * ]);
+ *
+ * @example
+ * // Create bins with custom fees
+ * const bins = createBins([
+ *   { lengthE6: 10000, addFeeBuyE6: 500, addFeeSellE6: 200 },   // 1% length, +0.05% buy, +0.02% sell
+ *   { lengthE6: 20000, addFeeBuyE6: 0, addFeeSellE6: 0 },       // 2% length, no extra fees
+ * ]);
+ */
+export function createBins(bins) {
+    return packBinDataArray(bins);
+}
+/**
+ * Create uniform bins with the same configuration.
+ *
+ * @param count Number of bins to create
+ * @param lengthE6 Bin length in E6 format (10000 = 1%)
+ * @param addFeeBuyE6 Additional buy fee in E6 format (default: 0)
+ * @param addFeeSellE6 Additional sell fee in E6 format (default: 0)
+ * @returns Packed uint256 array ready for contract calls
+ *
+ * @example
+ * // Create 20 uniform bins, each 1% length
+ * const bins = createUniformBins(20, 10000);
+ *
+ * @example
+ * // Create 10 bins with 0.5% length and +0.1% buy fee
+ * const bins = createUniformBins(10, 5000, 1000);
+ */
+export function createUniformBins(count, lengthE6, addFeeBuyE6 = 0, addFeeSellE6 = 0) {
+    const bins = Array(count).fill({
+        lengthE6,
+        addFeeBuyE6,
+        addFeeSellE6,
+    });
+    return packBinDataArray(bins);
+}
+//# sourceMappingURL=binData.js.map

package/dist/utils/binData.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MetricAMM SDK - Utility Functions
+ */
+export { packBinData, packBins5, packBinDataArray, unpackBinData, createBins, createUniformBins, } from "./binData.js";
+export { priceToQ64, q64ToPrice } from "./price.js";
+export { ONE_E18, ceilDiv, toPriceE18 as toPriceX18, convertToken0ToToken1, convertToken1ToToken0, scaledPositiveDeltaToExternal, } from "./liquidityMath.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGpD,OAAO,EACL,OAAO,EACP,OAAO,EACP,UAAU,IAAI,UAAU,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,oBAAoB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,10 @@
+/**
+ * MetricAMM SDK - Utility Functions
+ */
+// Bin data utilities
+export { packBinData, packBins5, packBinDataArray, unpackBinData, createBins, createUniformBins, } from "./binData.js";
+// Price utilities
+export { priceToQ64, q64ToPrice } from "./price.js";
+// Liquidity math utilities
+export { ONE_E18, ceilDiv, toPriceE18 as toPriceX18, convertToken0ToToken1, convertToken1ToToken0, scaledPositiveDeltaToExternal, } from "./liquidityMath.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAqB;AACrB,OAAO,EACL,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,kBAAkB;AAClB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpD,2BAA2B;AAC3B,OAAO,EACL,OAAO,EACP,OAAO,EACP,UAAU,IAAI,UAAU,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,oBAAoB,CAAC"}

package/dist/utils/liquidityMath.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MetricAMM SDK - Liquidity Math Utilities
+ */
+export declare const ONE_E18 = 1000000000000000000n;
+export declare function ceilDiv(numerator: bigint, denominator: bigint): bigint;
+export declare function toPriceE18(currentPrice: number): bigint;
+export declare function convertToken0ToToken1(amount0: bigint, token0ScaleMultiplier: bigint, token1ScaleMultiplier: bigint, priceE18: bigint): bigint;
+export declare function convertToken1ToToken0(amount1: bigint, token0ScaleMultiplier: bigint, token1ScaleMultiplier: bigint, priceX18: bigint): bigint;
+export declare function scaledPositiveDeltaToExternal(scaledAmount: bigint, scaleMultiplier: bigint): bigint;
+//# sourceMappingURL=liquidityMath.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"liquidityMath.d.ts","sourceRoot":"","sources":["../../src/utils/liquidityMath.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,OAAO,uBAA6B,CAAC;AAElD,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAItE;AAED,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CASvD;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,qBAAqB,EAAE,MAAM,EAC7B,qBAAqB,EAAE,MAAM,EAC7B,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,qBAAqB,EAAE,MAAM,EAC7B,qBAAqB,EAAE,MAAM,EAC7B,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GACtB,MAAM,CAER"}

package/dist/utils/liquidityMath.js

@@ -0,0 +1,31 @@
+/**
+ * MetricAMM SDK - Liquidity Math Utilities
+ */
+export const ONE_E18 = 1000000000000000000n;
+export function ceilDiv(numerator, denominator) {
+    if (denominator <= 0n)
+        throw new Error("denominator must be > 0");
+    if (numerator < 0n)
+        throw new Error("numerator must be >= 0");
+    return numerator === 0n ? 0n : (numerator + denominator - 1n) / denominator;
+}
+export function toPriceE18(currentPrice) {
+    if (!Number.isFinite(currentPrice) || currentPrice <= 0) {
+        throw new Error("currentPrice must be a positive finite number");
+    }
+    const priceE18 = BigInt(Math.round(currentPrice * 1e18));
+    if (priceE18 <= 0n) {
+        throw new Error("currentPrice is too small");
+    }
+    return priceE18;
+}
+export function convertToken0ToToken1(amount0, token0ScaleMultiplier, token1ScaleMultiplier, priceE18) {
+    return (amount0 * token0ScaleMultiplier * priceE18) / (token1ScaleMultiplier * ONE_E18);
+}
+export function convertToken1ToToken0(amount1, token0ScaleMultiplier, token1ScaleMultiplier, priceX18) {
+    return (amount1 * token1ScaleMultiplier * ONE_E18) / (token0ScaleMultiplier * priceX18);
+}
+export function scaledPositiveDeltaToExternal(scaledAmount, scaleMultiplier) {
+    return ceilDiv(scaledAmount, scaleMultiplier);
+}
+//# sourceMappingURL=liquidityMath.js.map