Jetons

powfi.token // TokenModule

Le module de jetons récupère la liste de jetons JSON à network.tokenListUrl et la garde en cache mémoire pendant un jour. Les méthodes d’état de pool des modules CPMM et CLMM s’en servent pour associer un TokenInfo (symbole, décimales, logo) aux deux jetons du pool.

cpmm.getPoolState et clmm.getPoolState lèvent une erreur si l’un des jetons du pool est absent de la liste de jetons. Pour travailler avec des jetons non listés, faites pointer networkOverrides.tokenListUrl vers une liste qui les inclut, ou lisez directement les contrats de pool via les artefacts de contrats.

`TokenInfo`

Issu de @alephium/token-list :

interface TokenInfo {
  id: string          // 64-hex token ID (ALPH = ALPH_TOKEN_ID, "00…00")
  name: string
  symbol: string
  decimals: number
  description: string
  logoURI: string
  originChain?: string
  unchainedLogoURI?: string
}

Méthodes

`getTokens()`

getTokens(): Promise<TokenInfo[]>

Renvoie la liste en cache si elle est encore valide, sinon la récupère. Si la récupération échoue et qu’un cache périmé existe, la copie périmée est renvoyée (journalisée au niveau info). Sans cache, l’erreur est levée.

`getTokenById(id)` / `getTokenBySymbol(symbol)`

getTokenById(id: string): Promise<TokenInfo>
getTokenBySymbol(symbol: string): Promise<TokenInfo>

Lèvent Unknown token, … not found in token list en l’absence de correspondance. Les symboles sont comparés en respectant la casse, et la première correspondance l’emporte.

`getTokenInfoBy(predicate)`

getTokenInfoBy(fn: (token: TokenInfo) => boolean): Promise<TokenInfo | undefined>

`fetchTokens()`

Force un rafraîchissement et remplace le cache. Le contenu est validé : il doit être de la forme { tokens: TokenInfo[] }, avec id, name, symbol, description, logoURI de type chaîne et decimals entier dans [0, 255]. Tout le reste est rejeté.

Exemple

const tokens = await powfi.token.getTokens()
const ayin = await powfi.token.getTokenBySymbol('AYIN')
const stable = await powfi.token.getTokenInfoBy((t) => t.symbol.startsWith('USD'))

SDK et API

Concepts clés

Modules

Utilitaires

Guides

Référence

`TokenInfo`

Méthodes

`getTokens()`

`getTokenById(id)` / `getTokenBySymbol(symbol)`

`getTokenInfoBy(predicate)`

`fetchTokens()`

Exemple

​TokenInfo

​Méthodes

​getTokens()

​getTokenById(id) / getTokenBySymbol(symbol)

​getTokenInfoBy(predicate)

​fetchTokens()

​Exemple

`TokenInfo`

Méthodes

`getTokens()`

`getTokenById(id)` / `getTokenBySymbol(symbol)`

`getTokenInfoBy(predicate)`

`fetchTokens()`

Exemple