four-flap-meme-sdk 1.9.49 → 2.1.0

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

@@ -1,100 +1,28 @@
 /**
- * EIP-7702 转账功能
- *
- * 支持三种模式：
- * 1. 分散 (disperse): 一对多分发资金
- * 2. 归集 (sweep): 多对一收集资金
- * 3. 多对多 (pairwise): sender[i] → receiver[i] 一一对应转账
- *
- * 所有模式都支持：
- * - 原生 OKB 转账
- * - ERC20 代币转账
- * - 可选的多跳混淆
- *
- * 只生成签名，由调用方决定如何提交
+ * multi-hop-transfer - 主函数
  */
 import { ethers, Contract } from 'ethers';
-import { getCachedProvider, createWallet, signAuthorizationsWithNonces, batchGetNonces, buildEIP7702TransactionSync, generateRandomWallets, getProfitRecipient, } from './utils.js';
-import { UNIFIED_DELEGATE_ADDRESS, UNIFIED_DELEGATE_ABI, ERC20_ABI, XLAYER_CHAIN_ID, } from './constants.js';
+import { createWallet, signAuthorizationsWithNonces, batchGetNonces, buildEIP7702TransactionSync } from './utils.js';
+import { ERC20_ABI, XLAYER_CHAIN_ID } from './constants.js';
 import { calculateTransferFee } from '../../../shared/constants/index.js';
-/**
- * 分散资金 - 一对多分发
- *
- * 支持：原生 OKB / ERC20 代币 + 可选多跳
- *
- * 流程（无多跳）：主钱包 → 多个接收者
- * 流程（有多跳）：主钱包 → hop1 → hop2 → ... → 分发给接收者
- *
- * @example
- * // 原生 OKB 直接分发
- * const result = await disperse({
- *   mainPrivateKey: '0x...',
- *   recipients: ['0xAAA', '0xBBB', '0xCCC'],
- *   amounts: ['0.1', '0.2', '0.3'],
- * });
- *
- * @example
- * // 原生 OKB 多跳分发
- * const result = await disperse({
- *   mainPrivateKey: '0x...',
- *   recipients: ['0xAAA', '0xBBB'],
- *   amounts: ['0.5', '0.5'],
- *   hopCount: 2,
- * });
- *
- * @example
- * // ERC20 代币分发
- * const result = await disperse({
- *   mainPrivateKey: '0x...',
- *   recipients: ['0xAAA', '0xBBB'],
- *   amounts: ['100', '200'],
- *   tokenAddress: '0xTOKEN...',
- *   tokenDecimals: 18,
- *   hopCount: 2,
- * });
- */
+import { createEip7702DelegateContext, generateHopWalletMatrix, isNativeTransferToken, normalizePairwiseAmounts, parseTransferAmountsWei, resolveDispersePayerWallets, resolveListPayerWallet, } 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 = getCachedProvider(config?.rpcUrl);
-    const delegateAddress = (config?.delegateAddress && config.delegateAddress.trim()) || UNIFIED_DELEGATE_ADDRESS;
-    const delegateInterface = new ethers.Interface(UNIFIED_DELEGATE_ABI);
-    // ✅ mainWallet: 资金来源（Token/OKB 从这里转出）
-    const mainWallet = createWallet(mainPrivateKey, provider);
-    const isNative = !tokenAddress;
-    const profitRecipient = getProfitRecipient(config);
-    // ✅ 支持单独的 Payer 钱包（用于支付 gas）
-    const hasSeparatePayer = payerPrivateKey && payerPrivateKey !== mainPrivateKey;
-    const payerWallet = hasSeparatePayer ? createWallet(payerPrivateKey, provider) : null;
-    const txSender = payerWallet ?? mainWallet; // 交易发起者
-    // ✅ 为每个接收者生成独立的中间钱包链
-    // 每个接收者有自己的 hopCount 个中间钱包
-    const allHopWalletInfos = [];
-    const allHopWallets = [];
-    for (let i = 0; i < recipients.length; i++) {
-        if (hopCount > 0) {
-            const hopInfos = generateRandomWallets(hopCount);
-            allHopWalletInfos.push(hopInfos);
-            allHopWallets.push(hopInfos.map(info => createWallet(info.privateKey, provider)));
-        }
-        else {
-            allHopWalletInfos.push([]);
-            allHopWallets.push([]);
-        }
-    }
-    // 解析金额
-    const amountsWei = amounts.map(amt => isNative ? ethers.parseEther(amt) : ethers.parseUnits(amt, tokenDecimals));
+    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 addressesToGetNonces = payerWallet ? [payerWallet.address, mainWallet.address] : [mainWallet.address];
     const [allNoncesResult, feeData] = await Promise.all([
         batchGetNonces(addressesToGetNonces, provider),
         provider.getFeeData(),
@@ -113,8 +41,7 @@ export async function disperse(params) {
             allNonces.push(0);
         }
     }
-    const authorizations = signAuthorizationsWithNonces(allWallets, allNonces, delegateAddress, 0 // txSender（Payer 或 mainWallet）是交易发起者
-    );
+    const authorizations = signAuthorizationsWithNonces(allWallets, allNonces, delegateAddress, 0);
     // ========================================
     // 同步构建调用
     // ========================================
@@ -152,11 +79,7 @@ export async function disperse(params) {
                     target: mainWallet.address,
                     allowFailure: false,
                     value: 0n,
-                    callData: delegateInterface.encodeFunctionData('executeTransfer', [
-                        tokenAddress,
-                        recipient,
-                        amtWei,
-                    ]),
+                    callData: delegateInterface.encodeFunctionData('executeTransfer', [tokenAddress, recipient, amtWei]),
                 });
             }
         }
