@w3lib/evm-batch-call 0.5.0 → 0.6.0

package/dist/liquidity/v3.js

@@ -0,0 +1,310 @@
+import { Interface } from 'ethers';
+import { getAmountsForLiquidity, getFeeGrowthInside, getFeesEarned, getMinAmounts, getMintAmounts, getSqrtRatioAtTick, getTickAtSqrtRatio } from '../lpMath.js';
+import { liquidityFor, resolveRange, sqrtPriceOf, v3MinAmounts } from './concentrated.js';
+import { MAX_UINT128, ZERO_ADDRESS, approvals, concentratedProtocol, evm, isNative, makePlan, out, parseAmount, priceFields, removeAmount, tokenIdOf, tokenInfo, } from './common.js';
+const npmInterface = new Interface([
+    'function WETH9() view returns (address)',
+    'function factory() view returns (address)',
+    'function ownerOf(uint256 tokenId) view returns (address)',
+    'function isApprovedForAll(address owner, address operator) view returns (bool)',
+    'function positions(uint256 tokenId) view returns (uint96 nonce, address operator, address token0, address token1, uint24 fee, int24 tickLower, int24 tickUpper, uint128 liquidity, uint256 feeGrowthInside0LastX128, uint256 feeGrowthInside1LastX128, uint128 tokensOwed0, uint128 tokensOwed1)',
+    'function mint((address token0, address token1, uint24 fee, int24 tickLower, int24 tickUpper, uint256 amount0Desired, uint256 amount1Desired, uint256 amount0Min, uint256 amount1Min, address recipient, uint256 deadline) params) payable returns (uint256 tokenId, uint128 liquidity, uint256 amount0, uint256 amount1)',
+    'function increaseLiquidity((uint256 tokenId, uint256 amount0Desired, uint256 amount1Desired, uint256 amount0Min, uint256 amount1Min, uint256 deadline) params) payable returns (uint128 liquidity, uint256 amount0, uint256 amount1)',
+    'function decreaseLiquidity((uint256 tokenId, uint128 liquidity, uint256 amount0Min, uint256 amount1Min, uint256 deadline) params) payable returns (uint256 amount0, uint256 amount1)',
+    'function collect((uint256 tokenId, address recipient, uint128 amount0Max, uint128 amount1Max) params) payable returns (uint256 amount0, uint256 amount1)',
+    'function burn(uint256 tokenId) payable',
+    'function multicall(bytes[] data) payable returns (bytes[] results)',
+    'function refundETH() payable',
+    'function unwrapWETH9(uint256 amountMinimum, address recipient) payable',
+    'function sweepToken(address token, uint256 amountMinimum, address recipient) payable',
+    'function createAndInitializePoolIfNecessary(address token0, address token1, uint24 fee, uint160 sqrtPriceX96) payable returns (address pool)',
+]);
+const factoryInterface = new Interface([
+    'function getPool(address tokenA, address tokenB, uint24 fee) view returns (address)',
+    'function feeAmountTickSpacing(uint24 fee) view returns (int24)',
+]);
+// 只声明前两个返回值：各分叉 slot0 后面的字段类型不同
+const poolInterface = new Interface([
+    'function slot0() view returns (uint160 sqrtPriceX96, int24 tick)',
+    'function tickSpacing() view returns (int24)',
+    'function feeGrowthGlobal0X128() view returns (uint256)',
+    'function feeGrowthGlobal1X128() view returns (uint256)',
+    'function ticks(int24 tick) view returns (uint128 liquidityGross, int128 liquidityNet, uint256 feeGrowthOutside0X128, uint256 feeGrowthOutside1X128)',
+]);
+const U128_MASK = MAX_UINT128;
+async function factoryOf(ctx, protocol) {
+    if (protocol.factory) {
+        return evm(protocol.factory);
+    }
+    return evm((await ctx.provider.call(ctx.provider.contract(protocol.positionManager, npmInterface).factory())));
+}
+const wethOf = async (ctx, npm) => evm((await ctx.provider.call(ctx.provider.contract(npm, npmInterface).WETH9())));
+/** 读已有的仓位：仓位信息、池子状态、未领取的手续费 */
+async function readPosition(ctx, ref) {
+    const protocol = concentratedProtocol(ctx, ref);
+    const npm = evm(protocol.positionManager);
+    const tokenId = tokenIdOf(ref);
+    const c = ctx.provider.contract(npm, npmInterface);
+    const [factory, [owner, p]] = await Promise.all([
+        factoryOf(ctx, protocol),
+        ctx.provider.all([c.ownerOf(tokenId), c.positions(tokenId)]),
+    ]);
+    const pool = evm((await ctx.provider.call(ctx.provider.contract(factory, factoryInterface).getPool(p.token0, p.token1, p.fee))));
+    if (pool === ZERO_ADDRESS) {
+        throw new Error(`Cannot find the pool of position ${tokenId}`);
+    }
+    const tickLower = Number(p.tickLower);
+    const tickUpper = Number(p.tickUpper);
+    const pc = ctx.provider.contract(pool, poolInterface);
+    const [slot0, spacing, global0, global1, lower, upper, approvedForAll] = (await ctx.provider.all([
+        pc.slot0(),
+        pc.tickSpacing(),
+        pc.feeGrowthGlobal0X128(),
+        pc.feeGrowthGlobal1X128(),
+        pc.ticks(tickLower),
+        pc.ticks(tickUpper),
+        c.isApprovedForAll(owner, ctx.owner),
+    ]));
+    const tick = Number(slot0[1]);
+    const inside0 = getFeeGrowthInside(tick, tickLower, tickUpper, global0, lower[2], upper[2]);
+    const inside1 = getFeeGrowthInside(tick, tickLower, tickUpper, global1, lower[3], upper[3]);
+    return {
+        protocol,
+        npm,
+        tokenId,
+        owner: evm(owner),
+        operator: evm(p.operator),
+        approvedForAll,
+        token0: evm(p.token0),
+        token1: evm(p.token1),
+        fee: Number(p.fee),
+        tickLower,
+        tickUpper,
+        liquidity: p.liquidity,
+        pool: { address: pool, sqrtPriceX96: slot0[0], tick, tickSpacing: Number(spacing) },
+        // 与仓位合约一致：tokensOwed += uint128(新增)，按 uint128 回绕
+        fees0: (p.tokensOwed0 + (getFeesEarned(p.liquidity, inside0, p.feeGrowthInside0LastX128) & U128_MASK)) & U128_MASK,
+        fees1: (p.tokensOwed1 + (getFeesEarned(p.liquidity, inside1, p.feeGrowthInside1LastX128) & U128_MASK)) & U128_MASK,
+    };
+}
+/** 追加 / 移除 / 领取需要是仓位的所有者，或被授权的 operator（单个仓位的 approve 或 setApprovalForAll），与合约一致 */
+function assertCanManage(ctx, position) {
+    if (position.owner !== ctx.owner && position.operator !== ctx.owner && !position.approvedForAll) {
+        throw new Error(`${out(ctx, ctx.owner)} is not the owner of position ${position.tokenId} (owner: ${out(ctx, position.owner)})`);
+    }
+}
+/** 包装币那一边用主币时：确认池子里有包装币 */
+async function nativeWeth(ctx, npm, token0, token1) {
+    if (!ctx.options.native) {
+        return null;
+    }
+    const weth = await wethOf(ctx, npm);
+    if (weth !== token0 && weth !== token1) {
+        throw new Error('native: true needs one side of the pool to be the wrapped native token');
+    }
+    return weth;
+}
+const call = (name, args) => npmInterface.encodeFunctionData(name, args);
+/** 一个调用直接发，多个用仓位合约的 multicall 合成一笔 */
+const wrap = (calls) => (calls.length === 1 ? calls[0] : npmInterface.encodeFunctionData('multicall', [calls]));
+export async function v3Add(ctx, params) {
+    let protocol;
+    let npm;
+    let token0;
+    let token1;
+    let fee;
+    let pool;
+    let tickLower;
+    let tickUpper;
+    let tokenId = null;
+    let createPrice = null;
+    let weth;
+    let t0;
+    let t1;
+    let given0;
+    let given1;
+    if ('position' in params) {
+        const position = await readPosition(ctx, params.position);
+        // 合约允许任何人往别人的仓位里加流动性：tokenId 写错时代币会白送给别人，这里只允许所有者 / operator
+        assertCanManage(ctx, position);
+        ({ protocol, npm, token0, token1, fee, pool, tickLower, tickUpper } = position);
+        tokenId = position.tokenId;
+        weth = await nativeWeth(ctx, npm, token0, token1);
+        [t0, t1] = (await tokenInfo(ctx, [token0, token1]));
+        given0 = parseAmount(params.amount0, params.amount0Formatted, t0, 'amount0');
+        given1 = parseAmount(params.amount1, params.amount1Formatted, t1, 'amount1');
+    }
+    else {
+        protocol = params.protocol;
+        npm = evm(protocol.positionManager);
+        if (params.fee === undefined) {
+            throw new Error('fee is required for V3 (e.g. 500, 3000, 10000)');
+        }
+        fee = params.fee;
+        let a = evm(params.tokenA);
+        let b = evm(params.tokenB);
+        weth = null;
+        if (isNative(ctx, a) || isNative(ctx, b) || ctx.options.native) {
+            weth = await wethOf(ctx, npm);
+            a = isNative(ctx, a) ? weth : a;
+            b = isNative(ctx, b) ? weth : b;
+            if (a !== weth && b !== weth) {
+                throw new Error('native: true needs one side of the pool to be the wrapped native token');
+            }
+        }
+        if (a === b) {
+            throw new Error('tokenA and tokenB must be different');
+        }
+        const aIs0 = BigInt(a) < BigInt(b);
+        [token0, token1] = aIs0 ? [a, b] : [b, a];
+        const factory = await factoryOf(ctx, protocol);
+        const f = ctx.provider.contract(factory, factoryInterface);
+        const [address, defaultSpacing] = (await ctx.provider.all([f.getPool(token0, token1, fee), f.feeAmountTickSpacing(fee)]));
+        pool = { address: evm(address) === ZERO_ADDRESS ? null : evm(address), sqrtPriceX96: 0n, tick: 0, tickSpacing: Number(defaultSpacing) };
+        if (pool.address) {
+            const pc = ctx.provider.contract(pool.address, poolInterface);
+            const [slot0, spacing] = (await ctx.provider.all([pc.slot0(), pc.tickSpacing()]));
+            pool = { ...pool, sqrtPriceX96: slot0[0], tick: Number(slot0[1]), tickSpacing: Number(spacing) };
+        }
+        else if (pool.tickSpacing <= 0) {
+            throw new Error(`Fee tier ${fee} is not enabled on ${protocol.id}`);
+        }
+        ;
+        [t0, t1] = (await tokenInfo(ctx, [token0, token1]));
+        if (pool.sqrtPriceX96 === 0n) {
+            // 池子不存在或还没初始化：用 initialPrice 创建
+            if (params.initialPrice === undefined) {
+                throw new Error(`The ${protocol.id} pool for this pair and fee ${fee} does not exist yet; pass initialPrice to create it`);
+            }
+            createPrice = sqrtPriceOf(params.initialPrice, aIs0, t0, t1, 'initialPrice');
+            pool = { ...pool, sqrtPriceX96: createPrice, tick: getTickAtSqrtRatio(createPrice) };
+        }
+        ;
+        [tickLower, tickUpper] = resolveRange(params, aIs0, t0, t1, pool.tickSpacing);
+        const amountA = parseAmount(params.amountA, params.amountAFormatted, aIs0 ? t0 : t1, 'amountA');
+        const amountB = parseAmount(params.amountB, params.amountBFormatted, aIs0 ? t1 : t0, 'amountB');
+        [given0, given1] = aIs0 ? [amountA, amountB] : [amountB, amountA];
+    }
+    const liquidity = liquidityFor(pool.sqrtPriceX96, tickLower, tickUpper, given0, given1, t0, t1);
+    const [amount0, amount1] = getMintAmounts(pool.sqrtPriceX96, getSqrtRatioAtTick(tickLower), getSqrtRatioAtTick(tickUpper), liquidity);
+    // 传给合约的数量：给了的按给的，另一边按算出来的（合约按两边较少的算流动性，结果就是上面的 liquidity）。
+    // 价格在区间外时用不到的一边为 0（不用授权 / 附带主币）
+    const desired0 = amount0 === 0n ? 0n : (given0 ?? amount0);
+    const desired1 = amount1 === 0n ? 0n : (given1 ?? amount1);
+    const [min0, min1] = v3MinAmounts(pool.sqrtPriceX96, tickLower, tickUpper, desired0, desired1, ctx.slippage);
+    const calls = [];
+    if (createPrice !== null) {
+        calls.push(call('createAndInitializePoolIfNecessary', [token0, token1, fee, createPrice]));
+    }
+    if (tokenId === null) {
+        calls.push(call('mint', [{ token0, token1, fee, tickLower, tickUpper, amount0Desired: desired0, amount1Desired: desired1, amount0Min: min0, amount1Min: min1, recipient: ctx.recipient, deadline: ctx.deadline }]));
+    }
+    else {
+        calls.push(call('increaseLiquidity', [{ tokenId, amount0Desired: desired0, amount1Desired: desired1, amount0Min: min0, amount1Min: min1, deadline: ctx.deadline }]));
+    }
+    // 主币：附带包装币那一边的数量，多余的退回
+    const value = weth === token0 ? desired0 : weth === token1 ? desired1 : 0n;
+    if (value > 0n) {
+        calls.push(call('refundETH', []));
+    }
+    const main = { kind: 'add', to: out(ctx, npm), data: wrap(calls), value: value.toString() };
+    const approve = await approvals(ctx, [
+        { token: token0, spender: npm, amount: desired0 },
+        { token: token1, spender: npm, amount: desired1 },
+    ].filter((i) => i.token !== weth));
+    return makePlan(ctx, {
+        action: 'add',
+        version: 'v3',
+        protocol: protocol.id,
+        protocolName: protocol.name,
+        pool: pool.address,
+        createPool: createPrice !== null,
+        token0: t0,
+        token1: t1,
+        tokenId: tokenId === null ? null : tokenId.toString(),
+        tickLower,
+        tickUpper,
+        tick: pool.tick,
+        ...priceFields(t0, t1, pool.sqrtPriceX96, tickLower, tickUpper),
+        liquidity: liquidity.toString(),
+        amount0: amount0.toString(),
+        amount1: amount1.toString(),
+        amount0Max: desired0.toString(),
+        amount1Max: desired1.toString(),
+        amount0Min: null,
+        amount1Min: null,
+        // V3 追加流动性不会领取手续费（留在仓位里）
+        fees0: '0',
+        fees1: '0',
+        native: weth === null ? null : weth === token0 ? 'token0' : 'token1',
+        value: value.toString(),
+        transactions: [...approve, main],
+    });
+}
+/** 移除（liquidity > 0）/ 只领取手续费（collectOnly） */
+export async function v3Remove(ctx, params, collectOnly = false) {
+    const position = await readPosition(ctx, params.position);
+    assertCanManage(ctx, position);
+    const { npm, token0, token1, tickLower, tickUpper, tokenId, pool } = position;
+    let liquidity = 0n;
+    if (!collectOnly) {
+        if (position.liquidity === 0n) {
+            throw new Error(`Position ${tokenId} has no liquidity; use collectFees to collect what is owed`);
+        }
+        liquidity = removeAmount(position.liquidity, params.percent, params.liquidity);
+    }
+    else if (position.fees0 === 0n && position.fees1 === 0n) {
+        throw new Error(`Position ${tokenId} has no fees to collect`);
+    }
+    const burn = !collectOnly && !!params.burn;
+    if (burn && liquidity !== position.liquidity) {
+        throw new Error('burn: true needs the whole position to be removed');
+    }
+    const weth = await nativeWeth(ctx, npm, token0, token1);
+    const [t0, t1] = (await tokenInfo(ctx, [token0, token1]));
+    const sqrtA = getSqrtRatioAtTick(tickLower);
+    const sqrtB = getSqrtRatioAtTick(tickUpper);
+    const [amount0, amount1] = getAmountsForLiquidity(pool.sqrtPriceX96, sqrtA, sqrtB, liquidity);
+    const [min0, min1] = getMinAmounts(pool.sqrtPriceX96, sqrtA, sqrtB, liquidity, ctx.slippage);
+    const calls = [];
+    if (liquidity > 0n) {
+        calls.push(call('decreaseLiquidity', [{ tokenId, liquidity, amount0Min: min0, amount1Min: min1, deadline: ctx.deadline }]));
+    }
+    // 撤出的代币和手续费都要 collect 才会转出；包装币换成主币时先收到仓位合约（零地址）再转出
+    calls.push(call('collect', [{ tokenId, recipient: weth ? ZERO_ADDRESS : ctx.recipient, amount0Max: MAX_UINT128, amount1Max: MAX_UINT128 }]));
+    if (weth) {
+        calls.push(call('unwrapWETH9', [0n, ctx.recipient]));
+        calls.push(call('sweepToken', [weth === token0 ? token1 : token0, 0n, ctx.recipient]));
+    }
+    if (burn) {
+        calls.push(call('burn', [tokenId]));
+    }
+    return makePlan(ctx, {
+        action: collectOnly ? 'collect' : 'remove',
+        version: 'v3',
+        protocol: position.protocol.id,
+        protocolName: position.protocol.name,
+        pool: pool.address,
+        createPool: false,
+        token0: t0,
+        token1: t1,
+        tokenId: tokenId.toString(),
+        tickLower,
+        tickUpper,
+        tick: pool.tick,
+        ...priceFields(t0, t1, pool.sqrtPriceX96, tickLower, tickUpper),
+        liquidity: liquidity.toString(),
+        amount0: amount0.toString(),
+        amount1: amount1.toString(),
+        amount0Max: null,
+        amount1Max: null,
+        amount0Min: min0.toString(),
+        amount1Min: min1.toString(),
+        fees0: position.fees0.toString(),
+        fees1: position.fees1.toString(),
+        native: weth === null ? null : weth === token0 ? 'token0' : 'token1',
+        value: '0',
+        transactions: [{ kind: collectOnly ? 'collect' : 'remove', to: out(ctx, npm), data: wrap(calls), value: '0' }],
+    });
+}
+//# sourceMappingURL=v3.js.map

