four-flap-meme-sdk 2.2.20 → 3.0.1

package/dist/exports/root-foundations.js

@@ -15,7 +15,7 @@ export * as Abis from '../abis/index.js';
 // ============================================================================
 // SDK 基础（unknown 收口 / 可选 Logger；审计 P1）
 // ============================================================================
-export { getErrorMessageFromUnknown, normalizeUnknownError, noopSdkLogger, consoleSdkLogger, buildTransactionRequest, } from '../shared/foundation/index.js';
+export { getErrorMessageFromUnknown, normalizeUnknownError, noopSdkLogger, consoleSdkLogger, buildTransactionRequest, } from '../core/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 '../abis/common.js';
 // ============================================================================
@@ -31,7 +31,7 @@ ADDRESSES, getMulticall3Address, getFlapPortalAddress, isZeroAddress, isNativeTo
 // 利润配置
 getProfitRecipient, getAllProfitRecipients, getProfitRateBps, calculateProfitAmount, calculateProfitHopGasCost, getTransferFeePerAddress, TRANSFER_FEE_PER_ADDRESS, 
 // DEX 报价配置
-QUOTE_CONFIG, QUOTE_V3_FEE_TIERS, } from '../shared/constants/index.js';
+QUOTE_CONFIG, QUOTE_V3_FEE_TIERS, } from '../core/constants/index.js';
 export { buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../utils/bundle-helpers.js';
 export { isExclusiveOnChain, isExclusiveOffChain } from '../utils/mpcExclusive.js';
 export { 
@@ -46,25 +46,25 @@ ensureFlapSellApproval, checkFlapSellApproval, ensureFlapSellApprovalBatch, chec
 // ✅ 智能路由授权方法（自动选择 spender，适用于 Flap、Four、V2、V3）
 checkAllowance, approveToken, checkAllowanceBatch, approveTokenBatch, 
 // ✅ 底层授权方法（手动指定 spender，适用于任意合约）
-checkAllowanceRaw, approveTokenRaw, checkAllowanceBatchRaw, approveTokenBatchRaw, } from '../utils/erc20.js';
+checkAllowanceRaw, approveTokenRaw, checkAllowanceBatchRaw, approveTokenBatchRaw, } from '../core/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, DexThreshType, MigratorType, V3LPFeeProfile, lpFeeProfileToV3Fee, DEXId, } from '../shared/flap/portal.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 { FourClient, buildLoginMessage, } from '../core/clients/four.js';
+export { createTokenOnChain, tryBuy, trySell, buyTokenWithFunds, sellToken, tradeBuy, tradeSell, } from '../domains/four/contracts/tm.js';
+export { TM1 } from '../domains/four/contracts/tm1.js';
+export { TM2 } from '../domains/four/contracts/tm2.js';
+export { Helper3, Helper3Writer } from '../domains/four/contracts/helper3.js';
+export { CDPV2 } from '../domains/flap/curve.js';
+export { FlapPortal, FlapPortalWriter, validateTaxDistribution, TokenStatus, TokenVersion, DexThreshType, MigratorType, V3LPFeeProfile, lpFeeProfileToV3Fee, DEXId, } from '../domains/flap/portal.js';
+export { uploadTokenMeta } from '../domains/flap/ipfs.js';
+export { buildPermitPiggybackAuto } from '../domains/flap/permit.js';
+export { predictVanityTokenAddressByChain, findSaltEndingByChain } from '../domains/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 '../domains/flap/constants.js';
+export { parseFlapError, getFlapErrorMessage, getFlapErrorMessageEn, } from '../domains/flap/errors.js';
+export { getFlapMetaByAddress, getFlapMetasByAddresses } from '../domains/flap/meta.js';
+export { createTokenFlow } from '../domains/flows/create.js';
+export { Club48Client, sendBatchPrivateTransactions, sendBackrunBundle, } from '../core/clients/club48.js';
+export { MerkleClient, createMerkleClient, } from '../core/clients/merkle.js';
+export { BlockRazorClient, createBlockRazorClient, BLOCKRAZOR_BUILDER_EOA, } from '../core/clients/blockrazor.js';
+export { EmitServiceClient, submitToEmitServiceBlockRazor, } from '../core/clients/emitservice.js';
 export { NonceManager, getOptimizedGasPrice, estimateGasWithSafety, estimateGasBatch, buildTransaction, signTransactionsBatch, signTransactionsBatchMultiWallet, validateSignedTransactions, getDeadline, encodeV3Path, decodeV3Path, getGasLimit, getGasPriceConfig, getTxType, getChainId, } from '../utils/bundle-helpers.js';

package/dist/exports/root-swap-dex-and-xlayer.d.ts