@@ -209,11 +132,7 @@ export async function disperse(params) {
                     target: mainWallet.address,
                     allowFailure: false,
                     value: 0n,
-                    callData: delegateInterface.encodeFunctionData('executeTransfer', [
-                        tokenAddress,
-                        firstHop.address,
-                        amtWei,
-                    ]),
+                    callData: delegateInterface.encodeFunctionData('executeTransfer', [tokenAddress, firstHop.address, amtWei]),
                 });
                 // 中间钱包之间转账
                 for (let j = 0; j < hopWallets.length - 1; j++) {
@@ -232,10 +151,7 @@ export async function disperse(params) {
                     target: lastHop.address,
                     allowFailure: false,
                     value: 0n,
-                    callData: delegateInterface.encodeFunctionData('executeTransferAll', [
-                        tokenAddress,
-                        recipient,
-                    ]),
+                    callData: delegateInterface.encodeFunctionData('executeTransferAll', [tokenAddress, recipient]),
                 });
             }
         }
@@ -256,7 +172,7 @@ export async function disperse(params) {
     // ========================================
     // ✅ Payer 模式下 value 为 0（资金从 mainWallet 转出，不是 Payer）
     // 无 Payer 时，原生币分发需要传递 value（资金从 txSender 转出）
-    const totalValue = (isNative && !payerWallet) ? totalAmount : 0n;
+    const totalValue = isNative && !payerWallet ? totalAmount : 0n;
     const signedTransaction = buildEIP7702TransactionSync(txSender, // ✅ 使用 txSender（Payer 或 mainWallet）发起交易
     authorizations, calls, totalValue, payerNonce, // ✅ 使用 txSender 的 nonce
     feeData, config);
@@ -278,95 +194,44 @@ export async function disperse(params) {
         },
     };
 }
