four-flap-meme-sdk 2.2.0 → 2.2.2

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

@@ -1 +1,476 @@
-export type * from '../../../bundle-core/four-meme/types.js';
+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;
+};

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

@@ -1,7 +1,20 @@
+import { DisperseSignParams, DisperseMerkleResult, SweepSignParams, SweepMerkleResult, PairwiseTransferSignParams, PairwiseTransferMerkleResult } from './types.js';
 /**
- * Four.meme Merkle 转账类工具（分发 / 归集 / 多对多）。
- * 实现已拆分为子模块以降低单文件体量（参见审计文档 P0）。
+ * 分发（仅签名版本 - 不依赖 Merkle）
+ * ✅ 精简版：只负责签名交易，不提交到 Merkle
+ * ✅ 优化版：支持 startNonce 参数避免并行调用时的 nonce 冲突
  */
-export { disperseWithBundleMerkle } from './utils-disperse.js';
-export { sweepWithBundleMerkle } from './utils-sweep.js';
-export { pairwiseTransferWithBundleMerkle } from './utils-pairwise.js';
+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>;