four-flap-meme-sdk 1.4.17 → 1.4.18

package/dist/index.d.ts

@@ -34,6 +34,7 @@ export { generateWallets, type GeneratedWallet } from './utils/wallet.js';
 export { getTokenBalancesWithMulticall, type MulticallResult, type MultiTokenBalancesResult } from './utils/wallet.js';
 export { validatePrivateKeys, type PrivateKeyValidation } from './utils/wallet.js';
 export { stealthTransfer, type StealthTransferResult, type StealthTransferSimpleParams } from './utils/stealth-transfer.js';
+export { privateSaleMerkle, batchPrivateSaleMerkle, type PrivateSaleSignConfig, type PrivateSaleTransferParams, type BatchPrivateSaleParams, type PrivateSaleResult, } from './utils/private-sale.js';
 export { inspectTokenLP, getFactoryFromRouter, registerDYORSwap, registerDex, getChainConfig, type LPInfo, type LPPlatform, type InspectOptions, type DexConfig, type ChainDexConfig, } from './utils/lp-inspect.js';
 export { disperseWithBundle, sweepWithBundle, type DisperseSignParams, type SweepSignParams, type SignedTransactionsResult, type DisperseParams, type SweepParams, type BundleSubmitResult } from './utils/airdrop-sweep.js';
 export { fourBundleSwapMerkle, fourBatchSwapMerkle, fourQuickBatchSwapMerkle, type FourSwapSignConfig, type FourSwapConfig, type FourBundleSwapSignParams, type FourBundleSwapParams, type FourSwapResult, type FourBatchSwapSignParams, type FourBatchSwapResult, type FourQuickBatchSwapSignParams, type FourQuickBatchSwapResult } from './contracts/tm-bundle-merkle/swap.js';

package/dist/index.js

@@ -46,6 +46,8 @@ export { generateWallets } from './utils/wallet.js';
 export { getTokenBalancesWithMulticall } from './utils/wallet.js';
 export { validatePrivateKeys } from './utils/wallet.js';
 export { stealthTransfer } from './utils/stealth-transfer.js';
+// ✅ 私募转账签名（带贿赂和利润提取）
+export { privateSaleMerkle, batchPrivateSaleMerkle, } from './utils/private-sale.js';
 export { inspectTokenLP, getFactoryFromRouter, registerDYORSwap, registerDex, getChainConfig, } from './utils/lp-inspect.js';
 export { disperseWithBundle, sweepWithBundle } from './utils/airdrop-sweep.js';
 // ============================================================

package/dist/utils/private-sale.d.ts

@@ -0,0 +1,87 @@
+/**
+ * 私募转账签名工具
+ *
+ * ✅ 优化：能批量的批量，能并行的并行
+ * - 贿赂交易：向 BlockRazor Builder EOA 转账 BNB 提高优先级
+ * - 利润提取：千分之三（30 bps）
+ */
+/** 私募签名配置 */
+export interface PrivateSaleSignConfig {
+    /** RPC URL */
+    rpcUrl: string;
+    /** 链 ID */
+    chainId?: number;
+    /** Gas Limit（默认 21000） */
+    gasLimit?: number;
+    /** Gas Price（Gwei，默认 0.1） */
+    gasPriceGwei?: number;
+    /** 贿赂金额（BNB，默认 0.000001） */
+    bribeAmount?: number;
+    /** 是否提取利润（默认 true） */
+    extractProfit?: boolean;
+    /** 利润比例基点（默认 30 = 千分之三） */
+    profitBps?: number;
+}
+/** 单个转账参数 */
+export interface PrivateSaleTransferParams {
+    /** 发送者私钥 */
+    senderPrivateKey: string;
+    /** 接收者地址（合约地址） */
+    recipient: string;
+    /** 转账金额（单位：原生代币，如 BNB） */
+    amount: number;
+}
+/** 批量转账参数 */
+export interface BatchPrivateSaleParams {
+    /** 转账列表 */
+    transfers: PrivateSaleTransferParams[];
+    /** 签名配置 */
+    config: PrivateSaleSignConfig;
+}
+/** 私募结果 */
+export interface PrivateSaleResult {
+    /** 签名交易数组（包含贿赂 + 转账 + 利润） */
+    signedTransactions: string[];
+    /** 元数据 */
+    metadata: {
+        /** 总交易数 */
+        totalCount: number;
+        /** 贿赂交易数 */
+        bribeCount: number;
+        /** 转账交易数 */
+        transferCount: number;
+        /** 利润交易数 */
+        profitCount: number;
+        /** 总转账金额（Wei） */
+        totalAmountWei: string;
+        /** 总利润金额（Wei） */
+        totalProfitWei: string;
+        /** 贿赂金额（Wei） */
+        bribeAmountWei: string;
+    };
+}
+/**
+ * 生成私募转账签名交易（带贿赂和利润提取）
+ *
+ * ✅ 优化：
+ * 1. 批量获取 nonce（单次 RPC 请求）
+ * 2. 并行签名所有交易（贿赂 + 转账 + 利润）
+ * 3. 批量创建钱包实例
+ *
+ * 交易顺序：
+ * 1. 贿赂交易（第一个发送者 → BlockRazor）
+ * 2. 转账交易（各发送者 → 合约）
+ * 3. 利润交易（第一个发送者 → 利润地址）
+ *
+ * @param params 批量转账参数
+ * @returns 签名交易结果
+ */
+export declare function batchPrivateSaleMerkle(params: BatchPrivateSaleParams): Promise<PrivateSaleResult>;
+/**
+ * 生成单笔私募转账签名交易（带贿赂和利润提取）
+ *
+ * @param transfer 转账参数
+ * @param config 签名配置
+ * @returns 签名交易结果
+ */
+export declare function privateSaleMerkle(transfer: PrivateSaleTransferParams, config: PrivateSaleSignConfig): Promise<PrivateSaleResult>;

