four-flap-meme-sdk 2.2.18 → 2.2.20

package/dist/__tests__/subpath-exports.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/subpath-exports.test.js

@@ -0,0 +1,64 @@
+import { describe, expect, it } from 'vitest';
+describe('subpath exports (package.json exports map)', () => {
+    it('chains subpath exposes chains namespace', async () => {
+        const mod = await import('../chains/index.js');
+        expect(mod.chains).toBeDefined();
+        expect(mod.chains.bsc).toBeDefined();
+        expect(mod.chains.xlayer).toBeDefined();
+        expect(mod.chains.eni).toBeDefined();
+        expect(mod.bsc).toBe(mod.chains.bsc);
+    });
+    it('flap subpath exposes Merkle swap entrypoints', async () => {
+        const mod = await import('../flap/index.js');
+        expect(typeof mod.flapBundleSwapMerkle).toBe('function');
+        expect(typeof mod.flapBatchSwapMerkle).toBe('function');
+        expect(typeof mod.flapQuickBatchSwapMerkle).toBe('function');
+        expect(typeof mod.flapCrossSwapMerkle).toBe('function');
+    });
+    it('utils/wallet subpath exports GeneratedWallet type surface', async () => {
+        const mod = await import('../utils/wallet.js');
+        expect(typeof mod.generateWallets).toBe('function');
+        expect(typeof mod.validatePrivateKeys).toBe('function');
+        expect(typeof mod.getTokenBalancesWithMulticall).toBe('function');
+    });
+    it('constants subpath exports FlapChain type re-export', async () => {
+        const mod = await import('../shared/constants/index.js');
+        expect(mod.CHAINS).toBeDefined();
+        expect(mod.PROFIT_CONFIG).toBeDefined();
+    });
+    it('quote subpath exports quoteV2/quoteV3', async () => {
+        const mod = await import('../utils/quote-helpers.js');
+        expect(typeof mod.quoteV2).toBe('function');
+        expect(typeof mod.quoteV3).toBe('function');
+    });
+    it('merkle subpath exports Four Merkle swap and disperse', async () => {
+        const mod = await import('../merkle/index.js');
+        expect(typeof mod.disperseWithBundleMerkle).toBe('function');
+        expect(typeof mod.fourBundleSwapMerkle).toBe('function');
+        expect(typeof mod.submitBundleToMerkle).toBe('function');
+    });
+    it('vanity subpath exports findSaltEndingByChain', async () => {
+        const mod = await import('../vanity/index.js');
+        expect(typeof mod.findSaltEndingByChain).toBe('function');
+        expect(typeof mod.getVanitySuffix).toBe('function');
+    });
+    it('chains/bsc/iro subpath exports bscIroCreateProject', async () => {
+        const mod = await import('../chains/bsc/iro.js');
+        expect(typeof mod.bscIroCreateProject).toBe('function');
+    });
+    it('chains/eni flat aliases on eni subpath', async () => {
+        const mod = await import('../chains/eni/index.js');
+        expect(typeof mod.eniCreatePortalQuery).toBe('function');
+        expect(typeof mod.eniDisperseForSubmit).toBe('function');
+    });
+    it('chains/xlayer/eip7702 flat aliases', async () => {
+        const mod = await import('../chains/xlayer/eip7702/index.js');
+        expect(typeof mod.xlayerEip7702BundleSwap).toBe('function');
+        expect(typeof mod.xlayerEip7702CheckApprovalStatus).toBe('function');
+    });
+    it('chains/xlayer re-exports eip7702 flat aliases', async () => {
+        const mod = await import('../chains/xlayer/index.js');
+        expect(typeof mod.xlayerEip7702Disperse).toBe('function');
+        expect(mod.XLayer).toBeDefined();
+    });
+});

