four-flap-meme-sdk 3.0.0 → 4.0.0

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

@@ -0,0 +1,6 @@
+/**
+ * XLayer SDK — EOA/交易参数与结果类型
+ *
+ * 包含买入/卖出/换手/刷量/DEX 交易/预授权/买到毕业等交易参数与结果类型
+ */
+export {};

package/dist/chains/xlayer/eoa/eoa-wash-volume.d.ts

@@ -9,6 +9,14 @@
  * - 与普通买卖使用相同的代码路径
  *
  * 支持池子类型：V2, V3
+ *
+ * 跨层依赖说明（chains → domains/dex）：
+ * - 依赖 `../../../domains/dex/direct-router.js`（directV2BatchBuy / directV2BatchSell /
+ *   directV3BatchBuy / directV3BatchSell）与 `../../../domains/dex/types.js`
+ *   （DirectRouterSignConfig）。
+ * - 原因：EOA 刷量的本质是「直接调用 DEX Router 做批量买卖」，其路由识别、报价、签名、
+ *   利润刮取全部复用 DEX 层 direct-router 的实现，属于真实业务依赖（非纯函数/常量），
+ *   不宜抽到 core 或 chains 内部，否则会复制一份 DEX 路由逻辑导致双实现漂移。
  */
 import { Wallet } from 'ethers';
 import type { DirectRouterSignConfig } from '../../../domains/dex/types.js';

package/dist/chains/xlayer/eoa/eoa-wash-volume.js

@@ -9,6 +9,14 @@
  * - 与普通买卖使用相同的代码路径
  *
  * 支持池子类型：V2, V3
+ *
+ * 跨层依赖说明（chains → domains/dex）：
+ * - 依赖 `../../../domains/dex/direct-router.js`（directV2BatchBuy / directV2BatchSell /
+ *   directV3BatchBuy / directV3BatchSell）与 `../../../domains/dex/types.js`
+ *   （DirectRouterSignConfig）。
+ * - 原因：EOA 刷量的本质是「直接调用 DEX Router 做批量买卖」，其路由识别、报价、签名、
+ *   利润刮取全部复用 DEX 层 direct-router 的实现，属于真实业务依赖（非纯函数/常量），
+ *   不宜抽到 core 或 chains 内部，否则会复制一份 DEX 路由逻辑导致双实现漂移。
  */
 import { ethers, Wallet, Contract } from 'ethers';
 import { createXLayerProvider } from '../../../utils/provider-factory.js';

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

@@ -0,0 +1,34 @@
+/**
+ * XLayer Portal 操作 — 格式化 / 工具函数（format）
+ */
+/**
+ * 计算带滑点的最小输出
+ *
+ * @param expectedOutput 预期输出
+ * @param slippageBps 滑点基点（如 100 = 1%）
+ */
+export declare function applySlippage(expectedOutput: bigint, slippageBps: number): bigint;
+/**
+ * 将 Portal 的 lpFeeProfile 转换为 V3 Router 所需的 fee (100万分比)
+ *
+ * STANDARD = 0.25% (2500)
+ * LOW = 0.01% (100)
+ * HIGH = 1% (10000)
+ */
+export declare function lpFeeProfileToV3Fee(profile: number): number;
+/**
+ * 格式化 OKB 金额（wei -> OKB 字符串）
+ */
+export declare function formatOkb(wei: bigint): string;
+/**
+ * 解析 OKB 金额（OKB 字符串 -> wei）
+ */
+export declare function parseOkb(okb: string): bigint;
+/**
+ * 格式化代币金额（考虑精度）
+ */
+export declare function formatTokenAmount(amount: bigint, decimals?: number): string;
+/**
+ * 解析代币金额（考虑精度）
+ */
+export declare function parseTokenAmount(amount: string, decimals?: number): bigint;

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

