four-flap-meme-sdk 2.2.8 → 2.2.11

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

@@ -15,41 +15,59 @@
  */
 export * from './constants.js';
 export * from './types.js';
-export * from './flat-aliases.js';
 export { bigintToBytes, addressToBytes, hexToBytes, trimLeadingZeros, getCachedProvider, clearProviderCache, createWallet, generateRandomWallet, generateRandomWallets, signAuthorization, signAuthorizationWithNonce, signAuthorizationsBatch, buildEIP7702Transaction, estimateGasLimit, estimateGasLimitSimple, calculateProfitAmount, calculateProfitAmountByUserType, calculateProfitAmountByTxCount, getProfitRateBps, getProfitRateBpsDouble, getProfitRecipient, getDeadline, delay, type UserType, type OperationType, } from './utils.js';
-export { bundleBuy } from './bundle-buy.js';
-export { bundleSell } from './bundle-sell.js';
+export { bundleBuy, } from './bundle-buy.js';
+export { bundleSell, } from './bundle-sell.js';
 export { bundleSwap, bundleBatchSwap, bundleMultiSwap, type BundleMultiSwapParams, type BundleMultiSwapResult, } from './bundle-swap.js';
 export { disperse, sweep, pairwiseTransfer, disperseWithHops, sweepWithHops, type DisperseParams, type SweepParams, type PairwiseTransferParams, type PairwiseTransferResult, type TransferResult, } from './multi-hop-transfer.js';
 export { bundleApprove, bundleApproveMultiSpenders, checkApprovalStatus, type BundleApproveMultiSpendersParams, type BundleApproveMultiSpendersResult, } from './bundle-approve.js';
 export { bundleCreateBuy, bundleCreateToDex, bundleGraduateBuy, } from './bundle-create.js';
 export type { TokenInfo, CreateTokenParams, AmountMode, BundleCreateBuyParams, BundleCreateBuyResult, BundleCreateToDexParams, BundleCreateToDexResult, BundleGraduateBuyParams, BundleGraduateBuyResult, } from './types.js';
 export { washVolume, bundleVolume, singleRoundVolume, makeVolume, makeVolumeWithSwap, type VolumeMode, type PoolType, type VolumeProgress, type WashVolumeParams, type WashVolumeResult, type BundleVolumeParams, type BundleVolumeResult, type SingleRoundVolumeResult, type MakeVolumeParams, type MakeVolumeSignResult, type SwapVolumeSignResult, } from './volume.js';
