four-flap-meme-sdk 2.2.19 → 3.0.0

package/dist/index.js

@@ -1,218 +1,17 @@
-// ============================================================================
-// 按链分模块导出（新架构）
-// ============================================================================
-export * as chains from './chains/index.js';
-// ============================================================================
-// 公共 ABI（统一管理）
-// ============================================================================
-export * as Abis from './shared/abis/index.js';
-// export * as Sol from './sol/index.js';
-export { ERC20_ABI, ERC20_BALANCE_ABI, ERC20_ALLOWANCE_ABI, MULTICALL3_ABI, V2_ROUTER_ABI, V2_ROUTER_QUOTE_ABI, V3_ROUTER02_ABI, V3_ROUTER_LEGACY_ABI, V3_QUOTER_ABI, V2_FACTORY_ABI, V2_PAIR_ABI, V3_FACTORY_ABI, V3_POOL_ABI, FLAP_PORTAL_ABI, TM2_ABI, HELPER3_ABI, } from './shared/abis/common.js';
-// ============================================================================
-// 公共常量（新的统一入口 - shared/constants）
-// ============================================================================
-export { 
-// 链配置
-CHAINS, CHAIN_ID_MAP, getChainById, getChainName, getDefaultRpcUrl, isKnownChain, isBscChain, isXLayerChain, isMonadChain, isEniChain, getConfirmationTimeout, 
-// Gas 常量
-GAS_LIMITS, GAS_CONFIG, calculateGasLimit, getTransferGasLimit, 
-// 合约地址
-ADDRESSES, getMulticall3Address, getFlapPortalAddress, isZeroAddress, isNativeToken, ENI_SPENDERS, getEniSpenders, 
-// 利润配置
-getProfitRecipient, getAllProfitRecipients, getProfitRateBps, calculateProfitAmount, calculateProfitHopGasCost, getTransferFeePerAddress, TRANSFER_FEE_PER_ADDRESS, } from './shared/constants/index.js';
-export { buildProfitHopTransactions, PROFIT_HOP_COUNT, } from './utils/bundle-helpers.js';
-// ============================================================================
-// 公共常量（向后兼容别名）
-// ============================================================================
-export { CHAIN, DEFAULT_DEADLINE_MINUTES, } from './utils/constants.js';
-export { isExclusiveOnChain, isExclusiveOffChain } from './utils/mpcExclusive.js';
-export { 
-// Four.meme V1 授权
-ensureSellApprovalV1, checkSellApprovalV1, 
-// Four.meme V2 授权
-ensureSellApprovalV2, checkSellApprovalV2, 
-// Four.meme 通用授权（默认 V2）
-ensureSellApproval, checkSellApproval, 
-// Flap Protocol 授权
-ensureFlapSellApproval, checkFlapSellApproval, ensureFlapSellApprovalBatch, checkFlapSellApprovalBatch, 
-// ✅ 智能路由授权方法（自动选择 spender，适用于 Flap、Four、V2、V3）
-checkAllowance, approveToken, checkAllowanceBatch, approveTokenBatch, 
-// ✅ 底层授权方法（手动指定 spender，适用于任意合约）
-checkAllowanceRaw, approveTokenRaw, checkAllowanceBatchRaw, approveTokenBatchRaw } from './utils/erc20.js';
-export { parseFourError } from './utils/errors.js';
-export { getTokenManagerV1, getTokenManagerV2, getTokenManagerHelper3, getTokenManagerV1Writer, getTokenManagerV2Writer, getTokenManagerHelper3Writer, getTokenManagerAddress } from './utils/contract-factory.js';
-export { FourClient, buildLoginMessage } from './shared/clients/four.js';
-export { createTokenOnChain, tryBuy, trySell, buyTokenWithFunds, sellToken, tradeBuy, tradeSell } from './contracts/tm.js';
-export { TM1 } from './contracts/tm1.js';
-export { TM2 } from './contracts/tm2.js';
-export { Helper3, Helper3Writer } from './contracts/helper3.js';
-export { CDPV2 } from './shared/flap/curve.js';
-export { FlapPortal, FlapPortalWriter, validateTaxDistribution, TokenStatus, TokenVersion, FeeType, DexThreshType, MigratorType, V3LPFeeProfile, lpFeeProfileToV3Fee, DEXId } from './shared/flap/portal.js';
-export { getFlapGraduatedDexMetrics, buildFlapInfinityPoolKey, computeInfinityPoolId, isInfinityCLPoolManagerAddress, isFlapInfinityCLGraduated, resolvePortalQuoteInputToken, PCS_INFINITY_CL_POOL_MANAGER_BSC, PCS_INFINITY_VAULT_BSC, FLAP_INFINITY_HOOKS_BSC, } from './shared/flap/graduated-dex.js';
-export { uploadTokenMeta } from './shared/flap/ipfs.js';
-export { buildPermitPiggybackAuto } from './shared/flap/permit.js';
-export { predictVanityTokenAddressByChain, findSaltEndingByChain } from './shared/flap/vanity.js';
-export { FLAP_DEFAULT_FEE_RATES, FLAP_IPFS_API_URL, FLAP_VANITY_SUFFIX, FLAP_DEX_THRESHOLDS, FLAP_TOTAL_SUPPLY, ZERO_ADDRESS, CHAIN_TAX_SUPPORT, getVanitySuffix, isChainSupportTax } from './shared/flap/constants.js';
-export { parseFlapError, getFlapErrorMessage, getFlapErrorMessageEn } from './shared/flap/errors.js';
-export { getFlapMetaByAddress, getFlapMetasByAddresses } from './shared/flap/meta.js';
-export { createTokenFlow } from './flows/create.js';
-export { Club48Client, sendBatchPrivateTransactions, sendBackrunBundle } from './shared/clients/club48.js';
-export { MerkleClient, createMerkleClient } from './shared/clients/merkle.js';
-export { BlockRazorClient, createBlockRazorClient, BLOCKRAZOR_BUILDER_EOA } from './shared/clients/blockrazor.js';
-export { EmitServiceClient, submitToEmitServiceBlockRazor, } from './shared/clients/emitservice.js';
-export { NonceManager, getOptimizedGasPrice, estimateGasWithSafety, estimateGasBatch, buildTransaction, signTransactionsBatch, signTransactionsBatchMultiWallet, validateSignedTransactions, getDeadline, encodeV3Path, decodeV3Path, getGasLimit, getGasPriceConfig, getTxType, getChainId, } from './utils/bundle-helpers.js';
-export { createTokenWithBundleBuy as fourCreateTokenWithBundleBuy, batchBuyWithBundle as fourBatchBuyWithBundle, batchSellWithBundle as fourBatchSellWithBundle } from './contracts/tm-bundle.js';
-export { createTokenWithBundleBuy as flapCreateTokenWithBundleBuy, batchBuyWithBundle as flapBatchBuyWithBundle, batchSellWithBundle as flapBatchSellWithBundle } from './shared/flap/portal-bundle.js';
-export { fourPrivateBuy, fourPrivateSell, fourBatchPrivateBuy, fourBatchPrivateSell } from './contracts/tm-bundle.js';
-export { flapPrivateBuy, flapPrivateSell, flapBatchPrivateBuy, flapBatchPrivateSell } from './shared/flap/portal-bundle.js';
-export { createTokenWithBundleBuyMerkle as flapCreateTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle as flapBatchBuyWithBundleMerkle, batchSellWithBundleMerkle as flapBatchSellWithBundleMerkle, flapPrivateBuyMerkle, flapPrivateSellMerkle, flapBatchPrivateBuyMerkle, flapBatchPrivateSellMerkle, pancakeProxyBatchBuyMerkle, pancakeProxyBatchSellMerkle, approvePancakeProxy, approvePancakeProxyBatch, flapDisperseWithBundleMerkle, flapSweepWithBundleMerkle } from './shared/flap/portal-bundle-merkle/index.js';
-export { createTokenWithBundleBuyMerkle as fourCreateTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle as fourBatchBuyWithBundleMerkle, batchSellWithBundleMerkle as fourBatchSellWithBundleMerkle, fourPrivateBuyMerkle, fourPrivateSellMerkle, fourBatchPrivateBuyMerkle, fourBatchPrivateSellMerkle, disperseWithBundleMerkle, sweepWithBundleMerkle, pairwiseTransferWithBundleMerkle, fourPancakeProxyBatchBuyMerkle, fourPancakeProxyBatchSellMerkle, approveFourPancakeProxy, approveFourPancakeProxyBatch, approveFourTokenManagerBatch, submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel } from './chains/bsc/four/index.js';
-// ✅ Four.meme TaxToken 工具（税币识别/查询/领取奖励）
-export { isTaxToken as fourIsTaxToken, isAntiSniperFeeMode as fourIsAntiSniperFeeMode, getCreatorType as fourGetCreatorType, getTaxTokenInfo as fourGetTaxTokenInfo, getClaimableFee as fourGetClaimableFee, getClaimedFee as fourGetClaimedFee, getUserRewardInfo as fourGetUserRewardInfo, buildClaimFeeTx as fourBuildClaimFeeTx, buildBatchClaimFeeTxs as fourBuildBatchClaimFeeTxs, validateFourTokenTaxInfo, TAX_TOKEN_ABI, TransferMode as FourTransferMode, } from './shared/four/index.js';
-export { PinataClient } from './shared/flap/pinata.js';
-export { pinFileToIPFSWithJWT, pinImageByPath, pinFileToIPFSWithJWTWeb, pinDataURLWithJWTWeb, dataURLToBlob } from './shared/flap/pinata.js';
-export { generateWallets } from './utils/wallet.js';
-export { getTokenBalancesWithMulticall } from './utils/wallet.js';
-export { validatePrivateKeys } from './utils/wallet.js';
-export { stealthTransfer } from './utils/stealth-transfer.js';
-// ✅ 刷持有人（一键完成：生成钱包 → 分发资金 → 批量买入）
-export { holdersMaker, estimateHoldersMakerCost, } from './utils/holders-maker.js';
-// ✅ 私募转账签名（带贿赂和利润提取）
-export { privateSaleMerkle, batchPrivateSaleMerkle, } from './utils/private-sale.js';
-export { inspectTokenLP, getFactoryFromRouter, registerDYORSwap, registerDex, getChainConfig, } from './utils/lp-inspect.js';
-export { disperseWithBundle, sweepWithBundle } from './utils/airdrop-sweep.js';
-// ============================================================
-// 捆绑换手功能（Bundle Swap）
-// ============================================================
-// Four内盘换手
-export { fourBundleSwapMerkle, fourBatchSwapMerkle, fourQuickBatchSwapMerkle } from './chains/bsc/four/swap.js';
-// Flap内盘换手
-export { flapBundleSwapMerkle, flapBatchSwapMerkle, flapQuickBatchSwapMerkle, flapCrossSwapMerkle } from './shared/flap/portal-bundle-merkle/swap.js';
-// PancakeSwap V2/V3通用换手
-export { pancakeBundleSwapMerkle, pancakeBatchSwapMerkle, pancakeQuickBatchSwapMerkle, pancakeCrossSwapMerkle } from './chains/bsc/pancake/bundle-swap.js';
-// 先买后卖（Buy-First）入口
-export { fourBundleBuyFirstMerkle } from './chains/bsc/four/swap-buy-first.js';
-export { flapBundleBuyFirstMerkle } from './shared/flap/portal-bundle-merkle/swap-buy-first.js';
-export { pancakeBundleBuyFirstMerkle } from './chains/bsc/pancake/bundle-buy-first.js';
-// ✅ 内盘买到外盘（Bonding Curve → DEX）- 已存在代币
-export { flapBundleCurveToDex } from './shared/flap/portal-bundle-merkle/curve-to-dex.js';
-// ✅ 发币 + 一键买到外盘（Create → Curve → DEX）- 新代币
-export { flapBundleCreateToDex } from './shared/flap/portal-bundle-merkle/create-to-dex.js';
-// ✅ Tax Vault 金库模块（基于 VaultPortal + VaultFactory 规范）
-export { NONE_EXTENSION_ID, VAULT_TYPE_LABELS, VAULT_TYPE_CATEGORIES, VAULT_FACTORY_ADDRESSES, VAULT_PORTAL_ADDRESSES, VAULT_PORTAL_ABI, VAULT_EXTRA_CONFIG, FLAP_GUARDIAN_ADDRESSES, VAULT_FACTORY_ABI, VAULT_FACTORY_V2_ABI, VAULT_BASE_ABI, VAULT_BASE_V2_ABI, encodeVaultData, buildVaultParams, buildVaultExtensionParams, buildNewTokenV6WithVaultParams, getVaultLaunchVanityOptions, TOKEN_TAXED_V3_VERSION, getVaultFactoryAddress, getVaultPortalAddress, queryVaultDataSchema, queryVaultUISchema, queryVaultDescription, validateVaultFactory, getVaultInfo, isValidContract, } from './shared/flap/vault.js';
-export { buildNewTokenV6Params, normalizeTaxV2Fields, NEW_TOKEN_V6_ABI, getTaxV3LaunchVanityOptions, getV3PermitLaunchVanityOptions, } from './shared/flap/launch-v6.js';
-export { populateCreateTokenTransaction, normalizeTaxLaunchConfig, resolveCreateTokenLaunchFlags, MAGIC_DIVIDEND_SELF, } from './shared/flap/portal-create-token.js';
-// ✅ 硬编码利润配置（统一管理）- 从 shared/constants 导出
-export { PROFIT_CONFIG } from './shared/constants/index.js';
-// ✅ V2/V3 报价工具（统一管理）
-export { quoteV2, quoteV3, quote, getTokenToNativeQuote, getNativeToTokenQuote, getWrappedNativeAddress, // ✅ 来自 quote-helpers，与 shared/constants 同名但实现可能不同
-getStableCoins, V3_FEE_TIERS, // ✅ 来自 quote-helpers
-QUOTE_CONFIG, } from './utils/quote-helpers.js';
-// ✅ Monad 等不支持 Bundle 的链：逐笔 RPC 广播方法（服务器端使用）
-export { submitDirectToRpc, submitDirectToRpcSequential, submitDirectToRpcSequentialNoWait, submitDirectToRpcParallel, submitDirectToRpcSmart, submitDirectToRpcSmart as xlayerBundleSubmit } from './chains/bsc/four/submit.js';
-// ✅ ENI Bundle 提交
-export { submitBundleToEni, submitEniParallelThenProfit, } from './contracts/tm-bundle-merkle/submit.js';
-// ============================================================
-// ✅ DEX 直接交易（不走代理合约）
-// ============================================================
-export { 
-// V2 直接交易
-directV2BatchBuy, directV2BatchSell, 
-// V3 直接交易
-directV3BatchBuy, directV3BatchSell, 
-// 辅助函数
-getRouterAddress, 
-// 常量
-DIRECT_ROUTERS, } from './dex/index.js';
-// ============================================================
-// ✅ XLayer SDK（EOA 模式 + EIP-7702）
-// ============================================================
-export * as XLayer from './chains/xlayer/eoa/index.js';
-export { 
-// Portal 操作
-createPortalQuery as xlayerCreatePortalQuery, PortalQuery as XLayerPortalQuery, encodeBuyCall as xlayerEncodeBuyCall, encodeSellCall as xlayerEncodeSellCall, encodeApproveCall as xlayerEncodeApproveCall, 
-// 工具函数
-parseOkb as xlayerParseOkb, formatOkb as xlayerFormatOkb, 
-// 常量
-XLAYER_CHAIN_ID, FLAP_PORTAL as XLAYER_FLAP_PORTAL, ENTRYPOINT_V06 as XLAYER_ENTRYPOINT, SIMPLE_ACCOUNT_FACTORY as XLAYER_FACTORY, PARTICLE_BUNDLER_URL as XLAYER_BUNDLER_URL, WOKB as XLAYER_WOKB, POTATOSWAP_V2_ROUTER as XLAYER_POTATOSWAP_ROUTER, 
-// ✅ EOA 刷量
-signEoaWashBuyTransactions as xlayerSignEoaWashBuyTransactions, signEoaWashSellTransactions as xlayerSignEoaWashSellTransactions, signEoaWashVolumeTransactions as xlayerSignEoaWashVolumeTransactions, 
-// ✅ XLayer EOA 模式换手（推荐使用）
-xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, xlayerPureCrossSwapMerkle, } from './chains/xlayer/eoa/index.js';
-// ============================================================
-// ✅ XLayer EIP-7702 Bundle 模式 (新版 API - EOA 使用智能合约能力)
-// ============================================================
-export * as XLayerEIP7702 from './chains/xlayer/eip7702/index.js';
-// EIP-7702 批量操作（注意使用 eip7702 前缀避免与 AA 模式冲突）
-export { bundleBuy as xlayerEip7702BundleBuy, bundleSell as xlayerEip7702BundleSell, bundleApprove as xlayerEip7702BundleApprove, bundleApproveMultiSpenders as xlayerEip7702BundleApproveMultiSpenders, bundleSwap as xlayerEip7702BundleSwap, bundleBatchSwap as xlayerEip7702BundleBatchSwap, bundleMultiSwap as xlayerEip7702BundleMultiSwap, 
-// 转账功能
-disperse as xlayerEip7702Disperse, sweep as xlayerEip7702Sweep, pairwiseTransfer as xlayerEip7702PairwiseTransfer, 
-// 向后兼容
-disperseWithHops as xlayerEip7702DisperseWithHops, sweepWithHops as xlayerEip7702SweepWithHops, 
-// 刷量
-washVolume as xlayerEip7702WashVolume, bundleVolume as xlayerEip7702BundleVolume, singleRoundVolume as xlayerEip7702SingleRoundVolume, makeVolume as xlayerEip7702MakeVolume, makeVolumeWithSwap as xlayerEip7702MakeVolumeWithSwap, 
-// 工具函数
-checkApprovalStatus as xlayerEip7702CheckApprovalStatus, getProfitRecipient as xlayerEip7702GetProfitRecipient, calculateProfitAmount as xlayerEip7702CalculateProfitAmount, calculateProfitAmountByUserType as xlayerEip7702CalculateProfitAmountByUserType, calculateProfitAmountByTxCount as xlayerEip7702CalculateProfitAmountByTxCount, getProfitRateBps as xlayerEip7702GetProfitRateBps, getProfitRateBpsDouble as xlayerEip7702GetProfitRateBpsDouble, buildEIP7702Transaction as xlayerEip7702BuildTransaction, signAuthorization as xlayerEip7702SignAuthorization, signAuthorizationsBatch as xlayerEip7702SignAuthorizationsBatch, 
-// 常量
-UNIFIED_DELEGATE_ADDRESS as XLAYER_EIP7702_DELEGATE_ADDRESS, MULTICALL3_ADDRESS as XLAYER_EIP7702_MULTICALL3, PROFIT_CONFIG as XLAYER_EIP7702_PROFIT_CONFIG, WOKB_ADDRESS as XLAYER_EIP7702_WOKB_ADDRESS, POTATOSWAP_V2_ROUTER as XLAYER_EIP7702_V2_ROUTER, POTATOSWAP_V3_ROUTER as XLAYER_EIP7702_V3_ROUTER, DYORSWAP_ROUTER as XLAYER_EIP7702_DYORSWAP_ROUTER, FLAP_PORTAL_ADDRESS as XLAYER_EIP7702_FLAP_PORTAL, 
-// 代币创建与发射
-bundleCreateBuy as xlayerEip7702BundleCreateBuy, bundleCreateToDex as xlayerEip7702BundleCreateToDex, bundleGraduateBuy as xlayerEip7702BundleGraduateBuy, } from './chains/xlayer/eip7702/index.js';
-// ============================================================
-// ✅ ENI SDK（Phase 1 Direct + Phase 2 BatchRouter）
-// ============================================================
-export * as ENI from './chains/eni/index.js';
-export * as EniBatchRouter from './chains/eni/batch-router/index.js';
-export { 
-// DAOaaS Portal 查询
-DaoaasPortalQuery as EniPortalQuery, createPortalQuery as eniCreatePortalQuery, encodeBuyCall as eniEncodeBuyCall, encodeSellCall as eniEncodeSellCall, encodeCreateCall as eniEncodeCreateCall, applySlippage as eniApplySlippage, formatEgas as eniFormatEgas, parseEgas as eniParseEgas, 
-// Phase 1 Direct 模式交易
-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, ENI_CHAIN_ID, ENI_RPC_URL, DAOAAS_PORTAL as ENI_DAOAAS_PORTAL, DSWAP_V2_ROUTER as ENI_DSWAP_V2_ROUTER, DSWAP_V2_FACTORY as ENI_DSWAP_V2_FACTORY, DSWAP_V2_PAIR_ABI as ENI_DSWAP_V2_PAIR_ABI, WEGAS as ENI_WEGAS, } from './chains/eni/index.js';
-// ENI Fair Launch (公平发射 5 种模式)
-export { TokenLaunchType as EniTokenLaunchType, FairLauncherQuery as EniFairLauncherQuery, launchToken as eniLaunchToken, launchTokenForSubmit as eniLaunchTokenForSubmit, setTokenTradeStartTime as eniSetTokenTradeStartTime, encodeLaunchTokenCall as eniEncodeLaunchTokenCall, standardPreset as eniStandardPreset, liquidityProvidingPreset as eniLiquidityProvidingPreset, dividendPreset as eniDividendPreset, dividendBuybackPreset as eniDividendBuybackPreset, deflationaryPreset as eniDeflationaryPreset, validateLaunchParams as eniValidateLaunchParams, detectLaunchType as eniDetectLaunchType, } from './chains/eni/index.js';
-// ENI Fair Launch Pool (认购买入)
-export { FairPoolQuery as EniFairPoolQuery, claimFromPool as eniClaimFromPool, claimFromPoolForSubmit as eniClaimFromPoolForSubmit, batchClaimForSubmit as eniBatchClaimForSubmit, } from './chains/eni/index.js';
-// ENI BatchRouter Phase 2 (原子化批量操作)
-export { 
-// 批量买卖
-batchBuyPortal as eniBatchBuyPortal, batchBuyV2 as eniBatchBuyV2, batchSellPortal as eniBatchSellPortal, batchSellV2 as eniBatchSellV2, 
-// 原子换手
-atomicSwapPortal as eniAtomicSwapPortal, batchSwapPortal as eniBatchSwapPortal, atomicSwapV2 as eniAtomicSwapV2, batchSwapV2 as eniBatchSwapV2, 
-// 批量授权
-batchApprove as eniBatchApprove, 
-// 刷量
-washVolume as eniWashVolume, washVolumeV2 as eniWashVolumeV2, 
-// 分发 / 归集
-batchTransferEgas as eniBatchTransferEgas, batchTransferToken as eniBatchTransferToken, batchSweepToken as eniBatchSweepToken, batchSweepEgas as eniBatchSweepEgas, eniDisperseForSubmit, eniSweepForSubmit, 
-// 工具
-validateBatchParams as eniValidateBatchParams, encodeBatchBuy as eniEncodeBatchBuy, encodeBatchSell as eniEncodeBatchSell, encodeAtomicSwap as eniEncodeAtomicSwap, encodeBatchSwap as eniEncodeBatchSwap, encodeAtomicSwapV2 as eniEncodeAtomicSwapV2, encodeBatchSwapV2 as eniEncodeBatchSwapV2, encodeBatchTransfer as eniEncodeBatchTransfer, encodeBatchSweepToken as eniEncodeBatchSweepToken, buildBatchRouterTx as eniBuildBatchRouterTx, estimateGas as eniEstimateGas, 
-// 常量
-BATCH_ROUTER_ADDRESS as ENI_BATCH_ROUTER_ADDRESS, BATCH_ROUTER_ABI as ENI_BATCH_ROUTER_ABI, MAX_BATCH_SIZE as ENI_MAX_BATCH_SIZE, } from './chains/eni/batch-router/index.js';
-// ENI DSWAP V2 流动性管理
-export { getLPPairInfo as eniGetLPPairInfo, batchGetLPPairInfo as eniBatchGetLPPairInfo, getPairAddress as eniGetPairAddress, addLiquidityETHForSubmit as eniAddLiquidityETHForSubmit, removeLiquidityETHForSubmit as eniRemoveLiquidityETHForSubmit, addLiquidityForSubmit as eniAddLiquidityForSubmit, removeLiquidityForSubmit as eniRemoveLiquidityForSubmit, } from './chains/eni/index.js';
-// ENI IRO (Initial Rights Offering)
-export { EniIroFactoryQuery, eniIroEncodeCreateProjectCall, eniIroCreateProject, eniIroParseCreateProjectEvent, EniIroTokenQuery, eniIroSubscribe, eniIroPledge, eniIroBatchSubscribe, eniIroBatchSubscribeForSubmit, EniIroPoolQuery, eniIroPoolRemovePledge, eniIroPoolExtract, eniIroPoolTransferAwards, eniIroBatchExtract, ENI_IRO_FACTORY_ADDRESS, ENI_IRO_OWNER_ADDRESS, ENI_IRO_SELL_FEE_CONTRACT, ENI_IROSWAP_V2_ROUTER, ENI_IROSWAP_V2_FACTORY, ENI_IRO_FACTORY_ABI, ENI_IRO_TOKEN_ABI, ENI_IRO_POOL_ABI, ENI_IRO_PLATFORM_URL, setEniIroApiBase, eniIroApiCreateProject, eniIroApiUploadImage, eniIroGetTokenWhiteList, eniIroAddTokenWhiteListForSubmit, eniIroBatchAddTokenWhiteListForSubmit, eniIroRemoveTokenWhiteListForSubmit, ENI_IRO_OWNER_WHITELIST_ABI, } from './chains/eni/index.js';
-// ✅ ENI Bundler — EIP-712 元交易多签名者原子执行
-export * as EniBundler from './chains/eni/bundler/index.js';
-export { signOperation as eniBundlerSignOp, signTokenPull as eniBundlerSignTokenPull, signOperationsBatch as eniBundlerSignOpsBatch, getBundlerNonce as eniBundlerGetNonce, buildExecuteBatch as eniBundlerBuildExecuteBatch, buildPullAndExecute as eniBundlerBuildPullAndExecute, ENI_BUNDLER_ADDRESS, } from './chains/eni/bundler/index.js';
-// ============================================================
-// ✅ BSC IRO 发币平台
-// ============================================================
-export { 
-// Factory
-IroFactoryQuery as BscIroFactoryQuery, iroCreateProject as bscIroCreateProject, iroEncodeCreateProjectCall as bscIroEncodeCreateProjectCall, iroParseCreateProjectEvent as bscIroParseCreateProjectEvent, 
-// Token
-IroTokenQuery as BscIroTokenQuery, iroSubscribe as bscIroSubscribe, iroPledge as bscIroPledge, iroBatchSubscribe as bscIroBatchSubscribe, iroBatchSubscribeForSubmit as bscIroBatchSubscribeForSubmit, 
-// Pool
-IroPoolQuery as BscIroPoolQuery, iroPoolRemovePledge as bscIroPoolRemovePledge, iroPoolExtract as bscIroPoolExtract, iroPoolTransferAwards as bscIroPoolTransferAwards, iroBatchExtract 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, 
-// API (IRO 平台后端)
-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 './chains/bsc/index.js';
+/**
+ * SDK 公共 API 聚合入口（3.0 · 不推荐作默认消费入口）
+ *
+ * - **实现**：`core/` · `domains/*` · `chains/` · `bundle/` · 瘦 `utils/`
+ * - **扁平再导出**：`exports/root-*.ts`
+ * - **具名 facade**：见 `package.json#exports` / docs/PUBLIC_API.md §2
+ */
+export * from './exports/root-foundations.js';
+export * from './exports/root-bundle-and-tooling.js';
+export * from './exports/root-swap-dex-and-xlayer.js';
+export * from './exports/root-eni-and-bsc-iro.js';
+/** 横向基础：错误收口、Logger、共享类型、Nonce/Gas/Tx 工具 */
+export * as foundation from './core/foundation.js';
+/** Bundle 共享核心：internal、submit、config-helpers、four-meme 实现 */
+export * as bundleCore from './bundle/index.js';
+/** 高层业务流程 */
+export * as flows from './domains/flows/index.js';

package/dist/utils/airdrop-sweep.d.ts

@@ -1,80 +1,8 @@
-import type { SoulPointSignatureMode, VNormalizationMode } from '../shared/clients/club48.js';
-/** ✅ Bundle 提交结果（完整版 - 包含 bundleUuid） */
-export type BundleSubmitResult = {
-    bundleUuid: string;
-    signedTxs: string[];
-};
-/** ✅ 签名结果（精简版 - 仅返回签名交易） */
-export type SignedTransactionsResult = {
-    signedTransactions: string[];
-};
-/** ✅ 分散参数（完整版 - 包含 Bundle 提交） */
-export type DisperseParams = {
-    rpcUrl: string;
-    chainId: number;
-    fromPrivateKey: string;
-    recipients: string[];
-    amount?: string;
-    amounts?: string[];
-    tokenAddress?: string;
-    bundleEndpoint?: string;
-    gasPriceGwei?: string;
-    transferGasLimit?: bigint;
-    nativeGasLimit?: bigint;
-    blockOffset?: number;
-    spMode?: SoulPointSignatureMode;
-    spPrivateKey?: string;
-    spVMode?: VNormalizationMode;
-};
-/** ✅ 分散参数（精简版 - 仅签名） */
-export type DisperseSignParams = {
-    rpcUrl: string;
-    chainId: number;
-    fromPrivateKey: string;
-    recipients: string[];
-    amount?: string;
-    amounts?: string[];
-    tokenAddress?: string;
-    gasPriceGwei?: string;
-    transferGasLimit?: bigint;
-    nativeGasLimit?: bigint;
-};
-export declare function disperseWithBundle(params: DisperseSignParams): Promise<SignedTransactionsResult>;
-/** ✅ 归集参数（完整版 - 包含 Bundle 提交） */
-export type SweepParams = {
-    rpcUrl: string;
-    chainId: number;
-    sourcePrivateKeys: string[];
-    target: string;
-    ratioPct?: number;
-    amount?: string;
-    tokenAddress?: string;
-    bundleEndpoint?: string;
-    gasPriceGwei?: string;
-    transferGasLimit?: bigint;
-    nativeGasLimit?: bigint;
-    blockOffset?: number;
-    skipIfInsufficient?: boolean;
-    spMode?: SoulPointSignatureMode;
-    spPrivateKey?: string;
-    spVMode?: VNormalizationMode;
-};
-/** ✅ 归集参数（精简版 - 仅签名） */
-export type SweepSignParams = {
-    rpcUrl: string;
-    chainId: number;
-    sourcePrivateKeys: string[];
-    target: string;
-    ratioPct?: number;
-    amount?: string;
-    tokenAddress?: string;
-    gasPriceGwei?: string;
-    transferGasLimit?: bigint;
-    nativeGasLimit?: bigint;
-    skipIfInsufficient?: boolean;
-};
+import type { AirdropDisperseSignParams, SignedTransactionsResult, AirdropSweepSignParams } from './types/airdrop-sweep.js';
+export declare function disperseWithBundle(params: AirdropDisperseSignParams): Promise<SignedTransactionsResult>;
 /**
  * 归集（仅签名版本 - 不提交 Bundle）
  * ✅ 精简版：只负责签名交易，不提交
  */
-export declare function sweepWithBundle(params: SweepSignParams): Promise<SignedTransactionsResult>;
+export declare function sweepWithBundle(params: AirdropSweepSignParams): Promise<SignedTransactionsResult>;
+export type { BundleSubmitResult, SignedTransactionsResult, AirdropDisperseParams, AirdropDisperseSignParams, AirdropSweepParams, AirdropSweepSignParams, DisperseParams, DisperseSignParams, SweepParams, SweepSignParams, } from './types/airdrop-sweep.js';

package/dist/utils/airdrop-sweep.js

@@ -1,34 +1,15 @@
 import { ethers, JsonRpcProvider } from 'ethers';
-import { GAS_LIMITS } from '../shared/constants/index.js';
-async function getErc20Decimals(provider, token) {
-    try {
-        const erc20 = new ethers.Contract(token, ['function decimals() view returns (uint8)'], provider);
-        const d = await erc20.decimals();
-        if (!Number.isFinite(d) || d < 0 || d > 36)
-            return 18;
-        return d;
-    }
-    catch {
-        return 18;
-    }
-}
-/**
- * 分散（仅签名版本 - 不提交 Bundle）
- * ✅ 精简版：只负责签名交易，不提交
- */
-/** ENI Chain ID — EIP-1559 (type 2) */
-const ENI_CHAIN_ID = 173;
-function getTxType(chainId) {
-    return chainId === ENI_CHAIN_ID ? 2 : 0;
-}
-function buildGasFields(txType, gasPrice) {
-    if (txType === 2) {
-        return { type: 2, maxFeePerGas: gasPrice, maxPriorityFeePerGas: gasPrice / 10n || 1n };
-    }
-    return { type: 0, gasPrice };
+import { GAS_LIMITS, isEniChain } from '../core/constants/index.js';
+import { buildGasFields } from '../core/gas/bundle-gas.js';
+import { getErc20Decimals } from '../core/erc20/decimals.js';
+function getTxTypeForChain(chainId) {
+    return isEniChain(chainId) ? 2 : 0;
 }
+// ==========================================
+// 通用：原生/代币 一键分散 & 一键归集（Bundle）
+// ==========================================
 export async function disperseWithBundle(params) {
-    const { rpcUrl, chainId, fromPrivateKey, recipients, amount, amounts, tokenAddress, gasPriceGwei, transferGasLimit = GAS_LIMITS.ERC20_TRANSFER, nativeGasLimit = GAS_LIMITS.BRIBE } = params;
+    const { rpcUrl, chainId, fromPrivateKey, recipients, amount, amounts, tokenAddress, gasPriceGwei, transferGasLimit = GAS_LIMITS.ERC20_TRANSFER, nativeGasLimit = GAS_LIMITS.BRIBE, } = params;
     if (!recipients || recipients.length === 0) {
         return { signedTransactions: [] };
     }
@@ -36,22 +17,22 @@ export async function disperseWithBundle(params) {
     const wallet = new ethers.Wallet(fromPrivateKey, provider);
     const gasPrice = gasPriceGwei && gasPriceGwei.trim().length > 0
         ? ethers.parseUnits(gasPriceGwei, 'gwei')
-        : (await provider.getFeeData()).gasPrice ?? ethers.parseUnits('1', 'gwei');
+        : ((await provider.getFeeData()).gasPrice ?? ethers.parseUnits('1', 'gwei'));
     // 规范化 amounts：优先使用数组；否则将单值扩展为数组
     const useAmountsArray = Array.isArray(amounts) && amounts.length > 0;
     const effAmounts = useAmountsArray
         ? amounts
-        : (typeof amount === 'string' && amount.trim().length > 0
+        : typeof amount === 'string' && amount.trim().length > 0
             ? new Array(recipients.length).fill(amount)
-            : []);
+            : [];
     if (effAmounts.length !== recipients.length) {
         throw new Error('recipients and amounts length mismatch');
     }
-    let isNative = !tokenAddress || tokenAddress.trim().length === 0;
+    const isNative = !tokenAddress || tokenAddress.trim().length === 0;
     const signedTxs = [];
     if (isNative) {
         const baseNonce = await provider.getTransactionCount(wallet.address, 'pending');
-        const txType = getTxType(chainId);
+        const txType = getTxTypeForChain(chainId);
         const signedTxList = await Promise.all(recipients.map(async (to, i) => {
             const amountWei = ethers.parseEther(effAmounts[i]);
             return wallet.signTransaction({
@@ -69,10 +50,10 @@ export async function disperseWithBundle(params) {
         // ✅ 并行获取 decimals 和 nonce
         const [decimals, baseNonce] = await Promise.all([
             getErc20Decimals(provider, tokenAddress),
-            provider.getTransactionCount(wallet.address, 'pending')
+            provider.getTransactionCount(wallet.address, 'pending'),
         ]);
         const iface = new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
-        const txType = getTxType(chainId);
+        const txType = getTxTypeForChain(chainId);
         const signedTxList = await Promise.all(recipients.map(async (to, i) => {
             const amountWei = ethers.parseUnits(effAmounts[i], decimals);
             const data = iface.encodeFunctionData('transfer', [to, amountWei]);
@@ -96,15 +77,15 @@ export async function disperseWithBundle(params) {
  * ✅ 精简版：只负责签名交易，不提交
  */
 export async function sweepWithBundle(params) {
-    const { rpcUrl, chainId, sourcePrivateKeys, target, ratioPct, amount, tokenAddress, gasPriceGwei, transferGasLimit = GAS_LIMITS.ERC20_TRANSFER, nativeGasLimit = GAS_LIMITS.BRIBE, skipIfInsufficient = true } = params;
+    const { rpcUrl, chainId, sourcePrivateKeys, target, ratioPct, amount, tokenAddress, gasPriceGwei, transferGasLimit = GAS_LIMITS.ERC20_TRANSFER, nativeGasLimit = GAS_LIMITS.BRIBE, skipIfInsufficient = true, } = params;
     if (!sourcePrivateKeys || sourcePrivateKeys.length === 0) {
         return { signedTransactions: [] };
     }
     const provider = new JsonRpcProvider(rpcUrl, chainId);
     const gasPrice = gasPriceGwei && gasPriceGwei.trim().length > 0
         ? ethers.parseUnits(gasPriceGwei, 'gwei')
-        : (await provider.getFeeData()).gasPrice ?? ethers.parseUnits('1', 'gwei');
-    let isNative = !tokenAddress || tokenAddress.trim().length === 0;
+        : ((await provider.getFeeData()).gasPrice ?? ethers.parseUnits('1', 'gwei'));
+    const isNative = !tokenAddress || tokenAddress.trim().length === 0;
     const signedTxs = [];
     const clampRatio = (n) => {
         if (typeof n !== 'number' || !Number.isFinite(n))
@@ -118,18 +99,18 @@ export async function sweepWithBundle(params) {
     const ratio = clampRatio(ratioPct);
     if (isNative) {
         // ✅ 并行处理所有源钱包
-        const wallets = sourcePrivateKeys.map(pk => new ethers.Wallet(pk, provider));
+        const wallets = sourcePrivateKeys.map((pk) => new ethers.Wallet(pk, provider));
         const gasCost = nativeGasLimit * gasPrice;
         // 并行获取所有余额和 nonce
         const [balances, nonces] = await Promise.all([
-            Promise.all(wallets.map(w => provider.getBalance(w.address).catch(() => 0n))),
-            Promise.all(wallets.map(w => provider.getTransactionCount(w.address, 'pending')))
+            Promise.all(wallets.map((w) => provider.getBalance(w.address).catch(() => 0n))),
+            Promise.all(wallets.map((w) => provider.getTransactionCount(w.address, 'pending'))),
         ]);
         // 计算每个钱包的发送金额
-        const sendAmounts = balances.map(bal => {
+        const sendAmounts = balances.map((bal) => {
             if (ratio !== undefined) {
                 const want = (bal * BigInt(ratio)) / 100n;
-                const maxSendable = bal > gasCost ? (bal - gasCost) : 0n;
+                const maxSendable = bal > gasCost ? bal - gasCost : 0n;
                 return want > maxSendable ? maxSendable : want;
             }
             else if (amount && amount.trim().length > 0) {
@@ -140,9 +121,9 @@ export async function sweepWithBundle(params) {
             }
             return 0n;
         });
-        const txType = getTxType(chainId);
-        const validIndices = sendAmounts.map((amt, i) => amt > 0n ? i : -1).filter(i => i >= 0);
-        const signedTxList = await Promise.all(validIndices.map(i => wallets[i].signTransaction({
+        const txType = getTxTypeForChain(chainId);
+        const validIndices = sendAmounts.map((amt, i) => (amt > 0n ? i : -1)).filter((i) => i >= 0);
+        const signedTxList = await Promise.all(validIndices.map((i) => wallets[i].signTransaction({
             to: target,
             value: sendAmounts[i],
             nonce: nonces[i],
@@ -153,8 +134,11 @@ export async function sweepWithBundle(params) {
         signedTxs.push(...signedTxList);
     }
     else {
-        const wallets = sourcePrivateKeys.map(pk => new ethers.Wallet(pk, provider));
-        const iface = new ethers.Interface(['function balanceOf(address) view returns (uint256)', 'function transfer(address,uint256) returns (bool)']);
+        const wallets = sourcePrivateKeys.map((pk) => new ethers.Wallet(pk, provider));
+        const iface = new ethers.Interface([
+            'function balanceOf(address) view returns (uint256)',
+            'function transfer(address,uint256) returns (bool)',
+        ]);
         // ✅ 并行获取 decimals、所有代币余额和 nonce
         const [decimals, balanceResults, nonces] = await Promise.all([
             getErc20Decimals(provider, tokenAddress),
@@ -162,17 +146,18 @@ 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 {
                     return 0n;
                 }
             })),
-            Promise.all(wallets.map(w => provider.getTransactionCount(w.address, 'pending')))
+            Promise.all(wallets.map((w) => provider.getTransactionCount(w.address, 'pending'))),
         ]);
         // 计算每个钱包的发送金额
-        const sendAmounts = balanceResults.map(bal => {
+        const sendAmounts = balanceResults.map((bal) => {
             if (ratio !== undefined) {
                 return (bal * BigInt(ratio)) / 100n;
             }
@@ -184,15 +169,17 @@ export async function sweepWithBundle(params) {
             return 0n;
         });
         // 过滤余额不足的钱包
-        const validIndices = sendAmounts.map((amt, i) => {
+        const validIndices = sendAmounts
+            .map((amt, i) => {
             if (amt <= 0n)
                 return -1;
             if (skipIfInsufficient && balanceResults[i] < amt)
                 return -1;
             return i;
-        }).filter(i => i >= 0);
-        const txType = getTxType(chainId);
-        const signedTxList = await Promise.all(validIndices.map(i => {
+        })
+            .filter((i) => i >= 0);
+        const txType = getTxTypeForChain(chainId);
+        const signedTxList = await Promise.all(validIndices.map((i) => {
             const data = iface.encodeFunctionData('transfer', [target, sendAmounts[i]]);
             return wallets[i].signTransaction({
                 to: tokenAddress,