@w3lib/evm-batch-call 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.6.0
+
+### 新功能
+
+- 添加 / 移除流动性，子路径 `@w3lib/evm-batch-call/liquidity`：
+  - `buildAddLiquidity` / `buildRemoveLiquidity` / `buildCollectFees` 只构建（报价 + 按顺序发送的交易，授权在前），`addLiquidity` / `removeLiquidity` / `collectFees` 构建后签名发送（钱包同 `/write`）
+  - V2：Router 的 `addLiquidity(ETH)` / `removeLiquidity(ETH)`，数量与 Router 的取整逐位一致；V3：`mint` / `increaseLiquidity` / `decreaseLiquidity` + `collect`（+ `burn`），池子不存在时可传 `initialPrice` 创建；V4：PositionManager 的 actions + Permit2 授权，主币池子
+  - 新建仓位按价格区间（tokenB / tokenA）、tick 或全区间，给一边的数量自动算另一边；往已有仓位追加、按比例移除可以直接传 `getLpPositions` 的结果
+  - 主币：V2 / V3 的包装币那一边可以用主币支付 / 收取；滑点按价格范围算 V3 的 `amountMin`、V4 的 `amountMax` 和移除的最小数量
+  - Tron 的 SunSwap V2 / V3 同样支持
+- `LpProtocol.router`：V2 协议的 Router（内置表里的 V2 协议都已填好、在链上核对过）。SunSwap V2 用 SunSwap 网页当前使用的 Router
+- `LpProtocol.protocolFee`：V2 协议手续费给 feeTo 增发的比例（`'1/6'` / `'8/25'`），添加 / 移除时按它算 LP 总量
+- `/lp` 的数学工具新增 `getLiquidityForAmounts`、`getMintAmounts`、`getTickAtSqrtRatio`、`priceToTick`、`priceToSqrtPriceX96`、`nearestUsableTick` 等（也从 `/liquidity` 导出）
+
 ## 0.5.0
 
 ### 新功能

package/README.md

