集成方手续费 - Powfi Docs

本页讲的是兑换上的手续费。如果你想通过为 Powfi 带来质押用户来分享质押收益，请看推荐质押与渠道分润。这是两套独立的机制。

钱包和聚合器可以对每笔兑换收取手续费。手续费以输入代币支付，在同一笔交易中发送给 feeRecipient，并且是在兑换输入之外额外收取的。

用法

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'
})

用户支付 amountIn + fee（精确输入），或 maximalTokenInAmount + fee（CPMM 精确输出）。设置了手续费时，SDK 使用 SwapMinOutWithFee / SwapMaxInWithFee（CPMM）或 SwapWithoutAccountWithFee（CLMM）脚本。

校验规则

validateIntegratorFee 在签名前运行，以下情况会抛出普通 Error：

规则	消息
`fee` / `feeRecipient` 只设置了一个	`fee and feeRecipient must be provided together`
`fee <= 0`	`fee must be greater than 0`
`feeRecipient` 与发送方相同	`feeRecipient must differ from the sender`
输入是 ALPH 且 `fee < DUST_AMOUNT`	`an ALPH fee must be at least the dust amount …`
`fee >= amountIn`（精确输出时为 `>=` 最大输入）	`fee must be less than the swapped amount …`

当输入是非 ALPH 代币时，SDK 会为手续费输出额外附加一个 DUST_AMOUNT 的 ALPH。这笔 dust（0.001 ALPH）由用户在 amountIn + fee 和 gas 之外额外支付，最后会和手续费一起进入 feeRecipient 地址。向用户展示总花费时，记得把它算进去。无分组的 feeRecipient 地址会自动规范化到协议所在分组。