@w3lib/evm-batch-call 0.7.0 → 0.8.0

package/dist/dividends.js

@@ -0,0 +1,253 @@
+/**
+ * Flap（flap.sh，BNB Chain 发币平台）的分红：持有带分红的 Flap 税收代币（FlapTaxToken）的地址按持仓比例分到税收，
+ * 分红放在每个代币自己的 Dividend 合约里，持有人（或任何人替持有人）调用 withdrawDividendsFor 领取。
+ *
+ * 核实过的合约（BSC 主网，2026-10 在主网分叉上实测）：
+ * - 代币：`dividendContract()` 返回它的 Dividend 合约（Tax Token V3 总是部署；V2 只在 dividendBps > 0 时部署）
+ * - Dividend 合约（EIP-1167 克隆，实现 0xd67447C2…5905，Sourcify / BscScan 上未验证源码，函数靠官方文档 + 链上调用核对）：
+ *   `dividendToken()`、`weth()`、`minimumShareBalance()`、`withdrawableDividends(address)`、`withdrawnDividends(address)`、
+ *   `withdrawDividendsFor(address)`（任何人可调，款项直接到持有人）
+ * - 官方 TaxTokenHelper（0x53841c73…8346）的 `getDividendInfo(token, user) → (claimed, pending)` 与上面两个函数结果一致（测试里交叉核对）
+ *
+ * 只有一种合约形态，所以只有一个适配器（flap）；识别不了的代币（没有 dividendContract() 或 Dividend 合约缺函数）放进 unsupported，
+ * 不猜函数。
+ */
+import { Interface, getAddress } from 'ethers';
+import { NATIVE_TOKEN, formatUnits } from './erc20.js';
+import { runLogScan } from './scan.js';
+import { isTronChain } from './tron.js';
+/** 支持的链：目前只有 BSC（Flap 在 Base、X Layer 等链上也有部署，但没有核实过，不开放） */
+export const FLAP_DIVIDEND_CHAINS = {
+    56: {
+        portal: '0xe2cE6ab80874Fa9Fa2aAE65D277Dd6B8e65C9De0',
+        taxTokenHelper: '0x53841c73217735F37BC1775538b03b23feFD8346',
+        swapRegistry: '0x644A8f560138418bAD4EdEFC7c17878a3c2fBEB6',
+    },
+};
+/** Flap 代币地址的靓号后缀（Portal 创建时用）：税收代币是 7777，普通代币是 8888（实测也有 8888 的代币带分红合约）；发现持仓时只收这类地址 */
+export const FLAP_TOKEN_SUFFIXES = ['7777', '8888'];
+const TOKEN_ABI = [
+    'function dividendContract() view returns (address)',
+    'function balanceOf(address) view returns (uint256)',
+    'function symbol() view returns (string)',
+    'function decimals() view returns (uint8)',
+];
+const DIVIDEND_ABI = [
+    'function dividendToken() view returns (address)',
+    'function weth() view returns (address)',
+    'function minimumShareBalance() view returns (uint256)',
+    'function withdrawableDividends(address) view returns (uint256)',
+    'function withdrawnDividends(address) view returns (uint256)',
+];
+const ERC20_META_ABI = ['function symbol() view returns (string)', 'function decimals() view returns (uint8)'];
+const claimInterface = new Interface(['function withdrawDividendsFor(address user)']);
+const ZERO = '0x0000000000000000000000000000000000000000';
+const TRANSFER_TOPIC = '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef';
+/** 一次最多检查的代币数（防止传入或发现的列表无限大） */
+const MAX_TOKENS = 200;
+function assertChain(chainId) {
+    if (isTronChain(chainId) || !FLAP_DIVIDEND_CHAINS[chainId]) {
+        throw new Error(`Flap dividends are only supported on BNB Chain (56), got chain ${chainId}`);
+    }
+}
+/** 发现持有人收到过的 Flap 税收代币（只发现，不核对有没有分红：把 tokens 交给 dividends） */
+export async function scanDividendTokens(provider, owner, options = {}) {
+    assertChain(await provider.getChainId());
+    const ownerTopic = `0x${getAddress(owner).slice(2).toLowerCase().padStart(64, '0')}`;
+    const lookback = Math.max(0, Math.floor(options.lookbackBlocks ?? 5000));
+    const suffixes = (options.suffixes ?? FLAP_TOKEN_SUFFIXES).map((x) => x.toLowerCase());
+    const progress = await runLogScan({
+        provider,
+        saved: options.progress,
+        initialCursor: (target) => (options.fromBlock !== undefined ? options.fromBlock - 1 : target - lookback),
+        filter: { topics: [TRANSFER_TOPIC, null, ownerTopic] },
+        // 只收 ERC20 的 Transfer（3 个 topic）里靓号后缀的合约
+        collect: (log) => (log.topics.length === 3 && suffixes.some((s) => log.address.toLowerCase().endsWith(s)) ? log.address.toLowerCase() : null),
+        maxRange: Math.max(1, Math.floor(options.blockRange ?? 1000)),
+        maxRequests: Math.max(1, Math.floor(options.maxRequests ?? 10)),
+        timeBudget: options.timeBudget ?? 10_000,
+        confirmations: 0,
+        ...(options.signal ? { signal: options.signal } : {}),
+    });
+    return { tokens: (progress?.items ?? []).map((a) => getAddress(a)), cursor: progress?.cursor ?? -1, progress };
+}
+/**
+ * 查持有人在 Flap 代币上的分红：余额、可领取数量、已领取数量、分红资产和美元价值。
+ * 代币来自 tokens 和 discover（扫描收到过的 Transfer），每个代币都在链上核对（dividendContract() + Dividend 合约的函数），
+ * 核对不过的放进 unsupported。不发送交易
+ */
+export async function dividends(provider, owner, options = {}) {
+    const chainId = await provider.getChainId();
+    assertChain(chainId);
+    const holder = getAddress(owner);
+    let scan;
+    const found = new Map();
+    const explicit = new Set();
+    for (const t of options.tokens ?? []) {
+        found.set(getAddress(t).toLowerCase(), getAddress(t));
+        explicit.add(getAddress(t).toLowerCase());
+    }
+    if (options.discover) {
+        const r = await scanDividendTokens(provider, holder, options.discover === true ? {} : options.discover);
+        scan = { cursor: r.cursor, progress: r.progress, tokens: r.tokens };
+        for (const t of r.tokens)
+            found.set(t.toLowerCase(), t);
+    }
+    const tokens = [...found.values()];
+    if (tokens.length > MAX_TOKENS)
+        throw new Error(`Too many tokens (${tokens.length}), at most ${MAX_TOKENS} per call`);
+    const result = { items: [], unsupported: [], ...(scan ? { scan } : {}) };
+    if (!tokens.length)
+        return result;
+    // 第一步：代币本身（余额、精度、Dividend 合约地址）
+    const stage1 = await provider.tryAll(tokens.flatMap((t) => [provider.contract(t, TOKEN_ABI).dividendContract(), provider.contract(t, TOKEN_ABI).balanceOf(holder), provider.contract(t, TOKEN_ABI).symbol(), provider.contract(t, TOKEN_ABI).decimals()]));
+    const valid = [];
+    tokens.forEach((token, i) => {
+        const [dividend, balance, symbol, decimals] = stage1.slice(i * 4, i * 4 + 4);
+        if (dividend === null || dividend === ZERO) {
+            // 发现来的代币大多不是分红代币（普通 8888 代币等），只报告用户明确传入的
+            if (explicit.has(token.toLowerCase()))
+                result.unsupported.push({ token, reason: dividend === null ? 'no dividendContract() (not a Flap tax token V2/V3)' : 'token has no dividend contract' });
+        }
+        else if (balance === null || decimals === null) {
+            result.unsupported.push({ token, reason: 'not an ERC20 token' });
+        }
+        else {
+            valid.push({ token, dividend, balance, symbol: typeof symbol === 'string' ? symbol : null, decimals: Number(decimals) });
+        }
+    });
+    // 第二步：Dividend 合约（分红代币、可领取、已领取、最低持仓）
+    const stage2 = valid.length
+        ? await provider.tryAll(valid.flatMap((v) => {
+            const d = provider.contract(v.dividend, DIVIDEND_ABI);
+            return [d.dividendToken(), d.weth(), d.withdrawableDividends(holder), d.withdrawnDividends(holder), d.minimumShareBalance()];
+        }))
+        : [];
+    const rows = [];
+    valid.forEach((v, i) => {
+        const [dividendToken, weth, claimable, claimed, min] = stage2.slice(i * 5, i * 5 + 5);
+        if (dividendToken === null || claimable === null || claimed === null || min === null) {
+            result.unsupported.push({ token: v.token, reason: 'dividend contract does not expose the expected functions (unknown generation)' });
+        }
+        else {
+            rows.push({ v, dividendToken, weth, claimable, claimed, min });
+        }
+    });
+    // 第三步：分红资产的 symbol / decimals（WBNB 作为 BNB 领取：按主币处理）
+    const isNative = (r) => r.dividendToken === ZERO || (r.weth !== null && r.dividendToken.toLowerCase() === r.weth.toLowerCase());
+    const assetTokens = [...new Set(rows.filter((r) => !isNative(r)).map((r) => r.dividendToken))];
+    const meta = new Map();
+    if (assetTokens.length) {
+        const res = await provider.tryAll(assetTokens.flatMap((a) => [provider.contract(a, ERC20_META_ABI).symbol(), provider.contract(a, ERC20_META_ABI).decimals()]));
+        assetTokens.forEach((a, i) => meta.set(a, { symbol: typeof res[i * 2] === 'string' ? res[i * 2] : null, decimals: res[i * 2 + 1] === null ? 18 : Number(res[i * 2 + 1]), known: res[i * 2 + 1] !== null }));
+    }
+    const nativeMeta = { symbol: 'BNB', decimals: 18, known: true };
+    const items = rows.map((r) => {
+        const native = isNative(r);
+        const m = native ? nativeMeta : (meta.get(r.dividendToken) ?? { symbol: null, decimals: 18, known: false });
+        return {
+            owner: holder,
+            token: r.v.token,
+            symbol: r.v.symbol,
+            decimals: r.v.decimals,
+            balance: r.v.balance.toString(),
+            dividendContract: getAddress(r.v.dividend),
+            dividendToken: getAddress(r.dividendToken),
+            asset: native ? 'native' : getAddress(r.dividendToken),
+            assetSymbol: m.symbol,
+            assetDecimals: m.decimals,
+            ...(m.known ? {} : { decimalsUnknown: true }),
+            claimable: r.claimable.toString(),
+            claimableFormatted: formatUnits(r.claimable, m.decimals),
+            claimed: r.claimed.toString(),
+            claimedFormatted: formatUnits(r.claimed, m.decimals),
+            usd: null,
+            minimumShareBalance: r.min.toString(),
+            accruing: r.v.balance >= r.min && r.v.balance > 0n,
+            adapter: 'flap',
+        };
+    });
+    const shown = options.includeZero ? items : items.filter((i) => BigInt(i.claimable) > 0n);
+    if (options.prices !== false && shown.length) {
+        try {
+            const { tokenPrices } = await import('./price.js');
+            const assets = [...new Set(shown.map((i) => (i.asset === 'native' ? NATIVE_TOKEN : i.asset)))];
+            const prices = await tokenPrices(provider, assets, { ...(typeof options.prices === 'object' ? { sources: [options.prices] } : {}), ...(options.fetch ? { fetch: options.fetch } : {}) });
+            const byAsset = new Map(prices.map((p) => [p.token.toLowerCase(), p.price]));
+            for (const i of shown) {
+                if (i.decimalsUnknown)
+                    continue; // 精度未知，换算不出可信的美元价值
+                const price = byAsset.get((i.asset === 'native' ? NATIVE_TOKEN : i.asset).toLowerCase());
+                i.usd = price === null || price === undefined ? null : Number(i.claimableFormatted) * price;
+            }
+        }
+        catch (err) {
+            result.priceError = err instanceof Error ? err.message : String(err);
+        }
+    }
+    result.items = shown;
+    return result;
+}
+/**
+ * 领取分红要发的交易（不签名）：每个代币一笔 `withdrawDividendsFor(owner)`，发给它的 Dividend 合约，款项直接到 owner。
+ * 只包含 claimable > 0 的项。只校验 owner / dividendContract 是合法地址，不连链：items 来自调用方，
+ * 要确认 dividendContract 确实是代币自己的 Dividend 合约，用 claimDividends（发送前会在链上核对）
+ */
+export function buildClaimDividends(items) {
+    return items
+        .filter((item) => BigInt(item.claimable) > 0n)
+        .map((item) => {
+        if (item.adapter !== 'flap')
+            throw new Error(`Unsupported dividend adapter for ${item.token}`);
+        let to;
+        let owner;
+        try {
+            to = getAddress(item.dividendContract);
+            owner = getAddress(item.owner);
+        }
+        catch {
+            throw new Error(`Invalid dividendContract / owner address for ${item.token}`);
+        }
+        return { to, data: claimInterface.encodeFunctionData('withdrawDividendsFor', [owner]), value: '0', item };
+    });
+}
+/**
+ * 领取分红：构建（同 buildClaimDividends）后用 from 签名发送，钱包和选项同 batchCall
+ * （mode: '7702' / '4337' / '5792' 时合成一笔原子交易）。任何人都可以替持有人领取，款项直接到 item.owner，所以 from 不必是持有人（如代付 gas）。
+ *
+ * ```ts
+ * const { items } = await getDividends(user, { chainId: 56, discover: true })
+ * await claimDividends(provider, key, items, { mode: '7702' })
+ * ```
+ */
+export async function claimDividends(provider, from, items, options = {}) {
+    assertChain(await provider.getChainId());
+    const { simulate: preCheck = true, ...sendOptions } = options;
+    const txs = buildClaimDividends(items);
+    if (!txs.length)
+        return [];
+    const skipped = new Map();
+    // 核对 items 里的 dividendContract 确实是代币自己的 Dividend 合约（items 来自调用方，不能直接信）
+    const onChain = await provider.tryAll(txs.map((tx) => provider.contract(tx.item.token, TOKEN_ABI).dividendContract()));
+    onChain.forEach((d, i) => {
+        if (d === null || txs[i].to.toLowerCase() !== d.toLowerCase()) {
+            skipped.set(i, `dividendContract mismatch: ${txs[i].to} is not the dividend contract of ${txs[i].item.token}`);
+        }
+    });
+    if (preCheck) {
+        const { simulate } = await import('./simulate.js');
+        const sims = await Promise.all(txs.map((tx, i) => skipped.has(i) ? Promise.resolve({ success: true }) : simulate(provider, { to: tx.to, data: tx.data, from: tx.item.owner }, { usd: false, risk: false }).catch((err) => ({ success: false, error: err instanceof Error ? err.message : String(err) }))));
+        sims.forEach((s, i) => !s.success && skipped.set(i, s.error ?? 'simulation failed'));
+    }
+    const send = txs.map((tx, i) => ({ tx, i })).filter(({ i }) => !skipped.has(i));
+    const { batchCall } = await import('./write/batch.js');
+    const sent = send.length ? await batchCall(provider, send.map(({ tx }) => ({ from, to: tx.to, data: tx.data })), { continueOnError: true, ...sendOptions }) : [];
+    const sentBy = new Map(send.map(({ i }, k) => [i, sent[k]]));
+    return txs.map((tx, i) => {
+        const r = sentBy.get(i);
+        if (r)
+            return { ...r, index: i, item: tx.item };
+        return { index: i, from: tx.item.owner, to: tx.to, status: 'skipped', hash: null, nonce: null, gasLimit: null, gasUsed: null, fee: null, blockNumber: null, error: skipped.get(i) ?? null, item: tx.item };
+    });
+}
+//# sourceMappingURL=dividends.js.map