-/**
- * 归集资金 - 多对一收集
- *
- * 支持：原生 OKB / ERC20 代币 + 可选多跳
- *
- * 流程（无多跳）：多个源钱包 → 目标地址
- * 流程（有多跳）：多个源钱包 → hop1 → hop2 → ... → 目标地址
- *
- * @example
- * // 原生 OKB 直接归集
- * const result = await sweep({
- *   targetAddress: '0xTARGET',
- *   sourcePrivateKeys: ['0x...', '0x...'],
- * });
- *
- * @example
- * // 原生 OKB 多跳归集
- * const result = await sweep({
- *   targetAddress: '0xTARGET',
- *   sourcePrivateKeys: ['0x...', '0x...'],
- *   hopCount: 2,
- * });
- *
- * @example
- * // ERC20 代币归集
- * const result = await sweep({
- *   targetAddress: '0xTARGET',
- *   sourcePrivateKeys: ['0x...', '0x...'],
- *   tokenAddress: '0xTOKEN...',
- *   tokenDecimals: 18,
- *   hopCount: 2,
- * });
- */
+// ========================================
+// 归集 (Sweep) - 多对一
+// ========================================
 export async function sweep(params) {
     const { targetAddress, sourcePrivateKeys, payerPrivateKey, tokenAddress, tokenDecimals = 18, hopCount = 0, reserveGas = true, percent = 100, userType, config, } = params;
-    const provider = getCachedProvider(config?.rpcUrl);
-    const delegateAddress = (config?.delegateAddress && config.delegateAddress.trim()) || UNIFIED_DELEGATE_ADDRESS;
-    const delegateInterface = new ethers.Interface(UNIFIED_DELEGATE_ABI);
-    const sourceWallets = sourcePrivateKeys.map(pk => createWallet(pk, provider));
-    const isNative = !tokenAddress;
-    const profitRecipient = getProfitRecipient(config);
-    // ✅ 为每个源钱包生成独立的中间钱包链
-    const allHopWalletInfos = [];
-    const allHopWallets = [];
-    for (let i = 0; i < sourceWallets.length; i++) {
-        if (hopCount > 0) {
-            const hopInfos = generateRandomWallets(hopCount);
-            allHopWalletInfos.push(hopInfos);
-            allHopWallets.push(hopInfos.map(info => createWallet(info.privateKey, provider)));
-        }
-        else {
-            allHopWalletInfos.push([]);
-            allHopWallets.push([]);
-        }
-    }
-    // ✅ 支持单独的 Payer 钱包（用于支付 gas）
-    const hasSeparatePayer = payerPrivateKey && !sourcePrivateKeys.includes(payerPrivateKey);
-    const payerWallet = hasSeparatePayer ? createWallet(payerPrivateKey, provider) : null;
+    const { provider, delegateAddress, delegateInterface, profitRecipient } = createEip7702DelegateContext(config);
+    const sourceWallets = sourcePrivateKeys.map((pk) => createWallet(pk, provider));
+    const isNative = isNativeTransferToken(tokenAddress);
+    const { allHopWalletInfos, allHopWallets } = generateHopWalletMatrix(sourceWallets.length, hopCount, provider);
+    const { payerWallet } = resolveListPayerWallet(sourcePrivateKeys, payerPrivateKey, provider);
     const mainWallet = payerWallet ?? sourceWallets[0];
     // ========================================
     // 并行获取数据
     // ========================================
-    const sourceAddresses = sourceWallets.map(w => w.address);
-    const addressesToGetNonces = payerWallet
-        ? [payerWallet.address, ...sourceAddresses]
-        : sourceAddresses;
-    const parallelPromises = [
-        batchGetNonces(addressesToGetNonces, provider),
-        provider.getFeeData(),
-    ];
+    const sourceAddresses = sourceWallets.map((w) => w.address);
+    const addressesToGetNonces = payerWallet ? [payerWallet.address, ...sourceAddresses] : sourceAddresses;
+    const parallelPromises = [batchGetNonces(addressesToGetNonces, provider), provider.getFeeData()];
     if (isNative) {
-        parallelPromises.push(Promise.all(sourceWallets.map(w => provider.getBalance(w.address))));
+        parallelPromises.push(Promise.all(sourceWallets.map((w) => provider.getBalance(w.address))));
     }
     else {
+        if (!tokenAddress)
+            throw new Error('tokenAddress is required for ERC20 sweep');
         const tokenContract = new Contract(tokenAddress, ERC20_ABI, provider);
-        parallelPromises.push(Promise.all(sourceWallets.map(w => tokenContract.balanceOf(w.address))));
+        parallelPromises.push(Promise.all(sourceWallets.map((w) => tokenContract.balanceOf(w.address))));
     }
     const results = await Promise.all(parallelPromises);
     const allNoncesResult = results[0];
     const payerNonce = payerWallet ? allNoncesResult[0] : allNoncesResult[0];
     const nonces = payerWallet ? allNoncesResult.slice(1) : allNoncesResult;
     const feeData = results[1];
-    const balances = results[2].map(b => typeof b === 'bigint' ? b : BigInt(b.toString()));
+    const balances = results[2].map((b) => typeof b === 'bigint' ? b : BigInt(b.toString()));
     // 计算转账金额
     // ✅ 修复：当 percent=100 时，不预留 gas，归集全部余额
     const isFullSweep = percent >= 100;
-    const gasReserve = (reserveGas && isNative && !isFullSweep) ? ethers.parseEther('0.001') : 0n;
+    const gasReserve = reserveGas && isNative && !isFullSweep ? ethers.parseEther('0.001') : 0n;
     const percentBigInt = BigInt(Math.min(100, Math.max(1, percent)));
-    const transferAmounts = balances.map(b => {
+    const transferAmounts = balances.map((b) => {
         if (isFullSweep) {
             // 100% 归集：使用全部余额
             return b;
@@ -397,7 +262,7 @@ export async function sweep(params) {
         if (amount <= 0n)
             continue;
         // ✅ 使用 Payer 时所有源钱包都用自己的余额（value: 0n）
-        const callValue = (payerWallet || i > 0) ? 0n : amount;
+        const callValue = payerWallet || i > 0 ? 0n : amount;
         if (hopCount === 0 || hopWallets.length === 0) {
             // ========================================
             // 直接归集：源钱包 → 目标地址
@@ -426,11 +291,7 @@ export async function sweep(params) {
                     target: sourceWallet.address,
                     allowFailure: false,
                     value: 0n,
-                    callData: delegateInterface.encodeFunctionData('executeTransfer', [
-                        tokenAddress,
-                        targetAddress,
-                        amount,
-                    ]),
+                    callData: delegateInterface.encodeFunctionData('executeTransfer', [tokenAddress, targetAddress, amount]),
                 });
             }
         }
@@ -482,11 +343,7 @@ export async function sweep(params) {
                     target: sourceWallet.address,
                     allowFailure: false,
                     value: 0n,
-                    callData: delegateInterface.encodeFunctionData('executeTransfer', [
-                        tokenAddress,
-                        firstHop.address,
-                        amount,
-                    ]),
+                    callData: delegateInterface.encodeFunctionData('executeTransfer', [tokenAddress, firstHop.address, amount]),
                 });
                 // 中间钱包之间转账
                 for (let j = 0; j < hopWallets.length - 1; j++) {
@@ -505,10 +362,7 @@ export async function sweep(params) {
                     target: lastHop.address,
                     allowFailure: false,
                     value: 0n,
-                    callData: delegateInterface.encodeFunctionData('executeTransferAll', [
-                        tokenAddress,
-                        targetAddress,
-                    ]),
+                    callData: delegateInterface.encodeFunctionData('executeTransferAll', [tokenAddress, targetAddress]),
                 });
             }
         }
@@ -531,13 +385,12 @@ export async function sweep(params) {
             allNonces.push(0);
         }
     }
-    const authorizations = signAuthorizationsWithNonces(allWallets, allNonces, delegateAddress, 0 // mainWallet 是交易发起者
-    );
+    const authorizations = signAuthorizationsWithNonces(allWallets, allNonces, delegateAddress, 0);
     // ========================================
     // 同步构建交易
     // ========================================
     // ✅ Payer 模式下 value 为 0（资金来自源钱包）
-    const totalValue = (isNative && !payerWallet) ? transferAmounts[0] : 0n;
+    const totalValue = isNative && !payerWallet ? transferAmounts[0] : 0n;
     const signedTransaction = buildEIP7702TransactionSync(mainWallet, authorizations, calls, totalValue, payerWallet ? payerNonce : nonces[0], feeData, config);
     // ✅ 返回所有中间钱包（扁平化）
     const flatHopWallets = allHopWalletInfos.flat();
@@ -557,41 +410,9 @@ export async function sweep(params) {
         },
     };
 }