@@ -5,25 +5,25 @@
  * v2：包根不再导出 `PROFIT_CONFIG` / 报价 `V3_FEE_TIERS`；迁移说明见 README.zh-CN.md。
  */
 export { fourBundleSwapMerkle, fourBatchSwapMerkle, fourQuickBatchSwapMerkle, type FourSwapSignConfig, type FourSwapConfig, type FourBundleSwapSignParams, type FourBundleSwapParams, type FourSwapResult, type FourBatchSwapSignParams, type FourBatchSwapResult, type FourQuickBatchSwapSignParams, type FourQuickBatchSwapResult, } from '../chains/bsc/four/swap.js';
-export { flapBundleSwapMerkle, flapBatchSwapMerkle, flapQuickBatchSwapMerkle, flapCrossSwapMerkle, } from '../shared/flap/portal-bundle-merkle/swap.js';
-export type { FlapSwapSignConfig, FlapSwapConfig, FlapBundleSwapSignParams, FlapBundleSwapParams, FlapSwapResult, } from '../shared/flap/portal-bundle-merkle/swap-helpers.js';
-export type { FlapBatchSwapSignParams, FlapBatchSwapResult, FlapQuickBatchSwapSignParams, FlapQuickBatchSwapResult, FlapCrossSwapParams, FlapCrossSwapResult, } from '../shared/flap/portal-bundle-merkle/swap.js';
+export { flapBundleSwapMerkle, flapBatchSwapMerkle, flapQuickBatchSwapMerkle, flapCrossSwapMerkle, } from '../domains/flap/portal-bundle-merkle/swap.js';
+export type { FlapSwapSignConfig, FlapSwapConfig, FlapBundleSwapSignParams, FlapBundleSwapParams, FlapSwapResult, } from '../domains/flap/portal-bundle-merkle/swap-helpers.js';
+export type { FlapBatchSwapSignParams, FlapBatchSwapResult, FlapQuickBatchSwapSignParams, FlapQuickBatchSwapResult, FlapCrossSwapParams, FlapCrossSwapResult, } from '../domains/flap/portal-bundle-merkle/swap.js';
 export { pancakeBundleSwapMerkle, pancakeBatchSwapMerkle, pancakeQuickBatchSwapMerkle, pancakeCrossSwapMerkle, type PancakeBatchSwapSignParams, type PancakeBatchSwapResult, type PancakeQuickBatchSwapParams, type PancakeQuickBatchSwapResult, type PancakeCrossSwapParams, type PancakeCrossSwapResult, } from '../chains/bsc/pancake/bundle-swap.js';
 export type { PancakeSwapSignConfig, PancakeSwapConfig, PancakeBundleSwapSignParams, PancakeBundleSwapParams, PancakeSwapResult, SwapRouteType, RouteParams, V2RouteParams, V3SingleRouteParams, V3MultiRouteParams, } from '../chains/bsc/pancake/bundle-swap-helpers.js';
 export { fourBundleBuyFirstMerkle, type FourBuyFirstConfig, type FourBundleBuyFirstParams, type FourBuyFirstSignConfig, type FourBundleBuyFirstSignParams, type FourBuyFirstResult, } from '../chains/bsc/four/swap-buy-first.js';
-export { flapBundleBuyFirstMerkle } from '../shared/flap/portal-bundle-merkle/swap-buy-first.js';
-export type { FlapBuyFirstSignConfig, FlapBuyFirstConfig, FlapBundleBuyFirstSignParams, FlapBundleBuyFirstParams, FlapBuyFirstResult, } from '../shared/flap/portal-bundle-merkle/swap-buy-first-helpers.js';
+export { flapBundleBuyFirstMerkle } from '../domains/flap/portal-bundle-merkle/swap-buy-first.js';
+export type { FlapBuyFirstSignConfig, FlapBuyFirstConfig, FlapBundleBuyFirstSignParams, FlapBundleBuyFirstParams, FlapBuyFirstResult, } from '../domains/flap/portal-bundle-merkle/swap-buy-first-helpers.js';
 export { pancakeBundleBuyFirstMerkle } from '../chains/bsc/pancake/bundle-buy-first.js';
 export type { PancakeBuyFirstSignConfig, PancakeBuyFirstConfig, PancakeBundleBuyFirstSignParams, PancakeBundleBuyFirstParams, PancakeBuyFirstResult, } from '../chains/bsc/pancake/bundle-buy-first-helpers.js';