-import { bundleBuy } from './bundle-buy.js';
-import { bundleSell } from './bundle-sell.js';
-import { bundleSwap, bundleBatchSwap, bundleMultiSwap } from './bundle-swap.js';
-import { disperse, sweep, pairwiseTransfer } from './multi-hop-transfer.js';
-import { bundleApprove, checkApprovalStatus } from './bundle-approve.js';
-import { washVolume, bundleVolume, singleRoundVolume, makeVolume, makeVolumeWithSwap } from './volume.js';
-import { bundleCreateBuy, bundleCreateToDex, bundleGraduateBuy } from './bundle-create.js';
 export declare const eip7702: {
-    bundleBuy: typeof bundleBuy;
-    bundleSell: typeof bundleSell;
-    bundleSwap: typeof bundleSwap;
-    bundleBatchSwap: typeof bundleBatchSwap;
-    bundleMultiSwap: typeof bundleMultiSwap;
-    disperse: typeof disperse;
-    sweep: typeof sweep;
-    pairwiseTransfer: typeof pairwiseTransfer;
-    bundleApprove: typeof bundleApprove;
-    checkApprovalStatus: typeof checkApprovalStatus;
-    washVolume: typeof washVolume;
-    bundleVolume: typeof bundleVolume;
-    singleRoundVolume: typeof singleRoundVolume;
-    makeVolume: typeof makeVolume;
-    makeVolumeWithSwap: typeof makeVolumeWithSwap;
-    bundleCreateBuy: typeof bundleCreateBuy;
-    bundleCreateToDex: typeof bundleCreateToDex;
-    bundleGraduateBuy: typeof bundleGraduateBuy;
+    bundleBuy: (params: import("./bundle-buy.js").BundleBuyParams) => Promise<import("./types.js").BundleBuyResult>;
+    bundleSell: (params: import("./bundle-sell.js").BundleSellParams) => Promise<import("./types.js").BundleSellResult>;
+    bundleSwap: (params: import("./bundle-swap.js").BundleSwapParams) => Promise<import("./types.js").BundleSwapResult>;
+    bundleBatchSwap: (params: import("./bundle-swap.js").BundleBatchSwapParams) => Promise<import("./types.js").BundleSwapResult>;
+    bundleMultiSwap: (params: import("./bundle-swap.js").BundleMultiSwapParams) => Promise<import("./bundle-swap.js").BundleMultiSwapResult>;
+    disperse: (params: import("./multi-hop-transfer.js").DisperseParams) => Promise<import("./multi-hop-transfer.js").TransferResult>;
+    sweep: (params: import("./multi-hop-transfer.js").SweepParams) => Promise<import("./multi-hop-transfer.js").TransferResult>;
+    pairwiseTransfer: (params: import("./multi-hop-transfer.js").PairwiseTransferParams) => Promise<import("./multi-hop-transfer.js").PairwiseTransferResult>;
+    bundleApprove: (params: import("./types.js").BundleApproveParams) => Promise<import("./types.js").BundleApproveResult>;
+    checkApprovalStatus: (walletAddresses: string[], tokenAddress: string, spenderAddress: string, config?: import("./types.js").EIP7702Config | undefined, decimals?: number | undefined) => Promise<{
+        address: string;
+        allowance: string;
+        allowanceRaw: string;
+        isApproved: boolean;
+    }[]>;
+    washVolume: (params: import("./volume.js").WashVolumeParams) => Promise<import("./volume.js").WashVolumeResult>;
+    bundleVolume: (params: import("./volume.js").BundleVolumeParams) => Promise<import("./volume.js").BundleVolumeResult>;
+    singleRoundVolume: (params: {
+        privateKeys: string[];
+        tokenAddress: string;
+        tokenDecimals?: number;
+        buyAmountPerWallet: string;
+        sellPercent?: number;
+        tradeType?: import("./types.js").TradeType;
+        routerAddress?: string;
+        fee?: number;
+        config?: import("./types.js").EIP7702Config;
+    }) => Promise<import("./volume.js").SingleRoundVolumeResult>;
+    makeVolume: (params: import("./volume.js").MakeVolumeParams) => Promise<import("./volume.js").MakeVolumeSignResult>;
+    makeVolumeWithSwap: (params: {
+        sellerPrivateKey: string;
+        buyerPrivateKey: string;
+        tokenAddress: string;
+        tokenDecimals?: number;
+        sellAmount: string;
+        hopCount?: number;
+        tradeType?: import("./types.js").TradeType;
+        routerAddress?: string;
+        fee?: number;
+        config?: import("./types.js").EIP7702Config;
+    }) => Promise<import("./volume.js").SwapVolumeSignResult>;
+    bundleCreateBuy: (params: import("./types.js").BundleCreateBuyParams) => Promise<import("./types.js").BundleCreateBuyResult>;
+    bundleCreateToDex: (params: import("./types.js").BundleCreateToDexParams) => Promise<import("./types.js").BundleCreateToDexResult>;
+    bundleGraduateBuy: (params: import("./types.js").BundleGraduateBuyParams) => Promise<import("./types.js").BundleGraduateBuyResult>;
 };
 export default eip7702;

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

@@ -21,7 +21,6 @@ export * from './constants.js';
 // 类型
 // ============================================================================
 export * from './types.js';
-export * from './flat-aliases.js';
 // ============================================================================
 // 工具函数
 // ============================================================================
@@ -33,11 +32,11 @@ calculateProfitAmount, calculateProfitAmountByUserType, calculateProfitAmountByT
 // ============================================================================
 // 批量买入
 // ============================================================================
-export { bundleBuy } from './bundle-buy.js';
+export { bundleBuy, } from './bundle-buy.js';
 // ============================================================================
 // 批量卖出
 // ============================================================================
-export { bundleSell } from './bundle-sell.js';
+export { bundleSell, } from './bundle-sell.js';
 // ============================================================================
 // 捆绑换手
 // ============================================================================
@@ -78,34 +77,88 @@ singleRoundVolume,
 makeVolume, 
 // 换手刷量
 makeVolumeWithSwap, } from './volume.js';
