four-flap-meme-sdk 2.2.2 → 2.2.4

package/README.en.md

@@ -29,6 +29,41 @@ Optional (use Pinata for IPFS uploads)
 npm i pinata
 ```
 
+## Package entry points (subpath imports)
+
+The library is published as **ESM** (`dist` is produced by `npm run build`). The root import remains the default for full API access. For smaller dependency graphs, Node and bundlers that honor `package.json` **`exports`** may import:
+
+**When to use which**
+
+- **Root**: default for apps and examples that touch more than one SDK area.
+- **Subpaths**: for scripts or libraries that intentionally depend on only one slice (constants, ABIs, error utilities, Merkle clients, etc.).
+
+| Subpath | Purpose |
+|---------|---------|
+| `four-flap-meme-sdk` | Main entry — full surface |
+| `four-flap-meme-sdk/chains` | Chain namespaces and helpers |
+| `four-flap-meme-sdk/shared` | Cross-cutting modules: constants, `foundation`, `clients`, `FourUtils` |
+| `four-flap-meme-sdk/clients` | HTTP / Merkle-related clients |
+| `four-flap-meme-sdk/dex` | DEX helpers |
+| `four-flap-meme-sdk/constants` | Chain config, gas, addresses, profit settings |
+| `four-flap-meme-sdk/abis` | TokenManager JSON ABIs, common fragments, Flap ABIs (same as `src/abis` barrel) |
+| `four-flap-meme-sdk/foundation` | Unknown-error normalization and optional loggers |
+| `four-flap-meme-sdk/bundle-core` | Shared bundle core: `internal`, `submit`, `config-helpers` |
+| `four-flap-meme-sdk/flows` | High-level flows (e.g. `createTokenFlow`) |
+
+> **v2.0.0**: ambiguous root exports removed — see [docs/MIGRATION_EXPORTS.zh-CN.md](./docs/MIGRATION_EXPORTS.zh-CN.md).
+
+```typescript
+import { CHAINS, GAS_LIMITS } from 'four-flap-meme-sdk/constants';
+import { TokenManager } from 'four-flap-meme-sdk/abis';
+import { normalizeUnknownError } from 'four-flap-meme-sdk/foundation';
+```
+
+### Documentation: alignment & backends
+
+- **[docs/ALIGNMENT_STATUS.zh-CN.md](./docs/ALIGNMENT_STATUS.zh-CN.md)** — audit-style checklist (language: Chinese).
+- **[docs/SUBMIT_BACKENDS.zh-CN.md](./docs/SUBMIT_BACKENDS.zh-CN.md)** — choosing Merkle, BlockRazor, direct RPC, ENI, 48.club, etc.
+
 ---
 
 ## Table of Contents
@@ -3503,7 +3538,7 @@ const permitData = await buildPermitPiggybackAuto(
 The SDK provides pre-configured addresses for all supported networks:
 
 ```typescript
-import { CHAIN } from 'four-flap-meme-sdk';
+import { CHAINS } from 'four-flap-meme-sdk';
 
 // Use chain enum when calling SDK methods (addresses are handled internally)
 // Example:
@@ -3512,11 +3547,11 @@ import { CHAIN } from 'four-flap-meme-sdk';
 // await tryBuy('BSC', rpcUrl, token, amount, funds);
 
 // Chain information
