Réseaux et configuration

Réseaux intégrés

Powfi.load({ networkId }) choisit l’une de ces configurations (defaultNetworks) :

`networkId`	Nœud	API de l’explorateur	Liste de jetons
`mainnet`	`https://node.mainnet.alephium.org`	`https://backend.mainnet.alephium.org`	`alephium/token-list` → `tokens/mainnet.json`
`testnet`	`https://node.testnet.alephium.org`	`https://backend.testnet.alephium.org`	`h0ngcha0/token-list` → `testnet.json`
`devnet`	`http://127.0.0.1:22973`	`http://localhost:9090`	`http://127.0.0.1:4000/token-list/devnet.json`

Un networkId inconnu lève Network <id> not found.

Surcharger les endpoints

Utilisez networkOverrides pour remplacer n’importe quel champ sauf id :

const powfi = Powfi.load({
  networkId: 'mainnet',
  networkOverrides: {
    nodeUrl: 'https://my-node.example.com',
    nodeApiKey: process.env.ALEPHIUM_API_KEY,
    tokenListUrl: 'https://cdn.example.com/my-token-list.json'
  }
})

Champs de Network :

NetworkId

requis

'mainnet' | 'testnet' | 'devnet'. Détermine à la fois les endpoints et les déploiements de contrats inclus.

string

Nom affiché.

string

Endpoint REST du nœud complet.

string

Clé d’API optionnelle envoyée au nœud.

string

Endpoint du backend de l’explorateur (utilisé par powfi.explorerProvider).

string

Interface web de l’explorateur, pour construire des liens.

string

Liste de jetons JSON de forme { tokens: TokenInfo[] }.

Adresses des contrats

Chaque module charge ses identifiants de contrats depuis les fichiers de déploiement inclus dans le SDK (cpmm/deployments, clmm/deployments, staking/deployments) pour le networkId choisi :

Module	Type de config	Chargé depuis
CPMM	`CpmmConfig`	`Router`, `TokenPairFactory`
CLMM	`ClmmConfig`	`PoolFactory`, `PositionManager`, `DexAccountRoot`
Staking	`StakingConfig`	`XAlphToken`, `AlphUnstakeVault`, `RewardFeeCollector`

Pour faire pointer un module vers un autre déploiement (un fork ou votre propre devnet), surchargez sa configuration après le chargement :

powfi.cpmm.setConfig({ groupIndex: 0, factoryId: '...', routerId: '...' })
powfi.clmm.setConfig({ groupIndex: 0, factoryId: '...', positionManagerId: '...', defaultConfigIndex: 0n, accountRoot: '...' })
powfi.staking.setConfig({ /* StakingConfig */ })

Lisez la configuration active avec powfi.cpmm.getConfig(), powfi.clmm.getClmmConfig() et powfi.staking.getConfig().

Les noms des getters diffèrent selon les modules. Sur ClmmModule, getConfig() relit le fichier de déploiement inclus et ignore toute surcharge faite avec setConfig. Utilisez getClmmConfig() pour lire la configuration active. Sur CpmmModule, c’est l’inverse : getConfig() renvoie la configuration active et getCpmmConfig() relit le déploiement.

Groupes et adresses

Alephium est découpé en groupes d’adresses, et tous les contrats Powfi d’un module se trouvent dans un même groupe (config.groupIndex). Les identifiants de pools, de positions et de coffres sont dérivés comme sous-contrats dans ce groupe, ce qui permet de les calculer hors ligne :

powfi.cpmm.getPoolId(tokenA, tokenB)               // CPMM pair (also the LP token ID)
powfi.clmm.getPoolId(tokenA, tokenB, configIndex)  // CLMM pool
powfi.clmm.getPositionId(poolId, owner, tickLower, tickUpper)

Les adresses sans groupe (nouvelles adresses sans suffixe :group) sont normalisées avec normalizeAddress(address, group), qui ajoute :<group> si nécessaire. Le SDK le fait en interne pour les arguments sender, owner, recipient et fee recipient.

Devnet local

Les tests d’intégration du SDK s’exécutent sur un devnet Alephium local :

cd powfi-sdk
docker compose -f docker/docker-compose.yml up -d

Avec networkId: 'devnet', le SDK utilise 127.0.0.1:22973 et les déploiements devnet. Sur le devnet, la période de déblocage de l’unstake est de 1 minute au lieu de 30 jours.

SDK et API

Concepts clés

Modules

Utilitaires

Guides

Référence

Réseaux et configuration

Réseaux intégrés

Surcharger les endpoints

Adresses des contrats

Groupes et adresses

Devnet local

​Réseaux intégrés

​Surcharger les endpoints

​Adresses des contrats

​Groupes et adresses

​Devnet local

Réseaux intégrés

Surcharger les endpoints

Adresses des contrats

Groupes et adresses

Devnet local