-import { bundleBuy } from './bundle-buy.js';
-import { bundleSell } from './bundle-sell.js';
-import { bundleSwap, bundleBatchSwap, bundleMultiSwap } from './bundle-swap.js';
-import { disperse, sweep, pairwiseTransfer } from './multi-hop-transfer.js';
-import { bundleApprove, checkApprovalStatus } from './bundle-approve.js';
-import { washVolume, bundleVolume, singleRoundVolume, makeVolume, makeVolumeWithSwap } from './volume.js';
-import { bundleCreateBuy, bundleCreateToDex, bundleGraduateBuy } from './bundle-create.js';
 // ============================================================================
 // 便捷导出
 // ============================================================================
 export const eip7702 = {
-    bundleBuy,
-    bundleSell,
-    bundleSwap,
-    bundleBatchSwap,
-    bundleMultiSwap,
-    disperse,
-    sweep,
-    pairwiseTransfer,
-    bundleApprove,
-    checkApprovalStatus,
-    washVolume,
-    bundleVolume,
-    singleRoundVolume,
-    makeVolume,
-    makeVolumeWithSwap,
-    bundleCreateBuy,
-    bundleCreateToDex,
-    bundleGraduateBuy,
+    // 批量买入
+    bundleBuy: async (...args) => {
+        const { bundleBuy } = await import('./bundle-buy.js');
+        return bundleBuy(...args);
+    },
+    // 批量卖出
+    bundleSell: async (...args) => {
+        const { bundleSell } = await import('./bundle-sell.js');
+        return bundleSell(...args);
+    },
+    // 捆绑换手
+    bundleSwap: async (...args) => {
+        const { bundleSwap } = await import('./bundle-swap.js');
+        return bundleSwap(...args);
+    },
+    bundleBatchSwap: async (...args) => {
+        const { bundleBatchSwap } = await import('./bundle-swap.js');
+        return bundleBatchSwap(...args);
+    },
+    bundleMultiSwap: async (...args) => {
+        const { bundleMultiSwap } = await import('./bundle-swap.js');
+        return bundleMultiSwap(...args);
+    },
+    // 转账功能
+    disperse: async (...args) => {
+        const { disperse } = await import('./multi-hop-transfer.js');
+        return disperse(...args);
+    },
+    sweep: async (...args) => {
+        const { sweep } = await import('./multi-hop-transfer.js');
+        return sweep(...args);
+    },
+    pairwiseTransfer: async (...args) => {
+        const { pairwiseTransfer } = await import('./multi-hop-transfer.js');
+        return pairwiseTransfer(...args);
+    },
+    // 批量授权
+    bundleApprove: async (...args) => {
+        const { bundleApprove } = await import('./bundle-approve.js');
+        return bundleApprove(...args);
+    },
+    checkApprovalStatus: async (...args) => {
+        const { checkApprovalStatus } = await import('./bundle-approve.js');
+        return checkApprovalStatus(...args);
+    },
+    // 刷量
+    washVolume: async (...args) => {
+        const { washVolume } = await import('./volume.js');
+        return washVolume(...args);
+    },
+    bundleVolume: async (...args) => {
+        const { bundleVolume } = await import('./volume.js');
+        return bundleVolume(...args);
+    },
+    singleRoundVolume: async (...args) => {
+        const { singleRoundVolume } = await import('./volume.js');
+        return singleRoundVolume(...args);
+    },
+    makeVolume: async (...args) => {
+        const { makeVolume } = await import('./volume.js');
+        return makeVolume(...args);
+    },
+    makeVolumeWithSwap: async (...args) => {
+        const { makeVolumeWithSwap } = await import('./volume.js');
+        return makeVolumeWithSwap(...args);
+    },
+    // 代币创建与发射
+    bundleCreateBuy: async (...args) => {
+        const { bundleCreateBuy } = await import('./bundle-create.js');
+        return bundleCreateBuy(...args);
+    },
+    bundleCreateToDex: async (...args) => {
+        const { bundleCreateToDex } = await import('./bundle-create.js');
+        return bundleCreateToDex(...args);
+    },
+    bundleGraduateBuy: async (...args) => {
+        const { bundleGraduateBuy } = await import('./bundle-create.js');
+        return bundleGraduateBuy(...args);
+    },
 };
 export default eip7702;

