four-flap-meme-sdk 1.9.48 → 2.0.0

package/dist/xlayer/portal-ops.js

@@ -1,479 +0,0 @@
-/**
- * XLayer Portal 操作核心
- *
- * Flap Portal 内盘交易的核心逻辑：
- * - 买入（swapExactInput: native -> token）
- * - 卖出（swapExactInput: token -> native）
- * - 授权（approve）
- * - 代币转账
- */
-import { ethers, Interface, Contract, JsonRpcProvider } from 'ethers';
-import { FLAP_PORTAL, ZERO_ADDRESS, PORTAL_ABI, ERC20_ABI, MULTICALL3, DEFAULT_RPC_URL, XLAYER_CHAIN_ID, } from './constants.js';
-import { mapWithConcurrency } from '../utils/concurrency.js';
-// ============================================================================
-// Portal 操作编码器
-// ============================================================================
-const portalIface = new Interface(PORTAL_ABI);
-const erc20Iface = new Interface(ERC20_ABI);
-/**
- * 编码买入调用（swapExactInput: native -> token）
- *
- * @param tokenAddress 目标代币地址
- * @param inputAmount 输入 OKB 数量（wei）
- * @param minOutputAmount 最小输出代币数量（默认 0）
- */
-export function encodeBuyCall(tokenAddress, inputAmount, minOutputAmount = 0n) {
-    return portalIface.encodeFunctionData('swapExactInput', [
-        {
-            inputToken: ZERO_ADDRESS,
-            outputToken: tokenAddress,
-            inputAmount,
-            minOutputAmount,
-            permitData: '0x',
-        },
-    ]);
-}
-/**
- * 编码买入调用 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 function encodeBuyCallV3(tokenAddress, inputAmount, minOutputAmount = 0n, extensionData = '0x') {
-    return portalIface.encodeFunctionData('swapExactInputV3', [
-        {
-            inputToken: ZERO_ADDRESS,
-            outputToken: tokenAddress,
-            inputAmount,
-            minOutputAmount,
-            permitData: '0x',
-            extensionData,
-        },
-    ]);
-}
-/**
- * 编码卖出调用（swapExactInput: token -> native）
- *
- * @param tokenAddress 目标代币地址
- * @param inputAmount 输入代币数量
- * @param minOutputAmount 最小输出 OKB 数量（默认 0）
- */
-export function encodeSellCall(tokenAddress, inputAmount, minOutputAmount = 0n) {
-    return portalIface.encodeFunctionData('swapExactInput', [
-        {
-            inputToken: tokenAddress,
-            outputToken: ZERO_ADDRESS,
-            inputAmount,
-            minOutputAmount,
-            permitData: '0x',
-        },
-    ]);
-}
-/**
- * ✅ 编码卖出调用（支持 ERC20 输出）：swapExactInput: token -> quoteToken
- *
- * @param tokenAddress 输入代币地址
- * @param quoteToken 输出代币地址（如 USDT/USDC）
- * @param inputAmount 输入代币数量
- * @param minOutputAmount 最小输出数量（默认 0）
- */
-export function encodeSellCallWithQuote(tokenAddress, quoteToken, inputAmount, minOutputAmount = 0n) {
-    return portalIface.encodeFunctionData('swapExactInput', [
-        {
-            inputToken: tokenAddress,
-            outputToken: quoteToken,
-            inputAmount,
-            minOutputAmount,
-            permitData: '0x',
-        },
-    ]);
-}
-/**
- * ✅ 编码买入调用（支持 ERC20 输入）：swapExactInput: quoteToken -> token
- *
- * @param tokenAddress 输出代币地址
- * @param quoteToken 输入代币地址（如 USDT/USDC）
- * @param inputAmount 输入数量
- * @param minOutputAmount 最小输出代币数量（默认 0）
- */
-export function encodeBuyCallWithQuote(tokenAddress, quoteToken, inputAmount, minOutputAmount = 0n) {
-    return portalIface.encodeFunctionData('swapExactInput', [
-        {
-            inputToken: quoteToken,
-            outputToken: tokenAddress,
-            inputAmount,
-            minOutputAmount,
-            permitData: '0x',
-        },
-    ]);
-}
-/**
- * 编码授权调用
- *
- * @param spender 授权对象地址
- * @param amount 授权数量（默认无限）
- */
-export function encodeApproveCall(spender, amount = ethers.MaxUint256) {
-    return erc20Iface.encodeFunctionData('approve', [spender, amount]);
-}
-/**
- * 编码代币转账调用
- *
- * @param to 接收地址
- * @param amount 转账数量
- */
-export function encodeTransferCall(to, amount) {
-    return erc20Iface.encodeFunctionData('transfer', [to, amount]);
-}
-/**
- * 编码创建代币调用 V2
- */
-export function encodeCreateCallV2(params) {
-    return portalIface.encodeFunctionData('newTokenV2', [params]);
-}
-/**
- * 编码创建代币调用 V3
- */
-export function encodeCreateCallV3(params) {
-    return portalIface.encodeFunctionData('newTokenV3', [params]);
-}
-/**
- * 编码创建代币调用 V4
- */
-export function encodeCreateCallV4(params) {
-    return portalIface.encodeFunctionData('newTokenV4', [params]);
-}
-/**
- * Portal 查询器
- *
- * 提供只读查询方法：
- * - 代币余额
- * - 授权额度
- * - 预览买入/卖出
- * - 代币状态
- */
-export class PortalQuery {
-    constructor(config = {}) {
-        const rpcUrl = config.rpcUrl ?? DEFAULT_RPC_URL;
-        const chainId = config.chainId ?? XLAYER_CHAIN_ID;
-        // ✅ 禁用 ENS: XLayer 不支持 ENS,显式设置 ensAddress: undefined 避免解析错误
-        this.provider = new JsonRpcProvider(rpcUrl, { chainId, name: 'xlayer', ensAddress: undefined }, {
-            batchMaxCount: 20,
-            batchStallTime: 30,
-        });
-        this.portalAddress = config.portalAddress ?? FLAP_PORTAL;
-        this.portal = new Contract(this.portalAddress, PORTAL_ABI, this.provider);
-    }
-    async multicallAggregate3(params) {
-        const mcIface = new Interface([
-            'function aggregate3((address target,bool allowFailure,bytes callData)[] calls) view returns ((bool success,bytes returnData)[] returnData)',
-        ]);
-        const data = mcIface.encodeFunctionData('aggregate3', [params.calls]);
-        const raw = await this.provider.call({ to: MULTICALL3, data });
-        const decoded = mcIface.decodeFunctionResult('aggregate3', raw)?.[0];
-        return decoded || [];
-    }
-    /**
-     * 获取 Provider
-     */
-    getProvider() {
-        return this.provider;
-    }
-    /**
-     * 获取 Portal 地址
-     */
-    getPortalAddress() {
-        return this.portalAddress;
-    }
-    /**
-     * 获取代币余额
-     */
-    async getTokenBalance(tokenAddress, account) {
-        const token = new Contract(tokenAddress, ERC20_ABI, this.provider);
-        return await token.balanceOf(account);
-    }
-    /**
-     * 获取 OKB 余额
-     */
-    async getOkbBalance(account) {
-        return await this.provider.getBalance(account);
-    }
-    /**
-     * 获取授权额度
-     */
-    async getAllowance(tokenAddress, owner, spender) {
-        const token = new Contract(tokenAddress, ERC20_ABI, this.provider);
-        return await token.allowance(owner, spender ?? this.portalAddress);
-    }
-    /**
-     * 检查是否需要授权
-     */
-    async needsApproval(tokenAddress, owner, amount, spender) {
-        const allowance = await this.getAllowance(tokenAddress, owner, spender);
-        return allowance < amount;
-    }
-    /**
-     * 预览买入输出
-     */
-    async previewBuy(tokenAddress, okbAmount) {
-        return await this.portal.previewBuy(tokenAddress, okbAmount);
-    }
-    /**
-     * 预览卖出输出
-     */
-    async previewSell(tokenAddress, tokenAmount) {
-        return await this.portal.previewSell(tokenAddress, tokenAmount);
-    }
-    /**
-     * 使用 quoteExactInput 查询报价
-     */
-    async quoteExactInput(inputToken, outputToken, inputAmount) {
-        return await this.portal.quoteExactInput.staticCall({
-            inputToken,
-            outputToken,
-            inputAmount,
-        });
-    }
-    /**
-     * 获取代币状态 V5
-     */
-    async getTokenV5(tokenAddress) {
-        const raw = await this.portal.getTokenV5(tokenAddress);
-        return {
-            status: raw[0],
-            reserve: raw[1],
-            circulatingSupply: raw[2],
-            price: raw[3],
-            tokenVersion: raw[4],
-            r: raw[5],
-            h: raw[6],
-            k: raw[7],
-            dexSupplyThresh: raw[8],
-            quoteTokenAddress: raw[9],
-            nativeToQuoteSwapEnabled: raw[10],
-            extensionID: raw[11],
-        };
-    }
-    /**
-     * 获取代币状态 V7 (包含 lpFeeProfile)
-     *
-     * ✅ 修复：与 BSC portal.ts 对齐，使用 16 字段结构
-     */
-    async getTokenV7(tokenAddress) {
-        const raw = await this.portal.getTokenV7(tokenAddress);
-        return {
-            status: Number(raw[0]),
-            reserve: raw[1],
-            circulatingSupply: raw[2],
-            price: raw[3],
-            tokenVersion: Number(raw[4]),
-            r: raw[5],
-            h: raw[6],
-            k: raw[7],
-            dexSupplyThresh: raw[8],
-            quoteTokenAddress: raw[9],
-            nativeToQuoteSwapEnabled: raw[10],
-            extensionID: raw[11],
-            taxRate: Number(raw[12]),
-            pool: raw[13],
-            progress: raw[14],
-            lpFeeProfile: Number(raw[15]),
-        };
-    }
-    /**
-     * 批量获取多个账户的代币余额
-     */
-    async getMultipleTokenBalances(tokenAddress, accounts) {
-        const balances = new Map();
-        const list = accounts.map((a) => String(a || '').trim()).filter(Boolean);
-        if (list.length === 0)
-            return balances;
-        const calls = list.map((acc) => ({
-            target: tokenAddress,
-            allowFailure: true,
-            callData: erc20Iface.encodeFunctionData('balanceOf', [acc]),
-        }));
-        const BATCH = 350;
-        try {
-            for (let cursor = 0; cursor < calls.length; cursor += BATCH) {
-                const sliceCalls = calls.slice(cursor, cursor + BATCH);
-                const res = await this.multicallAggregate3({ calls: sliceCalls });
-                for (let i = 0; i < res.length; i++) {
-                    const r = res[i];
-                    const idx = cursor + i;
-                    const acc = list[idx];
-                    if (!r?.success || !r.returnData || r.returnData === '0x') {
-                        balances.set(acc, 0n);
-                        continue;
-                    }
-                    try {
-                        const decoded = erc20Iface.decodeFunctionResult('balanceOf', r.returnData);
-                        balances.set(acc, BigInt(decoded?.[0] ?? 0n));
-                    }
-                    catch {
-                        balances.set(acc, 0n);
-                    }
-                }
-            }
-            return balances;
-        }
-        catch {
-            const results = await mapWithConcurrency(list, 8, async (acc) => this.getTokenBalance(tokenAddress, acc));
-            list.forEach((acc, i) => balances.set(acc, results[i] ?? 0n));
-        }
-        return balances;
-    }
-    /**
-     * 批量获取多个账户的 OKB 余额
-     */
-    async getMultipleOkbBalances(accounts) {
-        const balances = new Map();
-        const list = accounts.map((a) => String(a || '').trim()).filter(Boolean);
-        if (list.length === 0)
-            return balances;
-        const ethBalIface = new Interface(['function getEthBalance(address addr) view returns (uint256)']);
-        const calls = list.map((acc) => ({
-            target: MULTICALL3,
-            allowFailure: true,
-            callData: ethBalIface.encodeFunctionData('getEthBalance', [acc]),
-        }));
-        const BATCH = 350;
-        try {
-            for (let cursor = 0; cursor < calls.length; cursor += BATCH) {
-                const sliceCalls = calls.slice(cursor, cursor + BATCH);
-                const res = await this.multicallAggregate3({ calls: sliceCalls });
-                for (let i = 0; i < res.length; i++) {
-                    const r = res[i];
-                    const idx = cursor + i;
-                    const acc = list[idx];
-                    if (!r?.success || !r.returnData || r.returnData === '0x') {
-                        balances.set(acc, 0n);
-                        continue;
-                    }
-                    try {
-                        const decoded = ethBalIface.decodeFunctionResult('getEthBalance', r.returnData);
-                        balances.set(acc, BigInt(decoded?.[0] ?? 0n));
-                    }
-                    catch {
-                        balances.set(acc, 0n);
-                    }
-                }
-            }
-            return balances;
-        }
-        catch {
-            const results = await mapWithConcurrency(list, 8, async (acc) => this.getOkbBalance(acc));
-            list.forEach((acc, i) => balances.set(acc, results[i] ?? 0n));
-        }
-        return balances;
-    }
-    /**
-     * 批量获取授权额度
-     */
-    async getMultipleAllowances(tokenAddress, owners, spender) {
-        const allowances = new Map();
-        const list = owners.map((a) => String(a || '').trim()).filter(Boolean);
-        if (list.length === 0)
-            return allowances;
-        const useSpender = spender ?? this.portalAddress;
-        const calls = list.map((owner) => ({
-            target: tokenAddress,
-            allowFailure: true,
-            callData: erc20Iface.encodeFunctionData('allowance', [owner, useSpender]),
-        }));
-        const BATCH = 350;
-        try {
-            for (let cursor = 0; cursor < calls.length; cursor += BATCH) {
-                const sliceCalls = calls.slice(cursor, cursor + BATCH);
-                const res = await this.multicallAggregate3({ calls: sliceCalls });
-                for (let i = 0; i < res.length; i++) {
-                    const r = res[i];
-                    const idx = cursor + i;
-                    const owner = list[idx];
-                    if (!r?.success || !r.returnData || r.returnData === '0x') {
-                        allowances.set(owner, 0n);
-                        continue;
-                    }
-                    try {
-                        const decoded = erc20Iface.decodeFunctionResult('allowance', r.returnData);
-                        allowances.set(owner, BigInt(decoded?.[0] ?? 0n));
-                    }
-                    catch {
-                        allowances.set(owner, 0n);
-                    }
-                }
-            }
-            return allowances;
-        }
-        catch {
-            const results = await mapWithConcurrency(list, 8, async (owner) => this.getAllowance(tokenAddress, owner, useSpender));
-            list.forEach((owner, i) => allowances.set(owner, results[i] ?? 0n));
-        }
-        return allowances;
-    }
-}
-// ============================================================================
-// 辅助函数
-// ============================================================================
-/**
- * 计算带滑点的最小输出
- *
- * @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%
-    }
-}
-/**
- * 创建 Portal 查询器
- */
-export function createPortalQuery(config) {
-    return new PortalQuery(config);
-}
-/**
- * 格式化 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/xlayer/router-manager.d.ts

@@ -1,38 +0,0 @@
-/**
- * XLayer Router 管理器
- * 统一管理 V2/V3 Router 地址和授权目标选择逻辑
- */
-import type { RouterVersion, ApprovalTarget } from './types.js';
-/**
- * ✅ 获取 Router 地址
- * @param params.routerVersion - Router 版本（V2 或 V3）
- * @param params.dexKey - DEX 标识（如 DYORSWAP）
- * @param params.routerAddress - 显式指定的 Router 地址（优先级最高）
- * @returns Router 地址
- */
-export declare function getRouterAddress(params: {
-    routerVersion?: RouterVersion;
-    dexKey?: string;
-    routerAddress?: string;
-}): string;
-/**
- * ✅ 获取授权目标地址
- * @param target - 授权目标类型
- * @returns 目标合约地址
- */
-export declare function getApprovalTargetAddress(target: ApprovalTarget): string;
-/**
- * ✅ 获取所有授权目标地址
- * @param targets - 授权目标类型数组
- * @returns 目标信息数组
- */
-export declare function getAllApprovalTargets(targets: ApprovalTarget[]): Array<{
-    target: ApprovalTarget;
-    address: string;
-}>;
-/**
- * ✅ 根据交易类型推断授权目标
- * @param tradeType - 交易类型（FLAP/V2/V3）
- * @returns 授权目标类型
- */
-export declare function inferApprovalTarget(tradeType: string): ApprovalTarget;

