@flashnet/sdk 0.4.3 → 0.5.0

package/dist/cjs/src/utils/tick-math.js

@@ -0,0 +1,299 @@
+'use strict';
+
+/**
+ * V3 Concentrated Liquidity Tick Math Utilities
+ *
+ * In V3 AMMs, price is represented as ticks where: price = 1.0001^tick
+ * Each tick represents a 0.01% (1 basis point) price change.
+ *
+ * Pool price convention: "amount of asset B per 1 unit of asset A" (in smallest units)
+ * For a USDB/BTC pool (A=USDB, B=BTC): price = sats per microUSDB
+ */
+// Constants
+const LOG_BASE = Math.log(1.0001);
+const MIN_TICK = -887272;
+const MAX_TICK = 887272;
+/**
+ * Convert a raw pool price to a tick.
+ *
+ * @param price - Pool price (amount of asset B per unit of asset A in smallest units)
+ * @returns The tick value
+ *
+ * @example
+ * // For USDB/BTC pool at ~$90k: price = 0.00111 sats per microUSDB
+ * priceToTick(0.00111) // returns approximately -68038
+ */
+function priceToTick(price) {
+    const priceNum = typeof price === "string" ? parseFloat(price) : price;
+    if (priceNum <= 0) {
+        throw new Error("Price must be positive");
+    }
+    const tick = Math.log(priceNum) / LOG_BASE;
+    return Math.round(tick);
+}
+/**
+ * Convert a tick to a raw pool price.
+ *
+ * @param tick - The tick value
+ * @returns Pool price as a string (for precision)
+ *
+ * @example
+ * tickToPrice(-68038) // returns "0.001109..." (sats per microUSDB)
+ */
+function tickToPrice(tick) {
+    if (tick < MIN_TICK || tick > MAX_TICK) {
+        throw new Error(`Tick must be between ${MIN_TICK} and ${MAX_TICK}`);
+    }
+    const price = 1.0001 ** tick;
+    return price.toString();
+}
+/**
+ * Round a tick down to the nearest valid tick (multiple of tick spacing).
+ *
+ * @param tick - The tick to round
+ * @param tickSpacing - The pool's tick spacing (e.g., 60)
+ * @returns Rounded tick
+ */
+function roundTickDown(tick, tickSpacing) {
+    return Math.floor(tick / tickSpacing) * tickSpacing;
+}
+/**
+ * Round a tick up to the nearest valid tick (multiple of tick spacing).
+ *
+ * @param tick - The tick to round
+ * @param tickSpacing - The pool's tick spacing (e.g., 60)
+ * @returns Rounded tick
+ */
+function roundTickUp(tick, tickSpacing) {
+    return Math.ceil(tick / tickSpacing) * tickSpacing;
+}
+/**
+ * Round a tick to the nearest valid tick (multiple of tick spacing).
+ *
+ * @param tick - The tick to round
+ * @param tickSpacing - The pool's tick spacing (e.g., 60)
+ * @returns Rounded tick
+ */
+function roundTick(tick, tickSpacing) {
+    return Math.round(tick / tickSpacing) * tickSpacing;
+}
+/**
+ * Convert a human-readable price to a V3 tick.
+ *
+ * This is the most user-friendly function for calculating ticks.
+ * Express your price as "quote per base" (e.g., "$90,000 per BTC").
+ *
+ * @example
+ * // BTC at $90,000, pool has USDB (6 decimals) as A, BTC (8 decimals) as B
+ * humanPriceToTick({
+ *   humanPrice: 90000,
+ *   baseDecimals: 8,      // BTC
+ *   quoteDecimals: 6,     // USD
+ *   baseIsAssetA: false,  // BTC is asset B (default)
+ *   tickSpacing: 60
+ * }) // returns -68040
+ *
+ * @example
+ * // Get tick range for $80,000 to $100,000
+ * const tickLower = humanPriceToTick({ humanPrice: 100000, baseDecimals: 8, quoteDecimals: 6, tickSpacing: 60 });
+ * const tickUpper = humanPriceToTick({ humanPrice: 80000, baseDecimals: 8, quoteDecimals: 6, tickSpacing: 60 });
+ * // Note: higher price = lower tick for this pool configuration
+ */
+function humanPriceToTick(options) {
+    const { humanPrice, baseDecimals, quoteDecimals, baseIsAssetA = false, tickSpacing, } = options;
+    if (humanPrice <= 0) {
+        throw new Error("Human price must be positive");
+    }
+    // Pool price is "amount of B per unit of A" in smallest units
+    // Human price is "quote per base"
+    // If base is asset B (common case: BTC/USD pool where BTC is B):
+    //   pool_price = 10^(baseDecimals - quoteDecimals) / humanPrice
+    // If base is asset A:
+    //   pool_price = humanPrice * 10^(quoteDecimals - baseDecimals)
+    let poolPrice;
+    if (baseIsAssetA) {
+        // Base is A, so human price is "B per A" which is the same direction as pool price
+        poolPrice = humanPrice * 10 ** (quoteDecimals - baseDecimals);
+    }
+    else {
+        // Base is B, so human price is "A per B", need to invert
+        poolPrice = 10 ** (baseDecimals - quoteDecimals) / humanPrice;
+    }
+    let tick = priceToTick(poolPrice);
+    if (tickSpacing) {
+        tick = roundTick(tick, tickSpacing);
+    }
+    return tick;
+}
+/**
+ * Convert a V3 tick to a human-readable price.
+ *
+ * @example
+ * // Tick -68040 in a USDB/BTC pool
+ * tickToHumanPrice({
+ *   tick: -68040,
+ *   baseDecimals: 8,      // BTC
+ *   quoteDecimals: 6,     // USD
+ *   baseIsAssetA: false   // BTC is asset B
+ * }) // returns approximately 90000 (dollars per BTC)
+ */
+function tickToHumanPrice(options) {
+    const { tick, baseDecimals, quoteDecimals, baseIsAssetA = false } = options;
+    const poolPrice = parseFloat(tickToPrice(tick));
+    // Reverse the conversion from humanPriceToTick
+    if (baseIsAssetA) {
+        return poolPrice / 10 ** (quoteDecimals - baseDecimals);
+    }
+    else {
+        return 10 ** (baseDecimals - quoteDecimals) / poolPrice;
+    }
+}
+/**
+ * Get a tick range from human-readable price bounds.
+ *
+ * Automatically handles the conversion and ensures tickLower < tickUpper.
+ *
+ * @example
+ * // Get tick range for $80,000 to $100,000 BTC price
+ * const range = tickRangeFromPrices({
+ *   priceLower: 80000,
+ *   priceUpper: 100000,
+ *   baseDecimals: 8,
+ *   quoteDecimals: 6,
+ *   tickSpacing: 60
+ * });
+ * // returns { tickLower: -69120, tickUpper: -66840, actualPriceLower: 80180, actualPriceUpper: 99820 }
+ */
+function tickRangeFromPrices(options) {
+    const { priceLower, priceUpper, baseDecimals, quoteDecimals, baseIsAssetA = false, tickSpacing, } = options;
+    if (priceLower >= priceUpper) {
+        throw new Error("priceLower must be less than priceUpper");
+    }
+    const tick1 = humanPriceToTick({
+        humanPrice: priceLower,
+        baseDecimals,
+        quoteDecimals,
+        baseIsAssetA,
+        tickSpacing,
+    });
+    const tick2 = humanPriceToTick({
+        humanPrice: priceUpper,
+        baseDecimals,
+        quoteDecimals,
+        baseIsAssetA,
+        tickSpacing,
+    });
+    // Ensure tickLower < tickUpper (tick direction depends on baseIsAssetA)
+    const tickLower = Math.min(tick1, tick2);
+    const tickUpper = Math.max(tick1, tick2);
+    // Calculate actual prices at the rounded ticks
+    const actualPriceLower = tickToHumanPrice({
+        tick: baseIsAssetA ? tickLower : tickUpper,
+        baseDecimals,
+        quoteDecimals,
+        baseIsAssetA,
+    });
+    const actualPriceUpper = tickToHumanPrice({
+        tick: baseIsAssetA ? tickUpper : tickLower,
+        baseDecimals,
+        quoteDecimals,
+        baseIsAssetA,
+    });
+    return {
+        tickLower,
+        tickUpper,
+        actualPriceLower,
+        actualPriceUpper,
+    };
+}
+//
+// Pool Price Calculation from Amount
+//
+/**
+ * Calculate the pool price needed for a given position configuration.
+ *
+ * @param humanPrice - Human-readable price (e.g., 90000 for $90k/BTC)
+ * @param baseDecimals - Decimals of base token
+ * @param quoteDecimals - Decimals of quote token
+ * @param baseIsAssetA - Whether base is asset A (default: false)
+ * @returns Pool price string suitable for createConcentratedPool's initialPrice
+ */
+function humanPriceToPoolPrice(humanPrice, baseDecimals, quoteDecimals, baseIsAssetA = false) {
+    if (humanPrice <= 0) {
+        throw new Error("Human price must be positive");
+    }
+    let poolPrice;
+    if (baseIsAssetA) {
+        poolPrice = humanPrice * 10 ** (quoteDecimals - baseDecimals);
+    }
+    else {
+        poolPrice = 10 ** (baseDecimals - quoteDecimals) / humanPrice;
+    }
+    return poolPrice.toPrecision(10);
+}
+/**
+ * Convert pool price to human-readable price.
+ *
+ * @param poolPrice - Pool price (amount of B per unit of A in smallest units)
+ * @param baseDecimals - Decimals of base token
+ * @param quoteDecimals - Decimals of quote token
+ * @param baseIsAssetA - Whether base is asset A (default: false)
+ * @returns Human-readable price
+ */
+function poolPriceToHumanPrice(poolPrice, baseDecimals, quoteDecimals, baseIsAssetA = false) {
+    const price = typeof poolPrice === "string" ? parseFloat(poolPrice) : poolPrice;
+    if (baseIsAssetA) {
+        return price / 10 ** (quoteDecimals - baseDecimals);
+    }
+    else {
+        return 10 ** (baseDecimals - quoteDecimals) / price;
+    }
+}
+//
+// Convenience exports
+//
+/**
+ * V3 tick math utilities namespace for cleaner imports.
+ *
+ * @example
+ * import { V3TickMath } from "@flashnet/sdk";
+ *
+ * const tick = V3TickMath.fromHumanPrice({
+ *   humanPrice: 90000,
+ *   baseDecimals: 8,
+ *   quoteDecimals: 6,
+ *   tickSpacing: 60
+ * });
+ */
+const V3TickMath = {
+    // Core conversions
+    priceToTick,
+    tickToPrice,
+    // Tick spacing
+    roundTickDown,
+    roundTickUp,
+    roundTick,
+    // Human-readable conversions
+    fromHumanPrice: humanPriceToTick,
+    toHumanPrice: tickToHumanPrice,
+    rangeFromPrices: tickRangeFromPrices,
+    // Pool price conversions
+    humanPriceToPoolPrice,
+    poolPriceToHumanPrice,
+    // Constants
+    MIN_TICK,
+    MAX_TICK,
+};
+
+exports.V3TickMath = V3TickMath;
+exports.humanPriceToPoolPrice = humanPriceToPoolPrice;
+exports.humanPriceToTick = humanPriceToTick;
+exports.poolPriceToHumanPrice = poolPriceToHumanPrice;
+exports.priceToTick = priceToTick;
+exports.roundTick = roundTick;
+exports.roundTickDown = roundTickDown;
+exports.roundTickUp = roundTickUp;
+exports.tickRangeFromPrices = tickRangeFromPrices;
+exports.tickToHumanPrice = tickToHumanPrice;
+exports.tickToPrice = tickToPrice;
+//# sourceMappingURL=tick-math.js.map