package/dist/utils/private-sale.js

@@ -0,0 +1,166 @@
+/**
+ * 私募转账签名工具
+ *
+ * ✅ 优化：能批量的批量，能并行的并行
+ * - 贿赂交易：向 BlockRazor Builder EOA 转账 BNB 提高优先级
+ * - 利润提取：千分之三（30 bps）
+ */
+import { ethers, Wallet, JsonRpcProvider } from 'ethers';
+import { PROFIT_CONFIG } from './constants.js';
+import { BLOCKRAZOR_BUILDER_EOA } from '../clients/blockrazor.js';
+import { NonceManager } from './bundle-helpers.js';
+// ============================================================================
+// 核心功能
+// ============================================================================
+/**
+ * 生成私募转账签名交易（带贿赂和利润提取）
+ *
+ * ✅ 优化：
+ * 1. 批量获取 nonce（单次 RPC 请求）
+ * 2. 并行签名所有交易（贿赂 + 转账 + 利润）
+ * 3. 批量创建钱包实例
+ *
+ * 交易顺序：
+ * 1. 贿赂交易（第一个发送者 → BlockRazor）
+ * 2. 转账交易（各发送者 → 合约）
+ * 3. 利润交易（第一个发送者 → 利润地址）
+ *
+ * @param params 批量转账参数
+ * @returns 签名交易结果
+ */
+export async function batchPrivateSaleMerkle(params) {
+    const { transfers, config } = params;
+    if (transfers.length === 0) {
+        throw new Error('转账列表不能为空');
+    }
+    // ✅ 配置参数（提前计算，避免重复）
+    const chainId = config.chainId || 56;
+    const gasLimit = BigInt(config.gasLimit || 21000);
+    const gasPrice = ethers.parseUnits(String(config.gasPriceGwei || 0.1), 'gwei');
+    const bribeAmount = ethers.parseEther(String(config.bribeAmount || 0.000001));
+    const extractProfit = config.extractProfit !== false;
+    const profitBps = config.profitBps ?? PROFIT_CONFIG.RATE_BPS;
+    // 创建 Provider
+    const provider = new JsonRpcProvider(config.rpcUrl);
+    const nonceManager = new NonceManager(provider);
+    // ✅ 批量创建钱包实例（使用 Map 去重）
+    const walletMap = new Map();
+    const transferWallets = [];
+    for (const transfer of transfers) {
+        const key = new Wallet(transfer.senderPrivateKey).address.toLowerCase();
+        if (!walletMap.has(key)) {
+            const wallet = new Wallet(transfer.senderPrivateKey, provider);
+            walletMap.set(key, wallet);
+        }
+        transferWallets.push(walletMap.get(key));
+    }
+    // 第一个发送者（负责贿赂和利润交易）
+    const firstWallet = transferWallets[0];
+    const firstWalletKey = firstWallet.address.toLowerCase();
+    // ✅ 批量计算总金额（使用 reduce）
+    const totalAmountWei = transfers.reduce((sum, t) => sum + ethers.parseEther(String(t.amount)), 0n);
+    const profitWei = extractProfit ? (totalAmountWei * BigInt(profitBps)) / 10000n : 0n;
+    const hasProfit = extractProfit && profitWei > 0n;
+    // ✅ 批量获取所有 nonce（单次 RPC 请求）
+    const uniqueWallets = Array.from(walletMap.values());
+    const noncesArray = await nonceManager.getNextNoncesForWallets(uniqueWallets);
+    // 构建 nonce 映射
+    const nonceMap = new Map();
+    uniqueWallets.forEach((wallet, i) => {
+        nonceMap.set(wallet.address.toLowerCase(), noncesArray[i]);
+    });
+    // ✅ 预计算每个钱包的 nonce 分配
+    // 第一个钱包：baseNonce(贿赂) → baseNonce+1...+N(转账) → 最后(利润)
+    const firstWalletBaseNonce = nonceMap.get(firstWalletKey);
+    // 统计第一个钱包的转账数量
+    let firstWalletTransferCount = 0;
+    for (let i = 0; i < transfers.length; i++) {
+        if (transferWallets[i].address.toLowerCase() === firstWalletKey) {
+            firstWalletTransferCount++;
+        }
+    }
+    // ✅ 为每个转账预分配 nonce
+    const transferNonces = [];
+    const currentNonces = new Map();
+    // 初始化 nonce（第一个钱包跳过贿赂交易的 nonce）
+    for (const [key, nonce] of nonceMap) {
+        currentNonces.set(key, key === firstWalletKey ? nonce + 1 : nonce);
+    }
+    // 为每个转账分配 nonce
+    for (let i = 0; i < transfers.length; i++) {
+        const walletKey = transferWallets[i].address.toLowerCase();
+        const nonce = currentNonces.get(walletKey);
+        transferNonces.push(nonce);
+        currentNonces.set(walletKey, nonce + 1);
+    }
+    // 利润交易的 nonce
+    const profitNonce = hasProfit ? currentNonces.get(firstWalletKey) : 0;
+    // ✅ 并行签名所有交易
+    const allSignPromises = [];
+    // 1. 贿赂交易签名
+    allSignPromises.push(firstWallet.signTransaction({
+        to: BLOCKRAZOR_BUILDER_EOA,
+        value: bribeAmount,
+        gasLimit,
+        gasPrice,
+        nonce: firstWalletBaseNonce,
+        chainId,
+        type: 0,
+    }));
+    // 2. 转账交易签名（并行）
+    for (let i = 0; i < transfers.length; i++) {
+        const transfer = transfers[i];
+        const wallet = transferWallets[i];
+        const nonce = transferNonces[i];
+        allSignPromises.push(wallet.signTransaction({
+            to: transfer.recipient,
+            value: ethers.parseEther(String(transfer.amount)),
+            gasLimit,
+            gasPrice,
+            nonce,
+            chainId,
+            type: 0,
+        }));
+    }
+    // 3. 利润交易签名
+    if (hasProfit) {
+        allSignPromises.push(firstWallet.signTransaction({
+            to: PROFIT_CONFIG.RECIPIENT,
+            value: profitWei,
+            gasLimit,
+            gasPrice,
+            nonce: profitNonce,
+            chainId,
+            type: 0,
+        }));
+    }
+    // ✅ 并行执行所有签名
+    const allSignedTxs = await Promise.all(allSignPromises);
+    // 按顺序组装结果：贿赂(1) + 转账(N) + 利润(0或1)
+    const signedTransactions = allSignedTxs;
+    return {
+        signedTransactions,
+        metadata: {
+            totalCount: signedTransactions.length,
+            bribeCount: 1,
+            transferCount: transfers.length,
+            profitCount: hasProfit ? 1 : 0,
+            totalAmountWei: totalAmountWei.toString(),
+            totalProfitWei: profitWei.toString(),
+            bribeAmountWei: bribeAmount.toString(),
+        },
+    };
+}
+/**
+ * 生成单笔私募转账签名交易（带贿赂和利润提取）
+ *
+ * @param transfer 转账参数
+ * @param config 签名配置
+ * @returns 签名交易结果
+ */
+export async function privateSaleMerkle(transfer, config) {
+    return batchPrivateSaleMerkle({
+        transfers: [transfer],
+        config,
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "four-flap-meme-sdk",
-  "version": "1.4.17",
+  "version": "1.4.18",
   "description": "SDK for Flap bonding curve and four.meme TokenManager",
   "type": "module",
   "main": "dist/index.js",