TickUtils

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

CLMM 价格有三种表示方式：

表示方式	类型	示例	使用场景
人类可读价格	`number` / `Decimal`	`0.25`（每个 token0 值多少 token1，已按精度调整）	界面
`sqrtPriceX96`	`bigint`	`sqrt(原始价格) × 2^96`	池状态、兑换限价
Tick	`bigint`	`价格 = 1.0001^tick`	头寸区间

所有原始价格都是按排序后顺序的 每个 token0 值多少 token1。下面的基础/报价辅助函数可以处理界面上任意方向的交易对。

Tick ↔ sqrtPriceX96

`getSqrtRatioAtTick(tick)`

static getSqrtRatioAtTick(tick: bigint): bigint

链上 tick 数学的精确移植。当 |tick| > MAX_TICK（887272）时抛出 TickOutOfBounds。

`getTickAtSqrtRatio(sqrtPriceX96)`

static getTickAtSqrtRatio(sqrtPriceX96: bigint): bigint

返回 sqrt 比率 ≤ 输入值的最大 tick。输入超出 [MIN_SQRT_RATIO, MAX_SQRT_RATIO) 时抛出 SqrtPriceX96OutOfBounds。

价格 ↔ sqrtPriceX96

`priceToSqrtPriceX96(price, token0Decimals, token1Decimals)`

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

price 是以 token1 计的 token0 人类可读价格。价格非有限值或非正数时抛出错误。

`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

对齐到 tick 间距

头寸边界必须是费率档位 tickSpacing 的整数倍。

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

把人类可读价格转换为最近的有效 tick（向上取整到 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)

面向界面的基础/报价辅助函数

这些函数按用户看到的方式接收代币（tokenBase、tokenQuote）以及 baseIn，并在内部转换为排序后的顺序。baseIn = true 时，价格表示为”1 个 base = X 个 quote”。

方法	返回	用途
`getAlignedPrice(price, tokenBase, tokenQuote, tickSpacing, baseIn)`	`{ tick, price }`	把用户输入的价格对齐到有效 tick，并显示对齐后的价格
`getPriceFromTick(tick, tokenBase, tokenQuote, baseIn)`	`{ tick, price }`	显示区间边界
`getNextTick(tick, tickSpacing, tokenBase, tokenQuote, baseIn, isAdd)`	`bigint`	价格输入框旁的 `+` / `−` 按钮
`getMinPriceFromTick(tokenBase, tokenQuote, tickSpacing, baseIn)`	`{ tick, price }`	”全区间”下界
`getMaxPriceFromTick(tokenBase, tokenQuote, tickSpacing, baseIn)`	`{ tick, price }`	”全区间”上界

// 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

兑换数学

方法	说明
`getNextSqrtPrice(sqrtPX96, liquidity, amount, zeroForOne)`	在一个流动性区间内兑换 `amount` 后的价格
`getNextSqrtPriceFromAmount0(...)` / `getNextSqrtPriceFromAmount1(...)`	区分方向的版本
`getSqrtPriceX96Bounds(sqrtPriceX96, slippageBps)`	`[min, max]` = `sqrtPrice × sqrt(1 ∓ s)`
`getSqrtPriceLimitX96(sqrtPriceX96, slippageBps, zeroForOne)`	传给兑换的限价。始终严格越过当前价格，并位于有效范围内。

常量

从包的根路径导出：MIN_TICK = -887272n、MAX_TICK = 887272n、U256_MAX、UNLIMITED_AMOUNT 和 MAX_PIPS。包的根路径不导出 MIN_SQRT_RATIO（4295128739n）、MAX_SQRT_RATIO 和 Q96（2n ** 96n），如有需要请在本地定义。

SDK 与 API

核心概念

模块

工具类

指南

参考

Tick ↔ sqrtPriceX96

`getSqrtRatioAtTick(tick)`

`getTickAtSqrtRatio(sqrtPriceX96)`

价格 ↔ sqrtPriceX96

`priceToSqrtPriceX96(price, token0Decimals, token1Decimals)`

`sqrtPriceX96ToPrice(sqrtPriceX96, token0Decimals, token1Decimals)`

对齐到 tick 间距

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

面向界面的基础/报价辅助函数

兑换数学

常量

​Tick ↔ sqrtPriceX96

​getSqrtRatioAtTick(tick)

​getTickAtSqrtRatio(sqrtPriceX96)

​价格 ↔ sqrtPriceX96

​priceToSqrtPriceX96(price, token0Decimals, token1Decimals)

​sqrtPriceX96ToPrice(sqrtPriceX96, token0Decimals, token1Decimals)

​对齐到 tick 间距

​getAlignedTick(price, token0Decimals, token1Decimals, tickSpacing)

​面向界面的基础/报价辅助函数

​兑换数学

​常量

Tick ↔ sqrtPriceX96

`getSqrtRatioAtTick(tick)`

`getTickAtSqrtRatio(sqrtPriceX96)`

价格 ↔ sqrtPriceX96

`priceToSqrtPriceX96(price, token0Decimals, token1Decimals)`

`sqrtPriceX96ToPrice(sqrtPriceX96, token0Decimals, token1Decimals)`

对齐到 tick 间距

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

面向界面的基础/报价辅助函数

兑换数学

常量