four-flap-meme-sdk 3.0.0 → 4.0.0

package/dist/chains/xlayer/eip7702/bytes.d.ts

@@ -0,0 +1,4 @@
+export declare function bigintToBytes(value: bigint): Uint8Array;
+export declare function addressToBytes(address: string): Uint8Array;
+export declare function hexToBytes(hex: string): Uint8Array;
+export declare function trimLeadingZeros(bytes: Uint8Array): Uint8Array;

package/dist/chains/xlayer/eip7702/bytes.js

@@ -0,0 +1,31 @@
+import { ethers } from 'ethers';
+// ========================================
+// 字节转换工具
+// ========================================
+export function bigintToBytes(value) {
+    if (value === 0n)
+        return new Uint8Array(0);
+    let hex = value.toString(16);
+    if (hex.length % 2 !== 0)
+        hex = '0' + hex;
+    const bytes = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+    }
+    return bytes;
+}
+export function addressToBytes(address) {
+    return ethers.getBytes(address);
+}
+export function hexToBytes(hex) {
+    if (hex === '0x' || hex === '')
+        return new Uint8Array(0);
+    return ethers.getBytes(hex);
+}
+export function trimLeadingZeros(bytes) {
+    let start = 0;
+    while (start < bytes.length - 1 && bytes[start] === 0) {
+        start++;
+    }
+    return bytes.slice(start);
+}

package/dist/chains/xlayer/eip7702/gas.d.ts

@@ -0,0 +1,19 @@
+import type { Call3Value } from './types.js';
+/**
+ * 操作类型（用于 gas 估算）
+ */
+export type OperationType = 'transfer' | 'buy' | 'sell' | 'swap' | 'create' | 'approve' | 'graduate' | 'unknown';
+/**
+ * 动态估算 Gas Limit
+ *
+ * @param authorizationCount 授权数量
+ * @param calls Multicall 调用列表
+ * @param configGasLimit 配置的 gas limit（可选，优先使用）
+ * @returns 估算的 gas limit
+ */
+export declare function estimateGasLimit(authorizationCount: number, calls: Call3Value[], configGasLimit?: bigint): bigint;
+/**
+ * 简化版 gas 估算（仅根据调用数量）
+ * 适用于无法分析 callData 的场景
+ */
+export declare function estimateGasLimitSimple(authorizationCount: number, callCount: number, operationType?: 'simple' | 'buy' | 'sell' | 'swap' | 'create' | 'graduate', configGasLimit?: bigint): bigint;

package/dist/chains/xlayer/eip7702/gas.js

