@w3lib/evm-batch-call 0.4.1 → 0.5.0

package/dist/write/collect.js

@@ -0,0 +1,255 @@
+import { Interface, getAddress, getBigInt } from 'ethers';
+import { ERC20_ABI, NATIVE_TOKEN, formatUnits } from '../erc20.js';
+import { isExecutionError } from '../errors.js';
+import { WriteRpc, failureText, l1Fee } from './rpc.js';
+import { FeeSource, applyGasMultiplier, emptyOutcome, mapPool, sendJobs, toWriteResult } from './send.js';
+import { resolveSigner } from './signer.js';
+import { tronModule } from './batch.js';
+import { batchTransfer } from './transfer.js';
+const erc20Interface = new Interface(ERC20_ABI);
+/** 预估代币转账 gas 失败（有的节点对没有主币的地址预估时报余额不足）时用的 gasLimit */
+const FALLBACK_TOKEN_GAS = 120000n;
+/**
+ * 归集：多个钱包的代币 / 主币转到同一个地址。每个钱包内按代币顺序逐笔发送，钱包之间并发。
+ *
+ * ```ts
+ * const { results, topUps } = await batchCollect(multi, [key1, key2, key3], hotWallet, {
+ *   tokens: [USDT, NATIVE_TOKEN],   // 主币放在里面表示代币归集完后扫空剩余主币
+ *   gasWallet: gasKey,              // 子钱包主币不够付手续费时先从这里补
+ * })
+ * ```
+ *
+ * 流程：一次 multicall 读出所有钱包的余额 → 预估每笔归集的手续费 → 给不够的钱包补 gas（等确认）
+ * → 发代币归集 → （包含主币时）等代币归集确认、按最新余额扫空主币。
+ * dryRun 时只做到预估，返回计划（补多少 gas、每笔 gasLimit），不发任何交易
+ */
+export async function batchCollect(provider, wallets, to, options) {
+    const tron = await tronModule(provider);
+    if (tron) {
+        return tron.tronBatchCollect(provider, wallets, to, options);
+    }
+    const rpc = await WriteRpc.from(provider);
+    const target = getAddress(to);
+    const cache = new Map();
+    const signers = await Promise.all(wallets.map((w) => resolveSigner(w, cache)));
+    const tokens = options.tokens;
+    const nativeIndex = tokens.findIndex((t) => provider.isNativeToken(t));
+    const sweep = nativeIndex >= 0;
+    const multiplier = options.gasMultiplier;
+    // 一次 multicall 读出所有钱包的代币余额 + 主币余额（算手续费要用）
+    const queryTokens = sweep ? [...tokens] : [...tokens, NATIVE_TOKEN];
+    const nativeAt = sweep ? nativeIndex : tokens.length;
+    const balances = await provider.multiBalances(signers.map((s) => ({ owner: s.address, tokens: queryTokens })));
+    const minAmount = new Map(Object.entries(options.minAmount ?? {}).map(([k, v]) => [k.toLowerCase(), getBigInt(v)]));
+    const items = [];
+    const seen = new Set();
+    signers.forEach((signer, w) => {
+        const duplicate = seen.has(signer.address.toLowerCase());
+        seen.add(signer.address.toLowerCase());
+        tokens.forEach((token, t) => {
+            const balance = balances[w]?.[t];
+            const native = t === nativeIndex;
+            const decimals = balance.success ? balance.decimals : null;
+            const item = {
+                index: w * tokens.length + t,
+                signer,
+                token: native ? token : getAddress(token),
+                native,
+                amount: native ? 0n : balance.success ? BigInt(balance.balance) : 0n,
+                decimals,
+                gasLimit: null,
+                result: null,
+            };
+            const skip = !balance.success
+                ? `cannot read balance: ${balance.error ?? 'unknown error'}`
+                : signer.address === target
+                    ? 'skipped: wallet is the collect address'
+                    : duplicate
+                        ? 'skipped: duplicate wallet'
+                        : !native && item.amount === 0n
+                            ? 'skipped: zero balance'
+                            : !native && item.amount < (minAmount.get(token.toLowerCase()) ?? 0n)
+                                ? 'skipped: below minAmount'
+                                : null;
+            item.result = toCollectResult(item, target, emptyOutcome(skip ? (balance.success ? 'skipped' : 'failed') : 'skipped', skip));
+            items.push(item);
+        });
+    });
+    const results = items.map((i) => i.result);
+    const report = (item, outcome) => {
+        item.result = toCollectResult(item, target, outcome);
+        results[item.index] = item.result;
+        options.onUpdate?.(item.result);
+    };
+    const active = (item) => item.result.error === null;
+    // 预估每个钱包的代币归集 gas，算出需要补多少主币。
+    // 手续费价格只取这一次，代币归集也按它发：补 gas 等确认期间节点报价上涨，也不会超出补的数量、因余额不足被拒
+    const fee = await new FeeSource(rpc, options).get();
+    const fees = FeeSource.fixed(rpc, fee);
+    const byWallet = new Map();
+    items.forEach((item) => {
+        if (active(item)) {
+            byWallet.set(item.signer.address, [...(byWallet.get(item.signer.address) ?? []), item]);
+        }
+    });
+    const plans = await mapPool([...byWallet.entries()], options.concurrency ?? 8, async ([address, list]) => {
+        const native = balances[signers.findIndex((s) => s.address === address)]?.[nativeAt];
+        if (!native.success) {
+            // 主币余额读不到：不知道要补多少，不补（按 0 算会多补，而这个钱包也不会扫主币，多补的收不回来）
+            list.filter((i) => !i.native).forEach((i) => report(i, emptyOutcome('failed', `cannot read the native balance: ${native.error ?? 'unknown error'}`)));
+            return { address, list, shortfall: 0n };
+        }
+        let need = 0n;
+        for (const item of list) {
+            if (item.native) {
+                continue;
+            }
+            const tx = { from: address, to: item.token, data: erc20Interface.encodeFunctionData('transfer', [target, item.amount]) };
+            try {
+                item.gasLimit = applyGasMultiplier(await rpc.estimateGas(tx), multiplier);
+            }
+            catch (err) {
+                if (!/insufficient funds/i.test(failureText(err))) {
+                    report(item, { ...emptyOutcome('failed', failureText(err)) });
+                    continue;
+                }
+                item.gasLimit = FALLBACK_TOKEN_GAS;
+            }
+            need += item.gasLimit * fee.perGas + (await l1Fee(rpc, { ...tx, from: undefined, gasLimit: item.gasLimit, ...feeFields(fee) }));
+        }
+        const wallet = signers.findIndex((s) => s.address === address);
+        const nativeBalance = BigInt((balances[wallet]?.[nativeAt]).balance);
+        const buffered = (need * BigInt(Math.round((options.gasBuffer ?? 1) * 1000))) / 1000n;
+        return { address, list, shortfall: buffered > nativeBalance ? buffered - nativeBalance : 0n };
+    });
+    // 补 gas
+    let topUps = [];
+    const short = plans.filter((p) => p.shortfall > 0n && p.list.some((i) => !i.native && active(i)));
+    if (short.length) {
+        if (!options.gasWallet) {
+            short.forEach((p) => p.list.filter((i) => !i.native && active(i)).forEach((i) => report(i, emptyOutcome('failed', `insufficient native balance for gas: need ${p.shortfall} more wei (pass gasWallet to top up automatically)`))));
+        }
+        else {
+            topUps = await batchTransfer(provider, options.gasWallet, short.map((p) => ({ to: p.address, amount: p.shortfall, token: NATIVE_TOKEN })), { ...sendOptions(options), mode: options.gasMode ?? 'disperse', wait: true });
+            topUps.forEach((t, k) => {
+                const ok = t.status === 'confirmed' || (options.dryRun && t.status === 'simulated');
+                if (!ok) {
+                    ;
+                    short[k].list.filter((i) => !i.native && active(i)).forEach((i) => report(i, emptyOutcome('failed', `gas top-up ${t.status}: ${t.error ?? ''}`.trim())));
+                }
+            });
+        }
+    }
+    // 代币归集
+    const tokenItems = items.filter((i) => !i.native && active(i));
+    if (options.dryRun) {
+        tokenItems.forEach((i) => report(i, { ...emptyOutcome('simulated'), gasLimit: i.gasLimit }));
+        if (sweep) {
+            items.filter((i) => i.native && active(i)).forEach((i) => report(i, { ...emptyOutcome('simulated'), gasLimit: 21000n }));
+        }
+        return { results, topUps };
+    }
+    const minBlock = new Map();
+    topUps.forEach((t) => t.blockNumber !== null && minBlock.set(getAddress(t.to), t.blockNumber));
+    const track = (item, outcome) => {
+        if (outcome.blockNumber !== null) {
+            minBlock.set(item.signer.address, Math.max(minBlock.get(item.signer.address) ?? 0, outcome.blockNumber));
+        }
+        report(item, outcome);
+    };
+    // 发送前重新预估（不用补 gas 前的 gasLimit）：预估时余额不足、用了兜底值的项按实际需要发；余额变了的项预估失败，不会上链 revert 白付手续费
+    const jobs = tokenItems.map((item) => ({
+        signer: item.signer,
+        continueOnError: true,
+        build: async () => ({ to: item.token, data: erc20Interface.encodeFunctionData('transfer', [target, item.amount]), value: 0n }),
+        onUpdate: (outcome) => track(item, outcome),
+    }));
+    // 要扫主币时必须等代币归集确认（扫的是扣完手续费后的余额）
+    await sendJobs(rpc, jobs, sweep ? { ...options, wait: true } : options, fees);
+    // 代币没有全部归集成功的钱包不扫主币：留着付之后重新归集的手续费；还没确认的交易也要用这部分主币付手续费
+    items
+        .filter((i) => i.native && active(i))
+        .forEach((native) => {
+        const unfinished = items.find((i) => !i.native && i.signer.address === native.signer.address && i.result.status !== 'confirmed' && i.result.status !== 'skipped');
+        if (unfinished) {
+            report(native, emptyOutcome('skipped', `skipped: collecting ${unfinished.token} did not succeed (${unfinished.result.status})`));
+        }
+    });
+    // 扫空主币：按最新余额（不早于该钱包最后一笔确认交易的区块）减去这笔的手续费
+    const sweepItems = items.filter((i) => i.native && active(i));
+    if (sweep && sweepItems.length && !options.signal?.aborted) {
+        // 代币归集已经发出：这一阶段出错不能整体抛错（调用方会拿不到这些结果），扫主币的项标记失败
+        const failSweep = (error) => {
+            sweepItems.forEach((i) => report(i, emptyOutcome('failed', error)));
+            return { results, topUps };
+        };
+        let sweepFee;
+        try {
+            sweepFee = await new FeeSource(rpc, options).get();
+        }
+        catch (err) {
+            return failSweep(`cannot get the fee data: ${failureText(err)}`);
+        }
+        let gasLimit = 21000n;
+        try {
+            gasLimit = applyGasMultiplier(await rpc.estimateGas({ from: sweepItems[0].signer.address, to: target, value: 1n }), multiplier);
+        }
+        catch (err) {
+            // 归集地址拒收主币（如没有 receive 的合约）：发了也必然 revert，白付手续费
+            if (isExecutionError(err))
+                return failSweep(`the collect address cannot receive the native coin: ${failureText(err)}`);
+            // 节点暂时出错：按普通转账
+        }
+        const sweepJobs = await mapPool(sweepItems, options.concurrency ?? 8, async (item) => {
+            const block = minBlock.get(item.signer.address);
+            let balance;
+            try {
+                ;
+                [balance] = await provider.balances(item.signer.address, [NATIVE_TOKEN], block === undefined ? {} : { minBlock: block });
+            }
+            catch (err) {
+                // 代币归集已经发出：不能整体抛错（调用方会拿不到这些结果），这一项标记失败
+                report(item, emptyOutcome('failed', `cannot read balance: ${failureText(err)}`));
+                return null;
+            }
+            if (!balance?.success) {
+                report(item, emptyOutcome('failed', `cannot read balance: ${balance?.error ?? 'unknown error'}`));
+                return null;
+            }
+            const reserve = gasLimit * sweepFee.perGas + (await l1Fee(rpc, { to: target, value: BigInt(balance.balance), gasLimit, ...feeFields(sweepFee) }));
+            const amount = BigInt(balance.balance) - reserve;
+            if (amount <= 0n) {
+                report(item, emptyOutcome('skipped', 'skipped: native balance does not cover the gas fee'));
+                return null;
+            }
+            item.amount = amount;
+            return {
+                signer: item.signer,
+                gasLimit,
+                continueOnError: true,
+                build: async () => ({ to: target, data: '0x', value: amount }),
+                onUpdate: (outcome) => report(item, outcome),
+            };
+        });
+        await sendJobs(rpc, sweepJobs.filter((j) => j !== null), options, FeeSource.fixed(rpc, sweepFee));
+    }
+    return { results, topUps };
+}
+/** 只保留发送参数（补 gas 时不带 tokens / onUpdate 等归集参数） */
+function sendOptions(options) {
+    const { tokens: _tokens, gasWallet: _gasWallet, gasMode: _gasMode, gasBuffer: _gasBuffer, minAmount: _minAmount, onUpdate: _onUpdate, ...rest } = options;
+    return rest;
+}
+function feeFields(fee) {
+    return fee.type === 2 ? { type: 2, maxFeePerGas: fee.maxFeePerGas, maxPriorityFeePerGas: fee.maxPriorityFeePerGas } : { type: 0, gasPrice: fee.gasPrice };
+}
+function toCollectResult(item, to, outcome) {
+    return {
+        ...toWriteResult(item.index, item.signer.address, to, outcome),
+        token: item.token,
+        native: item.native,
+        amount: item.amount.toString(),
+        formatted: item.decimals === null ? null : formatUnits(item.amount, item.decimals),
+    };
+}
+//# sourceMappingURL=collect.js.map

