four-flap-meme-sdk 2.0.0 → 2.1.0

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

@@ -1,358 +0,0 @@
-import type { GeneratedWallet } from '../../../utils/wallet.js';
-import type { TaxVaultConfig } from '../vault.js';
-/**
- * ✅ 利润模式：
- * - 'single': 单一模式（默认），从金额最大的钱包统一扣除所有利润，只有一组多跳交易
- * - 'distributed': 分布式模式，每个钱包独立扣除自己的利润，每个都有独立的多跳交易
- *   - 分布式模式最多支持 12 个钱包（12 交易 + 36 多跳 + 1 贿赂 = 49 笔）
- */
-export type FlapProfitMode = 'single' | 'distributed';
-/**
- * Tax Token V2 税收分配配置
- * 注意：mktBps + deflationBps + dividendBps + lpBps 必须等于 10000 (100%)
- */
-export type TaxDistributionConfig = {
-    /** 营销分配（基点，0-10000，发送到 beneficiary 地址） */
-    mktBps: number;
-    /** 通缩销毁（基点，0-10000，直接销毁） */
-    deflationBps: number;
-    /** 持有者分红（基点，0-10000，发送到分红合约） */
-    dividendBps: number;
-    /** 流动性提供（基点，0-10000，LP 发送到 dead address） */
-    lpBps: number;
-    /** 分红最低持仓门槛（代币数量，dividendBps > 0 时必填，最小 10000） */
-    minimumShareBalance?: number;
-};
-/**
- * Tax Token V2 高级税收参数（用于 newTokenV5）
- */
-export type TaxV2Config = {
-    /** 税收持续时间（秒，最大 100 年，0 = 永久） */
-    taxDuration: number;
-    /** 防打新持续时间（秒，最大 1 年） */
-    antiFarmerDuration: number;
-    /** 税收分配配置 */
-    distribution: TaxDistributionConfig;
-    /** ✅ Tax Vault 金库配置（可选） */
-    vaultConfig?: TaxVaultConfig;
-};
-export type FlapSignConfig = {
-    rpcUrl: string;
-    txType?: 0 | 2;
-    gasLimit?: number | bigint;
-    gasLimitMultiplier?: number;
-    gasPriceMultiplierPercent?: number;
-    minGasPriceGwei?: number;
-    nonces?: number[];
-    gasPrice?: bigint;
-    bribeAmount?: number;
-    profitMode?: FlapProfitMode;
-};
-export type FlapBundleMerkleConfig = {
-    apiKey: string;
-    customRpcUrl?: 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;
-    slippageBps?: number;
-    skipQuoteOnError?: boolean;
-    skipSubmit?: boolean;
-};
-export type FlapChainForMerkleBundle = 'BSC' | 'MONAD' | 'XLAYER' | 'BASE';
-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;
-    /** ✅ 利润多跳钱包（用于导出私钥） */
-    profitHopWallets?: GeneratedWallet[];
-    /** 元数据（如利润信息等） */
-    metadata?: {
-        [key: string]: any;
-    };
-};
-/** ✅ Flap 创建代币 + 购买参数（Merkle 版本 - 完整） */
-export type FlapCreateWithBundleBuyMerkleParams = {
-    chain: FlapChainForMerkleBundle;
-    privateKeys: string[];
-    buyAmounts: string[];
-    tokenInfo: {
-        name: string;
-        symbol: string;
-        meta: string;
-    };
-    quoteToken?: string;
-    tokenAddress: string;
-    minOutputAmounts?: (string | bigint)[];
-    config: FlapBundleMerkleConfig;
-    dexThresh?: number;
-    migratorType?: number;
-    taxRate?: number;
-    salt?: string;
-    extensionID?: string;
-    extensionData?: string;
-};
-/** ✅ Flap 创建代币 + 购买参数（仅签名版本 - 精简） */
-export type FlapCreateWithBundleBuySignParams = {
-    chain: FlapChainForMerkleBundle;
-    privateKeys: string[];
-    buyAmounts: string[];
-    tokenInfo: {
-        name: string;
-        symbol: string;
-        meta: string;
-    };
-    quoteToken?: string;
-    /** ✅ 报价代币精度（如 USDC 为 6），不传默认 18 */
-    quoteTokenDecimals?: number;
-    tokenAddress: string;
-    minOutputAmounts?: (string | bigint)[];
-    config: FlapSignConfig;
-    dexThresh?: number;
-    migratorType?: number;
-    taxRate?: number;
-    salt?: string;
-    extensionID?: string;
-    extensionData?: string;
-    /** DEX ID：0=DEX0, 1=DEX1, 2=DEX2（BSC: DEX0=PancakeSwap, Monad: DEX0=Uniswap, DEX1=PancakeSwap） */
-    dexId?: number;
-    /** LP 费率档位：0=STANDARD(0.25%), 1=LOW(0.01%), 2=HIGH(1%) */
-    lpFeeProfile?: number;
-    /** Tax Token V2 高级税收配置 */
-    taxV2Config?: TaxV2Config;
-};
-/**
- * ✅ Flap 创建代币 + 购买结果（简化版）
- * 包含 tokenAddress 用于返回创建的代币地址
- */
-export type FlapCreateWithBundleBuyMerkleResult = MerkleSignedResult;
-/** ✅ Flap 批量购买参数（Merkle 版本 - 完整） */
-export type FlapBatchBuyMerkleParams = {
-    chain: FlapChainForMerkleBundle;
-    privateKeys: string[];
-    buyAmounts: string[];
-    tokenAddress: string;
-    minOutputAmounts?: (string | bigint)[];
-    config: FlapBundleMerkleConfig;
-};
-/** ✅ Flap 批量购买参数（仅签名版本 - 精简） */
-export type FlapBatchBuySignParams = {
-    chain: FlapChainForMerkleBundle;
-    privateKeys: string[];
-    buyAmounts: string[];
-    tokenAddress: string;
-    /** 报价代币地址（如 USDC），零地址或不传表示使用原生代币（MON/BNB） */
-    quoteToken?: string;
-    /** ✅ 报价代币精度（如 USDC 为 6），不传默认 18 */
-    quoteTokenDecimals?: number;
-    minOutputAmounts?: (string | bigint)[];
-    config: FlapSignConfig;
-};
-/** ✅ Flap 批量购买结果（简化版） */
-export type FlapBatchBuyMerkleResult = MerkleSignedResult;
-/** ✅ Flap 批量卖出参数（Merkle 版本 - 完整） */
-export type FlapBatchSellMerkleParams = {
-    chain: FlapChainForMerkleBundle;
-    privateKeys: string[];
-    sellAmounts: string[];
-    tokenAddress: string;
-    minOutputAmounts?: (string | bigint)[];
-    config: FlapBundleMerkleConfig;
-};
-/** ✅ Flap 批量卖出参数（仅签名版本 - 精简） */
-export type FlapBatchSellSignParams = {
-    chain: FlapChainForMerkleBundle;
-    privateKeys: string[];
-    sellAmounts: string[];
-    tokenAddress: string;
-    /** 报价代币地址（如 USDC），零地址或不传表示输出原生代币（MON/BNB） */
-    quoteToken?: string;
-    minOutputAmounts?: (string | bigint)[];
-    config: FlapSignConfig;
-};
-/** ✅ Flap 批量卖出结果（简化版） */
-export type FlapBatchSellMerkleResult = MerkleSignedResult;
-export type FlapPrivateMerkleBase = {
-    chain: FlapChainForMerkleBundle;
-    config: FlapBundleMerkleConfig;
-};
-export type FlapPrivateBuyMerkleParams = FlapPrivateMerkleBase & {
-    privateKey: string;
-    tokenAddress: string;
-    amountIn: string;
-    minOutputAmount?: string | bigint;
-    to?: string;
-};
-export type FlapPrivateSellMerkleParams = FlapPrivateMerkleBase & {
-    privateKey: string;
-    tokenAddress: string;
-    amount: string;
-    minOutputAmount?: string | bigint;
-};
-/** ✅ Flap 私有交易结果（简化版） */
-export type FlapPrivateTransactionResult = MerkleSignedResult;
-export type FlapBatchPrivateBuyMerkleParams = FlapPrivateMerkleBase & {
-    privateKeys: string[];
-    amountsIn: string[];
-    tokenAddress: string;
-    minOutputAmounts?: (string | bigint)[];
-};
-export type FlapBatchPrivateSellMerkleParams = FlapPrivateMerkleBase & {
-    privateKeys: string[];
-    amounts: string[];
-    tokenAddress: string;
-    minOutputAmounts?: (string | bigint)[];
-};
-/** ✅ Flap 批量私有交易结果（简化版） */
-export type FlapBatchPrivateMerkleResult = MerkleSignedResult;
-/**
- * 使用 PancakeSwapProxy 批量购买参数
- */
-/** ✅ PancakeProxy 批量购买参数（Merkle 版本 - 完整） */
-export type PancakeProxyBatchBuyParams = {
-    chain: FlapChainForMerkleBundle;
-    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: FlapBundleMerkleConfig;
-};
-/** ✅ PancakeProxy 批量购买参数（仅签名版本 - 精简） */
-export type PancakeProxyBatchBuySignParams = {
-    chain: FlapChainForMerkleBundle;
-    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: FlapSignConfig;
-    quoteToken?: string;
-    quoteTokenDecimals?: number;
-};
-/** ✅ PancakeProxy 批量购买结果（简化版） */
-export type PancakeProxyBatchBuyResult = MerkleSignedResult;
-/**
- * 使用 PancakeSwapProxy 批量卖出参数
- */
-/** ✅ PancakeProxy 批量卖出参数（Merkle 版本 - 完整） */
-export type PancakeProxyBatchSellParams = {
-    chain: FlapChainForMerkleBundle;
-    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: FlapBundleMerkleConfig;
-};
-/** ✅ PancakeProxy 批量卖出参数（仅签名版本 - 精简） */
-export type PancakeProxyBatchSellSignParams = {
-    chain: FlapChainForMerkleBundle;
-    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: FlapSignConfig;
-};
-/** ✅ PancakeProxy 批量卖出结果（简化版） */
-export type PancakeProxyBatchSellResult = MerkleSignedResult;
-/**
- * PancakeSwap Router 单个授权参数（官方合约）
- */
-export type PancakeProxyApprovalParams = {
-    chain: 'BSC';
-    privateKey: string;
-    tokenAddress: string;
-    amount: string | 'max';
-    rpcUrl: string;
-    /** 路由类型，用于确定授权目标（V2 或 V3 Router） */
-    routeType?: 'v2' | 'v3-single' | 'v3-multi';
-};
-/**
- * PancakeSwap Router 批量授权参数（官方合约）
- */
-export type PancakeProxyApprovalBatchParams = {
-    chain: FlapChainForMerkleBundle;
-    privateKeys: string[];
-    tokenAddress: string;
-    amounts: (string | 'max')[];
-    config: FlapSignConfig;
-    /** 路由类型，用于确定授权目标（V2 或 V3 Router） */
-    routeType?: 'v2' | 'v3-single' | 'v3-multi';
-};
-/** ✅ PancakeProxy 批量授权结果 */
-export type PancakeProxyApprovalBatchResult = {
-    success: boolean;
-    approvedCount: number;
-    signedTransactions: string[];
-    txHashes?: string[];
-    bundleHash?: string;
-    message: string;
-};

package/dist/shared/flap 2/portal-bundle-merkle/types.js

@@ -1 +0,0 @@
-export {};

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

@@ -1,89 +0,0 @@
-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 批量获取余额
- */
-export declare function flapDisperseWithBundleMerkle(params: FlapDisperseSignParams): Promise<FlapDisperseMerkleResult>;
-/**
- * Flap Protocol: 归集（仅签名版本）
- * ✅ 支持利润提取（按地址数量收取固定费用）
- * ✅ 查询余额最大的钱包支付利润
- * ✅ 支持多跳
- * ✅ 支持 Multicall3 批量获取余额
- */
-export declare function flapSweepWithBundleMerkle(params: FlapSweepSignParams): Promise<FlapSweepMerkleResult>;