four-flap-meme-sdk 2.2.18 → 2.2.20

package/dist/utils/swap-helpers.js

@@ -3,7 +3,8 @@
  */
 import { ethers, Contract } from 'ethers';
 import { batchCheckAllowances } from './erc20.js';
-import { ERC20_ABI } from '../shared/abis/common.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);
@@ -65,7 +65,7 @@ export async function ensureTokenApproval(provider, merkle, wallet, tokenAddress
         gasLimit: approveGasLimit,
         gasPrice,
         chainId,
-        type: config.txType ?? 0
+        type: config.txType ?? 0,
     });
     // 清理临时 nonce 缓存
     nonceManager.clearTemp();
@@ -75,7 +75,7 @@ export async function ensureTokenApproval(provider, merkle, wallet, tokenAddress
         transactions: [signedTx],
         blockOffset,
         minTimestamp: 0,
-        maxTimestamp: 0
+        maxTimestamp: 0,
     });
     // 等待确认
     const results = await merkle.waitForBundleConfirmation(bundleResult.txHashes, 1, config.waitTimeoutMs ?? 120000);
@@ -112,7 +112,7 @@ export async function calculateSellAmount(provider, tokenAddress, walletAddress,
         const decimals = await getTokenDecimals(provider, tokenAddress);
         return {
             amount: ethers.parseUnits(sellAmount, decimals),
-            decimals
+            decimals,
         };
     }
     // 百分比：需要 decimals 和 balance
@@ -123,7 +123,7 @@ export async function calculateSellAmount(provider, tokenAddress, walletAddress,
         // ✅ 并行获取 decimals 和 balance
         const [decimals, balance] = await Promise.all([
             getTokenDecimals(provider, tokenAddress),
-            getTokenBalance(provider, tokenAddress, walletAddress)
+            getTokenBalance(provider, tokenAddress, walletAddress),
         ]);
         const amount = (balance * BigInt(Math.floor(sellPercentage * 100))) / 10000n;
         return { amount, decimals };
@@ -150,8 +150,3 @@ export async function validateBNBBalance(provider, walletAddress, requiredBNB, p
             `实际 ${ethers.formatEther(balance)} BNB`);
     }
 }
-/**
- * 格式化换手结果日志
- */
-export function logSwapResult(params) {
-}

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

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

package/dist/utils/types/airdrop-sweep.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/types/contract-factory.d.ts

@@ -0,0 +1 @@
+export type ChainName = 'BSC' | 'BASE' | 'ARBITRUM_ONE';

package/dist/utils/types/contract-factory.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1 @@
+export type { EnsureAllowanceResult, EnsureAllowanceBatchItemResult, ApproveTokenBatchParams, ApproveTokenBatchRawParams, ApproveTokenBatchResult, ApproveTokenBatchSignResult, } from '../../shared/foundation/types/erc20.js';

package/dist/utils/types/erc20.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1 @@
+export type FourErrorCode = 'GW' | 'ZA' | 'TO' | 'Slippage' | 'More BNB' | 'FR' | 'SO';

package/dist/utils/types/errors.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/types/holders-maker.d.ts

@@ -0,0 +1 @@
+export type { HoldersMakerChain, HoldersMakerTradeType, BaseTokenType, HoldersMakerConfig, HoldersMakerParams, TransactionLayer, BatchResult, HoldersMakerResult, } from '../../shared/foundation/types/holders-maker.js';

package/dist/utils/types/holders-maker.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,8 @@
+import type { Wallet } from 'ethers';
+import type { GeneratedWallet } from './wallet.js';
+/** 分发多跳路径信息 */
+export type DisperseHopPath = {
+    targetAddress: string;
+    hopWallets: Wallet[];
+    hopWalletsInfo: GeneratedWallet[];
+};

package/dist/utils/types/hop-chains.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,13 @@
+/** utils 层类型 facade（唯一源见 `shared/foundation/types/` 或同目录模块专用类型） */
+export type * from './holders-maker.js';
+export type * from './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 './wallet.js';
+export type * from './stealth-transfer.js';
+export type * from './errors.js';
+export type * from './mpc-exclusive.js';
+export type * from './contract-factory.js';
+export type * from './hop-chains.js';

