@w3lib/evm-batch-call 0.4.1 → 0.5.0

package/dist/write/send.d.ts

@@ -0,0 +1,124 @@
+import { type TransactionRequest } from 'ethers';
+import { WriteRpc } from './rpc.js';
+import type { ResolvedSigner } from './signer.js';
+/**
+ * 每个调用的状态：
+ * - confirmed：已上链且执行成功
+ * - reverted：已上链但执行失败（手续费已扣）
+ * - failed：没有发出去（预估 revert、余额不足、节点拒绝、用户在钱包里拒绝等），不花手续费
+ * - sent：已广播，没等确认（wait: false，或等待中途取消）。广播时超时 / 节点都连不上（交易可能已进交易池）也算 sent，error 里有说明
+ * - pending：等到超时还没确认，之后仍可能上链（可用 hash 自行查询）
+ * - skipped：没有执行：同一钱包前面的调用失败（continueOnError 为 false 时）、已取消，或同一笔批量交易里的其他调用失败
+ * - simulated：dryRun 预估通过
+ */
+export type WriteStatus = 'confirmed' | 'reverted' | 'failed' | 'sent' | 'pending' | 'skipped' | 'simulated';
+/** 发送参数（batchCall / batchTransfer / batchCollect 共用） */
+export interface SendOptions {
+    /** 等待上链确认。默认 true；false 时广播后即返回，status 为 'sent' */
+    wait?: boolean;
+    /** 等待确认的最长时间（毫秒），超时的交易 status 为 'pending'。默认 180000 */
+    timeout?: number;
+    /** 查询回执的间隔（毫秒），默认 2000。等待期间每 5 次查询重发一次原交易（防止被交易池丢弃，重发同一笔签名交易是安全的） */
+    pollInterval?: number;
+    /** 同时处理的钱包数（同一钱包的交易总是按 nonce 顺序发），默认 8 */
+    concurrency?: number;
+    /** gas 预估值的放大倍数，默认 1.2（预估值正好 21000 的普通转账不放大） */
+    gasMultiplier?: number;
+    /** 固定 gasPrice（legacy 交易） */
+    gasPrice?: bigint;
+    /** 固定 EIP-1559 费用，不传时按节点的 getFeeData（maxFee = 2 × baseFee + priorityFee） */
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    /** 只预估 gas、不发送，status 为 'simulated' 或 'failed'。注意：依赖前一笔交易结果的调用（如先 approve 再 transferFrom）预估会失败 */
+    dryRun?: boolean;
+    /** 取消：不再发新交易，已发出的不再等待确认（status 为 'sent'） */
+    signal?: AbortSignal;
+    /** 每个结果状态变化时回调（sent / confirmed / failed …），用于展示进度 */
+    onUpdate?: (result: WriteResult) => void;
+}
+/** 只在 Tron 上生效的发送参数 */
+export interface TronSendOptions {
+    /**
+     * 合约调用的 fee_limit（sun，最多烧多少 TRX 换能量）。默认按模拟的能量 × 能量单价 × 1.5。
+     * 能量不够时交易上链但执行失败（OUT_OF_ENERGY），已烧的 TRX 不退
+     */
+    feeLimit?: bigint;
+    /** 交易过期仍未上链时（按固化区块判断），换新的参考区块重发的次数。默认 2 */
+    retries?: number;
+}
+/** 每个调用的结果，都是字符串 / 数字 / null，可以直接 JSON.stringify */
+export interface WriteResult {
+    /** 在输入里的下标 */
+    index: number;
+    /** 发送的钱包地址 */
+    from: string;
+    /** 调用的目标地址（7702 批量交易里是每个子调用的目标） */
+    to: string;
+    status: WriteStatus;
+    /** 交易哈希（7702 / Disperse 里同一笔交易的多个调用相同） */
+    hash: string | null;
+    nonce: number | null;
+    gasLimit: string | null;
+    gasUsed: string | null;
+    /** 实际手续费（wei），gasUsed × effectiveGasPrice，不含 OP Stack 的 L1 数据费 */
+    fee: string | null;
+    blockNumber: number | null;
+    error: string | null;
+}
+/** 交易层面的结果（一笔交易可能对应多个调用的结果） */
+export interface TxOutcome {
+    status: WriteStatus;
+    hash: string | null;
+    nonce: number | null;
+    gasLimit: bigint | null;
+    gasUsed: bigint | null;
+    fee: bigint | null;
+    blockNumber: number | null;
+    error: string | null;
+    /** 预估失败时的 revert 数据 */
+    revertData: string | null;
+}
+/** 要发送的一笔交易 */
+export interface TxJob {
+    signer: ResolvedSigner;
+    /** 生成交易内容；nonce 是这笔交易将使用的 nonce（7702 授权签名要用），交给钱包发送时为 null */
+    build(nonce: number | null): Promise<Pick<TransactionRequest, 'to' | 'data' | 'value' | 'authorizationList'>>;
+    /** 指定 gasLimit 时不预估 */
+    gasLimit?: bigint;
+    /** 发送前失败后同一钱包后面的交易是否继续（默认 false：后面的标记为 skipped）。已发出、之后上链 revert 的不影响后面的交易 */
+    continueOnError?: boolean;
+    /** 状态变化时回调 */
+    onUpdate?(outcome: TxOutcome): void;
+}
+export interface TxFees {
+    type: 0 | 2;
+    gasPrice?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    /** 每单位 gas 最多花多少（预留余额用）：legacy 为 gasPrice，1559 为 maxFeePerGas */
+    perGas: bigint;
+}
+/** 交易费用参数：用户指定的优先，否则按节点的 getFeeData；结果缓存 30 秒，同一批交易共用 */
+export declare class FeeSource {
+    #private;
+    readonly rpc: WriteRpc;
+    readonly options: Pick<SendOptions, 'gasPrice' | 'maxFeePerGas' | 'maxPriorityFeePerGas'>;
+    constructor(rpc: WriteRpc, options?: Pick<SendOptions, 'gasPrice' | 'maxFeePerGas' | 'maxPriorityFeePerGas'>);
+    /** 固定为给定的费用，不再查节点（预留余额和实际发送要用同一个价格时） */
+    static fixed(rpc: WriteRpc, fee: TxFees): FeeSource;
+    get(): Promise<TxFees>;
+}
+/** gas 预估值乘以放大倍数（正好 21000 的普通转账不放大） */
+export declare function applyGasMultiplier(gas: bigint, multiplier?: number): bigint;
+export declare function emptyOutcome(status: WriteStatus, error?: string | null): TxOutcome;
+/** 并发数为 limit 的 map，结果按输入顺序 */
+export declare function mapPool<T, R>(items: readonly T[], limit: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;
+/**
+ * 发送一批交易：同一钱包按顺序、用本地维护的 nonce 连续发出（不等上一笔确认），不同钱包并发。
+ * 预估失败且同一钱包还有未确认的交易时，先等它们确认再重新预估一次——后一笔依赖前一笔的结果时（先 approve 再调用）自动正确处理。
+ * 返回值与 jobs 一一对应
+ */
+export declare function sendJobs(rpc: WriteRpc, jobs: readonly TxJob[], options: SendOptions, fees?: FeeSource): Promise<TxOutcome[]>;
+/** 交易结果转成调用结果（字符串 / 数字，可 JSON 序列化） */
+export declare function toWriteResult(index: number, from: string, to: string, outcome: TxOutcome): WriteResult;
+//# sourceMappingURL=send.d.ts.map

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

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

package/dist/write/send.js

@@ -0,0 +1,373 @@
+import { isError } from 'ethers';
+import { WriteRpc, failureText, revertData, signedHash } from './rpc.js';
+const FEE_TTL = 30_000;
+/** 交易费用参数：用户指定的优先，否则按节点的 getFeeData；结果缓存 30 秒，同一批交易共用 */
+export class FeeSource {
+    rpc;
+    options;
+    #cached = null;
+    constructor(rpc, options = {}) {
+        this.rpc = rpc;
+        this.options = options;
+    }
+    /** 固定为给定的费用，不再查节点（预留余额和实际发送要用同一个价格时） */
+    static fixed(rpc, fee) {
+        return new FeeSource(rpc, fee.type === 0 ? { gasPrice: fee.gasPrice } : { maxFeePerGas: fee.maxFeePerGas, maxPriorityFeePerGas: fee.maxPriorityFeePerGas });
+    }
+    get() {
+        const { gasPrice, maxFeePerGas, maxPriorityFeePerGas } = this.options;
+        if (gasPrice !== undefined) {
+            return Promise.resolve({ type: 0, gasPrice, perGas: gasPrice });
+        }
+        if (maxFeePerGas !== undefined && maxPriorityFeePerGas !== undefined) {
+            return Promise.resolve({ type: 2, maxFeePerGas, maxPriorityFeePerGas, perGas: maxFeePerGas });
+        }
+        if (!this.#cached || Date.now() - this.#cached.at > FEE_TTL) {
+            const fees = this.rpc.feeData().then((data) => toFees(data, maxFeePerGas, maxPriorityFeePerGas));
+            fees.catch(() => {
+                if (this.#cached?.fees === fees) {
+                    this.#cached = null;
+                }
+            });
+            this.#cached = { at: Date.now(), fees };
+        }
+        return this.#cached.fees;
+    }
+}
+function toFees(data, maxFee, priority) {
+    if (data.maxFeePerGas === null || data.maxPriorityFeePerGas === null) {
+        if (data.gasPrice === null) {
+            throw new Error('Unable to get gas price from the node');
+        }
+        return { type: 0, gasPrice: data.gasPrice, perGas: data.gasPrice };
+    }
+    const maxPriorityFeePerGas = priority ?? data.maxPriorityFeePerGas;
+    let maxFeePerGas = maxFee ?? data.maxFeePerGas;
+    if (maxFeePerGas < maxPriorityFeePerGas) {
+        maxFeePerGas = maxPriorityFeePerGas;
+    }
+    return { type: 2, maxFeePerGas, maxPriorityFeePerGas, perGas: maxFeePerGas };
+}
+/** gas 预估值乘以放大倍数（正好 21000 的普通转账不放大） */
+export function applyGasMultiplier(gas, multiplier = 1.2) {
+    if (gas === 21000n || multiplier <= 1) {
+        return gas;
+    }
+    return (gas * BigInt(Math.round(multiplier * 1000))) / 1000n;
+}
+export function emptyOutcome(status, error = null) {
+    return { status, hash: null, nonce: null, gasLimit: null, gasUsed: null, fee: null, blockNumber: null, error, revertData: null };
+}
+/** 并发数为 limit 的 map，结果按输入顺序 */
+export async function mapPool(items, limit, fn) {
+    const results = new Array(items.length);
+    let next = 0;
+    const worker = async () => {
+        while (next < items.length) {
+            const i = next++;
+            results[i] = await fn(items[i], i);
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(Math.max(1, limit), items.length) }, worker));
+    return results;
+}
+function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal?.aborted) {
+            resolve();
+            return;
+        }
+        const timer = setTimeout(done, ms);
+        function done() {
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', done);
+            resolve();
+        }
+        signal?.addEventListener('abort', done, { once: true });
+    });
+}
+/**
+ * 发送一批交易：同一钱包按顺序、用本地维护的 nonce 连续发出（不等上一笔确认），不同钱包并发。
+ * 预估失败且同一钱包还有未确认的交易时，先等它们确认再重新预估一次——后一笔依赖前一笔的结果时（先 approve 再调用）自动正确处理。
+ * 返回值与 jobs 一一对应
+ */
+export async function sendJobs(rpc, jobs, options, fees = new FeeSource(rpc, options)) {
+    const outcomes = jobs.map(() => emptyOutcome('skipped'));
+    const groups = new Map();
+    jobs.forEach((job, i) => {
+        const key = job.signer.address.toLowerCase();
+        const list = groups.get(key);
+        if (list) {
+            list.push(i);
+        }
+        else {
+            groups.set(key, [i]);
+        }
+    });
+    await mapPool([...groups.values()], options.concurrency ?? 8, (indexes) => sendGroup(rpc, jobs, indexes, outcomes, options, fees));
+    return outcomes;
+}
+async function sendGroup(rpc, jobs, indexes, outcomes, options, fees) {
+    const { signal, dryRun = false, wait = true } = options;
+    const first = jobs[indexes[0]];
+    const { signer, address, local } = first.signer;
+    const inFlight = [];
+    const update = (job, outcome, patch) => {
+        Object.assign(outcome, patch);
+        try {
+            job.onUpdate?.(outcome);
+        }
+        catch {
+            // 调用方的进度回调出错不能打断发送（已经发出的交易还要继续跟踪）
+        }
+    };
+    const watch = (item) => (item.watching ??= confirm(rpc, item, options, update));
+    /** 等同一钱包已发出的交易都确认（后面的调用依赖它们的结果时） */
+    const settle = async () => {
+        await Promise.all(inFlight.map(watch));
+    };
+    let nonce = null;
+    /** 上一笔带了 7702 授权：等它确认后再发下一笔 */
+    let authorized = null;
+    let stopped = false;
+    /** 浏览器钱包当前所在的链已核对过 */
+    let chainChecked = false;
+    for (const i of indexes) {
+        const job = jobs[i];
+        const outcome = outcomes[i];
+        if (authorized && !stopped && !signal?.aborted) {
+            // 自己签的授权会让账户 nonce 再加一（授权无效时不加），而且委托状态变了：等上链后重新取 nonce、重新生成
+            await settle();
+            const done = authorized.status === 'confirmed' || authorized.status === 'reverted';
+            authorized = null;
+            nonce = null;
+            if (!done) {
+                // 授权交易还没上链：之后的 nonce 不确定（上链后账户 nonce 会加 2），后面的交易发了也上不了链
+                stopped = true;
+                update(job, outcome, { status: 'skipped', error: 'skipped: the delegation transaction is not confirmed yet' });
+                continue;
+            }
+        }
+        if (stopped || signal?.aborted) {
+            update(job, outcome, { status: 'skipped', error: signal?.aborted ? 'aborted' : 'skipped: a previous call from this wallet failed' });
+            continue;
+        }
+        const fail = (error, extra = {}) => {
+            update(job, outcome, { status: 'failed', error, ...extra });
+            if (!job.continueOnError) {
+                stopped = true;
+            }
+        };
+        try {
+            if (local && nonce === null) {
+                nonce = await rpc.nonce(address);
+            }
+            let tx = await job.build(local ? nonce : null);
+            let gasLimit = job.gasLimit;
+            if (gasLimit === undefined) {
+                const estimate = () => rpc.estimateGas({ ...tx, from: address });
+                try {
+                    gasLimit = await estimate();
+                }
+                catch (err) {
+                    if (!inFlight.some((item) => item.outcome.status === 'sent')) {
+                        throw err;
+                    }
+                    // 可能依赖前面还没确认的交易：等它们确认后重新生成（7702 授权的 nonce 不变）、重新预估
+                    await settle();
+                    if (signal?.aborted) {
+                        update(job, outcome, { status: 'skipped', error: 'aborted' });
+                        continue;
+                    }
+                    tx = await job.build(local ? nonce : null);
+                    gasLimit = await estimate();
+                }
+                gasLimit = applyGasMultiplier(gasLimit, options.gasMultiplier);
+            }
+            if (dryRun) {
+                update(job, outcome, { status: 'simulated', gasLimit });
+                continue;
+            }
+            if (!local) {
+                if (!chainChecked) {
+                    // 浏览器钱包在它当前所在的链上签名发送：先确认和 Provider 是同一条链，否则会在别的链上真的转账
+                    const walletChain = await walletChainId(signer);
+                    if (walletChain !== null && walletChain !== rpc.chainId) {
+                        throw new Error(`The wallet is on chain ${walletChain}, expected ${rpc.chainId}; switch the network in the wallet first`);
+                    }
+                    chainChecked = true;
+                }
+                let hash;
+                let note = null;
+                try {
+                    // 带上 chainId：钱包（如 MetaMask）会拒绝与当前链不一致的交易
+                    hash = (await signer.sendTransaction({ ...tx, gasLimit, chainId: rpc.chainId })).hash;
+                }
+                catch (err) {
+                    // ethers 在钱包广播之后还会查一次交易，查询失败（如用户切换了网络）时错误里带着已经发出的哈希：不能报 failed
+                    const sentHash = err?.info?.sendTransactionHash;
+                    if (typeof sentHash !== 'string')
+                        throw err;
+                    hash = sentHash;
+                    note = `sent, but the wallet reported: ${failureText(err)}`;
+                }
+                update(job, outcome, { status: 'sent', hash, gasLimit, error: note });
+                inFlight.push({ job, outcome, hash, signed: null });
+            }
+            else {
+                const fee = await fees.get();
+                /** 广播结果不确定时的说明（超时、节点都连不上等）：交易可能已经进了交易池，不能报 failed（用户会重试、重复付款），按已发出继续跟踪 */
+                let uncertain = null;
+                const broadcast = async (raw) => {
+                    const result = await rpc.broadcast(raw);
+                    if (typeof result === 'object') {
+                        uncertain = result.uncertain;
+                        return 'accepted';
+                    }
+                    return result;
+                };
+                const sign = (n, request) => signer.signTransaction({
+                    ...request,
+                    ...txFeeFields(fee, request.authorizationList ? 4 : undefined),
+                    chainId: rpc.chainId,
+                    nonce: n,
+                    gasLimit,
+                });
+                let used = nonce;
+                let signed = await sign(used, tx);
+                let hash = signedHash(signed);
+                if ((await broadcast(signed)) === 'nonce-used') {
+                    // nonce 被用掉了：可能就是这笔已经上链（节点超时后换节点重发、或重复执行同一批），也可能被钱包在别处发的交易占用。
+                    // 多查几次回执（节点可能落后），确定这笔没上链才换 nonce 重发；查询出错时不确定，按已发出跟踪，绝不重发
+                    const state = await minedState(rpc, hash, options);
+                    if (state === 'unknown') {
+                        uncertain = 'nonce already used; unable to confirm whether this transaction was mined';
+                    }
+                    else if (state === 'absent') {
+                        rpc.useNonce(address, used);
+                        used = await rpc.nonce(address);
+                        tx = await job.build(used);
+                        signed = await sign(used, tx);
+                        hash = signedHash(signed);
+                        if ((await broadcast(signed)) === 'nonce-used') {
+                            rpc.useNonce(address, used);
+                            nonce = null; // 下一笔重新取 nonce
+                            fail('nonce already used by another transaction');
+                            continue;
+                        }
+                    }
+                }
+                nonce = used + 1;
+                rpc.useNonce(address, used);
+                authorized = tx.authorizationList?.length ? outcome : null;
+                update(job, outcome, { status: 'sent', hash, nonce: used, gasLimit, error: uncertain });
+                inFlight.push({ job, outcome, hash, signed });
+            }
+            const item = inFlight[inFlight.length - 1];
+            if (wait) {
+                void watch(item);
+            }
+        }
+        catch (err) {
+            if (isError(err, 'ACTION_REJECTED')) {
+                fail('rejected by user');
+                continue;
+            }
+            fail(failureText(err), { revertData: revertData(err) });
+        }
+    }
+    if (wait) {
+        await settle();
+    }
+}
+/** 浏览器钱包当前所在的链；问不到时为 null（这时靠交易里的 chainId 让钱包校验） */
+async function walletChainId(signer) {
+    const provider = signer.provider;
+    if (typeof provider?.send !== 'function')
+        return null;
+    try {
+        return Number(await provider.send('eth_chainId', []));
+    }
+    catch {
+        return null;
+    }
+}
+/** 这笔交易有没有上链：多查几次回执（节点可能落后）。查到为 'mined'；每次都成功查询但都没有为 'absent'；有查询出错为 'unknown' */
+async function minedState(rpc, hash, options) {
+    let errors = 0;
+    for (let i = 0; i < 5; i++) {
+        if (i > 0)
+            await sleep(options.pollInterval ?? 2_000, options.signal);
+        // 已取消：不再发新交易，也就不需要判断是否换 nonce 重发；没查够几轮也不能断定没上链
+        if (options.signal?.aborted)
+            return 'unknown';
+        try {
+            if (await rpc.receipt(hash))
+                return 'mined';
+        }
+        catch {
+            errors++;
+        }
+    }
+    return errors ? 'unknown' : 'absent';
+}
+/** 7702 授权交易（type 4）也必须用 1559 费用字段 */
+function txFeeFields(fee, type) {
+    if (type === 4) {
+        return fee.type === 2
+            ? { type: 4, maxFeePerGas: fee.maxFeePerGas, maxPriorityFeePerGas: fee.maxPriorityFeePerGas }
+            : { type: 4, maxFeePerGas: fee.gasPrice, maxPriorityFeePerGas: fee.gasPrice };
+    }
+    return fee.type === 2 ? { type: 2, maxFeePerGas: fee.maxFeePerGas, maxPriorityFeePerGas: fee.maxPriorityFeePerGas } : { type: 0, gasPrice: fee.gasPrice };
+}
+/** 轮询回执直到确认 / 超时 / 取消；等待期间定期重发原交易 */
+async function confirm(rpc, item, options, update) {
+    const { timeout = 180_000, pollInterval = 2_000, signal } = options;
+    const deadline = Date.now() + timeout;
+    let polls = 0;
+    while (!signal?.aborted) {
+        let receipt = null;
+        try {
+            receipt = await rpc.receipt(item.hash);
+        }
+        catch {
+            // 节点暂时出错：下次再查
+        }
+        if (receipt) {
+            update(item.job, item.outcome, {
+                status: receipt.status === 1 ? 'confirmed' : 'reverted',
+                gasUsed: receipt.gasUsed,
+                fee: receipt.fee,
+                blockNumber: receipt.blockNumber,
+                error: receipt.status === 1 ? null : 'execution reverted',
+            });
+            return;
+        }
+        if (Date.now() >= deadline) {
+            const note = `not confirmed within ${timeout}ms`;
+            update(item.job, item.outcome, { status: 'pending', error: item.outcome.error ? `${item.outcome.error}; ${note}` : note });
+            return;
+        }
+        if (item.signed && ++polls % 5 === 0) {
+            void rpc.broadcast(item.signed).catch(() => { });
+        }
+        await sleep(Math.min(pollInterval, Math.max(0, deadline - Date.now())), signal);
+    }
+}
+/** 交易结果转成调用结果（字符串 / 数字，可 JSON 序列化） */
+export function toWriteResult(index, from, to, outcome) {
+    return {
+        index,
+        from,
+        to,
+        status: outcome.status,
+        hash: outcome.hash,
+        nonce: outcome.nonce,
+        gasLimit: outcome.gasLimit?.toString() ?? null,
+        gasUsed: outcome.gasUsed?.toString() ?? null,
+        fee: outcome.fee?.toString() ?? null,
+        blockNumber: outcome.blockNumber,
+        error: outcome.error,
+    };
+}
+//# sourceMappingURL=send.js.map

