four-flap-meme-sdk 3.0.0 → 4.0.0

package/dist/chains/xlayer/eip7702/multi-hop-transfer-sweep.js

@@ -0,0 +1,220 @@
+/**
+ * multi-hop-transfer - 归集 (Sweep) 多对一
+ */
+import { ethers, Contract } from 'ethers';
+import { createWallet, signAuthorizationsWithNonces, batchGetNonces, buildEIP7702TransactionSync } from './utils.js';
+import { ERC20_ABI, XLAYER_CHAIN_ID } from './constants.js';
+import { calculateTransferFee } from '../../../core/constants/index.js';
+import { createEip7702DelegateContext, generateHopWalletMatrix, isNativeTransferToken, resolveListPayerWallet, } from './transfer-context-helpers.js';
+export async function sweep(params) {
+    const { targetAddress, sourcePrivateKeys, payerPrivateKey, tokenAddress, tokenDecimals = 18, hopCount = 0, reserveGas = true, percent = 100, userType, config, } = params;
+    const { provider, delegateAddress, delegateInterface, profitRecipient } = createEip7702DelegateContext(config);
+    const sourceWallets = sourcePrivateKeys.map((pk) => createWallet(pk, provider));
+    const isNative = isNativeTransferToken(tokenAddress);
+    const { allHopWalletInfos, allHopWallets } = generateHopWalletMatrix(sourceWallets.length, hopCount, provider);
+    const { payerWallet } = resolveListPayerWallet(sourcePrivateKeys, payerPrivateKey, provider);
+    const mainWallet = payerWallet ?? sourceWallets[0];
+    // ========================================
+    // 并行获取数据
+    // ========================================
+    const sourceAddresses = sourceWallets.map((w) => w.address);
+    const addressesToGetNonces = payerWallet ? [payerWallet.address, ...sourceAddresses] : sourceAddresses;
+    const [allNoncesResult, feeData, balancesRaw] = await Promise.all([
+        batchGetNonces(addressesToGetNonces, provider),
+        provider.getFeeData(),
+        isNative
+            ? Promise.all(sourceWallets.map((w) => provider.getBalance(w.address)))
+            : Promise.all(sourceWallets.map((w) => {
+                if (!tokenAddress)
+                    throw new Error('tokenAddress is required for ERC20 sweep');
+                const tokenContract = new Contract(tokenAddress, ERC20_ABI, provider);
+                return tokenContract.balanceOf(w.address);
+            })),
+    ]);
+    const payerNonce = payerWallet ? allNoncesResult[0] : allNoncesResult[0];
+    const nonces = payerWallet ? allNoncesResult.slice(1) : allNoncesResult;
+    const balances = balancesRaw;
+    // 计算转账金额
+    // ✅ 修复：当 percent=100 时，不预留 gas，归集全部余额
+    const isFullSweep = percent >= 100;
+    const gasReserve = reserveGas && isNative && !isFullSweep ? ethers.parseEther('0.001') : 0n;
+    const percentBigInt = BigInt(Math.min(100, Math.max(1, percent)));
+    const transferAmounts = balances.map((b) => {
+        if (isFullSweep) {
+            // 100% 归集：使用全部余额
+            return b;
+        }
+        const afterReserve = b > gasReserve ? b - gasReserve : 0n;
+        return (afterReserve * percentBigInt) / 100n;
+    });
+    const totalAmount = transferAmounts.reduce((sum, amt) => sum + amt, 0n);
+    // ✅ 按地址数量收取固定费用（原生 OKB）
+    const profitAmountOkb = calculateTransferFee(XLAYER_CHAIN_ID, sourceWallets.length);
+    // ✅ 找出归集金额最大的钱包（用于支付 OKB 利润）
+    let maxSweepIndex = -1;
+    let maxSweepAmount = 0n;
+    for (let i = 0; i < transferAmounts.length; i++) {
+        if (transferAmounts[i] > maxSweepAmount) {
+            maxSweepAmount = transferAmounts[i];
+            maxSweepIndex = i;
+        }
+    }
+    // ========================================
+    // 构建调用
+    // ========================================
+    const calls = [];
+    for (let i = 0; i < sourceWallets.length; i++) {
+        const sourceWallet = sourceWallets[i];
+        const amount = transferAmounts[i];
+        const hopWallets = allHopWallets[i];
+        if (amount <= 0n)
+            continue;
+        // ✅ 使用 Payer 时所有源钱包都用自己的余额（value: 0n）
+        const callValue = payerWallet || i > 0 ? 0n : amount;
+        if (hopCount === 0 || hopWallets.length === 0) {
+            // ========================================
+            // 直接归集：源钱包 → 目标地址
+            // ========================================
+            // ✅ 最大归集钱包负责转 OKB 固定费用
+            if (profitAmountOkb > 0n && i === maxSweepIndex) {
+                calls.push({
+                    target: sourceWallet.address,
+                    allowFailure: false,
+                    value: 0n,
+                    callData: delegateInterface.encodeFunctionData('transferAmount', [profitRecipient, profitAmountOkb]),
+                });
+            }
+            if (isNative) {
+                // ✅ 原生 OKB 归集
+                calls.push({
+                    target: sourceWallet.address,
+                    allowFailure: false,
+                    value: callValue,
+                    callData: delegateInterface.encodeFunctionData('transferAmount', [targetAddress, amount]),
+                });
+            }
+            else {
+                // ✅ ERC20 归集
+                calls.push({
+                    target: sourceWallet.address,
+                    allowFailure: false,
+                    value: 0n,
+                    callData: delegateInterface.encodeFunctionData('executeTransfer', [tokenAddress, targetAddress, amount]),
+                });
+            }
+        }
+        else {
+            // ========================================
+            // 多跳归集：源钱包 → hop1 → hop2 → ... → 目标地址
+            // ========================================
+            const firstHop = hopWallets[0];
+            const lastHop = hopWallets[hopWallets.length - 1];
+            // ✅ 最大归集钱包负责转 OKB 固定费用（在归集前）
+            if (profitAmountOkb > 0n && i === maxSweepIndex) {
+                calls.push({
+                    target: sourceWallet.address,
+                    allowFailure: false,
+                    value: 0n,
+                    callData: delegateInterface.encodeFunctionData('transferAmount', [profitRecipient, profitAmountOkb]),
+                });
+            }
+            if (isNative) {
+                // 源钱包 → 第一个中间钱包
+                // ✅ 修复：使用 transferAmount 替代 transferTo，支持百分比归集
+                calls.push({
+                    target: sourceWallet.address,
+                    allowFailure: false,
+                    value: callValue,
+                    callData: delegateInterface.encodeFunctionData('transferAmount', [firstHop.address, amount]),
+                });
+                // 中间钱包之间转账
+                for (let j = 0; j < hopWallets.length - 1; j++) {
+                    calls.push({
+                        target: hopWallets[j].address,
+                        allowFailure: false,
+                        value: 0n,
+                        callData: delegateInterface.encodeFunctionData('transferTo', [hopWallets[j + 1].address]),
+                    });
+                }
+                // 最后一个中间钱包 → 目标地址
+                calls.push({
+                    target: lastHop.address,
+                    allowFailure: false,
+                    value: 0n,
+                    callData: delegateInterface.encodeFunctionData('transferTo', [targetAddress]),
+                });
+            }
+            else {
+                // ERC20 多跳
+                // 源钱包 → 第一个中间钱包（ERC20 代币）
+                calls.push({
+                    target: sourceWallet.address,
+                    allowFailure: false,
+                    value: 0n,
+                    callData: delegateInterface.encodeFunctionData('executeTransfer', [tokenAddress, firstHop.address, amount]),
+                });
+                // 中间钱包之间转账
+                for (let j = 0; j < hopWallets.length - 1; j++) {
+                    calls.push({
+                        target: hopWallets[j].address,
+                        allowFailure: false,
+                        value: 0n,
+                        callData: delegateInterface.encodeFunctionData('executeTransferAll', [
+                            tokenAddress,
+                            hopWallets[j + 1].address,
+                        ]),
+                    });
+                }
+                // 最后一个中间钱包 → 目标地址
+                calls.push({
+                    target: lastHop.address,
+                    allowFailure: false,
+                    value: 0n,
+                    callData: delegateInterface.encodeFunctionData('executeTransferAll', [tokenAddress, targetAddress]),
+                });
+            }
+        }
+    }
+    // ========================================
+    // 同步签署授权（已有 nonce）
+    // ========================================
+    // ✅ 收集所有需要授权的钱包
+    const allWallets = payerWallet ? [payerWallet] : [];
+    const allNonces = payerWallet ? [payerNonce] : [];
+    // 添加源钱包
+    for (let i = 0; i < sourceWallets.length; i++) {
+        allWallets.push(sourceWallets[i]);
+        allNonces.push(nonces[i]);
+    }
+    // 添加所有中间钱包
+    for (const hopWallets of allHopWallets) {
+        for (const hopWallet of hopWallets) {
+            allWallets.push(hopWallet);
+            allNonces.push(0);
+        }
+    }
+    const authorizations = signAuthorizationsWithNonces(allWallets, allNonces, delegateAddress, 0);
+    // ========================================
+    // 同步构建交易
+    // ========================================
+    // ✅ Payer 模式下 value 为 0（资金来自源钱包）
+    const totalValue = isNative && !payerWallet ? transferAmounts[0] : 0n;
+    const signedTransaction = buildEIP7702TransactionSync(mainWallet, authorizations, calls, totalValue, payerWallet ? payerNonce : nonces[0], feeData, config);
+    // ✅ 返回所有中间钱包（扁平化）
+    const flatHopWallets = allHopWalletInfos.flat();
+    return {
+        signedTransaction,
+        hopWallets: flatHopWallets.length > 0 ? flatHopWallets : undefined,
+        metadata: {
+            targetAddress,
+            sourceCount: sourceWallets.length,
+            totalAmount: isNative ? ethers.formatEther(totalAmount) : ethers.formatUnits(totalAmount, tokenDecimals),
+            profitAmount: ethers.formatEther(profitAmountOkb), // ✅ 以 OKB 计
+            isNative,
+            tokenAddress: tokenAddress ?? null,
+            hopCount,
+            percent,
+            userType,
+        },
+    };
+}

package/dist/chains/xlayer/eip7702/multi-hop-transfer.d.ts

@@ -1,8 +1,12 @@
-import { DisperseParams, SweepParams, PairwiseTransferParams, PairwiseTransferResult, TransferResult } from './multi-hop-transfer-helpers.js';
+/**
+ * multi-hop-transfer - 主函数
+ */
+import { disperse } from './multi-hop-transfer-disperse.js';
+import { sweep } from './multi-hop-transfer-sweep.js';
+export { disperse } from './multi-hop-transfer-disperse.js';
+export { sweep } from './multi-hop-transfer-sweep.js';
+export { pairwiseTransfer } from './multi-hop-transfer-pairwise.js';
 export type { DisperseParams, SweepParams, PairwiseTransferParams, PairwiseTransferResult, TransferResult, } from './multi-hop-transfer-helpers.js';
-export declare function disperse(params: DisperseParams): Promise<TransferResult>;
-export declare function sweep(params: SweepParams): Promise<TransferResult>;
-export declare function pairwiseTransfer(params: PairwiseTransferParams): Promise<PairwiseTransferResult>;
 /** @deprecated 使用 disperse 替代 */
 export declare const disperseWithHops: typeof disperse;
 /** @deprecated 使用 sweep 替代 */