@@ -0,0 +1,152 @@
+import { GAS_ESTIMATE } from './constants.js';
+/**
+ * 分析 callData 推断操作类型
+ */
+function inferOperationType(callData) {
+    if (!callData || callData === '0x')
+        return 'transfer';
+    // 根据函数签名推断操作类型
+    const selector = callData.slice(0, 10).toLowerCase();
+    // 常见的函数选择器
+    const selectors = {
+        // 转账
+        '0xa9059cbb': 'transfer', // transfer(address,uint256)
+        // 买入相关
+        '0x7ff36ab5': 'buy', // swapExactETHForTokens
+        '0xb6f9de95': 'buy', // swapExactETHForTokensSupportingFeeOnTransferTokens
+        '0x414bf389': 'buy', // exactInputSingle (V3)
+        '0xc04b8d59': 'buy', // exactInput (V3)
+        // 卖出相关
+        '0x18cbafe5': 'sell', // swapExactTokensForETH
+        '0x791ac947': 'sell', // swapExactTokensForETHSupportingFeeOnTransferTokens
+        '0xdb3e2198': 'sell', // exactOutputSingle (V3)
+        // 授权
+        '0x095ea7b3': 'approve', // approve(address,uint256)
+        // 创建代币
+        '0x': 'create', // 需要更精确的匹配
+    };
+    // UnifiedDelegate 函数选择器（计算得到的 4 字节选择器）
+    const delegateSelectors = {
+        '0x3edd1128': 'transfer', // transferTo(address)
+        '0x2ada9a96': 'transfer', // transferAmount(address,uint256)
+        '0x2cdaa6d3': 'buy', // executeBuy(address,address,address,uint24,uint256)
+        '0x2e87f7de': 'buy', // executeBuyV2(address,address[],uint256)
+        '0x6fcda3a1': 'sell', // executeSell(address,address,address,uint24,uint256)
+        '0x0a3e9e95': 'sell', // executeSellV2(address,address[],uint256)
+        '0x72c18b75': 'sell', // executeSellAndTransfer(address,address,address,uint24,uint256,address)
+        '0x9db6b375': 'sell', // executeSellAndTransferV2(address,address[],uint256,address)
+    };
+    // 先检查标准选择器
+    if (selectors[selector]) {
+        return selectors[selector];
+    }
+    // 检查 UnifiedDelegate 选择器
+    if (delegateSelectors[selector]) {
+        return delegateSelectors[selector];
+    }
+    // 检查 callData 长度和模式
+    if (callData.length < 20) {
+        return 'transfer';
+    }
+    // 默认根据 callData 长度估算
+    if (callData.length > 500) {
+        return 'swap'; // 复杂调用可能是 swap
+    }
+    return 'unknown';
+}
+/**
+ * 根据操作类型获取额外 gas
+ */
+function getExtraGasForOperation(opType) {
+    switch (opType) {
+        case 'transfer':
+            return GAS_ESTIMATE.TRANSFER;
+        case 'buy':
+            return GAS_ESTIMATE.BUY_EXTRA;
+        case 'sell':
+            return GAS_ESTIMATE.SELL_EXTRA;
+        case 'swap':
+            return GAS_ESTIMATE.BUY_EXTRA + GAS_ESTIMATE.SELL_EXTRA;
+        case 'approve':
+            return 50000n;
+        case 'create':
+            return GAS_ESTIMATE.CREATE_TOKEN;
+        default:
+            return GAS_ESTIMATE.PER_CALL_BASE;
+    }
+}
+/**
+ * 动态估算 Gas Limit
+ *
+ * @param authorizationCount 授权数量
+ * @param calls Multicall 调用列表
+ * @param configGasLimit 配置的 gas limit（可选，优先使用）
+ * @returns 估算的 gas limit
+ */
+export function estimateGasLimit(authorizationCount, calls, configGasLimit) {
+    // 如果明确指定了 gasLimit，优先使用
+    if (configGasLimit && configGasLimit > 0n) {
+        return configGasLimit;
+    }
+    // 基础 gas
+    let estimated = GAS_ESTIMATE.BASE;
+    // 授权 gas
+    estimated += BigInt(authorizationCount) * GAS_ESTIMATE.PER_AUTHORIZATION;
+    // 每个调用的 gas
+    for (const call of calls) {
+        // 基础调用 gas
+        estimated += GAS_ESTIMATE.PER_CALL_BASE;
+        // 根据操作类型添加额外 gas
+        const opType = inferOperationType(call.callData);
+        estimated += getExtraGasForOperation(opType);
+    }
+    // 应用安全系数
+    const withSafety = BigInt(Math.ceil(Number(estimated) * GAS_ESTIMATE.SAFETY_MULTIPLIER));
+    // 限制在最小和最大值之间
+    if (withSafety < GAS_ESTIMATE.MIN) {
+        return GAS_ESTIMATE.MIN;
+    }
+    if (withSafety > GAS_ESTIMATE.MAX) {
+        return GAS_ESTIMATE.MAX;
+    }
+    return withSafety;
+}
+/**
+ * 简化版 gas 估算（仅根据调用数量）
+ * 适用于无法分析 callData 的场景
+ */
+export function estimateGasLimitSimple(authorizationCount, callCount, operationType = 'simple', configGasLimit) {
+    if (configGasLimit && configGasLimit > 0n) {
+        return configGasLimit;
+    }
+    // 毕业操作需要固定的高 gas（约 800 万）
+    if (operationType === 'graduate') {
+        return GAS_ESTIMATE.GRADUATE;
+    }
+    let estimated = GAS_ESTIMATE.BASE;
+    estimated += BigInt(authorizationCount) * GAS_ESTIMATE.PER_AUTHORIZATION;
+    estimated += BigInt(callCount) * GAS_ESTIMATE.PER_CALL_BASE;
+    // 根据操作类型添加额外 gas
+    switch (operationType) {
+        case 'buy':
+            estimated += BigInt(callCount) * GAS_ESTIMATE.BUY_EXTRA;
+            break;
+        case 'sell':
+            estimated += BigInt(callCount) * GAS_ESTIMATE.SELL_EXTRA;
+            break;
+        case 'swap':
+            estimated += BigInt(callCount) * (GAS_ESTIMATE.BUY_EXTRA + GAS_ESTIMATE.SELL_EXTRA);
+            break;
+        case 'create':
+            estimated += GAS_ESTIMATE.CREATE_TOKEN;
+            break;
+        default:
+            estimated += BigInt(callCount) * GAS_ESTIMATE.TRANSFER;
+    }
+    const withSafety = BigInt(Math.ceil(Number(estimated) * GAS_ESTIMATE.SAFETY_MULTIPLIER));
+    if (withSafety < GAS_ESTIMATE.MIN)
+        return GAS_ESTIMATE.MIN;
+    if (withSafety > GAS_ESTIMATE.MAX)
+        return GAS_ESTIMATE.MAX;
+    return withSafety;
+}

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

