four-flap-meme-sdk 1.9.49 → 2.0.0

package/dist/chains/xlayer/eoa/index.d.ts

@@ -11,14 +11,18 @@
  */
 export * from './constants.js';
 export * from './types.js';
+import { createPortalQuery } from './portal-ops.js';
+import { xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, xlayerPureCrossSwapMerkle } from './eoa-bundle-swap.js';
+import { signEoaWashVolumeTransactions } from './eoa-wash-volume.js';
 export { encodeBuyCall, encodeBuyCallV3, encodeSellCall, encodeApproveCall, encodeTransferCall, PortalQuery, createPortalQuery, applySlippage, formatOkb, parseOkb, formatTokenAmount, parseTokenAmount, type PortalQueryConfig, } from './portal-ops.js';
 export { signEoaWashBuyTransactions, signEoaWashSellTransactions, signEoaWashVolumeTransactions, type EoaWashPoolType, type EoaWashVolumeParams, type EoaWashVolumeResult, } from './eoa-wash-volume.js';
-export { xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, xlayerPureCrossSwapMerkle, type XLayerEoaSwapConfig, type XLayerQuickBatchSwapParams, type XLayerQuickBatchSwapResult, type XLayerCrossSwapParams, type XLayerCrossSwapResult, type XLayerPureCrossSwapParams, type XLayerPureCrossSwapResult, type UserType as XLayerUserType, type RouteParams as XLayerRouteParams, type V2RouteParams as XLayerV2RouteParams, type V3SingleRouteParams as XLayerV3SingleRouteParams, } from './eoa-bundle-swap.js';
+export { xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, xlayerPureCrossSwapMerkle, type XLayerPureCrossSwapParams, type XLayerPureCrossSwapResult, } from './eoa-bundle-swap.js';
+export type { XLayerEoaSwapConfig, XLayerQuickBatchSwapParams, XLayerQuickBatchSwapResult, XLayerCrossSwapParams, XLayerCrossSwapResult, UserType as XLayerUserType, RouteParams as XLayerRouteParams, V2RouteParams as XLayerV2RouteParams, V3SingleRouteParams as XLayerV3SingleRouteParams, V3MultiRouteParams as XLayerV3MultiRouteParams, } from './eoa-bundle-swap-helpers.js';
 export declare const xlayer: {
-    createPortalQuery: (config?: import("./portal-ops.js").PortalQueryConfig | undefined) => Promise<import("./portal-ops.js").PortalQuery>;
-    xlayerQuickBatchSwapMerkle: (params: import("./eoa-bundle-swap.js").XLayerQuickBatchSwapParams) => Promise<import("./eoa-bundle-swap.js").XLayerQuickBatchSwapResult>;
-    xlayerCrossSwapMerkle: (params: import("./eoa-bundle-swap.js").XLayerCrossSwapParams) => Promise<import("./eoa-bundle-swap.js").XLayerCrossSwapResult>;
-    xlayerPureCrossSwapMerkle: (params: import("./eoa-bundle-swap.js").XLayerPureCrossSwapParams) => Promise<import("./eoa-bundle-swap.js").XLayerPureCrossSwapResult>;
-    signEoaWashVolumeTransactions: (params: import("./eoa-wash-volume.js").EoaWashVolumeParams) => Promise<import("./eoa-wash-volume.js").EoaWashVolumeResult>;
+    createPortalQuery: typeof createPortalQuery;
+    xlayerQuickBatchSwapMerkle: typeof xlayerQuickBatchSwapMerkle;
+    xlayerCrossSwapMerkle: typeof xlayerCrossSwapMerkle;
+    xlayerPureCrossSwapMerkle: typeof xlayerPureCrossSwapMerkle;
+    signEoaWashVolumeTransactions: typeof signEoaWashVolumeTransactions;
 };
 export default xlayer;

package/dist/chains/xlayer/eoa/index.js

@@ -17,6 +17,9 @@ export * from './constants.js';
 // 类型
 // ============================================================================
 export * from './types.js';
