TickUtils

import { TickUtils } from '@alephium/powfi-sdk'

CLMM prices live in three representations:

Representation	Type	Example	Used by
Human price	`number` / `Decimal`	`0.25` (token1 per token0, decimal-adjusted)	UIs
`sqrtPriceX96`	`bigint`	`sqrt(rawPrice) × 2^96`	pool state, swap limits
Tick	`bigint`	`price = 1.0001^tick`	position ranges

All raw prices are token1 per token0 in sorted order. The base/quote helpers below handle UI pairs in either orientation.

Tick ↔ sqrtPriceX96

`getSqrtRatioAtTick(tick)`

static getSqrtRatioAtTick(tick: bigint): bigint

Exact port of the on-chain tick math. Throws TickOutOfBounds if |tick| > MAX_TICK (887272).

`getTickAtSqrtRatio(sqrtPriceX96)`

static getTickAtSqrtRatio(sqrtPriceX96: bigint): bigint

The greatest tick whose sqrt ratio is ≤ the input. Throws SqrtPriceX96OutOfBounds outside [MIN_SQRT_RATIO, MAX_SQRT_RATIO).

Price ↔ sqrtPriceX96

`priceToSqrtPriceX96(price, token0Decimals, token1Decimals)`

static priceToSqrtPriceX96(price: Decimal.Value, token0Decimal: number, token1Decimal: number): bigint

price is the human price of token0 in token1. Throws on non-finite or non-positive prices.

`sqrtPriceX96ToPrice(sqrtPriceX96, token0Decimals, token1Decimals)`

static sqrtPriceX96ToPrice(sqrtPriceX96: bigint, token0Decimal: number, token1Decimal: number): number

const state = await powfi.clmm.getPoolState(poolId)
const price = TickUtils.sqrtPriceX96ToPrice(state.sqrtPriceX96, state.token0Info.decimals, state.token1Info.decimals)
// price of 1 token0 in token1

Aligning to tick spacing

Position bounds must be multiples of the fee tier’s tickSpacing.

`getAlignedTick(price, token0Decimals, token1Decimals, tickSpacing)`

Converts a human price to the nearest valid tick (rounded up to a multiple of tickSpacing).

const { tickSpacing } = (await powfi.clmm.getPoolConfig(configIndex))!
const tickLower = TickUtils.getAlignedTick(0.2, d0, d1, tickSpacing)
const tickUpper = TickUtils.getAlignedTick(0.3, d0, d1, tickSpacing)

Base/quote helpers for UIs

These take the tokens as the user sees them (tokenBase, tokenQuote) plus baseIn, and flip to sorted order internally. With baseIn = true the price is quoted as “1 base = X quote”.

Method	Returns	Use
`getAlignedPrice(price, tokenBase, tokenQuote, tickSpacing, baseIn)`	`{ tick, price }`	Snap a typed price to a valid tick and show the snapped price
`getPriceFromTick(tick, tokenBase, tokenQuote, baseIn)`	`{ tick, price }`	Display a range bound
`getNextTick(tick, tickSpacing, tokenBase, tokenQuote, baseIn, isAdd)`	`bigint`	`+` / `−` buttons next to a price input
`getMinPriceFromTick(tokenBase, tokenQuote, tickSpacing, baseIn)`	`{ tick, price }`	”Full range” lower bound
`getMaxPriceFromTick(tokenBase, tokenQuote, tickSpacing, baseIn)`	`{ tick, price }`	”Full range” upper bound

// user types "1 ALPH = 0.25 USDT" as the lower bound
const lower = TickUtils.getAlignedPrice(0.25, alphInfo, usdtInfo, tickSpacing, true)
// lower.tick -> pass to addLiquidity; lower.price -> show "0.2499…" in the input

Swap math

Method	Description
`getNextSqrtPrice(sqrtPX96, liquidity, amount, zeroForOne)`	Price after swapping `amount` within one liquidity range
`getNextSqrtPriceFromAmount0(...)` / `getNextSqrtPriceFromAmount1(...)`	Direction-specific versions
`getSqrtPriceX96Bounds(sqrtPriceX96, slippageBps)`	`[min, max]` = `sqrtPrice × sqrt(1 ∓ s)`
`getSqrtPriceLimitX96(sqrtPriceX96, slippageBps, zeroForOne)`	The limit passed to swaps. Always strictly past the current price and inside the valid range.

Constants

Exported from the package root: MIN_TICK = -887272n, MAX_TICK = 887272n, U256_MAX, UNLIMITED_AMOUNT, and MAX_PIPS. The package root does not export MIN_SQRT_RATIO (4295128739n), MAX_SQRT_RATIO, or Q96 (2n ** 96n). Define them locally if you need them.

SDK & API

Core concepts

Modules

Utilities

Guides

Reference

Tick ↔ sqrtPriceX96

`getSqrtRatioAtTick(tick)`

`getTickAtSqrtRatio(sqrtPriceX96)`

Price ↔ sqrtPriceX96

`priceToSqrtPriceX96(price, token0Decimals, token1Decimals)`

`sqrtPriceX96ToPrice(sqrtPriceX96, token0Decimals, token1Decimals)`

Aligning to tick spacing

`getAlignedTick(price, token0Decimals, token1Decimals, tickSpacing)`

Base/quote helpers for UIs

Swap math

Constants

​Tick ↔ sqrtPriceX96

​getSqrtRatioAtTick(tick)

​getTickAtSqrtRatio(sqrtPriceX96)

​Price ↔ sqrtPriceX96

​priceToSqrtPriceX96(price, token0Decimals, token1Decimals)

​sqrtPriceX96ToPrice(sqrtPriceX96, token0Decimals, token1Decimals)

​Aligning to tick spacing

​getAlignedTick(price, token0Decimals, token1Decimals, tickSpacing)

​Base/quote helpers for UIs

​Swap math

​Constants

Tick ↔ sqrtPriceX96

`getSqrtRatioAtTick(tick)`

`getTickAtSqrtRatio(sqrtPriceX96)`

Price ↔ sqrtPriceX96

`priceToSqrtPriceX96(price, token0Decimals, token1Decimals)`

`sqrtPriceX96ToPrice(sqrtPriceX96, token0Decimals, token1Decimals)`

Aligning to tick spacing

`getAlignedTick(price, token0Decimals, token1Decimals, tickSpacing)`

Base/quote helpers for UIs

Swap math

Constants