Integrator fees

This page is about fees on swaps. If you want to earn a share of staking yield by bringing stakers to Powfi, see Referral staking & partner commission. The two mechanisms are separate.

Wallets and aggregators can take a fee on each swap. The fee is paid in the input token, is sent to feeRecipient inside the same transaction, and is charged on top of the swap input.

Usage

await powfi.cpmm.swap({
  tokenInId, tokenOutId,
  amountIn: 1_000n * 10n ** 18n,
  slippageBps: 50n,
  sender: address,
  fee: 3n * 10n ** 18n,          // 3 tokens of tokenIn (0.3%)
  feeRecipient: 'your-fee-address'
})

await powfi.clmm.swap({
  token0: tokenIn, token1: tokenOut,
  amount: amountIn, amountIn,
  slippage: 50n,
  routePlan: [configIndex],
  fee: (amountIn * 30n) / 10_000n,
  feeRecipient: 'your-fee-address'
})

The user pays amountIn + fee (exact-in) or maximalTokenInAmount + fee (exact-out on CPMM). The SDK uses the SwapMinOutWithFee / SwapMaxInWithFee (CPMM) or SwapWithoutAccountWithFee (CLMM) scripts when a fee is set.

Validation rules

validateIntegratorFee runs before signing and throws a plain Error if:

Rule	Message
Only one of `fee` / `feeRecipient` is set	`fee and feeRecipient must be provided together`
`fee <= 0`	`fee must be greater than 0`
`feeRecipient` equals the sender	`feeRecipient must differ from the sender`
Input is ALPH and `fee < DUST_AMOUNT`	`an ALPH fee must be at least the dust amount …`
`fee >= amountIn` (or `>=` max input for exact-out)	`fee must be less than the swapped amount …`

When the input is a non-ALPH token, the SDK attaches one extra DUST_AMOUNT of ALPH for the fee output. The user pays this dust (0.001 ALPH) on top of amountIn + fee and gas, and it ends up at feeRecipient together with the fee. Include it when you show the user their total cost. Groupless feeRecipient addresses are normalized to the protocol group automatically.

SDK & API

Core concepts

Modules

Utilities

Guides

Reference

Usage

Validation rules

​Usage

​Validation rules

Usage

Validation rules