Powfi SDK (@eyettea/powfi-sdk)

TypeScript SDK for Powfi on Alephium. This package provides high-level modules for CPMM, CLMM, staking, and token operations, and re-exports generated contract artifacts/deployments.

Scope

• Powfi entrypoint for network/provider/signer configuration
• powfi.cpmm for constant-product liquidity pools
• powfi.clmm for concentrated-liquidity pools
• powfi.staking for xALPH staking flows
• powfi.token for token metadata helpers
• Re-exported contract types and deployment loaders from clmm, cpmm, and staking

Installation

For SDK consumers:

npm install @eyettea/powfi-sdk

For monorepo development:

bun install

Quick Start

import { Powfi, CpmmModule } from '@eyettea/powfi-sdk';

const powfi = Powfi.load({ networkId: 'testnet' });

const poolState = await powfi.cpmm.getPoolState(tokenAId, tokenBId);
const quote = CpmmModule.computeSwapAmount({
  state: poolState,
  tokenInId: tokenAId,
  tokenOutId: tokenBId,
  amountIn: 1_000_000n,
  slippageBps: 50n,
});

CLMM simulation example:

const simulation = await powfi.clmm.simulateSwap({
  configIndex: 0n,
  token0,
  token1,
  zeroForOne: true,
  amount: 1_000_000n,
});

For write operations (swap, add/remove liquidity, staking), pass a signer when loading the SDK:

const powfi = Powfi.load({ networkId: 'testnet', signer });

Development Commands

Run inside packages/sdk:

bun run build
bun run test
bun run typecheck
bun run lint
bun run format:check

Artifact Packaging

bun run build runs copy-artifacts before bundling. It copies:

• ../clmm/artifacts and ../clmm/deployments
• ../cpmm/artifacts and ../cpmm/deployments
• ../staking/artifacts and ../staking/deployments

into this package so the published SDK includes contract bindings and deployment metadata.

If contracts changed, rebuild contract artifacts first:

bun run compile
bun run build:sdk

Related Packages

• Monorepo README
• CLMM package
• CPMM package
• Staking package