four-flap-meme-sdk 1.7.8 → 1.7.10

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

@@ -1,12 +1,20 @@
 /**
  * X-Layer Bundle 批量授权
  *
- * 使用 Bundle 实现多钱包批量授权
+ * ✅ 完整授权支持：
+ * - 代币授权给内盘 Flap Portal
+ * - 代币授权给外盘 V2/V3 Router
+ * - WOKB 授权给路由（用于卖出/交换）
+ * - 稳定币授权（USDT、USDC、USDT0）
  *
  * 优化：第一个钱包作为 Sponsor，支付 gas
  * 其他钱包不需要 gas
  */
 import type { BatchOperationResult } from './types.js';
+/** 授权目标类型 */
+export type ApprovalTarget = 'all' | 'flap' | 'v2' | 'v3' | 'v3-02';
+/** 授权模式 */
+export type ApprovalMode = 'token' | 'base' | 'full';
 /**
  * 批量授权参数
  *
@@ -16,7 +24,7 @@ import type { BatchOperationResult } from './types.js';
 export interface BatchApproveParams {
     /** RPC URL */
     rpcUrl: string;
-    /** 代币地址 */
+    /** 代币地址（要授权的代币） */
     tokenAddress: string;
     /** 要授权的钱包列表（第一个钱包作为 Sponsor，支付 gas） */
     wallets: Array<{
@@ -24,6 +32,31 @@ export interface BatchApproveParams {
     }>;
     /** Gas Price (可选) */
     gasPrice?: bigint;
+    /** 授权目标（默认 'all'：授权给所有路由） */
+    target?: ApprovalTarget;
+    /** 授权模式（默认 'token'：只授权代币） */
+    mode?: ApprovalMode;
+    /** 是否包含 WOKB 授权（默认 false） */
+    includeWokb?: boolean;
+    /** 是否包含稳定币授权（默认 false） */
+    includeStablecoins?: boolean;
+}
+/**
+ * 完整授权参数（代币 + WOKB + 稳定币）
+ */
+export interface FullApproveParams {
+    /** RPC URL */
+    rpcUrl: string;
+    /** 代币地址（要授权的代币） */
+    tokenAddress: string;
+    /** 要授权的钱包列表（第一个钱包作为 Sponsor，支付 gas） */
+    wallets: Array<{
+        privateKey: string;
+    }>;
+    /** Gas Price (可选) */
+    gasPrice?: bigint;
+    /** 授权目标（默认 'all'：授权给所有路由） */
+    target?: ApprovalTarget;
 }
 /**
  * 单个钱包授权参数
@@ -39,14 +72,54 @@ export interface SingleApproveParams {
     walletPrivateKey: string;
     /** Gas Price (可选) */
     gasPrice?: bigint;
+    /** 授权目标（默认 'all'） */
+    target?: ApprovalTarget;
+    /** 授权模式（默认 'token'） */
+    mode?: ApprovalMode;
+    /** 是否包含 WOKB 授权 */
+    includeWokb?: boolean;
+    /** 是否包含稳定币授权 */
+    includeStablecoins?: boolean;
 }
 /**
  * Bundle 批量授权
  *
  * 将多个钱包对所有 Spender 的授权打包成一笔交易
  * 第一个钱包作为 Sponsor，支付 gas
+ *
+ * @example
+ * ```typescript
+ * // 只授权代币给所有路由
+ * await bundleBatchApprove({
+ *   rpcUrl,
+ *   tokenAddress,
+ *   wallets: [{ privateKey: pk1 }, { privateKey: pk2 }],
+ * });
+ *
+ * // 授权代币 + WOKB
+ * await bundleBatchApprove({
+ *   rpcUrl,
+ *   tokenAddress,
+ *   wallets: [{ privateKey: pk1 }],
+ *   includeWokb: true,
+ * });
+ *
+ * // 完整授权（代币 + WOKB + 稳定币）
+ * await bundleBatchApprove({
+ *   rpcUrl,
+ *   tokenAddress,
+ *   wallets: [{ privateKey: pk1 }],
+ *   mode: 'full',
+ * });
+ * ```
  */
 export declare function bundleBatchApprove(params: BatchApproveParams): Promise<BatchOperationResult>;
+/**
+ * Bundle 完整授权（代币 + WOKB + 稳定币）
+ *
+ * 一次性完成所有授权，跟 BSC 链一样
+ */
+export declare function bundleFullApprove(params: FullApproveParams): Promise<BatchOperationResult>;
 /**
  * Bundle 单钱包授权
  *
@@ -57,4 +130,12 @@ export declare function bundleSingleApprove(params: SingleApproveParams): Promis
 /**
  * 获取需要授权的 Spender 列表
  */
-export declare function getSpendersToApprove(): readonly string[];
+export declare function getSpendersToApprove(target?: ApprovalTarget): readonly string[];
+/**
+ * 获取基础代币列表（WOKB + 稳定币）
+ */
+export declare function getBaseTokensToApprove(): readonly string[];
+/**
+ * 获取稳定币列表
+ */
+export declare function getStablecoins(): readonly string[];

package/dist/eip7702/xlayer/approve.js

@@ -1,33 +1,114 @@
 /**
  * X-Layer Bundle 批量授权
  *
- * 使用 Bundle 实现多钱包批量授权
+ * ✅ 完整授权支持：
+ * - 代币授权给内盘 Flap Portal
+ * - 代币授权给外盘 V2/V3 Router
+ * - WOKB 授权给路由（用于卖出/交换）
+ * - 稳定币授权（USDT、USDC、USDT0）
  *
  * 优化：第一个钱包作为 Sponsor，支付 gas
  * 其他钱包不需要 gas
  */
-import { SPENDERS_TO_APPROVE, MAX_UINT256 } from './constants.js';
+import { SPENDERS_TO_APPROVE, BASE_TOKENS_TO_APPROVE, MAX_UINT256, WOKB, USDT, USDC, USDT0, FLAP_PORTAL, POTATOSWAP_V2_ROUTER, POTATOSWAP_V3_ROUTER, POTATOSWAP_SWAP_ROUTER02, } from './constants.js';
 import { XLayerBundle } from './bundle.js';
 import { buildApprove } from './builders.js';