-export { flapBundleCurveToDex, type CurveToDexChain, type DexPoolType, type CurveToDexSignConfig, type CurveBuyerConfig, type DexBuyerConfig, type FlapCurveToDexParams, type FlapCurveToDexResult, } from '../shared/flap/portal-bundle-merkle/curve-to-dex.js';
-export { flapBundleCreateToDex, type CreateToDexChain, type CreateToDexSignConfig, type CreateTokenInfo, type FlapCreateToDexParams, type FlapCreateToDexResult, } from '../shared/flap/portal-bundle-merkle/create-to-dex.js';
-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, type VaultType, type TaxVaultConfig, type VaultInfo, type FieldDescriptor, type VaultDataSchema, type ApproveAction, type VaultMethodSchema, type VaultUISchema, encodeVaultData, buildVaultParams, buildVaultExtensionParams, getVaultFactoryAddress, getVaultPortalAddress, queryVaultDataSchema, queryVaultUISchema, queryVaultDescription, validateVaultFactory, getVaultInfo, isValidContract, } from '../shared/flap/vault.js';
+export { flapBundleCurveToDex, type CurveToDexChain, type DexPoolType, type CurveToDexSignConfig, type CurveBuyerConfig, type DexBuyerConfig, type FlapCurveToDexParams, type FlapCurveToDexResult, } from '../domains/flap/portal-bundle-merkle/curve-to-dex.js';
+export { flapBundleCreateToDex, type CreateToDexChain, type CreateToDexSignConfig, type CreateTokenInfo, type FlapCreateToDexParams, type FlapCreateToDexResult, } from '../domains/flap/portal-bundle-merkle/create-to-dex.js';
+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, type VaultType, type TaxVaultConfig, type VaultInfo, type FieldDescriptor, type VaultDataSchema, type ApproveAction, type VaultMethodSchema, type VaultUISchema, encodeVaultData, buildVaultParams, buildVaultExtensionParams, getVaultFactoryAddress, getVaultPortalAddress, queryVaultDataSchema, queryVaultUISchema, queryVaultDescription, validateVaultFactory, getVaultInfo, isValidContract, } from '../domains/flap/vault.js';
 export { quoteV2, quoteV3, quote, getTokenToNativeQuote, getNativeToTokenQuote, 
 /** 链名字符串版 WETH/WBNB 地址（与 shared/constants.getWrappedNativeAddress(chainId) 签名不同） */
-getWrappedNativeAddress, getStableCoins, } from '../utils/quote-helpers.js';
+getWrappedNativeAddress, getStableCoins, } from '../domains/quote/quote-helpers.js';
 export { submitDirectToRpc, submitDirectToRpcSequential, submitDirectToRpcSequentialNoWait, submitDirectToRpcParallel, submitDirectToRpcSmart, submitDirectToRpcSmart as xlayerBundleSubmit, type DirectSubmitConfig, type DirectSubmitResult, type DirectTxResult, } from '../chains/bsc/four/submit.js';
 export { submitBundleToEni, submitEniParallelThenProfit, type EniBundleSubmitConfig, type EniBundleSubmitResult, } from '../chains/eni/submit.js';
-export { directV2BatchBuy, directV2BatchSell, directV3BatchBuy, directV3BatchSell, getRouterAddress, DIRECT_ROUTERS, type DirectV2BuyParams, type DirectV2SellParams, type DirectV3BuyParams, type DirectV3SellParams, type DirectRouterResult, type DirectRouterSignConfig, type DexKey, type RouterVersion, } from '../dex/index.js';
+export { directV2BatchBuy, directV2BatchSell, directV3BatchBuy, directV3BatchSell, getRouterAddress, DIRECT_ROUTERS, type DirectV2BuyParams, type DirectV2SellParams, type DirectV3BuyParams, type DirectV3SellParams, type DirectRouterResult, type DirectRouterSignConfig, type DexKey, type RouterVersion, } from '../domains/dex/index.js';
 export * as XLayer from '../chains/xlayer/eoa/index.js';
 export { 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, signEoaWashBuyTransactions as xlayerSignEoaWashBuyTransactions, signEoaWashSellTransactions as xlayerSignEoaWashSellTransactions, signEoaWashVolumeTransactions as xlayerSignEoaWashVolumeTransactions, type EoaWashPoolType as XLayerEoaWashPoolType, type EoaWashVolumeParams as XLayerEoaWashVolumeParams, type EoaWashVolumeResult as XLayerEoaWashVolumeResult, xlayerQuickBatchSwapMerkle, xlayerCrossSwapMerkle, xlayerPureCrossSwapMerkle, type XLayerEoaSwapConfig, type XLayerQuickBatchSwapParams, type XLayerQuickBatchSwapResult, type XLayerCrossSwapParams, type XLayerCrossSwapResult, type XLayerPureCrossSwapParams, type XLayerPureCrossSwapResult, type BundleSwapParams as XLayerBundleSwapParams, type BundleSwapSignParams as XLayerBundleSwapSignParams, type BundleBatchSwapParams as XLayerBundleBatchSwapParams, type BundleBatchSwapSignParams as XLayerBundleBatchSwapSignParams, type BuyFirstParams as XLayerBuyFirstParams, type BuyFirstResult as XLayerBuyFirstResult, } from '../chains/xlayer/eoa/index.js';
 export * as XLayerEIP7702 from '../chains/xlayer/eip7702/index.js';

