four-flap-meme-sdk 1.7.2 → 1.7.4

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

@@ -0,0 +1,60 @@
+/**
+ * X-Layer Bundle 批量授权
+ *
+ * 使用 Bundle 实现多钱包批量授权
+ *
+ * 优化：第一个钱包作为 Sponsor，支付 gas
+ * 其他钱包不需要 gas
+ */
+import type { BatchOperationResult } from './types.js';
+/**
+ * 批量授权参数
+ *
+ * 不需要单独的 Sponsor 私钥
+ * 第一个钱包自动作为 Sponsor，支付 gas
+ */
+export interface BatchApproveParams {
+    /** RPC URL */
+    rpcUrl: string;
+    /** 代币地址 */
+    tokenAddress: string;
+    /** 要授权的钱包列表（第一个钱包作为 Sponsor，支付 gas） */
+    wallets: Array<{
+        privateKey: string;
+    }>;
+    /** Gas Price (可选) */
+    gasPrice?: bigint;
+}
+/**
+ * 单个钱包授权参数
+ *
+ * 该钱包自己支付 gas
+ */
+export interface SingleApproveParams {
+    /** RPC URL */
+    rpcUrl: string;
+    /** 代币地址 */
+    tokenAddress: string;
+    /** 钱包私钥（该钱包自己支付 gas） */
+    walletPrivateKey: string;
+    /** Gas Price (可选) */
+    gasPrice?: bigint;
+}
+/**
+ * Bundle 批量授权
+ *
+ * 将多个钱包对所有 Spender 的授权打包成一笔交易
+ * 第一个钱包作为 Sponsor，支付 gas
+ */
+export declare function bundleBatchApprove(params: BatchApproveParams): Promise<BatchOperationResult>;
+/**
+ * Bundle 单钱包授权
+ *
+ * 对单个钱包授权所有 Spender
+ * 该钱包自己支付 gas
+ */
+export declare function bundleSingleApprove(params: SingleApproveParams): Promise<BatchOperationResult>;
+/**
+ * 获取需要授权的 Spender 列表
+ */
+export declare function getSpendersToApprove(): readonly string[];

package/dist/eip7702/xlayer/approve.js

@@ -0,0 +1,58 @@
+/**
+ * X-Layer Bundle 批量授权
+ *
+ * 使用 Bundle 实现多钱包批量授权
+ *
+ * 优化：第一个钱包作为 Sponsor，支付 gas
+ * 其他钱包不需要 gas
+ */
+import { SPENDERS_TO_APPROVE, MAX_UINT256 } from './constants.js';
+import { XLayerBundle } from './bundle.js';
+import { buildApprove } from './builders.js';
+// ==================== 批量授权 ====================
+/**
+ * Bundle 批量授权
+ *
+ * 将多个钱包对所有 Spender 的授权打包成一笔交易
+ * 第一个钱包作为 Sponsor，支付 gas
+ */
+export async function bundleBatchApprove(params) {
+    const { rpcUrl, tokenAddress, wallets, gasPrice } = params;
+    if (wallets.length === 0) {
+        return { success: false, successCount: 0, totalCount: 0, error: '没有钱包' };
+    }
+    const bundle = new XLayerBundle({ rpcUrl, gasPrice });
+    // 构建参与者：每个钱包授权给所有 Spender
+    const participants = wallets.map(w => ({
+        wallet: w.privateKey,
+        calls: SPENDERS_TO_APPROVE.map(spender => buildApprove(tokenAddress, spender, MAX_UINT256)),
+    }));
+    console.log(`[Bundle授权] 执行批量授权: ${wallets.length} 个钱包, ${SPENDERS_TO_APPROVE.length} 个 Spender`);
+    console.log(`[Bundle授权] 第一个钱包作为 Sponsor，支付 gas`);
+    const result = await bundle.execute(participants);
+    return {
+        ...result,
+        successCount: result.success ? wallets.length : 0,
+        totalCount: wallets.length,
+    };
+}
+/**
+ * Bundle 单钱包授权
+ *
+ * 对单个钱包授权所有 Spender
+ * 该钱包自己支付 gas
+ */
+export async function bundleSingleApprove(params) {
+    return bundleBatchApprove({
+        rpcUrl: params.rpcUrl,
+        tokenAddress: params.tokenAddress,
+        wallets: [{ privateKey: params.walletPrivateKey }],
+        gasPrice: params.gasPrice,
+    });
+}
+/**
+ * 获取需要授权的 Spender 列表
+ */
+export function getSpendersToApprove() {
+    return SPENDERS_TO_APPROVE;
+}

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

