four-flap-meme-sdk 1.9.49 → 2.1.0

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

@@ -85,6 +85,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 +101,7 @@ export type MerkleSignedResult = {
     /** ✅ 利润多跳钱包（用于导出私钥） */
     profitHopWallets?: GeneratedWallet[];
     /** 元数据（如利润信息等） */
-    metadata?: {
-        [key: string]: any;
-    };
+    metadata?: MerkleResultMetadata;
 };
 /** ✅ Flap 创建代币 + 购买参数（Merkle 版本 - 完整） */
 export type FlapCreateWithBundleBuyMerkleParams = {
@@ -356,3 +358,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: 归集（仅签名版本）