package/dist/exports/root-swap-dex-and-xlayer.js

@@ -10,23 +10,23 @@
 // 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';
+export { flapBundleSwapMerkle, flapBatchSwapMerkle, flapQuickBatchSwapMerkle, flapCrossSwapMerkle, } from '../domains/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 { flapBundleBuyFirstMerkle } from '../domains/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';
+export { flapBundleCurveToDex, } from '../domains/flap/portal-bundle-merkle/curve-to-dex.js';
 // ✅ 发币 + 一键买到外盘（Create → Curve → DEX）- 新代币
-export { flapBundleCreateToDex, } from '../shared/flap/portal-bundle-merkle/create-to-dex.js';
+export { flapBundleCreateToDex, } from '../domains/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, getVaultFactoryAddress, getVaultPortalAddress, queryVaultDataSchema, queryVaultUISchema, queryVaultDescription, validateVaultFactory, getVaultInfo, isValidContract, } from '../shared/flap/vault.js';
-// ✅ V2/V3 报价工具（QUOTE_CONFIG / QUOTE_V3_FEE_TIERS 见 root-foundations / shared/constants/quote）
+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, getVaultFactoryAddress, getVaultPortalAddress, queryVaultDataSchema, queryVaultUISchema, queryVaultDescription, validateVaultFactory, getVaultInfo, isValidContract, } from '../domains/flap/vault.js';
+// ✅ V2/V3 报价工具（QUOTE_CONFIG / QUOTE_V3_FEE_TIERS 见 root-foundations / core/constants/quote）
 export { quoteV2, quoteV3, quote, getTokenToNativeQuote, getNativeToTokenQuote, 
 /** 链名字符串版 WETH/WBNB 地址（与 shared/constants.getWrappedNativeAddress(chainId) 签名不同） */
-getWrappedNativeAddress, getStableCoins, } from '../utils/quote-helpers.js';
+getWrappedNativeAddress, getStableCoins, } from '../domains/quote/quote-helpers.js';
 // ✅ Monad 等不支持 Bundle 的链：逐笔 RPC 广播方法（服务器端使用）
 export { submitDirectToRpc, submitDirectToRpcSequential, submitDirectToRpcSequentialNoWait, submitDirectToRpcParallel, submitDirectToRpcSmart, submitDirectToRpcSmart as xlayerBundleSubmit, } from '../chains/bsc/four/submit.js';
 // ✅ ENI Bundle 提交
@@ -42,7 +42,7 @@ directV3BatchBuy, directV3BatchSell,
 // 辅助函数
 getRouterAddress, 
 // 常量
-DIRECT_ROUTERS, } from '../dex/index.js';
+DIRECT_ROUTERS, } from '../domains/dex/index.js';
 // ============================================================
 // ✅ XLayer SDK（EOA 模式 + EIP-7702）
 // ============================================================

package/dist/index.d.ts

@@ -1,20 +1,17 @@
 /**
- * SDK 公共 API 聚合入口
+ * SDK 公共 API 聚合入口（3.0 · 不推荐作默认消费入口）
  *
- * - **实现代码**分布于 `chains/`、`contracts/`、`shared/`、`utils/`、`dex/` 等目录。
- * - **扁平再导出**按域拆分至 `exports/root-*.ts`，避免单文件维护成本过高；修改导出时请编辑对应分片。
- * - **命名空间导出**（`foundation` / `bundleCore` / `flows`）供新代码按层引用；`chains` 见 `root-foundations`。
- *
- * @see README.zh-CN.md · README.md
- * @see 子路径：`four-flap-meme-sdk/foundation` · `four-flap-meme-sdk/bundle-core` · `four-flap-meme-sdk/flows` · `four-flap-meme-sdk/constants`
+ * - **实现**：`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 './shared/foundation/index.js';
+export * as foundation from './core/foundation.js';
 /** Bundle 共享核心：internal、submit、config-helpers、four-meme 实现 */
-export * as bundleCore from './bundle-core/index.js';
+export * as bundleCore from './bundle/index.js';
 /** 高层业务流程 */
-export * as flows from './flows/index.js';
+export * as flows from './domains/flows/index.js';

package/dist/index.js

@@ -1,20 +1,17 @@
 /**
- * SDK 公共 API 聚合入口
+ * SDK 公共 API 聚合入口（3.0 · 不推荐作默认消费入口）
  *
- * - **实现代码**分布于 `chains/`、`contracts/`、`shared/`、`utils/`、`dex/` 等目录。
- * - **扁平再导出**按域拆分至 `exports/root-*.ts`，避免单文件维护成本过高；修改导出时请编辑对应分片。
- * - **命名空间导出**（`foundation` / `bundleCore` / `flows`）供新代码按层引用；`chains` 见 `root-foundations`。
- *
- * @see README.zh-CN.md · README.md
- * @see 子路径：`four-flap-meme-sdk/foundation` · `four-flap-meme-sdk/bundle-core` · `four-flap-meme-sdk/flows` · `four-flap-meme-sdk/constants`
+ * - **实现**：`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 './shared/foundation/index.js';
+export * as foundation from './core/foundation.js';
 /** Bundle 共享核心：internal、submit、config-helpers、four-meme 实现 */