package/dist/liquidity/v3.js.map

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

package/dist/liquidity/v4.d.ts

@@ -0,0 +1,5 @@
+import { type Ctx } from './common.js';
+import type { IncreaseLiquidityParams, LiquidityPlan, NewPositionParams, RemoveLiquidityParams } from './types.js';
+export declare function v4Add(ctx: Ctx, params: IncreaseLiquidityParams | NewPositionParams): Promise<LiquidityPlan>;
+export declare function v4Remove(ctx: Ctx, params: RemoveLiquidityParams, collectOnly?: boolean): Promise<LiquidityPlan>;
+//# sourceMappingURL=v4.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"v4.d.ts","sourceRoot":"","sources":["../../src/liquidity/v4.ts"],"names":[],"mappings":"AAMA,OAAO,EAYL,KAAK,GAAG,EACT,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,uBAAuB,EAAE,aAAa,EAAE,iBAAiB,EAAe,qBAAqB,EAAE,MAAM,YAAY,CAAA;AA+I/H,wBAAsB,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CA2HjH;AAED,wBAAsB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,qBAAqB,EAAE,WAAW,UAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,CA2DnH"}

package/dist/liquidity/v4.js

@@ -0,0 +1,279 @@
+import { AbiCoder, Interface, hexlify } from 'ethers';
+import { getAmountsForLiquidity, getFeesEarned, getMaxAmounts, getMinAmounts, getMintAmounts, getSqrtRatioAtTick, getTickAtSqrtRatio } from '../lpMath.js';
+import { decodePositionInfo, poolIdOf } from '../lpV4.js';
+import { liquidityFor, resolveRange, sqrtPriceOf } from './concentrated.js';
+import { ZERO_ADDRESS, concentratedProtocol, evm, isNative, makePlan, parseAmount, permit2Approvals, priceFields, removeAmount, tokenIdOf, tokenInfo, } from './common.js';
+const pmInterface = new Interface([
+    'function ownerOf(uint256 tokenId) view returns (address)',
+    'function getApproved(uint256 tokenId) view returns (address)',
+    'function isApprovedForAll(address owner, address operator) view returns (bool)',
+    'function getPoolAndPositionInfo(uint256 tokenId) view returns ((address currency0, address currency1, uint24 fee, int24 tickSpacing, address hooks) poolKey, uint256 info)',
+    'function getPositionLiquidity(uint256 tokenId) view returns (uint128)',
+    'function modifyLiquidities(bytes unlockData, uint256 deadline) payable',
+    'function initializePool((address currency0, address currency1, uint24 fee, int24 tickSpacing, address hooks) key, uint160 sqrtPriceX96) payable returns (int24)',
+    'function multicall(bytes[] data) payable returns (bytes[] results)',
+]);
+const stateViewInterface = new Interface([
+    'function getSlot0(bytes32 poolId) view returns (uint160 sqrtPriceX96, int24 tick, uint24 protocolFee, uint24 lpFee)',
+    'function getFeeGrowthInside(bytes32 poolId, int24 tickLower, int24 tickUpper) view returns (uint256 feeGrowthInside0X128, uint256 feeGrowthInside1X128)',
+    'function getPositionInfo(bytes32 poolId, address owner, int24 tickLower, int24 tickUpper, bytes32 salt) view returns (uint128 liquidity, uint256 feeGrowthInside0LastX128, uint256 feeGrowthInside1LastX128)',
+]);
+/** v4-periphery 的 Actions */
+const Actions = {
+    INCREASE_LIQUIDITY: 0x00,
+    DECREASE_LIQUIDITY: 0x01,
+    MINT_POSITION: 0x02,
+    BURN_POSITION: 0x03,
+    SETTLE_PAIR: 0x0d,
+    TAKE_PAIR: 0x11,
+    CLOSE_CURRENCY: 0x12,
+    SWEEP: 0x14,
+};
+/** 标准手续费档位对应的 tick 间距（与 Uniswap 网页一致） */
+const DEFAULT_TICK_SPACING = { 100: 1, 500: 10, 3000: 60, 10000: 200 };
+const coder = AbiCoder.defaultAbiCoder();
+const POOL_KEY = 'tuple(address currency0, address currency1, uint24 fee, int24 tickSpacing, address hooks)';
+const keyTuple = (k) => [k.currency0, k.currency1, k.fee, k.tickSpacing, k.hooks];
+/** 依次执行的 action 列表 → modifyLiquidities 的 unlockData */
+class Planner {
+    actions = [];
+    params = [];
+    add(action, types, values) {
+        this.actions.push(action);
+        this.params.push(coder.encode(types, values));
+        return this;
+    }
+    encode() {
+        return coder.encode(['bytes', 'bytes[]'], [hexlify(new Uint8Array(this.actions)), this.params]);
+    }
+}
+function addresses(ctx, protocol) {
+    if (ctx.tron) {
+        throw new Error('Uniswap V4 is not supported on Tron');
+    }
+    if (!protocol.positionManager || !protocol.stateView) {
+        throw new Error(`Protocol ${protocol.id} needs positionManager and stateView`);
+    }
+    return { pm: evm(protocol.positionManager), stateView: evm(protocol.stateView) };
+}
+async function readPosition(ctx, ref) {
+    const protocol = concentratedProtocol(ctx, ref);
+    const { pm, stateView } = addresses(ctx, protocol);
+    const tokenId = tokenIdOf(ref);
+    const c = ctx.provider.contract(pm, pmInterface);
+    const [owner, info, liquidity] = (await ctx.provider.all([c.ownerOf(tokenId), c.getPoolAndPositionInfo(tokenId), c.getPositionLiquidity(tokenId)]));
+    const raw = info[0];
+    const key = { currency0: evm(raw.currency0), currency1: evm(raw.currency1), fee: Number(raw.fee), tickSpacing: Number(raw.tickSpacing), hooks: evm(raw.hooks) };
+    const poolId = poolIdOf(key);
+    const { tickLower, tickUpper } = decodePositionInfo(info[1]);
+    const sv = ctx.provider.contract(stateView, stateViewInterface);
+    const salt = `0x${tokenId.toString(16).padStart(64, '0')}`;
+    const [slot0, inside, last, approved, approvedForAll] = (await ctx.provider.all([
+        sv.getSlot0(poolId),
+        sv.getFeeGrowthInside(poolId, tickLower, tickUpper),
+        sv.getPositionInfo(poolId, pm, tickLower, tickUpper, salt),
+        c.getApproved(tokenId),
+        c.isApprovedForAll(owner, ctx.owner),
+    ]));
+    return {
+        protocol,
+        pm,
+        stateView,
+        tokenId,
+        owner: evm(owner),
+        // 与 PositionManager 的 onlyIfApproved 一致：所有者、单个仓位的 approve、setApprovalForAll 都可以
+        canManage: evm(owner) === ctx.owner || evm(approved) === ctx.owner || approvedForAll,
+        pool: { key, poolId, sqrtPriceX96: slot0[0], tick: Number(slot0[1]) },
+        tickLower,
+        tickUpper,
+        liquidity,
+        fees0: getFeesEarned(liquidity, inside[0], last[1]),
+        fees1: getFeesEarned(liquidity, inside[1], last[2]),
+    };
+}
+function assertOwner(ctx, position) {
+    if (!position.canManage) {
+        throw new Error(`${ctx.owner} is not the owner of position ${position.tokenId} (owner: ${position.owner})`);
+    }
+}
+const hookData = (ctx) => (ctx.options.hookData ? hexlify(ctx.options.hookData) : '0x');
+export async function v4Add(ctx, params) {
+    let protocol;
+    let pm;
+    let pool;
+    let tickLower;
+    let tickUpper;
+    let tokenId = null;
+    let createPrice = null;
+    let fees = [0n, 0n];
+    let t0;
+    let t1;
+    let given0;
+    let given1;
+    if ('position' in params) {
+        const position = await readPosition(ctx, params.position);
+        assertOwner(ctx, position);
+        ({ protocol, pm, pool, tickLower, tickUpper } = position);
+        tokenId = position.tokenId;
+        fees = [position.fees0, position.fees1];
+        [t0, t1] = (await tokenInfo(ctx, [pool.key.currency0, pool.key.currency1]));
+        given0 = parseAmount(params.amount0, params.amount0Formatted, t0, 'amount0');
+        given1 = parseAmount(params.amount1, params.amount1Formatted, t1, 'amount1');
+    }
+    else {
+        protocol = params.protocol;
+        const { pm: positionManager, stateView } = addresses(ctx, protocol);
+        pm = positionManager;
+        if (params.fee === undefined) {
+            throw new Error('fee is required for V4 (e.g. 500, 3000, 10000)');
+        }
+        const tickSpacing = params.tickSpacing ?? DEFAULT_TICK_SPACING[params.fee];
+        if (tickSpacing === undefined) {
+            throw new Error(`Pass tickSpacing: there is no default for fee ${params.fee}`);
+        }
+        // 主币是零地址，排在前面
+        const a = isNative(ctx, params.tokenA) ? ZERO_ADDRESS : evm(params.tokenA);
+        const b = isNative(ctx, params.tokenB) ? ZERO_ADDRESS : evm(params.tokenB);
+        if (a === b) {
+            throw new Error('tokenA and tokenB must be different');
+        }
+        const aIs0 = BigInt(a) < BigInt(b);
+        const key = { currency0: aIs0 ? a : b, currency1: aIs0 ? b : a, fee: params.fee, tickSpacing, hooks: params.hooks ? evm(params.hooks) : ZERO_ADDRESS };
+        const poolId = poolIdOf(key);
+        const slot0 = (await ctx.provider.call(ctx.provider.contract(stateView, stateViewInterface).getSlot0(poolId)));
+        pool = { key, poolId, sqrtPriceX96: slot0[0], tick: Number(slot0[1]) };
+        [t0, t1] = (await tokenInfo(ctx, [key.currency0, key.currency1]));
+        if (pool.sqrtPriceX96 === 0n) {
+            if (params.initialPrice === undefined) {
+                throw new Error('This V4 pool (currencies, fee, tickSpacing, hooks) is not initialized yet; pass initialPrice to create it');
+            }
+            createPrice = sqrtPriceOf(params.initialPrice, aIs0, t0, t1, 'initialPrice');
+            pool = { ...pool, sqrtPriceX96: createPrice, tick: getTickAtSqrtRatio(createPrice) };
+        }
+        ;
+        [tickLower, tickUpper] = resolveRange(params, aIs0, t0, t1, tickSpacing);
+        const amountA = parseAmount(params.amountA, params.amountAFormatted, aIs0 ? t0 : t1, 'amountA');
+        const amountB = parseAmount(params.amountB, params.amountBFormatted, aIs0 ? t1 : t0, 'amountB');
+        [given0, given1] = aIs0 ? [amountA, amountB] : [amountB, amountA];
+    }
+    const { key } = pool;
+    const sqrtA = getSqrtRatioAtTick(tickLower);
+    const sqrtB = getSqrtRatioAtTick(tickUpper);
+    const liquidity = liquidityFor(pool.sqrtPriceX96, tickLower, tickUpper, given0, given1, t0, t1);
+    const [amount0, amount1] = getMintAmounts(pool.sqrtPriceX96, sqrtA, sqrtB, liquidity);
+    // V4 直接指定流动性，价格变动时需要的数量随之变化：按滑点给出上限
+    const [max0, max1] = getMaxAmounts(pool.sqrtPriceX96, sqrtA, sqrtB, liquidity, ctx.slippage);
+    const native = key.currency0 === ZERO_ADDRESS;
+    const planner = new Planner();
+    if (tokenId === null) {
+        planner.add(Actions.MINT_POSITION, [POOL_KEY, 'int24', 'int24', 'uint256', 'uint128', 'uint128', 'address', 'bytes'], [keyTuple(key), tickLower, tickUpper, liquidity, max0, max1, ctx.recipient, hookData(ctx)]);
+        planner.add(Actions.SETTLE_PAIR, ['address', 'address'], [key.currency0, key.currency1]);
+    }
+    else {
+        planner.add(Actions.INCREASE_LIQUIDITY, ['uint256', 'uint256', 'uint128', 'uint128', 'bytes'], [tokenId, liquidity, max0, max1, hookData(ctx)]);
+        // 追加时会自动领取手续费：手续费可能比要存入的多（差额为正），CLOSE_CURRENCY 按差额的正负自动付款或收款
+        planner.add(Actions.CLOSE_CURRENCY, ['address'], [key.currency0]);
+        planner.add(Actions.CLOSE_CURRENCY, ['address'], [key.currency1]);
+    }
+    if (native) {
+        // 附带的主币按上限给，多余的退回
+        planner.add(Actions.SWEEP, ['address', 'address'], [ZERO_ADDRESS, ctx.owner]);
+    }
+    const modify = pmInterface.encodeFunctionData('modifyLiquidities', [planner.encode(), ctx.deadline]);
+    const data = createPrice === null ? modify : pmInterface.encodeFunctionData('multicall', [[pmInterface.encodeFunctionData('initializePool', [keyTuple(key), createPrice]), modify]]);
+    const value = native ? max0 : 0n;
+    const approve = await permit2Approvals(ctx, pm, [
+        { token: key.currency0, amount: max0 },
+        { token: key.currency1, amount: max1 },
+    ].filter((i) => i.token !== ZERO_ADDRESS));
+    return makePlan(ctx, {
+        action: 'add',
+        version: 'v4',
+        protocol: protocol.id,
+        protocolName: protocol.name,
+        pool: pool.poolId,
+        createPool: createPrice !== null,
+        token0: t0,
+        token1: t1,
+        tokenId: tokenId === null ? null : tokenId.toString(),
+        tickLower,
+        tickUpper,
+        tick: pool.tick,
+        ...priceFields(t0, t1, pool.sqrtPriceX96, tickLower, tickUpper),
+        liquidity: liquidity.toString(),
+        amount0: amount0.toString(),
+        amount1: amount1.toString(),
+        amount0Max: max0.toString(),
+        amount1Max: max1.toString(),
+        amount0Min: null,
+        amount1Min: null,
+        fees0: fees[0].toString(),
+        fees1: fees[1].toString(),
+        native: native ? 'token0' : null,
+        value: value.toString(),
+        transactions: [...approve, { kind: 'add', to: pm, data, value: value.toString() }],
+    });
+}
+export async function v4Remove(ctx, params, collectOnly = false) {
+    const position = await readPosition(ctx, params.position);
+    assertOwner(ctx, position);
+    const { pm, pool, tickLower, tickUpper, tokenId } = position;
+    const { key } = pool;
+    let liquidity = 0n;
+    if (!collectOnly) {
+        if (position.liquidity === 0n) {
+            throw new Error(`Position ${tokenId} has no liquidity`);
+        }
+        liquidity = removeAmount(position.liquidity, params.percent, params.liquidity);
+    }
+    else if (position.fees0 === 0n && position.fees1 === 0n) {
+        throw new Error(`Position ${tokenId} has no fees to collect`);
+    }
+    const burn = !collectOnly && !!params.burn;
+    if (burn && liquidity !== position.liquidity) {
+        throw new Error('burn: true needs the whole position to be removed');
+    }
+    const [t0, t1] = (await tokenInfo(ctx, [key.currency0, key.currency1]));
+    const sqrtA = getSqrtRatioAtTick(tickLower);
+    const sqrtB = getSqrtRatioAtTick(tickUpper);
+    const [amount0, amount1] = getAmountsForLiquidity(pool.sqrtPriceX96, sqrtA, sqrtB, liquidity);
+    const [min0, min1] = getMinAmounts(pool.sqrtPriceX96, sqrtA, sqrtB, liquidity, ctx.slippage);
+    const planner = new Planner();
+    if (burn) {
+        planner.add(Actions.BURN_POSITION, ['uint256', 'uint128', 'uint128', 'bytes'], [tokenId, min0, min1, hookData(ctx)]);
+    }
+    else {
+        // 流动性为 0 时只领取手续费
+        planner.add(Actions.DECREASE_LIQUIDITY, ['uint256', 'uint256', 'uint128', 'uint128', 'bytes'], [tokenId, liquidity, min0, min1, hookData(ctx)]);
+    }
+    planner.add(Actions.TAKE_PAIR, ['address', 'address', 'address'], [key.currency0, key.currency1, ctx.recipient]);
+    const data = pmInterface.encodeFunctionData('modifyLiquidities', [planner.encode(), ctx.deadline]);
+    return makePlan(ctx, {
+        action: collectOnly ? 'collect' : 'remove',
+        version: 'v4',
+        protocol: position.protocol.id,
+        protocolName: position.protocol.name,
+        pool: pool.poolId,
+        createPool: false,
+        token0: t0,
+        token1: t1,
+        tokenId: tokenId.toString(),
+        tickLower,
+        tickUpper,
+        tick: pool.tick,
+        ...priceFields(t0, t1, pool.sqrtPriceX96, tickLower, tickUpper),
+        liquidity: liquidity.toString(),
+        amount0: amount0.toString(),
+        amount1: amount1.toString(),
+        amount0Max: null,
+        amount1Max: null,
+        amount0Min: min0.toString(),
+        amount1Min: min1.toString(),
+        fees0: position.fees0.toString(),
+        fees1: position.fees1.toString(),
+        native: key.currency0 === ZERO_ADDRESS ? 'token0' : null,
+        value: '0',
+        transactions: [{ kind: collectOnly ? 'collect' : 'remove', to: pm, data, value: '0' }],
+    });
+}
+//# sourceMappingURL=v4.js.map