+// ==================== 辅助函数 ====================
+/**
+ * 获取目标 Spender 列表
+ */
+function getSpenders(target = 'all') {
+    switch (target) {
+        case 'flap':
+            return [FLAP_PORTAL];
+        case 'v2':
+            return [POTATOSWAP_V2_ROUTER];
+        case 'v3':
+            return [POTATOSWAP_V3_ROUTER];
+        case 'v3-02':
+            return [POTATOSWAP_SWAP_ROUTER02];
+        case 'all':
+        default:
+            return SPENDERS_TO_APPROVE;
+    }
+}
+/**
+ * 构建授权 calls
+ */
+function buildApproveCalls(tokenAddress, target = 'all', mode = 'token', includeWokb = false, includeStablecoins = false) {
+    const spenders = getSpenders(target);
+    const calls = [];
+    // 1. 代币授权给路由
+    if (mode === 'token' || mode === 'full') {
+        for (const spender of spenders) {
+            calls.push(buildApprove(tokenAddress, spender, MAX_UINT256));
+        }
+    }
+    // 2. WOKB 授权给路由（用于 V3 卖出等）
+    if (includeWokb || mode === 'base' || mode === 'full') {
+        for (const spender of spenders) {
+            calls.push(buildApprove(WOKB, spender, MAX_UINT256));
+        }
+    }
+    // 3. 稳定币授权给路由
+    if (includeStablecoins || mode === 'full') {
+        const stablecoins = [USDT, USDC, USDT0];
+        for (const stablecoin of stablecoins) {
+            for (const spender of spenders) {
+                calls.push(buildApprove(stablecoin, spender, MAX_UINT256));
+            }
+        }
+    }
+    return calls;
+}
 // ==================== 批量授权 ====================
 /**
  * Bundle 批量授权
  *
  * 将多个钱包对所有 Spender 的授权打包成一笔交易
  * 第一个钱包作为 Sponsor，支付 gas
+ *
+ * @example
+ * ```typescript
+ * // 只授权代币给所有路由
+ * await bundleBatchApprove({
+ *   rpcUrl,
+ *   tokenAddress,
+ *   wallets: [{ privateKey: pk1 }, { privateKey: pk2 }],
+ * });
+ *
+ * // 授权代币 + WOKB
+ * await bundleBatchApprove({
+ *   rpcUrl,
+ *   tokenAddress,
+ *   wallets: [{ privateKey: pk1 }],
+ *   includeWokb: true,
+ * });
+ *
+ * // 完整授权（代币 + WOKB + 稳定币）
+ * await bundleBatchApprove({
+ *   rpcUrl,
+ *   tokenAddress,
+ *   wallets: [{ privateKey: pk1 }],
+ *   mode: 'full',
+ * });
+ * ```
  */
 export async function bundleBatchApprove(params) {
-    const { rpcUrl, tokenAddress, wallets, gasPrice } = params;
+    const { rpcUrl, tokenAddress, wallets, gasPrice, target = 'all', mode = 'token', includeWokb = false, includeStablecoins = false, } = params;
     if (wallets.length === 0) {
         return { success: false, successCount: 0, totalCount: 0, error: '没有钱包' };
     }
     const bundle = new XLayerBundle({ rpcUrl, gasPrice });
-    // 构建参与者：每个钱包授权给所有 Spender
+    const calls = buildApproveCalls(tokenAddress, target, mode, includeWokb, includeStablecoins);
+    // 构建参与者：每个钱包执行相同的授权 calls
     const participants = wallets.map(w => ({
         wallet: w.privateKey,
-        calls: SPENDERS_TO_APPROVE.map(spender => buildApprove(tokenAddress, spender, MAX_UINT256)),
+        calls,
     }));
-    console.log(`[Bundle授权] 执行批量授权: ${wallets.length} 个钱包, ${SPENDERS_TO_APPROVE.length} 个 Spender`);
+    const spenders = getSpenders(target);
+    console.log(`[Bundle授权] 执行批量授权: ${wallets.length} 个钱包, ${spenders.length} 个 Spender, ${calls.length / wallets.length} 个授权/钱包`);
+    console.log(`[Bundle授权] 模式: ${mode}, 目标: ${target}, WOKB: ${includeWokb}, 稳定币: ${includeStablecoins}`);
     console.log(`[Bundle授权] 第一个钱包作为 Sponsor，支付 gas`);
     const result = await bundle.execute(participants);
     return {
@@ -36,6 +117,19 @@ export async function bundleBatchApprove(params) {
         totalCount: wallets.length,
     };
 }
+/**
+ * Bundle 完整授权（代币 + WOKB + 稳定币）
+ *
+ * 一次性完成所有授权，跟 BSC 链一样
+ */
+export async function bundleFullApprove(params) {
+    return bundleBatchApprove({
+        ...params,
+        mode: 'full',
+        includeWokb: true,
+        includeStablecoins: true,
+    });
+}
 /**
  * Bundle 单钱包授权
  *
@@ -48,11 +142,27 @@ export async function bundleSingleApprove(params) {
         tokenAddress: params.tokenAddress,
         wallets: [{ privateKey: params.walletPrivateKey }],
         gasPrice: params.gasPrice,
+        target: params.target,
+        mode: params.mode,
+        includeWokb: params.includeWokb,
+        includeStablecoins: params.includeStablecoins,
     });
 }
 /**
  * 获取需要授权的 Spender 列表
  */
-export function getSpendersToApprove() {
-    return SPENDERS_TO_APPROVE;
+export function getSpendersToApprove(target = 'all') {
+    return getSpenders(target);
+}
+/**
+ * 获取基础代币列表（WOKB + 稳定币）
+ */
+export function getBaseTokensToApprove() {
+    return BASE_TOKENS_TO_APPROVE;
+}
+/**
+ * 获取稳定币列表
+ */
+export function getStablecoins() {
+    return [USDT, USDC, USDT0];
 }

package/dist/eip7702/xlayer/bundle.js

@@ -17,8 +17,7 @@ function toRlpHex(value) {
     if (value === 0 || value === 0n) {
         return '0x';
     }
-    const hex = ethers.toBeHex(value);
-    return hex.replace(/^0x0+/, '0x') || '0x';
+    return ethers.toBeHex(value);
 }
 // ==================== 工具函数 ====================
 /** 计算授权消息哈希 */
@@ -35,11 +34,12 @@ function hashAuthorization(chainId, executorAddress, nonce) {
 async function signAuthorization(wallet, nonce) {
     const messageHash = hashAuthorization(XLAYER_CHAIN_ID, EXECUTOR_ADDRESS, nonce);
     const signature = wallet.signingKey.sign(messageHash);
+    // 注意：EIP-7702 授权签名使用 yParity (0 或 1)，不是 v (27 或 28)
     return {
         chainId: XLAYER_CHAIN_ID,
         address: EXECUTOR_ADDRESS,
         nonce,
-        v: signature.v,
+        v: signature.yParity,
         r: signature.r,
         s: signature.s,
     };
@@ -208,17 +208,17 @@ export class XLayerBundle {
         ]);
         const txHash = ethers.keccak256(unsigned);
         const signature = sponsor.signingKey.sign(txHash);
-        // 添加签名
+        // 添加签名（注意：Type 4 交易使用 yParity (0 或 1)，不是 v (27 或 28)）
         const signedFields = [
             ...fields,
-            toRlpHex(signature.v),
+            toRlpHex(signature.yParity),
             signature.r,
             signature.s,
         ];
-        return ethers.concat([
+        return ethers.hexlify(ethers.concat([
             new Uint8Array([0x04]),
             ethers.encodeRlp(signedFields),
-        ]);
+        ]));
     }
 }
 // ==================== 便捷函数 ====================

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

@@ -1,26 +1,86 @@
 /**
  * X-Layer Bundle 授权检查
  *
- * 检查钱包是否已授权所有 Spender
+ * ✅ 完整功能：
+ * - 批量检查授权状态（使用 Multicall3 优化）
+ * - 检查所有路由（Flap + V2 + V3）
+ * - 检查基础代币（WOKB + 稳定币）
+ * - 返回详细授权信息
  */
+/** 授权目标类型 */
+export type ApprovalTarget = 'all' | 'flap' | 'v2' | 'v3' | 'v3-02';
+/** 授权状态详情 */
+export interface ApprovalStatusDetail {
+    /** 钱包地址 */
+    walletAddress: string;
+    /** 是否所有 Spender 都已授权 */
+    isFullyApproved: boolean;
+    /** 每个 Spender 的授权详情 */
+    spenderDetails: Array<{
+        spender: string;
+        spenderName: string;
+        isApproved: boolean;
+        currentAllowance: bigint;
+    }>;
+}
+/** 批量授权检查结果 */
+export interface BatchApprovalCheckResult {
+    /** 代币地址 */
+    tokenAddress: string;
+    /** 钱包总数 */
+    totalWallets: number;
+    /** 已完全授权的钱包数 */
+    fullyApprovedCount: number;
+    /** 需要授权的钱包数 */
+    needApprovalCount: number;
+    /** 详细信息 */
+    details: ApprovalStatusDetail[];
+}
+/** 完整授权检查结果（包含基础代币） */
+export interface FullApprovalCheckResult {
+    /** 代币授权状态 */
+    token: BatchApprovalCheckResult;
+    /** WOKB 授权状态 */
+    wokb: BatchApprovalCheckResult;
+    /** 稳定币授权状态 */
+    stablecoins: {
+        usdt: BatchApprovalCheckResult;
+        usdc: BatchApprovalCheckResult;
+        usdt0: BatchApprovalCheckResult;
+    };
+}
 /**
  * 检查钱包是否已授权（检查所有 Spender）
  *
  * @param rpcUrl RPC URL
  * @param tokenAddress 代币地址
  * @param walletAddress 钱包地址
+ * @param target 授权目标（默认 'all'）
  * @returns 是否所有 Spender 都已授权
  */
-export declare function checkApprovalStatus(rpcUrl: string, tokenAddress: string, walletAddress: string): Promise<boolean>;
+export declare function checkApprovalStatus(rpcUrl: string, tokenAddress: string, walletAddress: string, target?: ApprovalTarget): Promise<boolean>;
 /**
- * 批量检查授权状态
+ * 批量检查授权状态（使用 Multicall3 优化）
+ *
+ * ✅ 跟 BSC 链一样，返回详细的授权信息
+ *
+ * @param rpcUrl RPC URL
+ * @param tokenAddress 代币地址
+ * @param walletAddresses 钱包地址列表
+ * @param target 授权目标（默认 'all'）
+ * @returns 批量授权检查结果
+ */
+export declare function checkApprovalStatusBatch(rpcUrl: string, tokenAddress: string, walletAddresses: string[], target?: ApprovalTarget): Promise<BatchApprovalCheckResult>;
+/**
+ * 批量检查授权状态（简化版，返回 Map）
  *
  * @param rpcUrl RPC URL
  * @param tokenAddress 代币地址
  * @param walletAddresses 钱包地址列表
+ * @param target 授权目标
  * @returns 钱包地址 -> 是否已授权
  */
-export declare function checkApprovalStatusBatch(rpcUrl: string, tokenAddress: string, walletAddresses: string[]): Promise<Map<string, boolean>>;
+export declare function checkApprovalStatusBatchSimple(rpcUrl: string, tokenAddress: string, walletAddresses: string[], target?: ApprovalTarget): Promise<Map<string, boolean>>;
 /**
  * 检查单个 Spender 的授权状态
  *
@@ -37,15 +97,54 @@ export declare function checkSingleApprovalStatus(rpcUrl: string, tokenAddress:
  * @param rpcUrl RPC URL
  * @param tokenAddress 代币地址
  * @param walletAddress 钱包地址
+ * @param target 授权目标
  * @returns Spender 地址 -> 授权额度
  */
-export declare function getApprovalDetails(rpcUrl: string, tokenAddress: string, walletAddress: string): Promise<Map<string, bigint>>;
+export declare function getApprovalDetails(rpcUrl: string, tokenAddress: string, walletAddress: string, target?: ApprovalTarget): Promise<Map<string, bigint>>;
 /**
  * 获取需要授权的 Spender 列表（未授权的）
  *
  * @param rpcUrl RPC URL
  * @param tokenAddress 代币地址
  * @param walletAddress 钱包地址
+ * @param target 授权目标
  * @returns 未授权的 Spender 地址列表
  */
-export declare function getUnapprovedSpenders(rpcUrl: string, tokenAddress: string, walletAddress: string): Promise<string[]>;
+export declare function getUnapprovedSpenders(rpcUrl: string, tokenAddress: string, walletAddress: string, target?: ApprovalTarget): Promise<string[]>;
+/**
+ * 获取需要授权的钱包列表
+ *
+ * @param rpcUrl RPC URL
+ * @param tokenAddress 代币地址
+ * @param walletAddresses 钱包地址列表
+ * @param target 授权目标
+ * @returns 需要授权的钱包地址列表
+ */
+export declare function getWalletsNeedApproval(rpcUrl: string, tokenAddress: string, walletAddresses: string[], target?: ApprovalTarget): Promise<string[]>;
+/**
+ * 完整授权检查（代币 + WOKB + 稳定币）
+ *
+ * ✅ 跟 BSC 链一样，一次性检查所有授权状态
+ *
+ * @param rpcUrl RPC URL
+ * @param tokenAddress 代币地址
+ * @param walletAddresses 钱包地址列表
+ * @param target 授权目标
+ * @returns 完整授权检查结果
+ */
+export declare function checkFullApprovalStatus(rpcUrl: string, tokenAddress: string, walletAddresses: string[], target?: ApprovalTarget): Promise<FullApprovalCheckResult>;
+/**
+ * 获取授权汇总信息
+ *
+ * @param rpcUrl RPC URL
+ * @param tokenAddress 代币地址
+ * @param walletAddresses 钱包地址列表
+ * @returns 授权汇总
+ */
+export declare function getApprovalSummary(rpcUrl: string, tokenAddress: string, walletAddresses: string[]): Promise<{
+    totalWallets: number;
+    tokenApproved: number;
+    wokbApproved: number;
+    allApproved: number;
+    needApproval: number;
+}>;

package/dist/eip7702/xlayer/check.js

@@ -1,52 +1,211 @@
 /**
  * X-Layer Bundle 授权检查
  *
- * 检查钱包是否已授权所有 Spender
+ * ✅ 完整功能：
+ * - 批量检查授权状态（使用 Multicall3 优化）
+ * - 检查所有路由（Flap + V2 + V3）
+ * - 检查基础代币（WOKB + 稳定币）
+ * - 返回详细授权信息
  */
 import { JsonRpcProvider, Interface, Contract } from 'ethers';
-import { SPENDERS_TO_APPROVE, ERC20_ABI } from './constants.js';
-// ==================== 授权检查 ====================
+import { SPENDERS_TO_APPROVE, ERC20_ABI, WOKB, USDT, USDC, USDT0, FLAP_PORTAL, POTATOSWAP_V2_ROUTER, POTATOSWAP_V3_ROUTER, POTATOSWAP_SWAP_ROUTER02, } from './constants.js';
 /** 最小授权额度（2^128） */
 const MIN_ALLOWANCE = BigInt('0x100000000000000000000000000000000');
+/** Multicall3 地址（通用） */
+const MULTICALL3_ADDRESS = '0xca11bde05977b3631167028862be2a173976ca11';
+/** Multicall3 ABI */
+const MULTICALL3_ABI = [
+    'function aggregate3(tuple(address target, bool allowFailure, bytes callData)[] calls) public payable returns (tuple(bool success, bytes returnData)[])',
+];
+// ==================== 辅助函数 ====================
+/**
+ * 获取 Spender 名称
+ */
+function getSpenderName(spender) {
+    const names = {
+        [FLAP_PORTAL.toLowerCase()]: 'Flap Portal (内盘)',
+        [POTATOSWAP_V2_ROUTER.toLowerCase()]: 'PotatoSwap V2 Router',
+        [POTATOSWAP_V3_ROUTER.toLowerCase()]: 'PotatoSwap V3 Router',
+        [POTATOSWAP_SWAP_ROUTER02.toLowerCase()]: 'PotatoSwap SwapRouter02',
+    };
+    return names[spender.toLowerCase()] || spender;
+}
+/**
+ * 获取目标 Spender 列表
+ */
+function getSpenders(target = 'all') {
+    switch (target) {
+        case 'flap':
+            return [FLAP_PORTAL];
+        case 'v2':
+            return [POTATOSWAP_V2_ROUTER];
+        case 'v3':
+            return [POTATOSWAP_V3_ROUTER];
+        case 'v3-02':
+            return [POTATOSWAP_SWAP_ROUTER02];
+        case 'all':
+        default:
+            return SPENDERS_TO_APPROVE;
+    }
+}
+// ==================== Multicall3 批量查询 ====================
+/**
+ * 使用 Multicall3 批量查询授权额度
+ *
+ * @param provider Provider
+ * @param tokenAddress 代币地址
+ * @param walletAddresses 钱包地址列表
+ * @param spenderAddresses Spender 地址列表
+ * @returns 二维数组 [wallet][spender] = allowance
+ */
+async function batchCheckAllowancesMulticall(provider, tokenAddress, walletAddresses, spenderAddresses) {
+    if (walletAddresses.length === 0 || spenderAddresses.length === 0) {
+        return [];
+    }
+    const erc20Interface = new Interface(ERC20_ABI);
+    const multicall = new Contract(MULTICALL3_ADDRESS, MULTICALL3_ABI, provider);
+    // 构建 Multicall 调用
+    const calls = [];
+    for (const wallet of walletAddresses) {
+        for (const spender of spenderAddresses) {
+            calls.push({
+                target: tokenAddress,
+                allowFailure: true,
+                callData: erc20Interface.encodeFunctionData('allowance', [wallet, spender]),
+            });
+        }
+    }
+    try {
+        const results = await multicall.aggregate3.staticCall(calls);
+        // 解析结果
+        const allowances = [];
+        let idx = 0;
+        for (let w = 0; w < walletAddresses.length; w++) {
+            const walletAllowances = [];
+            for (let s = 0; s < spenderAddresses.length; s++) {
+                const result = results[idx++];
+                if (result.success) {
+                    const decoded = erc20Interface.decodeFunctionResult('allowance', result.returnData);
+                    walletAllowances.push(BigInt(decoded[0]));
+                }
+                else {
+                    walletAllowances.push(0n);
+                }
+            }
+            allowances.push(walletAllowances);
+        }
+        return allowances;
+    }
+    catch (error) {
+        // Multicall 失败时，回退到逐个查询
+        console.warn('[Multicall] 失败，回退到逐个查询:', error);
+        return batchCheckAllowancesFallback(provider, tokenAddress, walletAddresses, spenderAddresses);
+    }
+}
+/**
+ * 逐个查询授权额度（Multicall 失败时的备用方案）
+ */
+async function batchCheckAllowancesFallback(provider, tokenAddress, walletAddresses, spenderAddresses) {
+    const erc20Interface = new Interface(ERC20_ABI);
+    const contract = new Contract(tokenAddress, erc20Interface, provider);
+    const allowances = [];
+    for (const wallet of walletAddresses) {
+        const walletAllowances = [];
+        for (const spender of spenderAddresses) {
+            try {
+                const allowance = await contract.allowance(wallet, spender);
+                walletAllowances.push(BigInt(allowance));
+            }
+            catch {
+                walletAllowances.push(0n);
+            }
+        }
+        allowances.push(walletAllowances);
+    }
+    return allowances;
+}
+// ==================== 授权检查函数 ====================
 /**
  * 检查钱包是否已授权（检查所有 Spender）
  *
  * @param rpcUrl RPC URL
  * @param tokenAddress 代币地址
  * @param walletAddress 钱包地址
+ * @param target 授权目标（默认 'all'）
  * @returns 是否所有 Spender 都已授权
  */
-export async function checkApprovalStatus(rpcUrl, tokenAddress, walletAddress) {
+export async function checkApprovalStatus(rpcUrl, tokenAddress, walletAddress, target = 'all') {
     const provider = new JsonRpcProvider(rpcUrl);
-    const erc20Interface = new Interface(ERC20_ABI);
-    const contract = new Contract(tokenAddress, erc20Interface, provider);
-    try {
-        const results = await Promise.all(SPENDERS_TO_APPROVE.map(async (spender) => {
-            const allowance = await contract.allowance(walletAddress, spender);
-            return BigInt(allowance) >= MIN_ALLOWANCE;
-        }));
-        // 所有 Spender 都必须已授权
-        return results.every(Boolean);
-    }
-    catch {
+    const spenders = getSpenders(target);
+    const allowances = await batchCheckAllowancesMulticall(provider, tokenAddress, [walletAddress], spenders);
+    if (allowances.length === 0 || allowances[0].length === 0) {
         return false;
     }
+    return allowances[0].every(a => a >= MIN_ALLOWANCE);
+}
+/**
+ * 批量检查授权状态（使用 Multicall3 优化）
+ *
+ * ✅ 跟 BSC 链一样，返回详细的授权信息
+ *
+ * @param rpcUrl RPC URL
+ * @param tokenAddress 代币地址
+ * @param walletAddresses 钱包地址列表
+ * @param target 授权目标（默认 'all'）
+ * @returns 批量授权检查结果
+ */
+export async function checkApprovalStatusBatch(rpcUrl, tokenAddress, walletAddresses, target = 'all') {
+    if (walletAddresses.length === 0) {
+        return {
+            tokenAddress,
+            totalWallets: 0,
+            fullyApprovedCount: 0,
+            needApprovalCount: 0,
+            details: [],
+        };
+    }
+    const provider = new JsonRpcProvider(rpcUrl);
+    const spenders = getSpenders(target);
+    const allowances = await batchCheckAllowancesMulticall(provider, tokenAddress, walletAddresses, spenders);
+    const details = walletAddresses.map((wallet, wIdx) => {
+        const walletAllowances = allowances[wIdx] || [];
+        const spenderDetails = spenders.map((spender, sIdx) => ({
+            spender,
+            spenderName: getSpenderName(spender),
+            isApproved: walletAllowances[sIdx] >= MIN_ALLOWANCE,
+            currentAllowance: walletAllowances[sIdx] || 0n,
+        }));
+        return {
+            walletAddress: wallet,
+            isFullyApproved: spenderDetails.every(d => d.isApproved),
+            spenderDetails,
+        };
+    });
+    const fullyApprovedCount = details.filter(d => d.isFullyApproved).length;
+    return {
+        tokenAddress,
+        totalWallets: walletAddresses.length,
+        fullyApprovedCount,
+        needApprovalCount: walletAddresses.length - fullyApprovedCount,
+        details,
+    };
 }
 /**
- * 批量检查授权状态
+ * 批量检查授权状态（简化版，返回 Map）
  *
  * @param rpcUrl RPC URL
  * @param tokenAddress 代币地址
  * @param walletAddresses 钱包地址列表
+ * @param target 授权目标
  * @returns 钱包地址 -> 是否已授权
  */
-export async function checkApprovalStatusBatch(rpcUrl, tokenAddress, walletAddresses) {
-    const results = new Map();
-    await Promise.all(walletAddresses.map(async (address) => {
-        const isApproved = await checkApprovalStatus(rpcUrl, tokenAddress, address);
-        results.set(address.toLowerCase(), isApproved);
-    }));
-    return results;
+export async function checkApprovalStatusBatchSimple(rpcUrl, tokenAddress, walletAddresses, target = 'all') {
+    const result = await checkApprovalStatusBatch(rpcUrl, tokenAddress, walletAddresses, target);
+    const map = new Map();
+    for (const detail of result.details) {
+        map.set(detail.walletAddress.toLowerCase(), detail.isFullyApproved);
+    }
+    return map;
 }
 /**
  * 检查单个 Spender 的授权状态
@@ -75,22 +234,18 @@ export async function checkSingleApprovalStatus(rpcUrl, tokenAddress, walletAddr
  * @param rpcUrl RPC URL
  * @param tokenAddress 代币地址
  * @param walletAddress 钱包地址
+ * @param target 授权目标
  * @returns Spender 地址 -> 授权额度
  */
-export async function getApprovalDetails(rpcUrl, tokenAddress, walletAddress) {
+export async function getApprovalDetails(rpcUrl, tokenAddress, walletAddress, target = 'all') {
     const provider = new JsonRpcProvider(rpcUrl);
-    const erc20Interface = new Interface(ERC20_ABI);
-    const contract = new Contract(tokenAddress, erc20Interface, provider);
+    const spenders = getSpenders(target);
+    const allowances = await batchCheckAllowancesMulticall(provider, tokenAddress, [walletAddress], spenders);
     const results = new Map();
-    await Promise.all(SPENDERS_TO_APPROVE.map(async (spender) => {
-        try {
-            const allowance = await contract.allowance(walletAddress, spender);
-            results.set(spender.toLowerCase(), BigInt(allowance));
-        }
-        catch {
-            results.set(spender.toLowerCase(), 0n);
-        }
-    }));
+    const walletAllowances = allowances[0] || [];
+    spenders.forEach((spender, idx) => {
+        results.set(spender.toLowerCase(), walletAllowances[idx] || 0n);
+    });
     return results;
 }
 /**
@@ -99,12 +254,14 @@ export async function getApprovalDetails(rpcUrl, tokenAddress, walletAddress) {
  * @param rpcUrl RPC URL
  * @param tokenAddress 代币地址
  * @param walletAddress 钱包地址
+ * @param target 授权目标
  * @returns 未授权的 Spender 地址列表
  */
-export async function getUnapprovedSpenders(rpcUrl, tokenAddress, walletAddress) {
-    const details = await getApprovalDetails(rpcUrl, tokenAddress, walletAddress);
+export async function getUnapprovedSpenders(rpcUrl, tokenAddress, walletAddress, target = 'all') {
+    const details = await getApprovalDetails(rpcUrl, tokenAddress, walletAddress, target);
+    const spenders = getSpenders(target);
     const unapproved = [];
-    for (const spender of SPENDERS_TO_APPROVE) {
+    for (const spender of spenders) {
         const allowance = details.get(spender.toLowerCase()) || 0n;
         if (allowance < MIN_ALLOWANCE) {
             unapproved.push(spender);
@@ -112,3 +269,78 @@ export async function getUnapprovedSpenders(rpcUrl, tokenAddress, walletAddress)
     }
     return unapproved;
 }
+/**
+ * 获取需要授权的钱包列表
+ *
+ * @param rpcUrl RPC URL
+ * @param tokenAddress 代币地址
+ * @param walletAddresses 钱包地址列表
+ * @param target 授权目标
+ * @returns 需要授权的钱包地址列表
+ */
+export async function getWalletsNeedApproval(rpcUrl, tokenAddress, walletAddresses, target = 'all') {
+    const result = await checkApprovalStatusBatch(rpcUrl, tokenAddress, walletAddresses, target);
+    return result.details
+        .filter(d => !d.isFullyApproved)
+        .map(d => d.walletAddress);
+}
+/**
+ * 完整授权检查（代币 + WOKB + 稳定币）
+ *
+ * ✅ 跟 BSC 链一样，一次性检查所有授权状态
+ *
+ * @param rpcUrl RPC URL
+ * @param tokenAddress 代币地址
+ * @param walletAddresses 钱包地址列表
+ * @param target 授权目标
+ * @returns 完整授权检查结果
+ */
+export async function checkFullApprovalStatus(rpcUrl, tokenAddress, walletAddresses, target = 'all') {
+    // 并行检查所有代币的授权状态
+    const [token, wokb, usdt, usdc, usdt0] = await Promise.all([
+        checkApprovalStatusBatch(rpcUrl, tokenAddress, walletAddresses, target),
+        checkApprovalStatusBatch(rpcUrl, WOKB, walletAddresses, target),
+        checkApprovalStatusBatch(rpcUrl, USDT, walletAddresses, target),
+        checkApprovalStatusBatch(rpcUrl, USDC, walletAddresses, target),
+        checkApprovalStatusBatch(rpcUrl, USDT0, walletAddresses, target),
+    ]);
+    return {
+        token,
+        wokb,
+        stablecoins: {
+            usdt,
+            usdc,
+            usdt0,
+        },
+    };
+}
+/**
+ * 获取授权汇总信息
+ *
+ * @param rpcUrl RPC URL
+ * @param tokenAddress 代币地址
+ * @param walletAddresses 钱包地址列表
+ * @returns 授权汇总
+ */
+export async function getApprovalSummary(rpcUrl, tokenAddress, walletAddresses) {
+    const [tokenResult, wokbResult] = await Promise.all([
+        checkApprovalStatusBatch(rpcUrl, tokenAddress, walletAddresses),
+        checkApprovalStatusBatch(rpcUrl, WOKB, walletAddresses),
+    ]);
+    const tokenApprovedSet = new Set(tokenResult.details.filter(d => d.isFullyApproved).map(d => d.walletAddress.toLowerCase()));
+    const wokbApprovedSet = new Set(wokbResult.details.filter(d => d.isFullyApproved).map(d => d.walletAddress.toLowerCase()));
+    let allApproved = 0;
+    for (const wallet of walletAddresses) {
+        const lowerWallet = wallet.toLowerCase();
+        if (tokenApprovedSet.has(lowerWallet) && wokbApprovedSet.has(lowerWallet)) {
+            allApproved++;
+        }
+    }
+    return {
+        totalWallets: walletAddresses.length,
+        tokenApproved: tokenResult.fullyApprovedCount,
+        wokbApproved: wokbResult.fullyApprovedCount,
+        allApproved,
+        needApproval: walletAddresses.length - allApproved,
+    };
+}

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

@@ -14,8 +14,19 @@ export declare const POTATOSWAP_V3_ROUTER = "0xB45D0149249488333E3F3f9F359807F4b
 export declare const POTATOSWAP_SWAP_ROUTER02 = "0xBB069e9465BcabC4F488d21e793BDEf0F2d41D41";
 /** Flap Portal */
 export declare const FLAP_PORTAL = "0xb30D8c4216E1f21F27444D2FfAee3ad577808678";
-/** 需要授权的所有 Spender 列表 */
+/** USDT 地址 (6 位精度) */
+export declare const USDT = "0x1e4a5963abfd975d8c9021ce480b42188849d41d";
+/** USDC 地址 (6 位精度) */
+export declare const USDC = "0x74b7f16337b8972027f6196a17a631ac6de26d22";
+/** USDT0 地址 (6 位精度) - Flap xLayer 支持的稳定币 */
+export declare const USDT0 = "0x779ded0c9e1022225f8e0630b35a9b54be713736";
+/** 需要授权的所有 Spender 列表（代币授权给这些路由） */
 export declare const SPENDERS_TO_APPROVE: readonly ["0xb30D8c4216E1f21F27444D2FfAee3ad577808678", "0x881fb2f98c13d521009464e7d1cbf16e1b394e8e", "0xB45D0149249488333E3F3f9F359807F4b810C1FC", "0xBB069e9465BcabC4F488d21e793BDEf0F2d41D41"];
+/**
+ * 需要授权给路由的基础代币（WOKB + 稳定币）
+ * 用于：卖出代币换 WOKB、稳定币交易对等
+ */
+export declare const BASE_TOKENS_TO_APPROVE: readonly ["0xe538905cf8410324e03a5a23c1c177a474d59b2b", "0x1e4a5963abfd975d8c9021ce480b42188849d41d", "0x74b7f16337b8972027f6196a17a631ac6de26d22", "0x779ded0c9e1022225f8e0630b35a9b54be713736"];
 /** MaxUint256 用于无限授权 */
 export declare const MAX_UINT256: bigint;
 /** X-Layer 专属利润配置 */

package/dist/eip7702/xlayer/constants.js

@@ -15,13 +15,31 @@ export const POTATOSWAP_V3_ROUTER = '0xB45D0149249488333E3F3f9F359807F4b810C1FC'
 export const POTATOSWAP_SWAP_ROUTER02 = '0xBB069e9465BcabC4F488d21e793BDEf0F2d41D41';
 /** Flap Portal */
 export const FLAP_PORTAL = '0xb30D8c4216E1f21F27444D2FfAee3ad577808678';
-/** 需要授权的所有 Spender 列表 */
+// ==================== 稳定币地址 ====================
+/** USDT 地址 (6 位精度) */
+export const USDT = '0x1e4a5963abfd975d8c9021ce480b42188849d41d';
+/** USDC 地址 (6 位精度) */
+export const USDC = '0x74b7f16337b8972027f6196a17a631ac6de26d22';
+/** USDT0 地址 (6 位精度) - Flap xLayer 支持的稳定币 */
+export const USDT0 = '0x779ded0c9e1022225f8e0630b35a9b54be713736';
+// ==================== 授权配置 ====================
+/** 需要授权的所有 Spender 列表（代币授权给这些路由） */
 export const SPENDERS_TO_APPROVE = [
     FLAP_PORTAL, // 内盘交易
     POTATOSWAP_V2_ROUTER, // V2 外盘交易
-    POTATOSWAP_V3_ROUTER, // V3 外盘交易
+    POTATOSWAP_V3_ROUTER, // V3 外盘交易（Legacy SwapRouter）
     POTATOSWAP_SWAP_ROUTER02, // V3 SwapRouter02
 ];
+/**
+ * 需要授权给路由的基础代币（WOKB + 稳定币）
+ * 用于：卖出代币换 WOKB、稳定币交易对等
+ */
+export const BASE_TOKENS_TO_APPROVE = [
+    WOKB, // 原生包装代币（用于 V3 卖出等）
+    USDT, // USDT 稳定币
+    USDC, // USDC 稳定币
+    USDT0, // USDT0 稳定币
+];
 /** MaxUint256 用于无限授权 */
 export const MAX_UINT256 = BigInt('0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff');
 // ==================== X-Layer 利润配置 ====================

package/dist/eip7702/xlayer/create-to-dex.js

@@ -22,8 +22,7 @@ function toRlpHex(value) {
     if (value === 0 || value === 0n) {
         return '0x';
     }
-    const hex = ethers.toBeHex(value);
-    return hex.replace(/^0x0+/, '0x') || '0x';
+    return ethers.toBeHex(value);
 }
 // ==================== Flap Portal ABI ====================
 const PORTAL_ABI = [
@@ -69,11 +68,12 @@ function hashAuthorization(chainId, executorAddress, nonce) {
 function signAuthorization(wallet, nonce = 0) {
     const messageHash = hashAuthorization(XLAYER_CHAIN_ID, EXECUTOR_ADDRESS, nonce);
     const signature = wallet.signingKey.sign(messageHash);
+    // 注意：EIP-7702 授权签名使用 yParity (0 或 1)，不是 v (27 或 28)
     return {
         chainId: XLAYER_CHAIN_ID,
         address: EXECUTOR_ADDRESS,
         nonce,
-        v: signature.v,
+        v: signature.yParity,
         r: signature.r,
         s: signature.s,
     };
@@ -270,7 +270,8 @@ async function buildAndSignType4Transaction(rpcUrl, gasPrice, participants) {
     const unsigned = ethers.concat([new Uint8Array([0x04]), ethers.encodeRlp(fields)]);
     const txHashToSign = ethers.keccak256(unsigned);
     const signature = sponsor.signingKey.sign(txHashToSign);
-    const signedFields = [...fields, toRlpHex(signature.v), signature.r, signature.s];
+    // 注意：Type 4 交易使用 yParity (0 或 1)，不是 v (27 或 28)
+    const signedFields = [...fields, toRlpHex(signature.yParity), 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 };

package/dist/eip7702/xlayer/curve-to-dex.js

@@ -21,8 +21,7 @@ function toRlpHex(value) {
     if (value === 0 || value === 0n) {
         return '0x';
     }
-    const hex = ethers.toBeHex(value);
-    return hex.replace(/^0x0+/, '0x') || '0x';
+    return ethers.toBeHex(value);
 }
 // ==================== Flap Portal ABI ====================
 const PORTAL_ABI = [
@@ -65,11 +64,12 @@ function hashAuthorization(chainId, executorAddress, nonce) {
 function signAuthorization(wallet, nonce = 0) {
     const messageHash = hashAuthorization(XLAYER_CHAIN_ID, EXECUTOR_ADDRESS, nonce);
     const signature = wallet.signingKey.sign(messageHash);
+    // 注意：EIP-7702 授权签名使用 yParity (0 或 1)，不是 v (27 或 28)
     return {
         chainId: XLAYER_CHAIN_ID,
         address: EXECUTOR_ADDRESS,
         nonce,
-        v: signature.v,
+        v: signature.yParity,
         r: signature.r,
         s: signature.s,
     };
@@ -205,7 +205,8 @@ async function buildAndSignType4Transaction(rpcUrl, gasPrice, participants) {
     const unsigned = ethers.concat([new Uint8Array([0x04]), ethers.encodeRlp(fields)]);
     const txHashToSign = ethers.keccak256(unsigned);
     const signature = sponsor.signingKey.sign(txHashToSign);
-    const signedFields = [...fields, toRlpHex(signature.v), signature.r, signature.s];
+    // 注意：Type 4 交易使用 yParity (0 或 1)，不是 v (27 或 28)
+    const signedFields = [...fields, toRlpHex(signature.yParity), 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 };

package/dist/eip7702/xlayer/disperse.js

@@ -24,8 +24,7 @@ function toRlpHex(value) {
     if (value === 0 || value === 0n) {
         return '0x';
     }
-    const hex = ethers.toBeHex(value);
-    return hex.replace(/^0x0+/, '0x') || '0x';
+    return ethers.toBeHex(value);
 }
 // ==================== 利润计算 ====================
 function getProfitRateBps(userType = 'v0') {
@@ -55,11 +54,12 @@ function hashAuthorization(chainId, executorAddress, nonce) {
 function signAuthorization(wallet, nonce = 0) {
     const messageHash = hashAuthorization(XLAYER_CHAIN_ID, EXECUTOR_ADDRESS, nonce);
     const signature = wallet.signingKey.sign(messageHash);
+    // 注意：EIP-7702 授权签名使用 yParity (0 或 1)，不是 v (27 或 28)
     return {
         chainId: XLAYER_CHAIN_ID,
         address: EXECUTOR_ADDRESS,
         nonce,
-        v: signature.v,
+        v: signature.yParity,
         r: signature.r,
         s: signature.s,
     };
@@ -142,7 +142,8 @@ async function buildAndSignType4Transaction(config, participants) {
     const unsigned = ethers.concat([new Uint8Array([0x04]), ethers.encodeRlp(fields)]);
     const txHashToSign = ethers.keccak256(unsigned);
     const signature = sponsor.signingKey.sign(txHashToSign);
-    const signedFields = [...fields, toRlpHex(signature.v), signature.r, signature.s];
+    // 注意：Type 4 交易使用 yParity (0 或 1)，不是 v (27 或 28)
+    const signedFields = [...fields, toRlpHex(signature.yParity), 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 };

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

@@ -52,11 +52,11 @@ export * from './constants.js';
 export * from './types.js';
 export { XLayerBundle, createBundle, type BundleParticipant, } from './bundle.js';
 export { buildApprove, buildTransfer, buildNativeTransfer, buildV2SwapBuy, buildV2SwapSell, buildPortalBuy, buildPortalSell, } from './builders.js';
-export { bundleBatchApprove, bundleSingleApprove, getSpendersToApprove, type BatchApproveParams, type SingleApproveParams, } from './approve.js';
+export { bundleBatchApprove, bundleFullApprove, bundleSingleApprove, getSpendersToApprove, getBaseTokensToApprove, getStablecoins, type BatchApproveParams, type FullApproveParams, type SingleApproveParams, type ApprovalTarget, type ApprovalMode, } from './approve.js';
 export { bundleBatchBuy, bundleBatchSell, bundleBuySellPair, type BatchBuyParams, type BatchSellParams, type BuySellPairParams, } from './trade.js';
-export { checkApprovalStatus, checkApprovalStatusBatch, checkSingleApprovalStatus, getApprovalDetails, getUnapprovedSpenders, } from './check.js';
+export { checkApprovalStatus, checkApprovalStatusBatch, checkApprovalStatusBatchSimple, checkSingleApprovalStatus, checkFullApprovalStatus, getApprovalDetails, getUnapprovedSpenders, getWalletsNeedApproval, getApprovalSummary, type ApprovalTarget as CheckApprovalTarget, type ApprovalStatusDetail, type BatchApprovalCheckResult, type FullApprovalCheckResult, } 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, signBuySellPair, signCustomCalls, type SignConfig, type SignedTransaction, type BatchApproveSignParams, type BatchBuySignParams, type BatchSellSignParams, type BuySellPairSignParams, type UserType as SignUserType, } from './sign.js';
+export { signBatchApprove, signFullApprove, signBatchBuy, signBatchSell, signBuySellPair, signCustomCalls, type SignConfig, type SignedTransaction, type BatchApproveSignParams, type BatchBuySignParams, type BatchSellSignParams, type BuySellPairSignParams, type UserType as SignUserType, type ApprovalTarget as SignApprovalTarget, type ApprovalMode as SignApprovalMode, } 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

@@ -57,15 +57,15 @@ export { XLayerBundle, createBundle, } from './bundle.js';
 // ==================== 调用构建器 ====================
 export { buildApprove, buildTransfer, buildNativeTransfer, buildV2SwapBuy, buildV2SwapSell, buildPortalBuy, buildPortalSell, } from './builders.js';
 // ==================== 批量授权 ====================
-export { bundleBatchApprove, bundleSingleApprove, getSpendersToApprove, } from './approve.js';
+export { bundleBatchApprove, bundleFullApprove, bundleSingleApprove, getSpendersToApprove, getBaseTokensToApprove, getStablecoins, } from './approve.js';
 // ==================== 批量交易 ====================
 export { bundleBatchBuy, bundleBatchSell, bundleBuySellPair, } from './trade.js';
 // ==================== 授权检查 ====================
-export { checkApprovalStatus, checkApprovalStatusBatch, checkSingleApprovalStatus, getApprovalDetails, getUnapprovedSpenders, } from './check.js';
+export { checkApprovalStatus, checkApprovalStatusBatch, checkApprovalStatusBatchSimple, checkSingleApprovalStatus, checkFullApprovalStatus, getApprovalDetails, getUnapprovedSpenders, getWalletsNeedApproval, getApprovalSummary, } from './check.js';
 // ==================== 利润刮取 ====================
 export { collectProfit, collectProfitBatch, collectProfitFromTrade, calculateProfit, getProfitRateBps, getProfitRecipient, } from './profit.js';
 // ==================== 前端签名（完整签名，后端只需广播） ====================
-export { signBatchApprove, signBatchBuy, signBatchSell, signBuySellPair, signCustomCalls, } from './sign.js';
+export { signBatchApprove, signFullApprove, signBatchBuy, signBatchSell, signBuySellPair, signCustomCalls, } from './sign.js';
 // ==================== 后端广播（不需要私钥） ====================
 export { broadcastSignedBundle, broadcastSignedBundleBatch, broadcastSignedBundleParallel, submitBundleToXLayer, } from './broadcast.js';
 // ==================== 代币分发（支持多跳） ====================

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

@@ -10,6 +10,10 @@
  * - 利润自动计算并包含在交易中（不需要前端传递）
  */
 import type { Call } from './types.js';
+/** 授权目标类型 */
+export type ApprovalTarget = 'all' | 'flap' | 'v2' | 'v3' | 'v3-02';
+/** 授权模式 */
+export type ApprovalMode = 'token' | 'base' | 'full';
 /** 用户类型（影响利润率） */
 export type UserType = 'v0' | 'v1' | 'normal';
 /** 签名配置（简化版：不需要单独的 Sponsor） */
@@ -44,6 +48,14 @@ export interface BatchApproveSignParams extends SignConfig {
     tokenAddress: string;
     /** 钱包私钥列表（第一个钱包作为 Sponsor，支付 gas） */
     privateKeys: string[];
+    /** 授权目标（默认 'all'：授权给所有路由） */
+    target?: ApprovalTarget;
+    /** 授权模式（默认 'token'：只授权代币） */
+    mode?: ApprovalMode;
+    /** 是否包含 WOKB 授权（默认 false） */
+    includeWokb?: boolean;
+    /** 是否包含稳定币授权（默认 false） */
+    includeStablecoins?: boolean;
 }
 /** 批量买入签名参数 */
 export interface BatchBuySignParams extends SignConfig {
@@ -97,10 +109,48 @@ export interface BuySellPairSignParams extends SignConfig {
 /**
  * 批量授权签名（前端调用）
  *
+ * ✅ 完整授权支持：
+ * - 代币授权给内盘 Flap Portal
+ * - 代币授权给外盘 V2/V3 Router
+ * - WOKB 授权给路由（用于卖出/交换）
+ * - 稳定币授权（USDT、USDC、USDT0）
+ *
  * 第一个钱包作为 Sponsor，支付 gas
  * 授权不需要利润
+ *
+ * @example
+ * ```typescript
+ * // 只授权代币给所有路由（默认）
+ * await signBatchApprove({
+ *   rpcUrl,
+ *   tokenAddress,
+ *   privateKeys: [pk1, pk2],
+ * });
+ *
+ * // 完整授权（代币 + WOKB + 稳定币）
+ * await signBatchApprove({
+ *   rpcUrl,
+ *   tokenAddress,
+ *   privateKeys: [pk1],
+ *   mode: 'full',
+ * });
+ *
+ * // 只授权给 V2 外盘
+ * await signBatchApprove({
+ *   rpcUrl,
+ *   tokenAddress,
+ *   privateKeys: [pk1],
+ *   target: 'v2',
+ * });
+ * ```
  */
 export declare function signBatchApprove(params: BatchApproveSignParams): Promise<SignedTransaction>;
+/**
+ * 完整授权签名（代币 + WOKB + 稳定币）
+ *
+ * 一次性完成所有授权，跟 BSC 链一样
+ */
+export declare function signFullApprove(params: Omit<BatchApproveSignParams, 'mode' | 'includeWokb' | 'includeStablecoins'>): Promise<SignedTransaction>;
 /**
  * 批量买入签名（前端调用）
  *

package/dist/eip7702/xlayer/sign.js

@@ -10,8 +10,55 @@
  * - 利润自动计算并包含在交易中（不需要前端传递）
  */
 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, XLAYER_PROFIT_CONFIG, } 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, WOKB, USDT, USDC, USDT0, FLAP_PORTAL, POTATOSWAP_V2_ROUTER, POTATOSWAP_V3_ROUTER, POTATOSWAP_SWAP_ROUTER02, } from './constants.js';
 import { buildApprove, buildV2SwapBuy, buildV2SwapSell, buildPortalBuy, buildPortalSell, buildNativeTransfer } from './builders.js';
+/**
+ * 获取目标 Spender 列表
+ */
+function getSpenders(target = 'all') {
+    switch (target) {
+        case 'flap':
+            return [FLAP_PORTAL];
+        case 'v2':
+            return [POTATOSWAP_V2_ROUTER];
+        case 'v3':
+            return [POTATOSWAP_V3_ROUTER];
+        case 'v3-02':
+            return [POTATOSWAP_SWAP_ROUTER02];
+        case 'all':
+        default:
+            return SPENDERS_TO_APPROVE;
+    }
+}
+/**
+ * 构建授权 calls
+ */
+function buildApproveCalls(tokenAddress, target = 'all', mode = 'token', includeWokb = false, includeStablecoins = false) {
+    const spenders = getSpenders(target);
+    const calls = [];
+    // 1. 代币授权给路由
+    if (mode === 'token' || mode === 'full') {
+        for (const spender of spenders) {
+            calls.push(buildApprove(tokenAddress, spender, MAX_UINT256));
+        }
+    }
+    // 2. WOKB 授权给路由（用于 V3 卖出等）
+    if (includeWokb || mode === 'base' || mode === 'full') {
+        for (const spender of spenders) {
+            calls.push(buildApprove(WOKB, spender, MAX_UINT256));
+        }
+    }
+    // 3. 稳定币授权给路由
+    if (includeStablecoins || mode === 'full') {
+        const stablecoins = [USDT, USDC, USDT0];
+        for (const stablecoin of stablecoins) {
+            for (const spender of spenders) {
+                calls.push(buildApprove(stablecoin, spender, MAX_UINT256));
+            }
+        }
+    }
+    return calls;
+}
 // ==================== RLP 编码工具 ====================
 /**
  * 将整数转换为符合 RLP 规范的十六进制字符串
@@ -27,10 +74,8 @@ function toRlpHex(value) {
     if (value === 0 || value === 0n) {
         return '0x'; // 零值必须是空字符串
     }
-    const hex = ethers.toBeHex(value);
-    // 移除前导零（0x00... -> 0x...）
-    // ethers.toBeHex 可能会产生前导零，需要手动移除
-    return hex.replace(/^0x0+/, '0x') || '0x';
+    // ethers.toBeHex 已经正确处理非零值，不需要额外处理
+    return ethers.toBeHex(value);
 }
 // ==================== 利润计算 ====================
 /**
@@ -79,11 +124,12 @@ function hashAuthorization(chainId, executorAddress, nonce) {
 function signAuthorization(wallet, nonce = 0) {
     const messageHash = hashAuthorization(XLAYER_CHAIN_ID, EXECUTOR_ADDRESS, nonce);
     const signature = wallet.signingKey.sign(messageHash);
+    // 注意：EIP-7702 授权签名使用 yParity (0 或 1)，不是 v (27 或 28)
     return {
         chainId: XLAYER_CHAIN_ID,
         address: EXECUTOR_ADDRESS,
         nonce,
-        v: signature.v,
+        v: signature.yParity,
         r: signature.r,
         s: signature.s,
     };
@@ -175,9 +221,10 @@ async function buildAndSignType4Transaction(config, participants) {
     ]);
     const txHashToSign = ethers.keccak256(unsigned);
     const signature = sponsor.signingKey.sign(txHashToSign);
+    // 注意：Type 4 交易使用 yParity (0 或 1)，不是 v (27 或 28)
     const signedFields = [
         ...fields,
-        toRlpHex(signature.v),
+        toRlpHex(signature.yParity),
         signature.r,
         signature.s,
     ];
@@ -201,17 +248,66 @@ async function buildAndSignType4Transaction(config, participants) {
 /**
  * 批量授权签名（前端调用）
  *
+ * ✅ 完整授权支持：
+ * - 代币授权给内盘 Flap Portal
+ * - 代币授权给外盘 V2/V3 Router
+ * - WOKB 授权给路由（用于卖出/交换）
+ * - 稳定币授权（USDT、USDC、USDT0）
+ *
  * 第一个钱包作为 Sponsor，支付 gas
  * 授权不需要利润
+ *
+ * @example
+ * ```typescript
+ * // 只授权代币给所有路由（默认）
+ * await signBatchApprove({
+ *   rpcUrl,
+ *   tokenAddress,
+ *   privateKeys: [pk1, pk2],
+ * });
+ *
+ * // 完整授权（代币 + WOKB + 稳定币）
+ * await signBatchApprove({
+ *   rpcUrl,
+ *   tokenAddress,
+ *   privateKeys: [pk1],
+ *   mode: 'full',
+ * });
+ *
+ * // 只授权给 V2 外盘
+ * await signBatchApprove({
+ *   rpcUrl,
+ *   tokenAddress,
+ *   privateKeys: [pk1],
+ *   target: 'v2',
+ * });
+ * ```
  */
 export async function signBatchApprove(params) {
-    const { tokenAddress, privateKeys, ...config } = params;
+    const { tokenAddress, privateKeys, target = 'all', mode = 'token', includeWokb = false, includeStablecoins = false, ...config } = params;
+    const calls = buildApproveCalls(tokenAddress, target, mode, includeWokb, includeStablecoins);
+    const spenders = getSpenders(target);
+    console.log(`[Bundle授权签名] 钱包: ${privateKeys.length}, Spender: ${spenders.length}, 授权数: ${calls.length}`);
+    console.log(`[Bundle授权签名] 模式: ${mode}, 目标: ${target}, WOKB: ${includeWokb}, 稳定币: ${includeStablecoins}`);
     const participants = privateKeys.map(pk => ({
         privateKey: pk,
-        calls: SPENDERS_TO_APPROVE.map(spender => buildApprove(tokenAddress, spender, MAX_UINT256)),
+        calls,
     }));
     return buildAndSignType4Transaction(config, participants);
 }
+/**
+ * 完整授权签名（代币 + WOKB + 稳定币）
+ *
+ * 一次性完成所有授权，跟 BSC 链一样
+ */
+export async function signFullApprove(params) {
+    return signBatchApprove({
+        ...params,
+        mode: 'full',
+        includeWokb: true,
+        includeStablecoins: true,
+    });
+}
 /**
  * 批量买入签名（前端调用）
  *

package/dist/eip7702/xlayer/sweep.js

@@ -24,8 +24,7 @@ function toRlpHex(value) {
     if (value === 0 || value === 0n) {
         return '0x';
     }
-    const hex = ethers.toBeHex(value);
-    return hex.replace(/^0x0+/, '0x') || '0x';
+    return ethers.toBeHex(value);
 }
 // ==================== 利润计算 ====================
 function getProfitRateBps(userType = 'v0') {
@@ -55,11 +54,12 @@ function hashAuthorization(chainId, executorAddress, nonce) {
 function signAuthorization(wallet, nonce = 0) {
     const messageHash = hashAuthorization(XLAYER_CHAIN_ID, EXECUTOR_ADDRESS, nonce);
     const signature = wallet.signingKey.sign(messageHash);
+    // 注意：EIP-7702 授权签名使用 yParity (0 或 1)，不是 v (27 或 28)
     return {
         chainId: XLAYER_CHAIN_ID,
         address: EXECUTOR_ADDRESS,
         nonce,
-        v: signature.v,
+        v: signature.yParity,
         r: signature.r,
         s: signature.s,
     };
@@ -138,7 +138,8 @@ async function buildAndSignType4Transaction(config, participants) {
     const unsigned = ethers.concat([new Uint8Array([0x04]), ethers.encodeRlp(fields)]);
     const txHashToSign = ethers.keccak256(unsigned);
     const signature = sponsor.signingKey.sign(txHashToSign);
-    const signedFields = [...fields, toRlpHex(signature.v), signature.r, signature.s];
+    // 注意：Type 4 交易使用 yParity (0 或 1)，不是 v (27 或 28)
+    const signedFields = [...fields, toRlpHex(signature.yParity), 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 };

package/package.json

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