four-flap-meme-sdk 2.2.8 → 2.2.11

package/README.en.md

@@ -29,41 +29,6 @@ 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
@@ -3538,7 +3503,7 @@ const permitData = await buildPermitPiggybackAuto(
 The SDK provides pre-configured addresses for all supported networks:
 
 ```typescript
-import { CHAINS } from 'four-flap-meme-sdk';
+import { CHAIN } from 'four-flap-meme-sdk';
 
 // Use chain enum when calling SDK methods (addresses are handled internally)
 // Example:
@@ -3547,11 +3512,11 @@ import { CHAINS } from 'four-flap-meme-sdk';
 // await tryBuy('BSC', rpcUrl, token, amount, funds);
 
 // Chain information
-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
+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
 ```
 
 ---

package/README.md

@@ -20,37 +20,6 @@ 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,41 +29,6 @@ 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**：
@@ -4622,7 +4587,7 @@ const permitData = await buildPermitPiggybackAuto(
 SDK 提供所有支持网络的预配置地址：
 
 ```typescript
-import { CHAINS } from 'four-flap-meme-sdk';
+import { CHAIN } from 'four-flap-meme-sdk';
 
 // 使用链枚举调用 SDK 方法（地址由 SDK 内部处理）
 // 示例：
@@ -4631,11 +4596,11 @@ import { CHAINS } from 'four-flap-meme-sdk';
 // await tryBuy('BSC', rpcUrl, token, amount, funds);
 
 // 链信息
-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
+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
 ```
 
 ---

package/dist/chains/bsc/four/approve-tokenmanager.d.ts

@@ -1 +1,26 @@
-export { approveFourTokenManagerBatch, type ApproveFourTokenManagerBatchParams, type ApproveFourTokenManagerBatchResult, } from '../../../bundle-core/four-meme/approve-tokenmanager.js';
+import type { FourSignConfig } from './types.js';
+/** ✅ 批量授权参数（直接提交到链上） */
+export type ApproveFourTokenManagerBatchParams = {
+    privateKeys: string[];
+    tokenAddress: string;
+    amounts: string[];
+    config: FourSignConfig;
+};
+/** ✅ 批量授权结果（包含提交状态） */
+export type ApproveFourTokenManagerBatchResult = {
+    success: boolean;
+    signedTransactions: string[];
+    approvedCount: number;
+    skippedCount: number;
+    txHashes?: string[];
+    message: string;
+};
+/**
+ * 批量授权代币给 TokenManager（用于 Private Buy/Sell）
+ * ✅ 直接通过 RPC 提交到链上并等待确认
+ * ✅ 不需要 Merkle API Key，使用普通 RPC 即可
+ * ✅ 专门用于授权给 TokenManagerOriginal 合约
+ * ✅ 用于 fourBatchPrivateSell 和 fourBatchSellWithBundleMerkle
+ * ✅ 优化：并行获取 gasPrice、decimals、allowances
+ */
+export declare function approveFourTokenManagerBatch(params: ApproveFourTokenManagerBatchParams): Promise<ApproveFourTokenManagerBatchResult>;

package/dist/chains/bsc/four/approve-tokenmanager.js

@@ -1 +1,113 @@
-export { approveFourTokenManagerBatch, } from '../../../bundle-core/four-meme/approve-tokenmanager.js';
+import { ethers, Wallet } from 'ethers';
+import { NonceManager, getOptimizedGasPrice } from '../../../utils/bundle-helpers.js';
+import { ADDRESSES } from '../../../utils/constants.js';
+import { ERC20_ABI } from '../../../shared/abis/common.js';
+import { getTxType, getGasPriceConfig } from './config.js';
+import { batchCheckAllowances } from '../../../utils/erc20.js';
+/**
+ * 批量授权代币给 TokenManager（用于 Private Buy/Sell）
+ * ✅ 直接通过 RPC 提交到链上并等待确认
+ * ✅ 不需要 Merkle API Key，使用普通 RPC 即可
+ * ✅ 专门用于授权给 TokenManagerOriginal 合约
+ * ✅ 用于 fourBatchPrivateSell 和 fourBatchSellWithBundleMerkle
+ * ✅ 优化：并行获取 gasPrice、decimals、allowances
+ */
+export async function approveFourTokenManagerBatch(params) {
+    const { privateKeys, tokenAddress, amounts, config } = params;
+    if (privateKeys.length === 0 || amounts.length !== privateKeys.length) {
+        throw new Error('Private key count and amount count must match');
+    }
+    const tmAddr = ADDRESSES.BSC.TokenManagerOriginal;
+    const chainId = config.chainId ?? 56;
+    // ✅ 直接使用传入的 RPC URL 创建 provider（不依赖 Merkle）
+    const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
+        chainId: chainId,
+        name: 'BSC'
+    });
+    const wallets = privateKeys.map(k => new Wallet(k, provider));
+    const allMax = amounts.every(a => a === 'max');
+    // ✅ 优化：并行获取 gasPrice、decimals（如果需要）、allowances
+    const [gasPrice, decimals, allowances] = await Promise.all([
+        getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+        allMax
+            ? Promise.resolve(18) // 如果都是 'max'，不需要查询 decimals
+            : (async () => {
+                try {
+                    const tokenContract = new ethers.Contract(tokenAddress, ERC20_ABI, provider);
+                    return await tokenContract.decimals();
+                }
+                catch (error) {
+                    throw new Error(`查询代币 decimals 失败: ${error.message}`);
+                }
+            })(),
+        batchCheckAllowances(provider, tokenAddress, wallets.map(w => w.address), tmAddr)
+    ]);
+    const amountsBigInt = amounts.map(a => a === 'max' ? ethers.MaxUint256 : ethers.parseUnits(a, decimals));
+    // 只授权不足的
+    // ✅ 策略：如果授权额度 < MaxUint256 / 2n，就重新授权（确保授权足够大）
+    const APPROVAL_THRESHOLD = ethers.MaxUint256 / 2n;
+    const needApproval = wallets.filter((_, i) => allowances[i] < APPROVAL_THRESHOLD);
+    const needApprovalAmounts = amountsBigInt.filter((_, i) => allowances[i] < APPROVAL_THRESHOLD);
+    const skippedCount = wallets.length - needApproval.length;
+    if (needApproval.length === 0) {
+        return {
+            success: true,
+            signedTransactions: [],
+            approvedCount: 0,
+            skippedCount: skippedCount,
+            message: '所有钱包已授权，无需重复授权'
+        };
+    }
+    // ✅ 优化：计算 gasLimit（不需要 RPC）
+    const getGasLimit = (cfg) => {
+        if (cfg.gasLimit)
+            return BigInt(cfg.gasLimit);
+        if (cfg.gasLimitMultiplier)
+            return BigInt(Math.ceil(60000 * cfg.gasLimitMultiplier));
+        return 60000n; // 默认授权 gas limit
+    };
+    const finalGasLimit = getGasLimit(config);
+    const txType = getTxType(config);
+    // ✅ 优化：并行获取 nonces 和构建未签名交易
+    const nonceManager = new NonceManager(provider);
+    const needApprovalTokens = needApproval.map(w => new ethers.Contract(tokenAddress, ERC20_ABI, w));
+    const [nonces, unsignedApprovals] = await Promise.all([
+        nonceManager.getNextNoncesForWallets(needApproval), // ✅ 批量获取 nonces（JSON-RPC 批量请求）
+        Promise.all(needApprovalTokens.map((token, i) => token.approve.populateTransaction(tmAddr, needApprovalAmounts[i])))
+    ]);
+    // ✅ 并行签名所有授权交易
+    const signedTxs = await Promise.all(unsignedApprovals.map((unsigned, i) => needApproval[i].signTransaction({
+        ...unsigned,
+        from: needApproval[i].address,
+        nonce: nonces[i],
+        gasLimit: finalGasLimit,
+        gasPrice,
+        chainId,
+        type: txType
+    })));
+    nonceManager.clearTemp();
+    try {
+        // ✅ 并行广播所有授权交易
+        const txResponses = await Promise.all(signedTxs.map(tx => provider.broadcastTransaction(tx)));
+        const txHashes = txResponses.map(r => r.hash);
+        // ✅ 并行等待所有授权交易确认（至少1个确认）
+        await Promise.all(txResponses.map(tx => tx.wait(1)));
+        return {
+            success: true,
+            signedTransactions: signedTxs,
+            approvedCount: signedTxs.length,
+            skippedCount: skippedCount,
+            txHashes: txHashes,
+            message: `授权成功！共 ${signedTxs.length} 个钱包已授权，跳过 ${skippedCount} 个已授权钱包`
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            signedTransactions: signedTxs,
+            approvedCount: 0,
+            skippedCount: skippedCount,
+            message: `授权提交失败: ${error.message}`
+        };
+    }
+}