package/dist/write/send.js.map

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

package/dist/write/signer.d.ts

@@ -0,0 +1,58 @@
+import { type Authorization, type AuthorizationRequest, type TransactionRequest } from 'ethers';
+/**
+ * 发交易的钱包，两种都可以：
+ * - 私钥字符串（0x 开头的 32 字节十六进制），内部用 ethers BaseWallet 在本地签名
+ * - ethers Signer：Wallet / HDNodeWallet 等能本地签名的（signTransaction），
+ *   或浏览器钱包的 JsonRpcSigner（`await new BrowserProvider(window.ethereum).getSigner()`，由钱包签名并发送，每笔需要用户确认）
+ */
+export type SignerInput = string | WriteSigner | TronSigner | TronWalletLike;
+/**
+ * Tron 浏览器钱包：注入的 tronWeb（`window.tronWeb`，TronLink / OKX 等），或 @tronweb3/tronwallet-adapter 的 adapter。
+ * 每笔交易钱包弹一次确认（Tron 钱包不支持一次签多笔）
+ */
+export type TronWalletLike = {
+    defaultAddress?: {
+        base58?: string | boolean;
+    };
+    trx: {
+        sign(transaction: any): Promise<any>;
+    };
+} | {
+    address: string | null;
+    signTransaction(transaction: any): Promise<any>;
+};
+/**
+ * Tron 上的自定义签名器：对交易 ID（32 字节摘要，0x 开头）做 secp256k1 签名，返回 65 字节签名（r、s、v）的十六进制。
+ * 用于 KMS / 硬件钱包等；Tron 上私钥和 ethers Wallet 也可以直接传
+ */
+export interface TronSigner {
+    /** T 开头或 0x 格式的地址 */
+    address: string;
+    signDigest(digest: string): Promise<string>;
+}
+/** 只用到 ethers Signer 的这几个方法 */
+export interface WriteSigner {
+    getAddress(): Promise<string>;
+    /** 本地签名（Wallet 等）。浏览器钱包不支持，改用 sendTransaction */
+    signTransaction?(tx: TransactionRequest): Promise<string>;
+    /** 由钱包签名并广播（浏览器钱包），返回交易哈希 */
+    sendTransaction?(tx: TransactionRequest): Promise<{
+        hash: string;
+    }>;
+    /** EIP-7702 授权签名（ethers Wallet 支持；'7702' 模式需要） */
+    authorize?(auth: AuthorizationRequest): Promise<Authorization>;
+}
+/** 归一化后的钱包 */
+export interface ResolvedSigner {
+    address: string;
+    signer: WriteSigner;
+    /** true：本地签名，自己管 nonce、可以重发；false：交给钱包发送（浏览器钱包） */
+    local: boolean;
+}
+export declare function isPrivateKey(value: unknown): value is string;
+/**
+ * 把输入归一化成钱包；同一个私钥 / Signer 对象只解析一次（cache 由调用方按批次传入）。
+ * 私钥格式不对时抛错，错误信息里不带私钥内容
+ */
+export declare function resolveSigner(input: SignerInput, cache?: Map<SignerInput, Promise<ResolvedSigner>>): Promise<ResolvedSigner>;
+//# sourceMappingURL=signer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../../src/write/signer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqD,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AAElJ;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,cAAc,CAAA;AAE5E;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,cAAc,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAAC,GAAG,EAAE;QAAE,IAAI,CAAC,WAAW,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAA;CAAE,GACjG;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,eAAe,CAAC,WAAW,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;CAAE,CAAA;AAE/E;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CAC5C;AAED,+BAA+B;AAC/B,MAAM,WAAW,WAAW;IAC1B,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7B,iDAAiD;IACjD,eAAe,CAAC,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACzD,6BAA6B;IAC7B,eAAe,CAAC,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACnE,kDAAkD;IAClD,SAAS,CAAC,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;CAC/D;AAED,cAAc;AACd,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,WAAW,CAAA;IACnB,mDAAmD;IACnD,KAAK,EAAE,OAAO,CAAA;CACf;AAID,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE5D;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,GAAE,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,cAAc,CAAC,CAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAO7I"}