-export * as bundleCore from './bundle-core/index.js';
+export * as bundleCore from './bundle/index.js';
 /** 高层业务流程 */
-export * as flows from './flows/index.js';
+export * as flows from './domains/flows/index.js';

package/dist/utils/airdrop-sweep.js

@@ -1,7 +1,7 @@
 import { ethers, JsonRpcProvider } from 'ethers';
-import { GAS_LIMITS, isEniChain } from '../shared/constants/index.js';
-import { buildGasFields } from '../shared/foundation/gas/bundle-gas.js';
-import { getErc20Decimals } from '../shared/foundation/erc20/decimals.js';
+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;
 }

package/dist/utils/bundle-helpers.d.ts

@@ -1,10 +1,10 @@
 /**
- * Bundle 交易辅助工具 — 实现已迁至 shared/foundation/
+ * Bundle 交易辅助工具 — 实现已迁至 core/
  * 本文件保留 re-export，兼容现有 import 路径。
  */
-export { NonceManager } from '../shared/foundation/nonce/nonce-manager.js';
-export { type GasPriceConfig, type GasEstimateConfig, type BuildTransactionOptions, type CommonBundleConfig, getOptimizedGasPrice, estimateGasWithSafety, estimateGasBatch, buildTransaction, getGasLimit, getGasPriceConfig, getTxType, buildGasFields, } from '../shared/foundation/gas/bundle-gas.js';
-export { type ProfitHopConfig, type ProfitHopResult, PROFIT_HOP_COUNT, buildProfitHopTransactions, } from '../shared/foundation/gas/profit-hop.js';
-export { getChainId, signTransactionsBatch, signTransactionsBatchMultiWallet, validateSignedTransactions, } from '../shared/foundation/tx/sign-batch.js';
-export { getDeadline, encodeV3Path, decodeV3Path } from '../shared/foundation/dex/v3-path.js';
-import '../shared/foundation/tx/wallet-sign-patch.js';
+export { NonceManager } from '../core/nonce/nonce-manager.js';
+export { type GasPriceConfig, type GasEstimateConfig, type BuildTransactionOptions, type CommonBundleConfig, getOptimizedGasPrice, estimateGasWithSafety, estimateGasBatch, buildTransaction, getGasLimit, getGasPriceConfig, getTxType, buildGasFields, } from '../core/gas/bundle-gas.js';
+export { type ProfitHopConfig, type ProfitHopResult, PROFIT_HOP_COUNT, buildProfitHopTransactions, } from '../core/gas/profit-hop.js';
+export { getChainId, signTransactionsBatch, signTransactionsBatchMultiWallet, validateSignedTransactions, } from '../core/tx/sign-batch.js';
+export { getDeadline, encodeV3Path, decodeV3Path } from '../core/dex/v3-path.js';
+import '../core/tx/wallet-sign-patch.js';

package/dist/utils/bundle-helpers.js

@@ -1,11 +1,11 @@
 /**
- * Bundle 交易辅助工具 — 实现已迁至 shared/foundation/
+ * Bundle 交易辅助工具 — 实现已迁至 core/
  * 本文件保留 re-export，兼容现有 import 路径。
  */
-export { NonceManager } from '../shared/foundation/nonce/nonce-manager.js';
-export { getOptimizedGasPrice, estimateGasWithSafety, estimateGasBatch, buildTransaction, getGasLimit, getGasPriceConfig, getTxType, buildGasFields, } from '../shared/foundation/gas/bundle-gas.js';
-export { PROFIT_HOP_COUNT, buildProfitHopTransactions, } from '../shared/foundation/gas/profit-hop.js';
-export { getChainId, signTransactionsBatch, signTransactionsBatchMultiWallet, validateSignedTransactions, } from '../shared/foundation/tx/sign-batch.js';
-export { getDeadline, encodeV3Path, decodeV3Path } from '../shared/foundation/dex/v3-path.js';
+export { NonceManager } from '../core/nonce/nonce-manager.js';
+export { getOptimizedGasPrice, estimateGasWithSafety, estimateGasBatch, buildTransaction, getGasLimit, getGasPriceConfig, getTxType, buildGasFields, } from '../core/gas/bundle-gas.js';
+export { PROFIT_HOP_COUNT, buildProfitHopTransactions, } from '../core/gas/profit-hop.js';
+export { getChainId, signTransactionsBatch, signTransactionsBatchMultiWallet, validateSignedTransactions, } from '../core/tx/sign-batch.js';
+export { getDeadline, encodeV3Path, decodeV3Path } from '../core/dex/v3-path.js';
 // 加载 Wallet EIP-1559 patch（NonceManager 模块也会加载，此处确保从 bundle-helpers 导入时生效）