package/dist/chains/xlayer/eip7702/multi-hop-transfer.d.ts

@@ -1,7 +1,208 @@
-import { DisperseParams, SweepParams, PairwiseTransferParams, PairwiseTransferResult, TransferResult } from './multi-hop-transfer-helpers.js';
-export type { DisperseParams, SweepParams, PairwiseTransferParams, PairwiseTransferResult, TransferResult, } from './multi-hop-transfer-helpers.js';
+/**
+ * EIP-7702 转账功能
+ *
+ * 支持三种模式：
+ * 1. 分散 (disperse): 一对多分发资金
+ * 2. 归集 (sweep): 多对一收集资金
+ * 3. 多对多 (pairwise): sender[i] → receiver[i] 一一对应转账
+ *
+ * 所有模式都支持：
+ * - 原生 OKB 转账
+ * - ERC20 代币转账
+ * - 可选的多跳混淆
+ *
+ * 只生成签名，由调用方决定如何提交
+ */
+import type { GeneratedWallet, EIP7702Config } from './types.js';
+import { UserType } from './utils.js';
+export interface TransferResult {
+    signedTransaction: string;
+    hopWallets?: GeneratedWallet[];
+    metadata: Record<string, unknown>;
+}
+export interface DisperseParams {
+    /** 资金来源钱包私钥（Token/OKB 从这个钱包转出） */
+    mainPrivateKey: string;
+    /** Payer 钱包私钥（可选，用于支付 gas；不传则使用 mainPrivateKey） */
+    payerPrivateKey?: string;
+    /** 接收者地址列表 */
+    recipients: string[];
+    /** 每个接收者的金额 */
+    amounts: string[];
+    /** 代币地址（不填则为原生 OKB） */
+    tokenAddress?: string;
+    /** 代币精度（默认 18） */
+    tokenDecimals?: number;
+    /** 多跳数量（0=直接转账） */
+    hopCount?: number;
+    /** 用户类型（用于计算利润刮取） */
+    userType?: UserType;
+    /** EIP-7702 配置 */
+    config?: EIP7702Config;
+}
+/**
+ * 分散资金 - 一对多分发
+ *
+ * 支持：原生 OKB / ERC20 代币 + 可选多跳
+ *
+ * 流程（无多跳）：主钱包 → 多个接收者
+ * 流程（有多跳）：主钱包 → hop1 → hop2 → ... → 分发给接收者
+ *
+ * @example
+ * // 原生 OKB 直接分发
+ * const result = await disperse({
+ *   mainPrivateKey: '0x...',
+ *   recipients: ['0xAAA', '0xBBB', '0xCCC'],
+ *   amounts: ['0.1', '0.2', '0.3'],
+ * });
+ *
+ * @example
+ * // 原生 OKB 多跳分发
+ * const result = await disperse({
+ *   mainPrivateKey: '0x...',
+ *   recipients: ['0xAAA', '0xBBB'],
+ *   amounts: ['0.5', '0.5'],
+ *   hopCount: 2,
+ * });
+ *
+ * @example
+ * // ERC20 代币分发
+ * const result = await disperse({
+ *   mainPrivateKey: '0x...',
+ *   recipients: ['0xAAA', '0xBBB'],
+ *   amounts: ['100', '200'],
+ *   tokenAddress: '0xTOKEN...',
+ *   tokenDecimals: 18,
+ *   hopCount: 2,
+ * });
+ */
 export declare function disperse(params: DisperseParams): Promise<TransferResult>;
