@w3lib/evm-batch-call 0.7.0 → 0.8.0

package/dist/rewards/index.js

@@ -0,0 +1,382 @@
+import { MAX_UINT128, createCtx, evm, fmt, out } from '../liquidity/common.js';
+import { npmInterface } from '../liquidity/v3.js';
+import { Actions, Planner, pmInterface } from '../liquidity/v4.js';
+import { LP_PROTOCOLS, lpPositions } from '../lp.js';
+import { tokenPrices } from '../price.js';
+import { withSignal } from '../util.js';
+import { batchCall, tronModule } from '../write/batch.js';
+import { resolveSigner } from '../write/signer.js';
+import { mapPool } from '../write/send.js';
+import { FARM_PROTOCOLS, gaugeInterface, masterChefInterface, readGauges, readMasterChef } from './farms.js';
+export { FARM_PROTOCOLS } from './farms.js';
+const lower = (s) => s.toLowerCase();
+/** 同一个代币的数量合并 */
+function sumAmounts(items) {
+    const sum = new Map();
+    for (const { amounts } of items) {
+        for (const a of amounts) {
+            const key = lower(a.token.address);
+            const entry = sum.get(key) ?? { amount: a, raw: 0n, usd: undefined };
+            entry.raw += BigInt(a.amount);
+            if (a.usd !== undefined) {
+                entry.usd = a.usd === null ? (entry.usd ?? null) : (entry.usd ?? 0) + a.usd;
+            }
+            sum.set(key, entry);
+        }
+    }
+    return [...sum.values()]
+        .filter((e) => e.raw > 0n)
+        .map(({ amount, raw, usd }) => ({ token: amount.token, amount: raw.toString(), formatted: fmt(raw, amount.token), ...(usd === undefined ? {} : { usd }) }));
+}
+const usdOf = (amounts) => {
+    if (amounts.every((a) => a.usd === undefined)) {
+        return undefined;
+    }
+    const known = amounts.filter((a) => a.usd != null && BigInt(a.amount) > 0n);
+    return known.length ? known.reduce((s, a) => s + a.usd, 0) : null;
+};
+/** 给每一项的数量加美元价值（价格源出错时全部为 null） */
+async function applyPrices(provider, items, options) {
+    const tokens = [...new Set(items.flatMap((i) => i.amounts).filter((a) => BigInt(a.amount) > 0n).map((a) => a.token.address))];
+    if (!tokens.length) {
+        return;
+    }
+    let prices = tokens.map(() => null);
+    try {
+        const found = await tokenPrices(provider, tokens, {
+            ...(options.prices === true ? {} : { sources: options.prices }),
+            ...(options.fetch ? { fetch: options.fetch } : {}),
+        });
+        prices = found.map((p) => p.price);
+    }
+    catch (err) {
+        try {
+            options.onPriceError?.(err);
+        }
+        catch {
+            // 回调出错不影响查询结果
+        }
+    }
+    const priceOf = new Map(tokens.map((t, i) => [lower(t), prices[i]]));
+    for (const item of items) {
+        for (const a of item.amounts) {
+            const price = priceOf.get(lower(a.token.address)) ?? null;
+            a.usd = a.formatted !== null && price !== null ? Number(a.formatted) * price : BigInt(a.amount) === 0n ? 0 : null;
+        }
+        item.usd = usdOf(item.amounts) ?? null;
+    }
+}
+/** 选出要查的 LP 协议 / 挖矿合约 */
+function selectProtocols(chainId, options) {
+    const farmTable = [...(options.farms ?? []), ...FARM_PROTOCOLS].filter((f) => f.chainId === chainId);
+    const custom = (options.protocols ?? []).filter((p) => typeof p !== 'string' && p.chainId === chainId);
+    const lpAll = [...custom, ...LP_PROTOCOLS.filter((p) => p.chainId === chainId)];
+    if (!options.protocols) {
+        return { lp: undefined, farms: farmTable, lpAll };
+    }
+    const lp = [];
+    const farms = [];
+    for (const p of options.protocols) {
+        if (typeof p !== 'string') {
+            if (p.chainId === chainId && p.version !== 'v2')
+                lp.push(p);
+            continue;
+        }
+        const inLp = lpAll.filter((x) => x.id === p);
+        const inFarm = farmTable.filter((f) => f.id === p);
+        if (!inLp.length && !inFarm.length) {
+            throw new Error(`Unknown protocol ${p} on chain ${chainId}; pass an LpProtocol / FarmProtocol object for protocols that are not built in`);
+        }
+        // V2 的手续费计入 LP 份额，没有单独领取的
+        if (inLp.some((x) => x.version !== 'v2'))
+            lp.push(p);
+        farms.push(...inFarm);
+    }
+    return { lp, farms, lpAll };
+}
+/**
+ * 查一个地址能领取的全部内容（只读）：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 function claimable(provider, owner, options = {}) {
+    return withSignal(options.signal, () => queryClaimable(provider, owner, options));
+}
+async function queryClaimable(provider, owner, options) {
+    const ctx = await createCtx(provider, owner, {});
+    const { chainId } = ctx;
+    const wantFees = options.fees ?? true;
+    const wantRewards = options.rewards ?? true;
+    const maxPositions = Math.max(1, Math.floor(options.maxPositions ?? 500));
+    const overrides = {
+        ...(options.blockTag !== undefined ? { blockTag: options.blockTag } : {}),
+        ...(options.minBlock !== undefined ? { minBlock: options.minBlock } : {}),
+        ...(options.signal ? { signal: options.signal } : {}),
+    };
+    const { lp, farms, lpAll } = selectProtocols(chainId, options);
+    const errors = [];
+    const items = [];
+    const task = async (source, run) => {
+        try {
+            items.push(...(await run()));
+        }
+        catch (err) {
+            errors.push({ source, error: err instanceof Error ? err.message : String(err) });
+        }
+    };
+    const source = { ctx, owner: ctx.owner, overrides, maxPositions, lpProtocols: lpAll };
+    await Promise.all([
+        wantFees && (lp === undefined || lp.length)
+            ? task('positions', async () => {
+                const positions = await lpPositions(provider, owner, { ...overrides, ...(lp ? { protocols: lp } : {}), versions: ['v3', 'v4'], v4: options.v4, maxPositions });
+                return positions
+                    .filter((p) => BigInt(p.fees0) + BigInt(p.fees1) > 0n)
+                    .map((p) => ({
+                    id: `fees:${p.protocol}:${p.tokenId}`,
+                    kind: 'fees',
+                    protocol: p.protocol,
+                    protocolName: p.protocolName,
+                    version: p.version,
+                    tokenId: p.tokenId,
+                    pool: p.pool,
+                    staked: false,
+                    target: p.positionManager,
+                    amounts: [
+                        { token: p.token0, amount: p.fees0, formatted: p.fees0Formatted },
+                        { token: p.token1, amount: p.fees1, formatted: p.fees1Formatted },
+                    ],
+                }));
+            })
+            : null,
+        ...farms.map((farm) => farm.kind === 'masterchef-v3'
+            ? wantFees || wantRewards
+                ? task(farm.id, () => readMasterChef(source, farm, wantFees, wantRewards))
+                : null
+            : wantRewards
+                ? task(farm.id, () => readGauges(source, farm, options.gauges))
+                : null),
+    ]);
+    if (options.prices) {
+        await applyPrices(provider, items, options);
+    }
+    if (options.prices) {
+        items.sort((a, b) => (b.usd ?? -1) - (a.usd ?? -1));
+    }
+    const totals = sumAmounts(items);
+    const usd = usdOf(totals);
+    return { chainId, owner: out(ctx, ctx.owner), items, totals, ...(usd === undefined ? {} : { usd }), errors };
+}
+function groupOf(items) {
+    const groups = new Map();
+    for (const item of items) {
+        const [type, kind, key] = item.kind === 'gauge'
+            ? ['gauge', 'gauge', item.id]
+            : item.staked
+                ? ['masterchef', 'farm', item.target]
+                : item.version === 'v4'
+                    ? ['v4', 'fees', item.target]
+                    : ['v3', 'fees', item.target];
+        const k = `${type}:${key}`;
+        const group = groups.get(k) ?? { kind, type, target: item.target, items: [] };
+        group.items.push(item);
+        groups.set(k, group);
+    }
+    return [...groups.values()];
+}
+const wrap = (iface, calls) => (calls.length === 1 ? calls[0] : iface.encodeFunctionData('multicall', [calls]));
+/** 一组（同一个合约）里的若干项 → 一笔交易的 calldata */
+function encodeGroup(ctx, type, items) {
+    const recipient = ctx.recipient;
+    if (type === 'v3') {
+        return wrap(npmInterface, items.map((i) => npmInterface.encodeFunctionData('collect', [{ tokenId: i.tokenId, recipient, amount0Max: MAX_UINT128, amount1Max: MAX_UINT128 }])));
+    }
+    if (type === 'masterchef') {
+        return wrap(masterChefInterface, items.map((i) => i.kind === 'farm'
+            ? masterChefInterface.encodeFunctionData('harvest', [i.tokenId, recipient])
+            : masterChefInterface.encodeFunctionData('collectTo', [{ tokenId: i.tokenId, recipient, amount0Max: MAX_UINT128, amount1Max: MAX_UINT128 }, recipient])));
+    }
+    if (type === 'gauge') {
+        return gaugeInterface.encodeFunctionData('getReward', [items[0].tokenId]);
+    }
+    // V4：每个仓位 DECREASE_LIQUIDITY(0) 结算手续费，再把涉及的每个币整个取出（TAKE 的数量 0 = 全部）
+    const planner = new Planner();
+    const hookData = ctx.options.hookData ?? '0x';
+    for (const i of items) {
+        planner.add(Actions.DECREASE_LIQUIDITY, ['uint256', 'uint256', 'uint128', 'uint128', 'bytes'], [i.tokenId, 0n, 0n, 0n, hookData]);
+    }
+    const currencies = new Set(items.flatMap((i) => i.amounts.map((a) => evm(a.token.address))));
+    for (const currency of currencies) {
+        planner.add(Actions.TAKE, ['address', 'address', 'uint256'], [currency, recipient, 0n]);
+    }
+    return pmInterface.encodeFunctionData('modifyLiquidities', [planner.encode(), ctx.deadline]);
+}
+function buildTxs(ctx, items, batchSize) {
+    return groupOf(items).flatMap((group) => {
+        // gauge 的 getReward 一次只能领一个仓位
+        const size = group.type === 'gauge' ? 1 : batchSize;
+        const txs = [];
+        for (let i = 0; i < group.items.length; i += size) {
+            const part = group.items.slice(i, i + size);
+            txs.push({ kind: group.kind, to: out(ctx, group.target), data: encodeGroup(ctx, group.type, part), value: '0', itemIds: part.map((x) => x.id) });
+        }
+        return txs;
+    });
+}
+/**
+ * 领取计划（不签名、不发送）：把要领取的项合并成尽量少的交易——同一个仓位合约的 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 async function buildClaimAll(provider, owner, options = {}) {
+    const ctx = await createCtx(provider, owner, { recipient: options.recipient, hookData: options.hookData });
+    const batchSize = Math.floor(options.batchSize ?? 20);
+    if (!(batchSize >= 1)) {
+        throw new RangeError(`batchSize must be at least 1: ${options.batchSize}`);
+    }
+    if (options.minUsd !== undefined && !(options.minUsd >= 0)) {
+        throw new RangeError(`minUsd must not be negative: ${options.minUsd}`);
+    }
+    const found = options.items ? undefined : await claimable(provider, owner, options);
+    const candidates = options.items ? [...options.items] : found.items;
+    const skipped = [];
+    const seen = new Set();
+    let included = candidates.filter((item) => {
+        const skip = (reason) => {
+            skipped.push({ item, reason });
+            return false;
+        };
+        if (seen.has(item.id))
+            return false;
+        seen.add(item.id);
+        if (item.amounts.every((a) => BigInt(a.amount) === 0n))
+            return skip('nothing to claim');
+        // 有一个要领的币没有价格就当价值未知（usd 只是已知部分的合计），不跳过
+        const unknownValue = item.amounts.some((a) => BigInt(a.amount) > 0n && a.usd === null);
+        if (options.minUsd !== undefined && item.usd != null && !unknownValue && item.usd < options.minUsd)
+            return skip(`below minUsd (${item.usd})`);
+        if (item.kind === 'gauge' && ctx.recipient !== ctx.owner)
+            return skip('gauge rewards are always paid to the owner, recipient is not supported');
+        return true;
+    });
+    let transactions = buildTxs(ctx, included, batchSize);
+    if (options.simulate !== false && transactions.length) {
+        const checked = await preflight(provider, ctx, included, transactions, skipped, options.signal);
+        included = checked.items;
+        transactions = checked.transactions;
+    }
+    const totals = sumAmounts(included);
+    const usd = usdOf(totals);
+    return { chainId: ctx.chainId, owner: out(ctx, ctx.owner), recipient: out(ctx, ctx.recipient), items: included, skipped, totals, ...(usd === undefined ? {} : { usd }), transactions };
+}
+/**
+ * 模拟每一笔；失败的逐项再试，去掉会失败的项后重新构建。逐项都通过、只有合并后的那一笔失败时（gas / multicall 的相互影响）
+ * 对半拆开再模拟，直到通过或拆成单项。返回的交易模拟都没有失败；模拟本身出错（节点不支持等）时不拦，照常发送；取消（signal）时抛出
+ */
+async function preflight(provider, ctx, items, transactions, skipped, signal) {
+    const { simulate } = await import('../simulate.js');
+    const run = async (tx) => {
+        signal?.throwIfAborted();
+        try {
+            tx.simulation = await simulate(provider, { from: ctx.owner, to: tx.to, data: tx.data, value: 0n }, { from: ctx.owner, fee: false });
+            return tx.simulation.success ? null : (tx.simulation.error ?? 'execution reverted');
+        }
+        catch (err) {
+            if (signal?.aborted || (err instanceof Error && err.name === 'AbortError'))
+                throw err;
+            return null;
+        }
+    };
+    const byId = new Map(items.map((i) => [i.id, i]));
+    const failed = new Map();
+    const settle = async (tx) => {
+        const error = await run(tx);
+        if (error === null)
+            return [tx];
+        const list = tx.itemIds.map((id) => byId.get(id));
+        if (list.length === 1) {
+            failed.set(tx.itemIds[0], error);
+            return [];
+        }
+        // 逐项再试，找出是哪几个仓位失败
+        const singles = await mapPool(list, 4, async (item) => {
+            const single = buildTxs(ctx, [item], 1)[0];
+            return { item, single, error: await run(single) };
+        });
+        const good = singles.filter((s) => s.error === null);
+        for (const s of singles) {
+            if (s.error !== null)
+                failed.set(s.item.id, s.error);
+        }
+        if (good.length === singles.length) {
+            // 单项都能过、合并的失败：对半拆开
+            const half = Math.ceil(list.length / 2);
+            const parts = [list.slice(0, half), list.slice(half)].flatMap((part) => buildTxs(ctx, part, part.length));
+            return (await Promise.all(parts.map(settle))).flat();
+        }
+        if (good.length === 1)
+            return [good[0].single];
+        return (await Promise.all(buildTxs(ctx, good.map((s) => s.item), list.length).map(settle))).flat();
+    };
+    const settled = [];
+    await mapPool(transactions, 4, async (tx, i) => {
+        settled[i] = await settle(tx);
+    });
+    if (!failed.size) {
+        return { items, transactions: settled.flat() };
+    }
+    for (const item of items) {
+        if (failed.has(item.id))
+            skipped.push({ item, reason: `simulation failed: ${failed.get(item.id)}` });
+    }
+    return { items: items.filter((i) => !failed.has(i.id)), transactions: settled.flat() };
+}
+/**
+ * 领取全部手续费和挖矿奖励：构建计划（同 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 async function claimAll(provider, from, options = {}) {
+    const tron = await tronModule(provider);
+    const owner = tron ? await tron.tronSignerAddress(from) : (await resolveSigner(from)).address;
+    const plan = await buildClaimAll(provider, owner, options);
+    if (!plan.transactions.length) {
+        return { plan, results: [], status: 'skipped', claimed: [], failed: [] };
+    }
+    const { items: _items, protocols: _protocols, fees: _fees, rewards: _rewards, v4: _v4, farms: _farms, gauges: _gauges, maxPositions: _max, prices: _prices, onPriceError: _onPriceError, fetch: _fetch, recipient: _recipient, hookData: _hookData, minUsd: _minUsd, batchSize: _batchSize, simulate: _simulate, blockTag: _blockTag, from: _from, minBlock: _minBlock, ...send } = options;
+    const written = await batchCall(provider, plan.transactions.map((tx) => ({ from, to: tx.to, data: tx.data, value: 0n })), { ...send, continueOnError: options.continueOnError ?? true });
+    const results = written.map((r, i) => ({ ...r, kind: plan.transactions[i].kind, itemIds: plan.transactions[i].itemIds }));
+    if (options.dryRun) {
+        // 只预估：没有领取任何东西。预估通过的项放进 simulated，预估失败的才算 failed
+        const ok = new Set(results.filter((r) => r.status === 'simulated').flatMap((r) => r.itemIds));
+        const badRun = results.find((r) => r.status !== 'simulated');
+        return { plan, results, status: badRun ? badRun.status : 'simulated', claimed: [], failed: plan.items.filter((i) => !ok.has(i.id)), simulated: plan.items.filter((i) => ok.has(i.id)) };
+    }
+    const confirmed = new Set(results.filter((r) => r.status === 'confirmed').flatMap((r) => r.itemIds));
+    const bad = results.find((r) => r.status !== 'confirmed');
+    return {
+        plan,
+        results,
+        status: bad ? bad.status : 'confirmed',
+        claimed: plan.items.filter((i) => confirmed.has(i.id)),
+        failed: plan.items.filter((i) => !confirmed.has(i.id)),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/rewards/index.js.map

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

package/dist/rewards/types.d.ts

@@ -0,0 +1,170 @@
+import type { CallOverrides } from '../aggregate.js';
+import type { LpProtocol, LpToken } from '../lp.js';
+import type { LpV4Options } from '../lpV4.js';
+import type { TokenPricesOptions } from '../price.js';
+import type { SimulationResult } from '../simulate.js';
+import type { BatchCallOptions } from '../write/batch.js';
+import type { WriteResult, WriteStatus } from '../write/send.js';
+/** 内置表之外的挖矿合约（自己的 FarmProtocol） */
+export interface FarmProtocol {
+    /** 协议 id：与 LP 协议同名时（如 'pancakeswap-v3'）选这个协议会同时查它的挖矿奖励 */
+    id: string;
+    name: string;
+    /**
+     * - masterchef-v3：PancakeSwap V3 的 MasterChefV3，仓位 NFT 存在合约里，按 `balanceOf` / `tokenOfOwnerByIndex` 列出用户质押的仓位，
+     *   `pendingCake` 是待领取的 CAKE，质押中的仓位手续费也由它代为领取
+     * - gauge：Aerodrome / Velodrome Slipstream 的 CLGauge（经 Voter 找到每个池子的 gauge），`stakedValues` / `earned` / `getReward`
+     */
+    kind: 'masterchef-v3' | 'gauge';
+    chainId: number;
+    /** 仓位 NFT 合约（质押的仓位属于它） */
+    positionManager: string;
+    /** masterchef-v3：MasterChefV3 合约 */
+    masterChef?: string;
+    /** gauge：Voter 合约（pools / gauges） */
+    voter?: string;
+}
+/**
+ * 领取的内容：
+ * - fees：V3 / V4 仓位未领取的手续费（token0 / token1），质押在 MasterChef 里的仓位也有
+ * - farm：MasterChef 的挖矿奖励（CAKE）
+ * - gauge：Slipstream gauge 的奖励（AERO / VELO）
+ */
+export type ClaimKind = 'fees' | 'farm' | 'gauge';
+export interface ClaimAmount {
+    token: LpToken;
+    /** 最小单位 */
+    amount: string;
+    /** 按精度换算；读不到精度时为 null */
+    formatted: string | null;
+    /** 开启 prices 时：美元价值（没有价格或读不到精度时为 null） */
+    usd?: number | null;
+}
+/** 一项可领取的内容：一个仓位的手续费，或一个质押仓位的挖矿奖励 */
+export interface ClaimItem {
+    /** `<kind>:<协议 id>:<tokenId>`，在一次查询里唯一 */
+    id: string;
+    kind: ClaimKind;
+    protocol: string;
+    protocolName: string;
+    /** fees：仓位的版本 */
+    version?: 'v3' | 'v4';
+    tokenId: string;
+    /** 池子地址（V4 为 poolId）；gauge 为 null */
+    pool: string | null;
+    /** 仓位 NFT 质押在挖矿合约里 */
+    staked: boolean;
+    /** 领取时调用的合约：仓位合约 / MasterChef / gauge */
+    target: string;
+    /** fees 固定是 [token0, token1]（可能有一边为 0）；farm / gauge 是奖励代币 */
+    amounts: ClaimAmount[];
+    /** 开启 prices 时：这一项的美元价值（已知部分的合计；全部未知时为 null） */
+    usd?: number | null;
+    /** 数量是估计值（MasterChef 的 harvest 预执行失败，退回 pendingCake，实际领到的可能更多） */
+    approximate?: boolean;
+}
+export interface Claimable {
+    chainId: number;
+    owner: string;
+    /** 有东西可领的项，开启 prices 时按美元价值从大到小排 */
+    items: ClaimItem[];
+    /** 按代币汇总 */
+    totals: ClaimAmount[];
+    usd?: number | null;
+    /** 某个来源读取失败（节点出错等）时的说明，其他来源的结果照常返回 */
+    errors: Array<{
+        source: string;
+        error: string;
+    }>;
+}
+export interface ClaimableOptions extends CallOverrides {
+    /**
+     * 查哪些协议：LP 协议 id（'uniswap-v3'、'pancakeswap-v3'、'uniswap-v4' …）或自己的 LpProtocol、挖矿协议 id（'aerodrome-slipstream' …）。
+     * 'pancakeswap-v3' 同时包含它的 MasterChef 挖矿。默认这条链上内置的全部
+     */
+    protocols?: ReadonlyArray<string | LpProtocol>;
+    /** 查手续费（V3 / V4 仓位，含质押在 MasterChef 里的），默认 true */
+    fees?: boolean;
+    /** 查挖矿奖励（MasterChef / gauge），默认 true */
+    rewards?: boolean;
+    /** V4：怎么找仓位（已知 tokenIds 或扫描 Transfer 事件，同 getLpPositions），两个都没有时不查 V4 */
+    v4?: LpV4Options;
+    /** 内置表里没有的挖矿合约 */
+    farms?: readonly FarmProtocol[];
+    /** gauge：直接指定要查的 gauge 地址，不再通过 Voter 枚举全部池子（Aerodrome 有两千多个，枚举要几千次读取） */
+    gauges?: readonly string[];
+    /** 每个协议最多核对多少个仓位，默认 500 */
+    maxPositions?: number;
+    /** 美元价值（可选）：true 用 DefiLlama + 链上池子，也可以传 tokenPrices 的 sources。默认不查 */
+    prices?: boolean | TokenPricesOptions['sources'];
+    /** 价格源出错时调用：照样返回结果，usd 为 null */
+    onPriceError?: (error: unknown) => void;
+    /** 自定义 fetch（价格用） */
+    fetch?: typeof fetch;
+}
+export interface ClaimAllOptions extends ClaimableOptions {
+    /** 要领取的项（getClaimable 的结果里挑），默认领取查到的全部 */
+    items?: readonly ClaimItem[];
+    /** 领取的代币收到哪个地址，默认 owner。gauge 的奖励只能发给 owner，传了别的地址时这些项会被跳过 */
+    recipient?: string;
+    /** V4：传给 hooks 的 hookData，默认 '0x' */
+    hookData?: string;
+    /** 美元价值低于这个值的项跳过（不够付 gas 的零头）；价值未知的不跳过。需要 prices */
+    minUsd?: number;
+    /** 一笔交易最多合并多少个仓位，默认 20 */
+    batchSize?: number;
+    /**
+     * 构建后先模拟（用 /simulate，按需加载）：某一笔失败时逐项再试，把会失败的项放进 skipped，其余照常领取。默认 true；
+     * 设为 false 时不模拟（某一项失败会让它所在的那一笔整体失败）
+     */
+    simulate?: boolean;
+}
+export interface ClaimTx {
+    kind: ClaimKind;
+    to: string;
+    data: string;
+    value: '0';
+    /** 这一笔里包含的项（ClaimItem.id） */
+    itemIds: string[];
+    /** 模拟的结果（simulate 不为 false 时）：资产变化就是实际会收到的数量 */
+    simulation?: SimulationResult;
+}
+export interface ClaimSkipped {
+    item: ClaimItem;
+    reason: string;
+}
+/** 领取计划：要按顺序发送的交易（每笔独立，互不依赖）。只读取、不签名 */
+export interface ClaimPlan {
+    chainId: number;
+    owner: string;
+    recipient: string;
+    /** 会领取的项 */
+    items: ClaimItem[];
+    /** 跳过的项和原因（没东西可领、低于 minUsd、模拟失败、地址不允许 …） */
+    skipped: ClaimSkipped[];
+    /** 按代币汇总的预计数量（用的是查询时的数量，挖矿奖励随时间还会增加一点） */
+    totals: ClaimAmount[];
+    usd?: number | null;
+    transactions: ClaimTx[];
+}
+export interface ClaimAllSendOptions extends ClaimAllOptions, Omit<BatchCallOptions, 'continueOnError'> {
+    /** 某一笔发送前失败后，后面的是否继续，默认 true（每一笔都是独立的领取） */
+    continueOnError?: boolean;
+}
+export interface ClaimTxResult extends WriteResult {
+    kind: ClaimKind;
+    itemIds: string[];
+}
+export interface ClaimResult {
+    plan: ClaimPlan;
+    /** 与 plan.transactions 一一对应 */
+    results: ClaimTxResult[];
+    /** 全部确认为 'confirmed'；dryRun 全部预估通过为 'simulated'；没有东西可领为 'skipped'；否则是第一笔没成功的状态 */
+    status: WriteStatus;
+    /** 已确认的交易里的项 / 其他交易里的项（dryRun 时 claimed 为空，failed 只含预估失败的项） */
+    claimed: ClaimItem[];
+    failed: ClaimItem[];
+    /** dryRun：预估通过的项（没有真正发送） */
+    simulated?: ClaimItem[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/rewards/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/rewards/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/rewards/types.ts"],"names":[],"mappings":""}