four-flap-meme-sdk 2.2.2 → 2.2.3

package/dist/chains/bsc/four/types.d.ts

@@ -1,476 +1 @@
-import type { GeneratedWallet } from '../../../utils/wallet.js';
-import type { FourTokenTaxInfo } from '../../../shared/clients/four.js';
-export type FourSignConfig = {
-    rpcUrl: string;
-    fourApiUrl?: string;
-    club48Endpoint?: string;
-    club48ExplorerEndpoint?: string;
-    txType?: 0 | 2;
-    gasLimit?: number | bigint;
-    gasLimitMultiplier?: number;
-    gasPriceMultiplierPercent?: number;
-    minGasPriceGwei?: number;
-    chainId?: number;
-    prefer21000ForNative?: boolean;
-    checkBnbForErc20NoHop?: boolean;
-    estimateGas?: boolean;
-    customSubmitFn?: (signedTxs: string[]) => Promise<string>;
-    spPrivateKey?: string;
-    spMode?: 'none' | 'timestampPersonalSign' | 'concatTxHash' | 'rawTimestamp';
-    spVMode?: '27_28' | '0_1';
-    bribeAmount?: number;
-};
-export type FourBundleMerkleConfig = {
-    apiKey: string;
-    customRpcUrl?: string;
-    fourApiUrl?: string;
-    bundleBlockOffset?: number;
-    minBlockOffset?: number;
-    autoRetryBundle?: boolean;
-    maxBundleRetries?: number;
-    txType?: 0 | 2;
-    gasLimit?: number | bigint;
-    gasLimitMultiplier?: number;
-    gasPriceMultiplierPercent?: number;
-    minGasPriceGwei?: number;
-    waitForConfirmation?: boolean;
-    waitTimeoutMs?: number;
-    chainId?: number;
-    prefer21000ForNative?: boolean;
-    checkBnbForErc20NoHop?: boolean;
-    skipSubmit?: boolean;
-};
-export type AmountLike = string | number | bigint;
-export type MerkleTransactionStatus = {
-    index: number;
-    hash: string;
-    success: boolean;
-    blockNumber?: number;
-    gasUsed?: string;
-    effectiveGasPrice?: string;
-    gasCost?: string;
-    error?: string;
-};
-export type MerkleBundleStatus = {
-    bundleHash: string;
-    txHashes: string[];
-    results: MerkleTransactionStatus[];
-    successCount: number;
-    totalGasUsed: bigint;
-    targetBlock: number;
-};
-/**
- * 统一的 Merkle 方法返回类型
- * SDK 不再内部提交，只返回签名交易和元数据
- */
-export type MerkleSignedResult = {
-    /** 已签名的交易数组（发送到服务器进行提交） */
-    signedTransactions: string[];
-    /** 创建代币时返回的代币地址（仅 create 方法使用） */
-    tokenAddress?: string;
-    /** ✅ 转账多跳中间钱包（disperse/sweep 使用，按接收者分组）- 兼容旧版 string[][] 和新版 GeneratedWallet[][] */
-    hopWallets?: (string | GeneratedWallet)[][];
-    /** ✅ 利润多跳中间钱包 */
-    profitHopWallets?: GeneratedWallet[];
-    /** 元数据（如利润信息等） */
-    metadata?: {
-        [key: string]: any;
-    };
-    /** 交易哈希数组（内部提交时返回） */
-    txHashes?: string[];
-};
-/** ✅ 创建代币 + 购买参数（Merkle 版本 - 完整） */
-export type FourCreateWithBundleBuyMerkleParams = {
-    privateKeys: string[];
-    buyAmounts: string[];
-    b0Amount?: string;
-    tokenInfo: {
-        name: string;
-        symbol: string;
-        description: string;
-        imageUrl?: string;
-        imageFile?: Blob;
-        label?: 'Meme' | 'AI' | 'Defi' | 'Games' | 'Infra' | 'De-Sci' | 'Social' | 'Depin' | 'Charity' | 'Others';
-        preSale?: string;
-        webUrl?: string;
-        twitterUrl?: string;
-        telegramUrl?: string;
-        /** ✅ AntiSniperFeeMode（开盘高税模式） */
-        feePlan?: boolean;
-        /** ✅ 税币配置（Tax Token, creatorType=5） */
-        tokenTaxInfo?: FourTokenTaxInfo;
-    };
-    config: FourBundleMerkleConfig;
-};
-/** ✅ 创建代币 + 购买参数（仅签名版本 - 精简） */
-export type FourCreateWithBundleBuySignParams = {
-    privateKeys: string[];
-    buyAmounts: string[];
-    b0Amount?: string;
-    tokenInfo: {
-        name: string;
-        symbol: string;
-        description: string;
-        imageUrl?: string;
-        imageFile?: Blob;
-        label?: 'Meme' | 'AI' | 'Defi' | 'Games' | 'Infra' | 'De-Sci' | 'Social' | 'Depin' | 'Charity' | 'Others';
-        preSale?: string;
-        webUrl?: string;
-        twitterUrl?: string;
-        telegramUrl?: string;
-        /** ✅ AntiSniperFeeMode（开盘高税模式） */
-        feePlan?: boolean;
-        /** ✅ 税币配置（Tax Token, creatorType=5） */
-        tokenTaxInfo?: FourTokenTaxInfo;
-    };
-    config: FourSignConfig;
-};
-/**
- * ✅ 创建代币 + 购买结果（简化版）
- * 包含 tokenAddress 用于返回创建的代币地址
- */
-export type FourCreateWithBundleBuyMerkleResult = MerkleSignedResult;
-/** ✅ 批量购买参数（Merkle 版本 - 完整） */
-export type FourBatchBuyMerkleParams = {
-    privateKeys: string[];
-    buyAmounts: string[];
-    tokenAddress: string;
-    config: FourBundleMerkleConfig;
-};
-/** ✅ 批量购买参数（仅签名版本 - 精简） */
-export type FourBatchBuySignParams = {
-    privateKeys: string[];
-    buyAmounts: string[];
-    tokenAddress: string;
-    config: FourSignConfig;
-};
-/** ✅ 批量购买结果（简化版） */
-export type FourBatchBuyMerkleResult = MerkleSignedResult;
-/** ✅ 批量卖出参数（Merkle 版本 - 完整） */
-export type FourBatchSellMerkleParams = {
-    privateKeys: string[];
-    sellAmounts: string[];
-    tokenAddress: string;
-    minOutputAmounts?: (string | bigint)[];
-    config: FourBundleMerkleConfig;
-};
-/** ✅ 批量卖出参数（仅签名版本 - 精简） */
-export type FourBatchSellSignParams = {
-    privateKeys: string[];
-    sellAmounts: string[];
-    tokenAddress: string;
-    minOutputAmounts?: (string | bigint)[];
-    config: FourSignConfig;
-};
-/** ✅ 批量卖出结果（简化版） */
-export type FourBatchSellMerkleResult = MerkleSignedResult;
-/** ✅ 私有交易基础配置（Merkle 版本 - 完整） */
-export type FourPrivateMerkleBase = {
-    config: FourBundleMerkleConfig;
-};
-/** ✅ 私有交易基础配置（仅签名版本 - 精简） */
-export type FourPrivateSignBase = {
-    config: FourSignConfig;
-};
-/** ✅ 私有购买参数（Merkle 版本 - 完整） */
-export type FourPrivateBuyMerkleParams = FourPrivateMerkleBase & {
-    privateKey: string;
-    tokenAddress: string;
-    funds: string;
-    to?: string;
-};
-/** ✅ 私有购买参数（仅签名版本 - 精简） */
-export type FourPrivateBuySignParams = FourPrivateSignBase & {
-    privateKey: string;
-    tokenAddress: string;
-    funds: string;
-    to?: string;
-};
-/** ✅ 私有卖出参数（Merkle 版本 - 完整） */
-export type FourPrivateSellMerkleParams = FourPrivateMerkleBase & {
-    privateKey: string;
-    tokenAddress: string;
-    amount: string;
-    minFunds?: bigint;
-};
-/** ✅ 私有卖出参数（仅签名版本 - 精简） */
-export type FourPrivateSellSignParams = FourPrivateSignBase & {
-    privateKey: string;
-    tokenAddress: string;
-    amount: string;
-    minFunds?: bigint;
-};
-/** ✅ 私有交易结果（简化版） */
-export type FourPrivateTransactionResult = MerkleSignedResult;
-/** ✅ 批量私有购买参数（Merkle 版本 - 完整） */
-export type FourBatchPrivateBuyMerkleParams = FourPrivateMerkleBase & {
-    privateKeys: string[];
-    fundsList: string[];
-    tokenAddress: string;
-};
-/** ✅ 批量私有购买参数（仅签名版本 - 精简） */
-export type FourBatchPrivateBuySignParams = FourPrivateSignBase & {
-    privateKeys: string[];
-    fundsList: string[];
-    tokenAddress: string;
-};
-/** ✅ 批量私有卖出参数（Merkle 版本 - 完整） */
-export type FourBatchPrivateSellMerkleParams = FourPrivateMerkleBase & {
-    privateKeys: string[];
-    amounts: string[];
-    tokenAddress: string;
-    minFundsEach?: bigint;
-};
-/** ✅ 批量私有卖出参数（仅签名版本 - 精简） */
-export type FourBatchPrivateSellSignParams = FourPrivateSignBase & {
-    privateKeys: string[];
-    amounts: string[];
-    tokenAddress: string;
-    minFundsEach?: bigint;
-};
-/** ✅ 批量私有交易结果（简化版） */
-export type FourBatchPrivateMerkleResult = MerkleSignedResult;
-/** ✅ 分发参数（Merkle 版本 - 完整） */
-export type DisperseMerkleParams = {
-    fromPrivateKey: string;
-    recipients: string[];
-    amount?: AmountLike;
-    amounts?: AmountLike[];
-    tokenAddress?: string;
-    tokenDecimals?: number;
-    hopCount?: number | number[];
-    hopPrivateKeys?: string[][];
-    items?: Array<{
-        to: string;
-        amount: AmountLike;
-        hopCount?: number;
-        hopPrivateKeys?: string[];
-    }>;
-    config: FourBundleMerkleConfig;
-};
-/** ✅ 分发参数（仅签名版本 - 精简） */
-/** 代币池子类型 */
-export type TokenPoolType = 'flap' | 'four' | 'v2' | 'v3';
-/** 报价代币类型（池子的计价代币） */
-export type QuoteTokenType = 'native' | 'usdt' | 'usdc';
-/**
- * 用户类型（用于利润费率）
- * - v0: 万分之6 (6 bps = 0.06%)
- * - v1: 万分之5 (5 bps = 0.05%)
- */
-export type UserType = 'v0' | 'v1';
-export type DisperseSignParams = {
-    fromPrivateKey: string;
-    recipients: string[];
-    amount?: AmountLike;
-    amounts?: AmountLike[];
-    tokenAddress?: string;
-    tokenDecimals?: number;
-    hopCount?: number | number[];
-    hopPrivateKeys?: string[][];
-    items?: Array<{
-        to: string;
-        amount: AmountLike;
-        hopCount?: number;
-        hopPrivateKeys?: string[];
-    }>;
-    config: FourSignConfig;
-    /** ✅ 新增：起始 nonce（用于并行调用时避免 nonce 冲突） */
-    startNonce?: number;
-    /** ✅ 新增：代币池子类型（用于利润报价），默认 'v2' */
-    tokenPoolType?: TokenPoolType;
-    /** ✅ 新增：报价代币类型（池子的计价代币），默认 'native'（BNB/MON） */
-    quoteToken?: QuoteTokenType;
-    /** ✅ 新增：用户类型（用于利润费率），v0=万分之6，v1=万分之5，默认 v0 */
-    userType?: UserType;
-};
-/**
- * ✅ 分发结果（简化版）
- * 包含 hopWallets 用于返回生成的多跳钱包私钥
- */
-export type DisperseMerkleResult = MerkleSignedResult;
-/** ✅ 归集参数（Merkle 版本 - 完整） */
-export type SweepMerkleParams = {
-    sourcePrivateKeys: string[];
-    target: string;
-    targetPrivateKey?: string;
-    ratioPct?: number;
-    ratios?: number[];
-    amount?: AmountLike;
-    amounts?: AmountLike[];
-    tokenAddress?: string;
-    tokenDecimals?: number;
-    skipIfInsufficient?: boolean;
-    hopCount?: number | number[];
-    hopPrivateKeys?: string[][];
-    sources?: Array<{
-        privateKey: string;
-        ratioPct?: number;
-        amount?: AmountLike;
-        hopCount?: number;
-        hopPrivateKeys?: string[];
-    }>;
-    config: FourBundleMerkleConfig;
-};
-/** ✅ 归集参数（仅签名版本 - 精简） */
-export type SweepSignParams = {
-    sourcePrivateKeys: string[];
-    target: string;
-    /** ✅ 新增：归集目标地址的私钥（用于支付利润，不提供则由归集金额最大的源钱包支付） */
-    targetPrivateKey?: string;
-    ratioPct?: number;
-    ratios?: number[];
-    amount?: AmountLike;
-    amounts?: AmountLike[];
-    tokenAddress?: string;
-    tokenDecimals?: number;
-    skipIfInsufficient?: boolean;
-    hopCount?: number | number[];
-    hopPrivateKeys?: string[][];
-    sources?: Array<{
-        privateKey: string;
-        ratioPct?: number;
-        amount?: AmountLike;
-        hopCount?: number;
-        hopPrivateKeys?: string[];
-    }>;
-    config: FourSignConfig;
-    /** ✅ 新增：起始 nonce（用于并行调用时避免 nonce 冲突，仅对第一个源钱包生效） */
-    startNonce?: number;
-    /** ✅ 新增：代币池子类型（用于利润报价），默认 'v2' */
-    tokenPoolType?: TokenPoolType;
-    /** ✅ 新增：报价代币类型（池子的计价代币），默认 'native'（BNB/MON） */
-    quoteToken?: QuoteTokenType;
-    /** ✅ 新增：用户类型（用于利润费率），v0=万分之6，v1=万分之5，默认 v0 */
-    userType?: UserType;
-};
-/**
- * ✅ 归集结果（简化版）
- * 包含 hopWallets 用于返回生成的多跳钱包私钥
- */
-export type SweepMerkleResult = MerkleSignedResult;
-/**
- * 多对多（地址一一对应）转账参数（仅签名版本）
- * - senderPrivateKeys / receiverAddresses 必须等长
- * - amount / amounts 二选一（amounts 优先）
- * - 支持多跳：hopCount 可为 number 或逐对数组
- * - 支持利润刮取：利润由第一个 sender 支付（作为额外费用，不扣减每对转账金额）
- */
-export type PairwiseTransferSignParams = {
-    senderPrivateKeys: string[];
-    receiverAddresses: string[];
-    amount?: AmountLike;
-    amounts?: AmountLike[];
-    tokenAddress?: string;
-    tokenDecimals?: number;
-    hopCount?: number | number[];
-    hopPrivateKeys?: string[][];
-    config: FourSignConfig;
-    /** ✅ 起始 nonce（仅对第一个 sender 生效，用于并行调用避免 nonce 冲突） */
-    startNonce?: number;
-    tokenPoolType?: TokenPoolType;
-    quoteToken?: QuoteTokenType;
-    userType?: UserType;
-};
-export type PairwiseTransferMerkleResult = MerkleSignedResult;
-/** ✅ PancakeProxy 批量购买参数（Merkle 版本 - 完整） */
-export type FourPancakeProxyBatchBuyParams = {
-    privateKeys: string[];
-    buyAmounts: string[];
-    tokenAddress: string;
-    routeType: 'v2' | 'v3-single' | 'v3-multi';
-    v2Path?: string[];
-    v3TokenIn?: string;
-    v3Fee?: number;
-    v3LpAddresses?: string[];
-    v3ExactTokenIn?: string;
-    /** V3 多跳：代币路径 [tokenIn, tokenMid1, ..., tokenOut] */
-    v3Tokens?: string[];
-    /** V3 多跳：费率路径 [fee0, fee1, ...] - 长度 = v3Tokens.length - 1 */
-    v3Fees?: number[];
-    minOutputAmounts?: (string | bigint)[];
-    config: FourBundleMerkleConfig;
-};
-/** ✅ PancakeProxy 批量购买参数（仅签名版本 - 精简） */
-export type FourPancakeProxyBatchBuySignParams = {
-    privateKeys: string[];
-    buyAmounts: string[];
-    tokenAddress: string;
-    routeType: 'v2' | 'v3-single' | 'v3-multi';
-    v2Path?: string[];
-    v3TokenIn?: string;
-    v3Fee?: number;
-    v3LpAddresses?: string[];
-    v3ExactTokenIn?: string;
-    /** V3 多跳：代币路径 [tokenIn, tokenMid1, ..., tokenOut] */
-    v3Tokens?: string[];
-    /** V3 多跳：费率路径 [fee0, fee1, ...] - 长度 = v3Tokens.length - 1 */
-    v3Fees?: number[];
-    minOutputAmounts?: (string | bigint)[];
-    config: FourSignConfig;
-};
-/** ✅ PancakeProxy 批量购买结果（简化版） */
-export type FourPancakeProxyBatchBuyResult = MerkleSignedResult;
-/** ✅ PancakeProxy 批量卖出参数（Merkle 版本 - 完整） */
-export type FourPancakeProxyBatchSellParams = {
-    privateKeys: string[];
-    sellAmounts: string[];
-    tokenAddress: string;
-    routeType: 'v2' | 'v3-single' | 'v3-multi';
-    v2Path?: string[];
-    v3TokenOut?: string;
-    v3Fee?: number;
-    v3LpAddresses?: string[];
-    v3ExactTokenIn?: string;
-    /** V3 多跳：代币路径 [tokenIn, tokenMid1, ..., tokenOut] */
-    v3Tokens?: string[];
-    /** V3 多跳：费率路径 [fee0, fee1, ...] - 长度 = v3Tokens.length - 1 */
-    v3Fees?: number[];
-    minOutputAmounts?: (string | bigint)[];
-    config: FourBundleMerkleConfig;
-};
-/** ✅ PancakeProxy 批量卖出参数（仅签名版本 - 精简） */
-export type FourPancakeProxyBatchSellSignParams = {
-    privateKeys: string[];
-    sellAmounts: string[];
-    tokenAddress: string;
-    routeType: 'v2' | 'v3-single' | 'v3-multi';
-    v2Path?: string[];
-    v3TokenOut?: string;
-    v3Fee?: number;
-    v3LpAddresses?: string[];
-    v3ExactTokenIn?: string;
-    /** V3 多跳：代币路径 [tokenIn, tokenMid1, ..., tokenOut] */
-    v3Tokens?: string[];
-    /** V3 多跳：费率路径 [fee0, fee1, ...] - 长度 = v3Tokens.length - 1 */
-    v3Fees?: number[];
-    minOutputAmounts?: (string | bigint)[];
-    config: FourSignConfig;
-};
-/** ✅ PancakeProxy 批量卖出结果（简化版） */
-export type FourPancakeProxyBatchSellResult = MerkleSignedResult;
-export type FourPancakeProxyApprovalParams = {
-    privateKey: string;
-    tokenAddress: string;
-    amount: string | 'max';
-    rpcUrl: string;
-    /** 路由类型，用于确定授权目标（V2 或 V3 Router） */
-    routeType?: 'v2' | 'v3-single' | 'v3-multi';
-};
-export type FourPancakeProxyApprovalBatchParams = {
-    privateKeys: string[];
-    tokenAddress: string;
-    amounts: (string | 'max')[];
-    config: FourSignConfig;
-    /** 路由类型，用于确定授权目标（V2 或 V3 Router） */
-    routeType?: 'v2' | 'v3-single' | 'v3-multi';
-};
-/** ✅ PancakeProxy 批量授权结果 */
-export type FourPancakeProxyApprovalBatchResult = {
-    success: boolean;
-    approvedCount: number;
-    signedTransactions: string[];
-    txHashes?: string[];
-    bundleHash?: string;
-    message: string;
-};
+export type * from '../../../bundle-core/four-meme/types.js';

