Networks & configuration

Built-in networks

Powfi.load({ networkId }) picks one of these configurations (defaultNetworks):

`networkId`	Node	Explorer API	Token list
`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`

An unknown networkId throws Network <id> not found.

Overriding endpoints

Use networkOverrides to replace any field except 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'
  }
})

Network fields:

NetworkId

required

'mainnet' | 'testnet' | 'devnet'. Selects both the endpoints and the bundled contract deployments.

string

Display name.

string

Full node REST endpoint.

string

Optional API key sent to the node.

string

Explorer backend endpoint (used by powfi.explorerProvider).

string

Explorer web UI, for building links.

string

JSON token list with shape { tokens: TokenInfo[] }.

Contract addresses

Each module loads its contract IDs from the deployment files bundled with the SDK (cpmm/deployments, clmm/deployments, staking/deployments) for the chosen networkId:

Module	Config type	Loaded from
CPMM	`CpmmConfig`	`Router`, `TokenPairFactory`
CLMM	`ClmmConfig`	`PoolFactory`, `PositionManager`, `DexAccountRoot`
Staking	`StakingConfig`	`XAlphToken`, `AlphUnstakeVault`, `RewardFeeCollector`

To point a module at a different deployment (a fork, or your own devnet), override its config after loading:

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

Read the active config with powfi.cpmm.getConfig(), powfi.clmm.getClmmConfig(), and powfi.staking.getConfig().

The getter names differ between modules. On ClmmModule, getConfig() re-reads the bundled deployment file and ignores any setConfig override. Use getClmmConfig() to read the active config. On CpmmModule it’s the other way round: getConfig() returns the active config and getCpmmConfig() re-reads the deployment.

Groups and addresses

Alephium is sharded into address groups, and every Powfi contract for a module lives in one group (config.groupIndex). Pool, position, and vault IDs are derived as sub-contracts in that group, so they can be computed offline:

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)

Groupless addresses (new-style addresses without a :group suffix) are normalized with normalizeAddress(address, group), which appends :<group> when needed. The SDK does this internally for sender, owner, recipient, and fee-recipient arguments.

Local devnet

The SDK’s integration tests run against a local Alephium devnet:

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

With networkId: 'devnet', the SDK uses 127.0.0.1:22973 and the devnet deployments. The devnet unstake duration is 1 minute instead of 30 days.

SDK & API

Core concepts

Modules

Utilities

Guides

Reference

Networks & configuration

Built-in networks

Overriding endpoints

Contract addresses

Groups and addresses

Local devnet

​Built-in networks

​Overriding endpoints

​Contract addresses

​Groups and addresses

​Local devnet

Built-in networks

Overriding endpoints

Contract addresses

Groups and addresses

Local devnet