+import { createPortalQuery } from './portal-ops.js';
+import { xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, xlayerPureCrossSwapMerkle } from './eoa-bundle-swap.js';
+import { signEoaWashVolumeTransactions } from './eoa-wash-volume.js';
 // ============================================================================
 // Portal 操作
 // ============================================================================
@@ -33,28 +36,10 @@ export { xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, xlayerPureCrossSwapM
 // 便捷重导出
 // ============================================================================
 export const xlayer = {
-    // Portal 查询
-    createPortalQuery: async (...args) => {
-        const { createPortalQuery } = await import('./portal-ops.js');
-        return createPortalQuery(...args);
-    },
-    // EOA 换手
-    xlayerQuickBatchSwapMerkle: async (...args) => {
-        const { xlayerQuickBatchSwapMerkle } = await import('./eoa-bundle-swap.js');
-        return xlayerQuickBatchSwapMerkle(...args);
-    },
-    xlayerCrossSwapMerkle: async (...args) => {
-        const { xlayerCrossSwapMerkle } = await import('./eoa-bundle-swap.js');
-        return xlayerCrossSwapMerkle(...args);
-    },
-    xlayerPureCrossSwapMerkle: async (...args) => {
-        const { xlayerPureCrossSwapMerkle } = await import('./eoa-bundle-swap.js');
-        return xlayerPureCrossSwapMerkle(...args);
-    },
-    // EOA 刷量
-    signEoaWashVolumeTransactions: async (...args) => {
-        const { signEoaWashVolumeTransactions } = await import('./eoa-wash-volume.js');
-        return signEoaWashVolumeTransactions(...args);
-    },
+    createPortalQuery,
+    xlayerQuickBatchSwapMerkle,
+    xlayerCrossSwapMerkle,
+    xlayerPureCrossSwapMerkle,
+    signEoaWashVolumeTransactions,
 };
 export default xlayer;

package/dist/chains/xlayer/eoa/portal-ops.js

@@ -165,6 +165,9 @@ export function encodeCreateCallV5(params) {
  * - 代币状态
  */
 export class PortalQuery {
+    provider;
+    portal;
+    portalAddress;
     constructor(config = {}) {
         const rpcUrl = config.rpcUrl ?? DEFAULT_RPC_URL;
         const chainId = config.chainId ?? XLAYER_CHAIN_ID;
@@ -446,8 +449,10 @@ export function applySlippage(expectedOutput, slippageBps) {
  */
 export function lpFeeProfileToV3Fee(profile) {
     switch (profile) {
-        case 1: return 100; // 0.01%
-        case 2: return 10000; // 1%
+        case 1:
+            return 100; // 0.01%
+        case 2:
+            return 10000; // 1%
         case 0:
         default:
             return 2500; // 0.25%

package/dist/chains/xlayer/eoa/router-manager.js

@@ -2,7 +2,7 @@
  * XLayer Router 管理器
  * 统一管理 V2/V3 Router 地址和授权目标选择逻辑
  */
-import { POTATOSWAP_V2_ROUTER, POTATOSWAP_V3_ROUTER, FLAP_PORTAL, } from './constants.js';
+import { POTATOSWAP_V2_ROUTER, POTATOSWAP_V3_ROUTER, FLAP_PORTAL } from './constants.js';
 /**
  * ✅ 获取 Router 地址
  * @param params.routerVersion - Router 版本（V2 或 V3）
@@ -49,9 +49,9 @@ export function getApprovalTargetAddress(target) {
  * @returns 目标信息数组
  */
 export function getAllApprovalTargets(targets) {
-    return targets.map(target => ({
+    return targets.map((target) => ({
         target,
-        address: getApprovalTargetAddress(target)
+        address: getApprovalTargetAddress(target),
     }));
 }
 /**

package/dist/chains/xlayer/eoa/types-core.d.ts

@@ -0,0 +1,363 @@
+/**
+ * XLayer SDK 类型定义
+ *
+ * 包含 ERC-4337 UserOperation、AA 账户、交易参数等核心类型
+ */
+import type { HexString } from './constants.js';
+import type { HandleOpsResult } from './types-volume.js';
+/**
+ * UserOperation v0.6 结构
+ * 用于 ERC-4337 EntryPoint v0.6
+ */
+export interface UserOperation {
+    sender: string;
+    nonce: HexString | string;
+    initCode: HexString | string;
+    callData: HexString | string;
+    callGasLimit: HexString | string;
+    verificationGasLimit: HexString | string;
+    preVerificationGas: HexString | string;
+    maxFeePerGas: HexString | string;
+    maxPriorityFeePerGas: HexString | string;
+    paymasterAndData: HexString | string;
+    signature: HexString | string;
+}
+/**
+ * 签名后的 UserOperation（包含额外元数据）
+ */
+export interface SignedUserOp {
+    userOp: UserOperation;
+    userOpHash: string;
+    prefundWei: bigint;
+    sender: string;
+    ownerName?: string;
+}
+/**
+ * Gas 估算结果（来自 Bundler）
+ */
+export interface GasEstimate {
+    callGasLimit: HexString;
+    verificationGasLimit: HexString;
+    preVerificationGas: HexString;
+    maxFeePerGas?: HexString;
+    maxPriorityFeePerGas?: HexString;
+}
+export type GasPolicy = 'fixed' | 'localEstimate' | 'bundlerEstimate';
+export interface FixedGasConfig {
+    /** callGasLimit（若不提供，SDK 会使用较保守的默认值） */
+    callGasLimit?: bigint;
+    /** 已部署 sender 的 verificationGasLimit（默认用 SDK 常量） */
+    verificationGasLimitDeployed?: bigint;
+    /** 未部署 sender 的 verificationGasLimit（默认用 SDK 常量） */
+    verificationGasLimitUndeployed?: bigint;
+    /** preVerificationGas（默认用 SDK 常量） */
+    preVerificationGas?: bigint;
+    /** ✅ 固定 gasPrice（若不提供，SDK 会调用 getFeeData 获取） */
+    gasPrice?: bigint;
+}
+/**
+ * XLayer SDK 基础配置
+ */
+export interface XLayerConfig {
+    /** RPC URL（默认使用公共节点） */
+    rpcUrl?: string;
+    /** Bundler URL（默认使用 Particle） */
+    bundlerUrl?: string;
+    /** Chain ID（默认 196） */
+    chainId?: number;
+    /** EntryPoint 地址 */
+    entryPoint?: string;
+    /** SimpleAccountFactory 地址 */
+    factory?: string;
+    /** Salt（用于 AA 账户派生） */
+    salt?: bigint;
+    /** Paymaster 地址（如果指定，不需要往 AA 转手续费） */
+    paymaster?: string;
+    /** Paymaster Data（与 paymaster 一起使用） */
+    paymasterData?: string;
+    /** 默认超时时间（毫秒） */
+    timeoutMs?: number;
+    /** Gas 估算安全余量倍数 */
+    gasLimitMultiplier?: number;
+    /** Payer handleOps 交易的 gasLimit（手动覆盖） */
+    gasLimit?: bigint;
+    /** Payer handleOps 交易的最小 gasPrice (Gwei) */
+    minGasPriceGwei?: number;
+    /** 利润尾笔原生转账 gasLimit（默认 21000n） */
+    profitTailGasLimit?: bigint;
+    /**
+     * AA Gas 策略（用于大规模地址时减少 RPC）
+     * - fixed：固定 gas（不 estimate）
+     * - localEstimate：eth_estimateGas（不走 bundler）
+     * - bundlerEstimate：eth_estimateUserOperationGas（最慢但最稳）
+     */
+    gasPolicy?: GasPolicy;
+    /** fixed 策略的默认 gas 配置（可被每次调用覆盖） */
+    fixedGas?: FixedGasConfig;
+    /**
+     * 是否提取利润（默认 true）
+     * - 对齐 BSC：默认会从“卖出得到的 OKB / 归集金额”中按比例刮取利润
+     */
+    extractProfit?: boolean;
+    /**
+     * 利润比例（基点 bps，1 bps = 0.01%）
+     * - 默认使用 `getProfitRateBps('normal')`
+     */
+    profitBps?: number;
+    /**
+     * 利润接收地址
+     * - 默认使用 `getProfitRecipient()`
+     */
+    profitRecipient?: string;
+    /**
+     * ✅ 安全边际百分比（默认 80）
+     * - 只使用报价的 X% 进行分发，防止价格下跌导致失败
+     * - 例如：80 表示只使用报价的 80%，允许价格下跌 20%
+     * - 范围：50-100，越低越安全但买入金额越少
+     */
+    safetyMarginPercent?: number;
+}
+/**
+ * AA 账户信息
+ */
+export interface AAAccount {
+    /** Owner EOA 地址 */
+    owner: string;
+    /** AA Sender 地址 */
+    sender: string;
+    /** 是否已部署 */
+    deployed: boolean;
+    /** OKB 余额 */
+    balance: bigint;
+    /** Nonce */
+    nonce: bigint;
+}
+/**
+ * Owner 钱包信息
+ */
+export interface OwnerInfo {
+    name: string;
+    privateKey: string;
+    address?: string;
+    sender?: string;
+}
+/**
+ * 买入参数
+ */
+export interface BuyParams {
+    /** Flap 代币地址 */
+    tokenAddress: string;
+    /** 买入金额（OKB，字符串格式） */
+    amountOkb: string;
+    /** 最小输出代币数量（默认 0） */
+    minOutputAmount?: bigint;
+    /** 滑点基点（默认 100 = 1%） */
+    slippageBps?: number;
+}
+/**
+ * 卖出参数
+ */
+export interface SellParams {
+    /** Flap 代币地址 */
+    tokenAddress: string;
+    /** 卖出代币数量（可选，默认全部） */
+    amount?: bigint;
+    /** 卖出比例（0-100，如 50 表示卖出 50%） */
+    sellPercent?: number;
+    /** 最小输出 OKB 数量（默认 0） */
+    minOutputAmount?: bigint;
+    /** 滑点基点（默认 100 = 1%） */
+    slippageBps?: number;
+}
+/**
+ * 捆绑买入参数
+ */
+export interface BundleBuyParams {
+    /** 代币地址 */
+    tokenAddress: string;
+    /** Owner 私钥列表 */
+    privateKeys: string[];
+    /** 每个 owner 的买入金额（OKB 或 quoteToken，取决于 quoteToken 参数） */
+    buyAmounts: string[];
+    /** 买入使用的代币地址（零地址表示使用原生代币 OKB，非零地址表示使用 ERC20 代币如 USDC） */
+    quoteToken?: string;
+    /** quoteToken 的精度（默认 18，如果 quoteToken 不是 18 位精度需要指定） */
+    quoteTokenDecimals?: number;
+    /** 是否将代币转回 owner EOA（默认 false） */
+    transferBackToOwner?: boolean;
+    /** 配置覆盖 */
+    config?: Partial<XLayerConfig>;
+}
+/**
+ * 捆绑卖出参数
+ */
+export interface BundleSellParams {
+    /** 代币地址 */
+    tokenAddress: string;
+    /** Owner 私钥列表 */
+    privateKeys: string[];
+    /** 卖出比例（0-100，默认 100 全部卖出） */
+    sellPercent?: number;
+    /** 是否将 OKB 归集回 owner EOA（默认 true） */
+    withdrawToOwner?: boolean;
+    /** 归集时保留的最小 OKB 余额 */
+    withdrawReserve?: string;
+    /** 配置覆盖 */
+    config?: Partial<XLayerConfig>;
+}
+/**
+ * 捆绑买卖参数（先买后卖）
+ */
+export interface BundleBuySellParams {
+    /** 代币地址 */
+    tokenAddress: string;
+    /** Owner 私钥列表 */
+    privateKeys: string[];
+    /** 每个 owner 的買入金额（OKB 或 quoteToken，取决于 quoteToken 参数） */
+    buyAmounts: string[];
+    /** 买入使用的代币地址（零地址表示使用原生代币 OKB，非零地址表示使用 ERC20 代币如 USDC） */
+    quoteToken?: string;
+    /** quoteToken 的精度（默认 18，如果 quoteToken 不是 18 位精度需要指定） */
+    quoteTokenDecimals?: number;
+    /** 卖出比例（0-100，默认 100 全部卖出） */
+    sellPercent?: number;
+    /** 是否将 OKB 归集回 owner EOA（默认 true） */
+    withdrawToOwner?: boolean;
+    /** 归集时保留的最小 OKB 余额 */
+    withdrawReserve?: string;
+    /** 配置覆盖 */
+    config?: Partial<XLayerConfig>;
+    /** LP 费率档位 (V3 专用): 0=STANDARD, 1=LOW, 2=HIGH */
+    lpFeeProfile?: number;
+    /** DEX 类型: 'V2' | 'V3' */
+    dexType?: 'V2' | 'V3';
+}
+/**
+ * 捆绑发射签名参数
+ */
+export interface BundlePreApproveParams {
+    /** 代币地址 */
+    tokenAddress: string;
+    /** Owner 私钥列表 */
+    privateKeys: string[];
+    /** 授权目标（默认 FLAP_PORTAL，可传 Router 地址用于外盘交易） */
+    spender?: string;
+    /**
+     * 是否仅签名（不执行）
+     * - true: 返回签名后的 handleOps 交易，由前端发送到服务端广播
+     * - false（默认）: 直接执行 handleOps
+     */
+    signOnly?: boolean;
+    /** 配置覆盖 */
+    config?: Partial<XLayerConfig>;
+    /** Payer 私钥（signOnly=true 时必传，用于支付 gas） */
+    payerPrivateKey?: string;
+}
+/**
+ * 预授权结果
+ */
+export interface BundlePreApproveResult {
+    /** 发送授权交易的数量 */
+    approvedCount: number;
+    /** 已经授权无需操作的数量 */
+    alreadyApprovedCount: number;
+    /** 授权交易结果（signOnly=false 时有值） */
+    approveResult?: HandleOpsResult;
+    /** 每个地址的授权状态详情 */
+    details: ApprovalStatusResult[];
+    /** signOnly=true 时：签名后的 handleOps 交易（raw signed tx） */
+    signedTransactions?: string[];
+}
+/**
+ * 授权状态检查结果
+ */
+export interface ApprovalStatusResult {
+    /** Owner EOA 地址 */
+    owner: string;
+    /** AA Sender 地址 */
+    sender: string;
+    /** 是否已授权（授权额度 >= 代币余额） */
+    isApproved: boolean;
+    /** 当前授权额度 */
+    currentAllowance: bigint;
+    /** 当前代币余额 */
+    tokenBalance: bigint;
+}
+/**
+ * 深度 Partial 类型
+ */
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+/**
+ * ✅ 仅用于 ERC-4337 AA（EntryPoint.getNonce(sender, 0)）
+ *
+ * 目标：不要在业务代码里手写 `+1/+2` 推导，而是像 BSC bundle 一样用本地 Map
+ * 对“同一 sender 多步流程”连续分配 nonce。
+ *
+ * 注意：
+ * - 这是**同一次 SDK 调用/同一条流程**内的 nonce 分配；不解决多进程/多并发任务同时使用同一 sender 的问题。
+ * - 对“可能不生成 op”的分支（例如 withdraw 返回 null），使用 peek + commit，避免提前消耗 nonce。
+ */
+export declare class AANonceMap {
+    private nextBySenderLower;
+    init(sender: string, startNonce: bigint): void;
+    peek(sender: string): bigint;
+    commit(sender: string, usedNonce: bigint): void;
+    next(sender: string): bigint;
+}
+/**
+ * 必需的配置字段
+ */
+export type RequiredConfig = Required<Pick<XLayerConfig, 'rpcUrl' | 'bundlerUrl' | 'chainId' | 'entryPoint' | 'factory'>>;
+/**
+ * 捆绑买到毕业签名参数
+ */
+export interface BundleGraduateBuyParams {
+    /** 代位地址 */
+    tokenAddress: string;
+    /** 买入钱包私钥数组 */
+    privateKeys: string[];
+    /** AA Payer 私钥 */
+    payerPrivateKey: string;
+    /** 分配模式 */
+    amountMode: 'average' | 'random' | 'custom';
+    /** 平均模式：总买入金额 */
+    totalBuyAmount?: number;
+    /** 随机模式：最小金额 / 最大金额 */
+    minAmount?: number;
+    maxAmount?: number;
+    /** 自定义模式：地址 -> 金额 */
+    walletAmounts?: Record<string, number>;
+    /** 是否启用外盘买入（默认 false） */
+    enableDexBuy?: boolean;
+    /** 内盘钱包地址列表（可选，传入则使用前端分组，不传则 SDK 自动分组） */
+    curveAddresses?: string[];
+    /** 外盘钱包地址列表（可选） */
+    dexAddresses?: string[];
+    /** 动态毕业阈值（可选，不传则使用默认 73.38 OKB） */
+    graduationAmount?: number;
+    /** 配置覆盖 */
+    config?: Partial<XLayerConfig>;
+    /** 扩展数据（传递给 swapExactInputV3，默认 0x） */
+    extensionData?: string;
+    /** Payer 起始 nonce */
+    payerStartNonce?: number;
+    /** beneficiary（默认 payer 地址） */
+    beneficiary?: string;
+}
+/**
+ * 捆绑买到毕业签名结果
+ */
+export interface BundleGraduateBuyResult {
+    /** raw signed tx 列表 */
+    signedTransactions: string[];
+    /** 元数据 */
+    metadata: {
+        curveCount: number;
+        dexCount: number;
+        curveTotalAmount: string;
+        dexTotalAmount: string;
+        tokenAddress: string;
+    };
+}

package/dist/chains/xlayer/eoa/types-core.js

@@ -0,0 +1,53 @@
+/**
+ * XLayer SDK 类型定义
+ *
+ * 包含 ERC-4337 UserOperation、AA 账户、交易参数等核心类型
+ */
+// ==================== AA Nonce（EntryPoint nonce）本地分配器 ====================
+/**
+ * ✅ 仅用于 ERC-4337 AA（EntryPoint.getNonce(sender, 0)）
+ *
+ * 目标：不要在业务代码里手写 `+1/+2` 推导，而是像 BSC bundle 一样用本地 Map
+ * 对“同一 sender 多步流程”连续分配 nonce。
+ *
+ * 注意：
+ * - 这是**同一次 SDK 调用/同一条流程**内的 nonce 分配；不解决多进程/多并发任务同时使用同一 sender 的问题。
+ * - 对“可能不生成 op”的分支（例如 withdraw 返回 null），使用 peek + commit，避免提前消耗 nonce。
+ */
+export class AANonceMap {
+    nextBySenderLower = new Map();
+    init(sender, startNonce) {
+        const k = sender.toLowerCase();
+        const cur = this.nextBySenderLower.get(k);
+        if (cur === undefined || startNonce > cur) {
+            this.nextBySenderLower.set(k, startNonce);
+        }
+    }
+    peek(sender) {
+        const k = sender.toLowerCase();
+        const cur = this.nextBySenderLower.get(k);
+        if (cur === undefined) {
+            throw new Error(`AANonceMap: sender not initialized: ${sender}`);
+        }
+        return cur;
+    }
+    commit(sender, usedNonce) {
+        const k = sender.toLowerCase();
+        const cur = this.nextBySenderLower.get(k);
+        if (cur === undefined) {
+            throw new Error(`AANonceMap: sender not initialized: ${sender}`);
+        }
+        // 只允许“使用当前 nonce”或“重复 commit”（幂等）
+        if (usedNonce !== cur && usedNonce !== cur - 1n) {
+            throw new Error(`AANonceMap: nonce mismatch for ${sender}: used=${usedNonce.toString()} cur=${cur.toString()}`);
+        }
+        if (usedNonce === cur) {
+            this.nextBySenderLower.set(k, cur + 1n);
+        }
+    }
+    next(sender) {
+        const n = this.peek(sender);
+        this.commit(sender, n);
+        return n;
+    }
+}