@@ -0,0 +1,56 @@
+/**
+ * XLayer Portal 操作 — 格式化 / 工具函数（format）
+ */
+import { ethers } from 'ethers';
+/**
+ * 计算带滑点的最小输出
+ *
+ * @param expectedOutput 预期输出
+ * @param slippageBps 滑点基点（如 100 = 1%）
+ */
+export function applySlippage(expectedOutput, slippageBps) {
+    const keep = BigInt(10000 - Math.max(0, Math.min(5000, slippageBps)));
+    return (expectedOutput * keep) / 10000n;
+}
+/**
+ * 将 Portal 的 lpFeeProfile 转换为 V3 Router 所需的 fee (100万分比)
+ *
+ * STANDARD = 0.25% (2500)
+ * LOW = 0.01% (100)
+ * HIGH = 1% (10000)
+ */
+export function lpFeeProfileToV3Fee(profile) {
+    switch (profile) {
+        case 1:
+            return 100; // 0.01%
+        case 2:
+            return 10000; // 1%
+        case 0:
+        default:
+            return 2500; // 0.25%
+    }
+}
+/**
+ * 格式化 OKB 金额（wei -> OKB 字符串）
+ */
+export function formatOkb(wei) {
+    return ethers.formatEther(wei);
+}
+/**
+ * 解析 OKB 金额（OKB 字符串 -> wei）
+ */
+export function parseOkb(okb) {
+    return ethers.parseEther(okb);
+}
+/**
+ * 格式化代币金额（考虑精度）
+ */
+export function formatTokenAmount(amount, decimals = 18) {
+    return ethers.formatUnits(amount, decimals);
+}
+/**
+ * 解析代币金额（考虑精度）
+ */
+export function parseTokenAmount(amount, decimals = 18) {
+    return ethers.parseUnits(amount, decimals);
+}

package/dist/chains/xlayer/eoa/hop-chain.d.ts

@@ -0,0 +1,4 @@
+import { Wallet, JsonRpcProvider } from 'ethers';
+import { type DisperseHopPath } from './eoa-bundle-swap-types.js';
+export declare function generateDisperseHopPaths(targetAddresses: string[], hopCount: number, provider: JsonRpcProvider): DisperseHopPath[];
+export declare function buildNativeHopChain(payer: Wallet, path: DisperseHopPath, finalAmount: bigint, gasPrice: bigint, txType: 0 | 2, payerNonce: number): Promise<string[]>;

package/dist/chains/xlayer/eoa/hop-chain.js

@@ -0,0 +1,87 @@
+import { Wallet } from 'ethers';
+import { generateWallets } from '../../../utils/wallet.js';
+import { NATIVE_TRANSFER_GAS_LIMIT, XLAYER_CHAIN_ID } from './eoa-bundle-swap-types.js';
+// ==================== 多跳转账辅助函数 ====================
+export function generateDisperseHopPaths(targetAddresses, hopCount, provider) {
+    if (hopCount <= 0) {
+        return targetAddresses.map((addr) => ({
+            targetAddress: addr,
+            hopWallets: [],
+            hopWalletsInfo: [],
+        }));
+    }
+    return targetAddresses.map((targetAddress) => {
+        const hopWalletsInfo = generateWallets(hopCount);
+        const hopWallets = hopWalletsInfo.map((w) => new Wallet(w.privateKey, provider));
+        return { targetAddress, hopWallets, hopWalletsInfo };
+    });
+}
+export async function buildNativeHopChain(payer, path, finalAmount, gasPrice, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    if (hopCount === 0) {
+        const tx = {
+            to: path.targetAddress,
+            value: finalAmount,
+            nonce: payerNonce,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            chainId: XLAYER_CHAIN_ID,
+            type: txType,
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await payer.signTransaction(tx));
+        return signedTxs;
+    }
+    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
+    const amountsPerHop = [];
+    for (let i = 0; i < hopCount; i++) {
+        const remainingHops = hopCount - i;
+        amountsPerHop.push(finalAmount + hopGasCost * BigInt(remainingHops));
+    }
+    // payer → hop1
+    const firstTx = {
+        to: path.hopWallets[0].address,
+        value: amountsPerHop[0],
+        nonce: payerNonce,
+        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+        chainId: XLAYER_CHAIN_ID,
+        type: txType,
+    };
+    if (txType === 2) {
+        firstTx.maxFeePerGas = gasPrice;
+        firstTx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+    }
+    else {
+        firstTx.gasPrice = gasPrice;
+    }
+    signedTxs.push(await payer.signTransaction(firstTx));
+    // hop1 → hop2 → ... → target
+    for (let i = 0; i < hopCount; i++) {
+        const fromWallet = path.hopWallets[i];
+        const toAddress = i === hopCount - 1 ? path.targetAddress : path.hopWallets[i + 1].address;
+        const amount = i === hopCount - 1 ? finalAmount : amountsPerHop[i + 1];
+        const tx = {
+            to: toAddress,
+            value: amount,
+            nonce: 0,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            chainId: XLAYER_CHAIN_ID,
+            type: txType,
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await fromWallet.signTransaction(tx));
+    }
+    return signedTxs;
+}

