@w3lib/evm-batch-call 0.7.0 → 0.8.0

package/dist/subpaths/history.js

@@ -0,0 +1,23 @@
+/**
+ * 交易历史（子路径 `@w3lib/evm-batch-call/history`）：一个地址的转账 / 兑换 / 授权 / 流动性 / 铸造记录，带解码后的类型、资产变化和手续费。
+ * 数据来源可替换、可故障切换：Blockscout（免 Key，默认）、Etherscan v2（传 apiKey）、纯 RPC 日志、Tron 的 TronGrid。
+ * 不放在主入口，不用时打包不会带上这部分代码。
+ *
+ * ```ts
+ * import { getHistory } from '@w3lib/evm-batch-call/history'
+ *
+ * const page = await getHistory(user, { chainId: 1, limit: 20 })
+ * const more = await getHistory(user, { chainId: 1, cursor: page.nextCursor, types: ['swap'] })
+ * await getHistory(user, { chainId: 56, source: ['etherscan', 'rpc'], apiKey })
+ * ```
+ */
+import { history } from '../history.js';
+import { resolve } from '../shortcuts.js';
+export { HistorySourceError, buildActivities, history, } from '../history.js';
+export { BLOCKSCOUT_APIS, blockscoutSource, etherscanSource, explorerSource, rpcSource, trongridSource } from '../historySources.js';
+/** 查一个地址的历史活动，节点参数与 getBalances 相同（只有 rpc 来源会用到节点） */
+export function getHistory(address, options = {}) {
+    const { provider, own } = resolve(options, ['source', 'apiKey', 'limit', 'cursor', 'types', 'before', 'after', 'nft', 'maxPages', 'fetch']);
+    return history(provider, address, own);
+}
+//# sourceMappingURL=history.js.map

package/dist/subpaths/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/subpaths/history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,OAAO,EAA2C,MAAM,eAAe,CAAA;AAChF,OAAO,EAAE,OAAO,EAAgC,MAAM,iBAAiB,CAAA;AAEvE,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,OAAO,GAYR,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,SAAS,EAAE,cAAc,EAAqD,MAAM,sBAAsB,CAAA;AAIvL,sDAAsD;AACtD,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,UAA6B,EAAE;IACzE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAA;IAC3I,OAAO,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,CAAA;AACxC,CAAC"}

package/dist/subpaths/permit.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 免 gas 授权（子路径 `@w3lib/evm-batch-call/permit`）：EIP-2612 permit、DAI 风格 permit、Permit2（PermitSingle / PermitBatch / permitTransferFrom）。
+ * 构建 EIP-712 数据 → 用 ethers Signer 签名 → 本地验证 → 生成上链的 calldata。不放在主入口，不用时打包不会带上。
+ *
+ * ```ts
+ * import { buildPermit, signPermit, permitCalldata } from '@w3lib/evm-batch-call/permit'
+ *
+ * const permit = await buildPermit(provider, { token: USDC, owner, spender: router, value: 100_000_000n }) // 精确额度，30 分钟有效
+ * const signed = await signPermit(signer, permit)      // signer：Wallet / 浏览器钱包的 JsonRpcSigner
+ * const data = permitCalldata(signed)                  // token.permit(...) 的 calldata，谁都可以提交
+ * ```
+ */
+export { DEFAULT_PERMIT_DEADLINE, MAX_PERMIT_DEADLINE, MAX_UINT160, PERMIT2_ADDRESS, assertPermitSafe, buildPermit, buildPermit2Batch, buildPermit2Single, buildPermit2Transfer, detectPermit, permit2Calldata, permitCalldata, permitTransferFromCalldata, signPermit, verifyPermitSignature, type BuildPermitParams, type Permit, type Permit2AllowanceParams, type Permit2BatchParams, type Permit2TransferParams, type PermitKind, type PermitOptions, type PermitSupport, type SignedPermit, type TypedData, } from '../permit.js';
+//# sourceMappingURL=permit.d.ts.map

package/dist/subpaths/permit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permit.d.ts","sourceRoot":"","sources":["../../src/subpaths/permit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,0BAA0B,EAC1B,UAAU,EACV,qBAAqB,EACrB,KAAK,iBAAiB,EACtB,KAAK,MAAM,EACX,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,SAAS,GACf,MAAM,cAAc,CAAA"}

package/dist/subpaths/permit.js

@@ -0,0 +1,14 @@
+/**
+ * 免 gas 授权（子路径 `@w3lib/evm-batch-call/permit`）：EIP-2612 permit、DAI 风格 permit、Permit2（PermitSingle / PermitBatch / permitTransferFrom）。
+ * 构建 EIP-712 数据 → 用 ethers Signer 签名 → 本地验证 → 生成上链的 calldata。不放在主入口，不用时打包不会带上。
+ *
+ * ```ts
+ * import { buildPermit, signPermit, permitCalldata } from '@w3lib/evm-batch-call/permit'
+ *
+ * const permit = await buildPermit(provider, { token: USDC, owner, spender: router, value: 100_000_000n }) // 精确额度，30 分钟有效
+ * const signed = await signPermit(signer, permit)      // signer：Wallet / 浏览器钱包的 JsonRpcSigner
+ * const data = permitCalldata(signed)                  // token.permit(...) 的 calldata，谁都可以提交
+ * ```
+ */
+export { DEFAULT_PERMIT_DEADLINE, MAX_PERMIT_DEADLINE, MAX_UINT160, PERMIT2_ADDRESS, assertPermitSafe, buildPermit, buildPermit2Batch, buildPermit2Single, buildPermit2Transfer, detectPermit, permit2Calldata, permitCalldata, permitTransferFromCalldata, signPermit, verifyPermitSignature, } from '../permit.js';
+//# sourceMappingURL=permit.js.map

package/dist/subpaths/permit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permit.js","sourceRoot":"","sources":["../../src/subpaths/permit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,0BAA0B,EAC1B,UAAU,EACV,qBAAqB,GAWtB,MAAM,cAAc,CAAA"}