package/dist/chains/bsc/four/utils-disperse.d.ts

@@ -0,0 +1 @@
+export { disperseWithBundleMerkle } from '../../../bundle-core/four-meme/utils-disperse.js';

package/dist/chains/bsc/four/utils-disperse.js

@@ -0,0 +1 @@
+export { disperseWithBundleMerkle } from '../../../bundle-core/four-meme/utils-disperse.js';

package/dist/chains/bsc/four/utils-pairwise.d.ts

@@ -0,0 +1 @@
+export { pairwiseTransferWithBundleMerkle } from '../../../bundle-core/four-meme/utils-pairwise.js';

package/dist/chains/bsc/four/utils-pairwise.js

@@ -0,0 +1 @@
+export { pairwiseTransferWithBundleMerkle } from '../../../bundle-core/four-meme/utils-pairwise.js';

package/dist/chains/bsc/four/utils-sweep.d.ts

@@ -0,0 +1 @@
+export { sweepWithBundleMerkle } from '../../../bundle-core/four-meme/utils-sweep.js';

package/dist/chains/bsc/four/utils-sweep.js

@@ -0,0 +1 @@
+export { sweepWithBundleMerkle } from '../../../bundle-core/four-meme/utils-sweep.js';

package/dist/chains/bsc/four/utils.d.ts

