four-flap-meme-sdk 1.4.91 → 1.4.93

package/dist/index.d.ts

@@ -52,3 +52,5 @@ export { quoteV2, quoteV3, quote, getTokenToNativeQuote, getNativeToTokenQuote,
 export { submitDirectToRpc, submitDirectToRpcSequential, // ✅ 新增：顺序广播并等待确认（用于多跳）
 submitDirectToRpcParallel, type DirectSubmitConfig, type DirectSubmitResult, type DirectTxResult } from './contracts/tm-bundle-merkle/submit.js';
 export { directV2BatchBuy, directV2BatchSell, directV3BatchBuy, directV3BatchSell, getRouterAddress, DIRECT_ROUTERS, type DirectV2BuyParams, type DirectV2SellParams, type DirectV3BuyParams, type DirectV3SellParams, type DirectRouterResult, type DirectRouterSignConfig, type DexKey, type RouterVersion, } from './dex/index.js';
+export * as XLayer from './xlayer/index.js';
+export { bundleBuy as xlayerBundleBuy, bundleSell as xlayerBundleSell, bundleBuySell as xlayerBundleBuySell, createBundleExecutor as xlayerCreateBundleExecutor, BundleExecutor as XLayerBundleExecutor, makeVolume as xlayerMakeVolume, singleRoundVolume as xlayerSingleRoundVolume, createVolumeExecutor as xlayerCreateVolumeExecutor, VolumeExecutor as XLayerVolumeExecutor, createDexExecutor as xlayerCreateDexExecutor, createDexQuery as xlayerCreateDexQuery, quoteOkbToToken as xlayerQuoteOkbToToken, quoteTokenToOkb as xlayerQuoteTokenToOkb, DexExecutor as XLayerDexExecutor, DexQuery as XLayerDexQuery, createAAAccountManager as xlayerCreateAAAccountManager, predictSender as xlayerPredictSender, createWallet as xlayerCreateWallet, AAAccountManager as XLayerAAAccountManager, generateAAWallets as xlayerGenerateAAWallets, generateAAWalletsFromMnemonic as xlayerGenerateAAWalletsFromMnemonic, predictSendersFromPrivateKeys as xlayerPredictSendersFromPrivateKeys, createBundlerClient as xlayerCreateBundlerClient, BundlerClient as XLayerBundlerClient, createPortalQuery as xlayerCreatePortalQuery, PortalQuery as XLayerPortalQuery, encodeBuyCall as xlayerEncodeBuyCall, encodeSellCall as xlayerEncodeSellCall, encodeApproveCall as xlayerEncodeApproveCall, parseOkb as xlayerParseOkb, formatOkb as xlayerFormatOkb, XLAYER_CHAIN_ID, FLAP_PORTAL as XLAYER_FLAP_PORTAL, ENTRYPOINT_V06 as XLAYER_ENTRYPOINT, SIMPLE_ACCOUNT_FACTORY as XLAYER_FACTORY, PARTICLE_BUNDLER_URL as XLAYER_BUNDLER_URL, WOKB as XLAYER_WOKB, POTATOSWAP_V2_ROUTER as XLAYER_POTATOSWAP_ROUTER, type XLayerConfig, type BundleBuyParams as XLayerBundleBuyParams, type BundleSellParams as XLayerBundleSellParams, type BundleBuySellParams as XLayerBundleBuySellParams, type VolumeParams as XLayerVolumeParams, type BundleBuyResult as XLayerBundleBuyResult, type BundleSellResult as XLayerBundleSellResult, type BundleBuySellResult as XLayerBundleBuySellResult, type VolumeResult as XLayerVolumeResult, type HandleOpsResult as XLayerHandleOpsResult, type AAAccount as XLayerAAAccount, type UserOperation as XLayerUserOperation, type GeneratedAAWallet as XLayerGeneratedAAWallet, type GenerateAAWalletsParams as XLayerGenerateAAWalletsParams, type GenerateAAWalletsResult as XLayerGenerateAAWalletsResult, } from './xlayer/index.js';

package/dist/index.js

@@ -2,6 +2,7 @@
 // 公共 ABI（统一管理）
 // ============================================================================
 export * as Abis from './abis/index.js';
+// export * as Sol from './sol/index.js';
 export { ERC20_ABI, ERC20_BALANCE_ABI, ERC20_ALLOWANCE_ABI, MULTICALL3_ABI, V2_ROUTER_ABI, V2_ROUTER_QUOTE_ABI, V3_ROUTER02_ABI, V3_ROUTER_LEGACY_ABI, V3_QUOTER_ABI, V2_FACTORY_ABI, V2_PAIR_ABI, V3_FACTORY_ABI, V3_POOL_ABI, FLAP_PORTAL_ABI, TM2_ABI, HELPER3_ABI, } from './abis/common.js';
 // ============================================================================
 // 公共常量（统一管理）
@@ -95,3 +96,26 @@ directV3BatchBuy, directV3BatchSell,
 getRouterAddress, 
 // 常量
 DIRECT_ROUTERS, } from './dex/index.js';