-import '../shared/foundation/tx/wallet-sign-patch.js';
+import '../core/tx/wallet-sign-patch.js';

package/dist/utils/constants.d.ts

@@ -2,8 +2,8 @@
  * 公共常量 - 向后兼容 re-export 层
  *
  * 新代码请直接使用 `shared/constants`：
- * `import { CHAINS, ADDRESSES, getProfitRateBps } from '../shared/constants/index.js'`
+ * `import { CHAINS, ADDRESSES, getProfitRateBps } from '../core/constants/index.js'`
  *
  * v2：不再导出 `CHAIN` / `DEFAULT_DEADLINE_MINUTES` / `PROFIT_CONFIG` / 报价 `V3_FEE_TIERS`。
  */
-export { CHAINS, CHAIN_ID_MAP, getChainById, getChainName, getDefaultRpcUrl, isKnownChain, isBscChain, isXLayerChain, isMonadChain, isEniChain, getConfirmationTimeout, GAS_LIMITS, GAS_CONFIG, calculateGasLimit, getTransferGasLimit, ZERO_ADDRESS, BLOCKRAZOR_BUILDER_EOA, ADDRESSES, getAddress, getWrappedNativeAddress, getMulticall3Address, getFlapPortalAddress, isZeroAddress, isNativeToken, getProfitRecipient, getAllProfitRecipients, getProfitRateBps, calculateProfitAmount, calculateProfitHopGasCost, TRANSFER_FEE_PER_ADDRESS, getTransferFeePerAddress, calculateTransferFee, QUOTE_CONFIG, QUOTE_V3_FEE_TIERS, } from '../shared/constants/index.js';
+export { CHAINS, CHAIN_ID_MAP, getChainById, getChainName, getDefaultRpcUrl, isKnownChain, isBscChain, isXLayerChain, isMonadChain, isEniChain, getConfirmationTimeout, GAS_LIMITS, GAS_CONFIG, calculateGasLimit, getTransferGasLimit, ZERO_ADDRESS, BLOCKRAZOR_BUILDER_EOA, ADDRESSES, getAddress, getWrappedNativeAddress, getMulticall3Address, getFlapPortalAddress, isZeroAddress, isNativeToken, getProfitRecipient, getAllProfitRecipients, getProfitRateBps, calculateProfitAmount, calculateProfitHopGasCost, TRANSFER_FEE_PER_ADDRESS, getTransferFeePerAddress, calculateTransferFee, QUOTE_CONFIG, QUOTE_V3_FEE_TIERS, } from '../core/constants/index.js';

package/dist/utils/constants.js

@@ -2,8 +2,8 @@
  * 公共常量 - 向后兼容 re-export 层
  *
  * 新代码请直接使用 `shared/constants`：
- * `import { CHAINS, ADDRESSES, getProfitRateBps } from '../shared/constants/index.js'`
+ * `import { CHAINS, ADDRESSES, getProfitRateBps } from '../core/constants/index.js'`
  *
  * v2：不再导出 `CHAIN` / `DEFAULT_DEADLINE_MINUTES` / `PROFIT_CONFIG` / 报价 `V3_FEE_TIERS`。
  */
-export { CHAINS, CHAIN_ID_MAP, getChainById, getChainName, getDefaultRpcUrl, isKnownChain, isBscChain, isXLayerChain, isMonadChain, isEniChain, getConfirmationTimeout, GAS_LIMITS, GAS_CONFIG, calculateGasLimit, getTransferGasLimit, ZERO_ADDRESS, BLOCKRAZOR_BUILDER_EOA, ADDRESSES, getAddress, getWrappedNativeAddress, getMulticall3Address, getFlapPortalAddress, isZeroAddress, isNativeToken, getProfitRecipient, getAllProfitRecipients, getProfitRateBps, calculateProfitAmount, calculateProfitHopGasCost, TRANSFER_FEE_PER_ADDRESS, getTransferFeePerAddress, calculateTransferFee, QUOTE_CONFIG, QUOTE_V3_FEE_TIERS, } from '../shared/constants/index.js';
+export { CHAINS, CHAIN_ID_MAP, getChainById, getChainName, getDefaultRpcUrl, isKnownChain, isBscChain, isXLayerChain, isMonadChain, isEniChain, getConfirmationTimeout, GAS_LIMITS, GAS_CONFIG, calculateGasLimit, getTransferGasLimit, ZERO_ADDRESS, BLOCKRAZOR_BUILDER_EOA, ADDRESSES, getAddress, getWrappedNativeAddress, getMulticall3Address, getFlapPortalAddress, isZeroAddress, isNativeToken, getProfitRecipient, getAllProfitRecipients, getProfitRateBps, calculateProfitAmount, calculateProfitHopGasCost, TRANSFER_FEE_PER_ADDRESS, getTransferFeePerAddress, calculateTransferFee, QUOTE_CONFIG, QUOTE_V3_FEE_TIERS, } from '../core/constants/index.js';