package/dist/abis/common.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 公共 ABI 定义
+ *
+ * 将重复的 ABI 提取到这里，统一管理
+ */
+/** 完整 ERC20 ABI */
+export declare const ERC20_ABI: string[];
+/** 精简 ERC20 ABI（余额查询 + decimals） */
+export declare const ERC20_BALANCE_ABI: string[];
+/** ERC20 授权相关 ABI */
+export declare const ERC20_ALLOWANCE_ABI: string[];
+export declare const MULTICALL3_ABI: string[];
+/** V2 Router 完整 ABI */
+export declare const V2_ROUTER_ABI: string[];
+/** V2 Router 精简 ABI（只用于报价） */
+export declare const V2_ROUTER_QUOTE_ABI: string[];
+/** V3 SwapRouter02 ABI（新版，deadline 在 multicall 中传递） */
+export declare const V3_ROUTER02_ABI: (string | {
+    inputs: {
+        components: {
+            name: string;
+            type: string;
+        }[];
+        name: string;
+        type: string;
+    }[];
+    name: string;
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+    stateMutability: string;
+    type: string;
+})[];
+/** V3 SwapRouter 旧版 ABI（deadline 在 struct 内部） */
+export declare const V3_ROUTER_LEGACY_ABI: (string | {
+    inputs: {
+        components: {
+            name: string;
+            type: string;
+        }[];
+        name: string;
+        type: string;
+    }[];
+    name: string;
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+    stateMutability: string;
+    type: string;
+})[];
+/**
+ * SwapRouter02 的 V2 方法 ABI
+ *
+ * 注意：SwapRouter02 的 V2 方法只有 token-to-token 交换
+ * 没有 swapExactETHForTokens / swapExactTokensForETH
+ * 必须通过 multicall 组合 wrapETH/unwrapWETH9 来处理原生代币
+ */
+export declare const SWAP_ROUTER02_V2_ABI: string[];
+/** V3 QuoterV2 ABI */
+export declare const V3_QUOTER_ABI: {
+    inputs: {
+        components: {
+            name: string;
+            type: string;
+        }[];
+        name: string;
+        type: string;
+    }[];
+    name: string;
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+    stateMutability: string;
+    type: string;
+}[];
+export declare const V2_FACTORY_ABI: string[];
+export declare const V2_PAIR_ABI: string[];
+export declare const V3_FACTORY_ABI: string[];
+export declare const V3_POOL_ABI: string[];
+export { FLAP_PORTAL_ABI } from './flap/portal-merkle.js';
+export declare const TM2_ABI: string[];
+export declare const HELPER3_ABI: string[];

package/dist/abis/common.js

