Math, numeric & helpers

MathUtil

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

bigint math with explicit rounding, matching Alephium’s integer semantics.

Method	Description
`MathUtil.sqrt(x)`	Integer square root (floor), Newton’s method
`MathUtil.alphDiv(a, b)`	Floor division toward −∞ (the on-chain convention for signed values)
`MathUtil.alphCeil(a, b)`	Division rounding away from zero
`MathUtil.divFloor(a, b)` / `divCeil(a, b)`	Floor / ceiling division. Throws on `b = 0`.
`MathUtil.mulDivFloor(a, b, d)` / `mulDivCeil(a, b, d)`	`a × b / d` with the given rounding. Throws on `d = 0`.
`MathUtil.abs(x)`	Absolute value of a bigint

Native bigint / truncates toward zero. For negative values that differs from the contracts. Use alphDiv whenever you reproduce on-chain math with signed amounts.

NumericUtils

import { NumericUtils, type NumericLike } from '@alephium/powfi-sdk'
// NumericLike = Decimal | bigint | number | string | undefined | null

Method	Example
`decimalFrom(value)`	`decimalFrom(10n)` → `Decimal(10)` (nullish → 0)
`scaleDecimal(value, decimals)`	`scaleDecimal(1500000n, 6)` → `Decimal(1.5)`
`scaleToString(value, decimals)`	`scaleToString(1500000n, 6)` → `"1.5"`
`numericToString(value)`	Plain string, never scientific notation
`decimalToString(decimal)`	Same, from a `Decimal`
`numericToBigInt(value)`	`"42"` → `42n`. Throws on non-integers or non-finite values.

Token ordering

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

const [token0, token1] = sortTokens(tokenA, tokenB) // lexicographic, as the contracts derive pool IDs

Address normalization

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

normalizeAddress('1Abc…', 0) // '1Abc…:0' for a groupless address, unchanged otherwise

Integrator fee validation

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

validateIntegratorFee({ fee, feeRecipient, sender, tokenInId, amountIn }) // returns the fee (0n when unset) or throws

Rules are listed in Integrator fees.

Logging

Each module logs through a named logger (CpmmModule, ClmmModule, StakingModule, TokenModule). The default level is Error.

import { setLoggerLevel, LogLevel } from '@alephium/powfi-sdk'

setLoggerLevel('ClmmModule', LogLevel.Debug) // Error | Warning | Info | Debug

setLoggerLevel works before or after Powfi.load. Module names are case-sensitive, and a misspelled name silently does nothing. You can also create your own logger with createLogger(name). It returns a Logger with error, warning, info, and debug methods.

SDK & API

Core concepts

Modules

Utilities

Guides

Reference

Math, numeric & helpers

MathUtil

NumericUtils

Token ordering

Address normalization

Integrator fee validation

Logging

​MathUtil

​NumericUtils

​Token ordering

​Address normalization

​Integrator fee validation

​Logging

MathUtil

NumericUtils

Token ordering

Address normalization

Integrator fee validation

Logging