four-flap-meme-sdk 2.2.19 → 2.2.20

package/dist/utils/stealth-transfer.js

@@ -54,8 +54,8 @@ async function _stealthTransferInternal(params) {
         throw new Error(`insufficient balance: need ${needed.toString()}, have ${rootBal.toString()}`);
     }
     // ✅ 并行预取所有 nonce
-    const allAddresses = [rootAddr, ...hops.map(w => w.address)];
-    const nonces = await Promise.all(allAddresses.map(addr => provider.getTransactionCount(addr, 'pending')));
+    const allAddresses = [rootAddr, ...hops.map((w) => w.address)];
+    const nonces = await Promise.all(allAddresses.map((addr) => provider.getTransactionCount(addr, 'pending')));
     const signed = [];
     const hopAddresses = [];
     if (mode !== 'erc20') {
@@ -92,10 +92,14 @@ async function _stealthTransferInternal(params) {
     }
     else {
         // ============== ERC20 代币多跳路径 ==============
+        const erc20Config = erc20;
+        if (!erc20Config?.address) {
+            throw new Error('erc20.address is required in erc20 mode');
+        }
         const erc20Iface = new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
-        const transferGas = erc20?.transferGasLimit ?? GAS_LIMITS.ERC20_TRANSFER;
+        const transferGas = erc20Config.transferGasLimit ?? GAS_LIMITS.ERC20_TRANSFER;
         // 填充 hopAddresses
-        hops.forEach(hop => hopAddresses.push(hop.address));
+        hops.forEach((hop) => hopAddresses.push(hop.address));
         // ✅ 并行签名所有 gas 注资交易（root -> hop[i]）
         const fundTxs = await Promise.all(hops.map((hop, i) => root.signTransaction({
             to: hop.address,
@@ -108,14 +112,14 @@ async function _stealthTransferInternal(params) {
         })));
         signed.push(...fundTxs);
         // 代币持有者：可选独立私钥，未提供则用 root
-        const tokenOwner = (erc20?.holderPrivateKey && erc20.holderPrivateKey.length > 0)
-            ? new ethers.Wallet(erc20.holderPrivateKey, provider)
+        const tokenOwner = erc20Config.holderPrivateKey && erc20Config.holderPrivateKey.length > 0
+            ? new ethers.Wallet(erc20Config.holderPrivateKey, provider)
             : root;
         // tokenOwner -> hop0: ERC20 transfer 全量 token
         const callDataRoot = erc20Iface.encodeFunctionData('transfer', [hops[0].address, amountWei]);
         const rootTokenNonce = nonces[0] + hops.length;
         const erc20TxRoot = await tokenOwner.signTransaction({
-            to: erc20.address,
+            to: erc20Config.address,
             data: callDataRoot,
             value: 0n,
             nonce: rootTokenNonce,
@@ -131,7 +135,7 @@ async function _stealthTransferInternal(params) {
             const nextTo = isLast ? finalTo : hops[i + 1].address;
             const callData = erc20Iface.encodeFunctionData('transfer', [nextTo, amountWei]);
             return hop.signTransaction({
-                to: erc20.address,
+                to: erc20Config.address,
                 data: callData,
                 value: 0n,
                 nonce: nonces[i + 1],
@@ -148,9 +152,7 @@ async function _stealthTransferInternal(params) {
     const bundleUuid = await club48.sendBundle({
         txs: signed,
         maxBlockNumber: (await provider.getBlockNumber()) + blockOffset,
-    }, spPrivateKey
-        ? { spMode: spMode ?? 'timestampPersonalSign', spPrivateKey, spVMode }
-        : undefined);
+    }, spPrivateKey ? { spMode: spMode ?? 'timestampPersonalSign', spPrivateKey, spVMode } : undefined);
     return { bundleUuid, txs: signed, hopAddresses };
 }
 /**
@@ -160,21 +162,30 @@ async function _stealthTransferInternal(params) {
  * - 自动生成 hopCount 个中转地址，并通过 48.club Bundle 原子提交
  */
 export async function stealthTransfer(params) {
-    const { rpcUrl, chainId, rootPrivateKey, finalTo, hopCount, amount, tokenAddress, tokenHolderPrivateKey, bundleEndpoint, gasPriceGwei, gasLimit, blockOffset, spMode, spPrivateKey, spVMode } = params;
+    const { rpcUrl, chainId, rootPrivateKey, finalTo, hopCount, amount, tokenAddress, tokenHolderPrivateKey, bundleEndpoint, gasPriceGwei, gasLimit, blockOffset, spMode, spPrivateKey, spVMode, } = params;
     if (!tokenAddress) {
         // 原生：直接 parseEther
         const amountWei = ethers.parseEther(amount);
         return await _stealthTransferInternal({
-            rpcUrl, chainId, rootPrivateKey, finalTo, hopCount,
+            rpcUrl,
+            chainId,
+            rootPrivateKey,
+            finalTo,
+            hopCount,
             amountWei,
             mode: 'native',
-            bundleEndpoint, gasPriceGwei, gasLimit, blockOffset,
-            spMode, spPrivateKey, spVMode
+            bundleEndpoint,
+            gasPriceGwei,
+            gasLimit,
+            blockOffset,
+            spMode,
+            spPrivateKey,
+            spVMode,
         });
     }
     // ERC20：自动读取 decimals（读取失败则回退 18）
     const provider = new JsonRpcProvider(rpcUrl, chainId);
-    let decimals = 18;
+    let decimals;
     try {
         const erc20 = new ethers.Contract(tokenAddress, ['function decimals() view returns (uint8)'], provider);
         decimals = Number(await erc20.decimals());
@@ -186,11 +197,20 @@ export async function stealthTransfer(params) {
     }
     const amountWei = ethers.parseUnits(amount, decimals);
     return await _stealthTransferInternal({
-        rpcUrl, chainId, rootPrivateKey, finalTo, hopCount,
+        rpcUrl,
+        chainId,
+        rootPrivateKey,
+        finalTo,
+        hopCount,
         amountWei,
         mode: 'erc20',
         erc20: { address: tokenAddress, holderPrivateKey: tokenHolderPrivateKey },
-        bundleEndpoint, gasPriceGwei, gasLimit, blockOffset,
-        spMode, spPrivateKey, spVMode
+        bundleEndpoint,
+        gasPriceGwei,
+        gasLimit,
+        blockOffset,
+        spMode,
+        spPrivateKey,
+        spVMode,
     });
 }

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

@@ -2,11 +2,12 @@
  * 换手交易通用工具函数
  */
 import { Wallet, JsonRpcProvider } from 'ethers';
+import type { MerkleClient } from '../shared/clients/merkle.js';
 /**
  * 检查并执行代币授权（如果需要）
  * ✅ 与 pancake-proxy.ts 的授权逻辑一致
  */
-export declare function ensureTokenApproval(provider: JsonRpcProvider, merkle: any, wallet: Wallet, tokenAddress: string, spenderAddress: string, config: {
+export declare function ensureTokenApproval(provider: JsonRpcProvider, merkle: MerkleClient, wallet: Wallet, tokenAddress: string, spenderAddress: string, config: {
     gasLimit?: number;
     gasLimitMultiplier?: number;
     minGasPriceGwei?: number;
@@ -38,17 +39,3 @@ export declare function calculateSwapLoss(sellAmount: bigint, buyAmount: bigint)
  * 验证钱包BNB余额
  */
 export declare function validateBNBBalance(provider: JsonRpcProvider, walletAddress: string, requiredBNB: bigint, purpose: string): Promise<void>;
-/**
- * 格式化换手结果日志
- */
-export declare function logSwapResult(params: {
-    sellerAddress: string;
-    buyerAddress: string;
-    tokenAddress: string;
-    sellAmount: bigint;
-    buyAmount: bigint;
-    decimals: number;
-    sellerGotBNB: bigint;
-    buyerSpentBNB: bigint;
-    swapType: string;
-}): void;

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';