package/dist/utils/contract-factory.js

@@ -1,6 +1,6 @@
 import { Contract, Wallet } from 'ethers';
 import { TokenManager, TokenManager2, TokenManagerHelper3 } from '../abis/index.js';
-import { ADDRESSES } from '../shared/constants/index.js';
+import { ADDRESSES } from '../core/constants/index.js';
 import { createProvider } from './provider-factory.js';
 const TOKEN_MANAGER_ABI = TokenManager;
 const TOKEN_MANAGER2_ABI = TokenManager2;

package/dist/utils/errors.d.ts

@@ -1,6 +1,6 @@
-import { SdkErrorCode } from '../types/errors.js';
+import { SdkErrorCode } from '../core/legacy-types/errors.js';
 import type { FourErrorCode } from './types/errors.js';
-export { SdkErrorCode } from '../types/errors.js';
+export { SdkErrorCode } from '../core/legacy-types/errors.js';
 export type { FourErrorCode } from './types/errors.js';
 export declare function parseFourError(err: unknown): {
     code?: FourErrorCode;

package/dist/utils/errors.js

@@ -1,6 +1,6 @@
-import { getErrorMessageFromUnknown } from '../shared/foundation/normalize-unknown.js';
-import { SdkErrorCode } from '../types/errors.js';
-export { SdkErrorCode } from '../types/errors.js';
+import { getErrorMessageFromUnknown } from '../core/normalize-unknown.js';
+import { SdkErrorCode } from '../core/legacy-types/errors.js';
+export { SdkErrorCode } from '../core/legacy-types/errors.js';
 const MESSAGES = {
     GW: 'Amount precision is not aligned to GWEI',
     ZA: "The 'to' address should not be address(0)",

package/dist/utils/hop-chains.d.ts

@@ -1,7 +1,7 @@
 /**
  * 多跳（Hop Chain）转账链生成工具
  *
- * 提取自 chains/bsc/four/swap.ts、chains/bsc/pancake/bundle-swap.ts、shared/flap/portal-bundle-merkle/swap.ts
+ * 提取自 chains/bsc/four/swap.ts、chains/bsc/pancake/bundle-swap.ts、domains/flap/portal-bundle-merkle/swap.ts
  * 消除三个文件之间的复制代码
  */
 import { ethers, Wallet, JsonRpcProvider } from 'ethers';

package/dist/utils/hop-chains.js

@@ -1,11 +1,11 @@
 /**
  * 多跳（Hop Chain）转账链生成工具
  *
- * 提取自 chains/bsc/four/swap.ts、chains/bsc/pancake/bundle-swap.ts、shared/flap/portal-bundle-merkle/swap.ts
+ * 提取自 chains/bsc/four/swap.ts、chains/bsc/pancake/bundle-swap.ts、domains/flap/portal-bundle-merkle/swap.ts
  * 消除三个文件之间的复制代码
  */
 import { ethers, Wallet } from 'ethers';
-import { GAS_LIMITS } from '../shared/constants/index.js';
+import { GAS_LIMITS } from '../core/constants/index.js';
 import { ERC20_ABI } from '../abis/common.js';
 import { generateWallets } from './wallet.js';
 export const NATIVE_TRANSFER_GAS_LIMIT = GAS_LIMITS.NATIVE_TRANSFER;

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+/** pure utils barrel */
+export * from './wallet.js';
+export * from './concurrency.js';
+export * from './provider-factory.js';
+export * from './bundle-helpers.js';

package/dist/utils/index.js

@@ -0,0 +1,5 @@
+/** pure utils barrel */
+export * from './wallet.js';
+export * from './concurrency.js';
+export * from './provider-factory.js';
+export * from './bundle-helpers.js';

package/dist/utils/mpcExclusive.js

@@ -1,6 +1,6 @@
 import { Contract, JsonRpcProvider } from 'ethers';
 import TokenManager2Abi from '../abis/contracts/TokenManager2.json' with { type: 'json' };
-import { ADDRESSES } from '../shared/constants/index.js';
+import { ADDRESSES } from '../core/constants/index.js';
 const TOKEN_MANAGER2_ABI = TokenManager2Abi;
 // 链上识别：template & 0x10000 > 0
 export async function isExclusiveOnChain(params) {

package/dist/utils/stealth-transfer.js

@@ -1,6 +1,6 @@
 import { ethers, JsonRpcProvider } from 'ethers';
-import { Club48Client } from '../shared/clients/club48.js';
-import { GAS_LIMITS } from '../shared/constants/index.js';
+import { Club48Client } from '../core/clients/club48.js';
+import { GAS_LIMITS } from '../core/constants/index.js';
 /**
  * 隐秘转账（原生币，多跳）
  * - 生成 hopCount 个中转地址

package/dist/utils/swap-helpers.d.ts

@@ -2,7 +2,7 @@
  * 换手交易通用工具函数
  */
 import { Wallet, JsonRpcProvider } from 'ethers';
-import type { MerkleClient } from '../shared/clients/merkle.js';
+import type { MerkleClient } from '../core/clients/merkle.js';
 /**
  * 检查并执行代币授权（如果需要）
  * ✅ 与 pancake-proxy.ts 的授权逻辑一致

package/dist/utils/swap-helpers.js

@@ -2,7 +2,7 @@
  * 换手交易通用工具函数
  */
 import { ethers, Contract } from 'ethers';
-import { batchCheckAllowances } from './erc20.js';
+import { batchCheckAllowances } from '../core/erc20.js';
 import { ERC20_ABI } from '../abis/common.js';
 import { NonceManager, getOptimizedGasPrice } from './bundle-helpers.js';
 const APPROVAL_THRESHOLD = ethers.MaxUint256 / 2n;

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

@@ -1 +1 @@
-export type { BundleSubmitResult, SignedTransactionsResult, AirdropDisperseParams, AirdropDisperseSignParams, AirdropSweepParams, AirdropSweepSignParams, DisperseParams, DisperseSignParams, SweepParams, SweepSignParams, } from '../../shared/foundation/types/airdrop-sweep.js';
+export type { BundleSubmitResult, SignedTransactionsResult, AirdropDisperseParams, AirdropDisperseSignParams, AirdropSweepParams, AirdropSweepSignParams, DisperseParams, DisperseSignParams, SweepParams, SweepSignParams, } from '../../core/types/airdrop-sweep.js';

package/dist/utils/types/index.d.ts

@@ -1,10 +1,10 @@
-/** utils 层类型 facade（唯一源见 `shared/foundation/types/` 或同目录模块专用类型） */
-export type * from './holders-maker.js';
-export type * from './lp-inspect.js';
+/** utils 层类型 facade（业务类型源在 core/types；utils 不得依赖 domains） */
+export type * from '../../core/types/holders-maker.js';
+export type * from '../../core/types/lp-inspect.js';
 export type * from './airdrop-sweep.js';
-export type * from './private-sale.js';
-export type * from './quote-helpers.js';
-export type * from './erc20.js';
+export type * from '../../core/types/private-sale.js';
+export type * from '../../core/types/quote-helpers.js';
+export type * from '../../core/types/erc20.js';
 export type * from './wallet.js';
 export type * from './stealth-transfer.js';
 export type * from './errors.js';

package/dist/utils/types/stealth-transfer.d.ts

@@ -1,4 +1,4 @@
-import type { SoulPointSignatureMode, VNormalizationMode } from '../../shared/clients/club48.js';
+import type { SoulPointSignatureMode, VNormalizationMode } from '../../core/clients/club48.js';
 export type StealthTransferResult = {
     bundleUuid: string;
     txs: string[];

package/dist/utils/wallet.d.ts

@@ -1,7 +1,7 @@
-import { type GeneratedWallet } from '../shared/foundation/wallet/generate.js';
+import { type GeneratedWallet } from '../core/wallet/generate.js';
 import type { MultiTokenBalancesResult, MulticallResult, PrivateKeyValidation } from './types/wallet.js';
 export type { PrivateKeyValidation, MulticallResult, MultiTokenBalancesResult, } from './types/wallet.js';
-export type { GeneratedWallet } from '../shared/foundation/wallet/generate.js';
+export type { GeneratedWallet } from '../core/wallet/generate.js';
 /**
  * 批量生成钱包（并行优化）
  */

package/dist/utils/wallet.js

@@ -1,8 +1,8 @@
 import { Wallet, Interface, JsonRpcProvider, formatEther, formatUnits, isHexString } from 'ethers';
-import { CHAIN_ID_MAP, ADDRESSES } from '../shared/constants/index.js';
+import { CHAIN_ID_MAP, ADDRESSES } from '../core/constants/index.js';
 import { ERC20_ABI, MULTICALL3_ABI } from '../abis/common.js';
-import { getErrorMessageFromUnknown } from '../shared/foundation/index.js';
-import { generateWallets as generateWalletsFromFoundation, } from '../shared/foundation/wallet/generate.js';
+import { getErrorMessageFromUnknown } from '../core/index.js';
+import { generateWallets as generateWalletsFromFoundation, } from '../core/wallet/generate.js';
 // ============================================================================
 // 常量
 // ============================================================================