four-flap-meme-sdk 1.4.91 → 1.4.93

package/dist/xlayer/index.js

@@ -0,0 +1,130 @@
+/**
+ * XLayer SDK
+ *
+ * 完整的 XLayer 链 Flap 内盘交易 SDK
+ *
+ * 功能特性：
+ * - 🔗 基于 ERC-4337 AA 账户抽象
+ * - 📦 捆绑买入/卖出（多地址同一笔 handleOps）
+ * - 🔄 买卖一体化（买入 -> 授权 -> 卖出 -> 归集）
+ * - 📊 刷量/做市（多轮买卖循环）
+ * - 🌐 外盘交易（PotatoSwap DEX）
+ * - 💰 支持 Paymaster（免 Gas）
+ *
+ * 使用示例：
+ *
+ * ```typescript
+ * import {
+ *   bundleBuy,
+ *   bundleSell,
+ *   bundleBuySell,
+ *   makeVolume,
+ *   createBundleExecutor
+ * } from './xlayer';
+ *
+ * // 捆绑买入
+ * const buyResult = await bundleBuy({
+ *   tokenAddress: '0x...',
+ *   privateKeys: ['0x...', '0x...'],
+ *   buyAmounts: ['0.01', '0.02'],
+ * });
+ *
+ * // 捆绑卖出
+ * const sellResult = await bundleSell({
+ *   tokenAddress: '0x...',
+ *   privateKeys: ['0x...', '0x...'],
+ *   sellPercent: 100,
+ *   withdrawToOwner: true,
+ * });
+ *
+ * // 买卖一体化
+ * const buySellResult = await bundleBuySell({
+ *   tokenAddress: '0x...',
+ *   privateKeys: ['0x...', '0x...'],
+ *   buyAmounts: ['0.01', '0.02'],
+ *   sellPercent: 100,
+ *   withdrawToOwner: true,
+ * });
+ *
+ * // 刷量
+ * const volumeResult = await makeVolume({
+ *   tokenAddress: '0x...',
+ *   privateKeys: ['0x...', '0x...'],
+ *   buyAmountPerRound: '0.01',
+ *   rounds: 10,
+ *   intervalMs: 3000,
+ * });
+ * ```
+ */
+// ============================================================================
+// 常量
+// ============================================================================
+export * from './constants.js';
+// ============================================================================
+// 类型
+// ============================================================================
+export * from './types.js';
+// ============================================================================
+// Bundler 客户端
+// ============================================================================
+export { BundlerClient, createBundlerClient, } from './bundler.js';
+// ============================================================================
+// AA 账户管理
+// ============================================================================
+export { AAAccountManager, createAAAccountManager, predictSender, createWallet, encodeExecute, encodeExecuteBatch, 
+// 批量生成钱包工具
+generateAAWallets, generateAAWalletsFromMnemonic, predictSendersFromPrivateKeys, } from './aa-account.js';
+// ============================================================================
+// Portal 操作
+// ============================================================================
+export { encodeBuyCall, encodeSellCall, encodeApproveCall, encodeTransferCall, PortalQuery, createPortalQuery, applySlippage, formatOkb, parseOkb, formatTokenAmount, parseTokenAmount, } from './portal-ops.js';
+// ============================================================================
+// 捆绑交易
+// ============================================================================
+export { BundleExecutor, createBundleExecutor, bundleBuy, bundleSell, bundleBuySell, } from './bundle.js';
+// ============================================================================
+// 刷量/做市
+// ============================================================================
+export { VolumeExecutor, createVolumeExecutor, makeVolume, singleRoundVolume, } from './volume.js';
+// ============================================================================
+// 外盘交易 (DEX)
+// ============================================================================
+export { DexQuery, DexExecutor, createDexQuery, createDexExecutor, quoteOkbToToken, quoteTokenToOkb, 
+// 标准 swap 编码函数
+encodeSwapExactETHForTokens, encodeSwapExactTokensForETH, encodeSwapExactTokensForTokens, 
+// SupportingFeeOnTransferTokens 版本（推荐使用）
+encodeSwapExactETHForTokensSupportingFee, encodeSwapExactTokensForETHSupportingFee, encodeSwapExactTokensForTokensSupportingFee, } from './dex.js';
+// ============================================================================
+// 便捷重导出
+// ============================================================================
+// 将最常用的函数放在默认导出对象中
+export const xlayer = {
+    // 捆绑交易
+    bundleBuy: async (...args) => {
+        const { bundleBuy } = await import('./bundle.js');
+        return bundleBuy(...args);
+    },
+    bundleSell: async (...args) => {
+        const { bundleSell } = await import('./bundle.js');
+        return bundleSell(...args);
+    },
+    bundleBuySell: async (...args) => {
+        const { bundleBuySell } = await import('./bundle.js');
+        return bundleBuySell(...args);
+    },
+    // 刷量
+    makeVolume: async (...args) => {
+        const { makeVolume } = await import('./volume.js');
+        return makeVolume(...args);
+    },
+    // DEX
+    quoteOkbToToken: async (...args) => {
+        const { quoteOkbToToken } = await import('./dex.js');
+        return quoteOkbToToken(...args);
+    },
+    quoteTokenToOkb: async (...args) => {
+        const { quoteTokenToOkb } = await import('./dex.js');
+        return quoteTokenToOkb(...args);
+    },
+};
+export default xlayer;

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

