@w3lib/evm-batch-call 0.6.0 → 0.8.0

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":""}

package/dist/risk.d.ts

@@ -0,0 +1,42 @@
+import { type LpProtocol } from './lp.js';
+import type { Provider } from './provider.js';
+export type ProbeStage = 'ok' | 'buy-failed' | 'transfer-failed' | 'approve-failed' | 'sell-failed';
+export interface TokenRisk {
+    token: string;
+    /** 模拟用的 V2 协议和池子（代币 / 包装主币里包装主币一侧最深的）；没有池子时为 null */
+    protocol: string | null;
+    pool: string | null;
+    /** 模拟到哪一步：ok 全部成功；buy-failed 买不进（可能还没开放交易、限制了合约地址）；sell-failed 卖不出（貔貅盘） */
+    stage: ProbeStage | null;
+    /** 卖不出，或卖出税 ≥ 90% */
+    honeypot: boolean | null;
+    /** 税率（0~1）：实际数量比 Router 报价少多少；对应的步骤没跑到时为 null */
+    buyTax: number | null;
+    sellTax: number | null;
+    transferTax: number | null;
+    /** 买入 / 卖出消耗的 gas（异常高可能有额外逻辑） */
+    buyGas: number | null;
+    sellGas: number | null;
+    /** EIP-1967 代理的实现合约（可升级：规则以后可以改）；不是代理时为 null */
+    implementation: string | null;
+    /** owner()：没有这个方法时为 null；零地址表示已放弃 */
+    owner: string | null;
+    /** 汇总的风险标记：honeypot、cannot-buy、high-buy-tax / high-sell-tax / high-transfer-tax（> 10%）、has-tax（> 0.5%）、proxy、owned、no-pool */
+    flags: string[];
+}
+export interface TokenRiskOptions {
+    /** 模拟买入用的主币数量（最小单位），默认包装主币储备的 1 / 1000，最多 1 个主币 */
+    amount?: bigint;
+    /** 用哪些 V2 协议的池子，默认这条链内置表里有 Router 的 V2 协议 */
+    protocols?: readonly LpProtocol[];
+}
+/**
+ * 检查代币的风险（每个代币一次模拟的 eth_call，加上一次 multicall 找池子、读 owner）。
+ *
+ * ```ts
+ * const [risk] = await tokenRisks(provider, [token])
+ * // { stage: 'ok', honeypot: false, buyTax: 0.05, sellTax: 0.05, transferTax: 0, flags: ['has-tax', 'owned'], … }
+ * ```
+ */
+export declare function tokenRisks(provider: Provider, tokens: readonly string[], options?: TokenRiskOptions): Promise<TokenRisk[]>;
+//# sourceMappingURL=risk.d.ts.map

package/dist/risk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk.d.ts","sourceRoot":"","sources":["../src/risk.ts"],"names":[],"mappings":"AAOA,OAAO,EAAiC,KAAK,UAAU,EAAE,MAAM,SAAS,CAAA;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAK7C,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,YAAY,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,aAAa,CAAA;AAEnG,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,qDAAqD;IACrD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,2EAA2E;IAC3E,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IACxB,qBAAqB;IACrB,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAA;IACxB,iDAAiD;IACjD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,iCAAiC;IACjC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,gDAAgD;IAChD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,qCAAqC;IACrC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,8HAA8H;IAC9H,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,SAAS,CAAC,EAAE,SAAS,UAAU,EAAE,CAAA;CAClC;AAaD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAgFpI"}

package/dist/risk.js

