four-flap-meme-sdk 1.7.3 → 1.7.4

package/dist/eip7702/xlayer/disperse.d.ts

@@ -0,0 +1,98 @@
+/**
+ * X-Layer Bundle 代币分发
+ *
+ * 支持：
+ * - 原生代币 (OKB) 分发
+ * - ERC20 代币分发
+ * - 多跳转账（隐藏资金流向）
+ * - 自动利润计算
+ *
+ * 优化：
+ * - Type 4 交易：所有多跳在一个原子交易中完成
+ * - 第一个钱包作为 Sponsor，支付 gas + 利润
+ */
+/** 用户类型 */
+export type UserType = 'v0' | 'v1' | 'normal';
+/** 分发配置 */
+export interface DisperseConfig {
+    /** RPC URL */
+    rpcUrl: string;
+    /** Gas Price (可选) */
+    gasPrice?: bigint;
+    /** 用户类型（影响利润率） */
+    userType?: UserType;
+}
+/** 分发接收者 */
+export interface DisperseRecipient {
+    /** 接收地址 */
+    address: string;
+    /** 接收金额 */
+    amount: string;
+    /** 多跳钱包私钥（可选） */
+    hopPrivateKeys?: string[];
+}
+/** 原生代币分发参数 */
+export interface DisperseNativeParams extends DisperseConfig {
+    /** 发送者私钥（第一个钱包，支付 gas + 利润） */
+    senderPrivateKey: string;
+    /** 接收者列表 */
+    recipients: DisperseRecipient[];
+}
+/** ERC20 分发参数 */
+export interface DisperseERC20Params extends DisperseConfig {
+    /** 发送者私钥 */
+    senderPrivateKey: string;
+    /** 代币地址 */
+    tokenAddress: string;
+    /** 代币精度 */
+    tokenDecimals?: number;
+    /** 接收者列表 */
+    recipients: DisperseRecipient[];
+}
+/** 签名结果 */
+export interface DisperseSignedResult {
+    /** 签名后的 Type 4 交易 */
+    signedTx: string;
+    /** 交易哈希 */
+    txHash: string;
+    /** Sponsor 地址 */
+    sponsorAddress: string;
+    /** 接收者数量 */
+    recipientCount: number;
+    /** 总金额 */
+    totalAmount: string;
+    /** 多跳钱包（如果有） */
+    hopWallets?: Array<{
+        address: string;
+        privateKey: string;
+    }>;
+    /** 时间戳 */
+    timestamp: number;
+}
+/**
+ * 原生代币 (OKB) 分发
+ *
+ * 支持多跳转账，所有操作在一个 Type 4 交易中原子完成
+ *
+ * 流程（无多跳）：sender → [recipient1, recipient2, ...]
+ * 流程（有多跳）：sender → hop1 → hop2 → ... → recipient
+ */
+export declare function signDisperseNative(params: DisperseNativeParams): Promise<DisperseSignedResult>;
+/**
+ * ERC20 代币分发
+ *
+ * 支持多跳转账，所有操作在一个 Type 4 交易中原子完成
+ */
+export declare function signDisperseERC20(params: DisperseERC20Params): Promise<DisperseSignedResult>;
+/**
+ * 快捷分发（自动生成多跳钱包）
+ *
+ * @param hopCount 多跳数量（0 = 无多跳）
+ */
+export declare function signDisperseNativeWithAutoHop(params: Omit<DisperseNativeParams, 'recipients'> & {
+    recipients: Array<{
+        address: string;
+        amount: string;
+    }>;
+    hopCount?: number;
+}): Promise<DisperseSignedResult>;

package/dist/eip7702/xlayer/disperse.js

