four-flap-meme-sdk 1.4.90 → 1.4.92

package/dist/xlayer/dex.js

@@ -0,0 +1,335 @@
+/**
+ * XLayer 外盘交易 SDK
+ *
+ * 通过 PotatoSwap 进行外盘交易：
+ * - V2 Router 交易
+ * - 支持 OKB/Token 双向交换
+ * - 通过 AA 账户执行
+ */
+import { ethers, Contract, Interface, JsonRpcProvider } from 'ethers';
+import { POTATOSWAP_V2_ROUTER, POTATOSWAP_V2_ROUTER_ABI, WOKB, DEFAULT_RPC_URL, XLAYER_CHAIN_ID, ERC20_ABI, } from './constants.js';
+import { AAAccountManager, encodeExecute, createWallet } from './aa-account.js';
+import { encodeApproveCall, parseOkb } from './portal-ops.js';
+// ============================================================================
+// DEX 交易编码器
+// ============================================================================
+const routerIface = new Interface(POTATOSWAP_V2_ROUTER_ABI);
+/**
+ * 编码 swapExactETHForTokens 调用
+ */
+export function encodeSwapExactETHForTokens(amountOutMin, path, to, deadline) {
+    return routerIface.encodeFunctionData('swapExactETHForTokens', [
+        amountOutMin,
+        path,
+        to,
+        deadline,
+    ]);
+}
+/**
+ * 编码 swapExactETHForTokensSupportingFeeOnTransferTokens 调用
+ * 推荐使用：支持有手续费/分红机制的代币
+ */
+export function encodeSwapExactETHForTokensSupportingFee(amountOutMin, path, to, deadline) {
+    return routerIface.encodeFunctionData('swapExactETHForTokensSupportingFeeOnTransferTokens', [
+        amountOutMin,
+        path,
+        to,
+        deadline,
+    ]);
+}
+/**
+ * 编码 swapExactTokensForETH 调用
+ */
+export function encodeSwapExactTokensForETH(amountIn, amountOutMin, path, to, deadline) {
+    return routerIface.encodeFunctionData('swapExactTokensForETH', [
+        amountIn,
+        amountOutMin,
+        path,
+        to,
+        deadline,
+    ]);
+}
+/**
+ * 编码 swapExactTokensForETHSupportingFeeOnTransferTokens 调用
+ * 推荐使用：支持有手续费/分红机制的代币
+ */
+export function encodeSwapExactTokensForETHSupportingFee(amountIn, amountOutMin, path, to, deadline) {
+    return routerIface.encodeFunctionData('swapExactTokensForETHSupportingFeeOnTransferTokens', [
+        amountIn,
+        amountOutMin,
+        path,
+        to,
+        deadline,
+    ]);
+}
+/**
+ * 编码 swapExactTokensForTokens 调用
+ */
+export function encodeSwapExactTokensForTokens(amountIn, amountOutMin, path, to, deadline) {
+    return routerIface.encodeFunctionData('swapExactTokensForTokens', [
+        amountIn,
+        amountOutMin,
+        path,
+        to,
+        deadline,
+    ]);
+}
+/**
+ * 编码 swapExactTokensForTokensSupportingFeeOnTransferTokens 调用
+ * 推荐使用：支持有手续费/分红机制的代币
+ */
+export function encodeSwapExactTokensForTokensSupportingFee(amountIn, amountOutMin, path, to, deadline) {
+    return routerIface.encodeFunctionData('swapExactTokensForTokensSupportingFeeOnTransferTokens', [
+        amountIn,
+        amountOutMin,
+        path,
+        to,
+        deadline,
+    ]);
+}
+/**
+ * DEX 交易查询器
+ */
+export class DexQuery {
+    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.routerAddress = config.routerAddress ?? POTATOSWAP_V2_ROUTER;
+        this.wokb = config.wokbAddress ?? WOKB;
+        this.router = new Contract(this.routerAddress, POTATOSWAP_V2_ROUTER_ABI, this.provider);
+    }
+    /**
+     * 获取交易路径的输出金额
+     */
+    async getAmountsOut(amountIn, path) {
+        const amounts = await this.router.getAmountsOut(amountIn, path);
+        return amounts.map((a) => BigInt(a));
+    }
+    /**
+     * 获取交易路径的输入金额
+     */
+    async getAmountsIn(amountOut, path) {
+        const amounts = await this.router.getAmountsIn(amountOut, path);
+        return amounts.map((a) => BigInt(a));
+    }
+    /**
+     * 获取 OKB -> Token 的预期输出
+     */
+    async quoteOkbToToken(okbAmount, tokenAddress) {
+        const path = [this.wokb, tokenAddress];
+        const amounts = await this.getAmountsOut(okbAmount, path);
+        return amounts[amounts.length - 1];
+    }
+    /**
+     * 获取 Token -> OKB 的预期输出
+     */
+    async quoteTokenToOkb(tokenAmount, tokenAddress) {
+        const path = [tokenAddress, this.wokb];
+        const amounts = await this.getAmountsOut(tokenAmount, path);
+        return amounts[amounts.length - 1];
+    }
+    /**
+     * 获取 WOKB 地址
+     */
+    getWokbAddress() {
+        return this.wokb;
+    }
+    /**
+     * 获取 Router 地址
+     */
+    getRouterAddress() {
+        return this.routerAddress;
+    }
+}
+/**
+ * DEX 交易执行器
+ *
+ * 通过 AA 账户在 PotatoSwap 上进行交易
+ */
+export class DexExecutor {
+    constructor(config = {}) {
+        this.config = config;
+        this.aaManager = new AAAccountManager(config);
+        this.dexQuery = new DexQuery(config);
+        this.routerAddress = config.routerAddress ?? POTATOSWAP_V2_ROUTER;
+        this.wokb = config.wokbAddress ?? WOKB;
+        this.deadlineMinutes = config.deadlineMinutes ?? 20;
+    }
+    /**
+     * 获取 deadline 时间戳
+     */
+    getDeadline() {
+        return Math.floor(Date.now() / 1000) + this.deadlineMinutes * 60;
+    }
+    /**
+     * OKB -> Token 交易（通过 EOA 直接执行）
+     * 使用 SupportingFeeOnTransferTokens 版本，支持有手续费/分红的代币
+     */
+    async swapOkbForToken(privateKey, tokenAddress, okbAmount, minTokenAmount = 0n) {
+        const wallet = createWallet(privateKey, this.config);
+        const router = new Contract(this.routerAddress, POTATOSWAP_V2_ROUTER_ABI, wallet);
+        const path = [this.wokb, tokenAddress];
+        const deadline = this.getDeadline();
+        const tx = await router.swapExactETHForTokensSupportingFeeOnTransferTokens(minTokenAmount, path, wallet.address, deadline, { value: okbAmount });
+        const receipt = await tx.wait();
+        return {
+            txHash: tx.hash,
+            inputAmount: okbAmount,
+            outputAmount: 0n, // 需要从事件中解析
+            gasUsed: receipt.gasUsed,
+        };
+    }
+    /**
+     * Token -> OKB 交易（通过 EOA 直接执行）
+     * 使用 SupportingFeeOnTransferTokens 版本，支持有手续费/分红的代币
+     */
+    async swapTokenForOkb(privateKey, tokenAddress, tokenAmount, minOkbAmount = 0n) {
+        const wallet = createWallet(privateKey, this.config);
+        const token = new Contract(tokenAddress, ERC20_ABI, wallet);
+        const router = new Contract(this.routerAddress, POTATOSWAP_V2_ROUTER_ABI, wallet);
+        // 检查并授权
+        const allowance = await token.allowance(wallet.address, this.routerAddress);
+        if (allowance < tokenAmount) {
+            console.log('授权 Router...');
+            const approveTx = await token.approve(this.routerAddress, ethers.MaxUint256);
+            await approveTx.wait();
+        }
+        const path = [tokenAddress, this.wokb];
+        const deadline = this.getDeadline();
+        const tx = await router.swapExactTokensForETHSupportingFeeOnTransferTokens(tokenAmount, minOkbAmount, path, wallet.address, deadline);
+        const receipt = await tx.wait();
+        return {
+            txHash: tx.hash,
+            inputAmount: tokenAmount,
+            outputAmount: 0n,
+            gasUsed: receipt.gasUsed,
+        };
+    }
+    /**
+     * 通过 AA 账户执行 OKB -> Token 交易
+     * 使用 SupportingFeeOnTransferTokens 版本，支持有手续费/分红的代币
+     */
+    async swapOkbForTokenViaAA(privateKey, tokenAddress, okbAmount, minTokenAmount = 0n) {
+        const wallet = createWallet(privateKey, this.config);
+        const accountInfo = await this.aaManager.getAccountInfo(wallet.address);
+        const path = [this.wokb, tokenAddress];
+        const deadline = this.getDeadline();
+        // 构建 swapExactETHForTokensSupportingFeeOnTransferTokens calldata
+        const swapData = encodeSwapExactETHForTokensSupportingFee(minTokenAmount, path, accountInfo.sender, // 代币接收地址为 sender
+        deadline);
+        // 通过 execute 调用 router
+        const callData = encodeExecute(this.routerAddress, okbAmount, swapData);
+        // 确保 sender 有足够余额
+        await this.aaManager.ensureSenderBalance(wallet, accountInfo.sender, okbAmount + parseOkb('0.001'), 'dex-swap-prefund');
+        // 构建并签名 UserOp
+        const signedOp = await this.aaManager.buildAndSignUserOp({
+            ownerWallet: wallet,
+            callData,
+            value: okbAmount,
+        });
+        // 执行 handleOps
+        const provider = this.aaManager.getProvider();
+        const entryPoint = this.aaManager.getEntryPoint();
+        const feeData = await provider.getFeeData();
+        // 使用新 Contract 实例避免 TypeScript 类型问题
+        const entryPointWithSigner = new Contract(await entryPoint.getAddress(), ['function handleOps((address sender,uint256 nonce,bytes initCode,bytes callData,uint256 callGasLimit,uint256 verificationGasLimit,uint256 preVerificationGas,uint256 maxFeePerGas,uint256 maxPriorityFeePerGas,bytes paymasterAndData,bytes signature)[] ops, address payable beneficiary) external'], wallet);
+        const tx = await entryPointWithSigner.handleOps([signedOp.userOp], wallet.address, { gasPrice: feeData.gasPrice ?? 100000000n });
+        const receipt = await tx.wait();
+        return {
+            txHash: tx.hash,
+            inputAmount: okbAmount,
+            outputAmount: 0n,
+            gasUsed: receipt.gasUsed,
+        };
+    }
+    /**
+     * 通过 AA 账户执行 Token -> OKB 交易
+     */
+    async swapTokenForOkbViaAA(privateKey, tokenAddress, tokenAmount, minOkbAmount = 0n) {
+        const wallet = createWallet(privateKey, this.config);
+        const accountInfo = await this.aaManager.getAccountInfo(wallet.address);
+        const provider = this.aaManager.getProvider();
+        const entryPoint = this.aaManager.getEntryPoint();
+        const feeData = await provider.getFeeData();
+        const path = [tokenAddress, this.wokb];
+        const deadline = this.getDeadline();
+        // 检查授权
+        const token = new Contract(tokenAddress, ERC20_ABI, provider);
+        const allowance = await token.allowance(accountInfo.sender, this.routerAddress);
+        const ops = [];
+        let nonce = accountInfo.nonce;
+        // 如果需要授权
+        if (allowance < tokenAmount) {
+            const approveData = encodeApproveCall(this.routerAddress);
+            const approveCallData = encodeExecute(tokenAddress, 0n, approveData);
+            const approveOp = await this.aaManager.buildUserOpWithLocalEstimate({
+                ownerWallet: wallet,
+                sender: accountInfo.sender,
+                callData: approveCallData,
+                nonce,
+            });
+            const signedApprove = await this.aaManager.signUserOp(approveOp.userOp, wallet);
+            ops.push(signedApprove.userOp);
+            nonce = nonce + 1n;
+        }
+        // 构建 swap calldata（使用 SupportingFeeOnTransferTokens 版本）
+        const swapData = encodeSwapExactTokensForETHSupportingFee(tokenAmount, minOkbAmount, path, accountInfo.sender, deadline);
+        const swapCallData = encodeExecute(this.routerAddress, 0n, swapData);
+        // 确保 sender 有足够的 gas 费
+        await this.aaManager.ensureSenderBalance(wallet, accountInfo.sender, parseOkb('0.001'), 'dex-swap-gas');
+        const swapOp = await this.aaManager.buildUserOpWithLocalEstimate({
+            ownerWallet: wallet,
+            sender: accountInfo.sender,
+            callData: swapCallData,
+            nonce,
+        });
+        const signedSwap = await this.aaManager.signUserOp(swapOp.userOp, wallet);
+        ops.push(signedSwap.userOp);
+        // 执行（使用新 Contract 实例避免 TypeScript 类型问题）
+        const entryPointWithSigner = new Contract(await entryPoint.getAddress(), ['function handleOps((address sender,uint256 nonce,bytes initCode,bytes callData,uint256 callGasLimit,uint256 verificationGasLimit,uint256 preVerificationGas,uint256 maxFeePerGas,uint256 maxPriorityFeePerGas,bytes paymasterAndData,bytes signature)[] ops, address payable beneficiary) external'], wallet);
+        const tx = await entryPointWithSigner.handleOps(ops, wallet.address, { gasPrice: feeData.gasPrice ?? 100000000n });
+        const receipt = await tx.wait();
+        return {
+            txHash: tx.hash,
+            inputAmount: tokenAmount,
+            outputAmount: 0n,
+            gasUsed: receipt.gasUsed,
+        };
+    }
+    /**
+     * 获取 DEX 查询器
+     */
+    getDexQuery() {
+        return this.dexQuery;
+    }
+}
+// ============================================================================
+// 便捷函数
+// ============================================================================
+/**
+ * 创建 DEX 查询器
+ */
+export function createDexQuery(config) {
+    return new DexQuery(config);
+}
+/**
+ * 创建 DEX 执行器
+ */
+export function createDexExecutor(config) {
+    return new DexExecutor(config);
+}
+/**
+ * 快速获取 OKB -> Token 报价
+ */
+export async function quoteOkbToToken(okbAmount, tokenAddress, config) {
+    const query = createDexQuery(config);
+    return query.quoteOkbToToken(okbAmount, tokenAddress);
+}
+/**
+ * 快速获取 Token -> OKB 报价
+ */
+export async function quoteTokenToOkb(tokenAmount, tokenAddress, config) {
+    const query = createDexQuery(config);
+    return query.quoteTokenToOkb(tokenAmount, tokenAddress);
+}

