Stake ALPH for xALPH - Powfi Docs

Stake

import { ONE_ALPH } from '@alephium/web3'

const tx = await powfi.staking.stakeAlph(100n * ONE_ALPH)

The transaction attaches amount + MINIMAL_CONTRACT_DEPOSIT ALPH. To attribute the stake to a partner address, use stakeAlphWithReferral(amount, referral). Contact the team before using a referral: see Referral staking & partner commission.

Show the rate and a user’s value

import Decimal from 'decimal.js'

const { fields } = await powfi.staking.getXAlphTokenState()
const rate = new Decimal(fields.totalDepositedAlph.toString()).div(fields.totalXAlphSupply.toString()) // ALPH per xALPH

const xAlphId = powfi.staking.getConfig().xAlphTokenId
const bal = await powfi.nodeProvider.addresses.getAddressesAddressBalance(address)
const xAlph = BigInt(bal.tokenBalances?.find((t) => t.id === xAlphId)?.amount ?? '0')
const valueInAlph = rate.mul(xAlph.toString()).div(1e18) // xALPH has 18 decimals, like ALPH

Unstake

await powfi.staking.startUnstake(50n * ONE_ALPH) // amount of xALPH to burn

This opens a new unstake vault. The ALPH unlocks linearly over getSettings().unstakeDuration (30 days on mainnet): you can claim the unlocked part at any time, and the full amount once the period ends. A user can have at most 16 active requests.

List pending requests

const indexes = await powfi.staking.getActiveUnstakeVaultIndexes(address)

const requests = await Promise.all(
  indexes.map(async (i) => {
    const { fields } = await powfi.staking.getAlphUnstakeVaultState(address, i)
    return {
      index: i,
      total: fields.totalUnstakeAmount,
      withdrawn: fields.withdrawnAmount,
      fullyUnlockedAt: new Date(Number(fields.unstakeStartTime + fields.unstakeDuration)),
      claimable: await powfi.staking.getClaimableAmount(address, i)
    }
  })
)

Claim or cancel

for (const r of requests) {
  if (r.claimable > 0n) await powfi.staking.claimUnstaked(r.index, r.claimable)
}

// change of mind: unlocked ALPH is paid out, the rest is re-staked as xALPH
await powfi.staking.cancelUnstake(requests[0].index)