package/dist/cjs/src/utils/tick-math.js.map

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

package/dist/cjs/src/utils/tokenAddress.js

@@ -66,7 +66,7 @@ function decodeSparkHumanReadableTokenIdentifier(humanReadableTokenIdentifier, n
         throw new Error("Failed to decode Spark human readable token identifier");
     }
 }
-// ===== BACKWARD COMPATIBILITY LAYER =====
+// BACKWARD COMPATIBILITY LAYER
 /**
  * @deprecated Use SparkHumanReadableTokenIdentifierNetworkPrefix instead
  */

package/dist/esm/index.d.ts

@@ -9,8 +9,9 @@ export { calculateThresholdPercentage, type ValidationResult, validateSingleSide
 export { type AutoClawbackSummary, type ClawbackAttemptResult, ERROR_CODE_METADATA, type ErrorCodeMetadata, type ErrorRecoveryStrategy, FlashnetError, type FlashnetErrorCategory, type FlashnetErrorCode, type FlashnetErrorOptions, type FlashnetErrorResponseBody, getCategoryFromCodeRange, getErrorCategory, getErrorMetadata, getErrorRecovery, isFlashnetError, isFlashnetErrorCode, } from "./src/types/errors";
 export { fromSmallestUnit, generateNonce, toSmallestUnit } from "./src/utils";
 export { AuthManager } from "./src/utils/auth";
-export { generateAddLiquidityIntentMessage, generateClaimEscrowIntentMessage, generateClawbackIntentMessage, generateConstantProductPoolInitializationIntentMessage, generateCreateEscrowIntentMessage, generateFundEscrowIntentMessage, generatePoolConfirmInitialDepositIntentMessage, generatePoolInitializationIntentMessage, generatePoolSwapIntentMessage, generateRegisterHostIntentMessage, generateRemoveLiquidityIntentMessage, generateRouteSwapIntentMessage, generateWithdrawHostFeesIntentMessage, generateWithdrawIntegratorFeesIntentMessage, } from "./src/utils/intents";
+export { generateAddLiquidityIntentMessage, generateClaimEscrowIntentMessage, generateClawbackIntentMessage, generateCollectFeesIntentMessage, generateConstantProductPoolInitializationIntentMessage, generateCreateConcentratedPoolIntentMessage, generateCreateEscrowIntentMessage, generateDecreaseLiquidityIntentMessage, generateFundEscrowIntentMessage, generateIncreaseLiquidityIntentMessage, generatePoolConfirmInitialDepositIntentMessage, generatePoolInitializationIntentMessage, generatePoolSwapIntentMessage, generateRebalancePositionIntentMessage, generateRegisterHostIntentMessage, generateRemoveLiquidityIntentMessage, generateRouteSwapIntentMessage, generateWithdrawHostFeesIntentMessage, generateWithdrawIntegratorFeesIntentMessage, } from "./src/utils/intents";
 export { createWalletSigner } from "./src/utils/signer";
 export { convertSparkAddressToNetwork, convertSparkAddressToSparkNetwork, decodeSparkAddress, decodeSparkAddressNew, encodeSparkAddress, encodeSparkAddressNew, getNetworkFromAddress, getSparkNetworkFromAddress, isValidPublicKey, isValidSparkAddress, isValidSparkAddressNew, looksLikePublicKey, type SparkAddressFormat, } from "./src/utils/spark-address";
+export { type HumanPriceToTickOptions, humanPriceToPoolPrice, humanPriceToTick, poolPriceToHumanPrice, priceToTick, roundTick, roundTickDown, roundTickUp, type TickRange, type TickRangeFromPricesOptions, type TickToHumanPriceOptions, tickRangeFromPrices, tickToHumanPrice, tickToPrice, V3TickMath, } from "./src/utils/tick-math";
 export { decodeHumanReadableTokenIdentifier, decodeSparkHumanReadableTokenIdentifier, encodeHumanReadableTokenIdentifier, encodeSparkHumanReadableTokenIdentifier, getHumanReadableTokenIdentifier, getTokenIdentifier, getTokenIdentifierHashes, getTokenIdentifierWithHashes, type HumanReadableTokenIdentifier, SPARK_TOKEN_CREATION_ENTITY_PUBLIC_KEY, type SparkHumanReadableTokenIdentifier, } from "./src/utils/tokenAddress";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EACL,UAAU,EACV,6BAA6B,EAC7B,WAAW,GACZ,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,qBAAqB,EACrB,kCAAkC,EAClC,8BAA8B,EAC9B,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,6BAA6B,CAAC;AAErC,cAAc,cAAc,CAAC;AAC7B,mBAAmB,aAAa,CAAC;AACjC,OAAO,EACL,4BAA4B,EAC5B,KAAK,gBAAgB,EACrB,gCAAgC,GACjC,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,aAAa,EACb,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,iCAAiC,EACjC,gCAAgC,EAChC,6BAA6B,EAC7B,sDAAsD,EACtD,iCAAiC,EACjC,+BAA+B,EAC/B,8CAA8C,EAC9C,uCAAuC,EACvC,6BAA6B,EAC7B,iCAAiC,EACjC,oCAAoC,EACpC,8BAA8B,EAC9B,qCAAqC,EACrC,2CAA2C,GAC5C,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,EAEL,4BAA4B,EAE5B,iCAAiC,EACjC,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAE1B,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,kCAAkC,EAClC,uCAAuC,EAEvC,kCAAkC,EAElC,uCAAuC,EACvC,+BAA+B,EAC/B,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,EAC5B,KAAK,4BAA4B,EACjC,sCAAsC,EACtC,KAAK,iCAAiC,GACvC,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EACL,UAAU,EACV,6BAA6B,EAC7B,WAAW,GACZ,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,qBAAqB,EACrB,kCAAkC,EAClC,8BAA8B,EAC9B,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,6BAA6B,CAAC;AAErC,cAAc,cAAc,CAAC;AAC7B,mBAAmB,aAAa,CAAC;AACjC,OAAO,EACL,4BAA4B,EAC5B,KAAK,gBAAgB,EACrB,gCAAgC,GACjC,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,aAAa,EACb,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,iCAAiC,EACjC,gCAAgC,EAChC,6BAA6B,EAE7B,gCAAgC,EAChC,sDAAsD,EACtD,2CAA2C,EAC3C,iCAAiC,EACjC,sCAAsC,EACtC,+BAA+B,EAC/B,sCAAsC,EACtC,8CAA8C,EAC9C,uCAAuC,EACvC,6BAA6B,EAC7B,sCAAsC,EACtC,iCAAiC,EACjC,oCAAoC,EACpC,8BAA8B,EAC9B,qCAAqC,EACrC,2CAA2C,GAC5C,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,EAEL,4BAA4B,EAE5B,iCAAiC,EACjC,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAE1B,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,KAAK,uBAAuB,EAC5B,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,EACX,SAAS,EACT,aAAa,EACb,WAAW,EACX,KAAK,SAAS,EACd,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,UAAU,GACX,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,kCAAkC,EAClC,uCAAuC,EAEvC,kCAAkC,EAElC,uCAAuC,EACvC,+BAA+B,EAC/B,kBAAkB,EAClB,wBAAwB,EACxB,4BAA4B,EAC5B,KAAK,4BAA4B,EACjC,sCAAsC,EACtC,KAAK,iCAAiC,GACvC,MAAM,0BAA0B,CAAC"}

package/dist/esm/index.js

@@ -7,8 +7,9 @@ export { calculateThresholdPercentage, validateSingleSidedPoolThreshold } from '
 export { ERROR_CODE_METADATA, FlashnetError, getCategoryFromCodeRange, getErrorCategory, getErrorMetadata, getErrorRecovery, isFlashnetError, isFlashnetErrorCode } from './src/types/errors.js';
 export { fromSmallestUnit, generateNonce, toSmallestUnit } from './src/utils/index.js';
 export { AuthManager } from './src/utils/auth.js';
-export { generateAddLiquidityIntentMessage, generateClaimEscrowIntentMessage, generateClawbackIntentMessage, generateConstantProductPoolInitializationIntentMessage, generateCreateEscrowIntentMessage, generateFundEscrowIntentMessage, generatePoolConfirmInitialDepositIntentMessage, generatePoolInitializationIntentMessage, generatePoolSwapIntentMessage, generateRegisterHostIntentMessage, generateRemoveLiquidityIntentMessage, generateRouteSwapIntentMessage, generateWithdrawHostFeesIntentMessage, generateWithdrawIntegratorFeesIntentMessage } from './src/utils/intents.js';
+export { generateAddLiquidityIntentMessage, generateClaimEscrowIntentMessage, generateClawbackIntentMessage, generateCollectFeesIntentMessage, generateConstantProductPoolInitializationIntentMessage, generateCreateConcentratedPoolIntentMessage, generateCreateEscrowIntentMessage, generateDecreaseLiquidityIntentMessage, generateFundEscrowIntentMessage, generateIncreaseLiquidityIntentMessage, generatePoolConfirmInitialDepositIntentMessage, generatePoolInitializationIntentMessage, generatePoolSwapIntentMessage, generateRebalancePositionIntentMessage, generateRegisterHostIntentMessage, generateRemoveLiquidityIntentMessage, generateRouteSwapIntentMessage, generateWithdrawHostFeesIntentMessage, generateWithdrawIntegratorFeesIntentMessage } from './src/utils/intents.js';
 export { createWalletSigner } from './src/utils/signer.js';
 export { convertSparkAddressToNetwork, convertSparkAddressToSparkNetwork, decodeSparkAddress, decodeSparkAddressNew, encodeSparkAddress, encodeSparkAddressNew, getNetworkFromAddress, getSparkNetworkFromAddress, isValidPublicKey, isValidSparkAddress, isValidSparkAddressNew, looksLikePublicKey } from './src/utils/spark-address.js';
+export { V3TickMath, humanPriceToPoolPrice, humanPriceToTick, poolPriceToHumanPrice, priceToTick, roundTick, roundTickDown, roundTickUp, tickRangeFromPrices, tickToHumanPrice, tickToPrice } from './src/utils/tick-math.js';
 export { SPARK_TOKEN_CREATION_ENTITY_PUBLIC_KEY, decodeHumanReadableTokenIdentifier, decodeSparkHumanReadableTokenIdentifier, encodeHumanReadableTokenIdentifier, encodeSparkHumanReadableTokenIdentifier, getHumanReadableTokenIdentifier, getTokenIdentifier, getTokenIdentifierHashes, getTokenIdentifierWithHashes } from './src/utils/tokenAddress.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;"}

package/dist/esm/src/api/typed-endpoints.d.ts

@@ -235,6 +235,76 @@ export declare class TypedAmmApi {
      * @requires Bearer token
      */
     listClawbackableTransfers(query?: Types.ListClawbackableTransfersQuery): Promise<Types.ListClawbackableTransfersResponse>;
+    /**
+     * Create a new concentrated liquidity pool (V3)
+     * @POST /v1/pools/concentrated
+     * @requires Bearer token
+     */
+    createConcentratedPool(request: Types.CreateConcentratedPoolRequest): Promise<Types.CreateConcentratedPoolResponse>;
+    /**
+     * Increase liquidity in a V3 concentrated position
+     * @POST /v1/concentrated/liquidity/increase
+     * @requires Bearer token
+     */
+    increaseLiquidity(request: Types.IncreaseLiquidityRequest): Promise<Types.IncreaseLiquidityResponse>;
+    /**
+     * Decrease liquidity in a V3 concentrated position
+     * @POST /v1/concentrated/liquidity/decrease
+     * @requires Bearer token
+     */
+    decreaseLiquidity(request: Types.DecreaseLiquidityRequest): Promise<Types.DecreaseLiquidityResponse>;
+    /**
+     * Collect accumulated fees from a V3 position
+     * @POST /v1/concentrated/fees/collect
+     * @requires Bearer token
+     */
+    collectFees(request: Types.CollectFeesRequest): Promise<Types.CollectFeesResponse>;
+    /**
+     * Rebalance a V3 position to a new tick range
+     * @POST /v1/concentrated/positions/rebalance
+     * @requires Bearer token
+     */
+    rebalancePosition(request: Types.RebalancePositionRequest): Promise<Types.RebalancePositionResponse>;
+    /**
+     * List V3 concentrated liquidity positions
+     * @GET /v1/concentrated/positions
+     * @requires Bearer token
+     */
+    listConcentratedPositions(query?: Types.ListConcentratedPositionsQuery): Promise<Types.ListConcentratedPositionsResponse>;
+    /**
+     * Get pool liquidity distribution for visualization
+     * @GET /v1/concentrated/pools/{poolId}/liquidity
+     */
+    getPoolLiquidity(poolId: string): Promise<Types.PoolLiquidityResponse>;
+    /**
+     * Get pool ticks for simulation
+     * @GET /v1/concentrated/pools/{poolId}/ticks
+     */
+    getPoolTicks(poolId: string): Promise<Types.PoolTicksResponse>;
+    /**
+     * Get user's free balance for a specific V3 pool
+     * @GET /v1/concentrated/balance/{poolId}
+     * @requires Bearer token
+     */
+    getConcentratedBalance(poolId: string): Promise<Types.GetBalanceResponse>;
+    /**
+     * Get user's free balances across all V3 pools
+     * @GET /v1/concentrated/balances
+     * @requires Bearer token
+     */
+    getConcentratedBalances(): Promise<Types.GetBalancesResponse>;
+    /**
+     * Get user's free balance for a specific V3 pool (via balances endpoint)
+     * @GET /v1/concentrated/balances/{poolId}
+     * @requires Bearer token
+     */
+    getConcentratedBalanceByPool(poolId: string): Promise<Types.GetBalancesResponse>;
+    /**
+     * Withdraw free balance from a V3 pool to user's Spark wallet
+     * @POST /v1/concentrated/balance/withdraw
+     * @requires Bearer token
+     */
+    withdrawConcentratedBalance(request: Types.WithdrawBalanceRequest): Promise<Types.WithdrawBalanceResponse>;
 }
 /**
  * Error checking utilities

package/dist/esm/src/api/typed-endpoints.d.ts.map

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

package/dist/esm/src/api/typed-endpoints.js

@@ -6,7 +6,7 @@ class TypedAmmApi {
     constructor(client) {
         this.client = client;
     }
-    // ===== Authentication Endpoints =====
+    // Authentication Endpoints
     /**
      * Request authentication challenge
      * @POST /v1/auth/challenge
@@ -21,7 +21,7 @@ class TypedAmmApi {
     async verify(request) {
         return this.client.ammPost("/v1/auth/verify", request);
     }
-    // ===== Host Endpoints =====
+    // Host Endpoints
     /**
      * Register a new host
      * @POST /v1/hosts/register
@@ -69,7 +69,7 @@ class TypedAmmApi {
     async getHostFeeWithdrawalHistory(query) {
         return this.client.ammGet("/v1/hosts/fee-withdrawal-history", { params: query });
     }
-    // ===== Pool Endpoints =====
+    // Pool Endpoints
     /**
      * Create constant product pool
      * @POST /v1/pools/constant-product
@@ -126,7 +126,7 @@ class TypedAmmApi {
     async getAllLpPositions() {
         return this.client.ammGet("/v1/liquidity/positions");
     }
-    // ===== Liquidity Endpoints =====
+    // Liquidity Endpoints
     /**
      * Add liquidity to pool
      * @POST /v1/liquidity/add
@@ -157,7 +157,7 @@ class TypedAmmApi {
     async simulateRemoveLiquidity(request) {
         return this.client.ammPost("/v1/liquidity/remove/simulate", request);
     }
-    // ===== Swap Endpoints =====
+    // Swap Endpoints
     /**
      * Execute swap
      * @POST /v1/swap
@@ -196,7 +196,7 @@ class TypedAmmApi {
     async getUserSwaps(userPublicKey, query) {
         return this.client.ammGet(`/v1/swaps/user/${userPublicKey}`, { params: query });
     }
-    // ===== Route Swap Endpoints =====
+    // Route Swap Endpoints
     /**
      * Execute route swap
      * @POST /v1/route-swap
@@ -212,7 +212,7 @@ class TypedAmmApi {
     async simulateRouteSwap(request) {
         return this.client.ammPost("/v1/route-swap/simulate", request);
     }
-    // ===== Integrator Endpoints =====
+    // Integrator Endpoints
     /**
      * Get integrator fees across all pools
      * @GET /v1/integrators/fees
@@ -245,7 +245,7 @@ class TypedAmmApi {
     async withdrawIntegratorFees(request) {
         return this.client.ammPost("/v1/integrators/withdraw-fees", request);
     }
-    // ===== Escrow Endpoints =====
+    // Escrow Endpoints
     /**
      * Create a new escrow contract
      * @POST /v1/escrows/create
@@ -277,7 +277,7 @@ class TypedAmmApi {
     async getEscrow(escrowId) {
         return this.client.ammGet(`/v1/escrows/${escrowId}`);
     }
-    // ===== Status Endpoints =====
+    // Status Endpoints
     /**
      * Ping settlement service
      * @GET /v1/ping
@@ -285,7 +285,7 @@ class TypedAmmApi {
     async ping() {
         return this.client.ammGet("/v1/ping");
     }
-    // ===== Config Endpoints =====
+    // Config Endpoints
     /**
      * Get feature status flags
      * @GET /v1/config/feature-status
@@ -307,7 +307,7 @@ class TypedAmmApi {
     async getAllowedAssets() {
         return this.client.ammGet("/v1/config/allowed-assets");
     }
-    // ===== Clawback Endpoint =====
+    // Clawback Endpoint
     /**
      * Clawback stuck funds sent to an LP wallet
      * @POST /v1/clawback
@@ -332,6 +332,101 @@ class TypedAmmApi {
     async listClawbackableTransfers(query) {
         return this.client.ammGet("/v1/clawback-transfers/list", { params: query });
     }
+    // V3 Concentrated Liquidity Endpoints
+    /**
+     * Create a new concentrated liquidity pool (V3)
+     * @POST /v1/pools/concentrated
+     * @requires Bearer token
+     */
+    async createConcentratedPool(request) {
+        return this.client.ammPost("/v1/pools/concentrated", request);
+    }
+    /**
+     * Increase liquidity in a V3 concentrated position
+     * @POST /v1/concentrated/liquidity/increase
+     * @requires Bearer token
+     */
+    async increaseLiquidity(request) {
+        return this.client.ammPost("/v1/concentrated/liquidity/increase", request);
+    }
+    /**
+     * Decrease liquidity in a V3 concentrated position
+     * @POST /v1/concentrated/liquidity/decrease
+     * @requires Bearer token
+     */
+    async decreaseLiquidity(request) {
+        return this.client.ammPost("/v1/concentrated/liquidity/decrease", request);
+    }
+    /**
+     * Collect accumulated fees from a V3 position
+     * @POST /v1/concentrated/fees/collect
+     * @requires Bearer token
+     */
+    async collectFees(request) {
+        return this.client.ammPost("/v1/concentrated/fees/collect", request);
+    }
+    /**
+     * Rebalance a V3 position to a new tick range
+     * @POST /v1/concentrated/positions/rebalance
+     * @requires Bearer token
+     */
+    async rebalancePosition(request) {
+        return this.client.ammPost("/v1/concentrated/positions/rebalance", request);
+    }
+    /**
+     * List V3 concentrated liquidity positions
+     * @GET /v1/concentrated/positions
+     * @requires Bearer token
+     */
+    async listConcentratedPositions(query) {
+        return this.client.ammGet("/v1/concentrated/positions", { params: query });
+    }
+    /**
+     * Get pool liquidity distribution for visualization
+     * @GET /v1/concentrated/pools/{poolId}/liquidity
+     */
+    async getPoolLiquidity(poolId) {
+        return this.client.ammGet(`/v1/concentrated/pools/${poolId}/liquidity`);
+    }
+    /**
+     * Get pool ticks for simulation
+     * @GET /v1/concentrated/pools/{poolId}/ticks
+     */
+    async getPoolTicks(poolId) {
+        return this.client.ammGet(`/v1/concentrated/pools/${poolId}/ticks`);
+    }
+    /**
+     * Get user's free balance for a specific V3 pool
+     * @GET /v1/concentrated/balance/{poolId}
+     * @requires Bearer token
+     */
+    async getConcentratedBalance(poolId) {
+        return this.client.ammGet(`/v1/concentrated/balance/${poolId}`);
+    }
+    /**
+     * Get user's free balances across all V3 pools
+     * @GET /v1/concentrated/balances
+     * @requires Bearer token
+     */
+    async getConcentratedBalances() {
+        return this.client.ammGet("/v1/concentrated/balances");
+    }
+    /**
+     * Get user's free balance for a specific V3 pool (via balances endpoint)
+     * @GET /v1/concentrated/balances/{poolId}
+     * @requires Bearer token
+     */
+    async getConcentratedBalanceByPool(poolId) {
+        return this.client.ammGet(`/v1/concentrated/balances/${poolId}`);
+    }
+    /**
+     * Withdraw free balance from a V3 pool to user's Spark wallet
+     * @POST /v1/concentrated/balance/withdraw
+     * @requires Bearer token
+     */
+    async withdrawConcentratedBalance(request) {
+        return this.client.ammPost("/v1/concentrated/balance/withdraw", request);
+    }
 }
 /**
  * Error checking utilities