package/dist/chains/xlayer/eoa/nonce-map.d.ts

@@ -0,0 +1,20 @@
+/**
+ * XLayer SDK — 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 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;
+}

package/dist/chains/xlayer/eoa/nonce-map.js

@@ -0,0 +1,51 @@
+/**
+ * XLayer SDK — AA Nonce（EntryPoint nonce）本地分配器
+ */
+// ==================== 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;
+    }
+}

package/dist/chains/xlayer/eoa/portal-ops.d.ts

@@ -1,296 +1,13 @@
 /**
- * XLayer Portal 操作核心
+ * XLayer Portal 操作核心 barrel
  *
- * Flap Portal 内盘交易的核心逻辑：
- * - 买入（swapExactInput: native -> token）
- * - 卖出（swapExactInput: token -> native）
- * - 授权（approve）
- * - 代币转账
- */
-import { JsonRpcProvider } from 'ethers';
-/**
- * 编码买入调用（swapExactInput: native -> token）
- *
- * @param tokenAddress 目标代币地址
- * @param inputAmount 输入 OKB 数量（wei）
- * @param minOutputAmount 最小输出代币数量（默认 0）
- */
-export declare function encodeBuyCall(tokenAddress: string, inputAmount: bigint, minOutputAmount?: bigint): string;
-/**
- * 编码买入调用 V3（swapExactInputV3: native -> token，支持 extensionData）
- *
- * 与 BSC 版本的 create-to-dex.ts 保持一致：
- * - 统一优先使用 swapExactInputV3（支持 extensionData；无扩展时传 0x 即可）
- * - 这里的 V3 指"交易接口版本（扩展支持）"，不是"外盘 V3 池子"
- *
- * @param tokenAddress 目标代币地址
- * @param inputAmount 输入 OKB 数量（wei）
- * @param minOutputAmount 最小输出代币数量（默认 0）
- * @param extensionData 扩展数据（默认 0x）
- */
-export declare function encodeBuyCallV3(tokenAddress: string, inputAmount: bigint, minOutputAmount?: bigint, extensionData?: string): string;
-/**
- * 编码卖出调用（swapExactInput: token -> native）
- *
- * @param tokenAddress 目标代币地址
- * @param inputAmount 输入代币数量
- * @param minOutputAmount 最小输出 OKB 数量（默认 0）
- */
-export declare function encodeSellCall(tokenAddress: string, inputAmount: bigint, minOutputAmount?: bigint): string;
-/**
- * ✅ 编码卖出调用（支持 ERC20 输出）：swapExactInput: token -> quoteToken
- *
- * @param tokenAddress 输入代币地址
- * @param quoteToken 输出代币地址（如 USDT/USDC）
- * @param inputAmount 输入代币数量
- * @param minOutputAmount 最小输出数量（默认 0）
- */
-export declare function encodeSellCallWithQuote(tokenAddress: string, quoteToken: string, inputAmount: bigint, minOutputAmount?: bigint): string;
-/**
- * ✅ 编码买入调用（支持 ERC20 输入）：swapExactInput: quoteToken -> token
- *
- * @param tokenAddress 输出代币地址
- * @param quoteToken 输入代币地址（如 USDT/USDC）
- * @param inputAmount 输入数量
- * @param minOutputAmount 最小输出代币数量（默认 0）
- */
-export declare function encodeBuyCallWithQuote(tokenAddress: string, quoteToken: string, inputAmount: bigint, minOutputAmount?: bigint): string;
-/**
- * 编码授权调用
- *
- * @param spender 授权对象地址
- * @param amount 授权数量（默认无限）
- */
-export declare function encodeApproveCall(spender: string, amount?: bigint): string;
-/**
- * 编码代币转账调用
- *
- * @param to 接收地址
- * @param amount 转账数量
- */
-export declare function encodeTransferCall(to: string, amount: bigint): string;
-/**
- * 编码创建代币调用 V2
- */
-export declare function encodeCreateCallV2(params: {
-    name: string;
-    symbol: string;
-    meta: string;
-    dexThresh: number;
-    salt: string;
-    taxRate: number;
-    migratorType: number;
-    quoteToken: string;
-    quoteAmt: bigint;
-    beneficiary: string;
-    permitData: string;
-}): string;
-/**
- * 编码创建代币调用 V3
- */
-export declare function encodeCreateCallV3(params: {
-    name: string;
-    symbol: string;
-    meta: string;
-    dexThresh: number;
-    salt: string;
-    taxRate: number;
-    migratorType: number;
-    quoteToken: string;
-    quoteAmt: bigint;
-    beneficiary: string;
-    permitData: string;
-    extensionID: string;
-    extensionData: string;
-}): string;
-/**
- * 编码创建代币调用 V4
- */
-export declare function encodeCreateCallV4(params: {
-    name: string;
-    symbol: string;
-    meta: string;
-    dexThresh: number;
-    salt: string;
-    taxRate: number;
-    migratorType: number;
-    quoteToken: string;
-    quoteAmt: bigint;
-    beneficiary: string;
-    permitData: string;
-    extensionID: string;
-    extensionData: string;
-    dexId: number;
-    lpFeeProfile: number;
-}): string;
-/**
- * 编码创建代币调用 V5（Tax Token V2 高级税收分配）
- */
-export declare function encodeCreateCallV5(params: {
-    name: string;
-    symbol: string;
-    meta: string;
-    dexThresh: number;
-    salt: string;
-    taxRate: number;
-    migratorType: number;
-    quoteToken: string;
-    quoteAmt: bigint;
-    beneficiary: string;
-    permitData: string;
-    extensionID: string;
-    extensionData: string;
-    dexId: number;
-    lpFeeProfile: number;
-    taxDuration: bigint;
-    antiFarmerDuration: bigint;
-    mktBps: number;
-    deflationBps: number;
-    dividendBps: number;
-    lpBps: number;
-    minimumShareBalance: bigint;
-}): string;
-export interface PortalQueryConfig {
-    rpcUrl?: string;
-    chainId?: number;
-    portalAddress?: string;
-}
-/**
- * Portal 查询器
- *
- * 提供只读查询方法：
- * - 代币余额
- * - 授权额度
- * - 预览买入/卖出
- * - 代币状态
- */
-export declare class PortalQuery {
-    private provider;
-    private portal;
-    private portalAddress;
-    constructor(config?: PortalQueryConfig);
-    private multicallAggregate3;
-    /**
-     * 获取 Provider
-     */
-    getProvider(): JsonRpcProvider;
-    /**
-     * 获取 Portal 地址
-     */
-    getPortalAddress(): string;
-    /**
-     * 获取代币余额
-     */
-    getTokenBalance(tokenAddress: string, account: string): Promise<bigint>;
-    /**
-     * 获取 OKB 余额
-     */
-    getOkbBalance(account: string): Promise<bigint>;
-    /**
-     * 获取授权额度
-     */
-    getAllowance(tokenAddress: string, owner: string, spender?: string): Promise<bigint>;
-    /**
-     * 检查是否需要授权
-     */
-    needsApproval(tokenAddress: string, owner: string, amount: bigint, spender?: string): Promise<boolean>;
-    /**
-     * 预览买入输出
-     */
-    previewBuy(tokenAddress: string, okbAmount: bigint): Promise<bigint>;
-    /**
-     * 预览卖出输出
-     */
-    previewSell(tokenAddress: string, tokenAmount: bigint): Promise<bigint>;
-    /**
-     * 使用 quoteExactInput 查询报价
-     */
-    quoteExactInput(inputToken: string, outputToken: string, inputAmount: bigint): Promise<bigint>;
-    /**
-     * 获取代币状态 V5
-     */
-    getTokenV5(tokenAddress: string): Promise<{
-        status: number;
-        reserve: bigint;
-        circulatingSupply: bigint;
-        price: bigint;
-        tokenVersion: number;
-        r: bigint;
-        h: bigint;
-        k: bigint;
-        dexSupplyThresh: bigint;
-        quoteTokenAddress: string;
-        nativeToQuoteSwapEnabled: boolean;
-        extensionID: string;
-    }>;
-    /**
-     * 获取代币状态 V7 (包含 lpFeeProfile)
-     *
-     * ✅ 修复：与 BSC portal.ts 对齐，使用 16 字段结构
-     */
-    getTokenV7(tokenAddress: string): Promise<{
-        status: number;
-        reserve: bigint;
-        circulatingSupply: bigint;
-        price: bigint;
-        tokenVersion: number;
-        r: bigint;
-        h: bigint;
-        k: bigint;
-        dexSupplyThresh: bigint;
-        quoteTokenAddress: string;
-        nativeToQuoteSwapEnabled: boolean;
-        extensionID: string;
-        taxRate: number;
-        pool: string;
-        progress: bigint;
-        lpFeeProfile: number;
-    }>;
-    /**
-     * 批量获取多个账户的代币余额
-     */
-    getMultipleTokenBalances(tokenAddress: string, accounts: string[]): Promise<Map<string, bigint>>;
-    /**
-     * 批量获取多个账户的 OKB 余额
-     */
-    getMultipleOkbBalances(accounts: string[]): Promise<Map<string, bigint>>;
-    /**
-     * 批量获取授权额度
-     */
-    getMultipleAllowances(tokenAddress: string, owners: string[], spender?: string): Promise<Map<string, bigint>>;
-}
-/**
- * 计算带滑点的最小输出
- *
- * @param expectedOutput 预期输出
- * @param slippageBps 滑点基点（如 100 = 1%）
- */
-export declare function applySlippage(expectedOutput: bigint, slippageBps: number): bigint;
-/**
- * 将 Portal 的 lpFeeProfile 转换为 V3 Router 所需的 fee (100万分比)
+ * 原超长文件按职责拆分为：
+ * - encoders.ts：Portal 操作编码器（买入/卖出/授权/转账/创建代币）
+ * - query.ts：PortalQuery 查询器 + createPortalQuery
+ * - format.ts：格式化 / 工具函数（applySlippage / lpFeeProfileToV3Fee / format / parse）
  *
- * STANDARD = 0.25% (2500)
- * LOW = 0.01% (100)
- * HIGH = 1% (10000)
- */
-export declare function lpFeeProfileToV3Fee(profile: number): number;
-/**
- * 创建 Portal 查询器
- */
-export declare function createPortalQuery(config?: PortalQueryConfig): PortalQuery;
-/**
- * 格式化 OKB 金额（wei -> OKB 字符串）
- */
-export declare function formatOkb(wei: bigint): string;
-/**
- * 解析 OKB 金额（OKB 字符串 -> wei）
- */
-export declare function parseOkb(okb: string): bigint;
-/**
- * 格式化代币金额（考虑精度）
- */
-export declare function formatTokenAmount(amount: bigint, decimals?: number): string;
-/**
- * 解析代币金额（考虑精度）
+ * 对外 export 符号与路径保持不变。
  */
-export declare function parseTokenAmount(amount: string, decimals?: number): bigint;
+export { encodeBuyCall, encodeBuyCallV3, encodeSellCall, encodeSellCallWithQuote, encodeBuyCallWithQuote, encodeApproveCall, encodeTransferCall, encodeCreateCallV2, encodeCreateCallV3, encodeCreateCallV4, encodeCreateCallV5, } from './encoders.js';
+export { PortalQuery, createPortalQuery, type PortalQueryConfig } from './query.js';
+export { applySlippage, lpFeeProfileToV3Fee, formatOkb, parseOkb, formatTokenAmount, parseTokenAmount, } from './format.js';