-/**
- * 多对多转账 - sender[i] → receiver[i] 一一对应
- *
- * 支持：原生 OKB / ERC20 代币 + 可选多跳
- *
- * 每对都有独立的多跳链：sender → hop1 → hop2 → ... → receiver
- *
- * @example
- * // 原生 OKB 多对多（直接转账）
- * const result = await pairwiseTransfer({
- *   senderPrivateKeys: ['0xA...', '0xB...', '0xC...'],
- *   receiverAddresses: ['0x111', '0x222', '0x333'],
- *   amount: '0.1',
- * });
- *
- * @example
- * // 原生 OKB 多对多（带多跳）
- * const result = await pairwiseTransfer({
- *   senderPrivateKeys: ['0xA...', '0xB...'],
- *   receiverAddresses: ['0x111', '0x222'],
- *   amounts: ['0.1', '0.2'],
- *   hopCount: 2, // A → hop1 → hop2 → 111, B → hop3 → hop4 → 222
- * });
- *
- * @example
- * // ERC20 多对多（带多跳）
- * const result = await pairwiseTransfer({
- *   senderPrivateKeys: ['0xA...', '0xB...'],
- *   receiverAddresses: ['0x111', '0x222'],
- *   amount: '100',
- *   tokenAddress: '0xTOKEN...',
- *   tokenDecimals: 18,
- *   hopCount: 2,
- * });
- */
+// ========================================
+// 多对多 (Pairwise) - sender[i] → receiver[i]
+// ========================================
 export async function pairwiseTransfer(params) {
     const { senderPrivateKeys, receiverAddresses, payerPrivateKey, amount, amounts, tokenAddress, tokenDecimals = 18, hopCount = 0, userType, config, } = params;
     // 验证参数
@@ -602,46 +423,14 @@ export async function pairwiseTransfer(params) {
     if (pairCount === 0) {
         throw new Error('至少需要一对发送者/接收者');
     }
-    // 解析金额
-    const normalizedAmounts = (() => {
-        if (amounts && amounts.length > 0) {
-            if (amounts.length !== pairCount) {
-                throw new Error(`amounts 长度 (${amounts.length}) 必须与对数 (${pairCount}) 相同`);
-            }
-            return amounts;
-        }
-        if (amount !== undefined && amount.trim().length > 0) {
-            return new Array(pairCount).fill(amount);
-        }
-        throw new Error('必须提供 amount 或 amounts');
-    })();
-    const provider = getCachedProvider(config?.rpcUrl);
-    const delegateAddress = (config?.delegateAddress && config.delegateAddress.trim()) || UNIFIED_DELEGATE_ADDRESS;
-    const delegateInterface = new ethers.Interface(UNIFIED_DELEGATE_ABI);
-    const isNative = !tokenAddress;
-    const profitRecipient = getProfitRecipient(config);
-    // 创建钱包
-    const senderWallets = senderPrivateKeys.map(pk => createWallet(pk, provider));
-    // ✅ 支持单独的 Payer 钱包（用于支付 gas）
-    const hasSeparatePayer = payerPrivateKey && !senderPrivateKeys.includes(payerPrivateKey);
-    const payerWallet = hasSeparatePayer ? createWallet(payerPrivateKey, provider) : null;
+    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 = [];
-    const allHopWallets = [];
-    for (let i = 0; i < pairCount; i++) {
-        if (hopCount > 0) {
-            const hopInfos = generateRandomWallets(hopCount);
-            allHopWalletInfos.push(hopInfos);
-            allHopWallets.push(hopInfos.map(info => createWallet(info.privateKey, provider)));
-        }
-        else {
-            allHopWalletInfos.push([]);
-            allHopWallets.push([]);
-        }
-    }
-    // 解析金额为 Wei
-    const amountsWei = normalizedAmounts.map(amt => isNative ? ethers.parseEther(amt) : ethers.parseUnits(amt, tokenDecimals));
+    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);
@@ -650,10 +439,8 @@ export async function pairwiseTransfer(params) {
     // ========================================
     // 并行获取数据
     // ========================================
-    const senderAddresses = senderWallets.map(w => w.address);
-    const addressesToGetNonces = payerWallet
-        ? [payerWallet.address, ...senderAddresses]
-        : senderAddresses;
+    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(),
@@ -687,7 +474,6 @@ export async function pairwiseTransfer(params) {
                 });
             }
             if (isNative) {
-                // ✅ 使用 transferAmount 转移指定金额（而不是 transferTo 全额）
                 calls.push({
                     target: senderWallet.address,
                     allowFailure: false,
@@ -701,11 +487,7 @@ export async function pairwiseTransfer(params) {
                     target: senderWallet.address,
                     allowFailure: false,
                     value: 0n,
-                    callData: delegateInterface.encodeFunctionData('executeTransfer', [
-                        tokenAddress,
-                        receiver,
-                        amtWei,
-                    ]),
+                    callData: delegateInterface.encodeFunctionData('executeTransfer', [tokenAddress, receiver, amtWei]),
                 });
             }
         }
