@skate-org/amm-core-v2 1.0.0 → 2.0.0-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # @skate-org/amm-core-v2
 
+## 2.0.0-alpha.3 — 2026-05-06
+
+Lockstep bump — paired with the SVM/Sui efficiency pass in
+`@skate-org/amm-svm-v2` and `@skate-org/amm-sui-v2`. This package's
+source is unchanged versus `2.0.0-alpha.2`.
+
+## 2.0.0-alpha.2 — 2026-05-05
+
+Plan C of the SVM/Sui integration. Adds `@skate-org/amm-sui-v2` to
+the workspace; this package's source is unchanged versus
+`2.0.0-alpha.1` (re-versioned in lockstep).
+
+## 2.0.0-alpha.1 — 2026-05-05
+
+Plan B of the SVM/Sui integration. Adds `@skate-org/amm-svm-v2` to
+the workspace; this package's source is unchanged versus
+`2.0.0-alpha.0` (re-versioned in lockstep).
+
+## 2.0.0-alpha.0 — 2026-05-05
+
+Plan A of the SVM/Sui integration (see
+docs/superpowers/specs/2026-05-04-svm-sui-integration-design.md).
+
+- Add uniswap-v3 math module (`tickMath`, `sqrtPriceMath`,
+  `liquidityMath`, `fullMath`). Relocated from
+  `@skate-org/amm-evm-v2`.
+- Add `EvmChain` / `SvmChain` / `SuiChain` literal-union sub-types of
+  `CHAIN`.
+- **Breaking:** `PoolInfoType.peripheryInfo` is now a chain-id-
+  discriminated mapped type. EVM chain entries narrow to
+  `EvmPeripheryInfo`; SVM chain entries to `SvmPeripheryInfo`; Sui
+  to `SuiPeripheryInfo`. Code that read
+  `pool.peripheryInfo[chain].address` as `0x${string}` unconditionally
+  now type-narrows by chain.
+- New named types `EvmPeripheryInfo`, `SvmPeripheryInfo`,
+  `SuiPeripheryInfo`, `PeripheryInfoFor<K>`.
+- Cross-VM utilities (`base58ToBytes32`, `evmAddressToBytes32`,
+  `bytes32ToBase58`, `toBytes32Address`, `fromBytes32Address`)
+  unchanged in this release — already in core under
+  `adapter/skate.ts`.
+
 ## 1.0.0 — 2026-05-04
 
 Realigning all four `@skate-org/amm-*-v2` packages at a single version

package/README.md

@@ -7,7 +7,7 @@ Zero heavy runtime deps. Pure TypeScript.
 
 ## Surface (high-level)
 
-- `CHAIN`, `VM`, `vmTypeFromChain`, `getBlockExplorer`
+- `CHAIN`, `VM`, `EvmChain` / `SvmChain` / `SuiChain`, `vmTypeFromChain`, `getBlockExplorer`
 - `EnvMode`, `DevModeConfig`, `EnvModeWithConfig`, `normalizeMode`
 - `Token`, `TokenPair`
 - `ActionStatus`, `TaskPhase`, `TaskFunctionMeta`
@@ -15,6 +15,9 @@ Zero heavy runtime deps. Pure TypeScript.
 - Periphery deployment: `PERIPHERY_DEV`, `PeripheryManagerAddress`,
   `PeripheryEventEmitterAddress`, `SkateGatewayAddress`, `ActionBoxAddress`
 - Pool tables: `POOL_INFO_Dev`, `POOL_INFO_Staging`, `POOL_INFO_Production`
+- Periphery info types: `EvmPeripheryInfo`, `SvmPeripheryInfo`, `SuiPeripheryInfo`, `PeripheryInfoFor<K>`
+- Uniswap-v3 math: `getSqrtRatioAtTick`, `getTickAtSqrtRatio`, `MIN_TICK` / `MAX_TICK`, `MIN_SQRT_RATIO` / `MAX_SQRT_RATIO`, `MIN_SQRT_PRICE_LIMIT` / `MAX_SQRT_PRICE_LIMIT`, `mulDiv`, `getAmount0Delta`, `getAmount1Delta`, `computePositionAmounts`
+- Cross-VM adapter: `base58ToBytes32`, `evmAddressToBytes32`, `bytes32ToBase58`, `toBytes32Address`, `fromBytes32Address`
 - Errors: `SdkError` (base for all package errors)
 
 ## Install
