four-flap-meme-sdk 1.4.91 → 1.4.93

package/dist/xlayer/bundler.js

@@ -0,0 +1,162 @@
+/**
+ * XLayer Bundler 客户端
+ *
+ * 与 Particle Bundler 交互，提供 ERC-4337 相关 RPC 方法
+ */
+import { PARTICLE_BUNDLER_URL, XLAYER_CHAIN_ID, ENTRYPOINT_V06, } from './constants.js';
+// ============================================================================
+// Bundler 客户端类
+// ============================================================================
+let nextRpcId = 1;
+/**
+ * Particle Bundler 客户端
+ *
+ * 提供与 ERC-4337 Bundler 交互的方法：
+ * - eth_supportedEntryPoints
+ * - eth_estimateUserOperationGas
+ * - eth_sendUserOperation
+ * - eth_getUserOperationReceipt
+ * - eth_getUserOperationByHash
+ */
+export class BundlerClient {
+    constructor(config = {}) {
+        this.url = config.url ?? PARTICLE_BUNDLER_URL;
+        this.chainId = config.chainId ?? XLAYER_CHAIN_ID;
+        this.entryPoint = config.entryPoint ?? ENTRYPOINT_V06;
+        this.timeoutMs = config.timeoutMs ?? 20000;
+        this.headers = config.headers ?? {};
+    }
+    /**
+     * 发送 JSON-RPC 请求到 Bundler
+     */
+    async rpc(method, params = []) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const body = {
+                jsonrpc: '2.0',
+                id: nextRpcId++,
+                method,
+                params,
+                chainId: this.chainId,
+            };
+            const res = await fetch(this.url, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    ...this.headers,
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            const text = await res.text();
+            let data;
+            try {
+                data = JSON.parse(text);
+            }
+            catch {
+                throw new Error(`非 JSON 响应 (HTTP ${res.status}): ${text.slice(0, 400)}`);
+            }
+            if (!res.ok) {
+                throw new Error(`HTTP ${res.status}: ${JSON.stringify(data).slice(0, 800)}`);
+            }
+            if (data?.error) {
+                throw new Error(`RPC error: ${JSON.stringify(data.error)}`);
+            }
+            return data?.result;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * 获取支持的 EntryPoint 列表
+     */
+    async getSupportedEntryPoints() {
+        return await this.rpc('eth_supportedEntryPoints', []);
+    }
+    /**
+     * 估算 UserOperation Gas
+     *
+     * @param userOp 未签名的 UserOperation（signature 可为空）
+     * @returns Gas 估算结果
+     */
+    async estimateUserOperationGas(userOp) {
+        return await this.rpc('eth_estimateUserOperationGas', [
+            userOp,
+            this.entryPoint,
+        ]);
+    }
+    /**
+     * 发送 UserOperation
+     *
+     * @param userOp 已签名的 UserOperation
+     * @returns userOpHash
+     */
+    async sendUserOperation(userOp) {
+        return await this.rpc('eth_sendUserOperation', [
+            userOp,
+            this.entryPoint,
+        ]);
+    }
+    /**
+     * 获取 UserOperation 回执
+     *
+     * @param userOpHash UserOperation 哈希
+     * @returns 回执（如果还未被打包则返回 null）
+     */
+    async getUserOperationReceipt(userOpHash) {
+        return await this.rpc('eth_getUserOperationReceipt', [
+            userOpHash,
+        ]);
+    }
+    /**
+     * 根据 hash 获取 UserOperation
+     *
+     * @param userOpHash UserOperation 哈希
+     */
+    async getUserOperationByHash(userOpHash) {
+        return await this.rpc('eth_getUserOperationByHash', [userOpHash]);
+    }
+    /**
+     * 等待 UserOperation 被打包
+     *
+     * @param userOpHash UserOperation 哈希
+     * @param maxTries 最大轮询次数（默认 80）
+     * @param intervalMs 轮询间隔（默认 1500ms）
+     * @returns 回执
+     */
+    async waitForUserOperationReceipt(userOpHash, maxTries = 80, intervalMs = 1500) {
+        for (let i = 0; i < maxTries; i++) {
+            const receipt = await this.getUserOperationReceipt(userOpHash);
+            if (receipt)
+                return receipt;
+            await sleep(intervalMs);
+        }
+        return null;
+    }
+    /**
+     * 获取当前使用的 EntryPoint 地址
+     */
+    getEntryPoint() {
+        return this.entryPoint;
+    }
+    /**
+     * 获取当前链 ID
+     */
+    getChainId() {
+        return this.chainId;
+    }
+}
+// ============================================================================
+// 工具函数
+// ============================================================================
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * 创建默认的 Bundler 客户端
+ */
+export function createBundlerClient(config) {
+    return new BundlerClient(config);
+}

package/dist/xlayer/constants.d.ts

@@ -0,0 +1,75 @@
+/**
+ * XLayer SDK 常量配置
+ *
+ * XLayer 链 (chainId: 196) 的核心配置信息
+ * 支持 ERC-4337 AA 钱包模式进行 Flap 内盘交易
+ */
+/** XLayer 链 ID */
+export declare const XLAYER_CHAIN_ID = 196;
+/** XLayer 链名称 */
+export declare const XLAYER_CHAIN_NAME = "xlayer";
+/** 默认 RPC URL */
+export declare const DEFAULT_RPC_URL = "https://rpc.xlayer.tech";
+/** 高级 RPC URL（QuikNode） */
+export declare const QUIKNODE_RPC_URL = "https://stylish-practical-valley.xlayer-mainnet.quiknode.pro/84bb5dedac404fa486f57ab6387e32254dee1f83";
+/** EntryPoint v0.6 合约地址 */
+export declare const ENTRYPOINT_V06 = "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789";
+/** SimpleAccountFactory 合约地址 */
+export declare const SIMPLE_ACCOUNT_FACTORY = "0x9406Cc6185a346906296840746125a0E44976454";
+/** Particle Bundler URL */
+export declare const PARTICLE_BUNDLER_URL = "https://bundler.particle.network";
+/** Flap Portal 合约地址（XLayer 内盘） */
+export declare const FLAP_PORTAL = "0xb30D8c4216E1f21F27444D2FfAee3ad577808678";
+/** Flap Token 实现合约地址 */
+export declare const FLAP_TOKEN_IMPL = "0x12Dc83157Bf1cfCB8Db5952b3ba5bb56Cc38f8C9";
+/** WOKB 原生包装代币 */
+export declare const WOKB = "0xe538905cf8410324e03a5a23c1c177a474d59b2b";
+/** Multicall3 合约 */
+export declare const MULTICALL3 = "0xca11bde05977b3631167028862be2a173976ca11";
+/** PotatoSwap V2 Router */
+export declare const POTATOSWAP_V2_ROUTER = "0x881fb2f98c13d521009464e7d1cbf16e1b394e8e";
+/** PotatoSwap SwapRouter02 */
+export declare const POTATOSWAP_SWAP_ROUTER02 = "0xB45D0149249488333E3F3f9F359807F4b810C1FC";
+/** PotatoSwap V3 Router */
+export declare const POTATOSWAP_V3_ROUTER = "0xBB069e9465BcabC4F488d21e793BDEf0F2d41D41";
+/** PotatoSwap V3 Factory */
+export declare const POTATOSWAP_V3_FACTORY = "0xa1415fAe79c4B196d087F02b8aD5a622B8A827E5";
+/** USDT (6位精度) */
+export declare const USDT = "0x1e4a5963abfd975d8c9021ce480b42188849d41d";
+/** USDC (6位精度) */
+export declare const USDC = "0x74b7f16337b8972027f6196a17a631ac6de26d22";
+/** 零地址（表示原生代币 OKB） */
+export declare const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+/** 默认 Gas Price 兜底值（0.1 gwei） */
+export declare const DEFAULT_GAS_PRICE = 100000000n;
+/** 默认 Salt（用于 AA 账户派生） */
+export declare const DEFAULT_SALT = 0n;
+/** 默认 Withdraw Reserve（保留在 sender 的最小 OKB） */
+export declare const DEFAULT_WITHDRAW_RESERVE = "0.00005";
+/** Gas 估算安全余量（20%） */
+export declare const GAS_LIMIT_MULTIPLIER = 1.2;
+/** 验证 Gas 上限（未部署账户） */
+export declare const VERIFICATION_GAS_LIMIT_DEPLOY = 800000n;
+/** 验证 Gas 上限（已部署账户） */
+export declare const VERIFICATION_GAS_LIMIT_NORMAL = 250000n;
+/** Pre-verification Gas */
+export declare const PRE_VERIFICATION_GAS = 60000n;
+/** 默认 Call Gas Limit（卖出时的保守值） */
+export declare const DEFAULT_CALL_GAS_LIMIT_SELL = 450000n;
+/** XLayer Flap 买入手续费率 (1.5%) */
+export declare const FLAP_BUY_FEE_RATE = 0.015;
+/** XLayer Flap 卖出手续费率 (1.5%) */
+export declare const FLAP_SELL_FEE_RATE = 0.015;
+/** SimpleAccountFactory ABI */
+export declare const FACTORY_ABI: readonly ["function createAccount(address owner, uint256 salt) returns (address)", "function getAddress(address owner, uint256 salt) view returns (address)", "function accountImplementation() view returns (address)"];
+/** EntryPoint v0.6 ABI */
+export declare const ENTRYPOINT_ABI: readonly ["function getNonce(address sender, uint192 key) view returns (uint256)", "function getUserOpHash((address sender,uint256 nonce,bytes initCode,bytes callData,uint256 callGasLimit,uint256 verificationGasLimit,uint256 preVerificationGas,uint256 maxFeePerGas,uint256 maxPriorityFeePerGas,bytes paymasterAndData,bytes signature) userOp) view returns (bytes32)", "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", "function depositTo(address account) public payable", "function balanceOf(address account) public view returns (uint256)", "event UserOperationEvent(bytes32 indexed userOpHash, address indexed sender, address indexed paymaster, uint256 nonce, bool success, uint256 actualGasCost, uint256 actualGasUsed)"];
+/** SimpleAccount ABI */
+export declare const SIMPLE_ACCOUNT_ABI: readonly ["function execute(address dest, uint256 value, bytes func) external", "function executeBatch(address[] calldata dest, bytes[] calldata func) external", "function executeBatch(address[] calldata dest, uint256[] calldata values, bytes[] calldata func) external"];
+/** Flap Portal ABI */
+export declare const PORTAL_ABI: readonly ["function swapExactInput((address inputToken,address outputToken,uint256 inputAmount,uint256 minOutputAmount,bytes permitData) params) payable returns (uint256)", "function buy(address token, address to, uint256 minAmount) external payable returns (uint256)", "function sell(address token, uint256 amount, uint256 minEth) external returns (uint256)", "function quoteExactInput((address inputToken,address outputToken,uint256 inputAmount)) external returns (uint256)", "function previewBuy(address token, uint256 ethAmount) external view returns (uint256)", "function previewSell(address token, uint256 tokenAmount) external view returns (uint256)", "function getTokenV5(address token) external view returns ((uint8,uint256,uint256,uint256,uint8,uint256,uint256,uint256,uint256,address,bool,bytes32))"];
+/** ERC20 ABI */
+export declare const ERC20_ABI: readonly ["function balanceOf(address account) view returns (uint256)", "function allowance(address owner, address spender) view returns (uint256)", "function approve(address spender, uint256 amount) returns (bool)", "function transfer(address to, uint256 amount) returns (bool)", "function decimals() view returns (uint8)", "function symbol() view returns (string)", "function name() view returns (string)"];
+/** PotatoSwap V2 Router ABI */
+export declare const POTATOSWAP_V2_ROUTER_ABI: readonly ["function swapExactETHForTokens(uint amountOutMin, address[] calldata path, address to, uint deadline) external payable returns (uint[] memory amounts)", "function swapExactTokensForETH(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external returns (uint[] memory amounts)", "function swapExactTokensForTokens(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external returns (uint[] memory amounts)", "function swapExactETHForTokensSupportingFeeOnTransferTokens(uint amountOutMin, address[] calldata path, address to, uint deadline) external payable", "function swapExactTokensForETHSupportingFeeOnTransferTokens(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external", "function swapExactTokensForTokensSupportingFeeOnTransferTokens(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external", "function getAmountsOut(uint amountIn, address[] calldata path) external view returns (uint[] memory amounts)", "function getAmountsIn(uint amountOut, address[] calldata path) external view returns (uint[] memory amounts)", "function WETH() external pure returns (address)"];
+export type HexString = `0x${string}`;

package/dist/xlayer/constants.js

@@ -0,0 +1,145 @@
+/**
+ * XLayer SDK 常量配置
+ *
+ * XLayer 链 (chainId: 196) 的核心配置信息
+ * 支持 ERC-4337 AA 钱包模式进行 Flap 内盘交易
+ */
+// ============================================================================
+// 链基础配置
+// ============================================================================
+/** XLayer 链 ID */
+export const XLAYER_CHAIN_ID = 196;
+/** XLayer 链名称 */
+export const XLAYER_CHAIN_NAME = 'xlayer';
+/** 默认 RPC URL */
+export const DEFAULT_RPC_URL = 'https://rpc.xlayer.tech';
+/** 高级 RPC URL（QuikNode） */
+export const QUIKNODE_RPC_URL = 'https://stylish-practical-valley.xlayer-mainnet.quiknode.pro/84bb5dedac404fa486f57ab6387e32254dee1f83';
+// ============================================================================
+// ERC-4337 相关合约地址
+// ============================================================================
+/** EntryPoint v0.6 合约地址 */
+export const ENTRYPOINT_V06 = '0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789';
+/** SimpleAccountFactory 合约地址 */
+export const SIMPLE_ACCOUNT_FACTORY = '0x9406Cc6185a346906296840746125a0E44976454';
+/** Particle Bundler URL */
+export const PARTICLE_BUNDLER_URL = 'https://bundler.particle.network';
+// ============================================================================
+// Flap Portal 相关合约地址
+// ============================================================================
+/** Flap Portal 合约地址（XLayer 内盘） */
+export const FLAP_PORTAL = '0xb30D8c4216E1f21F27444D2FfAee3ad577808678';
+/** Flap Token 实现合约地址 */
+export const FLAP_TOKEN_IMPL = '0x12Dc83157Bf1cfCB8Db5952b3ba5bb56Cc38f8C9';
+// ============================================================================
+// DEX 相关合约地址
+// ============================================================================
+/** WOKB 原生包装代币 */
+export const WOKB = '0xe538905cf8410324e03a5a23c1c177a474d59b2b';
+/** Multicall3 合约 */
+export const MULTICALL3 = '0xca11bde05977b3631167028862be2a173976ca11';
+/** PotatoSwap V2 Router */
+export const POTATOSWAP_V2_ROUTER = '0x881fb2f98c13d521009464e7d1cbf16e1b394e8e';
+/** PotatoSwap SwapRouter02 */
+export const POTATOSWAP_SWAP_ROUTER02 = '0xB45D0149249488333E3F3f9F359807F4b810C1FC';
+/** PotatoSwap V3 Router */
+export const POTATOSWAP_V3_ROUTER = '0xBB069e9465BcabC4F488d21e793BDEf0F2d41D41';
+/** PotatoSwap V3 Factory */
+export const POTATOSWAP_V3_FACTORY = '0xa1415fAe79c4B196d087F02b8aD5a622B8A827E5';
+// ============================================================================
+// 稳定币地址
+// ============================================================================
+/** USDT (6位精度) */
+export const USDT = '0x1e4a5963abfd975d8c9021ce480b42188849d41d';
+/** USDC (6位精度) */
+export const USDC = '0x74b7f16337b8972027f6196a17a631ac6de26d22';
+// ============================================================================
+// 零地址
+// ============================================================================
+/** 零地址（表示原生代币 OKB） */
+export const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+// ============================================================================
+// Gas 配置
+// ============================================================================
+/** 默认 Gas Price 兜底值（0.1 gwei） */
+export const DEFAULT_GAS_PRICE = 100000000n;
+/** 默认 Salt（用于 AA 账户派生） */
+export const DEFAULT_SALT = 0n;
+/** 默认 Withdraw Reserve（保留在 sender 的最小 OKB） */
+export const DEFAULT_WITHDRAW_RESERVE = '0.00005';
+/** Gas 估算安全余量（20%） */
+export const GAS_LIMIT_MULTIPLIER = 1.2;
+/** 验证 Gas 上限（未部署账户） */
+export const VERIFICATION_GAS_LIMIT_DEPLOY = 800000n;
+/** 验证 Gas 上限（已部署账户） */
+export const VERIFICATION_GAS_LIMIT_NORMAL = 250000n;
+/** Pre-verification Gas */
+export const PRE_VERIFICATION_GAS = 60000n;
+/** 默认 Call Gas Limit（卖出时的保守值） */
+export const DEFAULT_CALL_GAS_LIMIT_SELL = 450000n;
+// ============================================================================
+// 费率配置
+// ============================================================================
+/** XLayer Flap 买入手续费率 (1.5%) */
+export const FLAP_BUY_FEE_RATE = 0.015;
+/** XLayer Flap 卖出手续费率 (1.5%) */
+export const FLAP_SELL_FEE_RATE = 0.015;
+// ============================================================================
+// ABI 定义
+// ============================================================================
+/** SimpleAccountFactory ABI */
+export const FACTORY_ABI = [
+    'function createAccount(address owner, uint256 salt) returns (address)',
+    'function getAddress(address owner, uint256 salt) view returns (address)',
+    'function accountImplementation() view returns (address)',
+];
+/** EntryPoint v0.6 ABI */
+export const ENTRYPOINT_ABI = [
+    'function getNonce(address sender, uint192 key) view returns (uint256)',
+    'function getUserOpHash((address sender,uint256 nonce,bytes initCode,bytes callData,uint256 callGasLimit,uint256 verificationGasLimit,uint256 preVerificationGas,uint256 maxFeePerGas,uint256 maxPriorityFeePerGas,bytes paymasterAndData,bytes signature) userOp) view returns (bytes32)',
+    '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',
+    'function depositTo(address account) public payable',
+    'function balanceOf(address account) public view returns (uint256)',
+    'event UserOperationEvent(bytes32 indexed userOpHash, address indexed sender, address indexed paymaster, uint256 nonce, bool success, uint256 actualGasCost, uint256 actualGasUsed)',
+];
+/** SimpleAccount ABI */
+export const SIMPLE_ACCOUNT_ABI = [
+    'function execute(address dest, uint256 value, bytes func) external',
+    'function executeBatch(address[] calldata dest, bytes[] calldata func) external',
+    'function executeBatch(address[] calldata dest, uint256[] calldata values, bytes[] calldata func) external',
+];
+/** Flap Portal ABI */
+export const PORTAL_ABI = [
+    'function swapExactInput((address inputToken,address outputToken,uint256 inputAmount,uint256 minOutputAmount,bytes permitData) params) payable returns (uint256)',
+    'function buy(address token, address to, uint256 minAmount) external payable returns (uint256)',
+    'function sell(address token, uint256 amount, uint256 minEth) external returns (uint256)',
+    'function quoteExactInput((address inputToken,address outputToken,uint256 inputAmount)) external returns (uint256)',
+    'function previewBuy(address token, uint256 ethAmount) external view returns (uint256)',
+    'function previewSell(address token, uint256 tokenAmount) external view returns (uint256)',
+    'function getTokenV5(address token) external view returns ((uint8,uint256,uint256,uint256,uint8,uint256,uint256,uint256,uint256,address,bool,bytes32))',
+];
+/** ERC20 ABI */
+export const ERC20_ABI = [
+    'function balanceOf(address account) view returns (uint256)',
+    'function allowance(address owner, address spender) view returns (uint256)',
+    'function approve(address spender, uint256 amount) returns (bool)',
+    'function transfer(address to, uint256 amount) returns (bool)',
+    'function decimals() view returns (uint8)',
+    'function symbol() view returns (string)',
+    'function name() view returns (string)',
+];
+/** PotatoSwap V2 Router ABI */
+export const POTATOSWAP_V2_ROUTER_ABI = [
+    // 标准 swap 函数
+    'function swapExactETHForTokens(uint amountOutMin, address[] calldata path, address to, uint deadline) external payable returns (uint[] memory amounts)',
+    'function swapExactTokensForETH(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external returns (uint[] memory amounts)',
+    'function swapExactTokensForTokens(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external returns (uint[] memory amounts)',
+    // SupportingFeeOnTransferTokens 版本（支持有手续费/分红的代币）
+    'function swapExactETHForTokensSupportingFeeOnTransferTokens(uint amountOutMin, address[] calldata path, address to, uint deadline) external payable',
+    'function swapExactTokensForETHSupportingFeeOnTransferTokens(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external',
+    'function swapExactTokensForTokensSupportingFeeOnTransferTokens(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external',
+    // 查询函数
+    'function getAmountsOut(uint amountIn, address[] calldata path) external view returns (uint[] memory amounts)',
+    'function getAmountsIn(uint amountOut, address[] calldata path) external view returns (uint[] memory amounts)',
+    'function WETH() external pure returns (address)',
+];

package/dist/xlayer/dex.d.ts

@@ -0,0 +1,132 @@
+/**
+ * XLayer 外盘交易 SDK
+ *
+ * 通过 PotatoSwap 进行外盘交易：
+ * - V2 Router 交易
+ * - 支持 OKB/Token 双向交换
+ * - 通过 AA 账户执行
+ */
+import type { XLayerConfig, DexSwapResult } from './types.js';
+/**
+ * 编码 swapExactETHForTokens 调用
+ */
+export declare function encodeSwapExactETHForTokens(amountOutMin: bigint, path: string[], to: string, deadline: number): string;
+/**
+ * 编码 swapExactETHForTokensSupportingFeeOnTransferTokens 调用
+ * 推荐使用：支持有手续费/分红机制的代币
+ */
+export declare function encodeSwapExactETHForTokensSupportingFee(amountOutMin: bigint, path: string[], to: string, deadline: number): string;
+/**
+ * 编码 swapExactTokensForETH 调用
+ */
+export declare function encodeSwapExactTokensForETH(amountIn: bigint, amountOutMin: bigint, path: string[], to: string, deadline: number): string;
+/**
+ * 编码 swapExactTokensForETHSupportingFeeOnTransferTokens 调用
+ * 推荐使用：支持有手续费/分红机制的代币
+ */
+export declare function encodeSwapExactTokensForETHSupportingFee(amountIn: bigint, amountOutMin: bigint, path: string[], to: string, deadline: number): string;
+/**
+ * 编码 swapExactTokensForTokens 调用
+ */
+export declare function encodeSwapExactTokensForTokens(amountIn: bigint, amountOutMin: bigint, path: string[], to: string, deadline: number): string;
+/**
+ * 编码 swapExactTokensForTokensSupportingFeeOnTransferTokens 调用
+ * 推荐使用：支持有手续费/分红机制的代币
+ */
+export declare function encodeSwapExactTokensForTokensSupportingFee(amountIn: bigint, amountOutMin: bigint, path: string[], to: string, deadline: number): string;
+export interface DexConfig extends XLayerConfig {
+    routerAddress?: string;
+    wokbAddress?: string;
+    deadlineMinutes?: number;
+}
+/**
+ * DEX 交易查询器
+ */
+export declare class DexQuery {
+    private provider;
+    private router;
+    private routerAddress;
+    private wokb;
+    constructor(config?: DexConfig);
+    /**
+     * 获取交易路径的输出金额
+     */
+    getAmountsOut(amountIn: bigint, path: string[]): Promise<bigint[]>;
+    /**
+     * 获取交易路径的输入金额
+     */
+    getAmountsIn(amountOut: bigint, path: string[]): Promise<bigint[]>;
+    /**
+     * 获取 OKB -> Token 的预期输出
+     */
+    quoteOkbToToken(okbAmount: bigint, tokenAddress: string): Promise<bigint>;
+    /**
+     * 获取 Token -> OKB 的预期输出
+     */
+    quoteTokenToOkb(tokenAmount: bigint, tokenAddress: string): Promise<bigint>;
+    /**
+     * 获取 WOKB 地址
+     */
+    getWokbAddress(): string;
+    /**
+     * 获取 Router 地址
+     */
+    getRouterAddress(): string;
+}
+/**
+ * DEX 交易执行器
+ *
+ * 通过 AA 账户在 PotatoSwap 上进行交易
+ */
+export declare class DexExecutor {
+    private aaManager;
+    private dexQuery;
+    private config;
+    private routerAddress;
+    private wokb;
+    private deadlineMinutes;
+    constructor(config?: DexConfig);
+    /**
+     * 获取 deadline 时间戳
+     */
+    private getDeadline;
+    /**
+     * OKB -> Token 交易（通过 EOA 直接执行）
+     * 使用 SupportingFeeOnTransferTokens 版本，支持有手续费/分红的代币
+     */
+    swapOkbForToken(privateKey: string, tokenAddress: string, okbAmount: bigint, minTokenAmount?: bigint): Promise<DexSwapResult>;
+    /**
+     * Token -> OKB 交易（通过 EOA 直接执行）
+     * 使用 SupportingFeeOnTransferTokens 版本，支持有手续费/分红的代币
+     */
+    swapTokenForOkb(privateKey: string, tokenAddress: string, tokenAmount: bigint, minOkbAmount?: bigint): Promise<DexSwapResult>;
+    /**
+     * 通过 AA 账户执行 OKB -> Token 交易
+     * 使用 SupportingFeeOnTransferTokens 版本，支持有手续费/分红的代币
+     */
+    swapOkbForTokenViaAA(privateKey: string, tokenAddress: string, okbAmount: bigint, minTokenAmount?: bigint): Promise<DexSwapResult>;
+    /**
+     * 通过 AA 账户执行 Token -> OKB 交易
+     */
+    swapTokenForOkbViaAA(privateKey: string, tokenAddress: string, tokenAmount: bigint, minOkbAmount?: bigint): Promise<DexSwapResult>;
+    /**
+     * 获取 DEX 查询器
+     */
+    getDexQuery(): DexQuery;
+}
+/**
+ * 创建 DEX 查询器
+ */
+export declare function createDexQuery(config?: DexConfig): DexQuery;
+/**
+ * 创建 DEX 执行器
+ */
+export declare function createDexExecutor(config?: DexConfig): DexExecutor;
+/**
+ * 快速获取 OKB -> Token 报价
+ */
+export declare function quoteOkbToToken(okbAmount: bigint, tokenAddress: string, config?: DexConfig): Promise<bigint>;
+/**
+ * 快速获取 Token -> OKB 报价
+ */
+export declare function quoteTokenToOkb(tokenAmount: bigint, tokenAddress: string, config?: DexConfig): Promise<bigint>;