@@ -1,20 +1,7 @@
-import { DisperseSignParams, DisperseMerkleResult, SweepSignParams, SweepMerkleResult, PairwiseTransferSignParams, PairwiseTransferMerkleResult } from './types.js';
 /**
- * 分发（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- * ✅ 优化版：支持 startNonce 参数避免并行调用时的 nonce 冲突
+ * Four.meme Merkle 转账类工具（分发 / 归集 / 多对多）。
+ * 实现已拆分为子模块以降低单文件体量（参见审计文档 P0）。
  */
-export declare function disperseWithBundleMerkle(params: DisperseSignParams): Promise<DisperseMerkleResult>;
-/**
- * 归集（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- * ✅ 优化版：支持 startNonce 参数避免并行调用时的 nonce 冲突
- */
-export declare function sweepWithBundleMerkle(params: SweepSignParams): Promise<SweepMerkleResult>;
-/**
- * 多对多（地址一一对应）转账（仅签名版本 - 不依赖 Merkle）
- * - 支持原生币 / ERC20
- * - 支持多跳（逐对）
- * - 支持利润刮取：利润由第一个 sender 支付（作为额外费用，不扣减每对转账金额）
- */
-export declare function pairwiseTransferWithBundleMerkle(params: PairwiseTransferSignParams): Promise<PairwiseTransferMerkleResult>;
+export { disperseWithBundleMerkle } from './utils-disperse.js';
+export { sweepWithBundleMerkle } from './utils-sweep.js';
+export { pairwiseTransferWithBundleMerkle } from './utils-pairwise.js';