@@ -0,0 +1,5 @@
+/**
+ * multi-hop-transfer - 分散 (Disperse) 一对多
+ */
+import type { DisperseParams, TransferResult } from './multi-hop-transfer-helpers.js';
+export declare function disperse(params: DisperseParams): Promise<TransferResult>;

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

@@ -0,0 +1,196 @@
+/**
+ * multi-hop-transfer - 分散 (Disperse) 一对多
+ */
+import { ethers } from 'ethers';
+import { signAuthorizationsWithNonces, batchGetNonces, buildEIP7702TransactionSync } from './utils.js';
+import { XLAYER_CHAIN_ID } from './constants.js';
+import { calculateTransferFee } from '../../../core/constants/index.js';
+import { createEip7702DelegateContext, generateHopWalletMatrix, isNativeTransferToken, parseTransferAmountsWei, resolveDispersePayerWallets, } from './transfer-context-helpers.js';
+export async function disperse(params) {
+    const { mainPrivateKey, payerPrivateKey, recipients, amounts, tokenAddress, tokenDecimals = 18, hopCount = 0, userType, config, } = params;
+    if (recipients.length !== amounts.length) {
+        throw new Error('recipients 和 amounts 长度必须相同');
+    }
+    const { provider, delegateAddress, delegateInterface, profitRecipient } = createEip7702DelegateContext(config);
+    const { mainWallet, payerWallet, txSender } = resolveDispersePayerWallets(mainPrivateKey, payerPrivateKey, provider);
+    const isNative = isNativeTransferToken(tokenAddress);
+    const { allHopWalletInfos, allHopWallets } = generateHopWalletMatrix(recipients.length, hopCount, provider);
+    const amountsWei = parseTransferAmountsWei(amounts, isNative, tokenDecimals);
+    const totalAmount = amountsWei.reduce((sum, amt) => sum + amt, 0n);
+    // ✅ 按地址数量收取固定费用（原生 OKB）
+    const profitAmountOkb = calculateTransferFee(XLAYER_CHAIN_ID, recipients.length);
+    // ========================================
+    // 并行获取数据
+    // ========================================
+    const addressesToGetNonces = payerWallet ? [payerWallet.address, mainWallet.address] : [mainWallet.address];
+    const [allNoncesResult, feeData] = await Promise.all([
+        batchGetNonces(addressesToGetNonces, provider),
+        provider.getFeeData(),
+    ]);
+    const payerNonce = payerWallet ? allNoncesResult[0] : allNoncesResult[0];
+    const mainNonce = payerWallet ? allNoncesResult[1] : allNoncesResult[0];
+    // ========================================
+    // 同步签署授权（已有 nonce）
+    // ========================================
+    // ✅ 如果有 Payer，需要为 Payer 和 mainWallet 都生成授权
+    const allWallets = payerWallet ? [payerWallet, mainWallet] : [mainWallet];
+    const allNonces = payerWallet ? [payerNonce, mainNonce] : [mainNonce];
+    for (const hopWallets of allHopWallets) {
+        for (const hopWallet of hopWallets) {
+            allWallets.push(hopWallet);
+            allNonces.push(0);
+        }
+    }
+    const authorizations = signAuthorizationsWithNonces(allWallets, allNonces, delegateAddress, 0);
+    // ========================================
+    // 同步构建调用
+    // ========================================
+    const calls = [];
+    for (let i = 0; i < recipients.length; i++) {
+        const recipient = recipients[i];
+        const amtWei = amountsWei[i];
+        const hopWallets = allHopWallets[i];
+        if (hopCount === 0 || hopWallets.length === 0) {
+            // ========================================
+            // 直接分发：主钱包 → 接收者
+            // ========================================
+            if (isNative) {
+                // ✅ Payer 模式：使用 transferAmount（从 mainWallet 余额转出）
+                // ✅ 非 Payer 模式：使用 transferTo（从 msg.value 转出）
+                if (payerWallet) {
+                    calls.push({
+                        target: mainWallet.address,
+                        allowFailure: false,
+                        value: 0n,
+                        callData: delegateInterface.encodeFunctionData('transferAmount', [recipient, amtWei]),
+                    });
+                }
+                else {
+                    calls.push({
+                        target: mainWallet.address,
+                        allowFailure: false,
+                        value: amtWei,
+                        callData: delegateInterface.encodeFunctionData('transferTo', [recipient]),
+                    });
+                }
+            }
+            else {
+                calls.push({
+                    target: mainWallet.address,
+                    allowFailure: false,
+                    value: 0n,
+                    callData: delegateInterface.encodeFunctionData('executeTransfer', [tokenAddress, recipient, amtWei]),
+                });
+            }
+        }
+        else {
+            // ========================================
+            // 多跳分发：主钱包 → hop1 → hop2 → ... → 接收者
+            // ========================================
+            const firstHop = hopWallets[0];
+            const lastHop = hopWallets[hopWallets.length - 1];
+            if (isNative) {
+                // 主钱包 → 第一个中间钱包
+                // ✅ Payer 模式：使用 transferAmount（从 mainWallet 余额转出）
+                if (payerWallet) {
+                    calls.push({
+                        target: mainWallet.address,
+                        allowFailure: false,
+                        value: 0n,
+                        callData: delegateInterface.encodeFunctionData('transferAmount', [firstHop.address, amtWei]),
+                    });
+                }
+                else {
+                    calls.push({
+                        target: mainWallet.address,
+                        allowFailure: false,
+                        value: amtWei,
+                        callData: delegateInterface.encodeFunctionData('transferTo', [firstHop.address]),
+                    });
+                }
+                // 中间钱包之间转账（使用全部余额）
+                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', [recipient]),
+                });
+            }
+            else {
+                // ERC20 多跳
+                // 主钱包 → 第一个中间钱包
+                calls.push({
+                    target: mainWallet.address,
+                    allowFailure: false,
+                    value: 0n,
+                    callData: delegateInterface.encodeFunctionData('executeTransfer', [tokenAddress, firstHop.address, amtWei]),
+                });
+                // 中间钱包之间转账
+                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, recipient]),
+                });
+            }
+        }
+    }
+    // ========================================
+    // 添加利润转账调用（固定费用，OKB）
+    // ========================================
+    if (profitAmountOkb > 0n) {
+        calls.push({
+            target: mainWallet.address,
+            allowFailure: false,
+            value: 0n,
+            callData: delegateInterface.encodeFunctionData('transferAmount', [profitRecipient, profitAmountOkb]),
+        });
+    }
+    // ========================================
+    // 构建交易
+    // ========================================
+    // ✅ Payer 模式下 value 为 0（资金从 mainWallet 转出，不是 Payer）
+    // 无 Payer 时，原生币分发需要传递 value（资金从 txSender 转出）
+    const totalValue = isNative && !payerWallet ? totalAmount : 0n;
+    const signedTransaction = buildEIP7702TransactionSync(txSender, // ✅ 使用 txSender（Payer 或 mainWallet）发起交易
+    authorizations, calls, totalValue, payerNonce, // ✅ 使用 txSender 的 nonce
+    feeData, config);
+    // ✅ 返回所有中间钱包（扁平化）
+    const flatHopWallets = allHopWalletInfos.flat();
+    return {
+        signedTransaction,
+        hopWallets: flatHopWallets.length > 0 ? flatHopWallets : undefined,
+        metadata: {
+            senderAddress: mainWallet.address, // 资金来源
+            payerAddress: txSender.address, // Gas 支付者
+            recipientCount: recipients.length,
+            totalAmount: isNative ? ethers.formatEther(totalAmount) : ethers.formatUnits(totalAmount, tokenDecimals),
+            profitAmount: ethers.formatEther(profitAmountOkb), // ✅ 以 OKB 计
+            isNative,
+            tokenAddress: tokenAddress ?? null,
+            hopCount,
+            userType,
+        },
+    };
+}

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