+// ============================================================
+// ✅ XLayer SDK（ERC-4337 AA 钱包模式）
+// ============================================================
+export * as XLayer from './xlayer/index.js';
+export { 
+// 捆绑交易
+bundleBuy as xlayerBundleBuy, bundleSell as xlayerBundleSell, bundleBuySell as xlayerBundleBuySell, createBundleExecutor as xlayerCreateBundleExecutor, BundleExecutor as XLayerBundleExecutor, 
+// 刷量
+makeVolume as xlayerMakeVolume, singleRoundVolume as xlayerSingleRoundVolume, createVolumeExecutor as xlayerCreateVolumeExecutor, VolumeExecutor as XLayerVolumeExecutor, 
+// DEX 交易
+createDexExecutor as xlayerCreateDexExecutor, createDexQuery as xlayerCreateDexQuery, quoteOkbToToken as xlayerQuoteOkbToToken, quoteTokenToOkb as xlayerQuoteTokenToOkb, DexExecutor as XLayerDexExecutor, DexQuery as XLayerDexQuery, 
+// AA 账户管理
+createAAAccountManager as xlayerCreateAAAccountManager, predictSender as xlayerPredictSender, createWallet as xlayerCreateWallet, AAAccountManager as XLayerAAAccountManager, 
+// 批量生成钱包工具
+generateAAWallets as xlayerGenerateAAWallets, generateAAWalletsFromMnemonic as xlayerGenerateAAWalletsFromMnemonic, predictSendersFromPrivateKeys as xlayerPredictSendersFromPrivateKeys, 
+// Bundler 客户端
+createBundlerClient as xlayerCreateBundlerClient, BundlerClient as XLayerBundlerClient, 
+// Portal 操作
+createPortalQuery as xlayerCreatePortalQuery, PortalQuery as XLayerPortalQuery, encodeBuyCall as xlayerEncodeBuyCall, encodeSellCall as xlayerEncodeSellCall, encodeApproveCall as xlayerEncodeApproveCall, 
+// 工具函数
+parseOkb as xlayerParseOkb, formatOkb as xlayerFormatOkb, 
+// 常量
+XLAYER_CHAIN_ID, FLAP_PORTAL as XLAYER_FLAP_PORTAL, ENTRYPOINT_V06 as XLAYER_ENTRYPOINT, SIMPLE_ACCOUNT_FACTORY as XLAYER_FACTORY, PARTICLE_BUNDLER_URL as XLAYER_BUNDLER_URL, WOKB as XLAYER_WOKB, POTATOSWAP_V2_ROUTER as XLAYER_POTATOSWAP_ROUTER, } from './xlayer/index.js';

package/dist/xlayer/aa-account.d.ts