package/dist/dividends.js.map

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

package/dist/history.d.ts

@@ -0,0 +1,154 @@
+import type { Provider } from './provider.js';
+import { type HistorySource } from './historySources.js';
+export type ActivityType = 'transfer' | 'swap' | 'approve' | 'liquidity' | 'mint' | 'contract' | 'other';
+export interface ActivityChange {
+    /** 代币 / NFT 合约地址；主币是 'native' */
+    asset: string;
+    symbol: string | null;
+    decimals: number;
+    /** 带符号的最小单位数量 */
+    delta: string;
+    formatted: string;
+    /** NFT（721 / 1155）：tokenId */
+    tokenId?: string;
+}
+export interface Activity {
+    hash: string;
+    /** 秒级时间戳 */
+    time: number;
+    block?: number;
+    status: 'success' | 'failed';
+    type: ActivityType;
+    /** 转账 / 铸造的方向（自己转给自己是 self）；兑换等没有 */
+    direction?: 'in' | 'out' | 'self';
+    /** 对方地址（转账的另一方；合约调用是合约地址） */
+    counterparty?: string;
+    /** 一句话描述 */
+    label?: string;
+    /** 这个地址的资产变化（失败的交易没有） */
+    changes: ActivityChange[];
+    /** 手续费（最小单位的主币，只有这个地址是发送者时）。Tron 为 sun */
+    fee?: string;
+    protocol?: string;
+    /** 调用的方法名（能解码时） */
+    method?: string;
+}
+export interface RawTx {
+    hash: string;
+    /** 位置：EVM 是区块号，Tron 是毫秒时间戳（分页用） */
+    pos: number;
+    block?: number;
+    time: number;
+    from: string;
+    to?: string | null;
+    /** 附带的主币 */
+    value: bigint;
+    /** calldata（0x 开头） */
+    input: string;
+    ok: boolean;
+    fee?: bigint;
+}
+export interface RawMove {
+    hash: string;
+    pos: number;
+    block?: number;
+    time: number;
+    /** 'native' 或代币合约地址 */
+    asset: string;
+    from: string;
+    to: string;
+    value: bigint;
+    tokenId?: string;
+    symbol?: string | null;
+    decimals?: number | null;
+}
+export interface RawPage {
+    txs: RawTx[];
+    moves: RawMove[];
+    /** 位置 ≥ 这个值的记录是完整的（列表按条数截断时，最后一个位置上的记录可能只拿到一部分）；没有更多历史时为 0 */
+    completeFrom: number;
+    /** 下一页查到这个位置（含）为止，往旧的方向；没有更多历史时没有 */
+    next?: number;
+}
+export interface HistoryQuery {
+    /** 要查的地址：EVM 是 0x 小写，Tron 是 T 开头 */
+    address: string;
+    chainId: number;
+    /** 每次从各个列表取多少条 */
+    limit: number;
+    /** 只查位置 ≤ 这个值的记录（分页用，不传从最新开始） */
+    endPos?: number;
+    /** 是否包含 NFT 转账 */
+    nft: boolean;
+    provider: Provider;
+    fetch: typeof fetch;
+    signal?: AbortSignal;
+}
+/** 数据来源适配器：按查询返回原始记录 */
+export interface HistoryAdapter {
+    name: string;
+    /** 这个来源是否支持这条链（不支持的在故障切换里直接跳过） */
+    supports?(chainId: number): boolean;
+    fetch(query: HistoryQuery): Promise<RawPage>;
+}
+export interface HistoryOptions {
+    /** 数据来源：名字（'blockscout' | 'etherscan' | 'rpc' | 'trongrid'）、适配器对象，或它们的数组（按顺序故障切换）。默认：有 Blockscout 的链 [blockscout, rpc]，否则 [rpc]；传了 apiKey 时 etherscan 排最前；Tron 是 trongrid */
+    source?: HistorySource | readonly HistorySource[];
+    /** Etherscan 系（v2，一个 Key 覆盖多条链）/ TronGrid 的 API Key */
+    apiKey?: string;
+    /** 至少返回多少条（按区块整块取，可能略多；历史到头时可能不足） */
+    limit?: number;
+    /** 上一次返回的 nextCursor */
+    cursor?: string;
+    /** 只要这些类型（过滤后不够 limit 会继续往前翻页，直到 maxPages） */
+    types?: readonly ActivityType[];
+    /** 时间范围（秒级时间戳）：只要这个时间之前 / 之后的；往前翻到早于 after 就停 */
+    before?: number;
+    after?: number;
+    /** 是否包含 NFT 转账，默认 true */
+    nft?: boolean;
+    /** 为凑够 limit 最多翻几页，默认 5 */
+    maxPages?: number;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}
+export interface HistoryResult {
+    items: Activity[];
+    /** 还有更早的历史时给出，传给下一次的 cursor */
+    nextCursor?: string;
+    /** 实际用的数据来源 */
+    source: string;
+}
+export declare class HistorySourceError extends Error {
+    readonly errors: ReadonlyArray<{
+        source: string;
+        error: unknown;
+    }>;
+    constructor(errors: ReadonlyArray<{
+        source: string;
+        error: unknown;
+    }>);
+}
+interface BuildCtx {
+    chainId: number;
+    tron: boolean;
+    /** 比较用的 0x 小写地址 */
+    me: string;
+    native: {
+        symbol: string | null;
+        decimals: number;
+    };
+}
+export declare function buildActivities(page: Pick<RawPage, 'txs' | 'moves'>, ctx: BuildCtx, minPos?: number): Activity[];
+/**
+ * 查一个地址的历史活动（最新的在前），分页用 nextCursor。
+ *
+ * ```ts
+ * const page = await history(provider, user, { limit: 20 })                       // Blockscout，失败换 RPC 日志
+ * const next = await history(provider, user, { cursor: page.nextCursor, types: ['swap'] })
+ * await history(provider, user, { source: ['etherscan', 'rpc'], apiKey })         // Etherscan v2 的 Key 覆盖多条链
+ * ```
+ */
+export declare function history(provider: Provider, address: string, options?: HistoryOptions): Promise<HistoryResult>;
+export type { HistorySource } from './historySources.js';
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

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