+export interface SweepParams {
+    /** 目标地址（接收者） */
+    targetAddress: string;
+    /** 源钱包私钥列表 */
+    sourcePrivateKeys: string[];
+    /** Payer 钱包私钥（可选，用于支付 gas；不传则使用第一个源钱包） */
+    payerPrivateKey?: string;
+    /** 代币地址（不填则为原生 OKB） */
+    tokenAddress?: string;
+    /** 代币精度（默认 18） */
+    tokenDecimals?: number;
+    /** 多跳数量（0=直接转账） */
+    hopCount?: number;
+    /** 是否预留 gas 费用（仅原生 OKB） */
+    reserveGas?: boolean;
+    /** 卖出百分比（1-100，默认 100%） */
+    percent?: number;
+    /** 用户类型（用于计算利润刮取） */
+    userType?: UserType;
+    /** EIP-7702 配置 */
+    config?: EIP7702Config;
+}
+/**
+ * 归集资金 - 多对一收集
+ *
+ * 支持：原生 OKB / ERC20 代币 + 可选多跳
+ *
+ * 流程（无多跳）：多个源钱包 → 目标地址
+ * 流程（有多跳）：多个源钱包 → hop1 → hop2 → ... → 目标地址
+ *
+ * @example
+ * // 原生 OKB 直接归集
+ * const result = await sweep({
+ *   targetAddress: '0xTARGET',
+ *   sourcePrivateKeys: ['0x...', '0x...'],
+ * });
+ *
+ * @example
+ * // 原生 OKB 多跳归集
+ * const result = await sweep({
+ *   targetAddress: '0xTARGET',
+ *   sourcePrivateKeys: ['0x...', '0x...'],
+ *   hopCount: 2,
+ * });
+ *
+ * @example
+ * // ERC20 代币归集
+ * const result = await sweep({
+ *   targetAddress: '0xTARGET',
+ *   sourcePrivateKeys: ['0x...', '0x...'],
+ *   tokenAddress: '0xTOKEN...',
+ *   tokenDecimals: 18,
+ *   hopCount: 2,
+ * });
+ */
 export declare function sweep(params: SweepParams): Promise<TransferResult>;
+export interface PairwiseTransferParams {
+    /** 发送者私钥列表 */
+    senderPrivateKeys: string[];
+    /** 接收者地址列表（与 senderPrivateKeys 一一对应） */
+    receiverAddresses: string[];
+    /** Payer 钱包私钥（可选，用于支付 gas；不传则使用第一个发送者钱包） */
+    payerPrivateKey?: string;
+    /** 统一金额（与 amounts 二选一） */
+    amount?: string;
+    /** 每对金额列表（与 amount 二选一） */
+    amounts?: string[];
+    /** 代币地址（不填则为原生 OKB） */
+    tokenAddress?: string;
+    /** 代币精度（默认 18） */
+    tokenDecimals?: number;
+    /** 每对的多跳数量（0=直接转账） */
+    hopCount?: number;
+    /** 用户类型（用于计算利润刮取） */
+    userType?: UserType;
+    /** EIP-7702 配置 */
+    config?: EIP7702Config;
+}
+export interface PairwiseTransferResult {
+    signedTransaction: string;
+    hopWallets?: GeneratedWallet[][];
+    metadata: {
+        pairCount: number;
+        totalAmount: string;
+        profitAmount: string;
+        isNative: boolean;
+        tokenAddress: string | null;
+        hopCount: number;
+        userType?: UserType;
+    };
+}
+/**
+ * 多对多转账 - sender[i] → receiver[i] 一一对应
+ *
+ * 支持：原生 OKB / ERC20 代币 + 可选多跳
+ *
+ * 每对都有独立的多跳链：sender → hop1 → hop2 → ... → receiver
+ *
+ * @example
+ * // 原生 OKB 多对多（直接转账）
+ * const result = await pairwiseTransfer({
+ *   senderPrivateKeys: ['0xA...', '0xB...', '0xC...'],
+ *   receiverAddresses: ['0x111', '0x222', '0x333'],
+ *   amount: '0.1',
+ * });
+ *
+ * @example
+ * // 原生 OKB 多对多（带多跳）
+ * const result = await pairwiseTransfer({
+ *   senderPrivateKeys: ['0xA...', '0xB...'],
+ *   receiverAddresses: ['0x111', '0x222'],
+ *   amounts: ['0.1', '0.2'],
+ *   hopCount: 2, // A → hop1 → hop2 → 111, B → hop3 → hop4 → 222
+ * });
+ *
+ * @example
+ * // ERC20 多对多（带多跳）
+ * const result = await pairwiseTransfer({
+ *   senderPrivateKeys: ['0xA...', '0xB...'],
+ *   receiverAddresses: ['0x111', '0x222'],
+ *   amount: '100',
+ *   tokenAddress: '0xTOKEN...',
+ *   tokenDecimals: 18,
+ *   hopCount: 2,
+ * });
+ */
 export declare function pairwiseTransfer(params: PairwiseTransferParams): Promise<PairwiseTransferResult>;
 /** @deprecated 使用 disperse 替代 */
 export declare const disperseWithHops: typeof disperse;