four-flap-meme-sdk 3.0.0 → 4.0.0

package/dist/domains/flap/portal-bundle-merkle/utils/disperse.js

@@ -0,0 +1,275 @@
+import { ethers, Wallet } from 'ethers';
+import { getOptimizedGasPrice, NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../../../utils/bundle-helpers.js';
+import { GAS_LIMITS, calculateTransferFee } from '../../../../core/constants/index.js';
+import { CHAIN_ID_MAP, getTxType, getGasPriceConfig, shouldExtractProfit, getProfitRecipient } from '../config.js';
+import { calculateGasLimit, generateHopWallets, getErc20Decimals, isNativeTokenAddress, normalizeAmounts, } from '../../../../bundle/internal.js';
+import { createSignProvider, createSignWallet, normalizeItemsOrRecipientsAmounts, resolveHopCountInput, resolveProvidedHops, } from '../../../../bundle/sign-context-helpers.js';
+export async function flapDisperseWithBundleMerkle(params) {
+    const { chain, fromPrivateKey, recipients, amount, amounts, tokenAddress, tokenDecimals, hopCount = 0, hopPrivateKeys, items, config, startNonce, } = params;
+    if (!recipients || recipients.length === 0) {
+        return { signedTransactions: [], hopWallets: undefined };
+    }
+    const chainIdNum = CHAIN_ID_MAP[chain] ?? 56;
+    const provider = createSignProvider(config.rpcUrl, chainIdNum, chain);
+    const mainWallet = createSignWallet(fromPrivateKey, provider);
+    const isNative = isNativeTokenAddress(tokenAddress);
+    const txType = getTxType(config);
+    const normalizedAmounts = normalizeItemsOrRecipientsAmounts(recipients, items, amount, amounts, normalizeAmounts);
+    const providedHops = resolveProvidedHops(recipients.length, hopPrivateKeys, items);
+    const hopCountInput = resolveHopCountInput(recipients.length, hopCount, items);
+    const preparedHops = providedHops ?? generateHopWallets(recipients.length, hopCountInput);
+    const hasHops = preparedHops !== null;
+    const maxHopCount = preparedHops ? Math.max(...preparedHops.map((h) => h.length)) : 0;
+    const finalGasLimit = calculateGasLimit(config, isNative, hasHops, maxHopCount);
+    const nativeGasLimit = GAS_LIMITS.BRIBE;
+    const signedTxs = [];
+    const extractProfit = shouldExtractProfit();
+    const profitAddr = getProfitRecipient();
+    let totalProfit = 0n;
+    let totalAmountBeforeProfit = 0n;
+    let profitHopWallets; // ✅ 收集利润多跳钱包
+    const nonceManager = new NonceManager(provider);
+    if (!preparedHops) {
+        // ========== 无多跳：直接批量转账 ==========
+        const extraTxCount = extractProfit ? 1 : 0;
+        const totalTxCount = recipients.length + extraTxCount;
+        const [gasPrice, nonces] = await Promise.all([
+            getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+            startNonce !== undefined
+                ? Promise.resolve(Array.from({ length: totalTxCount }, (_, i) => startNonce + i))
+                : nonceManager.getNextNonceBatch(mainWallet, totalTxCount),
+        ]);
+        // ✅ 按地址数量收取固定费用（原生代币）
+        if (extractProfit) {
+            totalProfit = calculateTransferFee(chainIdNum, recipients.length);
+        }
+        if (isNative) {
+            const txDataList = recipients.map((to, i) => {
+                const originalAmount = ethers.parseEther(normalizedAmounts[i]);
+                totalAmountBeforeProfit += originalAmount;
+                // ✅ 不再从转账金额中扣除利润，全额转账
+                return { to, value: originalAmount, nonce: nonces[i] };
+            });
+            const txPromises = txDataList.map(({ to, value, nonce }) => mainWallet.signTransaction({
+                to,
+                value,
+                nonce,
+                gasPrice,
+                gasLimit: nativeGasLimit,
+                chainId: chainIdNum,
+                type: txType,
+            }));
+            signedTxs.push(...(await Promise.all(txPromises)));
+        }
+        else {
+            const decimals = tokenDecimals ?? (await getErc20Decimals(provider, tokenAddress));
+            const iface = new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
+            const txDataList = recipients.map((to, i) => {
+                const originalAmount = ethers.parseUnits(normalizedAmounts[i], decimals);
+                totalAmountBeforeProfit += originalAmount;
+                // ✅ 不再从转账金额中扣除利润，全额转账
+                const data = iface.encodeFunctionData('transfer', [to, originalAmount]);
+                return { data, nonce: nonces[i] };
+            });
+            const txPromises = txDataList.map(({ data, nonce }) => mainWallet.signTransaction({
+                to: tokenAddress,
+                data,
+                value: 0n,
+                nonce,
+                gasPrice,
+                gasLimit: finalGasLimit,
+                chainId: chainIdNum,
+                type: txType,
+            }));
+            signedTxs.push(...(await Promise.all(txPromises)));
+        }
+        // ✅ 利润多跳转账（固定费用，原生代币）
+        if (extractProfit && totalProfit > 0n) {
+            const profitHopResult = await buildProfitHopTransactions({
+                provider,
+                payerWallet: mainWallet,
+                profitAmount: totalProfit,
+                profitRecipient: profitAddr,
+                hopCount: PROFIT_HOP_COUNT,
+                gasPrice,
+                chainId: chainIdNum,
+                txType,
+                startNonce: nonces[recipients.length],
+            });
+            signedTxs.push(...profitHopResult.signedTransactions);
+            profitHopWallets = profitHopResult.hopWallets;
+        }
+    }
+    else {
+        // ========== 有多跳：构建跳转链 ==========
+        const [gasPrice, decimals] = await Promise.all([
+            getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+            isNative
+                ? Promise.resolve(18)
+                : Promise.resolve(tokenDecimals ?? (await getErc20Decimals(provider, tokenAddress))),
+        ]);
+        const iface = isNative ? null : new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
+        const gasFeePerHop = finalGasLimit * gasPrice;
+        let mainWalletNonceCount = 0;
+        for (let i = 0; i < recipients.length; i++) {
+            const hopChain = preparedHops[i];
+            if (hopChain.length === 0) {
+                mainWalletNonceCount += 1;
+            }
+            else {
+                const nonceNeed = isNative ? 1 : hopChain.length + 1;
+                mainWalletNonceCount += nonceNeed;
+            }
+        }
+        if (extractProfit)
+            mainWalletNonceCount += 1;
+        const allMainNonces = startNonce !== undefined
+            ? Array.from({ length: mainWalletNonceCount }, (_, i) => startNonce + i)
+            : await nonceManager.getNextNonceBatch(mainWallet, mainWalletNonceCount);
+        let mainNonceIdx = 0;
+        const txsToSign = [];
+        // ✅ 按地址数量收取固定费用（原生代币）
+        if (extractProfit) {
+            totalProfit = calculateTransferFee(chainIdNum, recipients.length);
+        }
+        for (let i = 0; i < recipients.length; i++) {
+            const finalRecipient = recipients[i];
+            const originalAmountWei = isNative
+                ? ethers.parseEther(normalizedAmounts[i])
+                : ethers.parseUnits(normalizedAmounts[i], decimals);
+            totalAmountBeforeProfit += originalAmountWei;
+            // ✅ 不再从转账金额中扣除利润，全额转账
+            const amountWei = originalAmountWei;
+            const hopChain = preparedHops[i];
+            if (hopChain.length === 0) {
+                const nonce = allMainNonces[mainNonceIdx++];
+                if (isNative) {
+                    txsToSign.push({
+                        wallet: mainWallet,
+                        tx: {
+                            to: finalRecipient,
+                            value: amountWei,
+                            nonce,
+                            gasPrice,
+                            gasLimit: nativeGasLimit,
+                            chainId: chainIdNum,
+                            type: txType,
+                        },
+                    });
+                }
+                else {
+                    const data = iface.encodeFunctionData('transfer', [finalRecipient, amountWei]);
+                    txsToSign.push({
+                        wallet: mainWallet,
+                        tx: {
+                            to: tokenAddress,
+                            data,
+                            value: 0n,
+                            nonce,
+                            gasPrice,
+                            gasLimit: finalGasLimit,
+                            chainId: chainIdNum,
+                            type: txType,
+                        },
+                    });
+                }
+                continue;
+            }
+            // ✅ 支持 string 和 GeneratedWallet 两种类型
+            const fullChain = [
+                mainWallet,
+                ...hopChain.map((w) => new Wallet(typeof w === 'string' ? w : w.privateKey, provider)),
+            ];
+            const addresses = [...fullChain.map((w) => w.address), finalRecipient];
+            if (!isNative) {
+                for (let j = 0; j < hopChain.length; j++) {
+                    const nonce = allMainNonces[mainNonceIdx++];
+                    txsToSign.push({
+                        wallet: mainWallet,
+                        tx: {
+                            to: fullChain[j + 1].address,
+                            value: gasFeePerHop,
+                            nonce,
+                            gasPrice,
+                            gasLimit: nativeGasLimit,
+                            chainId: chainIdNum,
+                            type: txType,
+                        },
+                    });
+                }
+            }
+            for (let j = 0; j < addresses.length - 1; j++) {
+                const fromWallet = fullChain[j];
+                const toAddress = addresses[j + 1];
+                const nonce = j === 0 ? allMainNonces[mainNonceIdx++] : 0;
+                if (isNative) {
+                    const remainingHops = addresses.length - 2 - j;
+                    const additionalGas = gasFeePerHop * BigInt(remainingHops);
+                    const transferValue = amountWei + additionalGas;
+                    txsToSign.push({
+                        wallet: fromWallet,
+                        tx: {
+                            to: toAddress,
+                            value: transferValue,
+                            nonce,
+                            gasPrice,
+                            gasLimit: finalGasLimit,
+                            chainId: chainIdNum,
+                            type: txType,
+                        },
+                    });
+                }
+                else {
+                    const data = iface.encodeFunctionData('transfer', [toAddress, amountWei]);
+                    txsToSign.push({
+                        wallet: fromWallet,
+                        tx: {
+                            to: tokenAddress,
+                            data,
+                            value: 0n,
+                            nonce,
+                            gasPrice,
+                            gasLimit: finalGasLimit,
+                            chainId: chainIdNum,
+                            type: txType,
+                        },
+                    });
+                }
+            }
+        }
+        const signedTxsResult = await Promise.all(txsToSign.map(({ wallet, tx }) => wallet.signTransaction(tx)));
+        signedTxs.push(...signedTxsResult);
+        // ✅ 利润多跳转账（固定费用，原生代币）
+        if (extractProfit && totalProfit > 0n) {
+            const profitNonce = allMainNonces[mainNonceIdx];
+            const profitHopResult = await buildProfitHopTransactions({
+                provider,
+                payerWallet: mainWallet,
+                profitAmount: totalProfit,
+                profitRecipient: profitAddr,
+                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
+            ? {
+                totalAmount: ethers.formatEther(totalAmountBeforeProfit),
+                profitAmount: ethers.formatEther(totalProfit),
+                profitRecipient: profitAddr,
+                recipientCount: recipients.length,
+                isNative,
+                tokenAddress: isNative ? undefined : tokenAddress,
+            }
+            : undefined,
+    };
+}

package/dist/domains/flap/portal-bundle-merkle/utils/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Flap Protocol 分散 / 归集（Merkle Bundle）barrel
+ *
+ * 原超长文件按职责拆分为：
+ * - disperse.ts：flapDisperseWithBundleMerkle 分散
+ * - sweep.ts：flapSweepWithBundleMerkle 归集
+ *
+ * 对外 export 符号与路径保持不变。
+ */
+export { flapDisperseWithBundleMerkle } from './disperse.js';
+export { flapSweepWithBundleMerkle } from './sweep.js';

package/dist/domains/flap/portal-bundle-merkle/utils/index.js

@@ -0,0 +1,11 @@
+/**
+ * Flap Protocol 分散 / 归集（Merkle Bundle）barrel
+ *
+ * 原超长文件按职责拆分为：
+ * - disperse.ts：flapDisperseWithBundleMerkle 分散
+ * - sweep.ts：flapSweepWithBundleMerkle 归集
+ *
+ * 对外 export 符号与路径保持不变。
+ */
+export { flapDisperseWithBundleMerkle } from './disperse.js';
+export { flapSweepWithBundleMerkle } from './sweep.js';

package/dist/domains/flap/portal-bundle-merkle/utils/sweep.d.ts

@@ -0,0 +1,9 @@
+import type { FlapSweepMerkleResult, FlapSweepSignParams } from '../types.js';
+/**
+ * Flap Protocol: 归集（仅签名版本）
+ * ✅ 支持利润提取（按地址数量收取固定费用）
+ * ✅ 查询余额最大的钱包支付利润
+ * ✅ 支持多跳
+ * ✅ 支持 Multicall3 批量获取余额
+ */
+export declare function flapSweepWithBundleMerkle(params: FlapSweepSignParams): Promise<FlapSweepMerkleResult>;