package/dist/xlayer/examples/bundle-buy-sell.d.ts

@@ -0,0 +1,11 @@
+/**
+ * XLayer SDK 使用示例：捆绑买卖
+ *
+ * 演示如何使用 SDK 进行 Flap 内盘交易
+ *
+ * 运行前请确保：
+ * 1. 在 .env 文件中配置 OWNER_PRIVATE_KEY 和 OWNER_PRIVATE_KEY2
+ * 2. 配置 FLAP_TOKEN 为目标代币地址
+ * 3. 确保 owner 钱包有足够的 OKB
+ */
+export {};

package/dist/xlayer/examples/bundle-buy-sell.js

@@ -0,0 +1,194 @@
+/**
+ * XLayer SDK 使用示例：捆绑买卖
+ *
+ * 演示如何使用 SDK 进行 Flap 内盘交易
+ *
+ * 运行前请确保：
+ * 1. 在 .env 文件中配置 OWNER_PRIVATE_KEY 和 OWNER_PRIVATE_KEY2
+ * 2. 配置 FLAP_TOKEN 为目标代币地址
+ * 3. 确保 owner 钱包有足够的 OKB
+ */
+import { bundleBuy, bundleSell, bundleBuySell, makeVolume, createBundleExecutor, createAAAccountManager, predictSender, parseOkb, formatOkb, QUIKNODE_RPC_URL, } from '../index.js';
+// 配置
+const config = {
+    rpcUrl: QUIKNODE_RPC_URL, // 使用付费 RPC 获得更好的性能
+    // paymaster: '0x...', // 如果有 Paymaster，指定后不需要往 AA 地址转手续费
+};
+// 从环境变量读取私钥
+const OWNER_PRIVATE_KEY = process.env.OWNER_PRIVATE_KEY;
+const OWNER_PRIVATE_KEY2 = process.env.OWNER_PRIVATE_KEY2;
+const FLAP_TOKEN = process.env.FLAP_TOKEN;
+/**
+ * 示例 1: 查看 AA 账户信息
+ */
+async function example1_getAccountInfo() {
+    console.log('\n=== 示例 1: 查看 AA 账户信息 ===\n');
+    const aaManager = createAAAccountManager(config);
+    // 从私钥获取 owner 地址
+    const { Wallet } = await import('ethers');
+    const owner1 = new Wallet(OWNER_PRIVATE_KEY);
+    const owner2 = new Wallet(OWNER_PRIVATE_KEY2);
+    // 预测 sender 地址
+    const sender1 = await predictSender(owner1.address, config);
+    const sender2 = await predictSender(owner2.address, config);
+    console.log('Owner 1:', owner1.address);
+    console.log('Sender 1 (AA):', sender1);
+    console.log('\nOwner 2:', owner2.address);
+    console.log('Sender 2 (AA):', sender2);
+    // 获取完整账户信息
+    const info1 = await aaManager.getAccountInfo(owner1.address);
+    const info2 = await aaManager.getAccountInfo(owner2.address);
+    console.log('\n账户 1 信息:');
+    console.log('- 已部署:', info1.deployed);
+    console.log('- 余额:', formatOkb(info1.balance), 'OKB');
+    console.log('- Nonce:', info1.nonce.toString());
+    console.log('\n账户 2 信息:');
+    console.log('- 已部署:', info2.deployed);
+    console.log('- 余额:', formatOkb(info2.balance), 'OKB');
+    console.log('- Nonce:', info2.nonce.toString());
+}
+/**
+ * 示例 2: 捆绑买入
+ */
+async function example2_bundleBuy() {
+    console.log('\n=== 示例 2: 捆绑买入 ===\n');
+    const result = await bundleBuy({
+        tokenAddress: FLAP_TOKEN,
+        privateKeys: [OWNER_PRIVATE_KEY, OWNER_PRIVATE_KEY2],
+        buyAmounts: ['0.001', '0.001'], // 每个地址买入 0.001 OKB
+        transferBackToOwner: false, // 代币保留在 sender
+        config,
+    });
+    console.log('买入交易哈希:', result.buyResult.txHash);
+    console.log('区块号:', result.buyResult.blockNumber);
+    // 显示代币余额
+    console.log('\n代币余额:');
+    for (const [sender, balance] of result.tokenBalances) {
+        console.log(`- ${sender}: ${balance.toString()}`);
+    }
+}
+/**
+ * 示例 3: 捆绑卖出
+ */
+async function example3_bundleSell() {
+    console.log('\n=== 示例 3: 捆绑卖出 ===\n');
+    const result = await bundleSell({
+        tokenAddress: FLAP_TOKEN,
+        privateKeys: [OWNER_PRIVATE_KEY, OWNER_PRIVATE_KEY2],
+        sellPercent: 100, // 卖出全部
+        withdrawToOwner: true, // 将 OKB 归集回 owner
+        withdrawReserve: '0.00005', // 保留少量在 sender
+        config,
+    });
+    if (result.approveResult) {
+        console.log('授权交易哈希:', result.approveResult.txHash);
+    }
+    console.log('卖出交易哈希:', result.sellResult.txHash);
+    if (result.withdrawResult) {
+        console.log('归集交易哈希:', result.withdrawResult.txHash);
+    }
+}
+/**
+ * 示例 4: 买卖一体化（先买后卖）
+ */
+async function example4_bundleBuySell() {
+    console.log('\n=== 示例 4: 买卖一体化 ===\n');
+    const result = await bundleBuySell({
+        tokenAddress: FLAP_TOKEN,
+        privateKeys: [OWNER_PRIVATE_KEY, OWNER_PRIVATE_KEY2],
+        buyAmounts: ['0.001', '0.001'],
+        sellPercent: 100,
+        withdrawToOwner: true,
+        withdrawReserve: '0.00005',
+        config,
+    });
+    console.log('买入交易:', result.buyResult.txHash);
+    console.log('卖出交易:', result.sellResult.txHash);
+    if (result.withdrawResult) {
+        console.log('归集交易:', result.withdrawResult.txHash);
+    }
+    console.log('\n最终余额:');
+    for (const [sender, balance] of result.finalBalances) {
+        console.log(`- ${sender}: ${formatOkb(balance)} OKB`);
+    }
+}
+/**
+ * 示例 5: 刷量
+ */
+async function example5_makeVolume() {
+    console.log('\n=== 示例 5: 刷量 ===\n');
+    const result = await makeVolume({
+        tokenAddress: FLAP_TOKEN,
+        privateKeys: [OWNER_PRIVATE_KEY, OWNER_PRIVATE_KEY2],
+        buyAmountPerRound: '0.001',
+        rounds: 3, // 3 轮
+        intervalMs: 3000, // 每轮间隔 3 秒
+        sellImmediately: true,
+        config,
+    });
+    console.log('成功轮数:', result.successRounds);
+    console.log('失败轮数:', result.failedRounds);
+    console.log('总交易量:', formatOkb(result.totalVolume), 'OKB');
+}
+/**
+ * 示例 6: 使用 Paymaster（免 Gas）
+ */
+async function example6_withPaymaster() {
+    console.log('\n=== 示例 6: 使用 Paymaster ===\n');
+    // 配置 Paymaster 后，不需要往 AA 地址转手续费
+    const paymasterConfig = {
+        ...config,
+        paymaster: '0x...', // 替换为实际的 Paymaster 地址
+        paymasterData: '0x', // 可选的 Paymaster 数据
+    };
+    const executor = createBundleExecutor(paymasterConfig);
+    // 使用 Paymaster 执行交易
+    // sender 只需要买入金额，不需要额外的 gas 费
+    console.log('使用 Paymaster 后，sender 不需要预先充值 gas 费');
+}
+/**
+ * 示例 7: 高级用法 - 手动构建 UserOp
+ */
+async function example7_advancedUsage() {
+    console.log('\n=== 示例 7: 高级用法 ===\n');
+    const executor = createBundleExecutor(config);
+    const aaManager = executor.getAAManager();
+    const portalQuery = executor.getPortalQuery();
+    // 获取代币状态
+    const tokenState = await portalQuery.getTokenV5(FLAP_TOKEN);
+    console.log('代币状态:', tokenState.status);
+    console.log('储备:', formatOkb(tokenState.reserve), 'OKB');
+    console.log('流通量:', tokenState.circulatingSupply.toString());
+    // 预览买入
+    const buyPreview = await portalQuery.previewBuy(FLAP_TOKEN, parseOkb('0.01'));
+    console.log('买入 0.01 OKB 预计获得:', buyPreview.toString(), '代币');
+    // 预览卖出
+    const sellPreview = await portalQuery.previewSell(FLAP_TOKEN, parseOkb('1000'));
+    console.log('卖出 1000 代币预计获得:', formatOkb(sellPreview), 'OKB');
+}
+// 主函数
+async function main() {
+    console.log('XLayer SDK 使用示例');
+    console.log('==================\n');
+    if (!OWNER_PRIVATE_KEY || !OWNER_PRIVATE_KEY2 || !FLAP_TOKEN) {
+        console.error('请先配置环境变量:');
+        console.error('- OWNER_PRIVATE_KEY');
+        console.error('- OWNER_PRIVATE_KEY2');
+        console.error('- FLAP_TOKEN');
+        process.exit(1);
+    }
+    try {
+        // 取消注释以运行对应的示例
+        await example1_getAccountInfo();
+        // await example2_bundleBuy();
+        // await example3_bundleSell();
+        // await example4_bundleBuySell();
+        // await example5_makeVolume();
+        // await example7_advancedUsage();
+    }
+    catch (error) {
+        console.error('错误:', error);
+        process.exit(1);
+    }
+}
+main();

