four-flap-meme-sdk 1.7.7 → 1.7.9

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

@@ -8,13 +8,24 @@
  */
 import { ethers, Wallet, JsonRpcProvider, Interface } from 'ethers';
 import { XLAYER_CHAIN_ID, EXECUTOR_ADDRESS, EXECUTOR_ABI, DEFAULT_GAS_PRICE, GAS_LIMIT_MULTIPLIER, } from './constants.js';
+// ==================== RLP 编码工具 ====================
+/**
+ * 将整数转换为符合 RLP 规范的十六进制字符串
+ * 零值必须编码为空字符串 "0x"，而不是 "0x00"
+ */
+function toRlpHex(value) {
+    if (value === 0 || value === 0n) {
+        return '0x';
+    }
+    return ethers.toBeHex(value);
+}
 // ==================== 工具函数 ====================
 /** 计算授权消息哈希 */
 function hashAuthorization(chainId, executorAddress, nonce) {
     const encoded = ethers.encodeRlp([
-        ethers.toBeHex(chainId),
+        toRlpHex(chainId),
         executorAddress,
-        ethers.toBeHex(nonce),
+        toRlpHex(nonce),
     ]);
     const prefixed = ethers.concat([new Uint8Array([0x05]), encoded]);
     return ethers.keccak256(prefixed);
@@ -171,21 +182,21 @@ export class XLayerBundle {
         // EIP-7702 RLP 字段顺序：
         // [chainId, nonce, maxPriorityFeePerGas, maxFeePerGas, gasLimit, to, value, data, accessList, authorizationList]
         const fields = [
-            ethers.toBeHex(tx.chainId),
-            ethers.toBeHex(tx.nonce),
-            ethers.toBeHex(tx.maxPriorityFeePerGas),
-            ethers.toBeHex(tx.maxFeePerGas),
-            ethers.toBeHex(tx.gasLimit),
+            toRlpHex(tx.chainId),
+            toRlpHex(tx.nonce),
+            toRlpHex(tx.maxPriorityFeePerGas),
+            toRlpHex(tx.maxFeePerGas),
+            toRlpHex(tx.gasLimit),
             tx.to,
-            ethers.toBeHex(tx.value),
+            toRlpHex(tx.value),
             tx.data,
             (tx.accessList || []).map((item) => [item.address, item.storageKeys]), // accessList
             // Authorization list
             tx.authorizationList.map((auth) => [
-                ethers.toBeHex(auth.chainId),
+                toRlpHex(auth.chainId),
                 auth.address,
-                ethers.toBeHex(auth.nonce),
-                ethers.toBeHex(auth.v),
+                toRlpHex(auth.nonce),
+                toRlpHex(auth.v),
                 auth.r,
                 auth.s,
             ]),
@@ -199,14 +210,14 @@ export class XLayerBundle {
         // 添加签名
         const signedFields = [
             ...fields,
-            ethers.toBeHex(signature.v),
+            toRlpHex(signature.v),
             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;
+}>;