four-flap-meme-sdk 1.5.21 → 1.5.23

package/dist/contracts/tm-bundle-merkle/index.d.ts

@@ -6,7 +6,7 @@ export * from './config.js';
 export * from './types.js';
 export { createTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle, batchSellWithBundleMerkle } from './core.js';
 export { fourPrivateBuyMerkle, fourPrivateSellMerkle, fourBatchPrivateBuyMerkle, fourBatchPrivateSellMerkle } from './private.js';
-export { disperseWithBundleMerkle, sweepWithBundleMerkle } from './utils.js';
+export { disperseWithBundleMerkle, sweepWithBundleMerkle, pairwiseTransferWithBundleMerkle } from './utils.js';
 export { fourPancakeProxyBatchBuyMerkle, fourPancakeProxyBatchSellMerkle, approveFourPancakeProxy, approveFourPancakeProxyBatch } from './pancake-proxy.js';
 export { approveFourTokenManagerBatch, type ApproveFourTokenManagerBatchParams, type ApproveFourTokenManagerBatchResult } from './approve-tokenmanager.js';
 export { submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, type MerkleSubmitConfig, type SubmitBundleResult, submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel, type BlockRazorSubmitConfig, type BlockRazorSubmitResult, submitDirectToRpc, submitDirectToRpcSequential, // ✅ 新增：顺序广播并等待确认（用于多跳）

package/dist/contracts/tm-bundle-merkle/index.js

@@ -10,7 +10,7 @@ export { createTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle, batchSellWith
 // 私有交易方法
 export { fourPrivateBuyMerkle, fourPrivateSellMerkle, fourBatchPrivateBuyMerkle, fourBatchPrivateSellMerkle } from './private.js';
 // 工具方法
-export { disperseWithBundleMerkle, sweepWithBundleMerkle } from './utils.js';
+export { disperseWithBundleMerkle, sweepWithBundleMerkle, pairwiseTransferWithBundleMerkle } from './utils.js';
 // PancakeSwapProxy 代理交易方法
 export { fourPancakeProxyBatchBuyMerkle, fourPancakeProxyBatchSellMerkle, approveFourPancakeProxy, approveFourPancakeProxyBatch } from './pancake-proxy.js';
 // TokenManager 授权方法

package/dist/contracts/tm-bundle-merkle/types.d.ts

@@ -337,6 +337,30 @@ export type SweepSignParams = {
  * 包含 hopWallets 用于返回生成的多跳钱包私钥
  */
 export type SweepMerkleResult = MerkleSignedResult;
+/**
+ * 多对多（地址一一对应）转账参数（仅签名版本）
+ * - senderPrivateKeys / receiverAddresses 必须等长
+ * - amount / amounts 二选一（amounts 优先）
+ * - 支持多跳：hopCount 可为 number 或逐对数组
+ * - 支持利润刮取：利润由第一个 sender 支付（作为额外费用，不扣减每对转账金额）
+ */
+export type PairwiseTransferSignParams = {
+    senderPrivateKeys: string[];
+    receiverAddresses: string[];
+    amount?: AmountLike;
+    amounts?: AmountLike[];
+    tokenAddress?: string;
+    tokenDecimals?: number;
+    hopCount?: number | number[];
+    hopPrivateKeys?: string[][];
+    config: FourSignConfig;
+    /** ✅ 起始 nonce（仅对第一个 sender 生效，用于并行调用避免 nonce 冲突） */
+    startNonce?: number;
+    tokenPoolType?: TokenPoolType;
+    quoteToken?: QuoteTokenType;
+    userType?: UserType;
+};
+export type PairwiseTransferMerkleResult = MerkleSignedResult;
 /** ✅ PancakeProxy 批量购买参数（Merkle 版本 - 完整） */
 export type FourPancakeProxyBatchBuyParams = {
     privateKeys: string[];

package/dist/contracts/tm-bundle-merkle/utils.d.ts

@@ -1,4 +1,4 @@
-import { DisperseSignParams, DisperseMerkleResult, SweepSignParams, SweepMerkleResult } from './types.js';
+import { DisperseSignParams, DisperseMerkleResult, SweepSignParams, SweepMerkleResult, PairwiseTransferSignParams, PairwiseTransferMerkleResult } from './types.js';
 /**
  * 分发（仅签名版本 - 不依赖 Merkle）
  * ✅ 精简版：只负责签名交易，不提交到 Merkle
@@ -11,3 +11,10 @@ export declare function disperseWithBundleMerkle(params: DisperseSignParams): Pr
  * ✅ 优化版：支持 startNonce 参数避免并行调用时的 nonce 冲突
  */
 export declare function sweepWithBundleMerkle(params: SweepSignParams): Promise<SweepMerkleResult>;
+/**
+ * 多对多（地址一一对应）转账（仅签名版本 - 不依赖 Merkle）
+ * - 支持原生币 / ERC20
+ * - 支持多跳（逐对）
+ * - 支持利润刮取：利润由第一个 sender 支付（作为额外费用，不扣减每对转账金额）
+ */
+export declare function pairwiseTransferWithBundleMerkle(params: PairwiseTransferSignParams): Promise<PairwiseTransferMerkleResult>;

package/dist/contracts/tm-bundle-merkle/utils.js

@@ -1389,3 +1389,290 @@ export async function sweepWithBundleMerkle(params) {
         } : undefined
     };
 }
+/**
+ * 多对多（地址一一对应）转账（仅签名版本 - 不依赖 Merkle）
+ * - 支持原生币 / ERC20
+ * - 支持多跳（逐对）
+ * - 支持利润刮取：利润由第一个 sender 支付（作为额外费用，不扣减每对转账金额）
+ */
+export async function pairwiseTransferWithBundleMerkle(params) {
+    const { senderPrivateKeys, receiverAddresses, amount, amounts, tokenAddress, tokenDecimals, hopCount = 0, hopPrivateKeys, config, startNonce, tokenPoolType = 'v2', quoteToken = 'native', userType = 'v0', } = params;
+    if (!senderPrivateKeys || senderPrivateKeys.length === 0) {
+        return { signedTransactions: [], hopWallets: undefined };
+    }
+    if (!receiverAddresses || receiverAddresses.length === 0) {
+        return { signedTransactions: [], hopWallets: undefined };
+    }
+    if (senderPrivateKeys.length !== receiverAddresses.length) {
+        throw new Error(`senderPrivateKeys length (${senderPrivateKeys.length}) must match receiverAddresses length (${receiverAddresses.length})`);
+    }
+    const pairCount = senderPrivateKeys.length;
+    const normalizedAmounts = (() => {
+        if (amounts && amounts.length > 0) {
+            if (amounts.length !== pairCount) {
+                throw new Error(`amounts length (${amounts.length}) must match pair count (${pairCount})`);
+            }
+            return amounts.map(a => (typeof a === 'bigint' ? a.toString() : String(a)));
+        }
+        if (amount !== undefined && String(amount).trim().length > 0) {
+            const v = typeof amount === 'bigint' ? amount.toString() : String(amount);
+            return new Array(pairCount).fill(v);
+        }
+        throw new Error('Either amount or amounts must be provided');
+    })();
+    const chainIdNum = config.chainId ?? 56;
+    const chainName = chainIdNum === 143 ? 'Monad' : chainIdNum === 56 ? 'BSC' : `Chain-${chainIdNum}`;
+    const provider = new ethers.JsonRpcProvider(config.rpcUrl, { chainId: chainIdNum, name: chainName });
+    const txType = getTxType(config);
+    const isNative = _isNativeTokenAddress(tokenAddress);
+    const nonceManager = new NonceManager(provider);
+    // hop 私钥链优先使用传入
+    const providedHops = (() => {
+        if (hopPrivateKeys && hopPrivateKeys.length > 0) {
+            if (hopPrivateKeys.length !== pairCount) {
+                throw new Error(`hopPrivateKeys length (${hopPrivateKeys.length}) must match pair count (${pairCount})`);
+            }
+            return hopPrivateKeys.every(h => h.length === 0) ? null : hopPrivateKeys;
+        }
+        return null;
+    })();
+    const preparedHops = providedHops ?? _generateHopWallets(pairCount, hopCount);
+    const hasHops = preparedHops !== null;
+    const maxHopCount = hasHops ? Math.max(...preparedHops.map(h => h.length)) : 0;
+    const finalGasLimit = _calculateGasLimit(config, isNative, hasHops, maxHopCount);
+    const nativeGasLimit = (config.prefer21000ForNative ?? false) ? 21000n : finalGasLimit;
+    // 与 disperse 保持一致：多跳场景固定 gas limit
+    const nativeTransferGasLimit = 21000n;
+    const erc20TransferGasLimit = 65000n;
+    const [gasPrice, decimals] = await Promise.all([
+        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+        isNative ? Promise.resolve(18) : Promise.resolve(tokenDecimals ?? await _getErc20DecimalsMerkle(provider, tokenAddress, chainIdNum))
+    ]);
+    const iface = isNative ? null : new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
+    // 利润：按每对金额计算，但由第一个 sender 支付（额外费用）
+    const extractProfit = shouldExtractProfit(config);
+    let totalAmountBeforeProfit = 0n;
+    let totalTokenProfit = 0n;
+    let totalProfitNative = 0n;
+    const parsedAmountsWei = normalizedAmounts.map(v => {
+        const amt = isNative ? ethers.parseEther(v) : ethers.parseUnits(v, decimals);
+        totalAmountBeforeProfit += amt;
+        if (extractProfit && amt > 0n) {
+            const { profit } = calculateProfit(amt, userType);
+            if (isNative)
+                totalProfitNative += profit;
+            else
+                totalTokenProfit += profit;
+        }
+        return amt;
+    });
+    if (!isNative && extractProfit && totalTokenProfit > 0n) {
+        totalProfitNative = await getTokenToNativeQuote(provider, tokenAddress, totalTokenProfit, chainIdNum, tokenPoolType, quoteToken, config.rpcUrl);
+    }
+    // 计算每个 sender 需要的 nonce 数量（聚合到地址）
+    const senderWallets = senderPrivateKeys.map(pk => new Wallet(pk, provider));
+    const senderAddrLowerList = senderWallets.map(w => w.address.toLowerCase());
+    const firstSenderAddrLower = senderAddrLowerList[0];
+    const nonceNeedBySender = new Map();
+    for (let i = 0; i < pairCount; i++) {
+        const addrLower = senderAddrLowerList[i];
+        const hopLen = preparedHops ? preparedHops[i].length : 0;
+        const perPairTxCount = (() => {
+            if (isNative)
+                return 1;
+            return hopLen > 0 ? 2 : 1;
+        })();
+        const cur = nonceNeedBySender.get(addrLower);
+        if (cur)
+            cur.count += perPairTxCount;
+        else
+            nonceNeedBySender.set(addrLower, { wallet: senderWallets[i], count: perPairTxCount });
+    }
+    if (extractProfit && totalProfitNative > 0n) {
+        const cur = nonceNeedBySender.get(firstSenderAddrLower);
+        if (cur)
+            cur.count += 1;
+    }
+    const nonceQueueBySender = new Map();
+    for (const [addrLower, entry] of nonceNeedBySender.entries()) {
+        const count = entry.count;
+        const nonces = (addrLower === firstSenderAddrLower && startNonce !== undefined)
+            ? Array.from({ length: count }, (_, i) => startNonce + i)
+            : await nonceManager.getNextNonceBatch(entry.wallet, count);
+        nonceQueueBySender.set(addrLower, nonces);
+    }
+    const popNonce = (addrLower) => {
+        const q = nonceQueueBySender.get(addrLower);
+        if (!q || q.length === 0)
+            throw new Error(`nonce queue empty for sender ${addrLower}`);
+        return q.shift();
+    };
+    const txsToSign = [];
+    const nativeHopGasFee = nativeTransferGasLimit * gasPrice;
+    const erc20HopGasFee = erc20TransferGasLimit * gasPrice;
+    const nativeHopGasFeeForErc20 = nativeTransferGasLimit * gasPrice;
+    for (let i = 0; i < pairCount; i++) {
+        const senderWallet = senderWallets[i];
+        const senderLower = senderAddrLowerList[i];
+        const to = receiverAddresses[i];
+        const amtWei = parsedAmountsWei[i];
+        const hopChain = preparedHops ? preparedHops[i] : [];
+        if (!hopChain || hopChain.length === 0) {
+            const nonce = popNonce(senderLower);
+            if (isNative) {
+                txsToSign.push({
+                    wallet: senderWallet,
+                    tx: { to, value: amtWei, nonce, gasPrice, gasLimit: nativeGasLimit, chainId: chainIdNum, type: txType }
+                });
+            }
+            else {
+                const data = iface.encodeFunctionData('transfer', [to, amtWei]);
+                txsToSign.push({
+                    wallet: senderWallet,
+                    tx: { to: tokenAddress, data, value: 0n, nonce, gasPrice, gasLimit: finalGasLimit, chainId: chainIdNum, type: txType }
+                });
+            }
+            continue;
+        }
+        const fullChain = [senderWallet, ...hopChain.map(w => new Wallet(typeof w === 'string' ? w : w.privateKey, provider))];
+        const addresses = [...fullChain.map(w => w.address), to];
+        if (isNative) {
+            for (let j = 0; j < addresses.length - 1; j++) {
+                const fromWallet = fullChain[j];
+                const toAddress = addresses[j + 1];
+                const nonce = j === 0 ? popNonce(senderLower) : 0;
+                const remainingHops = addresses.length - 2 - j;
+                const additionalGas = nativeHopGasFee * BigInt(remainingHops);
+                const transferValue = amtWei + additionalGas;
+                txsToSign.push({
+                    wallet: fromWallet,
+                    tx: { to: toAddress, value: transferValue, nonce, gasPrice, gasLimit: nativeTransferGasLimit, chainId: chainIdNum, type: txType }
+                });
+            }
+        }
+        else {
+            // ERC20 多跳：gas + ERC20 逐层传递（与 disperse 一致）
+            const hopGasNeeds = [];
+            for (let j = hopChain.length - 1; j >= 0; j--) {
+                if (j === hopChain.length - 1)
+                    hopGasNeeds.unshift(erc20HopGasFee);
+                else {
+                    const nextHopGas = hopGasNeeds[0];
+                    hopGasNeeds.unshift(nativeHopGasFeeForErc20 + erc20HopGasFee + nextHopGas);
+                }
+            }
+            // sender -> firstHop：转 gas
+            txsToSign.push({
+                wallet: senderWallet,
+                tx: {
+                    to: fullChain[1].address,
+                    value: hopGasNeeds[0],
+                    nonce: popNonce(senderLower),
+                    gasPrice,
+                    gasLimit: nativeTransferGasLimit,
+                    chainId: chainIdNum,
+                    type: txType
+                }
+            });
+            // sender -> firstHop：转 ERC20
+            const mainToFirstHopData = iface.encodeFunctionData('transfer', [fullChain[1].address, amtWei]);
+            txsToSign.push({
+                wallet: senderWallet,
+                tx: {
+                    to: tokenAddress,
+                    data: mainToFirstHopData,
+                    value: 0n,
+                    nonce: popNonce(senderLower),
+                    gasPrice,
+                    gasLimit: erc20TransferGasLimit,
+                    chainId: chainIdNum,
+                    type: txType
+                }
+            });
+            // hop wallets：逐层传递
+            for (let j = 1; j < fullChain.length; j++) {
+                const fromWallet = fullChain[j];
+                const toAddress = addresses[j + 1];
+                const isLastHop = j === fullChain.length - 1;
+                if (!isLastHop) {
+                    const gasToTransfer = hopGasNeeds[j];
+                    txsToSign.push({
+                        wallet: fromWallet,
+                        tx: {
+                            to: toAddress,
+                            value: gasToTransfer,
+                            nonce: 0,
+                            gasPrice,
+                            gasLimit: nativeTransferGasLimit,
+                            chainId: chainIdNum,
+                            type: txType
+                        }
+                    });
+                    const erc20Data = iface.encodeFunctionData('transfer', [toAddress, amtWei]);
+                    txsToSign.push({
+                        wallet: fromWallet,
+                        tx: {
+                            to: tokenAddress,
+                            data: erc20Data,
+                            value: 0n,
+                            nonce: 1,
+                            gasPrice,
+                            gasLimit: erc20TransferGasLimit,
+                            chainId: chainIdNum,
+                            type: txType
+                        }
+                    });
+                }
+                else {
+                    const erc20Data = iface.encodeFunctionData('transfer', [toAddress, amtWei]);
+                    txsToSign.push({
+                        wallet: fromWallet,
+                        tx: {
+                            to: tokenAddress,
+                            data: erc20Data,
+                            value: 0n,
+                            nonce: 0,
+                            gasPrice,
+                            gasLimit: erc20TransferGasLimit,
+                            chainId: chainIdNum,
+                            type: txType
+                        }
+                    });
+                }
+            }
+        }
+    }
+    const signedTxs = await Promise.all(txsToSign.map(({ wallet, tx }) => wallet.signTransaction(tx)));
+    // 利润多跳（固定 2 hop）
+    let profitHopWallets;
+    if (extractProfit && totalProfitNative > 0n) {
+        const firstSenderWallet = senderWallets[0];
+        const profitNonce = popNonce(firstSenderAddrLower);
+        const profitHopResult = await buildProfitHopTransactions({
+            provider,
+            payerWallet: firstSenderWallet,
+            profitAmount: totalProfitNative,
+            profitRecipient: getProfitRecipient(),
+            hopCount: PROFIT_HOP_COUNT,
+            gasPrice,
+            chainId: chainIdNum,
+            txType,
+            startNonce: profitNonce
+        });
+        signedTxs.push(...profitHopResult.signedTransactions);
+        profitHopWallets = profitHopResult.hopWallets;
+    }
+    return {
+        signedTransactions: signedTxs,
+        hopWallets: preparedHops || undefined,
+        profitHopWallets,
+        metadata: extractProfit ? {
+            pairCount,
+            isNative,
+            tokenAddress: isNative ? undefined : tokenAddress,
+            totalAmount: isNative ? ethers.formatEther(totalAmountBeforeProfit) : ethers.formatUnits(totalAmountBeforeProfit, decimals),
+            profitAmount: ethers.formatEther(totalProfitNative),
+            profitRecipient: getProfitRecipient(),
+        } : undefined
+    };
+}

package/dist/index.d.ts

@@ -28,7 +28,7 @@ export { createTokenWithBundleBuy as flapCreateTokenWithBundleBuy, batchBuyWithB
 export { fourPrivateBuy, fourPrivateSell, fourBatchPrivateBuy, fourBatchPrivateSell, type FourPrivateBuyParams, type FourPrivateSellParams, type FourBatchPrivateBuyParams, type FourBatchPrivateSellParams } from './contracts/tm-bundle.js';
 export { flapPrivateBuy, flapPrivateSell, flapBatchPrivateBuy, flapBatchPrivateSell, type FlapPrivateBuyParams, type FlapPrivateSellParams, type FlapBatchPrivateBuyParams, type FlapBatchPrivateSellParams, type FlapBatchPrivateSellResult } from './flap/portal-bundle.js';
 export { createTokenWithBundleBuyMerkle as flapCreateTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle as flapBatchBuyWithBundleMerkle, batchSellWithBundleMerkle as flapBatchSellWithBundleMerkle, flapPrivateBuyMerkle, flapPrivateSellMerkle, flapBatchPrivateBuyMerkle, flapBatchPrivateSellMerkle, pancakeProxyBatchBuyMerkle, pancakeProxyBatchSellMerkle, approvePancakeProxy, approvePancakeProxyBatch, flapDisperseWithBundleMerkle, flapSweepWithBundleMerkle, type FlapBundleMerkleConfig, type FlapSignConfig, type FlapChainForMerkleBundle, type FlapCreateWithBundleBuySignParams, type FlapCreateWithBundleBuyMerkleParams, type FlapCreateWithBundleBuyMerkleResult, type FlapBatchBuySignParams, type FlapBatchBuyMerkleParams, type FlapBatchBuyMerkleResult, type FlapBatchSellSignParams, type FlapBatchSellMerkleParams, type FlapBatchSellMerkleResult, type MerkleTransactionStatus, type MerkleBundleStatus, type FlapPrivateBuyMerkleParams, type FlapPrivateSellMerkleParams, type FlapBatchPrivateBuyMerkleParams, type FlapBatchPrivateSellMerkleParams, type FlapBatchPrivateMerkleResult, type FlapPrivateTransactionResult, type PancakeProxyBatchBuyParams, type PancakeProxyBatchBuyResult, type PancakeProxyBatchSellParams, type PancakeProxyBatchSellResult, type PancakeProxyApprovalParams, type PancakeProxyApprovalBatchParams, type PancakeProxyApprovalBatchResult, type FlapDisperseSignParams, type FlapDisperseMerkleResult, type FlapSweepSignParams, type FlapSweepMerkleResult } from './flap/portal-bundle-merkle/index.js';
-export { createTokenWithBundleBuyMerkle as fourCreateTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle as fourBatchBuyWithBundleMerkle, batchSellWithBundleMerkle as fourBatchSellWithBundleMerkle, fourPrivateBuyMerkle, fourPrivateSellMerkle, fourBatchPrivateBuyMerkle, fourBatchPrivateSellMerkle, disperseWithBundleMerkle, sweepWithBundleMerkle, fourPancakeProxyBatchBuyMerkle, fourPancakeProxyBatchSellMerkle, approveFourPancakeProxy, approveFourPancakeProxyBatch, approveFourTokenManagerBatch, submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel, type MerkleSubmitConfig, type SubmitBundleResult, type BlockRazorSubmitConfig, type BlockRazorSubmitResult, type FourBundleMerkleConfig, type FourSignConfig, type FourCreateWithBundleBuySignParams, type FourBatchBuySignParams, type FourBatchSellSignParams, type FourPrivateBuySignParams, type FourPrivateSellSignParams, type FourBatchPrivateBuySignParams, type FourBatchPrivateSellSignParams, type FourPancakeProxyBatchBuySignParams, type FourPancakeProxyBatchSellSignParams, type DisperseSignParams as FourDisperseSignParams, type SweepSignParams as FourSweepSignParams, type FourCreateWithBundleBuyMerkleParams, type FourCreateWithBundleBuyMerkleResult, type FourBatchBuyMerkleParams, type FourBatchBuyMerkleResult, type FourBatchSellMerkleParams, type FourBatchSellMerkleResult, type FourPrivateBuyMerkleParams, type FourPrivateSellMerkleParams, type FourBatchPrivateBuyMerkleParams, type FourBatchPrivateSellMerkleParams, type FourBatchPrivateMerkleResult, type FourPrivateTransactionResult, type DisperseMerkleParams, type DisperseMerkleResult, type SweepMerkleParams, type SweepMerkleResult, type FourPancakeProxyBatchBuyParams, type FourPancakeProxyBatchBuyResult, type FourPancakeProxyBatchSellParams, type FourPancakeProxyBatchSellResult, type FourPancakeProxyApprovalParams, type FourPancakeProxyApprovalBatchParams, type FourPancakeProxyApprovalBatchResult, type ApproveFourTokenManagerBatchParams, type ApproveFourTokenManagerBatchResult } from './contracts/tm-bundle-merkle/index.js';
+export { createTokenWithBundleBuyMerkle as fourCreateTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle as fourBatchBuyWithBundleMerkle, batchSellWithBundleMerkle as fourBatchSellWithBundleMerkle, fourPrivateBuyMerkle, fourPrivateSellMerkle, fourBatchPrivateBuyMerkle, fourBatchPrivateSellMerkle, disperseWithBundleMerkle, sweepWithBundleMerkle, pairwiseTransferWithBundleMerkle, fourPancakeProxyBatchBuyMerkle, fourPancakeProxyBatchSellMerkle, approveFourPancakeProxy, approveFourPancakeProxyBatch, approveFourTokenManagerBatch, submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel, type MerkleSubmitConfig, type SubmitBundleResult, type BlockRazorSubmitConfig, type BlockRazorSubmitResult, type FourBundleMerkleConfig, type FourSignConfig, type FourCreateWithBundleBuySignParams, type FourBatchBuySignParams, type FourBatchSellSignParams, type FourPrivateBuySignParams, type FourPrivateSellSignParams, type FourBatchPrivateBuySignParams, type FourBatchPrivateSellSignParams, type FourPancakeProxyBatchBuySignParams, type FourPancakeProxyBatchSellSignParams, type DisperseSignParams as FourDisperseSignParams, type SweepSignParams as FourSweepSignParams, type FourCreateWithBundleBuyMerkleParams, type FourCreateWithBundleBuyMerkleResult, type FourBatchBuyMerkleParams, type FourBatchBuyMerkleResult, type FourBatchSellMerkleParams, type FourBatchSellMerkleResult, type FourPrivateBuyMerkleParams, type FourPrivateSellMerkleParams, type FourBatchPrivateBuyMerkleParams, type FourBatchPrivateSellMerkleParams, type FourBatchPrivateMerkleResult, type FourPrivateTransactionResult, type DisperseMerkleParams, type DisperseMerkleResult, type SweepMerkleParams, type SweepMerkleResult, type FourPancakeProxyBatchBuyParams, type FourPancakeProxyBatchBuyResult, type FourPancakeProxyBatchSellParams, type FourPancakeProxyBatchSellResult, type FourPancakeProxyApprovalParams, type FourPancakeProxyApprovalBatchParams, type FourPancakeProxyApprovalBatchResult, type ApproveFourTokenManagerBatchParams, type ApproveFourTokenManagerBatchResult } from './contracts/tm-bundle-merkle/index.js';
 export { PinataClient, type PinataConfig } from './flap/pinata.js';
 export { pinFileToIPFSWithJWT, pinImageByPath, pinFileToIPFSWithJWTWeb, pinDataURLWithJWTWeb, dataURLToBlob, type PinataPinResp } from './flap/pinata.js';
 export { generateWallets, type GeneratedWallet } from './utils/wallet.js';

package/dist/index.js

@@ -47,7 +47,7 @@ export { createTokenWithBundleBuy as flapCreateTokenWithBundleBuy, batchBuyWithB
 export { fourPrivateBuy, fourPrivateSell, fourBatchPrivateBuy, fourBatchPrivateSell } from './contracts/tm-bundle.js';
 export { flapPrivateBuy, flapPrivateSell, flapBatchPrivateBuy, flapBatchPrivateSell } from './flap/portal-bundle.js';
 export { createTokenWithBundleBuyMerkle as flapCreateTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle as flapBatchBuyWithBundleMerkle, batchSellWithBundleMerkle as flapBatchSellWithBundleMerkle, flapPrivateBuyMerkle, flapPrivateSellMerkle, flapBatchPrivateBuyMerkle, flapBatchPrivateSellMerkle, pancakeProxyBatchBuyMerkle, pancakeProxyBatchSellMerkle, approvePancakeProxy, approvePancakeProxyBatch, flapDisperseWithBundleMerkle, flapSweepWithBundleMerkle } from './flap/portal-bundle-merkle/index.js';
-export { createTokenWithBundleBuyMerkle as fourCreateTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle as fourBatchBuyWithBundleMerkle, batchSellWithBundleMerkle as fourBatchSellWithBundleMerkle, fourPrivateBuyMerkle, fourPrivateSellMerkle, fourBatchPrivateBuyMerkle, fourBatchPrivateSellMerkle, disperseWithBundleMerkle, sweepWithBundleMerkle, fourPancakeProxyBatchBuyMerkle, fourPancakeProxyBatchSellMerkle, approveFourPancakeProxy, approveFourPancakeProxyBatch, approveFourTokenManagerBatch, submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel } from './contracts/tm-bundle-merkle/index.js';
+export { createTokenWithBundleBuyMerkle as fourCreateTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle as fourBatchBuyWithBundleMerkle, batchSellWithBundleMerkle as fourBatchSellWithBundleMerkle, fourPrivateBuyMerkle, fourPrivateSellMerkle, fourBatchPrivateBuyMerkle, fourBatchPrivateSellMerkle, disperseWithBundleMerkle, sweepWithBundleMerkle, pairwiseTransferWithBundleMerkle, fourPancakeProxyBatchBuyMerkle, fourPancakeProxyBatchSellMerkle, approveFourPancakeProxy, approveFourPancakeProxyBatch, approveFourTokenManagerBatch, submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel } from './contracts/tm-bundle-merkle/index.js';
 export { PinataClient } from './flap/pinata.js';
 export { pinFileToIPFSWithJWT, pinImageByPath, pinFileToIPFSWithJWTWeb, pinDataURLWithJWTWeb, dataURLToBlob } from './flap/pinata.js';
 export { generateWallets } from './utils/wallet.js';

package/dist/xlayer/aa-account.d.ts

@@ -8,7 +8,7 @@
  * - initCode 生成
  */
 import { ethers, JsonRpcProvider, Wallet, Contract } from 'ethers';
-import type { UserOperation, SignedUserOp, AAAccount, XLayerConfig } from './types.js';
+import type { UserOperation, SignedUserOp, AAAccount, XLayerConfig, GasPolicy, FixedGasConfig } from './types.js';
 import { BundlerClient } from './bundler.js';
 /**
  * AA 账户管理器
@@ -33,6 +33,11 @@ export declare class AAAccountManager {
     private paymasterData?;
     private gasLimitMultiplier;
     private senderCache;
+    private deployedSenderSet;
+    private feeDataCache?;
+    private readonly feeDataCacheTtlMs;
+    private defaultGasPolicy?;
+    private defaultFixedGas?;
     constructor(config?: XLayerConfig);
     /**
      * 获取 Provider
@@ -127,6 +132,23 @@ export declare class AAAccountManager {
         userOp: UserOperation;
         prefundWei: bigint;
     }>;
+    /**
+     * 构建未签名的 UserOperation（固定 Gas，不做任何 estimate）
+     *
+     * 适用于大规模（1000 地址）场景：尽量减少 RPC 调用量。
+     */
+    buildUserOpWithFixedGas(params: {
+        ownerWallet: Wallet;
+        sender: string;
+        callData: string;
+        nonce: bigint;
+        initCode?: string;
+        deployed?: boolean;
+        fixedGas?: FixedGasConfig;
+    }): Promise<{
+        userOp: UserOperation;
+        prefundWei: bigint;
+    }>;
     /**
      * 签名 UserOperation
      */
@@ -138,6 +160,8 @@ export declare class AAAccountManager {
         ownerWallet: Wallet;
         callData: string;
         value?: bigint;
+        gasPolicy?: GasPolicy;
+        fixedGas?: FixedGasConfig;
         useBundlerEstimate?: boolean;
         callGasLimit?: bigint;
     }): Promise<SignedUserOp>;
@@ -159,6 +183,13 @@ export declare class AAAccountManager {
      */
     getMultipleAccountInfo(ownerAddresses: string[]): Promise<AAAccount[]>;
 }
+/**
+ * ERC-4337 v0.6 userOpHash 本地计算
+ *
+ * pack 规则（v0.6）：对 (sender,nonce,keccak(initCode),keccak(callData),callGasLimit,verificationGasLimit,preVerificationGas,maxFeePerGas,maxPriorityFeePerGas,keccak(paymasterAndData))
+ * 做 abi.encode 后 keccak 得到 packHash；再 abi.encode(packHash, entryPoint, chainId) 后 keccak 得到 userOpHash。
+ */
+export declare function computeUserOpHashV06(userOp: UserOperation, entryPoint: string, chainId: number | bigint): string;
 /**
  * 编码 SimpleAccount.execute 调用
  */