@skate-org/amm-core-v2 2.0.0-beta.10 → 2.0.0-beta.12

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @skate-org/amm-core-v2
 
+## 2.0.0-beta.12 — 2026-05-30
+
+Hotfix: `normalizeAmount` / `deNormalizeAmount` now handle
+`decimal > NORMALIZED_DECIMAL` instead of throwing `RangeError`
+(was: `BigInt(NORMALIZED_DECIMAL - decimal)` → negative exponent in
+`10n ** ...`).
+
+For `decimal > 18` (e.g. some SPL mints use 24), `normalizeAmount`
+scales DOWN with truncation; `deNormalizeAmount` scales UP. Also
+guards `decimal < 0` and non-integer inputs explicitly.
+
+## 2.0.0-beta.11 — 2026-05-30
+
+Adds v1-compat math helpers to close the parity gap surfaced by the
+backend v1 → v2 port of the quote lambdas. All new surface; no
+breaking changes.
+
+- `math/kernel.ts` (new module): `NORMALIZED_DECIMAL = 18`,
+  `normalizeAmount(amount, decimal)`, `deNormalizeAmount(amount, decimal)`.
+  Mirrors the kernel-side 18-decimal normalization done by every periphery
+  contract.
+- `math/tickMath.ts`: `getPriceAtTick(tick)`, `getTickAtPrice(price)`,
+  `TICK_VALUE = 1.0001`, `PRICE_ZERO`, `PRICE_INF`, `MIN_SQRT_PRICE_X96`,
+  `MAX_SQRT_PRICE_X96` (the `_X96` consts alias `{MIN,MAX}_SQRT_PRICE_LIMIT`
+  for source compat with `@skate-org/skate-app-amm`).
+- `math/liquidityMath.ts`: `getLiquidityForAmount0`,
+  `getLiquidityForAmount1` (uniswap-v3 periphery `LiquidityAmounts.sol`).
+  `Q96` is now exported (was module-private in `sqrtPriceMath.ts`).
+- `math/kernel.ts` is re-exported from the public barrel via `math/index.ts`.
+
 ## 2.0.0-beta.10 — 2026-05-29
 
 Closes the remaining STAGING / PRODUCTION gap left in beta.9: kernel

package/README.md

@@ -11,7 +11,7 @@ Zero heavy runtime deps. Pure TypeScript.
 - `EnvMode`, `DevModeConfig`, `EnvModeWithConfig`, `normalizeMode`
 - `Token`, `TokenPair`
 - `ActionStatus`, `TaskPhase`, `TaskFunctionMeta`
-- Kernel addresses: `KernelManagerAddress`, `KernelEventEmitterAddress` (DEV-only — STAGING/PRODUCTION throw `SdkError` until v2 deploys there)
+- Kernel addresses: `KernelManagerAddress`, `KernelEventEmitterAddress` (STAGING + PRODUCTION alias DEV as of `2.0.0-beta.10`)
 - Kernel chain config: `KERNEL_CHAIN_BY_MODE`, `KernelChain(mode)` — defaults every env to `CHAIN.MEGAETH`
 - Periphery deployment: `PERIPHERY_DEV`, `PeripheryManagerAddress`,
   `PeripheryEventEmitterAddress`, `SkateGatewayAddress`, `ActionBoxAddress`

package/dist/deployment/kernel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../src/deployment/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAmBjC,eAAO,MAAM,yBAAyB,+CAA+C,CAAC;AAkBtF,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAIjE,CAAC;AAEF,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,CAEhD;AAED;2EAC2E;AAC3E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,MAAM,EAAE,CAElE;AAED;uDACuD;AACvD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,MAAM,EAAE,CAEvE"}
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../src/deployment/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAqBjC,eAAO,MAAM,yBAAyB,+CAA+C,CAAC;AAkBtF,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAIjE,CAAC;AAEF,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,CAEhD;AAED;2EAC2E;AAC3E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,MAAM,EAAE,CAElE;AAED;uDACuD;AACvD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,MAAM,EAAE,CAEvE"}

package/dist/index.cjs