@@ -0,0 +1,240 @@
+/**
+ * XLayer AA 账户管理器
+ *
+ * 核心功能：
+ * - AA 账户（Sender）地址预测和部署
+ * - UserOperation 构建和签名
+ * - 余额管理和资金充值
+ * - initCode 生成
+ */
+import { ethers, JsonRpcProvider, Wallet, Contract } from 'ethers';
+import type { UserOperation, SignedUserOp, AAAccount, XLayerConfig } from './types.js';
+import { BundlerClient } from './bundler.js';
+/**
+ * AA 账户管理器
+ *
+ * 管理 ERC-4337 SimpleAccount：
+ * - 地址预测（无需部署即可知道地址）
+ * - UserOp 构建和签名
+ * - Gas 估算和 Prefund 计算
+ * - 支持 Paymaster（免 Gas）
+ */
+export declare class AAAccountManager {
+    private provider;
+    private chainId;
+    private factory;
+    private entryPoint;
+    private factoryAddress;
+    private entryPointAddress;
+    private salt;
+    private bundler;
+    private paymaster?;
+    private paymasterData?;
+    private gasLimitMultiplier;
+    constructor(config?: XLayerConfig);
+    /**
+     * 获取 Provider
+     */
+    getProvider(): JsonRpcProvider;
+    /**
+     * 获取 EntryPoint 合约
+     */
+    getEntryPoint(): Contract;
+    /**
+     * 获取 EntryPoint 地址
+     */
+    getEntryPointAddress(): string;
+    /**
+     * 获取 Bundler 客户端
+     */
+    getBundler(): BundlerClient;
+    /**
+     * 获取当前 Fee Data
+     */
+    getFeeData(): Promise<ethers.FeeData>;
+    /**
+     * 预测 AA Sender 地址
+     *
+     * @param ownerAddress Owner EOA 地址
+     * @param salt 可选的 salt 覆盖
+     * @returns 预测的 Sender 地址
+     */
+    predictSenderAddress(ownerAddress: string, salt?: bigint): Promise<string>;
+    /**
+     * 获取完整的 AA 账户信息
+     */
+    getAccountInfo(ownerAddress: string, salt?: bigint): Promise<AAAccount>;
+    /**
+     * 生成 initCode（用于在 UserOp 中部署账户）
+     */
+    generateInitCode(ownerAddress: string, salt?: bigint): string;
+    /**
+     * 构建 paymasterAndData
+     */
+    private buildPaymasterAndData;
+    /**
+     * 构建未签名的 UserOperation（使用 Bundler 估算 Gas）
+     */
+    buildUserOpWithBundlerEstimate(params: {
+        ownerWallet: Wallet;
+        sender: string;
+        callData: string;
+        nonce: bigint;
+        initCode?: string;
+    }): Promise<{
+        userOp: UserOperation;
+        prefundWei: bigint;
+    }>;
+    /**
+     * 构建未签名的 UserOperation（本地估算 Gas，不依赖 Bundler）
+     *
+     * 适用于无法通过 Bundler 估算的场景（如尚未授权的 sell 操作）
+     */
+    buildUserOpWithLocalEstimate(params: {
+        ownerWallet: Wallet;
+        sender: string;
+        callData: string;
+        nonce: bigint;
+        initCode?: string;
+        callGasLimit?: bigint;
+    }): Promise<{
+        userOp: UserOperation;
+        prefundWei: bigint;
+    }>;
+    /**
+     * 签名 UserOperation
+     */
+    signUserOp(userOp: UserOperation, ownerWallet: Wallet): Promise<SignedUserOp>;
+    /**
+     * 构建并签名 UserOperation（完整流程）
+     */
+    buildAndSignUserOp(params: {
+        ownerWallet: Wallet;
+        callData: string;
+        value?: bigint;
+        useBundlerEstimate?: boolean;
+        callGasLimit?: bigint;
+    }): Promise<SignedUserOp>;
+    /**
+     * 确保 Sender 有足够的 OKB 余额
+     *
+     * @param ownerWallet Owner 钱包（用于转账）
+     * @param sender Sender 地址
+     * @param requiredWei 所需余额（wei）
+     * @param tag 日志标签
+     * @returns 是否进行了转账
+     */
+    ensureSenderBalance(ownerWallet: Wallet, sender: string, requiredWei: bigint, tag?: string): Promise<{
+        funded: boolean;
+        txHash?: string;
+    }>;
+    /**
+     * 批量获取多个 owner 的 AA 账户信息
+     */
+    getMultipleAccountInfo(ownerAddresses: string[]): Promise<AAAccount[]>;
+}
+/**
+ * 编码 SimpleAccount.execute 调用
+ */
+export declare function encodeExecute(dest: string, value: bigint, data: string): string;
+/**
+ * 编码 SimpleAccount.executeBatch 调用
+ */
+export declare function encodeExecuteBatch(dests: string[], values: bigint[], datas: string[]): string;
+/**
+ * 创建 AA 账户管理器
+ */
+export declare function createAAAccountManager(config?: XLayerConfig): AAAccountManager;
+/**
+ * 快速预测 Sender 地址
+ */
+export declare function predictSender(ownerAddress: string, config?: XLayerConfig): Promise<string>;
+/**
+ * 从私钥创建连接了 Provider 的 Wallet
+ */
+export declare function createWallet(privateKey: string, config?: XLayerConfig): Wallet;
+/**
+ * 生成的钱包信息（包含 AA 地址）
+ */
+export interface GeneratedAAWallet {
+    /** 索引 */
+    index: number;
+    /** Owner EOA 地址 */
+    owner: string;
+    /** Owner 私钥 */
+    privateKey: string;
+    /** AA Sender 地址（预测） */
+    sender: string;
+    /** 助记词（仅当使用 generateAAWalletsFromMnemonic 时） */
+    mnemonic?: string;
+    /** 派生路径（仅当使用 generateAAWalletsFromMnemonic 时） */
+    derivationPath?: string;
+}
+/**
+ * 批量生成钱包参数
+ */
+export interface GenerateAAWalletsParams {
+    /** 生成数量 */
+    count: number;
+    /** 配置 */
+    config?: XLayerConfig;
+}
+/**
+ * 批量生成钱包结果
+ */
+export interface GenerateAAWalletsResult {
+    /** 生成的钱包列表 */
+    wallets: GeneratedAAWallet[];
+    /** 所有 owner 地址 */
+    owners: string[];
+    /** 所有私钥 */
+    privateKeys: string[];
+    /** 所有 AA sender 地址 */
+    senders: string[];
+    /** 格式化输出（方便复制） */
+    formatted: string;
+}
+/**
+ * 批量生成随机钱包并预测 AA 地址
+ *
+ * @param params 生成参数
+ * @returns 钱包列表和汇总信息
+ *
+ * @example
+ * ```typescript
+ * const result = await generateAAWallets({ count: 5 });
+ *
+ * console.log(result.formatted);
+ * // 输出:
+ * // === XLayer AA Wallets ===
+ * // #1
+ * //   Owner:  0x1234...
+ * //   Sender: 0xabcd...
+ * //   Key:    0x...
+ * // ...
+ *
+ * // 直接使用私钥列表
+ * await bundleBuy({
+ *   tokenAddress: '0x...',
+ *   privateKeys: result.privateKeys,
+ *   buyAmounts: ['0.01', '0.01', '0.01', '0.01', '0.01'],
+ * });
+ * ```
+ */
+export declare function generateAAWallets(params: GenerateAAWalletsParams): Promise<GenerateAAWalletsResult>;
+/**
+ * 从助记词批量派生钱包并预测 AA 地址
+ *
+ * @param mnemonic 助记词
+ * @param count 派生数量
+ * @param startIndex 起始索引（默认 0）
+ * @param config 配置
+ */
+export declare function generateAAWalletsFromMnemonic(mnemonic: string, count: number, startIndex?: number, config?: XLayerConfig): Promise<GenerateAAWalletsResult>;
+/**
+ * 从私钥列表预测 AA 地址
+ *
+ * @param privateKeys 私钥列表
+ * @param config 配置
+ */
+export declare function predictSendersFromPrivateKeys(privateKeys: string[], config?: XLayerConfig): Promise<GenerateAAWalletsResult>;