package/dist/xlayer/index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 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';
+export { BundlerClient, createBundlerClient, type BundlerConfig, type BundlerReceipt, } from './bundler.js';
+export { AAAccountManager, createAAAccountManager, predictSender, createWallet, encodeExecute, encodeExecuteBatch, generateAAWallets, generateAAWalletsFromMnemonic, predictSendersFromPrivateKeys, type GeneratedAAWallet, type GenerateAAWalletsParams, type GenerateAAWalletsResult, } from './aa-account.js';
+export { encodeBuyCall, encodeSellCall, encodeApproveCall, encodeTransferCall, PortalQuery, createPortalQuery, applySlippage, formatOkb, parseOkb, formatTokenAmount, parseTokenAmount, type PortalQueryConfig, } from './portal-ops.js';
+export { BundleExecutor, createBundleExecutor, bundleBuy, bundleSell, bundleBuySell, } from './bundle.js';
+export { VolumeExecutor, createVolumeExecutor, makeVolume, singleRoundVolume, } from './volume.js';
+export { DexQuery, DexExecutor, createDexQuery, createDexExecutor, quoteOkbToToken, quoteTokenToOkb, encodeSwapExactETHForTokens, encodeSwapExactTokensForETH, encodeSwapExactTokensForTokens, encodeSwapExactETHForTokensSupportingFee, encodeSwapExactTokensForETHSupportingFee, encodeSwapExactTokensForTokensSupportingFee, type DexConfig, } from './dex.js';
+export declare const xlayer: {
+    bundleBuy: (params: import("./types.js").BundleBuyParams) => Promise<import("./types.js").BundleBuyResult>;
+    bundleSell: (params: import("./types.js").BundleSellParams) => Promise<import("./types.js").BundleSellResult>;
+    bundleBuySell: (params: import("./types.js").BundleBuySellParams) => Promise<import("./types.js").BundleBuySellResult>;
+    makeVolume: (params: import("./types.js").VolumeParams) => Promise<import("./types.js").VolumeResult>;
+    quoteOkbToToken: (okbAmount: bigint, tokenAddress: string, config?: import("./dex.js").DexConfig | undefined) => Promise<bigint>;
+    quoteTokenToOkb: (tokenAmount: bigint, tokenAddress: string, config?: import("./dex.js").DexConfig | undefined) => Promise<bigint>;
+};
+export default xlayer;