@@ -26,7 +29,9 @@ pnpm add @skate-org/amm-core-v2
 ## Companion packages
 
 - [`@skate-org/amm-api-v2`](https://npmjs.com/package/@skate-org/amm-api-v2) — REST clients
-- [`@skate-org/amm-evm-v2`](https://npmjs.com/package/@skate-org/amm-evm-v2) — viem clients, readers, math
+- [`@skate-org/amm-evm-v2`](https://npmjs.com/package/@skate-org/amm-evm-v2) — viem clients, readers, submitters
+- [`@skate-org/amm-svm-v2`](https://npmjs.com/package/@skate-org/amm-svm-v2) — Solana / Eclipse periphery
+- [`@skate-org/amm-sui-v2`](https://npmjs.com/package/@skate-org/amm-sui-v2) — Sui periphery
 - [`@skate-org/amm-v2`](https://npmjs.com/package/@skate-org/amm-v2) — umbrella
 
 See `CHANGELOG.md` for version history.

package/dist/deployment/aggregated/_type_.d.ts

@@ -1,13 +1,47 @@
-import { TokenPair } from "../../types/pair";
+import type { Token } from "../../types/pair";
+import type { EvmChain, SvmChain, SuiChain } from "../../types/chain-vm";
+import type { CHAIN } from "../../types/chain";
 export type PoolKey = string;
+export interface EvmPeripheryInfo {
+    /** Periphery contract address on the source EVM chain. */
+    address: `0x${string}`;
+    token0: Token;
+    token1: Token;
+    /** Human-readable chain label (e.g. "ARBITRUM"). */
+    chain: string;
+}
+export interface SvmPeripheryInfo {
+    /** Periphery pool PDA (base58 string). */
+    peripheryPool: string;
+    /** Periphery manager program address (base58 string). */
+    manager: string;
+    /** SPL or Token-2022 program id for token0. */
+    tokenProgramId0: string;
+    /** SPL or Token-2022 program id for token1. */
+    tokenProgramId1: string;
+    token0: Token;
+    token1: Token;
+    chain: string;
+}
+export interface SuiPeripheryInfo {
+    /** Sui object id of the periphery pool (0x-prefixed). */
+    poolId: string;
+    /** Sui object id of the manager cap. */
+    managerCapId: string;
+    /** Sui package id that owns the periphery module. */
+    peripheryPackage: string;
+    token0: Token;
+    token1: Token;
+    chain: string;
+}
+export type PeripheryInfoFor<K extends CHAIN> = K extends EvmChain ? EvmPeripheryInfo : K extends SvmChain ? SvmPeripheryInfo : K extends SuiChain ? SuiPeripheryInfo : never;
 export type PoolInfoType = Record<PoolKey, {
     kernelPool: `0x${string}`;
     token0: string;
     token1: string;
-    peripheryInfo: Record<number, TokenPair & {
-        address: `0x${string}` | string;
-        chain: string;
-    }>;
     feeBps: number;
+    peripheryInfo: {
+        [K in CHAIN]?: PeripheryInfoFor<K>;
+    };
 }>;
 //# sourceMappingURL=_type_.d.ts.map

package/dist/deployment/aggregated/_type_.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_type_.d.ts","sourceRoot":"","sources":["../../../src/deployment/aggregated/_type_.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,MAAM,MAAM,YAAY,GAAG,MAAM,CAC/B,OAAO,EACP;IACE,UAAU,EAAE,KAAK,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CACnB,MAAM,EACN,SAAS,GAAG;QACV,OAAO,EAAE,KAAK,MAAM,EAAE,GAAG,MAAM,CAAC;QAChC,KAAK,EAAE,MAAM,CAAC;KACf,CACF,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;CAChB,CACF,CAAC"}
+{"version":3,"file":"_type_.d.ts","sourceRoot":"","sources":["../../../src/deployment/aggregated/_type_.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;IACd,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,KAAK,IAC1C,CAAC,SAAS,QAAQ,GAAG,gBAAgB,GACnC,CAAC,SAAS,QAAQ,GAAG,gBAAgB,GACrC,CAAC,SAAS,QAAQ,GAAG,gBAAgB,GACrC,KAAK,CAAC;AAEV,MAAM,MAAM,YAAY,GAAG,MAAM,CAC/B,OAAO,EACP;IACE,UAAU,EAAE,KAAK,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE;SAAG,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;KAAE,CAAC;CACvD,CACF,CAAC"}

package/dist/deployment/aggregated/retrieval.d.ts

@@ -1,4 +1,5 @@
 import { CHAIN, EnvMode, Token, TokenPair } from "../../types";
+import type { PeripheryInfoFor } from "./_type_";
 import { PoolInfoType, PoolKey } from "./_type_";
 export declare function getAllPoolInfo(mode?: EnvMode): PoolInfoType;
 export declare function getAllPoolKeys(mode?: EnvMode): PoolKey[];
@@ -6,11 +7,8 @@ export declare function getPoolInfoByKey(key: PoolKey, mode?: EnvMode): {
     kernelPool: `0x${string}`;
     token0: string;
     token1: string;
-    peripheryInfo: Record<number, TokenPair & {
-        address: `0x${string}` | string;
-        chain: string;
-    }>;
     feeBps: number;
+    peripheryInfo: { [K in CHAIN]?: PeripheryInfoFor<K>; };
 } | null;
 export declare function getSupportedChains(mode?: EnvMode): CHAIN[];
 export declare function getSupportedPairs(chainId: CHAIN, mode?: EnvMode): (TokenPair & {
@@ -19,8 +17,6 @@ export declare function getSupportedPairs(chainId: CHAIN, mode?: EnvMode): (Toke
 export declare function getSupportedTokens(chainId: CHAIN, mode?: EnvMode): Token[];
 export declare function getOtherTokensInPairs(chainId: CHAIN, tokenAddress: string, mode?: EnvMode): Token[];
 export declare function kernelPoolToPoolKey(kernelPool: `0x${string}`, mode?: EnvMode): PoolKey;
-export declare function getPeripheryDetailsByKernelPoolAndChainId(kernelPool: `0x${string}`, chainId: number, mode?: EnvMode): (TokenPair & {
-    address: `0x${string}` | string;
-    chain: string;
-}) | null;
+export declare function getPeripheryDetailsByKernelPoolAndChainId<K extends CHAIN>(kernelPool: `0x${string}`, chainId: K, mode?: EnvMode): PeripheryInfoFor<K> | null;
+export declare function getPeripheryDetailsByKernelPoolAndChainId(kernelPool: `0x${string}`, chainId: number, mode?: EnvMode): PeripheryInfoFor<CHAIN> | null;
 //# sourceMappingURL=retrieval.d.ts.map

package/dist/deployment/aggregated/retrieval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../../../src/deployment/aggregated/retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI/D,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEjD,wBAAgB,cAAc,CAAC,IAAI,GAAE,OAAsB,GAAG,YAAY,CAMzE;AAED,wBAAgB,cAAc,CAAC,IAAI,GAAE,OAAsB,GAAG,OAAO,EAAE,CAEtE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE,OAAsB;;;;;;;;;SAE1E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,OAAsB,GAAG,KAAK,EAAE,CASxE;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,KAAK,EACd,IAAI,GAAE,OAAsB,GAC3B,CAAC,SAAS,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,EAAE,CActC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,GAAE,OAAsB,GAAG,KAAK,EAAE,CAcxF;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,KAAK,EACd,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE,OAAsB,GAC3B,KAAK,EAAE,CAeT;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,KAAK,MAAM,EAAE,EAAE,IAAI,GAAE,OAAsB,GAAG,OAAO,CAOpG;AAED,wBAAgB,yCAAyC,CACvD,UAAU,EAAE,KAAK,MAAM,EAAE,EACzB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,OAAsB;;;UAK7B"}
+{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../../../src/deployment/aggregated/retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAIjD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEjD,wBAAgB,cAAc,CAAC,IAAI,GAAE,OAAsB,GAAG,YAAY,CAMzE;AAED,wBAAgB,cAAc,CAAC,IAAI,GAAE,OAAsB,GAAG,OAAO,EAAE,CAEtE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE,OAAsB;;;;;iCAsBhE,CAAC;SApBX;AAED,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,OAAsB,GAAG,KAAK,EAAE,CASxE;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,KAAK,EACd,IAAI,GAAE,OAAsB,GAC3B,CAAC,SAAS,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,EAAE,CActC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,GAAE,OAAsB,GAAG,KAAK,EAAE,CAcxF;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,KAAK,EACd,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE,OAAsB,GAC3B,KAAK,EAAE,CAeT;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,KAAK,MAAM,EAAE,EAAE,IAAI,GAAE,OAAsB,GAAG,OAAO,CAOpG;AAED,wBAAgB,yCAAyC,CAAC,CAAC,SAAS,KAAK,EACvE,UAAU,EAAE,KAAK,MAAM,EAAE,EACzB,OAAO,EAAE,CAAC,EACV,IAAI,CAAC,EAAE,OAAO,GACb,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;AAC9B,wBAAgB,yCAAyC,CACvD,UAAU,EAAE,KAAK,MAAM,EAAE,EACzB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,OAAO,GACb,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC"}

package/dist/index.cjs

@@ -37,6 +37,12 @@ __export(index_exports, {
   KERNEL_POOL_USDC_USDT_Dev: () => KERNEL_POOL_USDC_USDT_Dev,
   KernelEventEmitterAddress: () => KernelEventEmitterAddress,
   KernelManagerAddress: () => KernelManagerAddress,
+  MAX_SQRT_PRICE_LIMIT: () => MAX_SQRT_PRICE_LIMIT,
+  MAX_SQRT_RATIO: () => MAX_SQRT_RATIO,
+  MAX_TICK: () => MAX_TICK,
+  MIN_SQRT_PRICE_LIMIT: () => MIN_SQRT_PRICE_LIMIT,
+  MIN_SQRT_RATIO: () => MIN_SQRT_RATIO,
+  MIN_TICK: () => MIN_TICK,
   PERIPHERY_DEV: () => PERIPHERY_DEV,
   PERIPHERY_PROD: () => PERIPHERY_PROD,
   PERIPHERY_STAGING: () => PERIPHERY_STAGING,
@@ -50,6 +56,7 @@ __export(index_exports, {
   SkateGatewayAddress: () => SkateGatewayAddress,
   TaskPhase: () => TaskPhase,
   VM: () => VM,
+  addDelta: () => addDelta,
   base58ToBytes32: () => base58ToBytes32,
   base58ToHex: () => base58ToHex,
   bufferFromBase58: () => bufferFromBase58,
@@ -60,17 +67,29 @@ __export(index_exports, {
   fromBytes32Address: () => fromBytes32Address,
   getAllPoolInfo: () => getAllPoolInfo,
   getAllPoolKeys: () => getAllPoolKeys,
+  getAmount0Delta: () => getAmount0Delta,
+  getAmount0DeltaSigned: () => getAmount0DeltaSigned,
+  getAmount1Delta: () => getAmount1Delta,
+  getAmount1DeltaSigned: () => getAmount1DeltaSigned,
   getBlockExplorer: () => getBlockExplorer,
+  getNextSqrtPriceFromAmount0RoundingUp: () => getNextSqrtPriceFromAmount0RoundingUp,
+  getNextSqrtPriceFromAmount1RoundingDown: () => getNextSqrtPriceFromAmount1RoundingDown,
+  getNextSqrtPriceFromInput: () => getNextSqrtPriceFromInput,
+  getNextSqrtPriceFromOutput: () => getNextSqrtPriceFromOutput,
   getOtherTokensInPairs: () => getOtherTokensInPairs,
   getPeripheryDetailsByKernelPoolAndChainId: () => getPeripheryDetailsByKernelPoolAndChainId,
   getPoolInfoByKey: () => getPoolInfoByKey,
+  getSqrtRatioAtTick: () => getSqrtRatioAtTick,
   getSupportedChains: () => getSupportedChains,
   getSupportedPairs: () => getSupportedPairs,
   getSupportedTokens: () => getSupportedTokens,
+  getTickAtSqrtRatio: () => getTickAtSqrtRatio,
   hexToBase58: () => hexToBase58,
   isHexString: () => isHexString,
   isHexStringLoose: () => isHexStringLoose,
   kernelPoolToPoolKey: () => kernelPoolToPoolKey,
+  mulDiv: () => mulDiv,
+  mulDivRoundingUp: () => mulDivRoundingUp,
   normalizeMode: () => normalizeMode,
   skateAdapter: () => skate_exports,
   toBase58: () => toBase58,
@@ -597,6 +616,352 @@ var SdkError = class extends Error {
     super(message, options);
   }
 };
+
+// src/math/tickMath.ts
+var MAX_UINT256 = (1n << 256n) - 1n;
+var Q160_MASK = (1n << 160n) - 1n;
+var Q256_MOD = 1n << 256n;
+var MIN_TICK = -887272;
+var MAX_TICK = 887272;
+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;
+function getSqrtRatioAtTick(tick) {
+  if (!Number.isInteger(tick)) {
+    throw new Error("TickMath: tick must be an integer");
+  }
+  const absTick = BigInt(tick < 0 ? -tick : tick);
+  if (absTick > BigInt(MAX_TICK)) {
+    throw new Error("T");
+  }
+  let ratio = (absTick & 0x1n) !== 0n ? 0xfffcb933bd6fad37aa2d162d1a594001n : 0x100000000000000000000000000000000n;
+  if ((absTick & 0x2n) !== 0n)
+    ratio = (ratio * 0xfff97272373d413259a46990580e213an & MAX_UINT256) >> 128n;
+  if ((absTick & 0x4n) !== 0n)
+    ratio = (ratio * 0xfff2e50f5f656932ef12357cf3c7fdccn & MAX_UINT256) >> 128n;
+  if ((absTick & 0x8n) !== 0n)
+    ratio = (ratio * 0xffe5caca7e10e4e61c3624eaa0941cd0n & MAX_UINT256) >> 128n;
+  if ((absTick & 0x10n) !== 0n)
+    ratio = (ratio * 0xffcb9843d60f6159c9db58835c926644n & MAX_UINT256) >> 128n;
+  if ((absTick & 0x20n) !== 0n)
+    ratio = (ratio * 0xff973b41fa98c081472e6896dfb254c0n & MAX_UINT256) >> 128n;
+  if ((absTick & 0x40n) !== 0n)
+    ratio = (ratio * 0xff2ea16466c96a3843ec78b326b52861n & MAX_UINT256) >> 128n;
+  if ((absTick & 0x80n) !== 0n)
+    ratio = (ratio * 0xfe5dee046a99a2a811c461f1969c3053n & MAX_UINT256) >> 128n;
+  if ((absTick & 0x100n) !== 0n)
+    ratio = (ratio * 0xfcbe86c7900a88aedcffc83b479aa3a4n & MAX_UINT256) >> 128n;
+  if ((absTick & 0x200n) !== 0n)
+    ratio = (ratio * 0xf987a7253ac413176f2b074cf7815e54n & MAX_UINT256) >> 128n;
+  if ((absTick & 0x400n) !== 0n)
+    ratio = (ratio * 0xf3392b0822b70005940c7a398e4b70f3n & MAX_UINT256) >> 128n;
+  if ((absTick & 0x800n) !== 0n)
+    ratio = (ratio * 0xe7159475a2c29b7443b29c7fa6e889d9n & MAX_UINT256) >> 128n;
+  if ((absTick & 0x1000n) !== 0n)
+    ratio = (ratio * 0xd097f3bdfd2022b8845ad8f792aa5825n & MAX_UINT256) >> 128n;
+  if ((absTick & 0x2000n) !== 0n)
+    ratio = (ratio * 0xa9f746462d870fdf8a65dc1f90e061e5n & MAX_UINT256) >> 128n;
+  if ((absTick & 0x4000n) !== 0n)
+    ratio = (ratio * 0x70d869a156d2a1b890bb3df62baf32f7n & MAX_UINT256) >> 128n;
+  if ((absTick & 0x8000n) !== 0n)
+    ratio = (ratio * 0x31be135f97d08fd981231505542fcfa6n & MAX_UINT256) >> 128n;
+  if ((absTick & 0x10000n) !== 0n)
+    ratio = (ratio * 0x9aa508b5b7a84e1c677de54f3e99bc9n & MAX_UINT256) >> 128n;
+  if ((absTick & 0x20000n) !== 0n)
+    ratio = (ratio * 0x5d6af8dedb81196699c329225ee604n & MAX_UINT256) >> 128n;
+  if ((absTick & 0x40000n) !== 0n)
+    ratio = (ratio * 0x2216e584f5fa1ea926041bedfe98n & MAX_UINT256) >> 128n;
+  if ((absTick & 0x80000n) !== 0n)
+    ratio = (ratio * 0x48a170391f7dc42444e8fa2n & MAX_UINT256) >> 128n;
+  if (tick > 0) ratio = MAX_UINT256 / ratio;
+  const shifted = ratio >> 32n;
+  const remainder = ratio & (1n << 32n) - 1n;
+  const sqrtPriceX96 = remainder === 0n ? shifted : shifted + 1n;
+  return sqrtPriceX96 & Q160_MASK;
+}
+function getTickAtSqrtRatio(sqrtPriceX96) {
+  if (sqrtPriceX96 < MIN_SQRT_RATIO || sqrtPriceX96 >= MAX_SQRT_RATIO) {
+    throw new Error("R");
+  }
+  const ratio = sqrtPriceX96 << 32n;
+  let r = ratio;
+  let msb = 0n;
+  {
+    const f = r > 0xffffffffffffffffffffffffffffffffn ? 128n : 0n;
+    msb |= f;
+    r >>= f;
+  }
+  {
+    const f = r > 0xffffffffffffffffn ? 64n : 0n;
+    msb |= f;
+    r >>= f;
+  }
+  {
+    const f = r > 0xffffffffn ? 32n : 0n;
+    msb |= f;
+    r >>= f;
+  }
+  {
+    const f = r > 0xffffn ? 16n : 0n;
+    msb |= f;
+    r >>= f;
+  }
+  {
+    const f = r > 0xffn ? 8n : 0n;
+    msb |= f;
+    r >>= f;
+  }
+  {
+    const f = r > 0xfn ? 4n : 0n;
+    msb |= f;
+    r >>= f;
+  }
+  {
+    const f = r > 0x3n ? 2n : 0n;
+    msb |= f;
+    r >>= f;
+  }
+  {
+    const f = r > 0x1n ? 1n : 0n;
+    msb |= f;
+  }
+  if (msb >= 128n) r = ratio >> msb - 127n;
+  else r = ratio << 127n - msb & MAX_UINT256;
+  const offset = msb - 128n;
+  let log_2 = offset << 64n & MAX_UINT256;
+  for (let i = 0; i < 14; i++) {
+    r = r * r >> 127n;
+    const f = r >> 128n;
+    log_2 |= f << BigInt(63 - i);
+    r >>= f;
+  }
+  const log_2_signed = toInt256(log_2);
+  const log_sqrt10001 = log_2_signed * 255738958999603826347141n;
+  const tickLowBig = log_sqrt10001 - 3402992956809132418596140100660247210n >> 128n;
+  const tickHiBig = log_sqrt10001 + 291339464771989622907027621153398088495n >> 128n;
+  const tickLow = toInt24(tickLowBig);
+  const tickHi = toInt24(tickHiBig);
+  if (tickLow === tickHi) return tickLow;
+  return getSqrtRatioAtTick(tickHi) <= sqrtPriceX96 ? tickHi : tickLow;
+}
+function toInt256(x) {
+  const masked = x & MAX_UINT256;
+  return masked >= 1n << 255n ? masked - Q256_MOD : masked;
+}
+function toInt24(x) {
+  const mask = (1n << 24n) - 1n;
+  const truncated = x & mask;
+  const signed = truncated >= 1n << 23n ? truncated - (1n << 24n) : truncated;
+  return Number(signed);
+}
+
+// src/math/fullMath.ts
+var MAX_UINT2562 = (1n << 256n) - 1n;
+function mulDiv(a, b, denom) {
+  if (denom === 0n) {
+    throw new Error("FullMath: division by zero");
+  }
+  if (a < 0n || b < 0n || denom < 0n) {
+    throw new Error("FullMath: negative input");
+  }
+  const product = a * b;
+  const result = product / denom;
+  if (result > MAX_UINT2562) {
+    throw new Error("FullMath: result overflows uint256");
+  }
+  return result;
+}
+function mulDivRoundingUp(a, b, denom) {
+  if (denom === 0n) {
+    throw new Error("FullMath: division by zero");
+  }
+  if (a < 0n || b < 0n || denom < 0n) {
+    throw new Error("FullMath: negative input");
+  }
+  const product = a * b;
+  const quotient = product / denom;
+  if (quotient > MAX_UINT2562) {
+    throw new Error("FullMath: result overflows uint256");
+  }
+  if (product % denom !== 0n) {
+    if (quotient === MAX_UINT2562) {
+      throw new Error("FullMath: rounding up overflows uint256");
+    }
+    return quotient + 1n;
+  }
+  return quotient;
+}
+
+// src/math/sqrtPriceMath.ts
+var MAX_UINT128 = (1n << 128n) - 1n;
+var MAX_UINT160 = (1n << 160n) - 1n;
+var MAX_UINT2563 = (1n << 256n) - 1n;
+var Q96_RESOLUTION = 96n;
+var Q96 = 1n << 96n;
+function assertUint160(x, name) {
+  if (x < 0n || x > MAX_UINT160) {
+    throw new Error(`SqrtPriceMath: ${name} out of uint160 range`);
+  }
+}
+function assertUint128(x, name) {
+  if (x < 0n || x > MAX_UINT128) {
+    throw new Error(`SqrtPriceMath: ${name} out of uint128 range`);
+  }
+}
+function assertUint256(x, name) {
+  if (x < 0n || x > MAX_UINT2563) {
+    throw new Error(`SqrtPriceMath: ${name} out of uint256 range`);
+  }
+}
+function divRoundingUp(x, y) {
+  if (y === 0n) throw new Error("SqrtPriceMath: div by zero");
+  return x / y + (x % y === 0n ? 0n : 1n);
+}
+function toUint160(x) {
+  if (x > MAX_UINT160) throw new Error("SqrtPriceMath: toUint160 overflow");
+  return x;
+}
+function getNextSqrtPriceFromAmount0RoundingUp(sqrtPX96, liquidity, amount, add) {
+  assertUint160(sqrtPX96, "sqrtPX96");
+  assertUint128(liquidity, "liquidity");
+  assertUint256(amount, "amount");
+  if (amount === 0n) return sqrtPX96;
+  const numerator1 = liquidity << Q96_RESOLUTION;
+  if (add) {
+    const product = amount * sqrtPX96 & MAX_UINT2563;
+    const noOverflow = amount === 0n || product / amount === sqrtPX96;
+    if (noOverflow) {
+      const denominator = numerator1 + product;
+      if (denominator >= numerator1) {
+        return toUint160(mulDivRoundingUp(numerator1, sqrtPX96, denominator));
+      }
+    }
+    if (sqrtPX96 === 0n) throw new Error("SqrtPriceMath: sqrtPX96 == 0");
+    const denom = numerator1 / sqrtPX96 + amount;
+    return toUint160(divRoundingUp(numerator1, denom));
+  } else {
+    const product = amount * sqrtPX96 & MAX_UINT2563;
+    const noOverflow = amount === 0n || product / amount === sqrtPX96;
+    if (!noOverflow || numerator1 <= product) {
+      throw new Error("SqrtPriceMath: getNextSqrtPriceFromAmount0 denom <= 0");
+    }
+    const denominator = numerator1 - product;
+    return toUint160(mulDivRoundingUp(numerator1, sqrtPX96, denominator));
+  }
+}
+function getNextSqrtPriceFromAmount1RoundingDown(sqrtPX96, liquidity, amount, add) {
+  assertUint160(sqrtPX96, "sqrtPX96");
+  assertUint128(liquidity, "liquidity");
+  assertUint256(amount, "amount");
+  if (add) {
+    const quotient = amount <= MAX_UINT160 ? (amount << Q96_RESOLUTION) / liquidity : mulDiv(amount, Q96, liquidity);
+    return toUint160(sqrtPX96 + quotient);
+  } else {
+    const quotient = amount <= MAX_UINT160 ? divRoundingUp(amount << Q96_RESOLUTION, liquidity) : mulDivRoundingUp(amount, Q96, liquidity);
+    if (sqrtPX96 <= quotient) {
+      throw new Error("SqrtPriceMath: sqrtPX96 <= quotient");
+    }
+    return sqrtPX96 - quotient;
+  }
+}
+function getNextSqrtPriceFromInput(sqrtPX96, liquidity, amountIn, zeroForOne) {
+  if (sqrtPX96 <= 0n) throw new Error("SqrtPriceMath: sqrtPX96 must be > 0");
+  if (liquidity <= 0n)
+    throw new Error("SqrtPriceMath: liquidity must be > 0");
+  return zeroForOne ? getNextSqrtPriceFromAmount0RoundingUp(sqrtPX96, liquidity, amountIn, true) : getNextSqrtPriceFromAmount1RoundingDown(
+    sqrtPX96,
+    liquidity,
+    amountIn,
+    true
+  );
+}
+function getNextSqrtPriceFromOutput(sqrtPX96, liquidity, amountOut, zeroForOne) {
+  if (sqrtPX96 <= 0n) throw new Error("SqrtPriceMath: sqrtPX96 must be > 0");
+  if (liquidity <= 0n)
+    throw new Error("SqrtPriceMath: liquidity must be > 0");
+  return zeroForOne ? getNextSqrtPriceFromAmount1RoundingDown(
+    sqrtPX96,
+    liquidity,
+    amountOut,
+    false
+  ) : getNextSqrtPriceFromAmount0RoundingUp(
+    sqrtPX96,
+    liquidity,
+    amountOut,
+    false
+  );
+}
+function getAmount0Delta(sqrtRatioAX96, sqrtRatioBX96, liquidity, roundUp) {
+  assertUint160(sqrtRatioAX96, "sqrtRatioAX96");
+  assertUint160(sqrtRatioBX96, "sqrtRatioBX96");
+  assertUint128(liquidity, "liquidity");
+  let a = sqrtRatioAX96;
+  let b = sqrtRatioBX96;
+  if (a > b) {
+    [a, b] = [b, a];
+  }
+  if (a === 0n) throw new Error("SqrtPriceMath: sqrtRatio must be > 0");
+  const numerator1 = liquidity << Q96_RESOLUTION;
+  const numerator2 = b - a;
+  if (roundUp) {
+    return divRoundingUp(mulDivRoundingUp(numerator1, numerator2, b), a);
+  }
+  return mulDiv(numerator1, numerator2, b) / a;
+}
+function getAmount1Delta(sqrtRatioAX96, sqrtRatioBX96, liquidity, roundUp) {
+  assertUint160(sqrtRatioAX96, "sqrtRatioAX96");
+  assertUint160(sqrtRatioBX96, "sqrtRatioBX96");
+  assertUint128(liquidity, "liquidity");
+  let a = sqrtRatioAX96;
+  let b = sqrtRatioBX96;
+  if (a > b) {
+    [a, b] = [b, a];
+  }
+  return roundUp ? mulDivRoundingUp(liquidity, b - a, Q96) : mulDiv(liquidity, b - a, Q96);
+}
+function getAmount0DeltaSigned(sqrtRatioAX96, sqrtRatioBX96, liquidity) {
+  const INT128_MIN2 = -(1n << 127n);
+  const INT128_MAX2 = (1n << 127n) - 1n;
+  if (liquidity < INT128_MIN2 || liquidity > INT128_MAX2) {
+    throw new Error("SqrtPriceMath: liquidity out of int128 range");
+  }
+  if (liquidity < 0n) {
+    return -getAmount0Delta(sqrtRatioAX96, sqrtRatioBX96, -liquidity, false);
+  }
+  return getAmount0Delta(sqrtRatioAX96, sqrtRatioBX96, liquidity, true);
+}
+function getAmount1DeltaSigned(sqrtRatioAX96, sqrtRatioBX96, liquidity) {
+  const INT128_MIN2 = -(1n << 127n);
+  const INT128_MAX2 = (1n << 127n) - 1n;
+  if (liquidity < INT128_MIN2 || liquidity > INT128_MAX2) {
+    throw new Error("SqrtPriceMath: liquidity out of int128 range");
+  }
+  if (liquidity < 0n) {
+    return -getAmount1Delta(sqrtRatioAX96, sqrtRatioBX96, -liquidity, false);
+  }
+  return getAmount1Delta(sqrtRatioAX96, sqrtRatioBX96, liquidity, true);
+}
+
+// src/math/liquidityMath.ts
+var MAX_UINT1282 = (1n << 128n) - 1n;
+var INT128_MAX = (1n << 127n) - 1n;
+var INT128_MIN = -(1n << 127n);
+function addDelta(x, y) {
+  if (x < 0n || x > MAX_UINT1282) {
+    throw new Error("LiquidityMath: x out of uint128 range");
+  }
+  if (y < INT128_MIN || y > INT128_MAX) {
+    throw new Error("LiquidityMath: y out of int128 range");
+  }
+  const z = x + y;
+  if (y < 0n) {
+    if (z < 0n) throw new Error("LS");
+  } else {
+    if (z > MAX_UINT1282) throw new Error("LA");
+  }
+  return z;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ActionBoxAddress,
@@ -616,6 +981,12 @@ var SdkError = class extends Error {
   KERNEL_POOL_USDC_USDT_Dev,
   KernelEventEmitterAddress,
   KernelManagerAddress,
+  MAX_SQRT_PRICE_LIMIT,
+  MAX_SQRT_RATIO,
+  MAX_TICK,
+  MIN_SQRT_PRICE_LIMIT,
+  MIN_SQRT_RATIO,
+  MIN_TICK,
   PERIPHERY_DEV,
   PERIPHERY_PROD,
   PERIPHERY_STAGING,
@@ -629,6 +1000,7 @@ var SdkError = class extends Error {
   SkateGatewayAddress,
   TaskPhase,
   VM,
+  addDelta,
   base58ToBytes32,
   base58ToHex,
   bufferFromBase58,
@@ -639,17 +1011,29 @@ var SdkError = class extends Error {
   fromBytes32Address,
   getAllPoolInfo,
   getAllPoolKeys,
+  getAmount0Delta,
+  getAmount0DeltaSigned,
+  getAmount1Delta,
+  getAmount1DeltaSigned,
   getBlockExplorer,
+  getNextSqrtPriceFromAmount0RoundingUp,
+  getNextSqrtPriceFromAmount1RoundingDown,
+  getNextSqrtPriceFromInput,
+  getNextSqrtPriceFromOutput,
   getOtherTokensInPairs,
   getPeripheryDetailsByKernelPoolAndChainId,
   getPoolInfoByKey,
+  getSqrtRatioAtTick,
   getSupportedChains,
   getSupportedPairs,
   getSupportedTokens,
+  getTickAtSqrtRatio,
   hexToBase58,
   isHexString,
   isHexStringLoose,
   kernelPoolToPoolKey,
+  mulDiv,
+  mulDivRoundingUp,
   normalizeMode,
   skateAdapter,
   toBase58,