@@ -30,20 +30,26 @@ __export(index_exports, {
   KernelEventEmitterAddress: () => KernelEventEmitterAddress,
   KernelManagerAddress: () => KernelManagerAddress,
   MAX_SQRT_PRICE_LIMIT: () => MAX_SQRT_PRICE_LIMIT,
+  MAX_SQRT_PRICE_X96: () => MAX_SQRT_PRICE_X96,
   MAX_SQRT_RATIO: () => MAX_SQRT_RATIO,
   MAX_TICK: () => MAX_TICK,
   MIN_SQRT_PRICE_LIMIT: () => MIN_SQRT_PRICE_LIMIT,
+  MIN_SQRT_PRICE_X96: () => MIN_SQRT_PRICE_X96,
   MIN_SQRT_RATIO: () => MIN_SQRT_RATIO,
   MIN_TICK: () => MIN_TICK,
+  NORMALIZED_DECIMAL: () => NORMALIZED_DECIMAL,
   PERIPHERY_DEV: () => PERIPHERY_DEV,
   PERIPHERY_PRODUCTION: () => PERIPHERY_PRODUCTION,
   PERIPHERY_STAGING: () => PERIPHERY_STAGING,
   POOL_INFO_Dev: () => POOL_INFO_Dev,
   POOL_INFO_Production: () => POOL_INFO_Production,
   POOL_INFO_Staging: () => POOL_INFO_Staging,
+  PRICE_INF: () => PRICE_INF,
+  PRICE_ZERO: () => PRICE_ZERO,
   PeripheryDeploymentFor: () => PeripheryDeploymentFor,
   PeripheryEventEmitterAddress: () => PeripheryEventEmitterAddress,
   PeripheryManagerAddress: () => PeripheryManagerAddress,
+  Q96: () => Q96,
   SUI_DEPLOYMENT_DEV: () => SUI_DEPLOYMENT_DEV,
   SUI_DEPLOYMENT_PRODUCTION: () => SUI_DEPLOYMENT_PRODUCTION,
   SUI_DEPLOYMENT_STAGING: () => SUI_DEPLOYMENT_STAGING,
@@ -60,6 +66,7 @@ __export(index_exports, {
   SkateGatewayAddress: () => SkateGatewayAddress,
   SuiDeploymentFor: () => SuiDeploymentFor,
   SvmDeploymentFor: () => SvmDeploymentFor,
+  TICK_VALUE: () => TICK_VALUE,
   TaskPhase: () => TaskPhase,
   VM: () => VM,
   addDelta: () => addDelta,
@@ -68,6 +75,7 @@ __export(index_exports, {
   bufferFromBase58: () => bufferFromBase58,
   bytes32ToBase58: () => bytes32ToBase58,
   bytes32ToEvmAddress: () => bytes32ToEvmAddress,
+  deNormalizeAmount: () => deNormalizeAmount,
   evmAddressToBytes32: () => evmAddressToBytes32,
   findTokensBySymbol: () => findTokensBySymbol,
   fromBytes32Address: () => fromBytes32Address,
@@ -78,6 +86,8 @@ __export(index_exports, {
   getAmount1Delta: () => getAmount1Delta,
   getAmount1DeltaSigned: () => getAmount1DeltaSigned,
   getBlockExplorer: () => getBlockExplorer,
+  getLiquidityForAmount0: () => getLiquidityForAmount0,
+  getLiquidityForAmount1: () => getLiquidityForAmount1,
   getNextSqrtPriceFromAmount0RoundingUp: () => getNextSqrtPriceFromAmount0RoundingUp,
   getNextSqrtPriceFromAmount1RoundingDown: () => getNextSqrtPriceFromAmount1RoundingDown,
   getNextSqrtPriceFromInput: () => getNextSqrtPriceFromInput,
@@ -85,16 +95,19 @@ __export(index_exports, {
   getOtherTokensInPairs: () => getOtherTokensInPairs,
   getPeripheryDetailsByKernelPoolAndChainId: () => getPeripheryDetailsByKernelPoolAndChainId,
   getPoolInfoByKey: () => getPoolInfoByKey,
+  getPriceAtTick: () => getPriceAtTick,
   getSqrtRatioAtTick: () => getSqrtRatioAtTick,
   getSupportedChains: () => getSupportedChains,
   getSupportedPairs: () => getSupportedPairs,
   getSupportedTokens: () => getSupportedTokens,
+  getTickAtPrice: () => getTickAtPrice,
   getTickAtSqrtRatio: () => getTickAtSqrtRatio,
   getTokenSymbol: () => getTokenSymbol,
   hexToBase58: () => hexToBase58,
   kernelPoolToPoolKey: () => kernelPoolToPoolKey,
   mulDiv: () => mulDiv,
   mulDivRoundingUp: () => mulDivRoundingUp,
+  normalizeAmount: () => normalizeAmount,
   normalizeMode: () => normalizeMode,
   skateAdapter: () => skate_exports,
   svmBytes32Base58ToEvmAddress: () => svmBytes32Base58ToEvmAddress,
@@ -240,8 +253,8 @@ var TaskPhase = /* @__PURE__ */ ((TaskPhase2) => {
 })(TaskPhase || {});
 
 // src/deployment/kernel.ts
-var KERNEL_MANAGER_Dev = "0x17B7207837e8884f7f687f1f4057751BDAf70a01";
-var KERNEL_EVENT_EMITTER_Dev = "0x8989b3ecb65f250ab7A0DC03589B0Cc8b8b04b81";
+var KERNEL_MANAGER = "0x17B7207837e8884f7f687f1f4057751BDAf70a01";
+var KERNEL_EVENT_EMITTER = "0x8989b3ecb65f250ab7A0DC03589B0Cc8b8b04b81";
 var KERNEL_POOL_USDC_USDT_Dev = "0x2c23334eE3b030e6bacEDEDf7C511eEA08Cf7E7e";
 var KERNEL_CHAIN_BY_MODE = {
   DEV: 4326 /* MEGAETH */,
@@ -252,10 +265,10 @@ function KernelChain(mode) {
   return KERNEL_CHAIN_BY_MODE[mode];
 }
 function KernelManagerAddress(_mode) {
-  return KERNEL_MANAGER_Dev;
+  return KERNEL_MANAGER;
 }
 function KernelEventEmitterAddress(_mode) {
-  return KERNEL_EVENT_EMITTER_Dev;
+  return KERNEL_EVENT_EMITTER;
 }
 
 // src/deployment/periphery.ts
@@ -746,6 +759,11 @@ var MIN_SQRT_RATIO = 4295128739n;
 var MAX_SQRT_RATIO = 1461446703485210103287273052203988822378723970342n;
 var MIN_SQRT_PRICE_LIMIT = MIN_SQRT_RATIO + 1n;
 var MAX_SQRT_PRICE_LIMIT = MAX_SQRT_RATIO - 1n;
+var MIN_SQRT_PRICE_X96 = MIN_SQRT_PRICE_LIMIT;
+var MAX_SQRT_PRICE_X96 = MAX_SQRT_PRICE_LIMIT;
+var TICK_VALUE = 1.0001;
+var PRICE_ZERO = 0;
+var PRICE_INF = 2 ** 32 - 1;
 function getSqrtRatioAtTick(tick) {
   if (!Number.isInteger(tick)) {
     throw new Error("TickMath: tick must be an integer");
@@ -874,6 +892,17 @@ function toInt24(x) {
   const signed = truncated >= 1n << 23n ? truncated - (1n << 24n) : truncated;
   return Number(signed);
 }
+function getPriceAtTick(tick) {
+  const sqrtPriceX96 = getSqrtRatioAtTick(tick);
+  const Q962 = 1n << 96n;
+  return (Number(sqrtPriceX96) / Number(Q962)) ** 2;
+}
+function getTickAtPrice(price) {
+  if (price < 0) {
+    throw new Error(`getTickAtPrice: invalid price=${price}`);
+  }
+  return Math.round(Math.log(price) / Math.log(TICK_VALUE));
+}
 
 // src/math/fullMath.ts
 var MAX_UINT2562 = (1n << 256n) - 1n;
@@ -1081,6 +1110,41 @@ function addDelta(x, y) {
   }
   return z;
 }
+function getLiquidityForAmount0(sqrtRatioAX96, sqrtRatioBX96, amount0) {
+  if (sqrtRatioAX96 > sqrtRatioBX96) {
+    [sqrtRatioAX96, sqrtRatioBX96] = [sqrtRatioBX96, sqrtRatioAX96];
+  }
+  return amount0 * sqrtRatioAX96 * sqrtRatioBX96 / (Q96 * (sqrtRatioBX96 - sqrtRatioAX96));
+}
+function getLiquidityForAmount1(sqrtRatioAX96, sqrtRatioBX96, amount1) {
+  if (sqrtRatioAX96 > sqrtRatioBX96) {
+    [sqrtRatioAX96, sqrtRatioBX96] = [sqrtRatioBX96, sqrtRatioAX96];
+  }
+  return amount1 * Q96 / (sqrtRatioBX96 - sqrtRatioAX96);
+}
+
+// src/math/kernel.ts
+var NORMALIZED_DECIMAL = 18;
+function normalizeAmount(amount, decimal) {
+  if (decimal === NORMALIZED_DECIMAL) return amount;
+  if (!Number.isInteger(decimal) || decimal < 0) {
+    throw new Error(`normalizeAmount: invalid decimal=${decimal}`);
+  }
+  if (decimal < NORMALIZED_DECIMAL) {
+    return amount * 10n ** BigInt(NORMALIZED_DECIMAL - decimal);
+  }
+  return amount / 10n ** BigInt(decimal - NORMALIZED_DECIMAL);
+}
+function deNormalizeAmount(amount, decimal) {
+  if (decimal === NORMALIZED_DECIMAL) return amount;
+  if (!Number.isInteger(decimal) || decimal < 0) {
+    throw new Error(`deNormalizeAmount: invalid decimal=${decimal}`);
+  }
+  if (decimal < NORMALIZED_DECIMAL) {
+    return amount / 10n ** BigInt(NORMALIZED_DECIMAL - decimal);
+  }
+  return amount * 10n ** BigInt(decimal - NORMALIZED_DECIMAL);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ActionBoxAddress,
@@ -1093,20 +1157,26 @@ function addDelta(x, y) {
   KernelEventEmitterAddress,
   KernelManagerAddress,
   MAX_SQRT_PRICE_LIMIT,
+  MAX_SQRT_PRICE_X96,
   MAX_SQRT_RATIO,
   MAX_TICK,
   MIN_SQRT_PRICE_LIMIT,
+  MIN_SQRT_PRICE_X96,
   MIN_SQRT_RATIO,
   MIN_TICK,
+  NORMALIZED_DECIMAL,
   PERIPHERY_DEV,
   PERIPHERY_PRODUCTION,
   PERIPHERY_STAGING,
   POOL_INFO_Dev,
   POOL_INFO_Production,
   POOL_INFO_Staging,
+  PRICE_INF,
+  PRICE_ZERO,
   PeripheryDeploymentFor,
   PeripheryEventEmitterAddress,
   PeripheryManagerAddress,
+  Q96,
   SUI_DEPLOYMENT_DEV,
   SUI_DEPLOYMENT_PRODUCTION,
   SUI_DEPLOYMENT_STAGING,
@@ -1123,6 +1193,7 @@ function addDelta(x, y) {
   SkateGatewayAddress,
   SuiDeploymentFor,
   SvmDeploymentFor,
+  TICK_VALUE,
   TaskPhase,
   VM,
   addDelta,
@@ -1131,6 +1202,7 @@ function addDelta(x, y) {
   bufferFromBase58,
   bytes32ToBase58,
   bytes32ToEvmAddress,
+  deNormalizeAmount,
   evmAddressToBytes32,
   findTokensBySymbol,
   fromBytes32Address,
@@ -1141,6 +1213,8 @@ function addDelta(x, y) {
   getAmount1Delta,
   getAmount1DeltaSigned,
   getBlockExplorer,
+  getLiquidityForAmount0,
+  getLiquidityForAmount1,
   getNextSqrtPriceFromAmount0RoundingUp,
   getNextSqrtPriceFromAmount1RoundingDown,
   getNextSqrtPriceFromInput,
@@ -1148,16 +1222,19 @@ function addDelta(x, y) {
   getOtherTokensInPairs,
   getPeripheryDetailsByKernelPoolAndChainId,
   getPoolInfoByKey,
+  getPriceAtTick,
   getSqrtRatioAtTick,
   getSupportedChains,
   getSupportedPairs,
   getSupportedTokens,
+  getTickAtPrice,
   getTickAtSqrtRatio,
   getTokenSymbol,
   hexToBase58,
   kernelPoolToPoolKey,
   mulDiv,
   mulDivRoundingUp,
+  normalizeAmount,
   normalizeMode,
   skateAdapter,
   svmBytes32Base58ToEvmAddress,