package/dist/write/signer.js

@@ -0,0 +1,41 @@
+import { BaseWallet, JsonRpcSigner, SigningKey, getAddress } from 'ethers';
+const PRIVATE_KEY_RE = /^(0x)?[0-9a-fA-F]{64}$/;
+export function isPrivateKey(value) {
+    return typeof value === 'string' && PRIVATE_KEY_RE.test(value);
+}
+/**
+ * 把输入归一化成钱包；同一个私钥 / Signer 对象只解析一次（cache 由调用方按批次传入）。
+ * 私钥格式不对时抛错，错误信息里不带私钥内容
+ */
+export async function resolveSigner(input, cache = new Map()) {
+    let resolved = cache.get(input);
+    if (!resolved) {
+        resolved = toSigner(input);
+        cache.set(input, resolved);
+    }
+    return resolved;
+}
+async function toSigner(input) {
+    if (typeof input === 'string') {
+        if (!isPrivateKey(input)) {
+            throw new Error('Invalid private key: expected 32 bytes of hex');
+        }
+        // BaseWallet 而不是 Wallet：Wallet 带 JSON keystore 加解密（scrypt / AES），打包体积大很多，这里用不到
+        const wallet = new BaseWallet(new SigningKey(input.startsWith('0x') ? input : `0x${input}`));
+        return { address: wallet.address, signer: wallet, local: true };
+    }
+    if (!input || typeof input.getAddress !== 'function') {
+        throw new Error('Invalid signer: expected a private key or an ethers Signer');
+    }
+    return fromEthersSigner(input);
+}
+async function fromEthersSigner(input) {
+    const address = getAddress(await input.getAddress());
+    // JsonRpcSigner 的 signTransaction 走 eth_signTransaction，浏览器钱包基本都不支持，只能让钱包自己发送
+    const local = typeof input.signTransaction === 'function' && !(input instanceof JsonRpcSigner);
+    if (!local && typeof input.sendTransaction !== 'function') {
+        throw new Error('Signer must implement signTransaction or sendTransaction');
+    }
+    return { address, signer: input, local };
+}
+//# sourceMappingURL=signer.js.map

package/dist/write/signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.js","sourceRoot":"","sources":["../../src/write/signer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAA0E,MAAM,QAAQ,CAAA;AA+ClJ,MAAM,cAAc,GAAG,wBAAwB,CAAA;AAE/C,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAkB,EAAE,QAAmD,IAAI,GAAG,EAAE;IAClH,IAAI,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC/B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC1B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IAC5B,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,KAAkB;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;QAClE,CAAC;QACD,+EAA+E;QAC/E,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAA;QAC5F,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IACjE,CAAC;IACD,IAAI,CAAC,KAAK,IAAI,OAAQ,KAAqB,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAA;IAC/E,CAAC;IACD,OAAO,gBAAgB,CAAC,KAAoB,CAAC,CAAA;AAC/C,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,KAAkB;IAChD,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC,CAAA;IACpD,8EAA8E;IAC9E,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,eAAe,KAAK,UAAU,IAAI,CAAC,CAAC,KAAK,YAAY,aAAa,CAAC,CAAA;IAC9F,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;IAC7E,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;AAC1C,CAAC"}