@@ -0,0 +1,277 @@
+/**
+ * X-Layer Bundle 代币分发
+ *
+ * 支持：
+ * - 原生代币 (OKB) 分发
+ * - ERC20 代币分发
+ * - 多跳转账（隐藏资金流向）
+ * - 自动利润计算
+ *
+ * 优化：
+ * - Type 4 交易：所有多跳在一个原子交易中完成
+ * - 第一个钱包作为 Sponsor，支付 gas + 利润
+ */
+import { ethers, Wallet, JsonRpcProvider, Interface } from 'ethers';
+import { XLAYER_CHAIN_ID, EXECUTOR_ADDRESS, EXECUTOR_ABI, DEFAULT_GAS_PRICE, GAS_LIMIT_MULTIPLIER, XLAYER_PROFIT_CONFIG, } from './constants.js';
+import { buildNativeTransfer, buildTransfer } from './builders.js';
+// ==================== 利润计算 ====================
+function getProfitRateBps(userType = 'v0') {
+    switch (userType) {
+        case 'v0':
+            return XLAYER_PROFIT_CONFIG.RATE_BPS_V0;
+        case 'v1':
+            return XLAYER_PROFIT_CONFIG.RATE_BPS_V1;
+        default:
+            return XLAYER_PROFIT_CONFIG.RATE_BPS;
+    }
+}
+function calculateProfitWei(amount, userType = 'v0') {
+    const bps = getProfitRateBps(userType);
+    return (amount * BigInt(bps)) / 10000n;
+}
+// ==================== 授权签名 ====================
+function hashAuthorization(chainId, executorAddress, nonce) {
+    const encoded = ethers.encodeRlp([
+        ethers.toBeHex(chainId),
+        executorAddress,
+        ethers.toBeHex(nonce),
+    ]);
+    const prefixed = ethers.concat([new Uint8Array([0x05]), encoded]);
+    return ethers.keccak256(prefixed);
+}
+function signAuthorization(wallet, nonce = 0) {
+    const messageHash = hashAuthorization(XLAYER_CHAIN_ID, EXECUTOR_ADDRESS, nonce);
+    const signature = wallet.signingKey.sign(messageHash);
+    return {
+        chainId: XLAYER_CHAIN_ID,
+        address: EXECUTOR_ADDRESS,
+        nonce,
+        v: signature.v,
+        r: signature.r,
+        s: signature.s,
+    };
+}
+// ==================== 生成多跳钱包 ====================
+function generateHopWallets(count) {
+    const wallets = [];
+    for (let i = 0; i < count; i++) {
+        const w = Wallet.createRandom();
+        wallets.push({
+            address: w.address,
+            privateKey: w.privateKey,
+        });
+    }
+    return wallets;
+}
+// ==================== 核心签名函数 ====================
+async function buildAndSignType4Transaction(config, participants) {
+    const { rpcUrl, gasPrice = DEFAULT_GAS_PRICE } = config;
+    const provider = new JsonRpcProvider(rpcUrl);
+    const executorInterface = new Interface(EXECUTOR_ABI);
+    const sponsor = participants[0].wallet;
+    // 准备授权
+    const authorizations = [];
+    const allCalls = [];
+    for (const p of participants) {
+        const auth = signAuthorization(p.wallet);
+        authorizations.push(auth);
+        allCalls.push(...p.calls);
+    }
+    // 构建 execute 调用
+    const executeData = executorInterface.encodeFunctionData('execute', [
+        allCalls.map(c => ({
+            target: c.target,
+            value: c.value || 0n,
+            data: c.data,
+        })),
+    ]);
+    const totalValue = allCalls.reduce((sum, c) => sum + (c.value || 0n), 0n);
+    const gasLimit = BigInt(Math.ceil(Number(100000n + BigInt(allCalls.length) * 150000n) * GAS_LIMIT_MULTIPLIER));
+    const sponsorNonce = await provider.getTransactionCount(sponsor.address);
+    // 构建 Type 4 交易
+    const tx = {
+        type: 4,
+        chainId: XLAYER_CHAIN_ID,
+        to: sponsor.address,
+        data: executeData,
+        value: totalValue,
+        authorizationList: authorizations,
+        gasLimit,
+        gasPrice,
+        nonce: sponsorNonce,
+    };
+    // 签名
+    const fields = [
+        ethers.toBeHex(tx.chainId),
+        ethers.toBeHex(tx.nonce),
+        ethers.toBeHex(tx.gasPrice),
+        ethers.toBeHex(tx.gasLimit),
+        tx.to,
+        ethers.toBeHex(tx.value),
+        tx.data,
+        tx.authorizationList.map((auth) => [
+            ethers.toBeHex(auth.chainId),
+            auth.address,
+            ethers.toBeHex(auth.nonce),
+            ethers.toBeHex(auth.v),
+            auth.r,
+            auth.s,
+        ]),
+    ];
+    const unsigned = ethers.concat([new Uint8Array([0x04]), ethers.encodeRlp(fields)]);
+    const txHashToSign = ethers.keccak256(unsigned);
+    const signature = sponsor.signingKey.sign(txHashToSign);
+    const signedFields = [...fields, ethers.toBeHex(signature.v), signature.r, signature.s];
+    const signedTx = ethers.hexlify(ethers.concat([new Uint8Array([0x04]), ethers.encodeRlp(signedFields)]));
+    const txHash = ethers.keccak256(signedTx);
+    return { signedTx, txHash, sponsorAddress: sponsor.address };
+}
+// ==================== 分发函数 ====================
+/**
+ * 原生代币 (OKB) 分发
+ *
+ * 支持多跳转账，所有操作在一个 Type 4 交易中原子完成
+ *
+ * 流程（无多跳）：sender → [recipient1, recipient2, ...]
+ * 流程（有多跳）：sender → hop1 → hop2 → ... → recipient
+ */
+export async function signDisperseNative(params) {
+    const { senderPrivateKey, recipients, userType = 'v0', ...config } = params;
+    if (recipients.length === 0) {
+        throw new Error('至少需要一个接收者');
+    }
+    const provider = new JsonRpcProvider(config.rpcUrl);
+    const sender = new Wallet(senderPrivateKey, provider);
+    // 计算总金额
+    let totalAmountWei = 0n;
+    for (const r of recipients) {
+        totalAmountWei += ethers.parseEther(r.amount);
+    }
+    // 计算利润
+    const profitWei = calculateProfitWei(totalAmountWei, userType);
+    const profitRecipient = XLAYER_PROFIT_CONFIG.RECIPIENT;
+    console.log(`[Bundle分发] OKB分发: ${recipients.length} 个接收者, 总金额=${ethers.formatEther(totalAmountWei)} OKB, 利润=${ethers.formatEther(profitWei)} OKB`);
+    // 收集所有多跳钱包
+    const allHopWallets = [];
+    const participants = [];
+    // 发送者的 calls
+    const senderCalls = [];
+    for (const recipient of recipients) {
+        const amountWei = ethers.parseEther(recipient.amount);
+        const hopKeys = recipient.hopPrivateKeys || [];
+        if (hopKeys.length === 0) {
+            // 无多跳：直接转账
+            senderCalls.push(buildNativeTransfer(recipient.address, amountWei));
+        }
+        else {
+            // 有多跳：sender → hop1 → hop2 → ... → recipient
+            // 构建多跳链
+            const hopWallets = hopKeys.map(pk => new Wallet(pk, provider));
+            // 记录多跳钱包
+            hopWallets.forEach(w => allHopWallets.push({ address: w.address, privateKey: w.privateKey }));
+            // sender → hop1
+            senderCalls.push(buildNativeTransfer(hopWallets[0].address, amountWei));
+            // 添加中间钱包的转账
+            for (let i = 0; i < hopWallets.length; i++) {
+                const from = hopWallets[i];
+                const to = i === hopWallets.length - 1 ? recipient.address : hopWallets[i + 1].address;
+                // 添加中间钱包为参与者
+                participants.push({
+                    wallet: from,
+                    calls: [buildNativeTransfer(to, amountWei)],
+                });
+            }
+        }
+    }
+    // 添加利润转账（由 sender 支付）
+    if (profitWei > 0n) {
+        senderCalls.push(buildNativeTransfer(profitRecipient, profitWei));
+    }
+    // sender 作为第一个参与者
+    participants.unshift({ wallet: sender, calls: senderCalls });
+    const result = await buildAndSignType4Transaction(config, participants);
+    return {
+        ...result,
+        recipientCount: recipients.length,
+        totalAmount: totalAmountWei.toString(),
+        hopWallets: allHopWallets.length > 0 ? allHopWallets : undefined,
+        timestamp: Date.now(),
+    };
+}
+/**
+ * ERC20 代币分发
+ *
+ * 支持多跳转账，所有操作在一个 Type 4 交易中原子完成
+ */
+export async function signDisperseERC20(params) {
+    const { senderPrivateKey, tokenAddress, tokenDecimals = 18, recipients, userType = 'v0', ...config } = params;
+    if (recipients.length === 0) {
+        throw new Error('至少需要一个接收者');
+    }
+    const provider = new JsonRpcProvider(config.rpcUrl);
+    const sender = new Wallet(senderPrivateKey, provider);
+    // 计算总金额
+    let totalAmountWei = 0n;
+    for (const r of recipients) {
+        totalAmountWei += ethers.parseUnits(r.amount, tokenDecimals);
+    }
+    console.log(`[Bundle分发] ERC20分发: ${recipients.length} 个接收者, 代币=${tokenAddress}`);
+    const allHopWallets = [];
+    const participants = [];
+    const senderCalls = [];
+    for (const recipient of recipients) {
+        const amountWei = ethers.parseUnits(recipient.amount, tokenDecimals);
+        const hopKeys = recipient.hopPrivateKeys || [];
+        if (hopKeys.length === 0) {
+            senderCalls.push(buildTransfer(tokenAddress, recipient.address, amountWei));
+        }
+        else {
+            const hopWallets = hopKeys.map(pk => new Wallet(pk, provider));
+            hopWallets.forEach(w => allHopWallets.push({ address: w.address, privateKey: w.privateKey }));
+            senderCalls.push(buildTransfer(tokenAddress, hopWallets[0].address, amountWei));
+            for (let i = 0; i < hopWallets.length; i++) {
+                const from = hopWallets[i];
+                const to = i === hopWallets.length - 1 ? recipient.address : hopWallets[i + 1].address;
+                participants.push({
+                    wallet: from,
+                    calls: [buildTransfer(tokenAddress, to, amountWei)],
+                });
+            }
+        }
+    }
+    participants.unshift({ wallet: sender, calls: senderCalls });
+    const result = await buildAndSignType4Transaction(config, participants);
+    return {
+        ...result,
+        recipientCount: recipients.length,
+        totalAmount: totalAmountWei.toString(),
+        hopWallets: allHopWallets.length > 0 ? allHopWallets : undefined,
+        timestamp: Date.now(),
+    };
+}
+/**
+ * 快捷分发（自动生成多跳钱包）
+ *
+ * @param hopCount 多跳数量（0 = 无多跳）
+ */
+export async function signDisperseNativeWithAutoHop(params) {
+    const { hopCount = 0, recipients, ...rest } = params;
+    if (hopCount <= 0) {
+        return signDisperseNative({
+            ...rest,
+            recipients: recipients.map(r => ({ ...r, hopPrivateKeys: [] })),
+        });
+    }
+    // 为每个接收者生成多跳钱包
+    const recipientsWithHops = recipients.map(r => {
+        const hops = generateHopWallets(hopCount);
+        return {
+            ...r,
+            hopPrivateKeys: hops.map(h => h.privateKey),
+        };
+    });
+    return signDisperseNative({
+        ...rest,
+        recipients: recipientsWithHops,
+    });
+}

package/dist/eip7702/xlayer/index.d.ts