@@ -0,0 +1,5 @@
+/**
+ * multi-hop-transfer - 多对多 (Pairwise) sender[i] → receiver[i]
+ */
+import type { PairwiseTransferParams, PairwiseTransferResult } from './multi-hop-transfer-helpers.js';
+export declare function pairwiseTransfer(params: PairwiseTransferParams): Promise<PairwiseTransferResult>;

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

@@ -0,0 +1,188 @@
+/**
+ * multi-hop-transfer - 多对多 (Pairwise) sender[i] → receiver[i]
+ */
+import { ethers } from 'ethers';
+import { createWallet, signAuthorizationsWithNonces, batchGetNonces, buildEIP7702TransactionSync } from './utils.js';
+import { XLAYER_CHAIN_ID } from './constants.js';
+import { calculateTransferFee } from '../../../core/constants/index.js';
+import { createEip7702DelegateContext, generateHopWalletMatrix, isNativeTransferToken, normalizePairwiseAmounts, parseTransferAmountsWei, resolveListPayerWallet, } from './transfer-context-helpers.js';
+export async function pairwiseTransfer(params) {
+    const { senderPrivateKeys, receiverAddresses, payerPrivateKey, amount, amounts, tokenAddress, tokenDecimals = 18, hopCount = 0, userType, config, } = params;
+    // 验证参数
+    if (senderPrivateKeys.length !== receiverAddresses.length) {
+        throw new Error(`senderPrivateKeys 长度 (${senderPrivateKeys.length}) 必须与 receiverAddresses 长度 (${receiverAddresses.length}) 相同`);
+    }
+    const pairCount = senderPrivateKeys.length;
+    if (pairCount === 0) {
+        throw new Error('至少需要一对发送者/接收者');
+    }
+    const normalizedAmounts = normalizePairwiseAmounts(pairCount, amount, amounts);
+    const { provider, delegateAddress, delegateInterface, profitRecipient } = createEip7702DelegateContext(config);
+    const isNative = isNativeTransferToken(tokenAddress);
+    const senderWallets = senderPrivateKeys.map((pk) => createWallet(pk, provider));
+    const { payerWallet } = resolveListPayerWallet(senderPrivateKeys, payerPrivateKey, provider);
+    const mainWallet = payerWallet ?? senderWallets[0];
+    const { allHopWalletInfos, allHopWallets } = generateHopWalletMatrix(pairCount, hopCount, provider);
+    const amountsWei = parseTransferAmountsWei(normalizedAmounts, isNative, tokenDecimals);
+    const totalAmount = amountsWei.reduce((sum, amt) => sum + amt, 0n);
+    // ✅ 按地址数量收取固定费用（原生 OKB）
+    const profitAmountOkb = calculateTransferFee(XLAYER_CHAIN_ID, pairCount);
+    // ✅ 使用第一个发送者支付 OKB 利润
+    const maxTransferIndex = 0;
+    // ========================================
+    // 并行获取数据
+    // ========================================
+    const senderAddresses = senderWallets.map((w) => w.address);
+    const addressesToGetNonces = payerWallet ? [payerWallet.address, ...senderAddresses] : senderAddresses;
+    const [allNoncesResult, feeData] = await Promise.all([
+        batchGetNonces(addressesToGetNonces, provider),
+        provider.getFeeData(),
+    ]);
+    // 如果有单独的 Payer，第一个是 Payer 的 nonce，其余是发送者的
+    const payerNonce = payerWallet ? allNoncesResult[0] : allNoncesResult[0];
+    const nonces = payerWallet ? allNoncesResult.slice(1) : allNoncesResult;
+    // ========================================
+    // 构建调用
+    // ========================================
+    const calls = [];
+    for (let i = 0; i < pairCount; i++) {
+        const senderWallet = senderWallets[i];
+        const receiver = receiverAddresses[i];
+        const amtWei = amountsWei[i];
+        const hopWallets = allHopWallets[i];
+        // ✅ 如果有单独的 Payer，发送者使用自己的余额（value: 0n, 由 transferTo 使用 address(this).balance）
+        // ✅ 如果没有 Payer 且是第一个发送者（发起交易），需要传递 value
+        const shouldPassValue = !payerWallet && i === 0;
+        if (hopCount === 0 || hopWallets.length === 0) {
+            // ========================================
+            // 直接转账：sender → receiver
+            // ========================================
+            // ✅ 第一个发送者负责转 OKB 固定费用
+            if (profitAmountOkb > 0n && i === maxTransferIndex) {
+                calls.push({
+                    target: senderWallet.address,
+                    allowFailure: false,
+                    value: 0n,
+                    callData: delegateInterface.encodeFunctionData('transferAmount', [profitRecipient, profitAmountOkb]),
+                });
+            }
+            if (isNative) {
+                calls.push({
+                    target: senderWallet.address,
+                    allowFailure: false,
+                    value: shouldPassValue ? amtWei : 0n,
+                    callData: delegateInterface.encodeFunctionData('transferAmount', [receiver, amtWei]),
+                });
+            }
+            else {
+                // ERC20 代币转账
+                calls.push({
+                    target: senderWallet.address,
+                    allowFailure: false,
+                    value: 0n,
+                    callData: delegateInterface.encodeFunctionData('executeTransfer', [tokenAddress, receiver, amtWei]),
+                });
+            }
+        }
+        else {
+            // ========================================
+            // 多跳转账：sender → hop1 → hop2 → ... → receiver
+            // ========================================
+            const firstHop = hopWallets[0];
+            const lastHop = hopWallets[hopWallets.length - 1];
+            // ✅ 第一个发送者负责转 OKB 固定费用（在转账前）
+            if (profitAmountOkb > 0n && i === maxTransferIndex) {
+                calls.push({
+                    target: senderWallet.address,
+                    allowFailure: false,
+                    value: 0n,
+                    callData: delegateInterface.encodeFunctionData('transferAmount', [profitRecipient, profitAmountOkb]),
+                });
+            }
+            if (isNative) {
+                // 原生 OKB 多跳
+                calls.push({
+                    target: senderWallet.address,
+                    allowFailure: false,
+                    value: shouldPassValue ? amtWei : 0n,
+                    callData: delegateInterface.encodeFunctionData('transferAmount', [firstHop.address, amtWei]),
+                });
+                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', [receiver]),
+                });
+            }
+            else {
+                // ERC20 多跳
+                // sender → 第一个中间钱包（ERC20 代币）
+                calls.push({
+                    target: senderWallet.address,
+                    allowFailure: false,
+                    value: 0n,
+                    callData: delegateInterface.encodeFunctionData('executeTransfer', [tokenAddress, firstHop.address, amtWei]),
+                });
+                // 中间钱包之间转账
+                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,
+                        ]),
+                    });
+                }
+                // 最后一个中间钱包 → receiver
+                calls.push({
+                    target: lastHop.address,
+                    allowFailure: false,
+                    value: 0n,
+                    callData: delegateInterface.encodeFunctionData('executeTransferAll', [tokenAddress, receiver]),
+                });
+            }
+        }
+    }
+    // ========================================
+    // 同步签署授权（已有 nonce）
+    // ========================================
+    // ✅ 如果有单独的 Payer，需要为 Payer 也生成授权
+    const allWallets = payerWallet ? [payerWallet, ...senderWallets] : [...senderWallets];
+    const allNonces = payerWallet ? [payerNonce, ...nonces] : [...nonces];
+    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 ? totalAmount : 0n;
+    const signedTransaction = buildEIP7702TransactionSync(mainWallet, authorizations, calls, totalValue, payerWallet ? payerNonce : nonces[0], feeData, config);
+    return {
+        signedTransaction,
+        hopWallets: hopCount > 0 ? allHopWalletInfos : undefined,
+        metadata: {
+            pairCount,
+            totalAmount: isNative ? ethers.formatEther(totalAmount) : ethers.formatUnits(totalAmount, tokenDecimals),
+            profitAmount: ethers.formatEther(profitAmountOkb), // ✅ 以 OKB 计
+            isNative,
+            tokenAddress: tokenAddress ?? null,
+            hopCount,
+            userType,
+        },
+    };
+}

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

@@ -0,0 +1,5 @@
+/**
+ * multi-hop-transfer - 归集 (Sweep) 多对一
+ */
+import type { SweepParams, TransferResult } from './multi-hop-transfer-helpers.js';
+export declare function sweep(params: SweepParams): Promise<TransferResult>;