@@ -726,14 +508,12 @@ export async function pairwiseTransfer(params) {
             }
             if (isNative) {
                 // 原生 OKB 多跳
-                // ✅ sender → 第一个中间钱包（使用 transferAmount 转移指定金额）
                 calls.push({
                     target: senderWallet.address,
                     allowFailure: false,
                     value: shouldPassValue ? amtWei : 0n,
                     callData: delegateInterface.encodeFunctionData('transferAmount', [firstHop.address, amtWei]),
                 });
-                // 中间钱包之间转账（使用 transferTo，因为中间钱包只有这笔钱）
                 for (let j = 0; j < hopWallets.length - 1; j++) {
                     calls.push({
                         target: hopWallets[j].address,
@@ -742,7 +522,6 @@ export async function pairwiseTransfer(params) {
                         callData: delegateInterface.encodeFunctionData('transferTo', [hopWallets[j + 1].address]),
                     });
                 }
-                // 最后一个中间钱包 → receiver（使用 transferTo 转移全部）
                 calls.push({
                     target: lastHop.address,
                     allowFailure: false,
@@ -757,11 +536,7 @@ export async function pairwiseTransfer(params) {
                     target: senderWallet.address,
                     allowFailure: false,
                     value: 0n,
-                    callData: delegateInterface.encodeFunctionData('executeTransfer', [
-                        tokenAddress,
-                        firstHop.address,
-                        amtWei,
-                    ]),
+                    callData: delegateInterface.encodeFunctionData('executeTransfer', [tokenAddress, firstHop.address, amtWei]),
                 });
                 // 中间钱包之间转账
                 for (let j = 0; j < hopWallets.length - 1; j++) {
@@ -780,10 +555,7 @@ export async function pairwiseTransfer(params) {
                     target: lastHop.address,
                     allowFailure: false,
                     value: 0n,
-                    callData: delegateInterface.encodeFunctionData('executeTransferAll', [
-                        tokenAddress,
-                        receiver,
-                    ]),
+                    callData: delegateInterface.encodeFunctionData('executeTransferAll', [tokenAddress, receiver]),
                 });
             }
         }
@@ -792,25 +564,20 @@ export async function pairwiseTransfer(params) {
     // 同步签署授权（已有 nonce）
     // ========================================
     // ✅ 如果有单独的 Payer，需要为 Payer 也生成授权
-    const allWallets = payerWallet
-        ? [payerWallet, ...senderWallets]
-        : [...senderWallets];
-    const allNonces = payerWallet
-        ? [payerNonce, ...nonces]
-        : [...nonces];
+    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 // mainWallet（可能是 Payer 或第一个发送者钱包）是交易发起者
-    );
+    const authorizations = signAuthorizationsWithNonces(allWallets, allNonces, delegateAddress, 0);
     // ========================================
     // 同步构建交易
     // ========================================
     // ✅ Payer 模式下 value 为 0（资金来自发送者钱包）
-    const totalValue = (isNative && !payerWallet) ? totalAmount : 0n;
+    const totalValue = isNative && !payerWallet ? totalAmount : 0n;
     const signedTransaction = buildEIP7702TransactionSync(mainWallet, authorizations, calls, totalValue, payerWallet ? payerNonce : nonces[0], feeData, config);
     return {
         signedTransaction,

package/dist/chains/xlayer/eip7702/transfer-context-helpers.d.ts

@@ -0,0 +1,26 @@
+import { ethers, Wallet, type JsonRpcProvider } from 'ethers';
+import type { GeneratedWallet, EIP7702Config } from './types.js';
+export declare function createEip7702DelegateContext(config?: EIP7702Config): {
+    provider: ethers.JsonRpcProvider;
+    delegateAddress: string;
+    delegateInterface: ethers.Interface;
+    profitRecipient: string;
+};
+export declare function isNativeTransferToken(tokenAddress?: string): boolean;
+export declare function generateHopWalletMatrix(rowCount: number, hopCount: number, provider: JsonRpcProvider): {
+    allHopWalletInfos: GeneratedWallet[][];
+    allHopWallets: Wallet[][];
+};
+export declare function resolveDispersePayerWallets(mainPrivateKey: string, payerPrivateKey: string | undefined, provider: JsonRpcProvider): {
+    mainWallet: ethers.Wallet;
+    payerWallet: ethers.Wallet | null;
+    txSender: ethers.Wallet;
+    hasSeparatePayer: boolean;
+};
+export declare function resolveListPayerWallet(ownerPrivateKeys: string[], payerPrivateKey: string | undefined, provider: JsonRpcProvider, fallbackToFirst?: boolean): {
+    payerWallet: ethers.Wallet | null;
+    hasSeparatePayer: boolean;
+    mainWallet: ethers.Wallet | null;
+};
+export declare function parseTransferAmountsWei(amounts: string[], isNative: boolean, tokenDecimals: number): bigint[];
+export declare function normalizePairwiseAmounts(pairCount: number, amount: string | undefined, amounts: string[] | undefined): string[];

package/dist/chains/xlayer/eip7702/transfer-context-helpers.js

@@ -0,0 +1,57 @@
+import { ethers } from 'ethers';
+import { getCachedProvider, createWallet, generateRandomWallets, getProfitRecipient } from './utils.js';
+import { UNIFIED_DELEGATE_ADDRESS, UNIFIED_DELEGATE_ABI } from './constants.js';
+export function createEip7702DelegateContext(config) {
+    const provider = getCachedProvider(config?.rpcUrl);
+    const delegateAddress = (config?.delegateAddress && config.delegateAddress.trim()) || UNIFIED_DELEGATE_ADDRESS;
+    const delegateInterface = new ethers.Interface(UNIFIED_DELEGATE_ABI);
+    const profitRecipient = getProfitRecipient(config);
+    return { provider, delegateAddress, delegateInterface, profitRecipient };
+}
+export function isNativeTransferToken(tokenAddress) {
+    return !tokenAddress;
+}
+export function generateHopWalletMatrix(rowCount, hopCount, provider) {
+    const allHopWalletInfos = [];
+    const allHopWallets = [];
+    for (let i = 0; i < rowCount; i++) {
+        if (hopCount > 0) {
+            const hopInfos = generateRandomWallets(hopCount);
+            allHopWalletInfos.push(hopInfos);
+            allHopWallets.push(hopInfos.map((info) => createWallet(info.privateKey, provider)));
+        }
+        else {
+            allHopWalletInfos.push([]);
+            allHopWallets.push([]);
+        }
+    }
+    return { allHopWalletInfos, allHopWallets };
+}
+export function resolveDispersePayerWallets(mainPrivateKey, payerPrivateKey, provider) {
+    const mainWallet = createWallet(mainPrivateKey, provider);
+    const hasSeparatePayer = Boolean(payerPrivateKey && payerPrivateKey !== mainPrivateKey);
+    const payerWallet = hasSeparatePayer ? createWallet(payerPrivateKey, provider) : null;
+    const txSender = payerWallet ?? mainWallet;
+    return { mainWallet, payerWallet, txSender, hasSeparatePayer };
+}
+export function resolveListPayerWallet(ownerPrivateKeys, payerPrivateKey, provider, fallbackToFirst = true) {
+    const hasSeparatePayer = Boolean(payerPrivateKey && !ownerPrivateKeys.includes(payerPrivateKey));
+    const payerWallet = hasSeparatePayer ? createWallet(payerPrivateKey, provider) : null;
+    const mainWallet = payerWallet ?? (fallbackToFirst ? createWallet(ownerPrivateKeys[0], provider) : null);
+    return { payerWallet, hasSeparatePayer, mainWallet };
+}
+export function parseTransferAmountsWei(amounts, isNative, tokenDecimals) {
+    return amounts.map((amt) => (isNative ? ethers.parseEther(amt) : ethers.parseUnits(amt, tokenDecimals)));
+}
+export function normalizePairwiseAmounts(pairCount, amount, amounts) {
+    if (amounts && amounts.length > 0) {
+        if (amounts.length !== pairCount) {
+            throw new Error(`amounts 长度 (${amounts.length}) 必须与对数 (${pairCount}) 相同`);
+        }
+        return amounts;
+    }
+    if (amount !== undefined && amount.trim().length > 0) {
+        return new Array(pairCount).fill(amount);
+    }
+    throw new Error('必须提供 amount 或 amounts');
+}