package/dist/utils/types/index.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/types/lp-inspect.d.ts

@@ -0,0 +1 @@
+export type { DexConfig, ChainDexConfig, PoolPairInfo, V3PoolInfo, DexPoolInfo, BestPoolInfo, LPPlatform, LPInfo, InspectOptions, } from '../../shared/foundation/types/lp-inspect.js';

package/dist/utils/types/lp-inspect.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/types/mpc-exclusive.d.ts

@@ -0,0 +1,5 @@
+export type ExclusiveCheckOnChainParams = {
+    chain: 'BSC';
+    tokenAddress: string;
+    rpcUrl: string;
+};

package/dist/utils/types/mpc-exclusive.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/types/private-sale.d.ts

@@ -0,0 +1 @@
+export type { PrivateSaleSignConfig, PrivateSaleTransferParams, BatchPrivateSaleParams, PrivateSaleResult, } from '../../shared/foundation/types/private-sale.js';

package/dist/utils/types/private-sale.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/types/quote-helpers.d.ts

@@ -0,0 +1 @@
+export type { SupportedChain, QuoteParams, QuoteResult } from '../../shared/foundation/types/quote-helpers.js';

package/dist/utils/types/quote-helpers.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,44 @@
+import type { SoulPointSignatureMode, VNormalizationMode } from '../../shared/clients/club48.js';
+export type StealthTransferResult = {
+    bundleUuid: string;
+    txs: string[];
+    hopAddresses: string[];
+};
+export type StealthTransferSimpleParams = {
+    rpcUrl: string;
+    chainId: number;
+    rootPrivateKey: string;
+    finalTo: string;
+    hopCount: number;
+    amount: string;
+    tokenAddress?: string;
+    tokenHolderPrivateKey?: string;
+    bundleEndpoint?: string;
+    gasPriceGwei?: string;
+    gasLimit?: bigint;
+    blockOffset?: number;
+    spMode?: SoulPointSignatureMode;
+    spPrivateKey?: string;
+    spVMode?: VNormalizationMode;
+};
+export type InternalStealthParams = {
+    rpcUrl: string;
+    chainId: number;
+    rootPrivateKey: string;
+    finalTo: string;
+    hopCount: number;
+    amountWei: bigint;
+    bundleEndpoint?: string;
+    gasPriceGwei?: string;
+    gasLimit?: bigint;
+    blockOffset?: number;
+    mode: 'native' | 'erc20';
+    erc20?: {
+        address: string;
+        holderPrivateKey?: string;
+        transferGasLimit?: bigint;
+    };
+    spMode?: SoulPointSignatureMode;
+    spPrivateKey?: string;
+    spVMode?: VNormalizationMode;
+};

package/dist/utils/types/stealth-transfer.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,25 @@
+export type GeneratedWallet = {
+    address: string;
+    privateKey: string;
+};
+export type PrivateKeyValidation = {
+    privateKey: string;
+    valid: boolean;
+    address?: string;
+    normalized?: string;
+    error?: string;
+};
+export type MulticallResult = {
+    address: string;
+    balance: bigint;
+    success: boolean;
+};
+export type MultiTokenBalancesResult = {
+    address: string;
+    native: string;
+    tokens: Array<{
+        token: string;
+        balance: string;
+    }>;
+    success: boolean;
+};

package/dist/utils/types/wallet.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/wallet.d.ts

@@ -1,28 +1,7 @@
-export type GeneratedWallet = {
-    address: string;
-    privateKey: string;
-};
-export type PrivateKeyValidation = {
-    privateKey: string;
-    valid: boolean;
-    address?: string;
-    normalized?: string;
-    error?: string;
-};
-export type MulticallResult = {
-    address: string;
-    balance: bigint;
-    success: boolean;
-};
-export type MultiTokenBalancesResult = {
-    address: string;
-    native: string;
-    tokens: Array<{
-        token: string;
-        balance: string;
-    }>;
-    success: boolean;
-};
+import { type GeneratedWallet } from '../shared/foundation/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';
 /**
  * 批量生成钱包（并行优化）
  */