@@ -0,0 +1,152 @@
+/**
+ * XLayer Portal 操作核心
+ *
+ * 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;
+/**
+ * 编码卖出调用（swapExactInput: token -> native）
+ *
+ * @param tokenAddress 目标代币地址
+ * @param inputAmount 输入代币数量
+ * @param minOutputAmount 最小输出 OKB 数量（默认 0）
+ */
+export declare function encodeSellCall(tokenAddress: 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;
+export interface PortalQueryConfig {
+    rpcUrl?: string;
+    chainId?: number;
+    portalAddress?: string;
+}
+/**
+ * Portal 查询器
+ *
+ * 提供只读查询方法：
+ * - 代币余额
+ * - 授权额度
+ * - 预览买入/卖出
+ * - 代币状态
+ */
+export declare class PortalQuery {
+    private provider;
+    private portal;
+    private portalAddress;
+    constructor(config?: PortalQueryConfig);
+    /**
+     * 获取 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;
+    }>;
+    /**
+     * 批量获取多个账户的代币余额
+     */
+    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 查询器
+ */
+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 declare function parseTokenAmount(amount: string, decimals?: number): bigint;

package/dist/xlayer/portal-ops.js

@@ -0,0 +1,239 @@
+/**
+ * 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, DEFAULT_RPC_URL, XLAYER_CHAIN_ID, } from './constants.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',
+        },
+    ]);
+}
+/**
+ * 编码卖出调用（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',
+        },
+    ]);
+}
+/**
+ * 编码授权调用
+ *
+ * @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]);
+}
+/**
+ * Portal 查询器
+ *
+ * 提供只读查询方法：
+ * - 代币余额
+ * - 授权额度
+ * - 预览买入/卖出
+ * - 代币状态
+ */
+export class PortalQuery {
+    constructor(config = {}) {
+        const rpcUrl = config.rpcUrl ?? DEFAULT_RPC_URL;
+        const chainId = config.chainId ?? XLAYER_CHAIN_ID;
+        this.provider = new JsonRpcProvider(rpcUrl, { chainId, name: 'xlayer' });
+        this.portalAddress = config.portalAddress ?? FLAP_PORTAL;
+        this.portal = new Contract(this.portalAddress, PORTAL_ABI, this.provider);
+    }
+    /**
+     * 获取 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],
+        };
+    }
+    /**
+     * 批量获取多个账户的代币余额
+     */
+    async getMultipleTokenBalances(tokenAddress, accounts) {
+        const balances = new Map();
+        const results = await Promise.all(accounts.map((acc) => this.getTokenBalance(tokenAddress, acc)));
+        accounts.forEach((acc, i) => balances.set(acc, results[i]));
+        return balances;
+    }
+    /**
+     * 批量获取多个账户的 OKB 余额
+     */
+    async getMultipleOkbBalances(accounts) {
+        const balances = new Map();
+        const results = await Promise.all(accounts.map((acc) => this.getOkbBalance(acc)));
+        accounts.forEach((acc, i) => balances.set(acc, results[i]));
+        return balances;
+    }
+    /**
+     * 批量获取授权额度
+     */
+    async getMultipleAllowances(tokenAddress, owners, spender) {
+        const allowances = new Map();
+        const results = await Promise.all(owners.map((owner) => this.getAllowance(tokenAddress, owner, spender)));
+        owners.forEach((owner, i) => allowances.set(owner, results[i]));
+        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 查询器
+ */
+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);
+}