错误 - Powfi Docs

所有类型化错误都继承自 PowfiSDKError，后者继承自 Error。从包的根路径导入，并用 instanceof 判断：

import {
  PowfiSDKError,
  PoolNotFoundError,
  PriceImpactTooHighError,
  InsufficientBalanceError,
  InsufficientLiquidityError
} from '@alephium/powfi-sdk'

try {
  await powfi.cpmm.swap(req, balances)
} catch (e) {
  if (e instanceof PriceImpactTooHighError) showWarning(e.message)
  else if (e instanceof InsufficientBalanceError) showTopUp(e.message)
  else if (e instanceof PoolNotFoundError) showCreatePool()
  else throw e
}

类型化错误

错误	抛出位置	消息
`PoolNotFoundError`	`cpmm.getPoolState`、`clmm.getPoolState`、`clmm.getPoolTokenBalances`、`clmm.findBestRoute`	`Pool does not exist for <poolId>`
`PriceImpactTooHighError`	`cpmm.swap`，当 `priceImpact >= 5` 时	`Price impact too high: 6.12% > 5%`
`InsufficientBalanceError`	`cpmm.swap`、`cpmm.addLiquidity`，当你传入 `balances` 映射时	`Not enough <SYMBOL> balance. Required: …, Available: …`
`InsufficientLiquidityError`	`CpmmModule.getAmountIn`（输出 ≥ 储备量）、`getInitLiquidityDetails`（初始流动性 ≤ `MINIMUM_LIQUIDITY`）	`Insufficient liquidity` / 自定义
`TokenListFetchError`	`token.fetchTokens`（会被包装，见下文）	`Failed to fetch token list from <url> (status 404)`

TokenListFetchError 暴露 status?: number，原始错误在 cause 中。

部分模块方法会捕获错误，再以组合消息的普通 Error 重新抛出（通过 logAndThrowError），例如 Failed to fetch pool state on <id>, <原始消息>。TokenModule.getTokens() 和 fetchTokens() 就是这样：消息中包含 TokenListFetchError 的文本，但抛出的对象是 Error。如需区分，请匹配消息内容。

参数校验错误（普通 `Error`）

消息	原因
`Signer not set`	在未传入 `signer` 的实例上调用了写入方法。
`Network <id> not found`	未知的 `networkId`。
`Either amountIn or amountOut must be specified`	CPMM 报价既没有给出输入数量，也没有给出输出数量。
`Slippage must satisfy 0 <= slippage < 10000, received …`	CPMM 的 `slippageBps` 无效。
`slippageBps must be in [0, 10000)`	CLMM 的滑点无效。
`Unknown tokenInId … for pool …`	代币不属于你传入的池状态。
`Unknown token, id not found in token list: …`	代币不在代币列表中（查询池状态要求池中每个代币都在列表中）。
`fee and feeRecipient must be provided together`（及其他手续费消息）	集成方手续费无效。
`<Stake/Unstake/Claim> amount must be greater than zero`	质押数量不为正数。
`TickOutOfBounds: <tick>` / `SqrtPriceX96OutOfBounds`	tick 超出 `[MIN_TICK, MAX_TICK]`，或价格超出可表示范围。

链上错误

如果交易通过了 SDK 校验，但在合约中失败（超出滑点、超过截止时间、违反价格限制），节点会在签名阶段拒绝它，@alephium/web3 会抛出带有 VM 错误码的错误，例如 CLMM 兑换在全部成交之前就触及价格限制时，会报 Error Code: 501（如果价格限制位于当前价格的错误一侧，则报 106）。最常见的原因：

滑点或截止时间：在报价和提交之间池发生了变化。请重新报价并重试。
ALPH 不足以支付粉尘或押金：见 ALPH 押金与粉尘。
CLMM swapTo 方向或价格限制错误：目标价格已经在当前价格的另一侧。