@@ -0,0 +1,63 @@
+/**
+ * X-Layer Bundle 广播模块
+ *
+ * 后端使用：接收前端已签名的交易数据，广播到链上
+ * 后端不需要任何私钥，只负责广播和记录
+ */
+import type { BundleResult } from './types.js';
+import type { SignedTransaction } from './sign.js';
+/** 广播配置（后端不需要私钥） */
+export interface BroadcastConfig {
+    /** RPC URL */
+    rpcUrl: string;
+}
+/** 广播结果 */
+export interface BroadcastResult extends BundleResult {
+    /** 参与者数量 */
+    participantCount: number;
+    /** 调用数量 */
+    callCount: number;
+}
+/**
+ * 广播已签名的交易
+ *
+ * 后端调用，接收前端签名的数据并广播
+ * 后端不需要任何私钥
+ *
+ * @param config 广播配置（只需要 RPC URL）
+ * @param signedData 前端签名的交易数据
+ */
+export declare function broadcastSignedBundle(config: BroadcastConfig, signedData: SignedTransaction): Promise<BroadcastResult>;
+/**
+ * 批量广播多个已签名的交易
+ *
+ * @param config 广播配置
+ * @param signedDataList 签名数据列表
+ */
+export declare function broadcastSignedBundleBatch(config: BroadcastConfig, signedDataList: SignedTransaction[]): Promise<BroadcastResult[]>;
+/**
+ * 并行广播多个已签名的交易
+ *
+ * @param config 广播配置
+ * @param signedDataList 签名数据列表
+ */
+export declare function broadcastSignedBundleParallel(config: BroadcastConfig, signedDataList: SignedTransaction[]): Promise<BroadcastResult[]>;
+/**
+ * 直接广播原始交易（兼容 submitBundleToBlockRazor 风格）
+ *
+ * 接收签名后的原始交易字符串数组，逐个广播
+ *
+ * @param signatures 签名后的原始交易数组（hex string）
+ * @param config 广播配置
+ */
+export declare function submitBundleToXLayer(signatures: string[], config: BroadcastConfig): Promise<{
+    code: boolean;
+    txHashes: string[];
+    successCount: number;
+    failCount: number;
+    results: Array<{
+        success: boolean;
+        txHash?: string;
+        error?: string;
+    }>;
+}>;

package/dist/eip7702/xlayer/broadcast.js