package/dist/chains/bsc/four/config.d.ts

@@ -1,8 +1,70 @@
-/**
- * Four.meme bundle 配置 helper（实现见 bundle-core/）
- */
 import type { FourBundleMerkleConfig, FourSignConfig } from './types.js';
 export type { FourBundleMerkleConfig, FourSignConfig };
 export type FourAnyConfig = FourBundleMerkleConfig | FourSignConfig;
-export { BUNDLE_ERRORS as ERRORS, getBundleErrorMessage as getErrorMessage } from '../../../bundle-core/errors.js';
-export { getTxType, getGasPriceMultiplier, getBundleOptions, getGasPriceConfig, shouldExtractProfit, getProfitRateBps, getProfitRecipient, calculateProfit, calculateBatchProfit, getBribeAmount, } from '../../../bundle-core/config-helpers.js';
+export declare const ERRORS: {
+    NO_PRIVATE_KEY: {
+        en: string;
+        zh: string;
+    };
+    AMOUNT_MISMATCH: {
+        en: (buyCount: number, buyerCount: number) => string;
+        zh: (buyCount: number, buyerCount: number) => string;
+    };
+    IMAGE_REQUIRED: {
+        en: string;
+        zh: string;
+    };
+    KEY_AMOUNT_MISMATCH: {
+        en: string;
+        zh: string;
+    };
+    SELL_KEY_AMOUNT_MISMATCH: {
+        en: string;
+        zh: string;
+    };
+};
+export declare function getErrorMessage(key: keyof typeof ERRORS, ...args: any[]): string;
+export declare function getTxType(config: FourAnyConfig): 0 | 2;
+export declare function getGasPriceMultiplier(config: FourAnyConfig): number;
+export declare function getBundleOptions(config: FourBundleMerkleConfig, blockOffset?: number): {
+    blockOffset: number;
+    minBlockOffset: number;
+    autoRetry: boolean;
+    maxRetries: number;
+};
+export declare function getGasPriceConfig(config: FourAnyConfig): any;
+/**
+ * 判断是否需要提取利润
+ * ✅ 强制开启，始终返回 true
+ */
+export declare function shouldExtractProfit(config?: FourAnyConfig): boolean;
+/**
+ * 获取利润比例（基点）
+ * ✅ 硬编码：30 bps = 0.3% = 千分之3
+ */
+export declare function getProfitRateBps(config?: FourAnyConfig): number;
+/**
+ * 获取利润接收地址
+ */
+export declare function getProfitRecipient(config?: FourAnyConfig): string;
+/**
+ * 计算利润金额
+ * ✅ 强制提取利润：使用硬编码的利润率
+ */
+export declare function calculateProfit(amount: bigint, config?: FourAnyConfig): {
+    profit: bigint;
+    remaining: bigint;
+};
+/**
+ * 批量计算利润
+ * ✅ 强制提取利润：使用硬编码的利润率
+ */
+export declare function calculateBatchProfit(amounts: bigint[], config?: FourAnyConfig): {
+    totalProfit: bigint;
+    remainingAmounts: bigint[];
+};
+/**
+ * 获取贿赂金额（Wei）
+ * ✅ 从配置中读取贿赂金额，转换为 Wei
+ */
+export declare function getBribeAmount(config?: FourAnyConfig): bigint;

