four-flap-meme-sdk 2.0.0 → 2.2.0

package/dist/chains/xlayer/eip7702/volume/types.d.ts

@@ -1,124 +0,0 @@
-import type { TradeType } from '../types.js';
-import type { EIP7702Config } from '../types.js';
-import type { UserType } from '../utils.js';
-import type { GeneratedWallet } from '../../../../utils/wallet.js';
-export type VolumeMode = 'wash' | 'bundle';
-export type PoolType = 'FLAP' | 'V2' | 'V3';
-export interface VolumeProgress {
-    currentRound: number;
-    totalRounds: number;
-    status: 'pending' | 'running' | 'completed' | 'failed';
-    message?: string;
-}
-export interface WashVolumeParams {
-    /** Payer 钱包私钥（支付 Gas 费） */
-    mainPrivateKey: string;
-    /** 钱包私钥列表（每个钱包独立执行买入+卖出） */
-    privateKeys: string[];
-    /** 代币地址 */
-    tokenAddress: string;
-    /** 代币精度 */
-    tokenDecimals?: number;
-    /** 每个钱包的买入金额 (OKB) */
-    buyAmountPerWallet: string;
-    /** 卖出百分比（1-100） */
-    sellPercent?: number;
-    /** 池子类型 */
-    poolType?: PoolType;
-    /** 路由地址（V2/V3 模式） */
-    routerAddress?: string;
-    /** V3 费率 */
-    fee?: number;
-    /** 用户类型（影响利润率） */
-    userType?: UserType;
-    /** EIP-7702 配置 */
-    config?: EIP7702Config;
-}
-export interface WashVolumeResult {
-    signedTransaction: string;
-    metadata: {
-        walletCount: number;
-        buyAmountPerWallet: string;
-        totalBuyAmount: string;
-        sellPercent: number;
-        poolType: PoolType;
-        profitAmount: string;
-    };
-}
-export interface BundleVolumeParams {
-    /** Payer 钱包私钥（支付 Gas 费） */
-    mainPrivateKey: string;
-    /** 买入钱包私钥列表 */
-    buyerPrivateKeys: string[];
-    /** 每个买家的买入金额 (OKB) */
-    buyAmounts: string[];
-    /** 卖出钱包私钥列表 */
-    sellerPrivateKeys: string[];
-    /** 每个卖家的卖出数量（代币）或百分比 */
-    sellAmounts?: string[];
-    /** 卖出百分比（当 sellAmounts 未提供时使用） */
-    sellPercent?: number;
-    /** 代币地址 */
-    tokenAddress: string;
-    /** 代币精度 */
-    tokenDecimals?: number;
-    /** 池子类型 */
-    poolType?: PoolType;
-    /** 路由地址 */
-    routerAddress?: string;
-    /** V3 费率 */
-    fee?: number;
-    /** 用户类型（影响利润率） */
-    userType?: UserType;
-    /** EIP-7702 配置 */
-    config?: EIP7702Config;
-}
-export interface BundleVolumeResult {
-    signedTransaction: string;
-    metadata: {
-        buyerCount: number;
-        sellerCount: number;
-        totalBuyAmount: string;
-        totalSellAmount: string;
-        poolType: PoolType;
-        profitAmount: string;
-    };
-}
-export interface SingleRoundVolumeResult {
-    buySignedTransaction: string;
-    sellSignedTransaction: string;
-    metadata: {
-        buyAmount: string;
-        sellPercent: number;
-        walletCount: number;
-    };
-}
-export interface MakeVolumeParams {
-    privateKeys: string[];
-    tokenAddress: string;
-    tokenDecimals?: number;
-    buyAmountPerRound: string;
-    rounds: number;
-    tradeType?: TradeType;
-    routerAddress?: string;
-    fee?: number;
-    onProgress?: (progress: VolumeProgress) => void;
-    config?: EIP7702Config;
-}
-export interface MakeVolumeSignResult {
-    rounds: SingleRoundVolumeResult[];
-    metadata: {
-        totalRounds: number;
-        totalBuyAmount: string;
-        walletCount: number;
-    };
-}
-export interface SwapVolumeSignResult {
-    signedTransaction: string;
-    hopWallets: GeneratedWallet[];
-    metadata: {
-        sellerAddress: string;
-        buyerAddress: string;
-        sellAmount: string;
-    };
-}

package/dist/chains/xlayer/eip7702/volume/types.js

@@ -1 +0,0 @@
-export {};

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

@@ -1,363 +0,0 @@
-/**
- * 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

@@ -1,53 +0,0 @@
-/**
- * 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;
-    }
-}