-console.log(CHAIN.BSC.chainId);         // 56
-console.log(CHAIN.BASE.chainId);        // 8453
-console.log(CHAIN.XLAYER.chainId);      // 196
-console.log(CHAIN.MORPH.chainId);       // 2818
-console.log(CHAIN.ARBITRUM_ONE.chainId); // 42161
+console.log(CHAINS.BSC.chainId);         // 56
+console.log(CHAINS.BASE.chainId);        // 8453
+console.log(CHAINS.XLAYER.chainId);      // 196
+console.log(CHAINS.MORPH.chainId);       // 2818
+console.log(CHAINS.ARBITRUM_ONE.chainId); // 42161
 ```
 
 ---

package/README.md

@@ -20,6 +20,37 @@ npm i four-flap-meme-sdk ethers
 
 **要求**：Node.js >= 18, ESM, ethers v6
 
+### Package entry points (subpath imports)
+
+The package ships **ESM** with `exports` in `package.json`. Use the default root import for full API coverage; use subpaths to narrow what your resolver loads (requires tooling that respects `exports`).
+
+**When to use which**
+
+- **Root import**: matches the docs; use when you need multiple surfaces (four.meme, Flap, bundles, several chains).
+- **Subpaths**: use in scripts, internal packages, or constrained runtimes when you only need one vertical slice (constants, ABIs, error helpers, HTTP clients, etc.).
+
+| Subpath | Purpose |
+|---------|---------|
+| `four-flap-meme-sdk` | Main entry — full surface (recommended default) |
+| `four-flap-meme-sdk/chains` | Per-chain namespaces and chain helpers |
+| `four-flap-meme-sdk/shared` | Shared layer: constants, `foundation`, `clients`, `FourUtils`, etc. |
+| `four-flap-meme-sdk/clients` | HTTP / bundle / infra clients |
+| `four-flap-meme-sdk/dex` | DEX helpers and types |
+| `four-flap-meme-sdk/constants` | Chain IDs, gas limits, addresses, profit helpers — smallest config-only slice |
+| `four-flap-meme-sdk/abis` | Compiled contract JSON ABIs, shared fragment ABIs, Flap-specific ABIs (`src/abis` entry) |
+| `four-flap-meme-sdk/foundation` | `normalizeUnknownError`, `getErrorMessageFromUnknown`, injectable `SdkLogger` — no domain logic |
+
+```typescript
+import { CHAINS, ADDRESSES } from 'four-flap-meme-sdk/constants';
+import { TokenManager } from 'four-flap-meme-sdk/abis';
+import { normalizeUnknownError } from 'four-flap-meme-sdk/foundation';
+```
+
+### Docs: architecture & submission paths
+
+- **[docs/ALIGNMENT_STATUS.zh-CN.md](./docs/ALIGNMENT_STATUS.zh-CN.md)** — audit-style checklist (what is done vs backlog).
+- **[docs/SUBMIT_BACKENDS.zh-CN.md](./docs/SUBMIT_BACKENDS.zh-CN.md)** — when to use Merkle vs BlockRazor vs direct RPC vs ENI / 48.club, etc.
+
 ## 获取 Merkle API Key
 
 从 [Merkle.io](https://merkle.io) 获取免费 API Key，用于 Bundle 服务。

package/README.zh-CN.md

@@ -29,6 +29,41 @@ npm i four-flap-meme-sdk ethers
 npm i pinata
 ```
 
+## 包入口与子路径（按需引用）
+
+发布后包内为 **ESM**，`dist` 由 `npm run build` 生成。多数场景继续使用主入口即可；若希望缩小解析范围或只做配置层依赖，可选用 `package.json` 的 **`exports`** 子路径（需 Node／打包工具识别 `exports`）。
+
+**如何选择**
+
+- **主入口**：与文档示例一致；需要 four / Flap、Bundle、多链等组合能力时优先用它。
+- **子路径**：在脚本、内部库或边缘运行时**只要某一竖切**（仅常量、仅 ABI、仅错误与日志、仅 HTTP 客户端等）时使用，以收敛依赖与解析面。
+
+| 子路径 | 说明 |
+|--------|------|
+| `four-flap-meme-sdk` | 主入口，全量导出（默认推荐） |
+| `four-flap-meme-sdk/chains` | 各链命名空间与链相关工具 |
+| `four-flap-meme-sdk/shared` | 横向能力：常量、`foundation`、`clients`、`FourUtils` 等 |
+| `four-flap-meme-sdk/clients` | Merkle / HTTP 等与 I/O 相关的客户端封装 |
+| `four-flap-meme-sdk/dex` | DEX 路由与相关类型／辅助函数 |
+| `four-flap-meme-sdk/constants` | 链 ID、Gas、常用地址、利润配置等常量（等价于深入 `shared` 中的常量模块，但更轻依赖面） |
+| `four-flap-meme-sdk/abis` | 合约 JSON ABI（TokenManager 等）、公共片段 ABI、Flap 相关 ABI（与 `src/abis` 入口一致） |
+| `four-flap-meme-sdk/foundation` | 错误规范化（`normalizeUnknownError` 等）与可选 `SdkLogger`，无业务逻辑 |
+| `four-flap-meme-sdk/bundle-core` | Bundle 共享核心：`internal`、`submit`、`config-helpers` |
+| `four-flap-meme-sdk/flows` | 高层流程（如 `createTokenFlow`） |
+
+> **v2.0.0**：包根已移除 `TradeType` / `PROFIT_CONFIG` / `CHAIN` 等歧义导出，见 [docs/MIGRATION_EXPORTS.zh-CN.md](./docs/MIGRATION_EXPORTS.zh-CN.md)。
+
+```typescript
+import { CHAINS, GAS_LIMITS } from 'four-flap-meme-sdk/constants';
+import { TokenManager } from 'four-flap-meme-sdk/abis';
+import { normalizeUnknownError } from 'four-flap-meme-sdk/foundation';
+```
+
+### 文档：架构对齐与提交路径
+
+- **[docs/ALIGNMENT_STATUS.zh-CN.md](./docs/ALIGNMENT_STATUS.zh-CN.md)** — 与审计文档对照的总表（已完成 / 待办）。
+- **[docs/SUBMIT_BACKENDS.zh-CN.md](./docs/SUBMIT_BACKENDS.zh-CN.md)** — 何时用 Merkle / BlockRazor / 直连 RPC / ENI / 48.club 等。
+
 ## 浏览器环境支持
 
 SDK 已内置 Cloudflare Workers 代理，**浏览器环境可直接使用，无需额外配置 CORS**：