package/dist/write/collect.js.map

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

package/dist/write/rpc.d.ts

@@ -0,0 +1,68 @@
+import { type TransactionReceipt, type TransactionRequest } from 'ethers';
+import type { EthersLikeProvider } from '../aggregate.js';
+import type { Provider } from '../provider.js';
+export interface FeeData {
+    gasPrice: bigint | null;
+    maxFeePerGas: bigint | null;
+    maxPriorityFeePerGas: bigint | null;
+}
+/**
+ * 广播结果：已进交易池（含节点说已经有这笔）；nonce 已被用掉（可能就是这笔已上链，也可能被别的交易占用）；
+ * 或不确定（超时、连接失败，或前一个节点超时后另一个节点拒绝：前一个节点也许已经收下了），交易可能已经发出
+ */
+export type BroadcastOutcome = 'accepted' | 'nonce-used' | {
+    uncertain: string;
+};
+/** 广播被节点明确拒绝、换节点也一样（交易没进交易池） */
+export declare function isFinalBroadcastError(err: unknown): boolean;
+/** 预估 / 执行失败的可读原因：优先解析 revert 数据（Error(string) / Panic），否则取节点的原始信息 */
+export declare function failureText(err: unknown): string;
+/** 预估 gas 时 revert 带回的数据（解析 7702 批量执行里是第几个调用失败用） */
+export declare function revertData(err: unknown): string | null;
+/**
+ * 在 Provider 的节点上执行请求：多节点时与 call / getBalance 相同的故障切换（ChainCheckedProvider 先校验链）；
+ * isFinal 判定为确定性的错误（revert、余额不足等）直接抛出，不拿去别的节点重试
+ */
+export declare function runOnNodes<T>(rpc: EthersLikeProvider, method: string, fn: (node: EthersLikeProvider) => Promise<T>, isFinal?: (err: unknown) => boolean): Promise<T>;
+/**
+ * 写操作的节点访问：nonce、fee、预估 gas、广播、查回执，都经过 Provider 的多节点故障切换。
+ * 确定性错误（revert、余额不足等）直接抛出，不拿去别的节点重试
+ */
+export declare class WriteRpc {
+    #private;
+    readonly rpc: EthersLikeProvider;
+    readonly chainId: number;
+    constructor(rpc: EthersLikeProvider, chainId: number);
+    static from(provider: Provider): Promise<WriteRpc>;
+    /**
+     * 下一个可用的 nonce：节点的 pending 计数（含交易池里待确认的交易）与本次已用过的取大者。
+     * 多节点时先返回的节点可能还没看到刚发出的交易，只信节点会拿到已用过的 nonce
+     */
+    nonce(address: string): Promise<number>;
+    /** 已上链的交易数（latest nonce） */
+    latestNonce(address: string): Promise<number>;
+    /** 记录 nonce 已被占用（交易已广播，或节点说已被用掉） */
+    useNonce(address: string, nonce: number): void;
+    code(address: string): Promise<string>;
+    feeData(): Promise<FeeData>;
+    /** 预估 gas；revert / 余额不足等直接抛出（error.data 是 revert 数据） */
+    estimateGas(tx: TransactionRequest): Promise<bigint>;
+    /** eth_call；revert 直接抛出 */
+    call(tx: TransactionRequest): Promise<string>;
+    /**
+     * 广播已签名的交易。同一笔签名交易重复广播是安全的：节点说已经有了视为成功；
+     * nonce 已被用掉时返回 'nonce-used'（调用方查回执确认是不是这笔已上链）。其他交易本身的问题直接抛出
+     */
+    broadcast(signed: string): Promise<BroadcastOutcome>;
+    receipt(hash: string): Promise<TransactionReceipt | null>;
+}
+/** 已签名交易的哈希 */
+export declare function signedHash(signed: string): string;
+/** 测试用 */
+export declare function resetL1OracleCache(): void;
+/**
+ * 交易的 L1 数据费（OP Stack / Scroll），其他链为 0。结果加 25% 余量（L1 gas 价格在交易上链前可能上涨）。
+ * 查询失败时返回 0（不阻塞发送，只影响扫空主币时的预留）
+ */
+export declare function l1Fee(rpc: WriteRpc, tx: TransactionRequest): Promise<bigint>;
+//# sourceMappingURL=rpc.d.ts.map

