TickUtils

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

Les prix CLMM existent sous trois représentations :

Représentation	Type	Exemple	Utilisée par
Prix lisible	`number` / `Decimal`	`0.25` (token1 par token0, ajusté des décimales)	Interfaces
`sqrtPriceX96`	`bigint`	`sqrt(prixBrut) × 2^96`	état du pool, limites de swap
Tick	`bigint`	`prix = 1.0001^tick`	plages de positions

Tous les prix bruts sont exprimés en token1 par token0 dans l’ordre trié. Les helpers base/cotation ci-dessous gèrent les paires d’interface dans les deux sens.

Tick ↔ sqrtPriceX96

`getSqrtRatioAtTick(tick)`

static getSqrtRatioAtTick(tick: bigint): bigint

Portage exact des calculs de ticks on-chain. Lève TickOutOfBounds si |tick| > MAX_TICK (887272).

`getTickAtSqrtRatio(sqrtPriceX96)`

static getTickAtSqrtRatio(sqrtPriceX96: bigint): bigint

Le plus grand tick dont le ratio en racine carrée est ≤ à l’entrée. Lève SqrtPriceX96OutOfBounds hors de [MIN_SQRT_RATIO, MAX_SQRT_RATIO).

Prix ↔ sqrtPriceX96

`priceToSqrtPriceX96(price, token0Decimals, token1Decimals)`

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

price est le prix lisible du token0 exprimé en token1. Lève une erreur si le prix n’est pas fini ou pas strictement positif.

`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

Alignement sur l’espacement des ticks

Les bornes de position doivent être des multiples du tickSpacing du palier de frais.

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

Convertit un prix lisible en tick valide le plus proche (arrondi au multiple de tickSpacing supérieur).

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)

Helpers base/cotation pour les interfaces

Ces fonctions prennent les jetons tels que l’utilisateur les voit (tokenBase, tokenQuote) ainsi que baseIn, et passent à l’ordre trié en interne. Avec baseIn = true, le prix s’exprime comme « 1 base = X cotation ».

Méthode	Renvoie	Usage
`getAlignedPrice(price, tokenBase, tokenQuote, tickSpacing, baseIn)`	`{ tick, price }`	Aligner un prix saisi sur un tick valide et afficher le prix aligné
`getPriceFromTick(tick, tokenBase, tokenQuote, baseIn)`	`{ tick, price }`	Afficher une borne de plage
`getNextTick(tick, tickSpacing, tokenBase, tokenQuote, baseIn, isAdd)`	`bigint`	Boutons `+` / `−` à côté d’un champ de prix
`getMinPriceFromTick(tokenBase, tokenQuote, tickSpacing, baseIn)`	`{ tick, price }`	Borne inférieure « plage complète »
`getMaxPriceFromTick(tokenBase, tokenQuote, tickSpacing, baseIn)`	`{ tick, price }`	Borne supérieure « plage complète »

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

Calculs de swap

Méthode	Description
`getNextSqrtPrice(sqrtPX96, liquidity, amount, zeroForOne)`	Prix après un swap de `amount` dans une plage de liquidité
`getNextSqrtPriceFromAmount0(...)` / `getNextSqrtPriceFromAmount1(...)`	Versions spécifiques à chaque direction
`getSqrtPriceX96Bounds(sqrtPriceX96, slippageBps)`	`[min, max]` = `sqrtPrice × sqrt(1 ∓ s)`
`getSqrtPriceLimitX96(sqrtPriceX96, slippageBps, zeroForOne)`	La limite passée aux swaps. Toujours strictement au-delà du prix actuel et dans la plage valide.

Constantes

Exportées depuis la racine du package : MIN_TICK = -887272n, MAX_TICK = 887272n, U256_MAX, UNLIMITED_AMOUNT et MAX_PIPS. La racine du package n’exporte pas MIN_SQRT_RATIO (4295128739n), MAX_SQRT_RATIO ni Q96 (2n ** 96n). Définissez-les localement si vous en avez besoin.

SDK et API

Concepts clés

Modules

Utilitaires

Guides

Référence

Tick ↔ sqrtPriceX96

`getSqrtRatioAtTick(tick)`

`getTickAtSqrtRatio(sqrtPriceX96)`

Prix ↔ sqrtPriceX96

`priceToSqrtPriceX96(price, token0Decimals, token1Decimals)`

`sqrtPriceX96ToPrice(sqrtPriceX96, token0Decimals, token1Decimals)`

Alignement sur l’espacement des ticks

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

Helpers base/cotation pour les interfaces

Calculs de swap

Constantes

​Tick ↔ sqrtPriceX96

​getSqrtRatioAtTick(tick)

​getTickAtSqrtRatio(sqrtPriceX96)

​Prix ↔ sqrtPriceX96

​priceToSqrtPriceX96(price, token0Decimals, token1Decimals)

​sqrtPriceX96ToPrice(sqrtPriceX96, token0Decimals, token1Decimals)

​Alignement sur l’espacement des ticks

​getAlignedTick(price, token0Decimals, token1Decimals, tickSpacing)

​Helpers base/cotation pour les interfaces

​Calculs de swap

​Constantes

Tick ↔ sqrtPriceX96

`getSqrtRatioAtTick(tick)`

`getTickAtSqrtRatio(sqrtPriceX96)`

Prix ↔ sqrtPriceX96

`priceToSqrtPriceX96(price, token0Decimals, token1Decimals)`

`sqrtPriceX96ToPrice(sqrtPriceX96, token0Decimals, token1Decimals)`

Alignement sur l’espacement des ticks

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

Helpers base/cotation pour les interfaces

Calculs de swap

Constantes