@@ -0,0 +1,134 @@
+/**
+ * 代币风险检查（子路径 `@w3lib/evm-batch-call/risk`）：在 eth_call 里模拟“买入 → 转账 → 卖出”（deployless 的探测合约，不部署、不发交易），
+ * 算出买入税、转账税、卖出税，判断能不能卖（貔貅盘）；另外看合约是不是可升级的代理、owner 有没有放弃。
+ * 只能检查在内置 V2 协议里有 代币 / 包装主币 池子的代币；Tron 不支持
+ */
+import { AbiCoder, Interface, concat } from 'ethers';
+import { LP_PROTOCOLS, LP_QUOTE_TOKENS } from './lp.js';
+import { TOKEN_PROBE_BYTECODE } from './tokenProbe.js';
+import { isExecutionError } from './errors.js';
+import { isTronChain } from './tron.js';
+const coder = AbiCoder.defaultAbiCoder();
+const factoryInterface = new Interface(['function getPair(address tokenA, address tokenB) view returns (address)']);
+const pairInterface = new Interface(['function token0() view returns (address)', 'function getReserves() view returns (uint112 reserve0, uint112 reserve1, uint32 blockTimestampLast)']);
+const ownerInterface = new Interface(['function owner() view returns (address)']);
+/** EIP-1967 的实现合约槽位：bytes32(uint256(keccak256('eip1967.proxy.implementation')) - 1) */
+const IMPLEMENTATION_SLOT = '0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc';
+const STAGES = ['ok', 'buy-failed', 'transfer-failed', 'approve-failed', 'sell-failed'];
+const ZERO = '0x0000000000000000000000000000000000000000';
+/**
+ * 检查代币的风险（每个代币一次模拟的 eth_call，加上一次 multicall 找池子、读 owner）。
+ *
+ * ```ts
+ * const [risk] = await tokenRisks(provider, [token])
+ * // { stage: 'ok', honeypot: false, buyTax: 0.05, sellTax: 0.05, transferTax: 0, flags: ['has-tax', 'owned'], … }
+ * ```
+ */
+export async function tokenRisks(provider, tokens, options = {}) {
+    const chainId = await provider.getChainId();
+    if (isTronChain(chainId))
+        throw new Error('tokenRisks is not supported on Tron');
+    const wrapped = LP_QUOTE_TOKENS[chainId]?.[0];
+    const protocols = (options.protocols ?? LP_PROTOCOLS.filter((p) => p.chainId === chainId)).filter((p) => p.version === 'v2' && p.router && p.factory);
+    if (!wrapped || !protocols.length)
+        throw new Error(`No V2 protocol with a router on chain ${chainId}`);
+    // 1. 每个代币在每个 V2 协议里和包装主币的池子，以及 owner()
+    const pairCalls = tokens.flatMap((t) => protocols.map((p) => provider.contract(p.factory, factoryInterface).getPair(t, wrapped)));
+    const ownerCalls = tokens.map((t) => provider.contract(t, ownerInterface).owner());
+    const first = await provider.tryAll([...pairCalls, ...ownerCalls]);
+    const pairs = first.slice(0, pairCalls.length);
+    const owners = first.slice(pairCalls.length);
+    const found = pairs.flatMap((pair, i) => (pair && pair.toLowerCase() !== ZERO ? [{ i, pair }] : []));
+    const reserves = found.length
+        ? await provider.tryAll(found.flatMap(({ pair }) => [provider.contract(pair, pairInterface).token0(), provider.contract(pair, pairInterface).getReserves()]))
+        : [];
+    // 每个代币：包装主币一侧最深的池子
+    const best = tokens.map(() => null);
+    found.forEach(({ i, pair }, k) => {
+        const token0 = reserves[k * 2];
+        const r = reserves[k * 2 + 1];
+        if (!token0 || !r)
+            return;
+        const wrappedReserve = token0.toLowerCase() === wrapped.toLowerCase() ? r[0] : r[1];
+        const t = Math.floor(i / protocols.length);
+        const current = best[t];
+        if (wrappedReserve > 0n && (!current || wrappedReserve > current.wrappedReserve))
+            best[t] = { protocol: protocols[i % protocols.length], pair, wrappedReserve };
+    });
+    const { runOnNodes } = await import('./write/rpc.js');
+    const node = (method, fn, isFinal) => runOnNodes(provider.rpc, method, (n) => fn(n), isFinal);
+    const ONE = 10n ** 18n;
+    return Promise.all(tokens.map(async (token, t) => {
+        const pick = best[t];
+        const owner = owners[t] ?? null;
+        const implementation = await node('getStorage', (n) => (n.getStorage ? n.getStorage(token, IMPLEMENTATION_SLOT) : Promise.resolve('0x')))
+            .then((slot) => (slot && BigInt(slot) !== 0n ? `0x${slot.slice(-40)}` : null))
+            .catch(() => null);
+        const base = { token, implementation, owner, buyTax: null, sellTax: null, transferTax: null, buyGas: null, sellGas: null };
+        if (!pick)
+            return { ...base, protocol: null, pool: null, stage: null, honeypot: null, flags: flagsOf({ ...base, stage: null, honeypot: null }, true) };
+        const amount = options.amount ?? min(pick.wrappedReserve / 1000n, ONE);
+        // deployless：没有 to 的 eth_call 执行构造函数；从包装主币合约发起（它持有大量主币，eth_call 不需要签名）
+        const data = concat([TOKEN_PROBE_BYTECODE, coder.encode(['address', 'address', 'address'], [pick.protocol.router, token, pick.pair])]);
+        let decoded = null;
+        try {
+            // 探测合约自己不会 revert（每一步都 try）；执行出错（如买入时代币合约把调用方拒之门外导致整体 revert）算买不进，
+            // 节点、网络、限频的错误照常抛出，不当成代币的风险
+            const out = await node('call', (n) => n.call({ from: wrapped, data, value: amount }), isExecutionError);
+            decoded = coder.decode(new Array(11).fill('uint256'), out).toArray();
+        }
+        catch (err) {
+            if (!isExecutionError(err))
+                throw err;
+            decoded = null;
+        }
+        if (!decoded) {
+            const failed = { ...base, protocol: pick.protocol.id, pool: pick.pair, stage: 'buy-failed', honeypot: null };
+            return { ...failed, flags: flagsOf(failed, false) };
+        }
+        const [stageIndex, buyQuote, bought, transferSent, transferReceived, sellAmount, sellQuote, sold, buyGas, sellGas, pairReceived] = decoded;
+        const stage = STAGES[Number(stageIndex)] ?? 'buy-failed';
+        const tax = (actual, expected) => (expected > 0n ? Math.max(0, 1 - Number((actual * 1000000n) / expected) / 1_000_000) : null);
+        const result = {
+            ...base,
+            protocol: pick.protocol.id,
+            pool: pick.pair,
+            stage,
+            buyTax: stage === 'buy-failed' ? null : tax(bought, buyQuote),
+            transferTax: stage === 'ok' || stage === 'approve-failed' || stage === 'sell-failed' ? tax(transferReceived, transferSent) : null,
+            // 卖出税：池子实际收到的代币（转账时扣的税，精确），和实际换回的主币比报价少多少（有的代币卖出时顺便把收来的税也卖进同一个池子，
+            // 池子那边看不出来），取较大的
+            sellTax: stage === 'ok' ? Math.max(tax(pairReceived, sellAmount) ?? 0, tax(sold, sellQuote) ?? 0) : null,
+            buyGas: stage === 'buy-failed' ? null : Number(buyGas),
+            sellGas: stage === 'ok' ? Number(sellGas) : null,
+            honeypot: stage === 'sell-failed' || stage === 'transfer-failed' || stage === 'approve-failed' ? true : stage === 'ok' ? (tax(sold, sellQuote) ?? 0) >= 0.9 : null,
+        };
+        return { ...result, flags: flagsOf(result, false) };
+    }));
+}
+const min = (a, b) => (a < b ? a : b);
+function flagsOf(r, noPool) {
+    const flags = [];
+    if (noPool)
+        flags.push('no-pool');
+    if (r.honeypot)
+        flags.push('honeypot');
+    if (r.stage === 'buy-failed')
+        flags.push('cannot-buy');
+    for (const [name, value] of [
+        ['buy', r.buyTax],
+        ['sell', r.sellTax],
+        ['transfer', r.transferTax],
+    ]) {
+        if (value !== null && value > 0.1)
+            flags.push(`high-${name}-tax`);
+    }
+    if ([r.buyTax, r.sellTax, r.transferTax].some((v) => v !== null && v > 0.005))
+        flags.push('has-tax');
+    if (r.implementation)
+        flags.push('proxy');
+    if (r.owner && r.owner.toLowerCase() !== ZERO)
+        flags.push('owned');
+    return flags;
+}
+//# sourceMappingURL=risk.js.map