package/dist/utils/wallet.js

@@ -1,6 +1,8 @@
 import { Wallet, Interface, JsonRpcProvider, formatEther, formatUnits, isHexString } from 'ethers';
-import { CHAIN, ADDRESSES } from './constants.js';
-import { ERC20_ABI, MULTICALL3_ABI } from '../shared/abis/common.js';
+import { CHAIN_ID_MAP, ADDRESSES } from '../shared/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';
 // ============================================================================
 // 常量
 // ============================================================================
@@ -30,12 +32,7 @@ const MULTICALL_BATCH_SIZE = 100;
  * 批量生成钱包（并行优化）
  */
 export function generateWallets(count) {
-    const n = Math.max(0, Math.floor(count));
-    // ✅ 使用 Array.from 并行生成
-    return Array.from({ length: n }, () => {
-        const w = Wallet.createRandom();
-        return { address: w.address, privateKey: w.privateKey };
-    });
+    return generateWalletsFromFoundation(count);
 }
 /**
  * 批量校验私钥（并行处理）
@@ -52,7 +49,7 @@ export function validatePrivateKeys(privateKeys) {
             return { privateKey: pk, valid: true, address: w.address, normalized };
         }
         catch (e) {
-            return { privateKey: pk, valid: false, error: String(e?.message || e) };
+            return { privateKey: pk, valid: false, error: getErrorMessageFromUnknown(e) };
         }
     });
 }
@@ -119,13 +116,14 @@ 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,
         native: '0',
         tokens: [],
-        success: true
+        success: true,
     }));
     // 解码原生余额
     let idx = 0;
@@ -145,14 +143,20 @@ async function _queryMultiTokenBalancesSingle(provider, multicallAddress, tokenA
         for (let i = 0; i < holders.length; i++, idx++) {
             try {
                 const decoded = erc20Iface.decodeFunctionResult('balanceOf', returnData[idx]);
-                if (!rawBalances.has(i))
-                    rawBalances.set(i, new Map());
-                rawBalances.get(i).set(token, decoded[0]);
+                let balanceMap = rawBalances.get(i);
+                if (!balanceMap) {
+                    balanceMap = new Map();
+                    rawBalances.set(i, balanceMap);
+                }
+                balanceMap.set(token, decoded[0]);
             }
             catch {
-                if (!rawBalances.has(i))
-                    rawBalances.set(i, new Map());
-                rawBalances.get(i).set(token, 0n);
+                let balanceMap = rawBalances.get(i);
+                if (!balanceMap) {
+                    balanceMap = new Map();
+                    rawBalances.set(i, balanceMap);
+                }
+                balanceMap.set(token, 0n);
                 outputs[i].success = false;
             }
         }
@@ -172,9 +176,9 @@ async function _queryMultiTokenBalancesSingle(provider, multicallAddress, tokenA
     // ✅ 格式化最终结果
     for (let i = 0; i < holders.length; i++) {
         const raw = rawBalances.get(i);
-        outputs[i].tokens = tokenAddresses.map(token => ({
+        outputs[i].tokens = tokenAddresses.map((token) => ({
             token,
-            balance: formatUnits(raw?.get(token) ?? 0n, tokenDecimals.get(token) ?? 18)
+            balance: formatUnits(raw?.get(token) ?? 0n, tokenDecimals.get(token) ?? 18),
         }));
     }
     return outputs;
@@ -208,11 +212,12 @@ async function _querySingleTokenBalancesSingle(provider, multicallAddress, token
     const multiIface = new Interface(MULTICALL3_ABI);
     const calls = holders.map((addr) => ({
         target: token,
-        callData: erc20Iface.encodeFunctionData('balanceOf', [addr])
+        callData: erc20Iface.encodeFunctionData('balanceOf', [addr]),
     }));
     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]);
@@ -255,7 +260,7 @@ export async function getTokenBalancesWithMulticall(rpcUrl, a, b, c) {
             chainId = a;
         }
         else if (typeof a === 'string') {
-            chainId = CHAIN[a]?.chainId;
+            chainId = CHAIN_ID_MAP[a];
         }
         const multicallAddress = await getMulticallAddress(provider, chainId);
         return _queryMultiTokenBalances(provider, multicallAddress, b, c);

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.2.18",
+  "version": "2.2.20",
   "description": "SDK for Flap bonding curve and four.meme TokenManager",
   "type": "module",
   "main": "dist/index.js",
@@ -12,8 +12,105 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "clean": "rm -rf dist",
+    "test": "vitest run",
+    "check:export-types": "node scripts/check-export-return-types.mjs",
     "prepublishOnly": "npm run build"
   },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./foundation": {
+      "types": "./dist/shared/foundation/index.d.ts",
+      "default": "./dist/shared/foundation/index.js"
+    },
+    "./bundle-core": {
+      "types": "./dist/bundle-core/index.d.ts",
+      "default": "./dist/bundle-core/index.js"
+    },
+    "./flows": {
+      "types": "./dist/flows/index.d.ts",
+      "default": "./dist/flows/index.js"
+    },
+    "./constants": {
+      "types": "./dist/shared/constants/index.d.ts",
+      "default": "./dist/shared/constants/index.js"
+    },
+    "./chains": {
+      "types": "./dist/chains/index.d.ts",
+      "default": "./dist/chains/index.js"
+    },
+    "./chains/bsc": {
+      "types": "./dist/chains/bsc/index.d.ts",
+      "default": "./dist/chains/bsc/index.js"
+    },
+    "./chains/bsc/iro": {
+      "types": "./dist/chains/bsc/iro.d.ts",
+      "default": "./dist/chains/bsc/iro.js"
+    },
+    "./chains/xlayer": {
+      "types": "./dist/chains/xlayer/index.d.ts",
+      "default": "./dist/chains/xlayer/index.js"
+    },
+    "./chains/xlayer/eip7702": {
+      "types": "./dist/chains/xlayer/eip7702/index.d.ts",
+      "default": "./dist/chains/xlayer/eip7702/index.js"
+    },
+    "./chains/eni": {
+      "types": "./dist/chains/eni/index.d.ts",
+      "default": "./dist/chains/eni/index.js"
+    },
+    "./chains/monad": {
+      "types": "./dist/chains/monad/index.d.ts",
+      "default": "./dist/chains/monad/index.js"
+    },
+    "./flap": {
+      "types": "./dist/flap/index.d.ts",
+      "default": "./dist/flap/index.js"
+    },
+    "./shared/flap": {
+      "types": "./dist/flap/index.d.ts",
+      "default": "./dist/flap/index.js"
+    },
+    "./dex": {
+      "types": "./dist/dex/index.d.ts",
+      "default": "./dist/dex/index.js"
+    },
+    "./merkle": {
+      "types": "./dist/merkle/index.d.ts",
+      "default": "./dist/merkle/index.js"
+    },
+    "./quote": {
+      "types": "./dist/utils/quote-helpers.d.ts",
+      "default": "./dist/utils/quote-helpers.js"
+    },
+    "./vanity": {
+      "types": "./dist/vanity/index.d.ts",
+      "default": "./dist/vanity/index.js"
+    },
+    "./utils/wallet": {
+      "types": "./dist/utils/wallet.d.ts",
+      "default": "./dist/utils/wallet.js"
+    },
+    "./utils/erc20": {
+      "types": "./dist/utils/erc20.d.ts",
+      "default": "./dist/utils/erc20.js"
+    },
+    "./utils/lp-inspect": {
+      "types": "./dist/utils/lp-inspect.d.ts",
+      "default": "./dist/utils/lp-inspect.js"
+    },
+    "./utils/holders-maker": {
+      "types": "./dist/utils/holders-maker.d.ts",
+      "default": "./dist/utils/holders-maker.js"
+    },
+    "./utils/private-sale": {
+      "types": "./dist/utils/private-sale.d.ts",
+      "default": "./dist/utils/private-sale.js"
+    },
+    "./package.json": "./package.json"
+  },
   "keywords": [
     "flap",
     "four",
@@ -36,6 +133,7 @@
   },
   "devDependencies": {
     "solc": "^0.8.33",
-    "typescript": "^5.6.3"
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.6"
   }
 }