@@ -0,0 +1,112 @@
+/**
+ * X-Layer Bundle 广播模块
+ *
+ * 后端使用：接收前端已签名的交易数据，广播到链上
+ * 后端不需要任何私钥，只负责广播和记录
+ */
+import { JsonRpcProvider } from 'ethers';
+// ==================== 广播函数 ====================
+/**
+ * 广播已签名的交易
+ *
+ * 后端调用，接收前端签名的数据并广播
+ * 后端不需要任何私钥
+ *
+ * @param config 广播配置（只需要 RPC URL）
+ * @param signedData 前端签名的交易数据
+ */
+export async function broadcastSignedBundle(config, signedData) {
+    try {
+        const provider = new JsonRpcProvider(config.rpcUrl);
+        console.log(`[Bundle广播] 广播交易: ${signedData.txHash}`);
+        console.log(`[Bundle广播] 参与者: ${signedData.participantCount}, 调用: ${signedData.callCount}`);
+        // 直接广播已签名的原始交易
+        const txResponse = await provider.broadcastTransaction(signedData.signedTx);
+        const receipt = await txResponse.wait();
+        console.log(`[Bundle广播] 成功: ${txResponse.hash}, 区块: ${receipt?.blockNumber}`);
+        return {
+            success: receipt?.status === 1,
+            txHash: txResponse.hash,
+            blockNumber: receipt?.blockNumber,
+            gasUsed: receipt?.gasUsed,
+            participantCount: signedData.participantCount,
+            callCount: signedData.callCount,
+        };
+    }
+    catch (error) {
+        console.error('[Bundle广播] 失败:', error);
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+            participantCount: signedData.participantCount,
+            callCount: signedData.callCount,
+        };
+    }
+}
+/**
+ * 批量广播多个已签名的交易
+ *
+ * @param config 广播配置
+ * @param signedDataList 签名数据列表
+ */
+export async function broadcastSignedBundleBatch(config, signedDataList) {
+    const results = [];
+    for (const signedData of signedDataList) {
+        const result = await broadcastSignedBundle(config, signedData);
+        results.push(result);
+    }
+    return results;
+}
+/**
+ * 并行广播多个已签名的交易
+ *
+ * @param config 广播配置
+ * @param signedDataList 签名数据列表
+ */
+export async function broadcastSignedBundleParallel(config, signedDataList) {
+    return Promise.all(signedDataList.map(signedData => broadcastSignedBundle(config, signedData)));
+}
+/**
+ * 直接广播原始交易（兼容 submitBundleToBlockRazor 风格）
+ *
+ * 接收签名后的原始交易字符串数组，逐个广播
+ *
+ * @param signatures 签名后的原始交易数组（hex string）
+ * @param config 广播配置
+ */
+export async function submitBundleToXLayer(signatures, config) {
+    const provider = new JsonRpcProvider(config.rpcUrl);
+    const results = [];
+    const txHashes = [];
+    let successCount = 0;
+    let failCount = 0;
+    for (const signedTx of signatures) {
+        try {
+            const txResponse = await provider.broadcastTransaction(signedTx);
+            const receipt = await txResponse.wait();
+            if (receipt?.status === 1) {
+                successCount++;
+                txHashes.push(txResponse.hash);
+                results.push({ success: true, txHash: txResponse.hash });
+            }
+            else {
+                failCount++;
+                results.push({ success: false, txHash: txResponse.hash, error: 'Transaction reverted' });
+            }
+        }
+        catch (error) {
+            failCount++;
+            results.push({
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return {
+        code: successCount > 0,
+        txHashes,
+        successCount,
+        failCount,
+        results,
+    };
+}

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

@@ -0,0 +1,34 @@
+/**
+ * X-Layer Bundle 调用构建器
+ *
+ * 提供构建各种调用的便捷方法
+ */
+import type { Call } from './types.js';
+/**
+ * 构建 ERC20 approve 调用
+ */
+export declare function buildApprove(token: string, spender: string, amount: bigint): Call;
+/**
+ * 构建 ERC20 transfer 调用
+ */
+export declare function buildTransfer(token: string, to: string, amount: bigint): Call;
+/**
+ * 构建原生代币转账调用
+ */
+export declare function buildNativeTransfer(to: string, amount: bigint): Call;
+/**
+ * 构建 V2 Swap 买入调用 (OKB -> Token)
+ */
+export declare function buildV2SwapBuy(tokenAddress: string, amountInOkb: bigint, amountOutMin: bigint | undefined, to: string, deadline?: number): Call;
+/**
+ * 构建 V2 Swap 卖出调用 (Token -> OKB)
+ */
+export declare function buildV2SwapSell(tokenAddress: string, amountIn: bigint, amountOutMin: bigint | undefined, to: string, deadline?: number): Call;
+/**
+ * 构建 Flap Portal 买入调用 (内盘买入)
+ */
+export declare function buildPortalBuy(tokenAddress: string, amountInOkb: bigint, amountOutMin: bigint | undefined, to: string, deadline?: number): Call;
+/**
+ * 构建 Flap Portal 卖出调用 (内盘卖出)
+ */
+export declare function buildPortalSell(tokenAddress: string, amountIn: bigint, amountOutMin: bigint | undefined, to: string, deadline?: number): Call;

package/dist/eip7702/xlayer/builders.js

@@ -0,0 +1,100 @@
+/**
+ * X-Layer Bundle 调用构建器
+ *
+ * 提供构建各种调用的便捷方法
+ */
+import { Interface } from 'ethers';
+import { WOKB, POTATOSWAP_V2_ROUTER, FLAP_PORTAL } from './constants.js';
+// ==================== ERC20 相关 ====================
+/**
+ * 构建 ERC20 approve 调用
+ */
+export function buildApprove(token, spender, amount) {
+    const iface = new Interface(['function approve(address,uint256) returns (bool)']);
+    return {
+        target: token,
+        value: 0n,
+        data: iface.encodeFunctionData('approve', [spender, amount]),
+    };
+}
+/**
+ * 构建 ERC20 transfer 调用
+ */
+export function buildTransfer(token, to, amount) {
+    const iface = new Interface(['function transfer(address,uint256) returns (bool)']);
+    return {
+        target: token,
+        value: 0n,
+        data: iface.encodeFunctionData('transfer', [to, amount]),
+    };
+}
+/**
+ * 构建原生代币转账调用
+ */
+export function buildNativeTransfer(to, amount) {
+    return {
+        target: to,
+        value: amount,
+        data: '0x',
+    };
+}
+// ==================== V2 Swap 相关 ====================
+/**
+ * 构建 V2 Swap 买入调用 (OKB -> Token)
+ */
+export function buildV2SwapBuy(tokenAddress, amountInOkb, amountOutMin = 0n, to, deadline) {
+    const iface = new Interface([
+        'function swapExactETHForTokens(uint256 amountOutMin, address[] path, address to, uint256 deadline) payable returns (uint256[] amounts)',
+    ]);
+    const path = [WOKB, tokenAddress];
+    const dl = deadline || Math.floor(Date.now() / 1000) + 1200; // 20 分钟
+    return {
+        target: POTATOSWAP_V2_ROUTER,
+        value: amountInOkb,
+        data: iface.encodeFunctionData('swapExactETHForTokens', [amountOutMin, path, to, dl]),
+    };
+}
+/**
+ * 构建 V2 Swap 卖出调用 (Token -> OKB)
+ */
+export function buildV2SwapSell(tokenAddress, amountIn, amountOutMin = 0n, to, deadline) {
+    const iface = new Interface([
+        'function swapExactTokensForETH(uint256 amountIn, uint256 amountOutMin, address[] path, address to, uint256 deadline) returns (uint256[] amounts)',
+    ]);
+    const path = [tokenAddress, WOKB];
+    const dl = deadline || Math.floor(Date.now() / 1000) + 1200;
+    return {
+        target: POTATOSWAP_V2_ROUTER,
+        value: 0n,
+        data: iface.encodeFunctionData('swapExactTokensForETH', [amountIn, amountOutMin, path, to, dl]),
+    };
+}
+// ==================== Flap Portal 相关 ====================
+/**
+ * 构建 Flap Portal 买入调用 (内盘买入)
+ */
+export function buildPortalBuy(tokenAddress, amountInOkb, amountOutMin = 0n, to, deadline) {
+    const iface = new Interface([
+        'function buy(address token, uint256 amountOutMin, address to, uint256 deadline) payable returns (uint256 amountOut)',
+    ]);
+    const dl = deadline || Math.floor(Date.now() / 1000) + 1200;
+    return {
+        target: FLAP_PORTAL,
+        value: amountInOkb,
+        data: iface.encodeFunctionData('buy', [tokenAddress, amountOutMin, to, dl]),
+    };
+}
+/**
+ * 构建 Flap Portal 卖出调用 (内盘卖出)
+ */
+export function buildPortalSell(tokenAddress, amountIn, amountOutMin = 0n, to, deadline) {
+    const iface = new Interface([
+        'function sell(address token, uint256 amountIn, uint256 amountOutMin, address to, uint256 deadline) returns (uint256 amountOut)',
+    ]);
+    const dl = deadline || Math.floor(Date.now() / 1000) + 1200;
+    return {
+        target: FLAP_PORTAL,
+        value: 0n,
+        data: iface.encodeFunctionData('sell', [tokenAddress, amountIn, amountOutMin, to, dl]),
+    };
+}

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

@@ -0,0 +1,70 @@
+/**
+ * X-Layer Bundle 执行器
+ *
+ * 核心的捆绑交易执行类
+ *
+ * 优化：第一个参与钱包作为 Sponsor，支付 gas
+ * 其他参与钱包不需要 gas
+ */
+import { Wallet, JsonRpcProvider } from 'ethers';
+import type { Call, BundleConfig, BundleResult } from './types.js';
+/** Bundle 参与者 */
+export interface BundleParticipant {
+    /** 钱包（或私钥字符串） */
+    wallet: Wallet | string;
+    /** 该钱包要执行的调用列表 */
+    calls: Call[];
+}
+/**
+ * X-Layer Bundle 执行器
+ *
+ * 使用 Type 4 交易实现多地址原子化捆绑
+ *
+ * 第一个参与钱包作为 Sponsor，支付 gas
+ * 其他参与钱包不需要 gas
+ */
+export declare class XLayerBundle {
+    private provider;
+    private gasPrice;
+    private executorInterface;
+    constructor(config: BundleConfig);
+    /**
+     * 获取 Provider
+     */
+    getProvider(): JsonRpcProvider;
+    /**
+     * 执行 Bundle 交易
+     *
+     * 第一个参与者作为 Sponsor，支付 gas
+     * 其他参与者不需要 gas
+     *
+     * @param participants 参与者列表（第一个作为 Sponsor）
+     * @returns 执行结果
+     */
+    execute(participants: BundleParticipant[]): Promise<BundleResult>;
+    /**
+     * 简化的单钱包批量执行
+     */
+    executeBatch(wallet: Wallet | string, calls: Call[]): Promise<BundleResult>;
+    /**
+     * 获取 Sponsor 地址（第一个参与者）
+     *
+     * 注意：必须在 execute 时传入参与者才能确定 Sponsor
+     */
+    getSponsorAddress(participants: BundleParticipant[]): string;
+    /**
+     * 获取授权 nonce
+     */
+    private getAuthorizationNonce;
+    /**
+     * 签名 Type 4 交易
+     */
+    private signType4Transaction;
+}
+/**
+ * 创建 Bundle 执行器
+ *
+ * 不需要单独的 Sponsor 私钥
+ * 第一个参与钱包自动作为 Sponsor
+ */
+export declare function createBundle(rpcUrl: string, gasPrice?: bigint): XLayerBundle;