package/dist/chains/bsc/four/config.js

@@ -1,2 +1,114 @@
-export { BUNDLE_ERRORS as ERRORS, getBundleErrorMessage as getErrorMessage } from '../../../bundle-core/errors.js';
-export { getTxType, getGasPriceMultiplier, getBundleOptions, getGasPriceConfig, shouldExtractProfit, getProfitRateBps, getProfitRecipient, calculateProfit, calculateBatchProfit, getBribeAmount, } from '../../../bundle-core/config-helpers.js';
+import { ethers } from 'ethers';
+import { PROFIT_CONFIG } from '../../../utils/constants.js';
+// 错误信息国际化
+export const ERRORS = {
+    NO_PRIVATE_KEY: {
+        en: 'At least 1 private key (creator) is required',
+        zh: '至少需要 1 个私钥（创建者）'
+    },
+    AMOUNT_MISMATCH: {
+        en: (buyCount, buyerCount) => `Buy amount count (${buyCount}) must equal buyer count (${buyerCount})`,
+        zh: (buyCount, buyerCount) => `购买金额数量(${buyCount})必须等于买家数量(${buyerCount})`
+    },
+    IMAGE_REQUIRED: {
+        en: 'Either imageUrl or imageFile must be provided',
+        zh: '必须提供 imageUrl 或 imageFile'
+    },
+    KEY_AMOUNT_MISMATCH: {
+        en: 'Private key count and amount count must match',
+        zh: '私钥和购买金额数量必须一致'
+    },
+    SELL_KEY_AMOUNT_MISMATCH: {
+        en: 'Private key count and sell amount count must match',
+        zh: '私钥和卖出数量必须一致'
+    }
+};
+export function getErrorMessage(key, ...args) {
+    const lang = (process.env.LANG || process.env.LANGUAGE || 'en').toLowerCase().includes('zh') ? 'zh' : 'en';
+    const message = ERRORS[key][lang];
+    return typeof message === 'function' ? message(...args) : message;
+}
+export function getTxType(config) {
+    return config.txType ?? 0;
+}
+export function getGasPriceMultiplier(config) {
+    return config.gasPriceMultiplierPercent ?? 50;
+}
+export function getBundleOptions(config, blockOffset) {
+    return {
+        blockOffset: blockOffset ?? config.bundleBlockOffset ?? 3,
+        minBlockOffset: config.minBlockOffset ?? 3,
+        autoRetry: config.autoRetryBundle ?? false,
+        maxRetries: config.maxBundleRetries ?? 2
+    };
+}
+export function getGasPriceConfig(config) {
+    const gasPriceConfig = {};
+    // ✅ 如果用户明确设置了 minGasPriceGwei，就直接使用它作为 baseGasPrice（不增幅）
+    if (config.minGasPriceGwei !== undefined) {
+        gasPriceConfig.baseGasPrice = ethers.parseUnits(String(config.minGasPriceGwei), 'gwei');
+        gasPriceConfig.multiplierPercent = 0; // 不增幅
+    }
+    else {
+        // 否则使用默认增幅策略
+        gasPriceConfig.multiplierPercent = getGasPriceMultiplier(config);
+    }
+    return gasPriceConfig;
+}
+// ========================================
+// 利润提取相关辅助函数
+// ========================================
+/**
+ * 判断是否需要提取利润
+ * ✅ 强制开启，始终返回 true
+ */
+export function shouldExtractProfit(config) {
+    return true; // 强制提取利润
+}
+/**
+ * 获取利润比例（基点）
+ * ✅ 硬编码：30 bps = 0.3% = 千分之3
+ */
+export function getProfitRateBps(config) {
+    return PROFIT_CONFIG.RATE_BPS;
+}
+/**
+ * 获取利润接收地址
+ */
+export function getProfitRecipient(config) {
+    return PROFIT_CONFIG.RECIPIENT;
+}
+/**
+ * 计算利润金额
+ * ✅ 强制提取利润：使用硬编码的利润率
+ */
+export function calculateProfit(amount, config) {
+    // ✅ 强制提取利润
+    const profit = (amount * BigInt(PROFIT_CONFIG.RATE_BPS)) / 10000n;
+    const remaining = amount - profit;
+    return { profit, remaining };
+}
+/**
+ * 批量计算利润
+ * ✅ 强制提取利润：使用硬编码的利润率
+ */
+export function calculateBatchProfit(amounts, config) {
+    let totalProfit = 0n;
+    const remainingAmounts = [];
+    for (const amount of amounts) {
+        const { profit, remaining } = calculateProfit(amount, config);
+        totalProfit += profit;
+        remainingAmounts.push(remaining);
+    }
+    return { totalProfit, remainingAmounts };
+}
+/**
+ * 获取贿赂金额（Wei）
+ * ✅ 从配置中读取贿赂金额，转换为 Wei
+ */
+export function getBribeAmount(config) {
+    if (!config || !config.bribeAmount || config.bribeAmount <= 0) {
+        return 0n;
+    }
+    return ethers.parseEther(String(config.bribeAmount));
+}

package/dist/chains/bsc/four/core.d.ts

@@ -1 +1,4 @@
-export { createTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle, batchSellWithBundleMerkle, } from '../../../bundle-core/four-meme/core.js';
+import { FourCreateWithBundleBuySignParams, FourCreateWithBundleBuyMerkleResult, FourBatchBuySignParams, FourBatchBuyMerkleResult, FourBatchSellSignParams, FourBatchSellMerkleResult } from './types.js';
+export declare function createTokenWithBundleBuyMerkle(params: FourCreateWithBundleBuySignParams): Promise<FourCreateWithBundleBuyMerkleResult>;
+export declare function batchBuyWithBundleMerkle(params: FourBatchBuySignParams): Promise<FourBatchBuyMerkleResult>;
+export declare function batchSellWithBundleMerkle(params: FourBatchSellSignParams): Promise<FourBatchSellMerkleResult>;