package/dist/subpaths/price.js

@@ -34,7 +34,7 @@ export function getTokenPrices(tokens, options = {}) {
  * ```
  */
 export function getPortfolio(owner, options) {
-    const { provider, own } = resolve(options, ['tokens', 'sources', 'lp', 'minUsd', 'onPriceError', 'fetch']);
-    return portfolio(provider, owner, own);
+    const { provider, overrides, own } = resolve(options, ['tokens', 'sources', 'lp', 'minUsd', 'onPriceError', 'fetch']);
+    return portfolio(provider, owner, { ...own, ...(overrides.signal ? { signal: overrides.signal } : {}) });
 }
 //# sourceMappingURL=price.js.map

package/dist/subpaths/price.js.map

@@ -1 +1 @@
-{"version":3,"file":"price.js","sourceRoot":"","sources":["../../src/subpaths/price.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAyC,MAAM,iBAAiB,CAAA;AAClF,OAAO,EAAE,WAAW,EAA4C,MAAM,aAAa,CAAA;AACnF,OAAO,EAAE,OAAO,EAAgC,MAAM,iBAAiB,CAAA;AAEvE,OAAO,EAAE,SAAS,EAA8D,MAAM,iBAAiB,CAAA;AACvG,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,eAAe,EACf,aAAa,EACb,UAAU,EACV,WAAW,GAOZ,MAAM,aAAa,CAAA;AAIpB;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,MAAyB,EAAE,UAAiC,EAAE;IAC3F,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAA;IAC3E,OAAO,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,CAAA;AAC3C,CAAC;AAID;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,OAA4B;IACtE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC,CAAA;IAC1G,OAAO,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAuB,CAAC,CAAA;AAC5D,CAAC"}
+{"version":3,"file":"price.js","sourceRoot":"","sources":["../../src/subpaths/price.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAyC,MAAM,iBAAiB,CAAA;AAClF,OAAO,EAAE,WAAW,EAA4C,MAAM,aAAa,CAAA;AACnF,OAAO,EAAE,OAAO,EAAgC,MAAM,iBAAiB,CAAA;AAEvE,OAAO,EAAE,SAAS,EAA8D,MAAM,iBAAiB,CAAA;AACvG,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,eAAe,EACf,aAAa,EACb,UAAU,EACV,WAAW,GAOZ,MAAM,aAAa,CAAA;AAIpB;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,MAAyB,EAAE,UAAiC,EAAE;IAC3F,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAA;IAC3E,OAAO,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,CAAA;AAC3C,CAAC;AAID;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,OAA4B;IACtE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC,CAAA;IACrH,OAAO,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,GAAI,GAAwB,EAAE,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;AAChI,CAAC"}

package/dist/subpaths/rewards.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 一键领取手续费和挖矿奖励（子路径 `@w3lib/evm-batch-call/rewards`）：V3 / V4 仓位（含 Tron 的 SunSwap V3）未领取的手续费、
+ * PancakeSwap V3 MasterChef 的 CAKE（和质押仓位的手续费）、Aerodrome / Velodrome Slipstream gauge 的奖励。
+ * 不放在主入口，不用时打包不会带上这部分代码。
+ *
+ * - getClaimable：只读，列出每个仓位能领什么（数量 + 美元价值）
+ * - buildClaimAll：合并成尽量少的交易（V3 multicall、V4 一次 modifyLiquidities、MasterChef multicall），先模拟、剔除会失败的项
+ * - claimAll：构建后签名发送；`mode: '7702' | '4337' | '5792'` 时合成一笔原子交易
+ *
+ * ```ts
+ * import { claimAll, getClaimable } from '@w3lib/evm-batch-call/rewards'
+ *
+ * const c = await getClaimable(user, { chainId: 56, prices: true })   // c.items、c.totals、c.usd
+ * const { status, claimed } = await claimAll(multi, privateKey, { minUsd: 1 })
+ * ```
+ */
+import { type ShortcutProviderOptions } from '../shortcuts.js';
+import type { Claimable, ClaimableOptions } from '../rewards/types.js';
+export { FARM_PROTOCOLS, buildClaimAll, claimAll, claimable } from '../rewards/index.js';
+export type { ClaimAllOptions, ClaimAllSendOptions, ClaimAmount, ClaimItem, ClaimKind, ClaimPlan, ClaimResult, ClaimSkipped, ClaimTx, ClaimTxResult, Claimable, ClaimableOptions, FarmProtocol, } from '../rewards/types.js';
+export type { LpProtocol } from '../lp.js';
+export type { SignerInput, WriteResult, WriteStatus } from '../subpaths/write.js';
+export interface GetClaimableOptions extends ClaimableOptions, ShortcutProviderOptions {
+}
+/** 查一个地址能领取的手续费和挖矿奖励，节点参数与 getBalances 相同 */
+export declare function getClaimable(owner: string, options?: GetClaimableOptions): Promise<Claimable>;
+//# sourceMappingURL=rewards.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rewards.d.ts","sourceRoot":"","sources":["../../src/subpaths/rewards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAW,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAEvE,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAEtE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACxF,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,SAAS,EACT,SAAS,EACT,SAAS,EACT,WAAW,EACX,YAAY,EACZ,OAAO,EACP,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,YAAY,GACb,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAC1C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEjF,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB,EAAE,uBAAuB;CAAG;AAEzF,6CAA6C;AAC7C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,SAAS,CAAC,CAGjG"}

package/dist/subpaths/rewards.js

@@ -0,0 +1,25 @@
+/**
+ * 一键领取手续费和挖矿奖励（子路径 `@w3lib/evm-batch-call/rewards`）：V3 / V4 仓位（含 Tron 的 SunSwap V3）未领取的手续费、
+ * PancakeSwap V3 MasterChef 的 CAKE（和质押仓位的手续费）、Aerodrome / Velodrome Slipstream gauge 的奖励。
+ * 不放在主入口，不用时打包不会带上这部分代码。
+ *
+ * - getClaimable：只读，列出每个仓位能领什么（数量 + 美元价值）
+ * - buildClaimAll：合并成尽量少的交易（V3 multicall、V4 一次 modifyLiquidities、MasterChef multicall），先模拟、剔除会失败的项
+ * - claimAll：构建后签名发送；`mode: '7702' | '4337' | '5792'` 时合成一笔原子交易
+ *
+ * ```ts
+ * import { claimAll, getClaimable } from '@w3lib/evm-batch-call/rewards'
+ *
+ * const c = await getClaimable(user, { chainId: 56, prices: true })   // c.items、c.totals、c.usd
+ * const { status, claimed } = await claimAll(multi, privateKey, { minUsd: 1 })
+ * ```
+ */
+import { resolve } from '../shortcuts.js';
+import { claimable } from '../rewards/index.js';
+export { FARM_PROTOCOLS, buildClaimAll, claimAll, claimable } from '../rewards/index.js';
+/** 查一个地址能领取的手续费和挖矿奖励，节点参数与 getBalances 相同 */
+export function getClaimable(owner, options = {}) {
+    const { provider, overrides, own } = resolve(options, ['protocols', 'fees', 'rewards', 'v4', 'farms', 'gauges', 'maxPositions', 'prices', 'onPriceError', 'fetch']);
+    return claimable(provider, owner, { ...overrides, ...own });
+}
+//# sourceMappingURL=rewards.js.map

package/dist/subpaths/rewards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewards.js","sourceRoot":"","sources":["../../src/subpaths/rewards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,OAAO,EAAgC,MAAM,iBAAiB,CAAA;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAG/C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAqBxF,6CAA6C;AAC7C,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,UAA+B,EAAE;IAC3E,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC,CAAA;IACnK,OAAO,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,GAAG,SAAS,EAAE,GAAG,GAAG,EAAE,CAAC,CAAA;AAC7D,CAAC"}

package/dist/subpaths/simulate.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 交易模拟（子路径 `@w3lib/evm-batch-call/simulate`）：发送前先看一笔（或一串依赖的）交易会发生什么——成不成功、gas、
+ * 哪些资产进出（含美元价值）、给了什么授权、calldata 解码、风险提示。可以直接传 `buildSwap` / `buildRevokes` / 流动性构建的交易。
+ * 不放在主入口，不用时打包不会带上这部分代码。EVM 用 `eth_simulateV1`（不支持时退回 `eth_call`），Tron 用 `triggerconstantcontract`。
+ *
+ * ```ts
+ * import { getSimulation, getBatchSimulation } from '@w3lib/evm-batch-call/simulate'
+ *
+ * const sim = await getSimulation({ to: router, data, value }, { chainId: 1, from: user, usd: true })
+ * if (sim.warnings.some((w) => w.severity === 'danger')) alert(sim.warnings[0].message)
+ * const flow = await getBatchSimulation(plan.transactions, { chainId: 1, from: user }) // approve + swap，状态延续
+ * ```
+ */
+import { type BatchSimulationResult, type SimulateOptions, type SimulateTx, type SimulationResult } from '../simulate.js';
+import { type ShortcutProviderOptions } from '../shortcuts.js';
+export { assertSimulation, decodeCalldata, decodeRevert, simulate, simulateBatch, type ApprovalChange, type BalanceChange, type BatchSimulationResult, type DecodedCall, type DecodedType, type SimulatedTransfer, type SimulateOptions, type SimulateTx, type SimulationResult, type SimulationWarning, type StateOverrides, type WarningSeverity, } from '../simulate.js';
+export interface GetSimulationOptions extends SimulateOptions, ShortcutProviderOptions {
+}
+/** 模拟一笔交易，节点参数与 getBalances 相同 */
+export declare function getSimulation(tx: SimulateTx, options?: GetSimulationOptions): Promise<SimulationResult>;
+/** 按顺序模拟一串依赖前一笔的交易（也可以直接传 buildSwap 等的结果），节点参数与 getBalances 相同 */
+export declare function getBatchSimulation(txs: readonly SimulateTx[] | {
+    transactions: readonly SimulateTx[];
+}, options?: GetSimulationOptions): Promise<BatchSimulationResult>;
+//# sourceMappingURL=simulate.d.ts.map

package/dist/subpaths/simulate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../../src/subpaths/simulate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAA2B,KAAK,qBAAqB,EAAE,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAClJ,OAAO,EAAW,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAEvE,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAA;AAIvB,MAAM,WAAW,oBAAqB,SAAQ,eAAe,EAAE,uBAAuB;CAAG;AAEzF,kCAAkC;AAClC,wBAAgB,aAAa,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAG3G;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,UAAU,EAAE,GAAG;IAAE,YAAY,EAAE,SAAS,UAAU,EAAE,CAAA;CAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAG3K"}

package/dist/subpaths/simulate.js

@@ -0,0 +1,28 @@
+/**
+ * 交易模拟（子路径 `@w3lib/evm-batch-call/simulate`）：发送前先看一笔（或一串依赖的）交易会发生什么——成不成功、gas、
+ * 哪些资产进出（含美元价值）、给了什么授权、calldata 解码、风险提示。可以直接传 `buildSwap` / `buildRevokes` / 流动性构建的交易。
+ * 不放在主入口，不用时打包不会带上这部分代码。EVM 用 `eth_simulateV1`（不支持时退回 `eth_call`），Tron 用 `triggerconstantcontract`。
+ *
+ * ```ts
+ * import { getSimulation, getBatchSimulation } from '@w3lib/evm-batch-call/simulate'
+ *
+ * const sim = await getSimulation({ to: router, data, value }, { chainId: 1, from: user, usd: true })
+ * if (sim.warnings.some((w) => w.severity === 'danger')) alert(sim.warnings[0].message)
+ * const flow = await getBatchSimulation(plan.transactions, { chainId: 1, from: user }) // approve + swap，状态延续
+ * ```
+ */
+import { simulate, simulateBatch } from '../simulate.js';
+import { resolve } from '../shortcuts.js';
+export { assertSimulation, decodeCalldata, decodeRevert, simulate, simulateBatch, } from '../simulate.js';
+const OWN = ['from', 'watch', 'stateOverrides', 'gas', 'fee', 'usd', 'risk', 'forceCall'];
+/** 模拟一笔交易，节点参数与 getBalances 相同 */
+export function getSimulation(tx, options = {}) {
+    const { provider, overrides, own } = resolve(options, OWN);
+    return simulate(provider, tx, { ...own, ...(overrides.blockTag === undefined ? {} : { blockTag: overrides.blockTag }) });
+}
+/** 按顺序模拟一串依赖前一笔的交易（也可以直接传 buildSwap 等的结果），节点参数与 getBalances 相同 */
+export function getBatchSimulation(txs, options = {}) {
+    const { provider, overrides, own } = resolve(options, OWN);
+    return simulateBatch(provider, txs, { ...own, ...(overrides.blockTag === undefined ? {} : { blockTag: overrides.blockTag }) });
+}
+//# sourceMappingURL=simulate.js.map

package/dist/subpaths/simulate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.js","sourceRoot":"","sources":["../../src/subpaths/simulate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,QAAQ,EAAE,aAAa,EAA4F,MAAM,gBAAgB,CAAA;AAClJ,OAAO,EAAE,OAAO,EAAgC,MAAM,iBAAiB,CAAA;AAEvE,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,aAAa,GAad,MAAM,gBAAgB,CAAA;AAEvB,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAU,CAAA;AAIlG,kCAAkC;AAClC,MAAM,UAAU,aAAa,CAAC,EAAc,EAAE,UAAgC,EAAE;IAC9E,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IAC1D,OAAO,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,GAAG,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAA;AAC1H,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,kBAAkB,CAAC,GAAoE,EAAE,UAAgC,EAAE;IACzI,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IAC1D,OAAO,aAAa,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAA;AAChI,CAAC"}

package/dist/subpaths/smart-account.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 智能账户批量执行（子路径 `@w3lib/evm-batch-call/smart-account`）：ERC-4337（EntryPoint v0.7 / v0.8）UserOperation 的构建 / 哈希 / 签名、
+ * bundler 与 ERC-7677 paymaster 客户端、自己打包（handleOps）、EIP-5792（wallet_sendCalls）。
+ * 通常通过 `/write` 的 `mode: '4337' | '5792'`、`mode: '7702' + sponsor` 使用，这里是底层积木。
+ *
+ * ```ts
+ * import { BundlerClient } from '@w3lib/evm-batch-call/smart-account'
+ * const bundler = new BundlerClient('https://public.pimlico.io/v2/8453/rpc')
+ * await bundler.supportedEntryPoints()
+ * ```
+ */
+export { BundlerClient, PaymasterClient, type GasEstimate, type PaymasterContext, type PaymasterFields, type PaymasterHook, type RpcClientOptions, type UserOperationReceipt } from '../smartAccount/clients.js';
+export { DUMMY_SIGNATURE, EIP7702_MARKER, ENTRY_POINT_V07, ENTRY_POINT_V08, entryPointAddress, getUserOpHash, packUserOp, userOpToRpc, userOpTypedData, type EntryPointVersion, type PackedUserOperation, type UserOperation, } from '../smartAccount/userOp.js';
+import type { Provider } from '../provider.js';
+import type { SmartAccountOptions } from '../smartAccount/send.js';
+export { SIMPLE_ACCOUNT_FACTORY_V07, SIMPLE_ACCOUNT_FACTORY_V08, encodeExecuteBatch, type SmartAccountKind } from '../smartAccount/account.js';
+export { getCallsStatus, getWalletCapabilities, sendCalls, waitForCalls, type CallsStatus, type Eip1193Like, type SendCallsRequest, type WalletCapabilities } from '../smartAccount/eip5792.js';
+export type { SmartAccountOptions };
+/** owner 对应的 SimpleAccount 地址（部署前就能算出，向它转入资产后再用 `mode: '4337'` 发送） */
+export declare function getSimpleAccount(provider: Provider, owner: string, options?: Pick<SmartAccountOptions, 'entryPoint' | 'salt' | 'factory'>): Promise<{
+    address: string;
+    deployed: boolean;
+}>;
+//# sourceMappingURL=smart-account.d.ts.map

package/dist/subpaths/smart-account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-account.d.ts","sourceRoot":"","sources":["../../src/subpaths/smart-account.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAChN,OAAO,EACL,eAAe,EACf,cAAc,EACd,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,WAAW,EACX,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAG9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAC9I,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAC/L,YAAY,EAAE,mBAAmB,EAAE,CAAA;AAEnC,sEAAsE;AACtE,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAIrM"}

package/dist/subpaths/smart-account.js

@@ -0,0 +1,24 @@
+/**
+ * 智能账户批量执行（子路径 `@w3lib/evm-batch-call/smart-account`）：ERC-4337（EntryPoint v0.7 / v0.8）UserOperation 的构建 / 哈希 / 签名、
+ * bundler 与 ERC-7677 paymaster 客户端、自己打包（handleOps）、EIP-5792（wallet_sendCalls）。
+ * 通常通过 `/write` 的 `mode: '4337' | '5792'`、`mode: '7702' + sponsor` 使用，这里是底层积木。
+ *
+ * ```ts
+ * import { BundlerClient } from '@w3lib/evm-batch-call/smart-account'
+ * const bundler = new BundlerClient('https://public.pimlico.io/v2/8453/rpc')
+ * await bundler.supportedEntryPoints()
+ * ```
+ */
+export { BundlerClient, PaymasterClient } from '../smartAccount/clients.js';
+export { DUMMY_SIGNATURE, EIP7702_MARKER, ENTRY_POINT_V07, ENTRY_POINT_V08, entryPointAddress, getUserOpHash, packUserOp, userOpToRpc, userOpTypedData, } from '../smartAccount/userOp.js';
+import { WriteRpc } from '../write/rpc.js';
+import { resolveSimpleAccount } from '../smartAccount/account.js';
+export { SIMPLE_ACCOUNT_FACTORY_V07, SIMPLE_ACCOUNT_FACTORY_V08, encodeExecuteBatch } from '../smartAccount/account.js';
+export { getCallsStatus, getWalletCapabilities, sendCalls, waitForCalls } from '../smartAccount/eip5792.js';
+/** owner 对应的 SimpleAccount 地址（部署前就能算出，向它转入资产后再用 `mode: '4337'` 发送） */
+export async function getSimpleAccount(provider, owner, options = {}) {
+    const rpc = await WriteRpc.from(provider);
+    const { address, deployed } = await resolveSimpleAccount(rpc, owner, options.entryPoint ?? '0.7', options.salt, options.factory);
+    return { address, deployed };
+}
+//# sourceMappingURL=smart-account.js.map

package/dist/subpaths/smart-account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-account.js","sourceRoot":"","sources":["../../src/subpaths/smart-account.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAuI,MAAM,4BAA4B,CAAA;AAChN,OAAO,EACL,eAAe,EACf,cAAc,EACd,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,WAAW,EACX,eAAe,GAIhB,MAAM,2BAA2B,CAAA;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAEjE,OAAO,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,kBAAkB,EAAyB,MAAM,4BAA4B,CAAA;AAC9I,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,SAAS,EAAE,YAAY,EAAsF,MAAM,4BAA4B,CAAA;AAG/L,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAkB,EAAE,KAAa,EAAE,UAAwE,EAAE;IAClJ,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACzC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IAChI,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAA;AAC9B,CAAC"}

package/dist/swap.d.ts

@@ -8,6 +8,7 @@ import type { LiquidityTxResult } from './liquidity/types.js';
 import { type LpProtocol, type LpToken } from './lp.js';
 import type { BlockTag } from './aggregate.js';
 import type { Provider } from './provider.js';
+import type { SignedPermit } from './permit.js';
 import type { BatchCallOptions } from './write/batch.js';
 import type { SignerInput } from './write/signer.js';
 /** V3 协议的报价合约（QuoterV2）和兑换合约（SwapRouter02 接口），按 协议 id → chainId。2026-10 在链上核对过（Router 的 WETH9 / deployer，并用 eth_call 实际执行过兑换） */
@@ -30,8 +31,20 @@ export interface SwapOptions {
     deadline?: number;
     /** 收到代币的地址，默认 owner */
     recipient?: string;
-    /** 授权额度：'exact'（默认，本次卖出的数量）或 'max' */
-    approve?: 'exact' | 'max';
+    /**
+     * 授权方式：
+     * - 'exact'（默认）：授权本次卖出的数量；'max'：无限额度
+     * - 'permit'：用 EIP-2612 签名代替授权交易（要代币支持，见 /permit 的 detectPermit）。V3 路线（SwapRouter02 / SmartRouter）把 selfPermit 放进同一笔 multicall，
+     *   一次签名、一笔交易；V2 路线的 Router 没有 selfPermit，只有 `atomic` 批量（7702 / 4337 / 5792）发送时才用 permit，否则仍然是普通授权
+     * - 'permit2'：内置的 V2 / V3 路由都不使用 Permit2（它们直接 transferFrom），所以会退回普通的 'exact' 授权；结果的 plan.approval 里有说明
+     * - 'auto'：能用 permit 就用，否则普通授权
+     * 退回普通授权时 plan.approval.method 为 'approve'，reason 写明原因
+     */
+    approve?: 'exact' | 'max' | 'permit' | 'permit2' | 'auto';
+    /** 交易会在一笔原子批量里发送（`swap` 的 mode 为 7702 / 4337 / 5792 时自动为 true）：V2 路线才能把 permit 和兑换放进同一笔 */
+    atomic?: boolean;
+    /** 已签名的 permit（`swap` 内部使用）：V3 路线嵌入 multicall 的 selfPermit，V2 路线放在兑换前；不再生成授权交易 */
+    signedPermit?: SignedPermit;
     /**
      * 代币的转账税（比例，0.05 = 5%），默认 0。V2 报价（getAmountsOut）不含转账税，带税的代币
      * 实际收到的比报价少，最少收到按 (1 − slippage) × (1 − tax) 算，否则会因 INSUFFICIENT_OUTPUT_AMOUNT 回滚。
@@ -59,8 +72,8 @@ export interface SwapRoute {
     amountOut: string;
 }
 export interface SwapTx {
-    /** approve：卖出的代币授权给 Router；swap：兑换 */
-    kind: 'approve' | 'swap';
+    /** approve：卖出的代币授权给 Router；permit：提交 EIP-2612 签名（V2 路线批量发送时）；swap：兑换 */
+    kind: 'approve' | 'permit' | 'swap';
     to: string;
     data: string;
     /** 附带的主币（最小单位）：卖出主币时为卖出的数量 */
@@ -88,6 +101,23 @@ export interface SwapPlan {
     routes: SwapRoute[];
     /** 按顺序发送的交易（授权在前） */
     transactions: SwapTx[];
+    /** 请求了 permit / permit2 / auto 时：实际采用的授权方式和原因 */
+    approval?: SwapApproval;
+}
+export interface SwapApproval {
+    requested: 'permit' | 'permit2' | 'auto';
+    /** 'permit'：用签名；'approve'：退回普通授权交易（reason 说明）；'none'：不需要授权（卖出主币 / 额度已够） */
+    method: 'permit' | 'approve' | 'none';
+    /** permit 的提交方式：selfPermit（V3 的 multicall 内）/ batch（和兑换放在同一笔原子批量） */
+    via?: 'selfPermit' | 'batch';
+    reason?: string;
+    /** 要签的 permit（owner 授权 spender 精确的卖出数量，签名有效期与兑换的 deadline 相同） */
+    permit?: {
+        token: string;
+        spender: string;
+        value: string;
+        deadline: number;
+    };
 }
 /** 这条链上能兑换的协议：V2 要有 Router，V3 要有报价和兑换合约（V3_SWAP_CONTRACTS） */
 export declare function swapProtocols(chainId: number): LpProtocol[];
@@ -106,13 +136,20 @@ export type SwapTxResult = Omit<LiquidityTxResult, 'kind'> & {
 };
 export interface SwapResult {
     plan: SwapPlan;
-    /** 每笔交易的结果（授权、兑换） */
+    /** 每笔交易的结果（授权 / permit、兑换） */
     results: SwapTxResult[];
     /** 兑换那一笔的状态和哈希 */
     status: LiquidityTxResult['status'];
     hash: string | null;
+    /** 请求 permit / permit2 / auto 时：实际采用的授权方式（同 plan.approval，退回普通授权时有原因） */
+    approval?: SwapApproval;
 }
 export interface SwapSendOptions extends SwapOptions, Omit<BatchCallOptions, 'mode' | 'continueOnError' | 'onUpdate'> {
+    /**
+     * 发送方式：'tx'（默认，授权和兑换分别发，授权确认后重新报价）；
+     * '7702' / '4337' / '5792'：授权（或 permit）和兑换放进同一笔原子批量，见 BatchCallOptions.mode
+     */
+    mode?: 'tx' | '7702' | '4337' | '5792';
     onUpdate?: (result: SwapTxResult) => void;
 }
 /**
@@ -122,6 +159,9 @@ export interface SwapSendOptions extends SwapOptions, Omit<BatchCallOptions, 'mo
  * ```ts
  * const r = await swap(provider, key, { tokenIn: USDT, tokenOut: NATIVE_TOKEN, amountInFormatted: '100' }, { slippage: 0.01 })
  * r.status   // 'confirmed'
+ *
+ * // 用 EIP-2612 签名代替授权交易（V3 路线一笔交易完成；不支持时退回普通授权，r.approval.reason 说明原因）
+ * await swap(provider, signer, params, { approve: 'auto' })
  * ```
  */
 export declare function swap(provider: Provider, from: SignerInput, params: SwapParams, options?: SwapSendOptions): Promise<SwapResult>;

package/dist/swap.d.ts.map

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

package/dist/swap.js

@@ -3,7 +3,7 @@
  * 批量报价（V2 用 Router 的 getAmountsOut，V3 用 QuoterV2，按 gas 分成几次并发的 eth_call），选输出最多的；按滑点算最少收到的数量，
  * 构建授权 + 兑换的交易（V2 走 Router 的 swapExact…SupportingFeeOnTransferTokens，V3 走 SwapRouter02 / PancakeSwap SmartRouter 的 multicall）
  */
-import { Interface } from 'ethers';
+import { Interface, getAddress } from 'ethers';
 import { approvals, createCtx, evm, fmt, isNative, minus, out, parseAmount, same, tokenInfo } from './liquidity/common.js';
 import { LP_PROTOCOLS, LP_QUOTE_TOKENS } from './lp.js';
 /** V3 协议的报价合约（QuoterV2）和兑换合约（SwapRouter02 接口），按 协议 id → chainId。2026-10 在链上核对过（Router 的 WETH9 / deployer，并用 eth_call 实际执行过兑换） */
@@ -33,6 +33,7 @@ const v2RouterInterface = new Interface([
     'function swapExactETHForTokensSupportingFeeOnTransferTokens(uint256 amountOutMin, address[] path, address to, uint256 deadline) payable',
     'function swapExactTokensForETHSupportingFeeOnTransferTokens(uint256 amountIn, uint256 amountOutMin, address[] path, address to, uint256 deadline)',
 ]);
+const permitInterface = new Interface(['function permit(address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s)']);
 const v3FactoryInterface = new Interface(['function getPool(address tokenA, address tokenB, uint24 fee) view returns (address)']);
 const v3PoolInterface = new Interface(['function liquidity() view returns (uint128)']);
 /** QuoterV2 很费 gas（池子很薄时一次可达上千万）：每次 eth_call 只放几个报价，多个 eth_call 并发，避免超过节点的 gas 上限后被悄悄截掉 */
@@ -47,6 +48,7 @@ const swapRouterInterface = new Interface([
     'function exactInputSingle((address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 amountIn, uint256 amountOutMinimum, uint160 sqrtPriceLimitX96) params) payable returns (uint256 amountOut)',
     'function exactInput((bytes path, address recipient, uint256 amountIn, uint256 amountOutMinimum) params) payable returns (uint256 amountOut)',
     'function unwrapWETH9(uint256 amountMinimum, address recipient) payable',
+    'function selfPermitIfNecessary(address token, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) payable',
     'function multicall(uint256 deadline, bytes[] data) payable returns (bytes[] results)',
 ]);
 /** 这条链上能兑换的协议：V2 要有 Router，V3 要有报价和兑换合约（V3_SWAP_CONTRACTS） */
@@ -163,7 +165,7 @@ function amountOf(c, result) {
  */
 export async function buildSwap(provider, owner, params, options = {}) {
     const { slippage, deadline, recipient, approve } = options;
-    const ctx = await createCtx(provider, owner, { slippage, deadline, recipient, approve });
+    const ctx = await createCtx(provider, owner, { slippage, deadline, recipient, approve: approve === 'max' ? 'max' : 'exact' });
     const wrapped = LP_QUOTE_TOKENS[ctx.chainId]?.[0];
     const nativeIn = isNative(ctx, params.tokenIn);
     const nativeOut = isNative(ctx, params.tokenOut);
@@ -200,7 +202,16 @@ export async function buildSwap(provider, owner, params, options = {}) {
     // approvals 只会返回 kind 为 'approve' 的交易
     // Router 在 Tron 上是 T 地址：授权的 ABI 参数要用 0x 格式
     const transactions = (nativeIn ? [] : await approvals(ctx, [{ token: tokenIn, spender: evm(best.router), amount: amountIn }]));
-    transactions.push(swapTx(ctx, best, amountIn, amountOutMin, nativeIn, nativeOut));
+    let approval;
+    const requested = options.approve;
+    if (requested === 'permit' || requested === 'permit2' || requested === 'auto') {
+        approval = await decideApproval(ctx, requested, best, tokenIn, amountIn, nativeIn, transactions.some((t) => t.kind === 'approve'), options);
+    }
+    let permitCall;
+    if (options.signedPermit && approval?.method === 'permit') {
+        permitCall = applySignedPermit(options.signedPermit, approval, ctx, transactions);
+    }
+    transactions.push(swapTx(ctx, best, amountIn, amountOutMin, nativeIn, nativeOut, permitCall));
     const route = (c) => ({
         protocol: c.protocol.id,
         protocolName: c.protocol.name,
@@ -224,9 +235,50 @@ export async function buildSwap(provider, owner, params, options = {}) {
         route: route(best),
         routes: routes.map(route),
         transactions,
+        ...(approval ? { approval } : {}),
     };
 }
-function swapTx(ctx, c, amountIn, amountOutMin, nativeIn, nativeOut) {
+/** permit / permit2 / auto：判断这条路线和这个代币能不能用签名代替授权交易，不能的退回普通授权并写明原因 */
+async function decideApproval(ctx, requested, best, tokenIn, amountIn, nativeIn, needsApprove, options) {
+    if (nativeIn || !needsApprove)
+        return { requested, method: 'none' };
+    const fallback = (reason) => ({ requested, method: 'approve', reason });
+    if (requested === 'permit2') {
+        return fallback('The built-in V2 / V3 routers pull tokens with transferFrom and do not consume Permit2 signatures; used a normal exact approve');
+    }
+    if (ctx.tron)
+        return fallback('permit is not available on Tron; used a normal approve');
+    const { detectPermit } = await import('./permit.js');
+    const support = await detectPermit(ctx.provider, tokenIn);
+    if (!support.kind)
+        return fallback(`${support.reason}; used a normal approve`);
+    if (support.kind === 'dai')
+        return fallback('A DAI-style permit can only grant an unlimited allowance; used a normal exact approve');
+    const via = best.version === 'v3' ? 'selfPermit' : 'batch';
+    if (via === 'batch' && !options.atomic) {
+        return fallback("V2 routers have no selfPermit, so a separate permit() transaction saves nothing; use mode '7702' / '4337' / '5792' to send the permit and the swap atomically. Used a normal approve");
+    }
+    return { requested, method: 'permit', via, permit: { token: tokenIn, spender: evm(best.router), value: amountIn.toString(), deadline: ctx.deadline } };
+}
+/** 已签名的 permit 放进交易：V3 返回 selfPermit 的 calldata（嵌进 multicall），V2 往 transactions 里加一笔 permit 交易 */
+function applySignedPermit(signed, approval, ctx, transactions) {
+    const want = approval.permit;
+    const p = signed.permit;
+    if (p.kind !== 'eip2612' || getAddress(p.tokens[0]) !== getAddress(want.token) || getAddress(p.spender) !== getAddress(want.spender) || p.owner !== ctx.owner || BigInt(p.amounts[0]) !== BigInt(want.value)) {
+        throw new Error('The signed permit does not match the swap (token / spender / owner / amount)');
+    }
+    // 授权交易换成 permit
+    const at = transactions.findIndex((t) => t.kind === 'approve');
+    transactions.splice(at, transactions.length);
+    if (approval.via === 'selfPermit') {
+        return swapRouterInterface.encodeFunctionData('selfPermitIfNecessary', [want.token, want.value, p.deadline, signed.v, signed.r, signed.s]);
+    }
+    const m = p.typedData.message;
+    const data = permitInterface.encodeFunctionData('permit', [m.owner, m.spender, m.value, m.deadline, signed.v, signed.r, signed.s]);
+    transactions.push({ kind: 'permit', to: out(ctx, want.token), data, value: '0', token: out(ctx, want.token), spender: out(ctx, want.spender), amount: want.value });
+    return undefined;
+}
+function swapTx(ctx, c, amountIn, amountOutMin, nativeIn, nativeOut, selfPermit) {
     const value = nativeIn ? amountIn.toString() : '0';
     if (c.version === 'v2') {
         const data = nativeIn
@@ -243,7 +295,7 @@ function swapTx(ctx, c, amountIn, amountOutMin, nativeIn, nativeOut) {
             { tokenIn: c.path[0], tokenOut: c.path[1], fee: c.fees[0], recipient, amountIn, amountOutMinimum: amountOutMin, sqrtPriceLimitX96: 0n },
         ])
         : swapRouterInterface.encodeFunctionData('exactInput', [{ path: encodePath(c.path, c.fees), recipient, amountIn, amountOutMinimum: amountOutMin }]);
-    const calls = nativeOut ? [swap, swapRouterInterface.encodeFunctionData('unwrapWETH9', [amountOutMin, ctx.recipient])] : [swap];
+    const calls = [...(selfPermit ? [selfPermit] : []), swap, ...(nativeOut ? [swapRouterInterface.encodeFunctionData('unwrapWETH9', [amountOutMin, ctx.recipient])] : [])];
     return { kind: 'swap', to: out(ctx, c.router), data: swapRouterInterface.encodeFunctionData('multicall', [ctx.deadline, calls]), value };
 }
 /**
@@ -253,22 +305,63 @@ function swapTx(ctx, c, amountIn, amountOutMin, nativeIn, nativeOut) {
  * ```ts
  * const r = await swap(provider, key, { tokenIn: USDT, tokenOut: NATIVE_TOKEN, amountInFormatted: '100' }, { slippage: 0.01 })
  * r.status   // 'confirmed'
+ *
+ * // 用 EIP-2612 签名代替授权交易（V3 路线一笔交易完成；不支持时退回普通授权，r.approval.reason 说明原因）
+ * await swap(provider, signer, params, { approve: 'auto' })
  * ```
  */
 export async function swap(provider, from, params, options = {}) {
     const [{ batchCall, tronModule }, { resolveSigner }, { emptyOutcome, toWriteResult }] = await Promise.all([import('./write/batch.js'), import('./write/signer.js'), import('./write/send.js')]);
     const tron = await tronModule(provider);
-    const owner = tron ? await tron.tronSignerAddress(from) : (await resolveSigner(from)).address;
-    let plan = await buildSwap(provider, owner, params, options);
-    const send = async (txs) => (await batchCall(provider, txs.map((tx) => ({ from, to: tx.to, data: tx.data, value: BigInt(tx.value) })), {
+    const resolved = tron ? null : await resolveSigner(from);
+    const owner = tron ? await tron.tronSignerAddress(from) : resolved.address;
+    const mode = options.mode ?? 'tx';
+    const atomic = mode !== 'tx';
+    // 4337 的 SimpleAccount：资产在账户地址里，兑换的 owner 是账户（合约账户不能签 EIP-2612，不用 permit）
+    let holder = owner;
+    let smartHolder = false;
+    if (mode === '4337' && (options.smartAccount?.account ?? 'simple') === 'simple') {
+        const [{ resolveSimpleAccount }, { WriteRpc }] = await Promise.all([import('./smartAccount/account.js'), import('./write/rpc.js')]);
+        const sa = options.smartAccount;
+        holder = (await resolveSimpleAccount(await WriteRpc.from(provider), owner, sa?.entryPoint ?? '0.7', sa?.salt, sa?.factory)).address;
+        smartHolder = true;
+    }
+    const wantsPermit = options.approve === 'permit' || options.approve === 'permit2' || options.approve === 'auto';
+    let plan = await buildSwap(provider, holder, params, { ...options, atomic, ...(smartHolder && wantsPermit ? { approve: 'exact' } : {}) });
+    if (smartHolder && wantsPermit && plan.transactions.length > 1) {
+        plan.approval = { requested: options.approve, method: 'approve', reason: 'The 4337 smart account is a contract and cannot sign EIP-2612 permits; used a normal approve' };
+    }
+    if (plan.approval?.method === 'permit' && resolved) {
+        // 签 permit：精确的卖出数量、有效期与兑换的 deadline 相同；用户拒绝签名就整体中止（不悄悄改成发授权交易）
+        const { buildPermit, signPermit } = await import('./permit.js');
+        const want = plan.approval.permit;
+        const permit = await buildPermit(provider, { token: want.token, owner: holder, spender: want.spender, value: want.value }, { deadlineAt: want.deadline });
+        const signed = await signPermit(resolved.signer, permit, { chainId: await provider.getChainId() });
+        try {
+            plan = await buildSwap(provider, holder, params, { ...options, atomic, signedPermit: signed });
+        }
+        catch (err) {
+            // 签名后重新报价，最优路线变了（路由 / 版本 / 数量不同），签名对不上：改用普通授权，不让已经签过的请求白白中止
+            if (!/signed permit does not match/.test(err instanceof Error ? err.message : String(err)))
+                throw err;
+            plan = await buildSwap(provider, holder, params, { ...options, atomic, approve: 'exact' });
+            if (plan.approval)
+                plan.approval = { ...plan.approval, requested: options.approve, method: 'approve', reason: 'The best route changed after the permit was signed; used a normal approve' };
+        }
+    }
+    const send = async (txs, asMode = 'tx') => (await batchCall(provider, txs.map((tx) => ({ from, to: tx.to, data: tx.data, value: BigInt(tx.value) })), {
         ...options,
-        mode: 'tx',
+        mode: asMode === 'atomic' ? mode : 'tx',
         continueOnError: false,
         onUpdate: options.onUpdate ? (r) => options.onUpdate?.({ ...r, kind: txs[r.index].kind }) : undefined,
     })).map((r, i) => ({ ...r, kind: txs[i].kind }));
     const txs = plan.transactions;
     let results;
-    if (txs.length === 1) {
+    if (atomic) {
+        // 授权 / permit 和兑换在同一笔原子批量里：要么都成功，要么都不生效
+        results = await send(txs, 'atomic');
+    }
+    else if (txs.length === 1) {
         results = await send(txs);
     }
     else {
@@ -276,8 +369,11 @@ export async function swap(provider, from, params, options = {}) {
         // 不会因为授权等得久而过期或按旧价成交
         const approved = await send(txs.slice(0, -1));
         const last = txs[txs.length - 1];
+        const approval = plan.approval;
         if (approved.every((r) => r.status === 'confirmed')) {
-            plan = await buildSwap(provider, owner, params, options);
+            plan = await buildSwap(provider, holder, params, { ...options, approve: options.approve === 'max' ? 'max' : 'exact' });
+            if (approval)
+                plan.approval = approval; // 重新报价时额度已够：保留最初的选择和原因
             const fresh = plan.transactions[plan.transactions.length - 1];
             results = [...approved, ...(await send([fresh])).map((r) => ({ ...r, index: txs.length - 1 }))];
         }
@@ -286,6 +382,6 @@ export async function swap(provider, from, params, options = {}) {
         }
     }
     const main = results[results.length - 1];
-    return { plan, results, status: main.status, hash: main.hash };
+    return { plan, results, status: main.status, hash: main.hash, ...(plan.approval ? { approval: plan.approval } : {}) };
 }
 //# sourceMappingURL=swap.js.map