four-flap-meme-sdk 2.2.2 → 2.2.4

package/dist/shared/flap/portal-bundle-merkle/types.d.ts

@@ -24,13 +24,21 @@ export type TaxDistributionConfig = {
     minimumShareBalance?: number;
 };
 /**
- * Tax Token V2 高级税收参数（用于 newTokenV5）
+ * Tax Token V2/V3 高级税收参数（用于 newTokenV6 TOKEN_TAXED_V3）
  */
 export type TaxV2Config = {
     /** 税收持续时间（秒，最大 100 年，0 = 永久） */
     taxDuration: number;
     /** 防打新持续时间（秒，最大 1 年） */
     antiFarmerDuration: number;
+    /** 买入税率（bps，100 = 1%） */
+    buyTaxRate?: number;
+    /** 卖出税率（bps，100 = 1%） */
+    sellTaxRate?: number;
+    /** 分红代币地址（零地址 = 原生/quote token） */
+    dividendToken?: string;
+    /** 佣金接收地址（零地址 = 无佣金） */
+    commissionReceiver?: string;
     /** 税收分配配置 */
     distribution: TaxDistributionConfig;
     /** ✅ Tax Vault 金库配置（可选） */
@@ -47,6 +55,11 @@ export type FlapSignConfig = {
     gasPrice?: bigint;
     bribeAmount?: number;
     profitMode?: FlapProfitMode;
+    /**
+     * 发币+捆绑买是否刮利润（默认 false）。
+     * 为 true 时跟买金额会缩水并可能追加利润多跳，易导致 BlockRazor 捆绑模拟失败。
+     */
+    extractProfitOnLaunch?: boolean;
 };
 export type FlapBundleMerkleConfig = {
     apiKey: string;
@@ -85,6 +98,10 @@ export type MerkleBundleStatus = {
     totalGasUsed: bigint;
     targetBlock: number;
 };
+/** Merkle 结果 metadata 字段值（各方法返回的键不固定，值类型统一收窄） */
+export type MerkleResultMetadataValue = string | number | boolean | string[] | undefined;
+/** Merkle 结果 metadata */
+export type MerkleResultMetadata = Record<string, MerkleResultMetadataValue>;
 /**
  * 统一的 Merkle 方法返回类型
  * SDK 不再内部提交，只返回签名交易和元数据
@@ -97,9 +114,7 @@ export type MerkleSignedResult = {
     /** ✅ 利润多跳钱包（用于导出私钥） */
     profitHopWallets?: GeneratedWallet[];
     /** 元数据（如利润信息等） */
-    metadata?: {
-        [key: string]: any;
-    };
+    metadata?: MerkleResultMetadata;
 };
 /** ✅ Flap 创建代币 + 购买参数（Merkle 版本 - 完整） */
 export type FlapCreateWithBundleBuyMerkleParams = {
@@ -141,10 +156,6 @@ export type FlapCreateWithBundleBuySignParams = {
     dexThresh?: number;
     migratorType?: number;
     taxRate?: number;
-    /** V6 金库发射：买入税率（基点），不传则使用 taxRate */
-    buyTaxRate?: number;
-    /** V6 金库发射：卖出税率（基点），不传则使用 taxRate */
-    sellTaxRate?: number;
     salt?: string;
     extensionID?: string;
     extensionData?: string;
@@ -152,7 +163,7 @@ export type FlapCreateWithBundleBuySignParams = {
     dexId?: number;
     /** LP 费率档位：0=STANDARD(0.25%), 1=LOW(0.01%), 2=HIGH(1%) */
     lpFeeProfile?: number;
-    /** Tax Token V2 高级税收配置 */
+    /** Tax Token V2/V3 高级税收配置 */
     taxV2Config?: TaxV2Config;
 };
 /**
@@ -360,3 +371,71 @@ export type PancakeProxyApprovalBatchResult = {
     bundleHash?: string;
     message: string;
 };
+export type FlapDisperseSignParams = {
+    chain: 'BSC' | 'MONAD' | 'XLAYER';
+    fromPrivateKey: string;
+    recipients: string[];
+    amount?: string;
+    amounts?: string[];
+    tokenAddress?: string;
+    tokenDecimals?: number;
+    hopCount?: number | number[];
+    hopPrivateKeys?: string[][];
+    items?: {
+        recipient: string;
+        amount: string | bigint;
+        hopCount?: number;
+        hopPrivateKeys?: string[];
+    }[];
+    config: FlapSignConfig;
+    startNonce?: number;
+};
+export type FlapDisperseMerkleResult = {
+    signedTransactions: string[];
+    hopWallets?: (string | GeneratedWallet)[][];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        totalAmount: string;
+        profitAmount: string;
+        profitRecipient: string;
+        recipientCount: number;
+        isNative: boolean;
+        tokenAddress?: string;
+    };
+};
+export type FlapSweepSignParams = {
+    chain: 'BSC' | 'MONAD' | 'XLAYER';
+    sourcePrivateKeys: string[];
+    target: string;
+    ratioPct?: number;
+    ratios?: number[];
+    amount?: string;
+    amounts?: string[];
+    tokenAddress?: string;
+    tokenDecimals?: number;
+    skipIfInsufficient?: boolean;
+    hopCount?: number | number[];
+    hopPrivateKeys?: string[][];
+    sources?: {
+        privateKey: string;
+        ratioPct?: number;
+        amount?: string;
+        hopCount?: number;
+        hopPrivateKeys?: string[];
+    }[];
+    config: FlapSignConfig;
+    startNonce?: number;
+};
+export type FlapSweepMerkleResult = {
+    signedTransactions: string[];
+    hopWallets?: (string | GeneratedWallet)[][];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        totalAmount: string;
+        profitAmount: string;
+        profitRecipient: string;
+        sourceCount: number;
+        isNative: boolean;
+        tokenAddress?: string;
+    };
+};

package/dist/shared/flap/portal-bundle-merkle/utils.d.ts

@@ -1,83 +1,4 @@
-import type { FlapSignConfig } from './types.js';
-import type { GeneratedWallet } from '../../../utils/wallet.js';
-/** 分散参数 */
-export type FlapDisperseSignParams = {
-    chain: 'BSC' | 'MONAD' | 'XLAYER';
-    fromPrivateKey: string;
-    recipients: string[];
-    amount?: string;
-    amounts?: string[];
-    tokenAddress?: string;
-    tokenDecimals?: number;
-    hopCount?: number | number[];
-    hopPrivateKeys?: string[][];
-    items?: {
-        recipient: string;
-        amount: string | bigint;
-        hopCount?: number;
-        hopPrivateKeys?: string[];
-    }[];
-    config: FlapSignConfig;
-    startNonce?: number;
-};
-/** 分散结果 */
-export type FlapDisperseMerkleResult = {
-    signedTransactions: string[];
-    hopWallets?: (string | GeneratedWallet)[][];
-    profitHopWallets?: GeneratedWallet[];
-    metadata?: {
-        totalAmount: string;
-        profitAmount: string;
-        profitRecipient: string;
-        recipientCount: number;
-        isNative: boolean;
-        tokenAddress?: string;
-    };
-};
-/** 归集参数 */
-export type FlapSweepSignParams = {
-    chain: 'BSC' | 'MONAD' | 'XLAYER';
-    sourcePrivateKeys: string[];
-    target: string;
-    ratioPct?: number;
-    ratios?: number[];
-    amount?: string;
-    amounts?: string[];
-    tokenAddress?: string;
-    tokenDecimals?: number;
-    skipIfInsufficient?: boolean;
-    hopCount?: number | number[];
-    hopPrivateKeys?: string[][];
-    sources?: {
-        privateKey: string;
-        ratioPct?: number;
-        amount?: string;
-        hopCount?: number;
-        hopPrivateKeys?: string[];
-    }[];
-    config: FlapSignConfig;
-    startNonce?: number;
-};
-/** 归集结果 */
-export type FlapSweepMerkleResult = {
-    signedTransactions: string[];
-    hopWallets?: (string | GeneratedWallet)[][];
-    profitHopWallets?: GeneratedWallet[];
-    metadata?: {
-        totalAmount: string;
-        profitAmount: string;
-        profitRecipient: string;
-        sourceCount: number;
-        isNative: boolean;
-        tokenAddress?: string;
-    };
-};
-/**
- * Flap Protocol: 分散（仅签名版本）
- * ✅ 支持利润提取（按地址数量收取固定费用）
- * ✅ 支持多跳
- * ✅ 支持 Multicall3 批量获取余额
- */
+import type { FlapDisperseMerkleResult, FlapDisperseSignParams, FlapSweepMerkleResult, FlapSweepSignParams } from './types.js';
 export declare function flapDisperseWithBundleMerkle(params: FlapDisperseSignParams): Promise<FlapDisperseMerkleResult>;
 /**
  * Flap Protocol: 归集（仅签名版本）