Calcul, numérique et helpers

MathUtil

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

Calcul sur bigint avec arrondi explicite, conforme à la sémantique entière d’Alephium.

Méthode	Description
`MathUtil.sqrt(x)`	Racine carrée entière (par défaut), méthode de Newton
`MathUtil.alphDiv(a, b)`	Division arrondie vers −∞ (la convention on-chain pour les valeurs signées)
`MathUtil.alphCeil(a, b)`	Division arrondie en s’éloignant de zéro
`MathUtil.divFloor(a, b)` / `divCeil(a, b)`	Division par défaut / par excès. Lève une erreur si `b = 0`.
`MathUtil.mulDivFloor(a, b, d)` / `mulDivCeil(a, b, d)`	`a × b / d` avec l’arrondi indiqué. Lève une erreur si `d = 0`.
`MathUtil.abs(x)`	Valeur absolue d’un bigint

L’opérateur / natif sur bigint tronque vers zéro. Pour les valeurs négatives, cela diffère des contrats. Utilisez alphDiv chaque fois que vous reproduisez un calcul on-chain avec des montants signés.

NumericUtils

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

Méthode	Exemple
`decimalFrom(value)`	`decimalFrom(10n)` → `Decimal(10)` (nul → 0)
`scaleDecimal(value, decimals)`	`scaleDecimal(1500000n, 6)` → `Decimal(1.5)`
`scaleToString(value, decimals)`	`scaleToString(1500000n, 6)` → `"1.5"`
`numericToString(value)`	Chaîne simple, jamais en notation scientifique
`decimalToString(decimal)`	Idem, à partir d’un `Decimal`
`numericToBigInt(value)`	`"42"` → `42n`. Lève une erreur pour les valeurs non entières ou non finies.

Ordre des jetons

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

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

Normalisation des adresses

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

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

Validation des frais d’intégrateur

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

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

Les règles sont listées dans Frais d’intégrateur.

Journalisation

Chaque module journalise via un logger nommé (CpmmModule, ClmmModule, StakingModule, TokenModule). Le niveau par défaut est Error.

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

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

setLoggerLevel fonctionne avant ou après Powfi.load. Les noms de modules sont sensibles à la casse, et un nom mal orthographié n’a aucun effet, sans erreur. Vous pouvez aussi créer votre propre logger avec createLogger(name). Il renvoie un Logger doté des méthodes error, warning, info et debug.

SDK et API

Concepts clés

Modules

Utilitaires

Guides

Référence

Calcul, numérique et helpers

MathUtil

NumericUtils

Ordre des jetons

Normalisation des adresses

Validation des frais d’intégrateur

Journalisation

​MathUtil

​NumericUtils

​Ordre des jetons

​Normalisation des adresses

​Validation des frais d’intégrateur

​Journalisation

MathUtil

NumericUtils

Ordre des jetons

Normalisation des adresses

Validation des frais d’intégrateur

Journalisation