@@ -4587,7 +4622,7 @@ const permitData = await buildPermitPiggybackAuto(
 SDK 提供所有支持网络的预配置地址：
 
 ```typescript
-import { CHAIN } from 'four-flap-meme-sdk';
+import { CHAINS } from 'four-flap-meme-sdk';
 
 // 使用链枚举调用 SDK 方法（地址由 SDK 内部处理）
 // 示例：
@@ -4596,11 +4631,11 @@ import { CHAIN } from 'four-flap-meme-sdk';
 // await tryBuy('BSC', rpcUrl, token, amount, funds);
 
 // 链信息
-console.log(CHAIN.BSC.chainId);         // 56
-console.log(CHAIN.BASE.chainId);        // 8453
-console.log(CHAIN.XLAYER.chainId);      // 196
-console.log(CHAIN.MORPH.chainId);       // 2818
-console.log(CHAIN.ARBITRUM_ONE.chainId); // 42161
+console.log(CHAINS.BSC.chainId);         // 56
+console.log(CHAINS.BASE.chainId);        // 8453
+console.log(CHAINS.XLAYER.chainId);      // 196
+console.log(CHAINS.MORPH.chainId);       // 2818
+console.log(CHAINS.ARBITRUM_ONE.chainId); // 42161
 ```
 
 ---

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 declare const FLAP_PORTAL_ABI: string[];
+export declare const TM2_ABI: string[];
+export declare const HELPER3_ABI: string[];

package/dist/abis/common.js

@@ -0,0 +1,264 @@
+/**
+ * 公共 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)',
+];
+// ============================================================================
+// Flap Portal ABI
+// ============================================================================
+export const FLAP_PORTAL_ABI = [
+    // 创建代币
+    'function newToken(string name, string symbol, string meta) external payable returns (address)',
+    'function newTokenV2((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint16 taxRate,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData)) external payable returns (address)',
+    'function newTokenV3((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint16 taxRate,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData,bytes32 extensionID,bytes extensionData)) external payable returns (address)',
+    // ✅ V4：支持 dexId / lpFeeProfile（与 portal-bundle-merkle/core.ts 的 newTokenV4.populateTransaction 对齐）
+    'function newTokenV4((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint16 taxRate,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData,bytes32 extensionID,bytes extensionData,uint8 dexId,uint8 lpFeeProfile)) external payable returns (address)',
+    // ✅ V5：Tax Token V2 高级税收分配（legacy）
+    'function newTokenV5((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint16 taxRate,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData,bytes32 extensionID,bytes extensionData,uint8 dexId,uint8 lpFeeProfile,uint64 taxDuration,uint64 antiFarmerDuration,uint16 mktBps,uint16 deflationBps,uint16 dividendBps,uint16 lpBps,uint256 minimumShareBalance)) external payable returns (address)',
+    // ✅ V6：统一发币入口（TOKEN_V2_PERMIT / TOKEN_TAXED_V3）
+    'function newTokenV6((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData,bytes32 extensionID,bytes extensionData,uint8 dexId,uint8 lpFeeProfile,uint16 buyTaxRate,uint16 sellTaxRate,uint64 taxDuration,uint64 antiFarmerDuration,uint16 mktBps,uint16 deflationBps,uint16 dividendBps,uint16 lpBps,uint256 minimumShareBalance,address dividendToken,address commissionReceiver,uint8 tokenVersion)) external payable returns (address)',
+    // ✅ V7：TOKEN_V3_PERMIT + CL 迁移
+    'function newTokenV7((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint8 migratorType,address quoteToken,uint256 quoteAmt,bytes permitData,bytes32 extensionID,bytes extensionData,uint8 dexId,uint16 buyTaxRate,uint16 sellTaxRate,uint64 taxDuration,uint64 antiFarmerDuration,address commissionReceiver,uint8 tokenVersion,(uint8 feeType,uint16 bps,address marketingAddress,address dividendToken,uint256 minimumShareBalance)[4] feeConfigs)) external payable returns (address)',
+    // 交易
+    'function swapExactInput((address inputToken,address outputToken,uint256 inputAmount,uint256 minOutputAmount,bytes permitData)) external payable returns (uint256)',
+    // ✅ V3：支持 extensionData（注意：这里的 V3 指“扩展交易接口版本”，不是“外盘 V3 池子”）
+    'function swapExactInputV3((address inputToken,address outputToken,uint256 inputAmount,uint256 minOutputAmount,bytes permitData,bytes extensionData)) external payable returns (uint256)',
+    'function quoteExactInput((address inputToken,address outputToken,uint256 inputAmount)) external view returns (uint256)',
+    // 旧版兼容
+    'function buy(address token, uint256 minReceived) external payable returns (uint256)',
+    'function sell(address token, uint256 sellAmount, uint256 minReceived) external returns (uint256)',
+];
+// ============================================================================
+// 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))',
+];