@@ -0,0 +1,240 @@
+/**
+ * 公共 ABI 定义
+ *
+ * 将重复的 ABI 提取到这里，统一管理
+ */
+// ============================================================================
+// ERC20 ABI
+// ============================================================================
+/** 完整 ERC20 ABI */
+export const ERC20_ABI = [
+    'function approve(address spender, uint256 amount) external returns (bool)',
+    'function allowance(address owner, address spender) external view returns (uint256)',
+    'function balanceOf(address account) external view returns (uint256)',
+    'function decimals() external view returns (uint8)',
+    'function name() external view returns (string)',
+    'function symbol() external view returns (string)',
+    'function totalSupply() external view returns (uint256)',
+    'function transfer(address to, uint256 amount) external returns (bool)',
+    'function transferFrom(address from, address to, uint256 amount) external returns (bool)',
+];
+/** 精简 ERC20 ABI（余额查询 + decimals） */
+export const ERC20_BALANCE_ABI = [
+    'function balanceOf(address account) external view returns (uint256)',
+    'function decimals() external view returns (uint8)',
+];
+/** ERC20 授权相关 ABI */
+export const ERC20_ALLOWANCE_ABI = [
+    'function allowance(address owner, address spender) external view returns (uint256)',
+    'function approve(address spender, uint256 amount) external returns (bool)',
+    'function decimals() external view returns (uint8)',
+];
+// ============================================================================
+// Multicall3 ABI
+// ============================================================================
+export const MULTICALL3_ABI = [
+    // ✅ 标记为 view，确保 ethers.js v6 使用 call 而不是 sendTransaction
+    'function aggregate3(tuple(address target, bool allowFailure, bytes callData)[] calls) view returns (tuple(bool success, bytes returnData)[])',
+    'function aggregate(tuple(address target, bytes callData)[] calls) view returns (uint256 blockNumber, bytes[] returnData)',
+    'function getEthBalance(address addr) view returns (uint256 balance)',
+];
+// ============================================================================
+// PancakeSwap / Uniswap V2 Router ABI
+// ============================================================================
+/** V2 Router 完整 ABI */
+export const V2_ROUTER_ABI = [
+    // BNB/ETH → Token (买入)
+    'function swapExactETHForTokens(uint amountOutMin, address[] calldata path, address to, uint deadline) external payable returns (uint[] memory amounts)',
+    'function swapExactETHForTokensSupportingFeeOnTransferTokens(uint amountOutMin, address[] calldata path, address to, uint deadline) external payable',
+    // Token → BNB/ETH (卖出)
+    'function swapExactTokensForETH(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external returns (uint[] memory amounts)',
+    'function swapExactTokensForETHSupportingFeeOnTransferTokens(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external',
+    // Token → Token
+    'function swapExactTokensForTokens(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external returns (uint[] memory amounts)',
+    '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)',
+    // Factory
+    'function factory() external view returns (address)',
+];
+/** V2 Router 精简 ABI（只用于报价） */
+export const V2_ROUTER_QUOTE_ABI = [
+    'function getAmountsOut(uint amountIn, address[] calldata path) external view returns (uint[] memory amounts)',
+];
+// ============================================================================
+// PancakeSwap / Uniswap V3 Router ABI (SwapRouter02)
+// ============================================================================
+/** V3 SwapRouter02 ABI（新版，deadline 在 multicall 中传递） */
+export const V3_ROUTER02_ABI = [
+    // exactInputSingle - 单跳，不含 deadline
+    {
+        inputs: [
+            {
+                components: [
+                    { name: 'tokenIn', type: 'address' },
+                    { name: 'tokenOut', type: 'address' },
+                    { name: 'fee', type: 'uint24' },
+                    { name: 'recipient', type: 'address' },
+                    { name: 'amountIn', type: 'uint256' },
+                    { name: 'amountOutMinimum', type: 'uint256' },
+                    { name: 'sqrtPriceLimitX96', type: 'uint160' },
+                ],
+                name: 'params',
+                type: 'tuple',
+            },
+        ],
+        name: 'exactInputSingle',
+        outputs: [{ name: 'amountOut', type: 'uint256' }],
+        stateMutability: 'payable',
+        type: 'function',
+    },
+    // exactInput - 多跳，不含 deadline
+    {
+        inputs: [
+            {
+                components: [
+                    { name: 'path', type: 'bytes' },
+                    { name: 'recipient', type: 'address' },
+                    { name: 'amountIn', type: 'uint256' },
+                    { name: 'amountOutMinimum', type: 'uint256' },
+                ],
+                name: 'params',
+                type: 'tuple',
+            },
+        ],
+        name: 'exactInput',
+        outputs: [{ name: 'amountOut', type: 'uint256' }],
+        stateMutability: 'payable',
+        type: 'function',
+    },
+    // multicall - 带 deadline 版本
+    'function multicall(uint256 deadline, bytes[] calldata data) external payable returns (bytes[] memory results)',
+    'function refundETH() external payable',
+    'function unwrapWETH9(uint256 amountMinimum, address recipient) external payable',
+];
+/** V3 SwapRouter 旧版 ABI（deadline 在 struct 内部） */
+export const V3_ROUTER_LEGACY_ABI = [
+    // exactInputSingle - 包含 deadline
+    {
+        inputs: [
+            {
+                components: [
+                    { name: 'tokenIn', type: 'address' },
+                    { name: 'tokenOut', type: 'address' },
+                    { name: 'fee', type: 'uint24' },
+                    { name: 'recipient', type: 'address' },
+                    { name: 'deadline', type: 'uint256' },
+                    { name: 'amountIn', type: 'uint256' },
+                    { name: 'amountOutMinimum', type: 'uint256' },
+                    { name: 'sqrtPriceLimitX96', type: 'uint160' },
+                ],
+                name: 'params',
+                type: 'tuple',
+            },
+        ],
+        name: 'exactInputSingle',
+        outputs: [{ name: 'amountOut', type: 'uint256' }],
+        stateMutability: 'payable',
+        type: 'function',
+    },
+    // multicall - 不带 deadline 版本
+    'function multicall(bytes[] calldata data) external payable returns (bytes[] memory results)',
+    'function refundETH() external payable',
+    'function unwrapWETH9(uint256 amountMinimum, address recipient) external payable',
+];
+// ============================================================================
+// SwapRouter02 V2 方法 ABI (PotatoSwap/DYORSwap 等)
+// ============================================================================
+/**
+ * SwapRouter02 的 V2 方法 ABI
+ *
+ * 注意：SwapRouter02 的 V2 方法只有 token-to-token 交换
+ * 没有 swapExactETHForTokens / swapExactTokensForETH
+ * 必须通过 multicall 组合 wrapETH/unwrapWETH9 来处理原生代币
+ */
+export const SWAP_ROUTER02_V2_ABI = [
+    // V2 交换方法（只有 token-to-token）
+    'function swapExactTokensForTokens(uint256 amountIn, uint256 amountOutMin, address[] calldata path, address to) external payable returns (uint256 amountOut)',
+    'function swapTokensForExactTokens(uint256 amountOut, uint256 amountInMax, address[] calldata path, address to) external payable returns (uint256 amountIn)',
+    // Multicall - 多种重载
+    'function multicall(uint256 deadline, bytes[] calldata data) external payable returns (bytes[] memory results)',
+    'function multicall(bytes32 previousBlockhash, bytes[] calldata data) external payable returns (bytes[] memory results)',
+    'function multicall(bytes[] calldata data) external payable returns (bytes[] memory results)',
+    // 辅助方法 - ETH/WETH 转换
+    'function wrapETH(uint256 value) external payable',
+    'function unwrapWETH9(uint256 amountMinimum, address recipient) external payable',
+    'function unwrapWETH9(uint256 amountMinimum) external payable',
+    'function refundETH() external payable',
+    // 代币操作
+    'function pull(address token, uint256 value) external payable',
+    'function sweepToken(address token, uint256 amountMinimum, address recipient) external payable',
+    'function sweepToken(address token, uint256 amountMinimum) external payable',
+];
+// ============================================================================
+// V3 Quoter ABI
+// ============================================================================
+/** V3 QuoterV2 ABI */
+export const V3_QUOTER_ABI = [
+    {
+        inputs: [
+            {
+                components: [
+                    { name: 'tokenIn', type: 'address' },
+                    { name: 'tokenOut', type: 'address' },
+                    { name: 'amountIn', type: 'uint256' },
+                    { name: 'fee', type: 'uint24' },
+                    { name: 'sqrtPriceLimitX96', type: 'uint160' },
+                ],
+                name: 'params',
+                type: 'tuple',
+            },
+        ],
+        name: 'quoteExactInputSingle',
+        outputs: [
+            { name: 'amountOut', type: 'uint256' },
+            { name: 'sqrtPriceX96After', type: 'uint160' },
+            { name: 'initializedTicksCrossed', type: 'uint32' },
+            { name: 'gasEstimate', type: 'uint256' },
+        ],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+];
+// ============================================================================
+// Uniswap V2 Factory & Pair ABI
+// ============================================================================
+export const V2_FACTORY_ABI = ['function getPair(address tokenA, address tokenB) external view returns (address pair)'];
+export const V2_PAIR_ABI = [
+    'function token0() external view returns (address)',
+    'function token1() external view returns (address)',
+    'function getReserves() external view returns (uint112 reserve0, uint112 reserve1, uint32 blockTimestampLast)',
+];
+// ============================================================================
+// Uniswap V3 Factory & Pool ABI
+// ============================================================================
+export const V3_FACTORY_ABI = [
+    'function getPool(address tokenA, address tokenB, uint24 fee) external view returns (address pool)',
+];
+export const V3_POOL_ABI = [
+    'function token0() external view returns (address)',
+    'function token1() external view returns (address)',
+    'function fee() external view returns (uint24)',
+    'function slot0() external view returns (uint160 sqrtPriceX96, int24 tick, uint16 observationIndex, uint16 observationCardinality, uint16 observationCardinalityNext, uint8 feeProtocol, bool unlocked)',
+];
+export { FLAP_PORTAL_ABI } from './flap/portal-merkle.js';
+// ============================================================================
+// Four TokenManager ABI
+// ============================================================================
+export const TM2_ABI = [
+    // 新版方法（Four.meme TokenManager2）
+    'function buyTokenAMAP(uint256 origin, address token, address to, uint256 funds, uint256 minAmount) external payable',
+    'function sellToken(uint256 origin, address token, uint256 amount, uint256 minFunds) external',
+    // 旧版兼容方法
+    'function buy(address token, uint256 minReceived) external payable returns (uint256)',
+    'function sell(address token, uint256 sellAmount, uint256 minReceived) external returns (uint256)',
+    'function trySell(address token, uint256 sellAmount) external view returns (uint256)',
+];
+export const HELPER3_ABI = [
+    'function getTokenInfo(address token) external view returns (tuple(address addr, string name, string symbol, uint8 decimals, uint256 totalSupply, uint256 balance, uint256 price, uint256 marketCap))',
+];