package/dist/write/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../src/write/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AAE3I,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAO9C,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,YAAY,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAA;AAchF,gCAAgC;AAChC,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE3D;AAcD,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAOhD;AAED,oDAAoD;AACpD,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAGtD;AASD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAqB,GAAG,OAAO,CAAC,CAAC,CAAC,CAiBvL;AAED;;;GAGG;AACH,qBAAa,QAAQ;;IAEjB,QAAQ,CAAC,GAAG,EAAE,kBAAkB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM;gBADf,GAAG,EAAE,kBAAkB,EACvB,OAAO,EAAE,MAAM;WAGb,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAyBxD;;;OAGG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK7C,4BAA4B;IAC5B,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7C,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAK9C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAKjC,wDAAwD;IACxD,WAAW,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIpD,2BAA2B;IAC3B,IAAI,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7C;;;OAGG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuC1D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;CAG1D;AAED,eAAe;AACf,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AASD,UAAU;AACV,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAuBD;;;GAGG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAalF"}

package/dist/write/rpc.js

@@ -0,0 +1,236 @@
+import { Interface, Transaction, isError } from 'ethers';
+import { decodeRevertReason, isExecutionError } from '../errors.js';
+import { FallbackRpc, errorText } from '../fallback.js';
+import { ChainCheckedProvider } from '../source.js';
+import { TronProvider, isTronChain } from '../tron.js';
+/** 换节点也不会变的失败（余额不足、revert、gas 参数不合法等），不再请求其他节点 */
+class Final {
+    error;
+    constructor(error) {
+        this.error = error;
+    }
+}
+// 节点对“交易池里已经有这笔交易”的各种说法：同一笔签名交易发到多个节点 / 重发时会遇到，视为成功
+const ALREADY_KNOWN_RE = /already known|known transaction|already imported|already exists|alreadyknown|already in (the )?(tx|transaction)?\s*pool/i;
+const NONCE_USED_RE = /nonce too low|nonce has already been used|nonce is too low|invalid nonce|old nonce/i;
+// 交易本身的问题：换节点结果一样
+const TX_INVALID_RE = /insufficient funds|intrinsic gas too low|exceeds block gas limit|gas limit reached|max fee per gas less than block base fee|fee cap less than block base fee|underpriced|tip higher than|max priority fee per gas higher than|invalid sender|invalid chain id|only replay-protected|transaction type not supported|tx type not supported|oversized data/i;
+/** 广播被节点明确拒绝、换节点也一样（交易没进交易池） */
+export function isFinalBroadcastError(err) {
+    return isError(err, 'INSUFFICIENT_FUNDS') || isError(err, 'REPLACEMENT_UNDERPRICED') || isError(err, 'INVALID_ARGUMENT') || TX_INVALID_RE.test(errorText(err));
+}
+/** 节点明确拒绝了这笔交易（给出了 JSON-RPC 错误，或限频）：交易肯定没进这个节点的交易池 */
+function isRejection(err) {
+    const e = err;
+    const message = e?.error?.message ?? e?.info?.error?.message;
+    if (isFinalBroadcastError(err) || /too many requests|rate.?limit|\b429\b/i.test(errorText(err)))
+        return true;
+    return typeof message === 'string' && !/timeout|timed out|busy|unavailable|overload|try again/i.test(message);
+}
+function isFinalEstimateError(err) {
+    return isExecutionError(err) || isError(err, 'INSUFFICIENT_FUNDS') || isError(err, 'INVALID_ARGUMENT') || /insufficient funds|gas required exceeds allowance|transaction type not supported/i.test(errorText(err));
+}
+/** 预估 / 执行失败的可读原因：优先解析 revert 数据（Error(string) / Panic），否则取节点的原始信息 */
+export function failureText(err) {
+    const data = err?.data;
+    const reason = typeof data === 'string' ? decodeRevertReason(data) : null;
+    if (reason) {
+        return `execution reverted: ${reason}`;
+    }
+    return errorText(err);
+}
+/** 预估 gas 时 revert 带回的数据（解析 7702 批量执行里是第几个调用失败用） */
+export function revertData(err) {
+    const data = err?.data;
+    return typeof data === 'string' && data !== '0x' ? data : null;
+}
+function asWriteNode(node, method) {
+    if (typeof node[method] !== 'function') {
+        throw new Error(`${method} is not supported by this node; pass an RPC URL or an ethers Provider`);
+    }
+    return node;
+}
+/**
+ * 在 Provider 的节点上执行请求：多节点时与 call / getBalance 相同的故障切换（ChainCheckedProvider 先校验链）；
+ * isFinal 判定为确定性的错误（revert、余额不足等）直接抛出，不拿去别的节点重试
+ */
+export async function runOnNodes(rpc, method, fn, isFinal = () => false) {
+    const guarded = (node) => {
+        if (node instanceof ChainCheckedProvider) {
+            return node.request((inner) => guarded(inner));
+        }
+        return fn(node).catch((err) => {
+            if (isFinal(err)) {
+                return new Final(err);
+            }
+            throw err;
+        });
+    };
+    const result = rpc instanceof FallbackRpc ? await rpc.request(method, guarded) : await guarded(rpc);
+    if (result instanceof Final) {
+        throw result.error;
+    }
+    return result;
+}
+/**
+ * 写操作的节点访问：nonce、fee、预估 gas、广播、查回执，都经过 Provider 的多节点故障切换。
+ * 确定性错误（revert、余额不足等）直接抛出，不拿去别的节点重试
+ */
+export class WriteRpc {
+    rpc;
+    chainId;
+    constructor(rpc, chainId) {
+        this.rpc = rpc;
+        this.chainId = chainId;
+    }
+    static async from(provider) {
+        const chainId = await provider.getChainId();
+        if (isTronChain(chainId)) {
+            throw new Error('This operation is not supported on Tron');
+        }
+        return new WriteRpc(provider.rpc, chainId);
+    }
+    #run(method, fn, isFinal) {
+        return runOnNodes(this.rpc, method, (node) => {
+            if (node instanceof TronProvider) {
+                return Promise.reject(new Error('This operation is not supported on Tron'));
+            }
+            return fn(asWriteNode(node, method));
+        }, isFinal);
+    }
+    /** 本次批量操作里各钱包已用到的 nonce + 1（同一个 WriteRpc 分几轮发送时接上） */
+    #nextNonce = new Map();
+    /**
+     * 下一个可用的 nonce：节点的 pending 计数（含交易池里待确认的交易）与本次已用过的取大者。
+     * 多节点时先返回的节点可能还没看到刚发出的交易，只信节点会拿到已用过的 nonce
+     */
+    async nonce(address) {
+        const pending = await this.#run('getTransactionCount', (node) => node.getTransactionCount(address, 'pending'));
+        return Math.max(pending, this.#nextNonce.get(address.toLowerCase()) ?? 0);
+    }
+    /** 已上链的交易数（latest nonce） */
+    latestNonce(address) {
+        return this.#run('getTransactionCount', (node) => node.getTransactionCount(address, 'latest'));
+    }
+    /** 记录 nonce 已被占用（交易已广播，或节点说已被用掉） */
+    useNonce(address, nonce) {
+        const key = address.toLowerCase();
+        this.#nextNonce.set(key, Math.max(this.#nextNonce.get(key) ?? 0, nonce + 1));
+    }
+    code(address) {
+        return this.#run('getCode', (node) => node.getCode(address));
+    }
+    async feeData() {
+        const fee = await this.#run('getFeeData', (node) => node.getFeeData());
+        return { gasPrice: fee.gasPrice, maxFeePerGas: fee.maxFeePerGas, maxPriorityFeePerGas: fee.maxPriorityFeePerGas };
+    }
+    /** 预估 gas；revert / 余额不足等直接抛出（error.data 是 revert 数据） */
+    estimateGas(tx) {
+        return this.#run('estimateGas', (node) => node.estimateGas(tx), isFinalEstimateError);
+    }
+    /** eth_call；revert 直接抛出 */
+    call(tx) {
+        return this.#run('call', (node) => node.call(tx), isExecutionError);
+    }
+    /**
+     * 广播已签名的交易。同一笔签名交易重复广播是安全的：节点说已经有了视为成功；
+     * nonce 已被用掉时返回 'nonce-used'（调用方查回执确认是不是这笔已上链）。其他交易本身的问题直接抛出
+     */
+    async broadcast(signed) {
+        // 记录各节点的结果：只有所有尝试都是“明确拒绝”、并且没有还在进行中的尝试时，才能确定交易没发出去
+        let attempts = 0;
+        let rejections = 0;
+        let pending = 0;
+        try {
+            return await this.#run('broadcastTransaction', async (node) => {
+                attempts++;
+                pending++;
+                try {
+                    await node.broadcastTransaction(signed);
+                    return 'accepted';
+                }
+                catch (err) {
+                    const text = errorText(err);
+                    if (ALREADY_KNOWN_RE.test(text)) {
+                        return 'accepted';
+                    }
+                    if (isError(err, 'NONCE_EXPIRED') || NONCE_USED_RE.test(text)) {
+                        return 'nonce-used';
+                    }
+                    if (isRejection(err))
+                        rejections++;
+                    throw err;
+                }
+                finally {
+                    pending--;
+                }
+            }, 
+            // 明确拒绝、而且之前没有不确定的尝试：不再问别的节点
+            (err) => isFinalBroadcastError(err) && rejections === attempts && pending === 0);
+        }
+        catch (err) {
+            if (attempts === 0 || rejections === attempts) {
+                throw err;
+            }
+            return { uncertain: `broadcast not acknowledged: ${failureText(err)}` };
+        }
+    }
+    receipt(hash) {
+        return this.#run('getTransactionReceipt', (node) => node.getTransactionReceipt(hash));
+    }
+}
+/** 已签名交易的哈希 */
+export function signedHash(signed) {
+    return Transaction.from(signed).hash;
+}
+// OP Stack（GasPriceOracle）与 Scroll（L1GasPriceOracle）的 L1 数据费：不包含在 gasLimit × gasPrice 里，单独从余额里扣。
+// 扫空主币余额时要预留，否则交易因余额不足失败
+const L1_ORACLES = ['0x420000000000000000000000000000000000000F', '0x5300000000000000000000000000000000000002'];
+const l1OracleInterface = new Interface(['function getL1Fee(bytes data) view returns (uint256)']);
+/** chainId → 这条链的 L1 费用预言机地址（null 表示不是这类链） */
+const l1OracleByChain = new Map();
+/** 测试用 */
+export function resetL1OracleCache() {
+    l1OracleByChain.clear();
+}
+async function l1Oracle(rpc) {
+    const cached = l1OracleByChain.get(rpc.chainId);
+    if (cached !== undefined) {
+        return cached;
+    }
+    let found = null;
+    for (const address of L1_ORACLES) {
+        try {
+            const code = await rpc.code(address);
+            if (code && code !== '0x') {
+                found = address;
+                break;
+            }
+        }
+        catch {
+            return null; // 节点出错：这次按没有处理，下次再查
+        }
+    }
+    l1OracleByChain.set(rpc.chainId, found);
+    return found;
+}
+/**
+ * 交易的 L1 数据费（OP Stack / Scroll），其他链为 0。结果加 25% 余量（L1 gas 价格在交易上链前可能上涨）。
+ * 查询失败时返回 0（不阻塞发送，只影响扫空主币时的预留）
+ */
+export async function l1Fee(rpc, tx) {
+    const oracle = await l1Oracle(rpc);
+    if (!oracle) {
+        return 0n;
+    }
+    try {
+        const unsigned = Transaction.from({ ...tx, from: undefined, chainId: rpc.chainId }).unsignedSerialized;
+        const data = await rpc.call({ to: oracle, data: l1OracleInterface.encodeFunctionData('getL1Fee', [unsigned]) });
+        const [fee] = l1OracleInterface.decodeFunctionResult('getL1Fee', data);
+        return (fee * 125n) / 100n;
+    }
+    catch {
+        return 0n;
+    }
+}
+//# sourceMappingURL=rpc.js.map

package/dist/write/rpc.js.map

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