package/dist/xlayer/router-manager.js

@@ -1,69 +0,0 @@
-/**
- * XLayer Router 管理器
- * 统一管理 V2/V3 Router 地址和授权目标选择逻辑
- */
-import { POTATOSWAP_V2_ROUTER, POTATOSWAP_V3_ROUTER, FLAP_PORTAL, } from './constants.js';
-/**
- * ✅ 获取 Router 地址
- * @param params.routerVersion - Router 版本（V2 或 V3）
- * @param params.dexKey - DEX 标识（如 DYORSWAP）
- * @param params.routerAddress - 显式指定的 Router 地址（优先级最高）
- * @returns Router 地址
- */
-export function getRouterAddress(params) {
-    // 1. 优先使用显式指定的地址
-    if (params.routerAddress)
-        return params.routerAddress;
-    // 2. 根据 dexKey 选择
-    if (params.dexKey === 'DYORSWAP') {
-        return '0xfb001fbbace32f09cb6d3c449b935183de53ee96';
-    }
-    // 3. 根据 routerVersion 选择
-    const version = params.routerVersion ?? 'V2';
-    if (version === 'V3') {
-        return POTATOSWAP_V3_ROUTER;
-    }
-    // 4. 默认 V2
-    return POTATOSWAP_V2_ROUTER;
-}
-/**
- * ✅ 获取授权目标地址
- * @param target - 授权目标类型
- * @returns 目标合约地址
- */
-export function getApprovalTargetAddress(target) {
-    switch (target) {
-        case 'FLAP_PORTAL':
-            return FLAP_PORTAL;
-        case 'V2_ROUTER':
-            return POTATOSWAP_V2_ROUTER;
-        case 'V3_ROUTER':
-            return POTATOSWAP_V3_ROUTER;
-        default:
-            throw new Error(`Unknown approval target: ${target}`);
-    }
-}
-/**
- * ✅ 获取所有授权目标地址
- * @param targets - 授权目标类型数组
- * @returns 目标信息数组
- */
-export function getAllApprovalTargets(targets) {
-    return targets.map(target => ({
-        target,
-        address: getApprovalTargetAddress(target)
-    }));
-}
-/**
- * ✅ 根据交易类型推断授权目标
- * @param tradeType - 交易类型（FLAP/V2/V3）
- * @returns 授权目标类型
- */
-export function inferApprovalTarget(tradeType) {
-    const type = String(tradeType || '').toUpperCase();
-    if (type === 'V2')
-        return 'V2_ROUTER';
-    if (type === 'V3')
-        return 'V3_ROUTER';
-    return 'FLAP_PORTAL'; // 默认内盘
-}