tickLower–tickUpper),只有当价格处于区间内时才赚取手续费。每个池由代币对加费率档位(configIndex)确定。价格存储为 sqrtPriceX96 = sqrt(token1/token0) × 2^96。
指南:在 CLMM 上兑换
指南:开设和管理头寸
费率档位(池配置)
费率档位是在工厂合约中注册的PoolConfig 合约,索引从 0n 开始。每个池恰好引用一个档位。
查询池
getPoolState(poolId)
PoolNotFoundError。
其他池查询
兑换
simulateSwap(params)
simulateSwap 视图方法(不发交易),返回兑换经过的流动性曲线。把结果传给 PoolUtils.offlineSwap 即可在本地计算输出数量。
swap(params)
SwapWithoutAccount 脚本(设置了集成方手续费时使用 SwapWithoutAccountWithFee)执行单池兑换。签名器既是付款方也是接收方。
可选的集成方手续费,以输入代币计。
swapTo(params)
targetSqrtPriceX96,最多花费 amountInMax 的 tokenIn。如果目标价格在当前价格的错误一侧,链上会失败(错误码 106,InvalidSqrtPriceLimit)。
buildSwapPath(tokenId, configIndex)
为 simulateSwap({ data }) 编码额外的一跳:tokenId + configIndex(4 个十六进制字符)。
流动性头寸
头寸由 池 + 所有者 + tickLower + tickUpper 确定。头寸合约 ID 同时也是头寸代币 ID:所有者持有 1 个单位,修改头寸时需要附加它。getPositionId(poolId, owner, tickLower, tickUpper)
离线推导头寸 ID。对于无分组地址,请传入规范化后的 owner(见分组与地址)。PoolUtils.getPositionId(poolAddress, owner, ...) 会自动规范化。
createPool(...)
tick 对应的价格创建池,并在 [tickLower, tickUpper] 内铸造第一个头寸。代币及其数量、tick 都会在内部排序。会为新合约附加 6 × MINIMAL_CONTRACT_DEPOSIT 的 ALPH。
addLiquidity(params)
dustAmount)通过 PositionManager.getSqrtPricesX96 从链上读取。
两步版本: getAddLiquidityParams(p) 返回 [positionId, positionManager, params] 而不发送,addLiquidityFromParams(positionId, positionManager, params) 再执行。可以用它展示带有精确最小数量的确认界面。
removeLiquidity(params)
0n 即可关闭检查。
collectTokens(params)
recipient。它不会移除流动性;如需移除,请使用 removeLiquidity。
positionInfo(params)
positionInfo 视图方法,原样返回结果。fees 包含三项:token0、token1 和池的奖励代币。SDK 会把累加器参数(acc、iacc0、iacc1、t0、acct0)直接传给合约,其含义请参考 Pool 合约源码。
要读取头寸的原始流动性,请获取头寸合约的状态:
流动性挖矿奖励
每个池最多可以运行三个奖励计划(MAX_REWARDS = 3),以 token0、token1 或池的额外奖励代币(token2)发放。奖励计划由 Powfi 团队设置和注资。
getPoolRewardState(poolId)返回奖励代币,以及每个计划的amount、openTime和endTime(毫秒时间戳)。- 头寸累计的奖励体现在
positionInfo(...).fees中:token0 奖励在fees[0],token1 奖励在fees[1],其他代币的奖励在fees[2]。通过collectTokens领取。
推荐(DEX)账户
Powfi 通过DexAccountRoot 下每个用户的 DexAccount 合约跟踪推荐关系。
配置
getClmmConfig() 读取当前生效的配置,用 setConfig() 覆盖。getConfig() 会重新读取打包的部署文件。