@@ -56,5 +56,7 @@ export { bundleBatchApprove, bundleSingleApprove, getSpendersToApprove, type Bat
 export { bundleBatchBuy, bundleBatchSell, bundleBuySellPair, type BatchBuyParams, type BatchSellParams, type BuySellPairParams, } from './trade.js';
 export { checkApprovalStatus, checkApprovalStatusBatch, checkSingleApprovalStatus, getApprovalDetails, getUnapprovedSpenders, } from './check.js';
 export { collectProfit, collectProfitBatch, collectProfitFromTrade, calculateProfit, getProfitRateBps, getProfitRecipient, type UserType, type ProfitMode, type ProfitParams, type BatchProfitParams, type ProfitResult, } from './profit.js';
-export { signBatchApprove, signBatchBuy, signBatchSell, signProfitCollect, signCustomCalls, type SignConfig, type SignedTransaction, type BatchApproveSignParams, type BatchBuySignParams, type BatchSellSignParams, type ProfitSignParams, } from './sign.js';
+export { signBatchApprove, signBatchBuy, signBatchSell, signBuySellPair, signCustomCalls, type SignConfig, type SignedTransaction, type BatchApproveSignParams, type BatchBuySignParams, type BatchSellSignParams, type BuySellPairSignParams, type UserType as SignUserType, } from './sign.js';
 export { broadcastSignedBundle, broadcastSignedBundleBatch, broadcastSignedBundleParallel, submitBundleToXLayer, type BroadcastConfig, type BroadcastResult, } from './broadcast.js';
+export { signDisperseNative, signDisperseERC20, signDisperseNativeWithAutoHop, type DisperseConfig, type DisperseRecipient, type DisperseNativeParams, type DisperseERC20Params, type DisperseSignedResult, } from './disperse.js';
+export { signSweepNative, signSweepERC20, signSweepNativeWithAutoHop, type SweepConfig, type SweepSource, type SweepNativeParams, type SweepERC20Params, type SweepSignedResult, } from './sweep.js';

package/dist/eip7702/xlayer/index.js

@@ -65,6 +65,10 @@ export { checkApprovalStatus, checkApprovalStatusBatch, checkSingleApprovalStatu
 // ==================== 利润刮取 ====================
 export { collectProfit, collectProfitBatch, collectProfitFromTrade, calculateProfit, getProfitRateBps, getProfitRecipient, } from './profit.js';
 // ==================== 前端签名（完整签名，后端只需广播） ====================
-export { signBatchApprove, signBatchBuy, signBatchSell, signProfitCollect, signCustomCalls, } from './sign.js';
+export { signBatchApprove, signBatchBuy, signBatchSell, signBuySellPair, signCustomCalls, } from './sign.js';
 // ==================== 后端广播（不需要私钥） ====================
 export { broadcastSignedBundle, broadcastSignedBundleBatch, broadcastSignedBundleParallel, submitBundleToXLayer, } from './broadcast.js';
+// ==================== 代币分发（支持多跳） ====================
+export { signDisperseNative, signDisperseERC20, signDisperseNativeWithAutoHop, } from './disperse.js';
+// ==================== 代币归集（支持多跳） ====================
+export { signSweepNative, signSweepERC20, signSweepNativeWithAutoHop, } from './sweep.js';

package/dist/eip7702/xlayer/sign.d.ts

@@ -4,16 +4,22 @@
  * 前端使用：构建并签名完整的 Type 4 交易
  * 返回已签名的原始交易数据，后端只需广播
  *
- * 优化：第一个参与钱包作为 Sponsor，支付 gas
- * 其他参与钱包不需要 gas
+ * 优化：
+ * - 第一个参与钱包作为 Sponsor，支付 gas
+ * - 其他参与钱包不需要 gas
+ * - 利润自动计算并包含在交易中（不需要前端传递）
  */
 import type { Call } from './types.js';
+/** 用户类型（影响利润率） */
+export type UserType = 'v0' | 'v1' | 'normal';
 /** 签名配置（简化版：不需要单独的 Sponsor） */
 export interface SignConfig {
     /** RPC URL（用于获取 nonce） */
     rpcUrl: string;
     /** Gas Price (可选) */
     gasPrice?: bigint;
+    /** 用户类型（影响利润率，默认 v0） */
+    userType?: UserType;
 }
 /** 签名后的交易数据（发送到后端广播） */
 export interface SignedTransaction {
@@ -43,19 +49,21 @@ export interface BatchApproveSignParams extends SignConfig {
 export interface BatchBuySignParams extends SignConfig {
     /** 代币地址 */
     tokenAddress: string;
-    /** 买入列表（第一个钱包作为 Sponsor，支付 gas） */
+    /** 买入列表（第一个钱包作为 Sponsor，支付 gas + 利润） */
     wallets: Array<{
         privateKey: string;
         buyAmount: string;
     }>;
     /** 交易类型 */
     tradeType?: 'v2' | 'portal';
+    /** 总交易笔数（用于计算利润，默认 = 买入数量） */
+    totalTxCount?: number;
 }
 /** 批量卖出签名参数 */
 export interface BatchSellSignParams extends SignConfig {
     /** 代币地址 */
     tokenAddress: string;
-    /** 卖出列表（第一个钱包作为 Sponsor，支付 gas） */
+    /** 卖出列表（第一个钱包作为 Sponsor，支付 gas + 利润） */
     wallets: Array<{
         privateKey: string;
         sellAmount: string;
@@ -63,48 +71,62 @@ export interface BatchSellSignParams extends SignConfig {
     }>;
     /** 交易类型 */
     tradeType?: 'v2' | 'portal';
+    /** 卖出金额（OKB）用于计算利润 */
+    sellValueOkb?: string;
+    /** 总交易笔数（用于计算利润，默认 = 卖出数量） */
+    totalTxCount?: number;
 }
-/** 利润刮取签名参数 */
-export interface ProfitSignParams extends SignConfig {
-    /** 利润列表（第一个钱包作为 Sponsor，支付 gas） */
-    profits: Array<{
+/** 买卖配对签名参数（刷量用） */
+export interface BuySellPairSignParams extends SignConfig {
+    /** 代币地址 */
+    tokenAddress: string;
+    /** 买入钱包 */
+    buyWallet: {
         privateKey: string;
-        profitAmount: string;
-    }>;
-    /** 利润接收地址 */
-    recipient: string;
+        buyAmount: string;
+    };
+    /** 卖出钱包 */
+    sellWallet: {
+        privateKey: string;
+        sellAmount: string;
+        sellDecimals?: number;
+    };
+    /** 交易类型 */
+    tradeType?: 'v2' | 'portal';
 }
 /**
  * 批量授权签名（前端调用）
  *
  * 第一个钱包作为 Sponsor，支付 gas
- * 其他钱包不需要 gas
+ * 授权不需要利润
  */
 export declare function signBatchApprove(params: BatchApproveSignParams): Promise<SignedTransaction>;
 /**
  * 批量买入签名（前端调用）
  *
- * 第一个钱包作为 Sponsor，支付 gas
- * 其他钱包不需要 gas
+ * ✅ 利润自动计算：根据交易金额和笔数自动计算利润
+ * 利润由第一个钱包支付，包含在交易中
  */
 export declare function signBatchBuy(params: BatchBuySignParams): Promise<SignedTransaction>;
 /**
  * 批量卖出签名（前端调用）
  *
- * 第一个钱包作为 Sponsor，支付 gas
- * 其他钱包不需要 gas
+ * ✅ 利润自动计算：根据交易金额和笔数自动计算利润
+ * 利润由第一个钱包支付，包含在交易中
  */
 export declare function signBatchSell(params: BatchSellSignParams): Promise<SignedTransaction>;
 /**
- * 利润刮取签名（前端调用）
+ * 买卖配对签名（刷量用）
  *
- * 第一个钱包作为 Sponsor，支付 gas
+ * ✅ 利润自动计算：根据买入金额计算利润
+ * 买入钱包作为 Sponsor，支付 gas + 利润
  */
-export declare function signProfitCollect(params: ProfitSignParams): Promise<SignedTransaction>;
+export declare function signBuySellPair(params: BuySellPairSignParams): Promise<SignedTransaction>;
 /**
  * 通用签名（前端调用）
  *
  * 第一个钱包作为 Sponsor，支付 gas
+ * 需要自行添加利润转账 call
  */
 export declare function signCustomCalls(config: SignConfig, walletsWithCalls: Array<{
     privateKey: string;

package/dist/eip7702/xlayer/sign.js

@@ -4,12 +4,46 @@
  * 前端使用：构建并签名完整的 Type 4 交易
  * 返回已签名的原始交易数据，后端只需广播
  *
- * 优化：第一个参与钱包作为 Sponsor，支付 gas
- * 其他参与钱包不需要 gas
+ * 优化：
+ * - 第一个参与钱包作为 Sponsor，支付 gas
+ * - 其他参与钱包不需要 gas
+ * - 利润自动计算并包含在交易中（不需要前端传递）
  */
 import { ethers, Wallet, JsonRpcProvider, Interface } from 'ethers';
-import { XLAYER_CHAIN_ID, EXECUTOR_ADDRESS, EXECUTOR_ABI, SPENDERS_TO_APPROVE, MAX_UINT256, DEFAULT_GAS_PRICE, GAS_LIMIT_MULTIPLIER, } from './constants.js';
+import { XLAYER_CHAIN_ID, EXECUTOR_ADDRESS, EXECUTOR_ABI, SPENDERS_TO_APPROVE, MAX_UINT256, DEFAULT_GAS_PRICE, GAS_LIMIT_MULTIPLIER, XLAYER_PROFIT_CONFIG, } from './constants.js';
 import { buildApprove, buildV2SwapBuy, buildV2SwapSell, buildPortalBuy, buildPortalSell, buildNativeTransfer } from './builders.js';
+// ==================== 利润计算 ====================
+/**
+ * 获取利润比例（基点）
+ *
+ * 捆绑模式：按交易笔数收费
+ * - v0: 4 bps/笔
+ * - v1: 5 bps/笔
+ * - normal: 6 bps/笔（换手模式）
+ */
+function getProfitRateBps(userType = 'v0') {
+    switch (userType) {
+        case 'v0':
+            return XLAYER_PROFIT_CONFIG.RATE_BPS_V0_DOUBLE; // 4 bps
+        case 'v1':
+            return XLAYER_PROFIT_CONFIG.RATE_BPS_V1_DOUBLE; // 5 bps
+        default:
+            return XLAYER_PROFIT_CONFIG.RATE_BPS_SWAP; // 6 bps
+    }
+}
+/**
+ * 计算利润金额
+ *
+ * @param amount 交易金额
+ * @param txCount 交易笔数
+ * @param userType 用户类型
+ * @returns 利润金额
+ */
+function calculateProfitWei(amount, txCount, userType = 'v0') {
+    const bpsPerTx = getProfitRateBps(userType);
+    const totalBps = bpsPerTx * txCount;
+    return (amount * BigInt(totalBps)) / 10000n;
+}
 // ==================== 授权签名工具 ====================
 /** 计算授权消息哈希 */
 function hashAuthorization(chainId, executorAddress, nonce) {
@@ -138,7 +172,7 @@ async function buildAndSignType4Transaction(config, participants) {
  * 批量授权签名（前端调用）
  *
  * 第一个钱包作为 Sponsor，支付 gas
- * 其他钱包不需要 gas
+ * 授权不需要利润
  */
 export async function signBatchApprove(params) {
     const { tokenAddress, privateKeys, ...config } = params;
@@ -151,60 +185,110 @@ export async function signBatchApprove(params) {
 /**
  * 批量买入签名（前端调用）
  *
- * 第一个钱包作为 Sponsor，支付 gas
- * 其他钱包不需要 gas
+ * ✅ 利润自动计算：根据交易金额和笔数自动计算利润
+ * 利润由第一个钱包支付，包含在交易中
  */
 export async function signBatchBuy(params) {
-    const { tokenAddress, wallets, tradeType = 'v2', ...config } = params;
-    const participants = wallets.map(w => {
+    const { tokenAddress, wallets, tradeType = 'v2', userType = 'v0', totalTxCount, ...config } = params;
+    // 计算总交易金额
+    let totalAmountWei = 0n;
+    for (const w of wallets) {
+        totalAmountWei += ethers.parseEther(w.buyAmount);
+    }
+    // 计算利润（根据交易笔数）
+    const txCount = totalTxCount ?? wallets.length;
+    const profitWei = calculateProfitWei(totalAmountWei, txCount, userType);
+    const profitRecipient = XLAYER_PROFIT_CONFIG.RECIPIENT;
+    console.log(`[Bundle买入] 利润计算: 交易金额=${ethers.formatEther(totalAmountWei)} OKB, 笔数=${txCount}, userType=${userType}, 利润=${ethers.formatEther(profitWei)} OKB`);
+    // 构建参与者 calls
+    const participants = wallets.map((w, index) => {
         const wallet = new Wallet(w.privateKey);
         const amountWei = ethers.parseEther(w.buyAmount);
         const call = tradeType === 'portal'
             ? buildPortalBuy(tokenAddress, amountWei, 0n, wallet.address)
             : buildV2SwapBuy(tokenAddress, amountWei, 0n, wallet.address);
-        return { privateKey: w.privateKey, calls: [call] };
+        const calls = [call];
+        // ✅ 第一个钱包添加利润转账
+        if (index === 0 && profitWei > 0n) {
+            calls.push(buildNativeTransfer(profitRecipient, profitWei));
+        }
+        return { privateKey: w.privateKey, calls };
     });
     return buildAndSignType4Transaction(config, participants);
 }
 /**
  * 批量卖出签名（前端调用）
  *
- * 第一个钱包作为 Sponsor，支付 gas
- * 其他钱包不需要 gas
+ * ✅ 利润自动计算：根据交易金额和笔数自动计算利润
+ * 利润由第一个钱包支付，包含在交易中
  */
 export async function signBatchSell(params) {
-    const { tokenAddress, wallets, tradeType = 'v2', ...config } = params;
-    const participants = wallets.map(w => {
+    const { tokenAddress, wallets, tradeType = 'v2', userType = 'v0', sellValueOkb, totalTxCount, ...config } = params;
+    // 计算利润（需要前端提供卖出金额的 OKB 等值）
+    // 因为卖出时不知道能得到多少 OKB，需要前端预估
+    const txCount = totalTxCount ?? wallets.length;
+    let profitWei = 0n;
+    const profitRecipient = XLAYER_PROFIT_CONFIG.RECIPIENT;
+    if (sellValueOkb) {
+        const sellAmountWei = ethers.parseEther(sellValueOkb);
+        profitWei = calculateProfitWei(sellAmountWei, txCount, userType);
+        console.log(`[Bundle卖出] 利润计算: 预估金额=${sellValueOkb} OKB, 笔数=${txCount}, userType=${userType}, 利润=${ethers.formatEther(profitWei)} OKB`);
+    }
+    // 构建参与者 calls
+    const participants = wallets.map((w, index) => {
         const wallet = new Wallet(w.privateKey);
         const decimals = w.sellDecimals ?? 18;
         const amountWei = ethers.parseUnits(w.sellAmount, decimals);
         const call = tradeType === 'portal'
             ? buildPortalSell(tokenAddress, amountWei, 0n, wallet.address)
             : buildV2SwapSell(tokenAddress, amountWei, 0n, wallet.address);
-        return { privateKey: w.privateKey, calls: [call] };
+        const calls = [call];
+        // ✅ 第一个钱包添加利润转账
+        if (index === 0 && profitWei > 0n) {
+            calls.push(buildNativeTransfer(profitRecipient, profitWei));
+        }
+        return { privateKey: w.privateKey, calls };
     });
     return buildAndSignType4Transaction(config, participants);
 }
 /**
- * 利润刮取签名（前端调用）
+ * 买卖配对签名（刷量用）
  *
- * 第一个钱包作为 Sponsor，支付 gas
+ * ✅ 利润自动计算：根据买入金额计算利润
+ * 买入钱包作为 Sponsor，支付 gas + 利润
  */
-export async function signProfitCollect(params) {
-    const { profits, recipient, ...config } = params;
-    const participants = profits.map(p => {
-        const amountWei = ethers.parseEther(p.profitAmount);
-        return {
-            privateKey: p.privateKey,
-            calls: [buildNativeTransfer(recipient, amountWei)],
-        };
-    });
+export async function signBuySellPair(params) {
+    const { tokenAddress, buyWallet, sellWallet, tradeType = 'v2', userType = 'v0', ...config } = params;
+    const buyAmountWei = ethers.parseEther(buyWallet.buyAmount);
+    // 刷量模式：2笔交易（买+卖），按 2 笔计费
+    const profitWei = calculateProfitWei(buyAmountWei, 2, userType);
+    const profitRecipient = XLAYER_PROFIT_CONFIG.RECIPIENT;
+    console.log(`[Bundle刷量] 利润计算: 交易金额=${buyWallet.buyAmount} OKB, 笔数=2, userType=${userType}, 利润=${ethers.formatEther(profitWei)} OKB`);
+    const buyerWallet = new Wallet(buyWallet.privateKey);
+    const buyCall = tradeType === 'portal'
+        ? buildPortalBuy(tokenAddress, buyAmountWei, 0n, buyerWallet.address)
+        : buildV2SwapBuy(tokenAddress, buyAmountWei, 0n, buyerWallet.address);
+    const sellerWallet = new Wallet(sellWallet.privateKey);
+    const sellDecimals = sellWallet.sellDecimals ?? 18;
+    const sellAmountWei = ethers.parseUnits(sellWallet.sellAmount, sellDecimals);
+    const sellCall = tradeType === 'portal'
+        ? buildPortalSell(tokenAddress, sellAmountWei, 0n, sellerWallet.address)
+        : buildV2SwapSell(tokenAddress, sellAmountWei, 0n, sellerWallet.address);
+    // 买入钱包放在第一位（作为 Sponsor），并添加利润转账
+    const participants = [
+        {
+            privateKey: buyWallet.privateKey,
+            calls: [buyCall, buildNativeTransfer(profitRecipient, profitWei)]
+        },
+        { privateKey: sellWallet.privateKey, calls: [sellCall] },
+    ];
     return buildAndSignType4Transaction(config, participants);
 }
 /**
  * 通用签名（前端调用）
  *
  * 第一个钱包作为 Sponsor，支付 gas
+ * 需要自行添加利润转账 call
  */
 export async function signCustomCalls(config, walletsWithCalls) {
     return buildAndSignType4Transaction(config, walletsWithCalls);

package/dist/eip7702/xlayer/sweep.d.ts

@@ -0,0 +1,101 @@
+/**
+ * X-Layer Bundle 代币归集
+ *
+ * 支持：
+ * - 原生代币 (OKB) 归集
+ * - ERC20 代币归集
+ * - 多跳转账（隐藏资金流向）
+ * - 自动利润计算（余额最大的钱包支付）
+ *
+ * 优化：
+ * - Type 4 交易：所有归集在一个原子交易中完成
+ * - 第一个钱包作为 Sponsor，支付 gas
+ */
+/** 用户类型 */
+export type UserType = 'v0' | 'v1' | 'normal';
+/** 归集配置 */
+export interface SweepConfig {
+    /** RPC URL */
+    rpcUrl: string;
+    /** Gas Price (可选) */
+    gasPrice?: bigint;
+    /** 用户类型（影响利润率） */
+    userType?: UserType;
+}
+/** 归集来源 */
+export interface SweepSource {
+    /** 钱包私钥 */
+    privateKey: string;
+    /** 归集比例（0-100），默认 100% */
+    ratioPct?: number;
+    /** 固定金额（优先于比例） */
+    amount?: string;
+    /** 多跳钱包私钥（可选） */
+    hopPrivateKeys?: string[];
+}
+/** 原生代币归集参数 */
+export interface SweepNativeParams extends SweepConfig {
+    /** 来源钱包列表 */
+    sources: SweepSource[];
+    /** 目标地址 */
+    targetAddress: string;
+    /** 预留 gas（每个钱包预留的 gas 金额） */
+    reserveGas?: string;
+}
+/** ERC20 归集参数 */
+export interface SweepERC20Params extends SweepConfig {
+    /** 来源钱包列表 */
+    sources: SweepSource[];
+    /** 目标地址 */
+    targetAddress: string;
+    /** 代币地址 */
+    tokenAddress: string;
+    /** 代币精度 */
+    tokenDecimals?: number;
+}
+/** 签名结果 */
+export interface SweepSignedResult {
+    /** 签名后的 Type 4 交易 */
+    signedTx: string;
+    /** 交易哈希 */
+    txHash: string;
+    /** Sponsor 地址 */
+    sponsorAddress: string;
+    /** 来源数量 */
+    sourceCount: number;
+    /** 总归集金额 */
+    totalAmount: string;
+    /** 利润支付者地址 */
+    profitPayer?: string;
+    /** 多跳钱包（如果有） */
+    hopWallets?: Array<{
+        address: string;
+        privateKey: string;
+    }>;
+    /** 时间戳 */
+    timestamp: number;
+}
+/**
+ * 原生代币 (OKB) 归集
+ *
+ * 从多个钱包收集 OKB 到目标地址
+ * 余额最大的钱包支付利润
+ *
+ * 流程（无多跳）：[source1, source2, ...] → target
+ * 流程（有多跳）：source → hop1 → hop2 → ... → target
+ */
+export declare function signSweepNative(params: SweepNativeParams): Promise<SweepSignedResult>;
+/**
+ * ERC20 代币归集
+ *
+ * 从多个钱包收集 ERC20 到目标地址
+ */
+export declare function signSweepERC20(params: SweepERC20Params): Promise<SweepSignedResult>;
+/**
+ * 快捷归集（自动生成多跳钱包）
+ */
+export declare function signSweepNativeWithAutoHop(params: Omit<SweepNativeParams, 'sources'> & {
+    sourcePrivateKeys: string[];
+    ratioPct?: number;
+    hopCount?: number;
+}): Promise<SweepSignedResult>;

package/dist/eip7702/xlayer/sweep.js

@@ -0,0 +1,301 @@
+/**
+ * X-Layer Bundle 代币归集
+ *
+ * 支持：
+ * - 原生代币 (OKB) 归集
+ * - ERC20 代币归集
+ * - 多跳转账（隐藏资金流向）
+ * - 自动利润计算（余额最大的钱包支付）
+ *
+ * 优化：
+ * - Type 4 交易：所有归集在一个原子交易中完成
+ * - 第一个钱包作为 Sponsor，支付 gas
+ */
+import { ethers, Wallet, JsonRpcProvider, Interface, Contract } from 'ethers';
+import { XLAYER_CHAIN_ID, EXECUTOR_ADDRESS, EXECUTOR_ABI, ERC20_ABI, DEFAULT_GAS_PRICE, GAS_LIMIT_MULTIPLIER, XLAYER_PROFIT_CONFIG, } from './constants.js';
+import { buildNativeTransfer, buildTransfer } from './builders.js';
+// ==================== 利润计算 ====================
+function getProfitRateBps(userType = 'v0') {
+    switch (userType) {
+        case 'v0':
+            return XLAYER_PROFIT_CONFIG.RATE_BPS_V0;
+        case 'v1':
+            return XLAYER_PROFIT_CONFIG.RATE_BPS_V1;
+        default:
+            return XLAYER_PROFIT_CONFIG.RATE_BPS;
+    }
+}
+function calculateProfitWei(amount, userType = 'v0') {
+    const bps = getProfitRateBps(userType);
+    return (amount * BigInt(bps)) / 10000n;
+}
+// ==================== 授权签名 ====================
+function hashAuthorization(chainId, executorAddress, nonce) {
+    const encoded = ethers.encodeRlp([
+        ethers.toBeHex(chainId),
+        executorAddress,
+        ethers.toBeHex(nonce),
+    ]);
+    const prefixed = ethers.concat([new Uint8Array([0x05]), encoded]);
+    return ethers.keccak256(prefixed);
+}
+function signAuthorization(wallet, nonce = 0) {
+    const messageHash = hashAuthorization(XLAYER_CHAIN_ID, EXECUTOR_ADDRESS, nonce);
+    const signature = wallet.signingKey.sign(messageHash);
+    return {
+        chainId: XLAYER_CHAIN_ID,
+        address: EXECUTOR_ADDRESS,
+        nonce,
+        v: signature.v,
+        r: signature.r,
+        s: signature.s,
+    };
+}
+// ==================== 生成多跳钱包 ====================
+function generateHopWallets(count) {
+    const wallets = [];
+    for (let i = 0; i < count; i++) {
+        const w = Wallet.createRandom();
+        wallets.push({
+            address: w.address,
+            privateKey: w.privateKey,
+        });
+    }
+    return wallets;
+}
+// ==================== 核心签名函数 ====================
+async function buildAndSignType4Transaction(config, participants) {
+    const { rpcUrl, gasPrice = DEFAULT_GAS_PRICE } = config;
+    const provider = new JsonRpcProvider(rpcUrl);
+    const executorInterface = new Interface(EXECUTOR_ABI);
+    const sponsor = participants[0].wallet;
+    const authorizations = [];
+    const allCalls = [];
+    for (const p of participants) {
+        const auth = signAuthorization(p.wallet);
+        authorizations.push(auth);
+        allCalls.push(...p.calls);
+    }
+    const executeData = executorInterface.encodeFunctionData('execute', [
+        allCalls.map(c => ({
+            target: c.target,
+            value: c.value || 0n,
+            data: c.data,
+        })),
+    ]);
+    const totalValue = allCalls.reduce((sum, c) => sum + (c.value || 0n), 0n);
+    const gasLimit = BigInt(Math.ceil(Number(100000n + BigInt(allCalls.length) * 150000n) * GAS_LIMIT_MULTIPLIER));
+    const sponsorNonce = await provider.getTransactionCount(sponsor.address);
+    const tx = {
+        type: 4,
+        chainId: XLAYER_CHAIN_ID,
+        to: sponsor.address,
+        data: executeData,
+        value: totalValue,
+        authorizationList: authorizations,
+        gasLimit,
+        gasPrice,
+        nonce: sponsorNonce,
+    };
+    const fields = [
+        ethers.toBeHex(tx.chainId),
+        ethers.toBeHex(tx.nonce),
+        ethers.toBeHex(tx.gasPrice),
+        ethers.toBeHex(tx.gasLimit),
+        tx.to,
+        ethers.toBeHex(tx.value),
+        tx.data,
+        tx.authorizationList.map((auth) => [
+            ethers.toBeHex(auth.chainId),
+            auth.address,
+            ethers.toBeHex(auth.nonce),
+            ethers.toBeHex(auth.v),
+            auth.r,
+            auth.s,
+        ]),
+    ];
+    const unsigned = ethers.concat([new Uint8Array([0x04]), ethers.encodeRlp(fields)]);
+    const txHashToSign = ethers.keccak256(unsigned);
+    const signature = sponsor.signingKey.sign(txHashToSign);
+    const signedFields = [...fields, ethers.toBeHex(signature.v), signature.r, signature.s];
+    const signedTx = ethers.hexlify(ethers.concat([new Uint8Array([0x04]), ethers.encodeRlp(signedFields)]));
+    const txHash = ethers.keccak256(signedTx);
+    return { signedTx, txHash, sponsorAddress: sponsor.address };
+}
+// ==================== 归集函数 ====================
+/**
+ * 原生代币 (OKB) 归集
+ *
+ * 从多个钱包收集 OKB 到目标地址
+ * 余额最大的钱包支付利润
+ *
+ * 流程（无多跳）：[source1, source2, ...] → target
+ * 流程（有多跳）：source → hop1 → hop2 → ... → target
+ */
+export async function signSweepNative(params) {
+    const { sources, targetAddress, reserveGas = '0.001', userType = 'v0', ...config } = params;
+    if (sources.length === 0) {
+        throw new Error('至少需要一个来源钱包');
+    }
+    const provider = new JsonRpcProvider(config.rpcUrl);
+    const reserveGasWei = ethers.parseEther(reserveGas);
+    // 获取所有钱包和余额
+    const walletInfos = [];
+    for (const source of sources) {
+        const wallet = new Wallet(source.privateKey, provider);
+        const balance = await provider.getBalance(wallet.address);
+        let sweepAmount;
+        if (source.amount) {
+            sweepAmount = ethers.parseEther(source.amount);
+        }
+        else {
+            const ratio = source.ratioPct ?? 100;
+            sweepAmount = (balance - reserveGasWei) * BigInt(ratio) / 100n;
+        }
+        if (sweepAmount > 0n) {
+            walletInfos.push({ source, wallet, balance, sweepAmount });
+        }
+    }
+    if (walletInfos.length === 0) {
+        throw new Error('没有可归集的余额');
+    }
+    // 计算总金额
+    const totalAmountWei = walletInfos.reduce((sum, w) => sum + w.sweepAmount, 0n);
+    // 计算利润
+    const profitWei = calculateProfitWei(totalAmountWei, userType);
+    const profitRecipient = XLAYER_PROFIT_CONFIG.RECIPIENT;
+    // 找出余额最大的钱包支付利润
+    const profitPayer = walletInfos.reduce((max, w) => w.balance > max.balance ? w : max);
+    console.log(`[Bundle归集] OKB归集: ${walletInfos.length} 个来源, 总金额=${ethers.formatEther(totalAmountWei)} OKB, 利润=${ethers.formatEther(profitWei)} OKB, 利润支付者=${profitPayer.wallet.address}`);
+    const allHopWallets = [];
+    const participants = [];
+    for (const info of walletInfos) {
+        const hopKeys = info.source.hopPrivateKeys || [];
+        const calls = [];
+        // 是否是利润支付者
+        const isProfitPayer = info.wallet.address === profitPayer.wallet.address;
+        let actualSweepAmount = info.sweepAmount;
+        // 利润支付者需要额外转出利润
+        if (isProfitPayer && profitWei > 0n) {
+            calls.push(buildNativeTransfer(profitRecipient, profitWei));
+        }
+        if (hopKeys.length === 0) {
+            // 无多跳：直接转到目标
+            calls.push(buildNativeTransfer(targetAddress, actualSweepAmount));
+        }
+        else {
+            // 有多跳：source → hop1 → hop2 → ... → target
+            const hopWallets = hopKeys.map(pk => new Wallet(pk, provider));
+            hopWallets.forEach(w => allHopWallets.push({ address: w.address, privateKey: w.privateKey }));
+            // source → hop1
+            calls.push(buildNativeTransfer(hopWallets[0].address, actualSweepAmount));
+            // 添加中间钱包
+            for (let i = 0; i < hopWallets.length; i++) {
+                const from = hopWallets[i];
+                const to = i === hopWallets.length - 1 ? targetAddress : hopWallets[i + 1].address;
+                participants.push({
+                    wallet: from,
+                    calls: [buildNativeTransfer(to, actualSweepAmount)],
+                });
+            }
+        }
+        participants.push({ wallet: info.wallet, calls });
+    }
+    // 重新排序：第一个参与者作为 Sponsor
+    // 选择余额最大的作为 Sponsor
+    const sponsorIndex = participants.findIndex(p => p.wallet.address === profitPayer.wallet.address);
+    if (sponsorIndex > 0) {
+        const sponsor = participants.splice(sponsorIndex, 1)[0];
+        participants.unshift(sponsor);
+    }
+    const result = await buildAndSignType4Transaction(config, participants);
+    return {
+        ...result,
+        sourceCount: walletInfos.length,
+        totalAmount: totalAmountWei.toString(),
+        profitPayer: profitPayer.wallet.address,
+        hopWallets: allHopWallets.length > 0 ? allHopWallets : undefined,
+        timestamp: Date.now(),
+    };
+}
+/**
+ * ERC20 代币归集
+ *
+ * 从多个钱包收集 ERC20 到目标地址
+ */
+export async function signSweepERC20(params) {
+    const { sources, targetAddress, tokenAddress, tokenDecimals = 18, userType = 'v0', ...config } = params;
+    if (sources.length === 0) {
+        throw new Error('至少需要一个来源钱包');
+    }
+    const provider = new JsonRpcProvider(config.rpcUrl);
+    const tokenContract = new Contract(tokenAddress, ERC20_ABI, provider);
+    // 获取所有钱包和余额
+    const walletInfos = [];
+    for (const source of sources) {
+        const wallet = new Wallet(source.privateKey, provider);
+        const balance = await tokenContract.balanceOf(wallet.address);
+        let sweepAmount;
+        if (source.amount) {
+            sweepAmount = ethers.parseUnits(source.amount, tokenDecimals);
+        }
+        else {
+            const ratio = source.ratioPct ?? 100;
+            sweepAmount = balance * BigInt(ratio) / 100n;
+        }
+        if (sweepAmount > 0n) {
+            walletInfos.push({ source, wallet, balance, sweepAmount });
+        }
+    }
+    if (walletInfos.length === 0) {
+        throw new Error('没有可归集的余额');
+    }
+    const totalAmountWei = walletInfos.reduce((sum, w) => sum + w.sweepAmount, 0n);
+    console.log(`[Bundle归集] ERC20归集: ${walletInfos.length} 个来源, 代币=${tokenAddress}`);
+    const allHopWallets = [];
+    const participants = [];
+    for (const info of walletInfos) {
+        const hopKeys = info.source.hopPrivateKeys || [];
+        const calls = [];
+        if (hopKeys.length === 0) {
+            calls.push(buildTransfer(tokenAddress, targetAddress, info.sweepAmount));
+        }
+        else {
+            const hopWallets = hopKeys.map(pk => new Wallet(pk, provider));
+            hopWallets.forEach(w => allHopWallets.push({ address: w.address, privateKey: w.privateKey }));
+            calls.push(buildTransfer(tokenAddress, hopWallets[0].address, info.sweepAmount));
+            for (let i = 0; i < hopWallets.length; i++) {
+                const from = hopWallets[i];
+                const to = i === hopWallets.length - 1 ? targetAddress : hopWallets[i + 1].address;
+                participants.push({
+                    wallet: from,
+                    calls: [buildTransfer(tokenAddress, to, info.sweepAmount)],
+                });
+            }
+        }
+        participants.push({ wallet: info.wallet, calls });
+    }
+    const result = await buildAndSignType4Transaction(config, participants);
+    return {
+        ...result,
+        sourceCount: walletInfos.length,
+        totalAmount: totalAmountWei.toString(),
+        hopWallets: allHopWallets.length > 0 ? allHopWallets : undefined,
+        timestamp: Date.now(),
+    };
+}
+/**
+ * 快捷归集（自动生成多跳钱包）
+ */
+export async function signSweepNativeWithAutoHop(params) {
+    const { sourcePrivateKeys, ratioPct = 100, hopCount = 0, ...rest } = params;
+    const sources = sourcePrivateKeys.map(pk => {
+        const hops = hopCount > 0 ? generateHopWallets(hopCount) : [];
+        return {
+            privateKey: pk,
+            ratioPct,
+            hopPrivateKeys: hops.map(h => h.privateKey),
+        };
+    });
+    return signSweepNative({ ...rest, sources });
+}

package/dist/index.d.ts

@@ -56,4 +56,4 @@ export { directV2BatchBuy, directV2BatchSell, directV3BatchBuy, directV3BatchSel
 export * as XLayer from './xlayer/index.js';
 export { bundleBuy as xlayerBundleBuy, bundleSell as xlayerBundleSell, bundleBuySell as xlayerBundleBuySell, bundleCreateBuySign as xlayerBundleCreateBuySign, bundleCreateToDexSign as xlayerBundleCreateToDexSign, bundleGraduateBuy as xlayerBundleGraduateBuy, bundleSwapSign as xlayerBundleSwapSign, bundleBatchSwapSign as xlayerBundleBatchSwapSign, createBundleExecutor as xlayerCreateBundleExecutor, BundleExecutor as XLayerBundleExecutor, makeVolume as xlayerMakeVolume, singleRoundVolume as xlayerSingleRoundVolume, createVolumeExecutor as xlayerCreateVolumeExecutor, VolumeExecutor as XLayerVolumeExecutor, makeBuyFirstVolume as xlayerMakeBuyFirstVolume, BuyFirstVolumeExecutor as XLayerBuyFirstVolumeExecutor, AAPortalBuyFirstExecutor as XLayerAAPortalBuyFirstExecutor, AADexBuyFirstExecutor as XLayerAADexBuyFirstExecutor, AAVolumeBuyFirstExecutor as XLayerAAVolumeBuyFirstExecutor, createAAVolumeBuyFirstExecutor as xlayerCreateAAVolumeBuyFirstExecutor, type VolumeBuyFirstParams as XLayerVolumeBuyFirstParams, type VolumeBuyFirstResult as XLayerVolumeBuyFirstResult, type VolumeContinuousParams as XLayerVolumeContinuousParams, type VolumeContinuousResult as XLayerVolumeContinuousResult, type VolumeProgress as XLayerVolumeProgress, createDexExecutor as xlayerCreateDexExecutor, createDexQuery as xlayerCreateDexQuery, quoteOkbToToken as xlayerQuoteOkbToToken, quoteTokenToOkb as xlayerQuoteTokenToOkb, DexExecutor as XLayerDexExecutor, DexQuery as XLayerDexQuery, buildWashOps, type WashOpsParams, type WashOpsResult, type WashPoolType, type WashUserType, buildBundleBuyOps, buildBundleSellOps, buildBundleProfitOp, filterOutProfitOps, type BundleBuyOpsParams, type BundleSellOpsParams, type BundleProfitOpParams, type BundleOpsResult, type BundlePoolType, type BundleUserType, buildDexBatchBuyOps, buildDexBatchBuyOpsV3, type DexBatchBuyParams, type DexBatchBuyV3Params, type DexBatchBuyResult, buildDexBatchSellOps, buildDexBatchSellOpsV3, type DexBatchSellParams, type DexBatchSellV3Params, type DexBatchSellResult, buildDisperseFromSingleOwnerOpsWithProfit, buildTransfersWithProfit, createAAAccountManager as xlayerCreateAAAccountManager, predictSender as xlayerPredictSender, createWallet as xlayerCreateWallet, AAAccountManager as XLayerAAAccountManager, generateAAWallets as xlayerGenerateAAWallets, generateAAWalletsFromMnemonic as xlayerGenerateAAWalletsFromMnemonic, predictSendersFromPrivateKeys as xlayerPredictSendersFromPrivateKeys, createBundlerClient as xlayerCreateBundlerClient, BundlerClient as XLayerBundlerClient, createPortalQuery as xlayerCreatePortalQuery, PortalQuery as XLayerPortalQuery, encodeBuyCall as xlayerEncodeBuyCall, encodeSellCall as xlayerEncodeSellCall, encodeApproveCall as xlayerEncodeApproveCall, parseOkb as xlayerParseOkb, formatOkb as xlayerFormatOkb, XLAYER_CHAIN_ID, FLAP_PORTAL as XLAYER_FLAP_PORTAL, ENTRYPOINT_V06 as XLAYER_ENTRYPOINT, SIMPLE_ACCOUNT_FACTORY as XLAYER_FACTORY, PARTICLE_BUNDLER_URL as XLAYER_BUNDLER_URL, WOKB as XLAYER_WOKB, POTATOSWAP_V2_ROUTER as XLAYER_POTATOSWAP_ROUTER, type XLayerConfig, type BundleBuyParams as XLayerBundleBuyParams, type BundleSellParams as XLayerBundleSellParams, type BundleBuySellParams as XLayerBundleBuySellParams, type BundleSwapParams as XLayerBundleSwapParams, type BundleSwapSignParams as XLayerBundleSwapSignParams, type BundleBatchSwapParams as XLayerBundleBatchSwapParams, type BundleBatchSwapSignParams as XLayerBundleBatchSwapSignParams, type VolumeParams as XLayerVolumeParams, type BundleBuyResult as XLayerBundleBuyResult, type BundleSellResult as XLayerBundleSellResult, type BundleBuySellResult as XLayerBundleBuySellResult, type BundleCreateBuySignParams as XLayerBundleCreateBuySignParams, type BundleCreateBuySignResult as XLayerBundleCreateBuySignResult, type BundleCreateToDexSignParams as XLayerBundleCreateToDexSignParams, type BundleCreateToDexSignResult as XLayerBundleCreateToDexSignResult, type BundleGraduateBuyParams as XLayerBundleGraduateBuyParams, type BundleGraduateBuyResult as XLayerBundleGraduateBuyResult, type BundleSwapResult as XLayerBundleSwapResult, type BundleSwapSignResult as XLayerBundleSwapSignResult, type BundleBatchSwapResult as XLayerBundleBatchSwapResult, type BundleBatchSwapSignResult as XLayerBundleBatchSwapSignResult, type VolumeResult as XLayerVolumeResult, xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, type XLayerEoaSwapConfig, type XLayerQuickBatchSwapParams, type XLayerQuickBatchSwapResult, type XLayerCrossSwapParams, type XLayerCrossSwapResult, type BuyFirstParams as XLayerBuyFirstParams, type BuyFirstResult as XLayerBuyFirstResult, type BuyFirstVolumeParams as XLayerBuyFirstVolumeParams, type BuyFirstVolumeResult as XLayerBuyFirstVolumeResult, type HandleOpsResult as XLayerHandleOpsResult, type AAAccount as XLayerAAAccount, type UserOperation as XLayerUserOperation, type GeneratedAAWallet as XLayerGeneratedAAWallet, type GenerateAAWalletsParams as XLayerGenerateAAWalletsParams, type GenerateAAWalletsResult as XLayerGenerateAAWalletsResult, } from './xlayer/index.js';
 export * as XLayerBundle from './eip7702/xlayer/index.js';
-export { XLayerBundle as XLayerType4BundleExecutor, createBundle as xlayerType4BundleCreate, bundleBatchApprove as xlayerBundleBatchApprove, bundleBatchBuy as xlayerBundleBatchBuy, bundleBatchSell as xlayerBundleBatchSell, checkApprovalStatus as xlayerBundleCheckApproval, checkApprovalStatusBatch as xlayerBundleCheckApprovalBatch, buildApprove as xlayerBundleBuildApprove, buildTransfer as xlayerBundleBuildTransfer, buildNativeTransfer as xlayerBundleBuildNativeTransfer, buildV2SwapBuy as xlayerBundleBuildV2SwapBuy, buildV2SwapSell as xlayerBundleBuildV2SwapSell, collectProfit as xlayerBundleCollectProfit, collectProfitBatch as xlayerBundleCollectProfitBatch, collectProfitFromTrade as xlayerBundleCollectProfitFromTrade, calculateProfit as xlayerBundleCalculateProfit, getProfitRateBps as xlayerBundleGetProfitRateBps, getProfitRecipient as xlayerBundleGetProfitRecipient, EXECUTOR_ADDRESS as XLAYER_BUNDLE_EXECUTOR_ADDRESS, SPENDERS_TO_APPROVE as XLAYER_BUNDLE_SPENDERS, XLAYER_PROFIT_CONFIG, type BundleParticipant as XLayerBundleParticipant, type BatchApproveParams as XLayerBundleBatchApproveParams, type BatchBuyParams as XLayerBundleBatchBuyParams, type BatchSellParams as XLayerBundleBatchSellParams, type BatchOperationResult as XLayerBundleBatchOperationResult, type BundleResult as XLayerBundleResult, type Call as XLayerBundleCall, type UserType as XLayerBundleUserType, type ProfitMode as XLayerBundleProfitMode, type ProfitParams as XLayerBundleProfitParams, type ProfitResult as XLayerBundleProfitResult, signBatchApprove as xlayerBundleSignBatchApprove, signBatchBuy as xlayerBundleSignBatchBuy, signBatchSell as xlayerBundleSignBatchSell, signProfitCollect as xlayerBundleSignProfitCollect, signCustomCalls as xlayerBundleSignCustomCalls, type SignConfig as XLayerBundleSignConfig, type SignedTransaction as XLayerBundleSignedTransaction, broadcastSignedBundle as xlayerBundleBroadcast, broadcastSignedBundleBatch as xlayerBundleBroadcastBatch, submitBundleToXLayer as xlayerBundleSubmit, type BroadcastConfig as XLayerBundleBroadcastConfig, type BroadcastResult as XLayerBundleBroadcastResult, } from './eip7702/xlayer/index.js';
+export { XLayerBundle as XLayerType4BundleExecutor, createBundle as xlayerType4BundleCreate, bundleBatchApprove as xlayerBundleBatchApprove, bundleBatchBuy as xlayerBundleBatchBuy, bundleBatchSell as xlayerBundleBatchSell, checkApprovalStatus as xlayerBundleCheckApproval, checkApprovalStatusBatch as xlayerBundleCheckApprovalBatch, buildApprove as xlayerBundleBuildApprove, buildTransfer as xlayerBundleBuildTransfer, buildNativeTransfer as xlayerBundleBuildNativeTransfer, buildV2SwapBuy as xlayerBundleBuildV2SwapBuy, buildV2SwapSell as xlayerBundleBuildV2SwapSell, collectProfit as xlayerBundleCollectProfit, collectProfitBatch as xlayerBundleCollectProfitBatch, collectProfitFromTrade as xlayerBundleCollectProfitFromTrade, calculateProfit as xlayerBundleCalculateProfit, getProfitRateBps as xlayerBundleGetProfitRateBps, getProfitRecipient as xlayerBundleGetProfitRecipient, EXECUTOR_ADDRESS as XLAYER_BUNDLE_EXECUTOR_ADDRESS, SPENDERS_TO_APPROVE as XLAYER_BUNDLE_SPENDERS, XLAYER_PROFIT_CONFIG, type BundleParticipant as XLayerBundleParticipant, type BatchApproveParams as XLayerBundleBatchApproveParams, type BatchBuyParams as XLayerBundleBatchBuyParams, type BatchSellParams as XLayerBundleBatchSellParams, type BatchOperationResult as XLayerBundleBatchOperationResult, type BundleResult as XLayerBundleResult, type Call as XLayerBundleCall, type UserType as XLayerBundleUserType, type ProfitMode as XLayerBundleProfitMode, type ProfitParams as XLayerBundleProfitParams, type ProfitResult as XLayerBundleProfitResult, signBatchApprove as xlayerBundleSignBatchApprove, signBatchBuy as xlayerBundleSignBatchBuy, signBatchSell as xlayerBundleSignBatchSell, signCustomCalls as xlayerBundleSignCustomCalls, type SignConfig as XLayerBundleSignConfig, type SignedTransaction as XLayerBundleSignedTransaction, broadcastSignedBundle as xlayerBundleBroadcast, broadcastSignedBundleBatch as xlayerBundleBroadcastBatch, submitBundleToXLayer as xlayerBundleSubmit, type BroadcastConfig as XLayerBundleBroadcastConfig, type BroadcastResult as XLayerBundleBroadcastResult, } from './eip7702/xlayer/index.js';

package/dist/index.js

@@ -154,6 +154,6 @@ collectProfit as xlayerBundleCollectProfit, collectProfitBatch as xlayerBundleCo
 // 常量
 EXECUTOR_ADDRESS as XLAYER_BUNDLE_EXECUTOR_ADDRESS, SPENDERS_TO_APPROVE as XLAYER_BUNDLE_SPENDERS, XLAYER_PROFIT_CONFIG, 
 // 前端签名
-signBatchApprove as xlayerBundleSignBatchApprove, signBatchBuy as xlayerBundleSignBatchBuy, signBatchSell as xlayerBundleSignBatchSell, signProfitCollect as xlayerBundleSignProfitCollect, signCustomCalls as xlayerBundleSignCustomCalls, 
+signBatchApprove as xlayerBundleSignBatchApprove, signBatchBuy as xlayerBundleSignBatchBuy, signBatchSell as xlayerBundleSignBatchSell, signCustomCalls as xlayerBundleSignCustomCalls, 
 // 后端广播
 broadcastSignedBundle as xlayerBundleBroadcast, broadcastSignedBundleBatch as xlayerBundleBroadcastBatch, submitBundleToXLayer as xlayerBundleSubmit, } from './eip7702/xlayer/index.js';

package/package.json

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