@@ -53,8 +53,9 @@ await getErc1155Balances(user, [{ contract: ITEMS, tokenId: 7 }], { chainId: 137
 | `getErc1155Balances(owner, items, opts)` | `erc1155Balances(multi, owner, items)` | **`/nft`**。ERC1155 余额 |
 | `getOwnerTokens(owner, opts)` | `ownerTokens(multi, owner, opts)` | **子路径 `/owner`**。资产列表：地址持有的代币（**不推荐使用**，结果不保证完整，见[资产列表](#资产列表)） |
 | `getLpPositions(owner, opts)` | `lpPositions(multi, owner, opts)` | **子路径 `/lp`**。LP 仓位：V2 的 LP 代币、V3 / V4 的仓位 NFT，代币数量、未领取手续费、可选美元价值，见 [LP 仓位](#lp-仓位) |
+| | `addLiquidity` / `removeLiquidity` / `collectFees`（`build*` 只构建不发送） | **子路径 `/liquidity`**。添加 / 移除流动性、领取手续费，见[添加 / 移除流动性](#添加--移除流动性) |
 
-**子路径**：NFT 查询在 `@w3lib/evm-batch-call/nft`，资产列表（含代币来源、价格源、Transfer 增量扫描）在 `@w3lib/evm-batch-call/owner`，LP 仓位在 `@w3lib/evm-batch-call/lp`，批量写操作在 `@w3lib/evm-batch-call/write`。不用这些功能时打包不会带上它们的代码（拆出后约少 15KB：只用 `getBalances` 时 minify 后约 50KB、gzip 约 17KB，均不含 ethers）。
+**子路径**：NFT 查询在 `@w3lib/evm-batch-call/nft`，资产列表（含代币来源、价格源、Transfer 增量扫描）在 `@w3lib/evm-batch-call/owner`，LP 仓位在 `@w3lib/evm-batch-call/lp`，添加 / 移除流动性在 `@w3lib/evm-batch-call/liquidity`，批量写操作在 `@w3lib/evm-batch-call/write`。不用这些功能时打包不会带上它们的代码（拆出后约少 15KB：只用 `getBalances` 时 minify 后约 50KB、gzip 约 17KB，均不含 ethers）。
 
 共同的规则：
 
@@ -275,7 +276,7 @@ await getLpPositions(user, { chainId: 1, v4: { scan: { storage } } })        //
 | Avalanche | | Uniswap | |
 | Tron | SunSwap | SunSwap | |
 
-地址都在链上核对过（2026-10）。其他 DEX / 链传自己的协议：`protocols: [{ id: 'my-dex', name: 'My DEX', version: 'v3', chainId, positionManager, factory }]`（V2 只需要 `factory`；V3 需要 `positionManager` 和 `factory`，ABI 与 Uniswap V3 相同的分叉都可以；V4 需要 `positionManager` 和 `stateView`，`deployBlock` 可选）。`protocols: ['uniswap-v3']` 只查某些协议，`versions: ['v3']` 只查某些类型。
+地址都在链上核对过（2026-10）。其他 DEX / 链传自己的协议：`protocols: [{ id: 'my-dex', name: 'My DEX', version: 'v3', chainId, positionManager, factory }]`（V2 只需要 `factory`，添加 / 移除流动性还要 `router`；V3 需要 `positionManager` 和 `factory`，ABI 与 Uniswap V3 相同的分叉都可以；V4 需要 `positionManager` 和 `stateView`，`deployBlock` 可选）。`protocols: ['uniswap-v3']` 只查某些协议，`versions: ['v3']` 只查某些类型。
 
 ### 每种类型怎么查、能不能查全
 
@@ -298,6 +299,78 @@ await getLpPositions(user, { chainId: 1, v4: { scan: { storage } } })        //
 
 **局限**：PancakeSwap 等质押到农场（MasterChef）的仓位 NFT 不在用户名下，查不到；V2 只能尽量查（见上表）；V4 需要传 `tokenIds` 或开启扫描。
 
+## 添加 / 移除流动性
+
+子路径 `@w3lib/evm-batch-call/liquidity`：V2（通过 Router）、V3（仓位 NFT）、Uniswap V4（PositionManager + Permit2），协议与 [LP 仓位](#内置的协议) 的内置表相同（含 Tron 的 SunSwap V2 / V3）。
+
+- `buildAddLiquidity` / `buildRemoveLiquidity` / `buildCollectFees`：只读取、不签名，返回预计的数量和要按顺序发送的交易（授权在前）。可以当作报价（输入一边的数量，看另一边要多少），也可以把 `transactions` 交给钱包自己发送
+- `addLiquidity` / `removeLiquidity` / `collectFees`：构建后签名发送，钱包与 `/write` 的 `batchCall` 相同（私钥、ethers Signer、浏览器钱包；Tron 上还可以是 tronWeb / tronwallet-adapter）。授权不够时先发授权交易，等它确认后再发主交易；授权失败时不发主交易
+
+```ts
+import { NATIVE_TOKEN, Provider } from '@w3lib/evm-batch-call'
+import { getLpPositions } from '@w3lib/evm-batch-call/lp'
+import { addLiquidity, buildAddLiquidity, collectFees, removeLiquidity } from '@w3lib/evm-batch-call/liquidity'
+
+const multi = new Provider(56, rpc)
+
+// 报价：新建 V3 仓位，价格区间是“1 个 tokenA 值多少个 tokenB”，给一边的数量
+const plan = await buildAddLiquidity(multi, owner, {
+  protocol: 'pancakeswap-v3', tokenA: WBNB, tokenB: USDT, fee: 500,
+  priceLower: 550, priceUpper: 650,              // 或 fullRange: true，或 tickLower / tickUpper
+  amountAFormatted: '1',                         // 或 amountA（最小单位）；也可以两边都给
+})
+// { version: 'v3', token0, token1, tickLower, tickUpper, tick, price, liquidity,
+//   amount0Formatted, amount1Formatted,            // 按当前价格预计存入的数量
+//   amount0Max, amount1Max, native: null, value: '0',
+//   transactions: [{ kind: 'approve', to: USDT, data, value: '0', token, spender, amount }, …, { kind: 'add', to: positionManager, data, value }] }
+
+// 发送：主币直接用 NATIVE_TOKEN（V2 / V3 换成包装币、附带主币支付；V4 是主币池子）
+const { status, tokenId, results } = await addLiquidity(multi, privateKey, {
+  protocol: 'uniswap-v2', tokenA: NATIVE_TOKEN, tokenB: USDT, amountAFormatted: '0.5',
+})
+
+// 已有仓位：直接用 getLpPositions 的结果（或 { protocol, tokenId } / { pool }）
+const [position] = await getLpPositions(owner, { chainId: 56 })
+await addLiquidity(multi, privateKey, { position, amount0Formatted: '0.1' })     // 追加，另一边按当前价格算
+await removeLiquidity(multi, privateKey, { position, percent: 50 })              // 按比例移除（V3 / V4 同时领取全部手续费）
+await removeLiquidity(multi, privateKey, { position, burn: true }, { native: true }) // 全部移除、销毁 NFT，包装币换成主币
+await collectFees(multi, privateKey, { position })                               // 只领取手续费
+```
+
+| | V2 | V3 | V4 |
+| --- | --- | --- | --- |
+| 新建 / 追加 | Router `addLiquidity(ETH)`，池子不存在时创建（两边数量都要给） | `mint` / `increaseLiquidity`；池子不存在时传 `initialPrice` 创建 | `MINT_POSITION` / `INCREASE_LIQUIDITY`；池子没初始化时传 `initialPrice` |
+| 移除 | Router `removeLiquidity(ETH)`，先授权 LP 代币 | `decreaseLiquidity` + `collect`（+ `burn`），用 multicall 合成一笔 | `DECREASE_LIQUIDITY` / `BURN_POSITION` + `TAKE_PAIR` |
+| 授权 | 代币授权给 Router | 代币授权给仓位合约 | 代币授权给 Permit2，再在 Permit2 里授权给仓位合约（30 天有效） |
+| 主币 | `native: true` 或 `tokenA` 传主币：包装币那一边用主币 | 同 V2（`refundETH` / `unwrapWETH9` + `sweepToken`） | 主币池子（`currency0` 是零地址）直接用主币 |
+| 手续费 | 已计入 LP 份额 | 追加不领取；移除时一并领取，`collectFees` 单独领取 | 修改流动性时自动领取（计划里的 `fees0` / `fees1`） |
+
+选项（构建和发送都可以传）：
+
+- `slippage`：价格滑点，默认 `0.005`（0.5%）。V2 是数量 × (1 − 滑点)；V3 / V4 按价格在 `[p × (1 − s), p × (1 + s)]` 内变动时的数量算：V3 添加给出 `amountMin`（三个价格下合约实际会用掉的最小值），V4 添加给出 `amountMax`（会多授权 / 附带一点，用不完的不扣、主币退回），移除给出 `amount0Min` / `amount1Min`
+- `deadline`：交易有效期（秒），默认 1200；`recipient`：收到 LP 代币 / NFT / 移除的代币的地址，默认发送者
+- `approve`：`'exact'`（默认，本次需要的数量）或 `'max'`。已有非零但不够的额度直接改成新额度；只有 Ethereum 上的 USDT 等要求先归零的代币才先 approve 0（有的代币反过来不允许 approve 0）
+- `native`：V2 / V3 的包装币那一边用主币支付 / 收取（新建时 `tokenA` / `tokenB` 传主币地址会自动开启）
+- `protocols`：内置表里没有的协议（自己的 `LpProtocol`，V2 要带 `router`）；`hookData`：V4 传给 hooks 的数据
+- 发送时还有 `/write` 的发送参数（`wait`、`timeout`、`gasPrice`、`signal`、`onUpdate`…）和 `checkBalance`（默认 true：代币按预计数量、主币按 `value` 检查余额，不够时直接报错，不发交易）
+
+数值：
+
+- **流动性**：V3 / V4 的 `liquidity` 与合约算出来的逐位一致；V2 的 LP 数量和移除数量已按协议手续费算过（`feeTo` 开启时每次添加 / 移除前先给手续费地址增发 LP：比例看 `LpProtocol.protocolFee`：内置的 Uniswap / SushiSwap / SunSwap 是 `'1/6'`，PancakeSwap 是 `'8/25'`；自定义协议没填时按 `'8/25'` 偏保守地算），Uniswap V2 和 SunSwap V2 上与实际逐位一致
+- **数量**：添加时 `amount0` / `amount1` 是按当前价格实际会用掉的（V2 与 Router 的取整一致；给了的一边可能因为取整少用几 wei），`amount0Max` / `amount1Max` 是传给合约的上限；移除时是按当前价格能拿到的（不含手续费），`fees0` / `fees1` 是一并领取的手续费
+- **区间**：价格按 tokenB / tokenA 给，换算成池子的 tick（token1 / token0 方向，tokenA 是 token1 时自动取倒数），再取最近的可用 tick（`tickSpacing` 的整数倍）；计划里的 `priceLower` / `priceUpper` 是取整后的实际区间（token1 / token0）。价格在区间外时只需要一种代币，给错了会报错并说明需要哪一种
+- **新仓位的 tokenId**：发送后从回执里读（EVM 上主交易 confirmed 时）；Tron 上为 null，用 `getLpPositions` 查
+- 往已有仓位追加、移除、领取都会先确认发送者是仓位的所有者（V3 也可以是被授权的 operator），不是时构建就报错（V3 的合约允许任何人往别人的仓位里加流动性，tokenId 写错时代币会白送给别人）
+- **V4 的上限可能超过给的数量**：V4 直接指定流动性，`amountMax` 是价格在滑点范围内最不利时需要的数量（与 Uniswap 的 SDK 相同），授权和附带的主币按它给，实际只扣按成交价格算的部分、主币多余的退回。主币池子要求余额够 `value`（= `amount0Max`），给的数量接近全部余额时请留出这部分或调小滑点。V3 传给合约的就是给的数量，不会超出
+- `dryRun: true` 时如果需要授权，主交易会预估失败（授权还没上链）；只想看数量用 `build*`
+
+核对方式：EVM 在 Base 主网分叉（anvil）上真实发交易，覆盖 Uniswap V2 / V3 / V4 和 PancakeSwap V3 的新建、追加、部分移除、全部移除并销毁；Tron 以近期真实用户的身份在主网预执行（SunSwap V2 添加 / 移除、V3 移除 / 追加），结果与计划逐位核对。
+
+**局限**：手续费转账代币（fee-on-transfer）不支持；V4 的 hooks 如果额外收取 / 返还代币，计划里的数量不含这部分（交易仍按 `amountMax` / `amountMin` 保护）；PancakeSwap 质押到农场的仓位要先取出。
+
+打包：在已经用到 `Provider` 的基础上，只用 `build*` 约增加 40KB（minify，gzip 约 13KB），加上发送约 77KB（gzip 约 26KB，其中大部分是 `/write` 的发送代码），均不含 ethers。
+
+
 ## 功能
 
 - **常用查询**：余额、代币详情、授权额度、NFT（集合 / 持有 / 元数据地址 / ERC1155 余额，子路径 `/nft`），一个函数一次请求
@@ -655,6 +728,10 @@ await router.swap.staticCall(params, { value })
 ```bash
 pnpm test              # 单元测试（mock 节点，不需要网络）
 pnpm test:live         # 连真实节点：BSC / Ethereum / Tron 主网（BSC_RPC / ETH_RPC / TRON_HOST / TRON_API_KEY 可覆盖）
+pnpm test:live:lp      # LP 仓位连主网核对（Ethereum / BSC / Base）
+pnpm test:live:liquidity   # SunSwap 加减流动性：在 Tron 主网上以真实用户的地址模拟（不发送）
+pnpm test:fork         # 加减流动性在主网分叉上真实执行：先 anvil --fork-url https://mainnet.base.org --port 18545，再带 FORK_RPC=http://127.0.0.1:18545
+pnpm demo              # 本地运行 demo（demo/，直接用 src 的源码）
 pnpm build             # 编译到 dist
 pnpm build:contracts   # 修改 contracts/ 后重新生成 src/deployless.ts
 pnpm check:rpc         # 检查内置公共节点表的可用性（--chain=56 只查一条链）

package/dist/liquidity/common.d.ts

@@ -0,0 +1,72 @@
+import { Interface, type BigNumberish } from 'ethers';
+import { type LpPosition, type LpProtocol, type LpToken, type LpVersion } from '../lp.js';
+import type { Provider } from '../provider.js';
+import type { LiquidityOptions, LiquidityPlan, LiquidityTx, PositionRef } from './types.js';
+export declare const ZERO_ADDRESS: string;
+export { MAX_UINT128 } from '../lpMath.js';
+/** Uniswap 的 Permit2（各 EVM 链上地址相同），V4 的仓位合约通过它收取代币 */
+export declare const PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+export declare const erc20Interface: Interface;
+/** 一次构建用到的公共信息 */
+export interface Ctx {
+    provider: Provider;
+    chainId: number;
+    tron: boolean;
+    /** 0x 格式（ABI 编码用） */
+    owner: string;
+    recipient: string;
+    slippage: number;
+    /** 截止时间（秒级时间戳） */
+    deadline: number;
+    options: LiquidityOptions;
+}
+/** 地址统一成 0x 的校验和格式（Tron 的 T 地址先转换） */
+export declare function evm(address: string): string;
+export declare const same: (a: string, b: string) => boolean;
+/** 输出的地址：Tron 上转成 T 地址 */
+export declare function out(ctx: Pick<Ctx, 'tron'>, address: string): string;
+export declare function createCtx(provider: Provider, owner: string, options: LiquidityOptions): Promise<Ctx>;
+/** 是否是主币地址（NATIVE_TOKEN / 零地址，或 Provider 配置的主币地址） */
+export declare function isNative(ctx: Ctx, address: string): boolean;
+/** 代币信息（symbol / 精度）；零地址是 V4 的主币 */
+export declare function tokenInfo(ctx: Ctx, addresses: readonly string[]): Promise<LpToken[]>;
+export declare function fmt(value: bigint, token: LpToken): string | null;
+/** 解析输入的数量：amount（最小单位）和 formatted 二选一，都没给时返回 undefined */
+export declare function parseAmount(raw: BigNumberish | undefined, formatted: string | undefined, token: LpToken, name: string): bigint | undefined;
+/** 按滑点向下取：value × (1 − slippage) */
+export declare function minus(value: bigint, slippage: number): bigint;
+/** 移除的数量：percent（百分数）或 liquidity，二选一，默认全部 */
+export declare function removeAmount(total: bigint, percent: number | undefined, liquidity: BigNumberish | undefined): bigint;
+export declare function protocolById(ctx: Ctx, protocol: string | LpProtocol): LpProtocol;
+/** V3 / V4 仓位所属的协议：按 positionManager 找，没有时按协议 id */
+export declare function concentratedProtocol(ctx: Ctx, ref: PositionRef | LpPosition): LpProtocol;
+/** 仓位是哪个版本：LpPosition 自带；PositionRef 有 tokenId 的看协议，否则是 V2 */
+export declare function positionVersion(ctx: Ctx, ref: PositionRef | LpPosition): LpVersion;
+export declare function tokenIdOf(ref: PositionRef | LpPosition): bigint;
+/** ERC20 授权：额度不够时 approve（USDT 等已有非零额度时先 approve 0）。amount 为 0 的不需要 */
+export declare function approvals(ctx: Ctx, items: ReadonlyArray<{
+    token: string;
+    spender: string;
+    amount: bigint;
+}>): Promise<LiquidityTx[]>;
+/** V4：代币先授权给 Permit2，再在 Permit2 里授权给仓位合约（额度不够或已过期时） */
+export declare function permit2Approvals(ctx: Ctx, spender: string, items: ReadonlyArray<{
+    token: string;
+    amount: bigint;
+}>): Promise<LiquidityTx[]>;
+/** 计划里的价格字段（token1 / token0，按精度换算） */
+export declare function priceFields(token0: LpToken, token1: LpToken, sqrtPriceX96: bigint | null, tickLower: number, tickUpper: number): {
+    price: null;
+    priceLower: null;
+    priceUpper: null;
+} | {
+    price: number | null;
+    priceLower: number;
+    priceUpper: number;
+};
+type PlanInput = Omit<LiquidityPlan, 'chainId' | 'owner' | 'recipient' | 'deadline' | 'amount0Formatted' | 'amount1Formatted' | 'fees0Formatted' | 'fees1Formatted' | 'pool'> & {
+    pool: string | null;
+};
+/** 补上公共字段、格式化数量 */
+export declare function makePlan(ctx: Ctx, input: PlanInput): LiquidityPlan;
+//# sourceMappingURL=common.d.ts.map

package/dist/liquidity/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/liquidity/common.ts"],"names":[],"mappings":"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"}

package/dist/liquidity/common.js

@@ -0,0 +1,271 @@
+import { Interface, MaxUint256, ZeroAddress, getAddress, getBigInt, parseUnits } from 'ethers';
+import { formatUnits } from '../erc20.js';
+import { LP_PROTOCOLS } from '../lp.js';
+import { sqrtPriceToPrice, tickToPrice } from '../lpMath.js';
+import { isTronAddress, isTronChain, toEvmAddress, toTronAddress } from '../tron.js';
+export const ZERO_ADDRESS = ZeroAddress;
+export { MAX_UINT128 } from '../lpMath.js';
+const MAX_UINT160 = 2n ** 160n - 1n;
+/** Uniswap 的 Permit2（各 EVM 链上地址相同），V4 的仓位合约通过它收取代币 */
+export const PERMIT2_ADDRESS = '0x000000000022D473030F116dDEE9F6B43aC78BA3';
+/** Permit2 授权的有效期：30 天（与 Uniswap 网页一致） */
+const PERMIT2_EXPIRATION = 30 * 24 * 3600;
+export const erc20Interface = new Interface([
+    'function allowance(address owner, address spender) view returns (uint256)',
+    'function approve(address spender, uint256 amount) returns (bool)',
+]);
+const permit2Interface = new Interface([
+    'function allowance(address owner, address token, address spender) view returns (uint160 amount, uint48 expiration, uint48 nonce)',
+    'function approve(address token, address spender, uint160 amount, uint48 expiration)',
+]);
+/** 地址统一成 0x 的校验和格式（Tron 的 T 地址先转换） */
+export function evm(address) {
+    return getAddress(isTronAddress(address) ? toEvmAddress(address) : address);
+}
+export const same = (a, b) => evm(a) === evm(b);
+/** 输出的地址：Tron 上转成 T 地址 */
+export function out(ctx, address) {
+    return ctx.tron ? toTronAddress(address) : address;
+}
+export async function createCtx(provider, owner, options) {
+    const chainId = await provider.getChainId();
+    const slippage = options.slippage ?? 0.005;
+    if (!(slippage >= 0 && slippage < 1)) {
+        throw new RangeError(`slippage must be in [0, 1): ${slippage}`);
+    }
+    const seconds = options.deadline ?? 1200;
+    if (!(seconds > 0)) {
+        throw new RangeError(`deadline must be greater than 0: ${seconds}`);
+    }
+    return {
+        provider,
+        chainId,
+        tron: isTronChain(chainId),
+        owner: evm(owner),
+        recipient: evm(options.recipient ?? owner),
+        slippage,
+        deadline: Math.floor(Date.now() / 1000) + Math.floor(seconds),
+        options,
+    };
+}
+/** 是否是主币地址（NATIVE_TOKEN / 零地址，或 Provider 配置的主币地址） */
+export function isNative(ctx, address) {
+    return evm(address) === ZERO_ADDRESS || ctx.provider.isNativeToken(address) || ctx.provider.isNativeToken(evm(address));
+}
+/** 代币信息（symbol / 精度）；零地址是 V4 的主币 */
+export async function tokenInfo(ctx, addresses) {
+    const nativeAlias = ctx.provider.isNativeToken(ZERO_ADDRESS) ? undefined : ctx.provider.nativeTokens[0];
+    const query = addresses.map((a) => (a === ZERO_ADDRESS && nativeAlias !== undefined ? nativeAlias : a));
+    const details = await ctx.provider.tokens(query, { fields: ['symbol', 'decimals'] });
+    return addresses.map((address, i) => {
+        const d = details[i];
+        return { address: out(ctx, address), native: d?.native ?? false, symbol: d?.symbol ?? null, decimals: d?.decimals ?? null };
+    });
+}
+export function fmt(value, token) {
+    return token.decimals === null ? null : formatUnits(value, token.decimals);
+}
+/** 解析输入的数量：amount（最小单位）和 formatted 二选一，都没给时返回 undefined */
+export function parseAmount(raw, formatted, token, name) {
+    if (raw !== undefined && formatted !== undefined) {
+        throw new Error(`Pass either ${name} or ${name}Formatted, not both`);
+    }
+    let value;
+    if (formatted !== undefined) {
+        if (token.decimals === null) {
+            throw new Error(`Cannot read the decimals of ${token.address}; pass ${name} in raw units instead of ${name}Formatted`);
+        }
+        value = parseUnits(formatted, token.decimals);
+    }
+    else if (raw !== undefined) {
+        value = getBigInt(raw);
+    }
+    else {
+        return undefined;
+    }
+    if (value < 0n) {
+        throw new RangeError(`${name} must not be negative`);
+    }
+    return value;
+}
+/** 按滑点向下取：value × (1 − slippage) */
+export function minus(value, slippage) {
+    return (value * (1000000n - BigInt(Math.round(slippage * 1e6)))) / 1000000n;
+}
+/** 移除的数量：percent（百分数）或 liquidity，二选一，默认全部 */
+export function removeAmount(total, percent, liquidity) {
+    if (percent !== undefined && liquidity !== undefined) {
+        throw new Error('Pass either percent or liquidity, not both');
+    }
+    if (liquidity !== undefined) {
+        const value = getBigInt(liquidity);
+        if (value <= 0n || value > total) {
+            throw new RangeError(`liquidity must be in (0, ${total}]: ${value}`);
+        }
+        return value;
+    }
+    const p = percent ?? 100;
+    if (!(p > 0 && p <= 100)) {
+        throw new RangeError(`percent must be in (0, 100]: ${p}`);
+    }
+    const amount = p === 100 ? total : (total * BigInt(Math.round(p * 10_000))) / 1000000n;
+    if (amount === 0n) {
+        throw new RangeError(`${p}% of ${total} rounds to 0`);
+    }
+    return amount;
+}
+/** 选出协议：自定义的优先，再找内置表 */
+function candidates(ctx) {
+    return [...(ctx.options.protocols ?? []).filter((p) => p.chainId === ctx.chainId), ...LP_PROTOCOLS.filter((p) => p.chainId === ctx.chainId)];
+}
+export function protocolById(ctx, protocol) {
+    if (typeof protocol !== 'string') {
+        if (protocol.chainId !== ctx.chainId) {
+            throw new Error(`Protocol ${protocol.id} is on chain ${protocol.chainId}, not ${ctx.chainId}`);
+        }
+        return protocol;
+    }
+    const found = candidates(ctx).find((p) => p.id === protocol);
+    if (!found) {
+        throw new Error(`Unknown LP protocol ${protocol} on chain ${ctx.chainId}; pass an LpProtocol object (or options.protocols) for protocols that are not built in`);
+    }
+    return found;
+}
+/** V3 / V4 仓位所属的协议：按 positionManager 找，没有时按协议 id */
+export function concentratedProtocol(ctx, ref) {
+    const pm = 'positionManager' in ref && ref.positionManager ? evm(ref.positionManager) : null;
+    if (pm) {
+        const fromRef = ref.protocol && typeof ref.protocol !== 'string' ? [ref.protocol] : [];
+        const found = [...fromRef, ...candidates(ctx)].find((p) => (p.version === 'v3' || p.version === 'v4') && p.positionManager && same(p.positionManager, pm));
+        if (!found) {
+            throw new Error(`Unknown position manager ${pm} on chain ${ctx.chainId}; pass its LpProtocol in options.protocols`);
+        }
+        return found;
+    }
+    if (!ref.protocol) {
+        throw new Error('position needs positionManager or protocol');
+    }
+    const found = protocolById(ctx, ref.protocol);
+    if (found.version === 'v2') {
+        throw new Error(`${found.id} is a V2 protocol; V2 positions are identified by pool`);
+    }
+    return found;
+}
+/** 仓位是哪个版本：LpPosition 自带；PositionRef 有 tokenId 的看协议，否则是 V2 */
+export function positionVersion(ctx, ref) {
+    if ('version' in ref && (ref.version === 'v2' || ref.version === 'v3' || ref.version === 'v4')) {
+        return ref.version;
+    }
+    if (!('tokenId' in ref) || ref.tokenId === undefined) {
+        if (!ref.pool) {
+            throw new Error('position needs pool (V2) or tokenId (V3 / V4)');
+        }
+        // 传了 V3 / V4 的协议却没有 tokenId：说清楚，不要当成 V2 的池子去读
+        if (ref.protocol && (typeof ref.protocol === 'string' ? protocolById(ctx, ref.protocol) : ref.protocol).version !== 'v2') {
+            throw new Error('position.tokenId is required for V3 / V4 positions');
+        }
+        return 'v2';
+    }
+    return concentratedProtocol(ctx, ref).version;
+}
+export function tokenIdOf(ref) {
+    if (!('tokenId' in ref) || ref.tokenId === undefined) {
+        throw new Error('position.tokenId is required');
+    }
+    if (typeof ref.tokenId === 'number' && !Number.isSafeInteger(ref.tokenId)) {
+        throw new RangeError(`tokenId ${ref.tokenId} is not a safe integer; pass it as a string or bigint`);
+    }
+    return getBigInt(ref.tokenId);
+}
+/**
+ * 要求先把额度归零才能改成另一个非零值的代币（chainId:小写地址）。只对它们先 approve 0：
+ * 有的代币（如 Ethereum 上的 BNB）反过来不允许 approve 0
+ */
+const RESET_FIRST = new Set([
+    '1:0xdac17f958d2ee523a2206206994597c13d831ec7', // USDT
+    '1:0xdd974d5c2e2928dea5f71b9825b8b646686bd200', // KNC（旧版）
+]);
+/** ERC20 授权：额度不够时 approve（USDT 等已有非零额度时先 approve 0）。amount 为 0 的不需要 */
+export async function approvals(ctx, items) {
+    const needed = items.filter((i) => i.amount > 0n);
+    if (!needed.length) {
+        return [];
+    }
+    const current = await ctx.provider.all(needed.map((i) => ctx.provider.contract(i.token, erc20Interface).allowance(ctx.owner, i.spender)));
+    return needed.flatMap((item, k) => {
+        const allowance = current[k];
+        if (allowance >= item.amount) {
+            return [];
+        }
+        const amount = ctx.options.approve === 'max' ? MaxUint256 : item.amount;
+        const tx = (value) => ({
+            kind: 'approve',
+            to: out(ctx, item.token),
+            data: erc20Interface.encodeFunctionData('approve', [item.spender, value]),
+            value: '0',
+            token: out(ctx, item.token),
+            spender: out(ctx, item.spender),
+            amount: value.toString(),
+        });
+        return allowance > 0n && RESET_FIRST.has(`${ctx.chainId}:${item.token.toLowerCase()}`) ? [tx(0n), tx(amount)] : [tx(amount)];
+    });
+}
+/** V4：代币先授权给 Permit2，再在 Permit2 里授权给仓位合约（额度不够或已过期时） */
+export async function permit2Approvals(ctx, spender, items) {
+    const needed = items.filter((i) => i.amount > 0n);
+    if (!needed.length) {
+        return [];
+    }
+    const erc20 = await approvals(ctx, needed.map((i) => ({ token: i.token, spender: PERMIT2_ADDRESS, amount: i.amount })));
+    const permits = (await ctx.provider.all(needed.map((i) => ctx.provider.contract(PERMIT2_ADDRESS, permit2Interface).allowance(ctx.owner, i.token, spender))));
+    const now = Math.floor(Date.now() / 1000);
+    const permit2 = needed.flatMap((item, k) => {
+        const [amount, expiration] = [permits[k]?.[0] ?? 0n, Number(permits[k]?.[1] ?? 0n)];
+        // 额度够、并且在交易截止时间之后才过期：不用再授权
+        if (amount >= item.amount && expiration >= ctx.deadline) {
+            return [];
+        }
+        // 过期重新授权时保留原来更大的额度（如之前授权过无限额度）
+        const value = ctx.options.approve === 'max' ? MAX_UINT160 : amount > item.amount ? amount : item.amount;
+        return [
+            {
+                kind: 'permit2',
+                to: PERMIT2_ADDRESS,
+                data: permit2Interface.encodeFunctionData('approve', [item.token, spender, value, Math.max(now, ctx.deadline) + PERMIT2_EXPIRATION]),
+                value: '0',
+                token: item.token,
+                spender,
+                amount: value.toString(),
+            },
+        ];
+    });
+    return [...erc20, ...permit2];
+}
+/** 计划里的价格字段（token1 / token0，按精度换算） */
+export function priceFields(token0, token1, sqrtPriceX96, tickLower, tickUpper) {
+    if (token0.decimals === null || token1.decimals === null) {
+        return { price: null, priceLower: null, priceUpper: null };
+    }
+    return {
+        price: sqrtPriceX96 ? sqrtPriceToPrice(sqrtPriceX96, token0.decimals, token1.decimals) : null,
+        priceLower: tickToPrice(tickLower, token0.decimals, token1.decimals),
+        priceUpper: tickToPrice(tickUpper, token0.decimals, token1.decimals),
+    };
+}
+/** 补上公共字段、格式化数量 */
+export function makePlan(ctx, input) {
+    const { token0, token1 } = input;
+    return {
+        ...input,
+        chainId: ctx.chainId,
+        pool: input.pool === null || input.version === 'v4' ? input.pool : out(ctx, input.pool),
+        owner: out(ctx, ctx.owner),
+        recipient: out(ctx, ctx.recipient),
+        amount0Formatted: fmt(BigInt(input.amount0), token0),
+        amount1Formatted: fmt(BigInt(input.amount1), token1),
+        fees0Formatted: fmt(BigInt(input.fees0), token0),
+        fees1Formatted: fmt(BigInt(input.fees1), token1),
+        deadline: ctx.deadline,
+    };
+}
+//# sourceMappingURL=common.js.map

package/dist/liquidity/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/liquidity/common.ts"],"names":[],"mappings":"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"}

package/dist/liquidity/concentrated.d.ts

@@ -0,0 +1,19 @@
+import type { LpToken } from '../lp.js';
+import type { NewPositionParams } from './types.js';
+/**
+ * 价格（tokenB / tokenA，按精度换算）→ 池子的 sqrtPriceX96（token1 / token0）。aIs0：tokenA 是不是 token0
+ */
+export declare function sqrtPriceOf(price: string | number, aIs0: boolean, token0: LpToken, token1: LpToken, name: string): bigint;
+/** 新建仓位的 tick 区间：fullRange / tickLower + tickUpper / priceLower + priceUpper 三选一 */
+export declare function resolveRange(params: NewPositionParams, aIs0: boolean, token0: LpToken, token1: LpToken, tickSpacing: number): [number, number];
+/**
+ * 按输入的数量算添加的流动性：两边都给时取较少的一边；只给一边时另一边按当前价格算。
+ * 价格在区间外时只需要一种代币，给错了另一种会报错
+ */
+export declare function liquidityFor(sqrtPrice: bigint, tickLower: number, tickUpper: number, amount0: bigint | undefined, amount1: bigint | undefined, token0: LpToken, token1: LpToken): bigint;
+/**
+ * V3：按传给仓位合约的数量（desired），价格在滑点范围内变动时至少会用掉多少（amountMin）。
+ * 合约按当时的价格重新算流动性：token0 在价格最高时用得最少，token1 在最低时；取三个价格下的最小值
+ */
+export declare function v3MinAmounts(sqrtPrice: bigint, tickLower: number, tickUpper: number, desired0: bigint, desired1: bigint, slippage: number): [bigint, bigint];
+//# sourceMappingURL=concentrated.d.ts.map

package/dist/liquidity/concentrated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concentrated.d.ts","sourceRoot":"","sources":["../../src/liquidity/concentrated.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAgBvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAUzH;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAoC9I;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CA0BxL;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAY5J"}