@w3lib/evm-batch-call 0.7.0 → 0.8.0

package/dist/portfolio.js

@@ -3,6 +3,7 @@
  */
 import { lpPositions } from './lp.js';
 import { combinePrices, defillamaPrices, onchainPrices, tokenPrices } from './price.js';
+import { withSignal } from './util.js';
 /**
  * 一个地址的资产总值：代币余额（只看传入的代币，EVM 不能只靠节点列出持仓）× 价格，可选加上 LP 仓位。
  *
@@ -12,14 +13,18 @@ import { combinePrices, defillamaPrices, onchainPrices, tokenPrices } from './pr
  * ```
  */
 export async function portfolio(provider, owner, options) {
-    const { tokens, sources = [defillamaPrices(), onchainPrices()], lp, minUsd = 0, onPriceError, fetch: fetchFn } = options;
+    const { tokens, sources = [defillamaPrices(), onchainPrices()], lp, minUsd = 0, onPriceError, fetch: fetchFn, signal } = options;
+    signal?.throwIfAborted();
     const onError = onPriceError ? (_, err) => onPriceError(err) : undefined;
+    const sig = signal ? { signal } : {};
     const [balances, positions] = await Promise.all([
-        tokens.length ? provider.balances(owner, tokens, { symbol: true }) : Promise.resolve([]),
-        lp ? lpPositions(provider, owner, { ...(lp === true ? {} : lp), prices: combinePrices(sources, { onError }), ...(fetchFn ? { fetch: fetchFn } : {}), ...(onPriceError ? { onPriceError } : {}) }) : Promise.resolve([]),
+        tokens.length ? provider.balances(owner, tokens, { symbol: true, ...sig }) : Promise.resolve([]),
+        lp ? lpPositions(provider, owner, { ...(lp === true ? {} : lp), prices: combinePrices(sources, { onError }), ...(fetchFn ? { fetch: fetchFn } : {}), ...(onPriceError ? { onPriceError } : {}), ...sig }) : Promise.resolve([]),
     ]);
     const held = balances.filter((b) => b.success && BigInt(b.balance) > 0n);
-    const prices = held.length ? await tokenPrices(provider, held.map((b) => b.token), { sources, ...(onError ? { onError } : {}), ...(fetchFn ? { fetch: fetchFn } : {}) }) : [];
+    const prices = held.length
+        ? await withSignal(signal, () => tokenPrices(provider, held.map((b) => b.token), { sources, ...(onError ? { onError } : {}), ...(fetchFn ? { fetch: fetchFn } : {}) }))
+        : [];
     const list = held.map((b, i) => {
         const p = prices[i];
         const price = p?.price ?? null;

package/dist/portfolio.js.map

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

package/dist/rewards/farms.d.ts

@@ -0,0 +1,26 @@
+import { Interface } from 'ethers';
+import type { CallOverrides } from '../aggregate.js';
+import { type Ctx } from '../liquidity/common.js';
+import { type LpProtocol } from '../lp.js';
+import type { ClaimItem, FarmProtocol } from './types.js';
+/**
+ * 内置的挖矿合约（2026-10 在链上逐个核对：合约有代码，MasterChefV3 的 CAKE / nonfungiblePositionManager / poolLength、
+ * Voter 的 length / pools / gauges 能读，CLGauge 的 stakedValues / earned 能读）。
+ * Uniswap V3 的激励（UniswapV3Staker）按 IncentiveKey 领取，key 不能从链上按用户列出，不在表里
+ */
+export declare const FARM_PROTOCOLS: readonly FarmProtocol[];
+export declare const masterChefInterface: Interface;
+export declare const gaugeInterface: Interface;
+type Source = {
+    ctx: Ctx;
+    owner: string;
+    overrides: CallOverrides;
+    maxPositions: number;
+    lpProtocols: readonly LpProtocol[];
+};
+/** MasterChefV3：用户质押的仓位。返回挖矿奖励（CAKE）和质押仓位未领取的手续费 */
+export declare function readMasterChef(source: Source, farm: FarmProtocol, wantFees: boolean, wantRewards: boolean): Promise<ClaimItem[]>;
+/** Slipstream gauge：用户质押的仓位和待领取的奖励 */
+export declare function readGauges(source: Source, farm: FarmProtocol, gauges: readonly string[] | undefined): Promise<ClaimItem[]>;
+export {};
+//# sourceMappingURL=farms.d.ts.map

package/dist/rewards/farms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"farms.d.ts","sourceRoot":"","sources":["../../src/rewards/farms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAElC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,OAAO,EAA6B,KAAK,GAAG,EAAE,MAAM,wBAAwB,CAAA;AAC5E,OAAO,EAAiD,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAIzF,OAAO,KAAK,EAAe,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAWtE;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAqBjD,CAAA;AAED,eAAO,MAAM,mBAAmB,WAQ9B,CAAA;AACF,eAAO,MAAM,cAAc,WAAyD,CAAA;AA4DpF,KAAK,MAAM,GAAG;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,aAAa,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAA;CAAE,CAAA;AAI7H,oDAAoD;AACpD,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAkEtI;AAED,sCAAsC;AACtC,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAqChI"}

package/dist/rewards/farms.js

@@ -0,0 +1,210 @@
+import { Interface } from 'ethers';
+import { evm, fmt, same, tokenInfo } from '../liquidity/common.js';
+import { lpPositionsByIds } from '../lp.js';
+import { withSignal } from '../util.js';
+import { mapPool } from '../write/send.js';
+const masterChef = (chainId, address) => ({
+    id: 'pancakeswap-v3',
+    name: 'PancakeSwap V3 Farm',
+    kind: 'masterchef-v3',
+    chainId,
+    positionManager: '0x46A15B0b27311cedF172AB29E4f4766fbE7F4364',
+    masterChef: address,
+});
+/**
+ * 内置的挖矿合约（2026-10 在链上逐个核对：合约有代码，MasterChefV3 的 CAKE / nonfungiblePositionManager / poolLength、
+ * Voter 的 length / pools / gauges 能读，CLGauge 的 stakedValues / earned 能读）。
+ * Uniswap V3 的激励（UniswapV3Staker）按 IncentiveKey 领取，key 不能从链上按用户列出，不在表里
+ */
+export const FARM_PROTOCOLS = [
+    masterChef(56, '0x556B9306565093C855AEA9AE92A594704c2Cd59e'),
+    masterChef(1, '0x556B9306565093C855AEA9AE92A594704c2Cd59e'),
+    masterChef(8453, '0xC6A2Db661D5a5690172d8eB0a7DEA2d3008665A3'),
+    masterChef(42161, '0x5e09ACf80C0296740eC5d6F643005a4ef8DaA694'),
+    {
+        id: 'aerodrome-slipstream',
+        name: 'Aerodrome Slipstream',
+        kind: 'gauge',
+        chainId: 8453,
+        positionManager: '0x827922686190790b37229fd06084350E74485b72',
+        voter: '0x16613524e02ad97eDfeF371bC883F2F5d6C480A5',
+    },
+    {
+        id: 'velodrome-slipstream',
+        name: 'Velodrome Slipstream',
+        kind: 'gauge',
+        chainId: 10,
+        positionManager: '0x416b433906b1B72FA758e166e239c43d68dC6F29',
+        voter: '0x41C914ee0c7E1A5edCD0295623e6dC557B5aBf3C',
+    },
+];
+export const masterChefInterface = new Interface([
+    'function CAKE() view returns (address)',
+    'function balanceOf(address user) view returns (uint256)',
+    'function tokenOfOwnerByIndex(address user, uint256 index) view returns (uint256)',
+    'function pendingCake(uint256 tokenId) view returns (uint256)',
+    'function harvest(uint256 tokenId, address to) returns (uint256 reward)',
+    'function collectTo((uint256 tokenId, address recipient, uint128 amount0Max, uint128 amount1Max) params, address to) returns (uint256 amount0, uint256 amount1)',
+    'function multicall(bytes[] data) payable returns (bytes[] results)',
+]);
+export const gaugeInterface = new Interface(['function getReward(uint256 tokenId)']);
+const voterAbi = ['function length() view returns (uint256)', 'function pools(uint256 index) view returns (address)', 'function gauges(address pool) view returns (address)'];
+const gaugeAbi = ['function stakedValues(address depositor) view returns (uint256[])', 'function earned(address account, uint256 tokenId) view returns (uint256)', 'function rewardToken() view returns (address)'];
+const CHUNK = 400;
+/** 每个 Voter 最多枚举多少个池子（Aerodrome 目前两千多个） */
+const MAX_POOLS = 6000;
+/** harvest 预执行：每条一个 eth_call，分批并发（受限节点上一次几百个会被限流） */
+const HARVEST_CHUNK = 25;
+const chunks = (list) => Array.from({ length: Math.ceil(list.length / CHUNK) }, (_, i) => list.slice(i * CHUNK, (i + 1) * CHUNK));
+async function staticCallChunked(provider, items) {
+    const parts = Array.from({ length: Math.ceil(items.length / HARVEST_CHUNK) }, (_, i) => items.slice(i * HARVEST_CHUNK, (i + 1) * HARVEST_CHUNK));
+    return (await mapPool(parts, 2, (part) => provider.staticCallAll(part))).flat();
+}
+/** 分批 tryAll：一次 multicall 不塞太多调用 */
+async function tryAllChunked(provider, calls, overrides) {
+    return (await Promise.all(chunks(calls).map((part) => provider.tryAll(part, overrides)))).flat();
+}
+// Voter 枚举出的 gauge 列表（几乎不变）：按 Provider（即按链）+ Voter 缓存 1 小时，只缓存最新状态的结果。
+// 共享的查询不带调用方的 signal / minBlock（否则第一个调用方取消会让其他等着的调用方一起失败），调用方各自按自己的 signal 取消等待
+const gaugeCache = new WeakMap();
+const GAUGE_TTL = 3_600_000;
+async function enumerateGauges(provider, voter, overrides) {
+    const v = provider.contract(voter, voterAbi);
+    const length = Math.min(Number(await provider.call(v.length(), overrides)), MAX_POOLS);
+    const pools = await tryAllChunked(provider, Array.from({ length }, (_, i) => v.pools(i)), overrides);
+    const list = pools.filter((p) => p !== null);
+    const found = await tryAllChunked(provider, list.map((p) => v.gauges(p)), overrides);
+    return [...new Set(found.filter((g) => g !== null && !/^0x0{40}$/.test(g)))];
+}
+function discoverGauges(provider, voter, overrides) {
+    if (overrides.blockTag !== undefined && overrides.blockTag !== 'latest') {
+        return enumerateGauges(provider, voter, overrides); // 历史区块：不缓存
+    }
+    const cache = gaugeCache.get(provider) ?? new Map();
+    gaugeCache.set(provider, cache);
+    const key = voter.toLowerCase();
+    const hit = cache.get(key);
+    let gauges;
+    if (hit && Date.now() - hit.at < GAUGE_TTL) {
+        gauges = hit.gauges;
+    }
+    else {
+        gauges = enumerateGauges(provider, voter, {});
+        const entry = { at: Date.now(), gauges };
+        cache.set(key, entry);
+        gauges.catch(() => {
+            if (cache.get(key) === entry)
+                cache.delete(key);
+        });
+    }
+    return withSignal(overrides.signal, () => gauges);
+}
+const amountOf = (token, value) => ({ token, amount: value.toString(), formatted: fmt(value, token) });
+/** MasterChefV3：用户质押的仓位。返回挖矿奖励（CAKE）和质押仓位未领取的手续费 */
+export async function readMasterChef(source, farm, wantFees, wantRewards) {
+    const { ctx, owner, overrides, maxPositions } = source;
+    const { provider } = ctx;
+    const mcAddress = evm(farm.masterChef);
+    const mc = provider.contract(mcAddress, masterChefInterface);
+    const count = Number(await provider.call(mc.balanceOf(owner), overrides));
+    if (!count) {
+        return [];
+    }
+    // 质押多的地址只看最近的 maxPositions 个（新质押的排在最后）
+    const indexes = Array.from({ length: Math.min(count, maxPositions) }, (_, i) => count - Math.min(count, maxPositions) + i);
+    const ids = (await tryAllChunked(provider, indexes.map((i) => mc.tokenOfOwnerByIndex(owner, i)), overrides)).filter((id) => id !== null);
+    const items = [];
+    if (wantRewards) {
+        // pendingCake 不含奖励池自上次更新以来新增的部分（比实际领到的少，差额随时间变大）：
+        // 以所有者的身份预执行 harvest 拿到合约真正会发的数量，预执行不了（钱包节点不支持 from 等）时退回 pendingCake
+        const [pending, exact, cake] = await Promise.all([
+            tryAllChunked(provider, ids.map((id) => mc.pendingCake(id)), overrides),
+            staticCallChunked(provider, ids.map((id) => ({ call: mc.harvest(id, owner), overrides: { ...overrides, from: owner } }))),
+            provider.call(mc.CAKE(), overrides),
+        ]);
+        const [token] = await tokenInfo(ctx, [evm(cake)]);
+        ids.forEach((id, i) => {
+            const run = exact[i];
+            // 预执行失败（限流 / 节点不支持 …）时退回 pendingCake，数量可能偏少，标 approximate
+            const value = run?.success ? BigInt(run.data) : (pending[i] ?? 0n);
+            if (value > 0n && token) {
+                items.push({
+                    id: `farm:${farm.id}:${id}`,
+                    kind: 'farm',
+                    protocol: farm.id,
+                    protocolName: farm.name,
+                    tokenId: id.toString(),
+                    pool: null,
+                    staked: true,
+                    target: mcAddress,
+                    amounts: [amountOf(token, value)],
+                    ...(run?.success ? {} : { approximate: true }),
+                });
+            }
+        });
+    }
+    const lp = source.lpProtocols.find((p) => p.version === 'v3' && p.chainId === ctx.chainId && p.positionManager && same(p.positionManager, farm.positionManager));
+    if (wantFees && lp && ids.length) {
+        const positions = (await lpPositionsByIds(provider, ids.map((tokenId) => ({ protocol: lp, tokenId })), { ...overrides }));
+        for (const p of positions) {
+            if (BigInt(p.fees0) + BigInt(p.fees1) > 0n) {
+                items.push({
+                    id: `fees:${lp.id}:${p.tokenId}`,
+                    kind: 'fees',
+                    protocol: lp.id,
+                    protocolName: lp.name,
+                    version: 'v3',
+                    tokenId: p.tokenId,
+                    pool: p.pool,
+                    staked: true,
+                    target: mcAddress,
+                    amounts: [
+                        { token: p.token0, amount: p.fees0, formatted: p.fees0Formatted },
+                        { token: p.token1, amount: p.fees1, formatted: p.fees1Formatted },
+                    ],
+                });
+            }
+        }
+    }
+    return items;
+}
+/** Slipstream gauge：用户质押的仓位和待领取的奖励 */
+export async function readGauges(source, farm, gauges) {
+    const { ctx, owner, overrides } = source;
+    const { provider } = ctx;
+    const list = gauges ? gauges.map(evm) : await discoverGauges(provider, evm(farm.voter), overrides);
+    const staked = await tryAllChunked(provider, list.map((g) => provider.contract(g, gaugeAbi).stakedValues(owner)), overrides);
+    const pairs = list.flatMap((gauge, i) => (staked[i] ?? []).slice(0, source.maxPositions).map((tokenId) => ({ gauge, tokenId })));
+    if (!pairs.length) {
+        return [];
+    }
+    const [earned, rewardTokens] = await Promise.all([
+        tryAllChunked(provider, pairs.map((x) => provider.contract(x.gauge, gaugeAbi).earned(owner, x.tokenId)), overrides),
+        tryAllChunked(provider, [...new Set(pairs.map((x) => x.gauge))].map((g) => provider.contract(g, gaugeAbi).rewardToken()), overrides),
+    ]);
+    const gaugeList = [...new Set(pairs.map((x) => x.gauge))];
+    const rewardOf = new Map(gaugeList.map((g, i) => [g, rewardTokens[i] ?? null]));
+    const tokens = await tokenInfo(ctx, [...new Set([...rewardOf.values()].filter((t) => t !== null).map(evm))]);
+    const infoOf = new Map(tokens.map((t) => [evm(t.address), t]));
+    return pairs.flatMap(({ gauge, tokenId }, i) => {
+        const value = earned[i] ?? 0n;
+        const reward = rewardOf.get(gauge);
+        const token = reward ? infoOf.get(evm(reward)) : undefined;
+        return value > 0n && token
+            ? [
+                {
+                    id: `gauge:${farm.id}:${tokenId}`,
+                    kind: 'gauge',
+                    protocol: farm.id,
+                    protocolName: farm.name,
+                    tokenId: tokenId.toString(),
+                    pool: null,
+                    staked: true,
+                    target: gauge,
+                    amounts: [amountOf(token, value)],
+                },
+            ]
+            : [];
+    });
+}
+//# sourceMappingURL=farms.js.map

package/dist/rewards/farms.js.map

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

package/dist/rewards/index.d.ts

@@ -0,0 +1,42 @@
+import type { Provider } from '../provider.js';
+import type { ClaimAllOptions, ClaimAllSendOptions, ClaimPlan, ClaimResult, Claimable, ClaimableOptions } from './types.js';
+import type { SignerInput } from '../write/signer.js';
+export { FARM_PROTOCOLS } from './farms.js';
+/**
+ * 查一个地址能领取的全部内容（只读）：V3 / V4 仓位未领取的手续费、质押在 MasterChef / gauge 里的仓位的挖矿奖励，
+ * 数量按精度换算，可选美元价值。每个来源单独读取，某个来源出错只记进 `errors`
+ *
+ * ```ts
+ * const c = await claimable(multi, user, { prices: true })
+ * c.items   // [{ kind: 'fees', protocol: 'uniswap-v3', tokenId: '123', amounts: [{ token: USDC, formatted: '12.3', usd: 12.3 }, …], usd: 20.1 }, { kind: 'farm', amounts: [CAKE …] }, …]
+ * c.totals  // 按代币汇总
+ * ```
+ */
+export declare function claimable(provider: Provider, owner: string, options?: ClaimableOptions): Promise<Claimable>;
+/**
+ * 领取计划（不签名、不发送）：把要领取的项合并成尽量少的交易——同一个仓位合约的 V3 仓位用它的 `multicall`、
+ * V4 仓位合并成一次 `modifyLiquidities`、MasterChef 的挖矿奖励和质押仓位手续费用它的 `multicall`、每个 gauge 的仓位各一笔。
+ * 交易之间互不依赖，可以交给 `batchCall` 的 '7702' / '4337' / '5792' 模式合成一笔原子交易，或者逐笔发送。
+ *
+ * 默认先模拟（/simulate）：某一笔失败时逐项再试，会失败的项放进 `skipped`，不拖累其他仓位。
+ *
+ * ```ts
+ * const plan = await buildClaimAll(multi, user, { prices: true, minUsd: 1 })
+ * plan.transactions   // [{ kind: 'fees', to: npm, data, itemIds: [...] }, { kind: 'farm', … }]
+ * plan.skipped        // [{ item, reason: 'below minUsd' }]
+ * ```
+ */
+export declare function buildClaimAll(provider: Provider, owner: string, options?: ClaimAllOptions): Promise<ClaimPlan>;
+/**
+ * 领取全部手续费和挖矿奖励：构建计划（同 buildClaimAll）后用 from 签名发送，每笔独立，某一笔失败不影响后面的。
+ * from 与 /write 的 batchCall 相同；`mode: '7702' | '4337' | '5792'` 时合成一笔原子交易（一个仓位失败整笔回滚，所以先模拟、剔除会失败的项）。
+ *
+ * ```ts
+ * const { status, plan, claimed } = await claimAll(multi, privateKey, { minUsd: 1 })
+ * await claimAll(multi, privateKey, { mode: '7702' })            // 一笔交易领完
+ * await claimAll(multi, privateKey, { items: picked })           // 只领 getClaimable / claimable 结果里挑出来的
+ * ```
+ */
+export declare function claimAll(provider: Provider, from: SignerInput, options?: ClaimAllSendOptions): Promise<ClaimResult>;
+export type { ClaimAllOptions, ClaimAllSendOptions, ClaimAmount, ClaimItem, ClaimKind, ClaimPlan, ClaimResult, ClaimSkipped, ClaimTx, ClaimTxResult, Claimable, ClaimableOptions, FarmProtocol } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/rewards/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rewards/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAM9C,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EAGnB,SAAS,EACT,WAAW,EAIX,SAAS,EACT,gBAAgB,EAEjB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAwF3C;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CAE/G;AAsJD;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,SAAS,CAAC,CAoCxH;AA2DD;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,CAgC7H;AAED,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}