package/dist/risk.js.map

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

package/dist/rpcNodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rpcNodes.d.ts","sourceRoot":"","sources":["../src/rpcNodes.ts"],"names":[],"mappings":"AAGA,gCAAgC;AAChC,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAqLxE,CAAA;AAED,6CAA6C;AAC7C,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAK/C,CAAA"}
+{"version":3,"file":"rpcNodes.d.ts","sourceRoot":"","sources":["../src/rpcNodes.ts"],"names":[],"mappings":"AAGA,gCAAgC;AAChC,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAuMxE,CAAA;AAED,6CAA6C;AAC7C,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAK/C,CAAA"}

package/dist/rpcNodes.js

@@ -182,6 +182,24 @@ export const DEFAULT_RPC_URLS = {
         'https://rpc-qnd.inkonchain.com',
         'https://ink.api.pocket.network',
     ],
+    // 星空链（Starry）
+    202308: [
+        'https://rpc.starryscan.com',
+    ],
+    // conflux
+    1030: [
+        'https://evm.confluxrpc.com',
+    ],
+    // injective
+    1776: [
+        'https://sentry.evm-rpc.injective.network',
+        'https://injectiveevm-rpc.polkachu.com',
+    ],
+    // pharos
+    1672: [
+        'https://rpc.pharos.xyz',
+        'https://infra.originstake.com/pharos/evm',
+    ],
 };
 /** Tron 主网全节点 HTTP API（均支持跨域与 deployless） */
 export const DEFAULT_TRON_HOSTS = [

package/dist/rpcNodes.js.map

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

package/dist/simulate.d.ts

@@ -0,0 +1,186 @@
+/**
+ * 交易模拟（子路径 `@w3lib/evm-batch-call/simulate`）：发送前先看会发生什么——成不成功、花多少 gas、哪些资产进出、给了什么授权、风险提示。
+ *
+ * - EVM：`eth_simulateV1`（公共节点 publicnode / drpc / mainnet.base.org / bsc-dataseed 等都支持）：一次请求执行一串交易、状态逐笔延续，
+ *   `traceTransfers` 把主币转账也变成日志；资产变化和授权变化都从日志里算（ERC20 / 721 / 1155 Transfer、WETH Deposit / Withdrawal、Approval、
+ *   ApprovalForAll、Permit2 Approval）。不支持时退回 `eth_call` + `eth_estimateGas`：只能知道成不成功和 gas，资产变化只能按 calldata 估
+ * - Tron：`triggerconstantcontract`（能量、日志里的 TRC20 Transfer / Approval）；TRX 的变化只有 call_value
+ */
+import { type BigNumberish } from 'ethers';
+import type { BlockTag } from './aggregate.js';
+import type { Provider } from './provider.js';
+import { type DecodedCall } from './simulateDecode.js';
+export { decodeCalldata, decodeRevert, type DecodedCall, type DecodedType } from './simulateDecode.js';
+/** 要模拟的交易，字段与 buildSwap / buildRevokes / 流动性构建的 transactions 里的一致（多出来的字段忽略） */
+export interface SimulateTx {
+    from?: string;
+    to?: string;
+    data?: string;
+    /** 附带的主币（最小单位；Tron 是 sun） */
+    value?: BigNumberish;
+    gas?: BigNumberish;
+}
+/** 状态覆盖（eth_call / eth_simulateV1 的格式）：改余额、nonce、代码、存储 */
+export type StateOverrides = Record<string, {
+    balance?: string;
+    nonce?: string;
+    code?: string;
+    state?: Record<string, string>;
+    stateDiff?: Record<string, string>;
+}>;
+export interface SimulateOptions {
+    /** 发送者（交易里没有 from 时用），也是资产变化 / 授权变化的主体 */
+    from?: string;
+    /** 另外要统计资产变化、授权的地址（默认只有 from） */
+    watch?: readonly string[];
+    /** 按这个区块的状态模拟（默认最新） */
+    blockTag?: BlockTag;
+    stateOverrides?: StateOverrides;
+    /** 每笔交易的 gas 上限，默认 min(1000 万, 2500 万 / 笔数)：不同节点限制一个模拟里的总 gas */
+    gas?: bigint;
+    /** 估算手续费（gasUsed × 当前 gas 价格；不含 L1 数据费），默认 true */
+    fee?: boolean;
+    /** 给资产变化带美元价值（用 /price，按需加载）：true 用默认价格源，或传 tokenPrices 的 sources */
+    usd?: boolean | import('./price.js').TokenPricesOptions['sources'];
+    /** 对收到的代币做风险检查（用 /risk，按需加载，只支持 EVM 的 V2 池子能买卖的代币），有问题时加进 warnings */
+    risk?: boolean;
+    /** 不用 eth_simulateV1，直接 eth_call + estimateGas（调试 / 节点行为不一致时） */
+    forceCall?: boolean;
+}
+export type WarningSeverity = 'info' | 'warn' | 'danger';
+export interface SimulationWarning {
+    severity: WarningSeverity;
+    /**
+     * unlimited-approval / unknown-spender / approve-to-eoa / unlimited-nft-approval / no-code / large-value /
+     * token-risk / unknown-method / no-logs / no-state / reverted
+     */
+    code: string;
+    message: string;
+    /** 相关地址：授权类提示是被授权方，token-risk 是代币 */
+    address?: string;
+}
+export interface BalanceChange {
+    address: string;
+    /** 代币地址；主币是 'native' */
+    asset: string;
+    symbol: string | null;
+    decimals: number;
+    /** 带符号的最小单位数量 */
+    delta: string;
+    formatted: string;
+    usd?: number | null;
+    /** NFT（721 / 1155）：tokenId，数量是个数 */
+    tokenId?: string;
+    standard: 'native' | 'erc20' | 'erc721' | 'erc1155';
+}
+export interface ApprovalChange {
+    type: 'erc20' | 'permit2' | 'nft' | 'nft-token';
+    owner: string;
+    /** 代币 / NFT 合约 */
+    token: string;
+    symbol: string | null;
+    /** 被授权方（ERC20 的 spender、Permit2 的 spender、NFT 的 operator / approved） */
+    spender: string;
+    spenderName?: string;
+    /** 新的额度（最小单位）；NFT 的 ApprovalForAll 是 '1' / '0'，单个 NFT 是 tokenId */
+    amount: string;
+    unlimited: boolean;
+    /** 授权被取消（额度 0 / setApprovalForAll false） */
+    revoked: boolean;
+    /** Permit2：授权到期的时间（秒） */
+    expiration?: number;
+}
+/** 一条转账（所有地址之间的，不只是 from 的） */
+export interface SimulatedTransfer {
+    asset: string;
+    from: string;
+    to: string;
+    amount: string;
+    tokenId?: string;
+    standard: BalanceChange['standard'];
+}
+export interface SimulationResult {
+    success: boolean;
+    /** 失败原因：解码后的 revert 原因（Error / Panic / 常见自定义错误）或节点给的错误信息 */
+    error?: string;
+    /** revert 的原始数据 */
+    revertData?: string;
+    /** 消耗的 gas（Tron 是能量） */
+    gasUsed: string;
+    /** 估算的手续费（wei），不含 L1 数据费；Tron 没有 */
+    fee?: string;
+    balanceChanges: BalanceChange[];
+    approvalChanges: ApprovalChange[];
+    decoded: {
+        type: DecodedCall['type'];
+        protocol?: string;
+        method?: string;
+        summary: string;
+        args?: Record<string, unknown>;
+        calls?: DecodedCall[];
+    };
+    warnings: SimulationWarning[];
+    transfers: SimulatedTransfer[];
+    /** 原始日志 */
+    logs?: Array<{
+        address: string;
+        topics: string[];
+        data: string;
+    }>;
+    /** 用的模拟方式：'simulateV1'（有日志）、'eth_call'（只有成败和 gas）、'tron' */
+    mode: 'simulateV1' | 'eth_call' | 'tron';
+    returnData?: string;
+}
+export interface BatchSimulationResult {
+    /** 全部成功 */
+    success: boolean;
+    /** 每笔交易的结果，与输入一一对应 */
+    results: SimulationResult[];
+    /** 第一笔失败的下标 */
+    failedIndex?: number;
+    gasUsed: string;
+    fee?: string;
+    /** 汇总（同一个资产、同一个地址的变化相加；授权取最后的状态） */
+    balanceChanges: BalanceChange[];
+    approvalChanges: ApprovalChange[];
+    warnings: SimulationWarning[];
+    mode: SimulationResult['mode'];
+}
+/**
+ * 模拟一笔交易（不签名、不发送）。可以直接传 `buildSwap` / `buildRevokes` / 流动性构建里的交易。
+ *
+ * ```ts
+ * const plan = await buildSwap(provider, user, { tokenIn, tokenOut, amountInFormatted: '1' })
+ * const sim = await simulate(provider, plan.transactions[1], { from: user })      // 兑换这一笔（授权在前，没发出去时用 simulateBatch）
+ * if (!sim.success) throw new Error(sim.error)
+ * sim.balanceChanges   // [{ asset: 'native', delta: '-1000…', formatted: '-1', … }, { asset: USDC, formatted: '2300.5', … }]
+ * sim.warnings         // [{ severity: 'warn', code: 'unknown-spender', … }]
+ * ```
+ */
+export declare function simulate(provider: Provider, tx: SimulateTx, options?: SimulateOptions): Promise<SimulationResult>;
+/**
+ * 按顺序模拟一串依赖前一笔的交易（如先 approve 再兑换：`plan.transactions`）。eth_simulateV1 在同一个区块里依次执行，状态延续；
+ * 不支持的节点退回单笔 eth_call，后面的交易看不到前面的结果（结果里有 `no-state` 提示；Tron 同理）。
+ *
+ * ```ts
+ * const sim = await simulateBatch(provider, plan.transactions, { from: user, usd: true })
+ * sim.success; sim.balanceChanges   // 汇总：整个流程你付出 / 收到什么
+ * ```
+ */
+export declare function simulateBatch(provider: Provider, txs: readonly SimulateTx[] | {
+    transactions: readonly SimulateTx[];
+}, options?: SimulateOptions): Promise<BatchSimulationResult>;
+/**
+ * 模拟通过才发送的一行守卫：`simulate` 失败或有 danger 级别的提示时抛错，否则返回模拟结果，由调用方继续发送。
+ *
+ * ```ts
+ * await assertSimulation(simulate(provider, tx, { from }))
+ * await batchCall(provider, key, [{ to: tx.to, data: tx.data, value: tx.value }])
+ * ```
+ */
+export declare function assertSimulation<T extends Pick<SimulationResult, 'success' | 'error' | 'warnings'> | Pick<BatchSimulationResult, 'success' | 'warnings'> & {
+    results: Array<Pick<SimulationResult, 'error'>>;
+}>(simulation: Promise<T> | T, options?: {
+    allowDanger?: boolean;
+}): Promise<T>;
+//# sourceMappingURL=simulate.d.ts.map

package/dist/simulate.d.ts.map

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