four-flap-meme-sdk 2.1.0 → 2.2.1

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

@@ -31,4 +31,34 @@ describe('subpath exports (package.json exports map)', () => {
         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/bundle-core/config-helpers.d.ts

@@ -22,14 +22,14 @@ export declare function getBundleOptions(config: BundleMerkleConfigInput, blockO
     maxRetries: number;
 };
 export declare function getGasPriceConfig(config: BundleGasConfigInput): GasPriceConfig;
-export declare function shouldExtractProfit(_config?: unknown): boolean;
-export declare function getProfitRateBps(_config?: unknown): number;
-export declare function getProfitRecipient(_config?: unknown): string;
-export declare function calculateProfit(amount: bigint, _config?: unknown): {
+export declare function shouldExtractProfit(_config?: BundleMerkleConfigInput): boolean;
+export declare function getProfitRateBps(_config?: BundleMerkleConfigInput): number;
+export declare function getProfitRecipient(_config?: BundleMerkleConfigInput): string;
+export declare function calculateProfit(amount: bigint, _config?: BundleMerkleConfigInput): {
     profit: bigint;
     remaining: bigint;
 };
-export declare function calculateBatchProfit(amounts: bigint[], _config?: unknown): {
+export declare function calculateBatchProfit(amounts: bigint[], _config?: BundleMerkleConfigInput): {
     totalProfit: bigint;
     remainingAmounts: bigint[];
 };

package/dist/bundle-core/errors.js

@@ -26,7 +26,8 @@ export function getBundleErrorMessage(key, ...args) {
     const lang = (process.env.LANG || process.env.LANGUAGE || 'en').toLowerCase().includes('zh') ? 'zh' : 'en';
     const message = BUNDLE_ERRORS[key][lang];
     if (typeof message === 'function') {
-        return message(...args);
+        const [a, b] = args;
+        return message(a, b);
     }
     return message;
 }

package/dist/chains/bsc/iro.d.ts

@@ -0,0 +1,5 @@
+/**
+ * BSC IRO 平台子路径（与包根 `bscIro*` 扁平别名一致）
+ */
+export { IroFactoryQuery as BscIroFactoryQuery, createProject as bscIroCreateProject, encodeCreateProjectCall as bscIroEncodeCreateProjectCall, parseCreateProjectEvent as bscIroParseCreateProjectEvent, IroTokenQuery as BscIroTokenQuery, subscribe as bscIroSubscribe, pledge as bscIroPledge, batchSubscribe as bscIroBatchSubscribe, batchSubscribeForSubmit as bscIroBatchSubscribeForSubmit, IroPoolQuery as BscIroPoolQuery, poolRemovePledge as bscIroPoolRemovePledge, poolExtract as bscIroPoolExtract, poolTransferAwards as bscIroPoolTransferAwards, batchExtract as bscIroBatchExtract, IRO_FACTORY_ADDRESS as BSC_IRO_FACTORY_ADDRESS, IRO_FACTORY_ABI as BSC_IRO_FACTORY_ABI, IRO_TOKEN_ABI as BSC_IRO_TOKEN_ABI, IRO_POOL_ABI as BSC_IRO_POOL_ABI, IRO_PLATFORM_URL as BSC_IRO_PLATFORM_URL, IRO_TESTNET_PLATFORM_URL as BSC_IRO_TESTNET_PLATFORM_URL, setIroApiBase as setBscIroApiBase, setIroTestApiBase as setBscIroTestApiBase, iroApiCreateProject as bscIroApiCreateProject, iroApiUploadImage as bscIroApiUploadImage, } from './platforms/iro/index.js';
+export type { WhiteListQuota as BscIroWhiteListQuota, IroCreateProjectParams as BscIroCreateProjectParams, IroFactoryTokenInfo as BscIroFactoryTokenInfo, IroSubscribeParams as BscIroSubscribeParams, IroPledgeParams as BscIroPledgeParams, IroTokenPrice as BscIroTokenPrice, IroPoolRemovePledgeParams as BscIroPoolRemovePledgeParams, IroPoolExtractParams as BscIroPoolExtractParams, IroPoolTransferAwardsParams as BscIroPoolTransferAwardsParams, IroTokenInfo as BscIroTokenInfo, IroTxResult as BscIroTxResult, IroCreateProjectResult as BscIroCreateProjectResult, IroQueryConfig as BscIroQueryConfig, IroCreateParams as BscIroCreateParams, IroApiCreateProjectRequest as BscIroApiCreateProjectRequest, IroBatchSubscribeForSubmitParams as BscIroBatchSubscribeForSubmitParams, IroBatchSubscribeForSubmitResult as BscIroBatchSubscribeForSubmitResult, } from './platforms/iro/index.js';

package/dist/chains/bsc/iro.js

@@ -0,0 +1,4 @@
+/**
+ * BSC IRO 平台子路径（与包根 `bscIro*` 扁平别名一致）
+ */
+export { IroFactoryQuery as BscIroFactoryQuery, createProject as bscIroCreateProject, encodeCreateProjectCall as bscIroEncodeCreateProjectCall, parseCreateProjectEvent as bscIroParseCreateProjectEvent, IroTokenQuery as BscIroTokenQuery, subscribe as bscIroSubscribe, pledge as bscIroPledge, batchSubscribe as bscIroBatchSubscribe, batchSubscribeForSubmit as bscIroBatchSubscribeForSubmit, IroPoolQuery as BscIroPoolQuery, poolRemovePledge as bscIroPoolRemovePledge, poolExtract as bscIroPoolExtract, poolTransferAwards as bscIroPoolTransferAwards, batchExtract as bscIroBatchExtract, IRO_FACTORY_ADDRESS as BSC_IRO_FACTORY_ADDRESS, IRO_FACTORY_ABI as BSC_IRO_FACTORY_ABI, IRO_TOKEN_ABI as BSC_IRO_TOKEN_ABI, IRO_POOL_ABI as BSC_IRO_POOL_ABI, IRO_PLATFORM_URL as BSC_IRO_PLATFORM_URL, IRO_TESTNET_PLATFORM_URL as BSC_IRO_TESTNET_PLATFORM_URL, setIroApiBase as setBscIroApiBase, setIroTestApiBase as setBscIroTestApiBase, iroApiCreateProject as bscIroApiCreateProject, iroApiUploadImage as bscIroApiUploadImage, } from './platforms/iro/index.js';

package/dist/chains/bsc/pancake/bundle-swap-helpers.d.ts

@@ -101,7 +101,7 @@ export type BalanceValidationParams = {
     buyerAddress?: string;
 };
 export declare function validateFinalBalances({ sameAddress, buyerBalance, buyAmountBNB, reserveGas, gasLimit, gasPrice, useNativeToken, quoteTokenDecimals, provider, buyerAddress, }: BalanceValidationParams): Promise<void>;
-export declare function countTruthy(values: unknown[]): number;
+export declare function countTruthy(values: Array<string | number | bigint | boolean | null | undefined>): number;
 /**
  * PancakeSwap V2/V3 通用捆绑换手（Merkle Bundle）
  *

package/dist/chains/bsc/platforms/iro/factory.d.ts

@@ -6,7 +6,7 @@
  * - 查询: 通过 projectId / token 地址获取信息
  */
 import { JsonRpcProvider } from 'ethers';
-import type { IroCreateParams, IroCreateProjectResult, IroQueryConfig, IroFactoryTokenInfo } from './types.js';
+import type { IroCreateParams, IroCreateProjectResult, IroQueryConfig, IroFactoryTokenInfo, IroCreateProjectParams } from './types.js';
 export declare class IroFactoryQuery {
     private provider;
     private factory;
@@ -31,7 +31,7 @@ export declare class IroFactoryQuery {
 /**
  * 编码 createProject calldata
  */
-export declare function encodeCreateProjectCall(params: import('./types.js').IroCreateProjectParams): string;
+export declare function encodeCreateProjectCall(params: IroCreateProjectParams): string;
 /**
  * 创建 IRO 项目 — 签名交易
  *

package/dist/chains/eni/bundler/sign.js

@@ -3,7 +3,7 @@
  *
  * 各钱包离线签署操作意图，主钱包收集后统一提交。
  */
-import { Wallet, JsonRpcProvider } from 'ethers';
+import { Wallet, JsonRpcProvider, Interface } from 'ethers';
 import { ENI_CHAIN_ID, ENI_RPC_URL } from '../constants.js';
 import { ENI_BUNDLER_ABI, EIP712_DOMAIN, SIGNED_OP_TYPE, TOKEN_PULL_TYPE } from './constants.js';
 const DEFAULT_DEADLINE_SEC = 300;
@@ -19,7 +19,6 @@ function buildDomain(bundlerAddress, chainId = Number(ENI_CHAIN_ID)) {
  */
 export async function getBundlerNonce(params) {
     const provider = new JsonRpcProvider(params.rpcUrl ?? ENI_RPC_URL, ENI_CHAIN_ID, { staticNetwork: true });
-    const { Interface } = await import('ethers');
     const iface = new Interface(ENI_BUNDLER_ABI);
     const data = iface.encodeFunctionData('nonces', [params.signer]);
     const result = await provider.call({ to: params.bundlerAddress, data });

package/dist/chains/eni/flat-aliases.d.ts

@@ -0,0 +1,10 @@
+/**
+ * ENI 包根扁平别名（子路径 `four-flap-meme-sdk/chains/eni` 可直接 import）
+ *
+ * 与 `root-eni-and-bsc-iro.ts` 中 `eni*` / `Eni*` 命名对齐，避免为 ENI 拉包根。
+ */
+export { DaoaasPortalQuery as EniPortalQuery, createPortalQuery as eniCreatePortalQuery, encodeBuyCall as eniEncodeBuyCall, encodeSellCall as eniEncodeSellCall, encodeCreateCall as eniEncodeCreateCall, applySlippage as eniApplySlippage, formatEgas as eniFormatEgas, parseEgas as eniParseEgas, directBuy as eniDirectBuy, directSell as eniDirectSell, directBatchBuy as eniDirectBatchBuy, directBatchSell as eniDirectBatchSell, directBuyForSubmit as eniDirectBuyForSubmit, directSellForSubmit as eniDirectSellForSubmit, directBatchBuyForSubmit as eniDirectBatchBuyForSubmit, directBatchSellForSubmit as eniDirectBatchSellForSubmit, directQuickSwap as eniDirectQuickSwap, directQuickSwapForSubmit as eniDirectQuickSwapForSubmit, buildProfitTransfer as eniBuildProfitTransfer, createToken as eniCreateToken, createTokenForSubmit as eniCreateTokenForSubmit, getGraduationInfo as eniGetGraduationInfo, batchGetGraduationInfo as eniBatchGetGraduationInfo, getTokenMeta as eniGetTokenMeta, getFairLaunchTokenMeta as eniGetFairLaunchTokenMeta, getTokenMetasBatch as eniGetTokenMetasBatch, DaoaasTokenStatus as EniDaoaasTokenStatus, } from './platforms/daoaas/index.js';
+export type { DaoaasTokenState as EniDaoaasTokenState, DaoaasBuyParams as EniDaoaasBuyParams, DaoaasSellParams as EniDaoaasSellParams, DaoaasCreateParams as EniDaoaasCreateParams, PortalQueryConfig as EniPortalQueryConfig, GraduationInfo as EniGraduationInfo, DaoaasTokenMeta as EniDaoaasTokenMeta, } from './platforms/daoaas/index.js';
+export { eniDisperseForSubmit, eniSweepForSubmit, batchTransferEgas, batchSweepEgas, batchSweepToken, } from './batch-router/index.js';
+export type { EniDisperseParams, EniDisperseResult, EniSweepParams, EniSweepResult } from './batch-router/index.js';
+export * as EniBatchRouter from './batch-router/index.js';

package/dist/chains/eni/flat-aliases.js

@@ -0,0 +1,8 @@
+/**
+ * ENI 包根扁平别名（子路径 `four-flap-meme-sdk/chains/eni` 可直接 import）
+ *
+ * 与 `root-eni-and-bsc-iro.ts` 中 `eni*` / `Eni*` 命名对齐，避免为 ENI 拉包根。
+ */
+export { DaoaasPortalQuery as EniPortalQuery, createPortalQuery as eniCreatePortalQuery, encodeBuyCall as eniEncodeBuyCall, encodeSellCall as eniEncodeSellCall, encodeCreateCall as eniEncodeCreateCall, applySlippage as eniApplySlippage, formatEgas as eniFormatEgas, parseEgas as eniParseEgas, directBuy as eniDirectBuy, directSell as eniDirectSell, directBatchBuy as eniDirectBatchBuy, directBatchSell as eniDirectBatchSell, directBuyForSubmit as eniDirectBuyForSubmit, directSellForSubmit as eniDirectSellForSubmit, directBatchBuyForSubmit as eniDirectBatchBuyForSubmit, directBatchSellForSubmit as eniDirectBatchSellForSubmit, directQuickSwap as eniDirectQuickSwap, directQuickSwapForSubmit as eniDirectQuickSwapForSubmit, buildProfitTransfer as eniBuildProfitTransfer, createToken as eniCreateToken, createTokenForSubmit as eniCreateTokenForSubmit, getGraduationInfo as eniGetGraduationInfo, batchGetGraduationInfo as eniBatchGetGraduationInfo, getTokenMeta as eniGetTokenMeta, getFairLaunchTokenMeta as eniGetFairLaunchTokenMeta, getTokenMetasBatch as eniGetTokenMetasBatch, DaoaasTokenStatus as EniDaoaasTokenStatus, } from './platforms/daoaas/index.js';
+export { eniDisperseForSubmit, eniSweepForSubmit, batchTransferEgas, batchSweepEgas, batchSweepToken, } from './batch-router/index.js';
+export * as EniBatchRouter from './batch-router/index.js';

package/dist/chains/eni/index.d.ts

@@ -20,3 +20,4 @@ export { getLPPairInfo, batchGetLPPairInfo, getPairAddress, addLiquidityETHForSu
 export type { LPPairInfo, GetLPInfoParams, BatchGetLPInfoParams, AddLiquidityETHParams, RemoveLiquidityETHParams, AddLiquidityParams, RemoveLiquidityParams, LiquidityTxResult, LiquidityForSubmitResult, } from './platforms/dswap/index.js';
 export { IroFactoryQuery as EniIroFactoryQuery, encodeCreateProjectCall as eniIroEncodeCreateProjectCall, createProject as eniIroCreateProject, parseCreateProjectEvent as eniIroParseCreateProjectEvent, IroTokenQuery as EniIroTokenQuery, subscribe as eniIroSubscribe, pledge as eniIroPledge, batchSubscribe as eniIroBatchSubscribe, batchSubscribeForSubmit as eniIroBatchSubscribeForSubmit, IroPoolQuery as EniIroPoolQuery, poolRemovePledge as eniIroPoolRemovePledge, poolExtract as eniIroPoolExtract, poolTransferAwards as eniIroPoolTransferAwards, batchExtract as eniIroBatchExtract, ENI_IRO_FACTORY_ADDRESS, ENI_IRO_OWNER_ADDRESS, ENI_IRO_SELL_FEE_CONTRACT, ENI_IROSWAP_V2_ROUTER, ENI_IROSWAP_V2_FACTORY, IRO_FACTORY_ABI as ENI_IRO_FACTORY_ABI, IRO_TOKEN_ABI as ENI_IRO_TOKEN_ABI, IRO_POOL_ABI as ENI_IRO_POOL_ABI, CREATE_PROJECT_GAS_LIMIT as ENI_CREATE_PROJECT_GAS_LIMIT, ENI_IRO_PLATFORM_URL, setIroApiBase as setEniIroApiBase, iroApiCreateProject as eniIroApiCreateProject, iroApiUploadImage as eniIroApiUploadImage, getTokenWhiteList as eniIroGetTokenWhiteList, addTokenWhiteListForSubmit as eniIroAddTokenWhiteListForSubmit, batchAddTokenWhiteListForSubmit as eniIroBatchAddTokenWhiteListForSubmit, removeTokenWhiteListForSubmit as eniIroRemoveTokenWhiteListForSubmit, IRO_OWNER_WHITELIST_ABI as ENI_IRO_OWNER_WHITELIST_ABI, } from './platforms/iro/index.js';
 export type { WhiteListQuota as EniWhiteListQuota, IroCreateProjectParams as EniIroCreateProjectParams, IroSubscribeParams as EniIroSubscribeParams, IroPledgeParams as EniIroPledgeParams, IroTokenInfo as EniIroTokenInfo, IroTxResult as EniIroTxResult, IroCreateProjectResult as EniIroCreateProjectResult, IroQueryConfig as EniIroQueryConfig, IroCreateParams as EniIroCreateParams, IroBatchSubscribeForSubmitParams as EniIroBatchSubscribeForSubmitParams, IroBatchSubscribeForSubmitResult as EniIroBatchSubscribeForSubmitResult, WhitelistManageConfig as EniWhitelistManageConfig, AddWhitelistParams as EniAddWhitelistParams, BatchAddWhitelistParams as EniBatchAddWhitelistParams, RemoveWhitelistParams as EniRemoveWhitelistParams, GetWhitelistParams as EniGetWhitelistParams, } from './platforms/iro/index.js';
+export * from './flat-aliases.js';

package/dist/chains/eni/index.js

@@ -31,3 +31,4 @@ export { getLPPairInfo, batchGetLPPairInfo, getPairAddress, addLiquidityETHForSu
 // 快捷导出 - IRO (Initial Rights Offering)
 // ============================================================================
 export { IroFactoryQuery as EniIroFactoryQuery, encodeCreateProjectCall as eniIroEncodeCreateProjectCall, createProject as eniIroCreateProject, parseCreateProjectEvent as eniIroParseCreateProjectEvent, IroTokenQuery as EniIroTokenQuery, subscribe as eniIroSubscribe, pledge as eniIroPledge, batchSubscribe as eniIroBatchSubscribe, batchSubscribeForSubmit as eniIroBatchSubscribeForSubmit, IroPoolQuery as EniIroPoolQuery, poolRemovePledge as eniIroPoolRemovePledge, poolExtract as eniIroPoolExtract, poolTransferAwards as eniIroPoolTransferAwards, batchExtract as eniIroBatchExtract, ENI_IRO_FACTORY_ADDRESS, ENI_IRO_OWNER_ADDRESS, ENI_IRO_SELL_FEE_CONTRACT, ENI_IROSWAP_V2_ROUTER, ENI_IROSWAP_V2_FACTORY, IRO_FACTORY_ABI as ENI_IRO_FACTORY_ABI, IRO_TOKEN_ABI as ENI_IRO_TOKEN_ABI, IRO_POOL_ABI as ENI_IRO_POOL_ABI, CREATE_PROJECT_GAS_LIMIT as ENI_CREATE_PROJECT_GAS_LIMIT, ENI_IRO_PLATFORM_URL, setIroApiBase as setEniIroApiBase, iroApiCreateProject as eniIroApiCreateProject, iroApiUploadImage as eniIroApiUploadImage, getTokenWhiteList as eniIroGetTokenWhiteList, addTokenWhiteListForSubmit as eniIroAddTokenWhiteListForSubmit, batchAddTokenWhiteListForSubmit as eniIroBatchAddTokenWhiteListForSubmit, removeTokenWhiteListForSubmit as eniIroRemoveTokenWhiteListForSubmit, IRO_OWNER_WHITELIST_ABI as ENI_IRO_OWNER_WHITELIST_ABI, } from './platforms/iro/index.js';
+export * from './flat-aliases.js';

package/dist/chains/eni/platforms/daoaas/meta.js

@@ -5,7 +5,8 @@
  * 提供代币 Logo、社交链接、描述等元信息查询
  */
 import { Contract, JsonRpcProvider } from 'ethers';
-import { ENI_CHAIN_ID, ENI_RPC_URL } from '../../constants.js';
+import { ENI_CHAIN_ID, ENI_RPC_URL, LP_FAIR_LAUNCHER_ABI } from '../../constants.js';
+import { LP_FAIR_LAUNCHER_ADDRESS } from '../fair-launch/constants.js';
 import { ERC20_ABI } from '../../../../abis/common.js';
 /**
  * 从 ERC20 合约获取 DAOaaS Portal 代币基本元数据
@@ -41,8 +42,6 @@ export async function getTokenMeta(token, rpcUrl = ENI_RPC_URL) {
  * FairLaunch 代币的 logo 和 metadata 存储在 LaunchParams 中
  */
 export async function getFairLaunchTokenMeta(token, rpcUrl = ENI_RPC_URL) {
-    const { LP_FAIR_LAUNCHER_ABI } = await import('../../constants.js');
-    const { LP_FAIR_LAUNCHER_ADDRESS } = await import('../fair-launch/constants.js');
     const provider = new JsonRpcProvider(rpcUrl, ENI_CHAIN_ID, { staticNetwork: true });
     const launcher = new Contract(LP_FAIR_LAUNCHER_ADDRESS, LP_FAIR_LAUNCHER_ABI, provider);
     const info = await launcher.getTokenInfoByToken(token);

package/dist/chains/eni/platforms/iro/factory.d.ts

@@ -4,7 +4,7 @@
  * ENI 使用 EIP-1559 (type 2) 交易，与 BSC (type 0) 不同
  */
 import { JsonRpcProvider } from 'ethers';
-import type { IroCreateParams, IroCreateProjectResult, IroQueryConfig, IroFactoryTokenInfo } from './types.js';
+import type { IroCreateParams, IroCreateProjectResult, IroQueryConfig, IroFactoryTokenInfo, IroCreateProjectParams } from './types.js';
 export declare class IroFactoryQuery {
     private provider;
     private factory;
@@ -20,7 +20,7 @@ export declare class IroFactoryQuery {
     }>;
     get providerInstance(): JsonRpcProvider;
 }
-export declare function encodeCreateProjectCall(params: import('./types.js').IroCreateProjectParams): string;
+export declare function encodeCreateProjectCall(params: IroCreateProjectParams): string;
 export declare function createProject(params: IroCreateParams): Promise<IroCreateProjectResult>;
 export declare function parseCreateProjectEvent(receipt: {
     logs: Array<{

package/dist/chains/xlayer/eip7702/bundle-sell.js

@@ -237,23 +237,12 @@ export async function bundleSell(params) {
     // 判断是否需要查询代币余额
     const needBalanceQuery = !sellAmounts || sellAmounts.length !== wallets.length;
     // 构建并行请求
-    const parallelPromises = [
-        // 1. 批量获取授权钱包的 nonce
+    const [walletNonces, mainNonce, feeData, tokenBalances] = await Promise.all([
         batchGetNonces(allAddresses, provider),
-        // 2. 获取主钱包的交易 nonce
         provider.getTransactionCount(mainWallet.address, 'pending'),
-        // 3. 获取 gas 费用数据
         provider.getFeeData(),
-    ];
-    // 4. 如果需要查询余额，并行获取
-    if (needBalanceQuery) {
-        parallelPromises.push(getTokenBalances(wallets, tokenAddress));
-    }
-    const results = await Promise.all(parallelPromises);
-    const walletNonces = results[0];
-    const mainNonce = results[1];
-    const feeData = results[2];
-    const tokenBalances = needBalanceQuery ? results[3] : null;
+        needBalanceQuery ? getTokenBalances(wallets, tokenAddress) : Promise.resolve(null),
+    ]);
     // ========================================
     // 同步计算卖出数量
     // ========================================

package/dist/chains/xlayer/eip7702/flat-aliases.d.ts

@@ -0,0 +1,13 @@
+/**
+ * EIP-7702 包根扁平别名（与 `root-swap-dex-and-xlayer.ts` 对齐）
+ */
+export { bundleBuy as xlayerEip7702BundleBuy } from './bundle-buy.js';
+export { bundleSell as xlayerEip7702BundleSell } from './bundle-sell.js';
+export { bundleApprove as xlayerEip7702BundleApprove, bundleApproveMultiSpenders as xlayerEip7702BundleApproveMultiSpenders, checkApprovalStatus as xlayerEip7702CheckApprovalStatus, } from './bundle-approve.js';
+export { bundleSwap as xlayerEip7702BundleSwap, bundleBatchSwap as xlayerEip7702BundleBatchSwap, bundleMultiSwap as xlayerEip7702BundleMultiSwap, } from './bundle-swap.js';
+export { disperse as xlayerEip7702Disperse, sweep as xlayerEip7702Sweep, pairwiseTransfer as xlayerEip7702PairwiseTransfer, disperseWithHops as xlayerEip7702DisperseWithHops, sweepWithHops as xlayerEip7702SweepWithHops, } from './multi-hop-transfer.js';
+export { washVolume as xlayerEip7702WashVolume, bundleVolume as xlayerEip7702BundleVolume, singleRoundVolume as xlayerEip7702SingleRoundVolume, makeVolume as xlayerEip7702MakeVolume, makeVolumeWithSwap as xlayerEip7702MakeVolumeWithSwap, } from './volume.js';
+export { bundleCreateBuy as xlayerEip7702BundleCreateBuy, bundleCreateToDex as xlayerEip7702BundleCreateToDex, bundleGraduateBuy as xlayerEip7702BundleGraduateBuy, } from './bundle-create.js';
+export type { TradeType as XLayerEip7702TradeType, BundleBuyParams as XLayerEip7702BundleBuyParams, BundleSellParams as XLayerEip7702BundleSellParams, BundleSwapParams as XLayerEip7702BundleSwapParams, BundleMultiSwapParams as XLayerEip7702BundleMultiSwapParams, DisperseParams as XLayerEip7702DisperseParams, SweepParams as XLayerEip7702SweepParams, EIP7702Config as XLayerEip7702Config, } from './types.js';
+export type { PairwiseTransferParams as XLayerEip7702PairwiseTransferParams } from './multi-hop-transfer.js';
+export type { WashVolumeParams as XLayerEip7702WashVolumeParams, BundleVolumeParams as XLayerEip7702BundleVolumeParams, } from './volume.js';

package/dist/chains/xlayer/eip7702/flat-aliases.js

@@ -0,0 +1,10 @@
+/**
+ * EIP-7702 包根扁平别名（与 `root-swap-dex-and-xlayer.ts` 对齐）
+ */
+export { bundleBuy as xlayerEip7702BundleBuy } from './bundle-buy.js';
+export { bundleSell as xlayerEip7702BundleSell } from './bundle-sell.js';
+export { bundleApprove as xlayerEip7702BundleApprove, bundleApproveMultiSpenders as xlayerEip7702BundleApproveMultiSpenders, checkApprovalStatus as xlayerEip7702CheckApprovalStatus, } from './bundle-approve.js';
+export { bundleSwap as xlayerEip7702BundleSwap, bundleBatchSwap as xlayerEip7702BundleBatchSwap, bundleMultiSwap as xlayerEip7702BundleMultiSwap, } from './bundle-swap.js';
+export { disperse as xlayerEip7702Disperse, sweep as xlayerEip7702Sweep, pairwiseTransfer as xlayerEip7702PairwiseTransfer, disperseWithHops as xlayerEip7702DisperseWithHops, sweepWithHops as xlayerEip7702SweepWithHops, } from './multi-hop-transfer.js';
+export { washVolume as xlayerEip7702WashVolume, bundleVolume as xlayerEip7702BundleVolume, singleRoundVolume as xlayerEip7702SingleRoundVolume, makeVolume as xlayerEip7702MakeVolume, makeVolumeWithSwap as xlayerEip7702MakeVolumeWithSwap, } from './volume.js';
+export { bundleCreateBuy as xlayerEip7702BundleCreateBuy, bundleCreateToDex as xlayerEip7702BundleCreateToDex, bundleGraduateBuy as xlayerEip7702BundleGraduateBuy, } from './bundle-create.js';

package/dist/chains/xlayer/eip7702/index.d.ts

@@ -15,8 +15,7 @@
  */
 export * from './constants.js';
 export * from './types.js';
-/** 与包根 `XLayerEip7702TradeType` 别名一致，便于子路径引用 */
-export type { TradeType as XLayerEip7702TradeType } from './types.js';
+export * from './flat-aliases.js';
 export { bigintToBytes, addressToBytes, hexToBytes, trimLeadingZeros, getCachedProvider, clearProviderCache, createWallet, generateRandomWallet, generateRandomWallets, signAuthorization, signAuthorizationWithNonce, signAuthorizationsBatch, buildEIP7702Transaction, estimateGasLimit, estimateGasLimitSimple, calculateProfitAmount, calculateProfitAmountByUserType, calculateProfitAmountByTxCount, getProfitRateBps, getProfitRateBpsDouble, getProfitRecipient, getDeadline, delay, type UserType, type OperationType, } from './utils.js';
 export { bundleBuy } from './bundle-buy.js';
 export { bundleSell } from './bundle-sell.js';

package/dist/chains/xlayer/eip7702/index.js

@@ -21,6 +21,7 @@ export * from './constants.js';
 // 类型
 // ============================================================================
 export * from './types.js';
+export * from './flat-aliases.js';
 // ============================================================================
 // 工具函数
 // ============================================================================

package/dist/chains/xlayer/eip7702/multi-hop-transfer-helpers.d.ts

@@ -18,7 +18,7 @@ import { UserType } from './utils.js';
 export interface TransferResult {
     signedTransaction: string;
     hopWallets?: GeneratedWallet[];
-    metadata: Record<string, unknown>;
+    metadata: Record<string, string | number | boolean | bigint | null | undefined>;
 }
 export interface DisperseParams {
     /** 资金来源钱包私钥（Token/OKB 从这个钱包转出） */

package/dist/chains/xlayer/eip7702/multi-hop-transfer.js

@@ -210,22 +210,21 @@ export async function sweep(params) {
     // ========================================
     const sourceAddresses = sourceWallets.map((w) => w.address);
     const addressesToGetNonces = payerWallet ? [payerWallet.address, ...sourceAddresses] : sourceAddresses;
-    const parallelPromises = [batchGetNonces(addressesToGetNonces, provider), provider.getFeeData()];
-    if (isNative) {
-        parallelPromises.push(Promise.all(sourceWallets.map((w) => provider.getBalance(w.address))));
-    }
-    else {
-        if (!tokenAddress)
-            throw new Error('tokenAddress is required for ERC20 sweep');
-        const tokenContract = new Contract(tokenAddress, ERC20_ABI, provider);
-        parallelPromises.push(Promise.all(sourceWallets.map((w) => tokenContract.balanceOf(w.address))));
-    }
-    const results = await Promise.all(parallelPromises);
-    const allNoncesResult = results[0];
+    const [allNoncesResult, feeData, balancesRaw] = await Promise.all([
+        batchGetNonces(addressesToGetNonces, provider),
+        provider.getFeeData(),
+        isNative
+            ? Promise.all(sourceWallets.map((w) => provider.getBalance(w.address)))
+            : Promise.all(sourceWallets.map((w) => {
+                if (!tokenAddress)
+                    throw new Error('tokenAddress is required for ERC20 sweep');
+                const tokenContract = new Contract(tokenAddress, ERC20_ABI, provider);
+                return tokenContract.balanceOf(w.address);
+            })),
+    ]);
     const payerNonce = payerWallet ? allNoncesResult[0] : allNoncesResult[0];
     const nonces = payerWallet ? allNoncesResult.slice(1) : allNoncesResult;
-    const feeData = results[1];
-    const balances = results[2].map((b) => typeof b === 'bigint' ? b : BigInt(b.toString()));
+    const balances = balancesRaw;
     // 计算转账金额
     // ✅ 修复：当 percent=100 时，不预留 gas，归集全部余额
     const isFullSweep = percent >= 100;

package/dist/chains/xlayer/eip7702/volume.js

@@ -7,6 +7,7 @@ import { UNIFIED_DELEGATE_ADDRESS, UNIFIED_DELEGATE_ABI, FLAP_PORTAL_ABI, FLAP_P
 import { bundleBuy } from './bundle-buy.js';
 import { bundleSell } from './bundle-sell.js';
 import { bundleSwap } from './bundle-swap.js';
+import { quoteV2, quoteV3 } from '../../../utils/quote-helpers.js';
 import { truncateDecimals, } from './volume-helpers.js';
 export async function washVolume(params) {
     const { mainPrivateKey, privateKeys, tokenAddress, tokenDecimals = 18, buyAmountPerWallet, sellPercent = 100, poolType = 'V3', routerAddress, fee = V3_FEE_TIERS.MEDIUM, userType = 'v0', // ✅ 用户类型（影响利润率）
@@ -108,7 +109,6 @@ export async function washVolume(params) {
     else if (poolType === 'V2' || poolType === 'V3') {
         // ✅ V2/V3 外盘模式：通过报价获取预估代币数量，确保买卖对等
         try {
-            const { quoteV2, quoteV3 } = await import('../../../utils/quote-helpers.js');
             let totalTokenAmount = 0n;
             if (poolType === 'V3') {
                 const result = await quoteV3(provider, WOKB_ADDRESS, tokenAddress, totalBuyWei, 'XLAYER', fee);
@@ -258,21 +258,21 @@ export async function bundleVolume(params) {
     const allAddresses = allWallets.map((w) => w.address);
     // 获取卖出钱包的代币余额（如果需要）
     const needBalanceQuery = !sellAmounts || sellAmounts.length !== sellerWallets.length;
-    const parallelPromises = [batchGetNonces(allAddresses, provider), provider.getFeeData()];
-    if (needBalanceQuery && sellerWallets.length > 0) {
-        const tokenContract = new ethers.Contract(tokenAddress, ERC20_ABI, provider);
-        parallelPromises.push(Promise.all(sellerWallets.map((w) => tokenContract.balanceOf(w.address))));
-    }
-    const results = await Promise.all(parallelPromises);
-    const nonces = results[0];
-    const feeData = results[1];
+    const tokenContract = needBalanceQuery && sellerWallets.length > 0 ? new ethers.Contract(tokenAddress, ERC20_ABI, provider) : null;
+    const [nonces, feeData, sellerBalancesRaw] = await Promise.all([
+        batchGetNonces(allAddresses, provider),
+        provider.getFeeData(),
+        needBalanceQuery && sellerWallets.length > 0 && tokenContract
+            ? Promise.all(sellerWallets.map((w) => tokenContract.balanceOf(w.address)))
+            : Promise.resolve(null),
+    ]);
     // 计算卖出金额
     let sellAmountsWei;
     if (sellAmounts && sellAmounts.length === sellerWallets.length) {
         // ✅ 如果有指定卖出金额，直接使用
         sellAmountsWei = sellAmounts.map((amt) => ethers.parseUnits(truncateDecimals(amt, tokenDecimals), tokenDecimals));
     }
-    else if (needBalanceQuery && results[2]) {
+    else if (needBalanceQuery && sellerBalancesRaw) {
         // ✅ 根据 poolType 预估买入能获得的代币数量
         let estimatedTokenAmount = 0n;
         try {

package/dist/chains/xlayer/index.d.ts

@@ -10,5 +10,6 @@ export * as eoa from './eoa/index.js';
 export * as eip7702 from './eip7702/index.js';
 export { PortalQuery, createPortalQuery, xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, xlayerPureCrossSwapMerkle, signEoaWashBuyTransactions, signEoaWashSellTransactions, signEoaWashVolumeTransactions, } from './eoa/index.js';
 export type { BundleSwapParams, BundleSwapSignParams, BundleSwapResult, BundleSwapSignResult, BundleBatchSwapParams, BundleBatchSwapSignParams, BundleBatchSwapResult, BundleBatchSwapSignResult, BuyFirstParams, BuyFirstResult, BuyParams, SellParams, } from './eoa/types.js';
-export { bundleBuy as xlayerEip7702BundleBuy, bundleSell as xlayerEip7702BundleSell, bundleSwap as xlayerEip7702BundleSwap, bundleApprove as xlayerEip7702BundleApprove, bundleCreateBuy as xlayerEip7702BundleCreate, washVolume as xlayerEip7702WashVolume, bundleVolume as xlayerEip7702BundleVolume, } from './eip7702/index.js';
-export { default as xlayer } from './eoa/index.js';
+export * from './eip7702/flat-aliases.js';
+export { default as xlayer, default as XLayer } from './eoa/index.js';
+export { lpFeeProfileToV3Fee } from './eoa/portal-ops.js';

package/dist/chains/xlayer/index.js

@@ -22,12 +22,9 @@ xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, xlayerPureCrossSwapMerkle,
 // EOA 刷量
 signEoaWashBuyTransactions, signEoaWashSellTransactions, signEoaWashVolumeTransactions, } from './eoa/index.js';
 // ============================================================================
-// 快捷导出 - EIP-7702 模式（使用实际名称）
+// 快捷导出 - EIP-7702 模式（与包根 `xlayerEip7702*` 别名一致，见 flat-aliases）
 // ============================================================================
-export { 
-// Bundle 操作
-bundleBuy as xlayerEip7702BundleBuy, bundleSell as xlayerEip7702BundleSell, bundleSwap as xlayerEip7702BundleSwap, bundleApprove as xlayerEip7702BundleApprove, bundleCreateBuy as xlayerEip7702BundleCreate, 
-// 刷量
-washVolume as xlayerEip7702WashVolume, bundleVolume as xlayerEip7702BundleVolume, } from './eip7702/index.js';
+export * from './eip7702/flat-aliases.js';
 // 导出旧模块的默认对象（向后兼容）
-export { default as xlayer } from './eoa/index.js';
+export { default as xlayer, default as XLayer } from './eoa/index.js';
+export { lpFeeProfileToV3Fee } from './eoa/portal-ops.js';

package/dist/merkle/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * BSC Four.meme Merkle Bundle 横向入口
+ *
+ * memeweb 分发 / 换手 / 提交可统一走 `four-flap-meme-sdk/merkle`，避免拉包根。
+ */
+export { disperseWithBundleMerkle } from '../bundle-core/four-meme/utils-disperse.js';
+export { sweepWithBundleMerkle } from '../bundle-core/four-meme/utils-sweep.js';
+export { pairwiseTransferWithBundleMerkle } from '../bundle-core/four-meme/utils-pairwise.js';
+export { fourBundleSwapMerkle, fourBatchSwapMerkle, fourQuickBatchSwapMerkle } from '../bundle-core/four-meme/swap.js';
+export { fourBundleBuyFirstMerkle } from '../bundle-core/four-meme/swap-buy-first.js';
+export { submitBundleToMerkle, submitBundleToBlockRazor, submitDirectToRpc, submitDirectToRpcSmart, type MerkleSubmitConfig, type SubmitBundleResult, type BlockRazorSubmitConfig, type DirectSubmitConfig, } from '../bundle-core/submit.js';
+export type { DisperseSignParams, DisperseMerkleResult, SweepSignParams, SweepMerkleResult, FourBundleSwapSignParams, FourSwapResult, FourBatchSwapSignParams, FourBatchSwapResult, FourQuickBatchSwapSignParams, FourQuickBatchSwapResult, PairwiseTransferSignParams, PairwiseTransferMerkleResult, } from '../bundle-core/four-meme/types.js';

package/dist/merkle/index.js

@@ -0,0 +1,11 @@
+/**
+ * BSC Four.meme Merkle Bundle 横向入口
+ *
+ * memeweb 分发 / 换手 / 提交可统一走 `four-flap-meme-sdk/merkle`，避免拉包根。
+ */
+export { disperseWithBundleMerkle } from '../bundle-core/four-meme/utils-disperse.js';
+export { sweepWithBundleMerkle } from '../bundle-core/four-meme/utils-sweep.js';
+export { pairwiseTransferWithBundleMerkle } from '../bundle-core/four-meme/utils-pairwise.js';
+export { fourBundleSwapMerkle, fourBatchSwapMerkle, fourQuickBatchSwapMerkle } from '../bundle-core/four-meme/swap.js';
+export { fourBundleBuyFirstMerkle } from '../bundle-core/four-meme/swap-buy-first.js';
+export { submitBundleToMerkle, submitBundleToBlockRazor, submitDirectToRpc, submitDirectToRpcSmart, } from '../bundle-core/submit.js';

package/dist/shared/clients/four.d.ts

@@ -87,14 +87,26 @@ export type CreateTokenReq = {
     funGroup: false;
     clickFun: false;
 };
+export type FourJsonValue = string | number | boolean | null | FourJsonValue[] | {
+    [key: string]: FourJsonValue;
+};
+export type FourPublicConfig = {
+    [key: string]: FourJsonValue;
+};
+export type FourTokenDetail = {
+    [key: string]: FourJsonValue;
+} & {
+    address?: string;
+    name?: string;
+    symbol?: string;
+};
 export type CreateTokenResp = {
     createArg: string;
     signature: string;
     tokenAddr?: string;
     address?: string;
     token?: string;
-    [key: string]: unknown;
-};
+} & Record<string, string | undefined>;
 export declare class FourClient {
     private baseUrl;
     private uploadUrls;
@@ -124,9 +136,12 @@ export declare class FourClient {
     private isCorsOrNetworkError;
     private getFilenameFromBlob;
     createToken(accessToken: string, req: CreateTokenReq): Promise<CreateTokenResp>;
-    getPublicConfig(): Promise<unknown>;
-    getTokenByAddress(address: string, accessToken?: string): Promise<unknown>;
-    getTokensByAddresses(addresses: string[], accessToken?: string): Promise<unknown[]>;
-    getTokenById(id: string | number, accessToken?: string): Promise<unknown>;
+    getPublicConfig(): Promise<FourPublicConfig>;
+    getTokenByAddress(address: string, accessToken?: string): Promise<FourTokenDetail>;
+    getTokensByAddresses(addresses: string[], accessToken?: string): Promise<(FourTokenDetail | {
+        address: string;
+        error: string;
+    })[]>;
+    getTokenById(id: string | number, accessToken?: string): Promise<FourTokenDetail>;
 }
 export declare function buildLoginMessage(nonce: string): string;

package/dist/shared/clients/four.js

@@ -155,16 +155,17 @@ export class FourClient {
                 return imgUrl;
             }
             catch (e) {
-                lastError = e;
+                const err = e instanceof Error ? e : new Error(getErrorMessageFromUnknown(e));
+                lastError = err;
                 const canRetry = i < this.uploadUrls.length - 1;
-                if (this.isRateLimitError(e) && canRetry) {
+                if (this.isRateLimitError(err) && canRetry) {
                     // IP 限流 → 切下一个端点
                     const nextUrl = this.uploadUrls[i + 1];
                     const nextLabel = nextUrl === FOUR_MEME_OFFICIAL_API ? '官方直连' : `备用端点 #${i + 2}`;
                     console.warn(`[FourClient] 端点 ${baseUrl} 触发 IP 限流(100次/天)，切换到${nextLabel}...`);
                     continue;
                 }
-                if (this.isCorsOrNetworkError(e) && canRetry) {
+                if (this.isCorsOrNetworkError(err) && canRetry) {
                     // CORS/网络错误（常见于浏览器直连官方 API）→ 跳过，继续尝试下一个
                     console.warn(`[FourClient] 端点 ${baseUrl} 请求失败(${isOfficial ? 'CORS限制' : '网络错误'})，跳过`);
                     continue;
@@ -251,7 +252,7 @@ export class FourClient {
     }
     async getPublicConfig() {
         const r = await fetch(`${this.baseUrl}/v1/public/config`);
-        return await r.json();
+        return (await r.json());
     }
     async getTokenByAddress(address, accessToken) {
         const r = await fetch(`${this.baseUrl}/v1/private/token/get?address=${address}`, {
@@ -261,12 +262,12 @@ export class FourClient {
         if (j.code && j.code !== '0' && j.code !== 0) {
             throw new Error(`getTokenByAddress failed: ${JSON.stringify(j)}`);
         }
-        return j.data ?? j;
+        return (j.data ?? j);
     }
     async getTokensByAddresses(addresses, accessToken) {
         if (!Array.isArray(addresses) || addresses.length === 0)
             return [];
-        const tasks = addresses.map((addr) => this.getTokenByAddress(addr, accessToken).catch((e) => ({ address: addr, error: String(e) })));
+        const tasks = addresses.map((addr) => this.getTokenByAddress(addr, accessToken).catch((e) => ({ address: addr, error: getErrorMessageFromUnknown(e) })));
         return await Promise.all(tasks);
     }
     async getTokenById(id, accessToken) {
@@ -277,7 +278,7 @@ export class FourClient {
         if (j.code && j.code !== '0' && j.code !== 0) {
             throw new Error(`getTokenById failed: ${JSON.stringify(j)}`);
         }
-        return j.data ?? j;
+        return (j.data ?? j);
     }
 }
 export function buildLoginMessage(nonce) {

package/dist/shared/flap/meta.d.ts

@@ -1,7 +1,13 @@
 import { JsonRpcProvider } from 'ethers';
 export type FlapChain = 'BSC' | 'BASE' | 'XLAYER' | 'MORPH';
+/** JSON 可序列化值（递归） */
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
 /** IPFS 元数据 JSON（字段因项目而异） */
-export type FlapTokenMetaJson = Record<string, unknown>;
+export type FlapTokenMetaJson = {
+    [key: string]: JsonValue;
+};
 export type FlapMetaByAddressResult = {
     cid: string;
     data?: FlapTokenMetaJson;

package/dist/shared/flap/pinata.d.ts

@@ -2,25 +2,34 @@ export type PinataConfig = {
     jwt: string;
     gateway?: string;
 };
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/** Pinata gateway JSON 响应（结构因 CID 内容而异） */
+export type PinataGatewayJson = {
+    [key: string]: JsonValue;
+};
 type PinataPinApiResponse = {
     IpfsHash?: string;
     cid?: string;
     PinSize?: number;
     Timestamp?: string;
 };
+export type PinataJsonUpload = {
+    [key: string]: JsonValue;
+};
 export declare class PinataClient {
     private client;
-    private ready;
     constructor(cfg: PinataConfig);
     uploadFile(file: File): Promise<{
         cid: string;
         id: string;
     }>;
-    uploadJSON(obj: unknown, name?: string): Promise<{
+    uploadJSON(obj: PinataJsonUpload, name?: string): Promise<{
         cid: string;
         id: string;
     }>;
-    get(cid: string): Promise<unknown>;
+    get(cid: string): Promise<PinataGatewayJson>;
     url(cid: string): Promise<string>;
 }
 export type PinataPinResp = {

package/dist/shared/flap/pinata.js

@@ -1,14 +1,13 @@
+import { createReadStream } from 'node:fs';
+import axios from 'axios';
+import NodeFormData from 'form-data';
+import { PinataSDK } from 'pinata';
 export class PinataClient {
     client;
-    ready;
     constructor(cfg) {
-        this.ready = (async () => {
-            const mod = (await import('pinata'));
-            this.client = new mod.PinataSDK({ pinataJwt: cfg.jwt, pinataGateway: cfg.gateway });
-        })();
+        this.client = new PinataSDK({ pinataJwt: cfg.jwt, pinataGateway: cfg.gateway });
     }
     async uploadFile(file) {
-        await this.ready;
         const r = await this.client.upload.file(file);
         return { cid: r.cid, id: r.id ?? '' };
     }
@@ -18,11 +17,9 @@ export class PinataClient {
         return await this.uploadFile(file);
     }
     async get(cid) {
-        await this.ready;
         return await this.client.gateways.public.get(cid);
     }
     async url(cid) {
-        await this.ready;
         return await this.client.gateways.convert(cid);
     }
 }
@@ -34,16 +31,9 @@ export class PinataClient {
  * @param fileName 可选：内存数据的文件名
  */
 export async function pinFileToIPFSWithJWT(jwt, filePath, data, fileName) {
-    const axiosMod = await import('axios');
-    const FormDataMod = (await import('form-data'));
-    const fsMod = await import('node:fs');
-    const FormDataCtor = FormDataMod.default;
-    if (!FormDataCtor) {
-        throw new Error('pinFileToIPFSWithJWT: form-data module unavailable');
-    }
-    const form = new FormDataCtor();
+    const form = new NodeFormData();
     if (filePath && filePath.length > 0) {
-        form.append('file', fsMod.createReadStream(filePath));
+        form.append('file', createReadStream(filePath));
     }
     else if (data) {
         form.append('file', data, { filename: fileName || 'upload.bin' });
@@ -51,8 +41,8 @@ export async function pinFileToIPFSWithJWT(jwt, filePath, data, fileName) {
     else {
         throw new Error('pinFileToIPFSWithJWT: either filePath or data must be provided');
     }
-    const resp = await axiosMod.default.post('https://api.pinata.cloud/pinning/pinFileToIPFS', form, {
-        headers: { Authorization: `Bearer ${jwt}`, ...(form.getHeaders ? form.getHeaders() : {}) },
+    const resp = await axios.post('https://api.pinata.cloud/pinning/pinFileToIPFS', form, {
+        headers: { Authorization: `Bearer ${jwt}`, ...form.getHeaders() },
         maxContentLength: Infinity,
         maxBodyLength: Infinity,
     });

package/dist/shared/flap/portal-bundle-merkle/create-to-dex.d.ts

@@ -7,6 +7,7 @@
  * 3. 买到毕业（代币上 DEX）
  * 4. 多个钱包在 PancakeSwap（外盘）继续买入
  */
+import { type TaxVaultConfig } from '../vault.js';
 import { type FlapSignConfig } from './config.js';
 import type { MerkleSignedResult } from './types.js';
 export type CreateToDexChain = 'bsc' | 'xlayer' | 'base';
@@ -85,7 +86,7 @@ export interface FlapCreateToDexParams {
         lpBps: number;
         minimumShareBalance?: number;
         /** ✅ Tax Vault 金库配置（可选） */
-        vaultConfig?: import('../vault.js').TaxVaultConfig;
+        vaultConfig?: TaxVaultConfig;
     };
     /** V3 扩展 ID */
     extensionID?: string;

package/dist/shared/foundation/gas/bundle-gas.d.ts

@@ -36,4 +36,14 @@ export interface CommonBundleConfig {
 export declare function getGasLimit(config: CommonBundleConfig, defaultGas?: number): bigint;
 export declare function getGasPriceConfig(config: CommonBundleConfig): GasPriceConfig;
 export declare function getTxType(config: CommonBundleConfig): 0 | 2;
-export declare function buildGasFields(txType: number, gasPrice: bigint): Record<string, unknown>;
+export type LegacyGasFields = {
+    type: 0;
+    gasPrice: bigint;
+};
+export type Eip1559GasFields = {
+    type: 2;
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+};
+export type TxGasFields = LegacyGasFields | Eip1559GasFields;
+export declare function buildGasFields(txType: number, gasPrice: bigint): TxGasFields;

package/dist/shared/foundation/nonce/nonce-manager.js

@@ -1,5 +1,8 @@
 import '../tx/wallet-sign-patch.js';
 import { CHAINS } from '../../constants/index.js';
+function asBatchSendProvider(provider) {
+    return provider;
+}
 const GLOBAL_NONCE_TTL_MS = 60 * 1000;
 const globalNonceCursorByChain = new Map();
 function isFlakyNonceChain(chainId) {
@@ -145,7 +148,7 @@ export class NonceManager {
                     id: idx + 1,
                     jsonrpc: '2.0',
                 }));
-                const rawResults = await this.provider._send(batchRequests);
+                const rawResults = await asBatchSendProvider(this.provider)._send(batchRequests);
                 queryResults = rawResults.map((r) => {
                     if (r.result) {
                         return parseInt(r.result, 16);

package/dist/utils/airdrop-sweep.js

@@ -146,7 +146,8 @@ export async function sweepWithBundle(params) {
                 try {
                     const balData = iface.encodeFunctionData('balanceOf', [w.address]);
                     const balRaw = await provider.call({ to: tokenAddress, data: balData });
-                    const [bal] = iface.decodeFunctionResult('balanceOf', balRaw);
+                    const decoded = iface.decodeFunctionResult('balanceOf', balRaw);
+                    const bal = decoded[0];
                     return bal;
                 }
                 catch {

package/dist/utils/swap-helpers.js

@@ -4,6 +4,7 @@
 import { ethers, Contract } from 'ethers';
 import { batchCheckAllowances } from './erc20.js';
 import { ERC20_ABI } from '../abis/common.js';
+import { NonceManager, getOptimizedGasPrice } from './bundle-helpers.js';
 const APPROVAL_THRESHOLD = ethers.MaxUint256 / 2n;
 /**
  * 获取 Gas Limit（授权专用）
@@ -35,7 +36,6 @@ export async function ensureTokenApproval(provider, merkle, wallet, tokenAddress
         return;
     }
     // ✅ 使用 NonceManager（与 pancake-proxy.ts 一致）
-    const { NonceManager, getOptimizedGasPrice } = await import('./bundle-helpers.js');
     const nonceManager = new NonceManager(provider);
     // 构建授权交易
     const tokenContract = new Contract(tokenAddress, ERC20_ABI, wallet);

package/dist/utils/wallet.js

@@ -120,7 +120,8 @@ async function _queryMultiTokenBalancesSingle(provider, multicallAddress, tokenA
     // ✅ 单次 multicall 获取所有数据
     const callData = multiIface.encodeFunctionData('aggregate', [calls]);
     const result = await provider.call({ to: multicallAddress, data: callData });
-    const [, returnData] = multiIface.decodeFunctionResult('aggregate', result);
+    const decoded = multiIface.decodeFunctionResult('aggregate', result);
+    const returnData = decoded[1];
     // ✅ 并行解码结果
     const outputs = holders.map((addr) => ({
         address: addr,
@@ -213,7 +214,8 @@ async function _querySingleTokenBalancesSingle(provider, multicallAddress, token
     }));
     const callData = multiIface.encodeFunctionData('aggregate', [calls]);
     const result = await provider.call({ to: multicallAddress, data: callData });
-    const [, returnData] = multiIface.decodeFunctionResult('aggregate', result);
+    const decoded = multiIface.decodeFunctionResult('aggregate', result);
+    const returnData = decoded[1];
     return holders.map((addr, i) => {
         try {
             const decoded = erc20Iface.decodeFunctionResult('balanceOf', returnData[i]);

package/dist/vanity/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Flap vanity / CREATE2 子路径
+ */
+export { findSaltEndingByChain, predictVanityTokenAddress, predictVanityTokenAddressByChain, } from '../shared/flap/vanity.js';
+export { getVanitySuffix } from '../shared/flap/constants.js';

package/dist/vanity/index.js

@@ -0,0 +1,5 @@
+/**
+ * Flap vanity / CREATE2 子路径
+ */
+export { findSaltEndingByChain, predictVanityTokenAddress, predictVanityTokenAddressByChain, } from '../shared/flap/vanity.js';
+export { getVanitySuffix } from '../shared/flap/constants.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "four-flap-meme-sdk",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "description": "SDK for Flap bonding curve and four.meme TokenManager",
   "type": "module",
   "main": "dist/index.js",
@@ -121,6 +121,31 @@
       "import": "./dist/utils/quote-helpers.js",
       "default": "./dist/utils/quote-helpers.js"
     },
+    "./merkle": {
+      "types": "./dist/merkle/index.d.ts",
+      "import": "./dist/merkle/index.js",
+      "default": "./dist/merkle/index.js"
+    },
+    "./vanity": {
+      "types": "./dist/vanity/index.d.ts",
+      "import": "./dist/vanity/index.js",
+      "default": "./dist/vanity/index.js"
+    },
+    "./shared/flap": {
+      "types": "./dist/shared/flap/index.d.ts",
+      "import": "./dist/shared/flap/index.js",
+      "default": "./dist/shared/flap/index.js"
+    },
+    "./chains/bsc/iro": {
+      "types": "./dist/chains/bsc/iro.d.ts",
+      "import": "./dist/chains/bsc/iro.js",
+      "default": "./dist/chains/bsc/iro.js"
+    },
+    "./chains/eni/batch-router": {
+      "types": "./dist/chains/eni/batch-router/index.d.ts",
+      "import": "./dist/chains/eni/batch-router/index.js",
+      "default": "./dist/chains/eni/batch-router/index.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -136,7 +161,8 @@
     "format": "prettier --check src/",
     "format:fix": "prettier --write src/",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "build:analyze": "node scripts/build-analyze.mjs"
   },
   "keywords": [
     "flap",
@@ -156,6 +182,7 @@
     "@ethereumjs/rlp": "^10.1.0",
     "axios": "^1.12.2",
     "ethers": "^6.16.0",
+    "form-data": "^4.0.2",
     "pinata": "^1.10.1"
   },
   "devDependencies": {