four-flap-meme-sdk 2.2.19 → 3.0.0

package/dist/{contracts/tm-bundle-merkle/swap-buy-first.d.ts → bundle/four-meme/types/buy-first.d.ts}

@@ -1,24 +1,19 @@
-/**
- * Four.meme 内盘捆绑换手（Merkle Bundle）- 先买后卖
- *
- * 功能：钱包B先买入代币 → 钱包A卖出相同数量 → 原子执行
- */
-import { CommonBundleConfig } from '../../utils/bundle-helpers.js';
-import { FourSignConfig, UserType } from './types.js';
-import type { GeneratedWallet } from '../../utils/wallet.js';
-export interface FourBuyFirstSignConfig extends FourSignConfig {
+import type { CommonBundleConfig } from '../../../utils/bundle-helpers.js';
+import type { GeneratedWallet } from '../../../utils/wallet.js';
+import type { FourSignConfig, UserType } from './index.js';
+export type FourBuyFirstSignConfig = FourSignConfig & {
     reserveGasBNB?: number;
     userType?: UserType;
-}
-export interface FourBuyFirstConfig extends CommonBundleConfig {
+};
+export type FourBuyFirstConfig = CommonBundleConfig & {
     apiKey: string;
     customRpcUrl?: string;
     bundleBlockOffset?: number;
     reserveGasBNB?: number;
     waitForConfirmation?: boolean;
     waitTimeoutMs?: number;
-}
-export interface FourBundleBuyFirstSignParams {
+};
+export type FourBundleBuyFirstSignParams = {
     buyerPrivateKey?: string;
     buyerPrivateKeys?: string[];
     buyerFunds?: string;
@@ -29,16 +24,15 @@ export interface FourBundleBuyFirstSignParams {
     config: FourBuyFirstSignConfig;
     buyCount?: number;
     sellCount?: number;
-}
-export interface FourBundleBuyFirstParams {
+};
+export type FourBundleBuyFirstParams = {
     buyerPrivateKey: string;
     buyerFunds?: string;
     buyerFundsPercentage?: number;
     sellerPrivateKey: string;
     tokenAddress: string;
     config: FourBuyFirstConfig;
-}
-/** ✅ BuyFirst 结果（简化版） */
+};
 export type FourBuyFirstResult = {
     signedTransactions: string[];
     profitHopWallets?: GeneratedWallet[];
@@ -54,4 +48,3 @@ export type FourBuyFirstResult = {
         sellAmounts?: string[];
     };
 };
-export declare function fourBundleBuyFirstMerkle(params: FourBundleBuyFirstSignParams): Promise<FourBuyFirstResult>;

package/dist/bundle/four-meme/types/core-flow.d.ts

@@ -0,0 +1,63 @@
+import type { Wallet, JsonRpcProvider } from 'ethers';
+import type { NonceManager } from '../../../utils/bundle-helpers.js';
+import type { GeneratedWallet } from '../../../utils/wallet.js';
+import type { FourBundleMerkleConfig, FourCreateWithBundleBuySignParams, FourSignConfig, MerkleResultMetadata } from './index.js';
+export type FourAnyConfig = FourBundleMerkleConfig | FourSignConfig;
+export type ProfitMode = {
+    type: 'individual';
+} | {
+    type: 'aggregated';
+    payer?: Wallet;
+};
+export type BuyMetadata = MerkleResultMetadata | undefined;
+export interface ChainContext {
+    provider: JsonRpcProvider;
+    chainId: number;
+}
+export interface BuyFundsAnalysis {
+    fundsList: bigint[];
+    profitList: bigint[];
+    totalProfit: bigint;
+    totalBuyAmount: bigint;
+}
+export interface SellOutputs {
+    minOuts: bigint[];
+    quotedOutputs: bigint[];
+}
+export interface BuyFlowResult {
+    signedTxs: string[];
+    metadata: BuyMetadata;
+    profitHopWallets?: GeneratedWallet[];
+}
+export interface SellFlowResult {
+    signedTxs: string[];
+    profitHopWallets?: GeneratedWallet[];
+}
+export interface BuyFlowOptions {
+    wallets: Wallet[];
+    buyAmounts: string[];
+    tokenAddress: string;
+    config: FourAnyConfig;
+    provider: JsonRpcProvider;
+    nonceManager: NonceManager;
+    contractAddress: string;
+    gasPrice: bigint;
+    chainId: number;
+    profitMode: ProfitMode;
+    txType: number;
+}
+export interface SellFlowOptions {
+    wallets: Wallet[];
+    sellAmounts: string[];
+    tokenAddress: string;
+    minOutputAmounts?: (string | bigint)[];
+    config: FourAnyConfig;
+    provider: JsonRpcProvider;
+    nonceManager: NonceManager;
+    contractAddress: string;
+    gasPrice: bigint;
+    chainId: number;
+    rpcUrl: string;
+    txType: number;
+}
+export type FourCreateTokenInfo = FourCreateWithBundleBuySignParams['tokenInfo'];

package/dist/bundle/four-meme/types/core-flow.js

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

package/dist/{contracts/tm-bundle-merkle/types.d.ts → bundle/four-meme/types/index.d.ts}

@@ -1,5 +1,8 @@
-import type { GeneratedWallet } from '../../utils/wallet.js';
-import type { FourTokenTaxInfo } from '../../shared/clients/four.js';
+import type { GeneratedWallet } from '../../../utils/wallet.js';
+import type { FourTokenTaxInfo } from '../../../core/clients/four.js';
+import type { AmountLike } from '../../types.js';
+import type { CommonBundleConfig } from '../../../utils/bundle-helpers.js';
+export type { AmountLike };
 export type FourSignConfig = {
     rpcUrl: string;
     fourApiUrl?: string;
@@ -39,8 +42,9 @@ export type FourBundleMerkleConfig = {
     prefer21000ForNative?: boolean;
     checkBnbForErc20NoHop?: boolean;
     skipSubmit?: boolean;
+    /** BlockRazor 贿赂金额（BNB），与 `FourSignConfig` 对齐 */
+    bribeAmount?: number;
 };
-export type AmountLike = string | number | bigint;
 export type MerkleTransactionStatus = {
     index: number;
     hash: string;
@@ -59,6 +63,10 @@ export type MerkleBundleStatus = {
     totalGasUsed: bigint;
     targetBlock: number;
 };
+/** Merkle 结果 metadata 字段值（各方法返回的键不固定，值类型统一收窄） */
+export type MerkleResultMetadataValue = string | number | boolean | string[] | undefined;
+/** 元数据（如利润信息等） */
+export type MerkleResultMetadata = Record<string, MerkleResultMetadataValue>;
 /**
  * 统一的 Merkle 方法返回类型
  * SDK 不再内部提交，只返回签名交易和元数据
@@ -73,9 +81,7 @@ export type MerkleSignedResult = {
     /** ✅ 利润多跳中间钱包 */
     profitHopWallets?: GeneratedWallet[];
     /** 元数据（如利润信息等） */
-    metadata?: {
-        [key: string]: any;
-    };
+    metadata?: MerkleResultMetadata;
     /** 交易哈希数组（内部提交时返回） */
     txHashes?: string[];
 };
@@ -474,3 +480,121 @@ export type FourPancakeProxyApprovalBatchResult = {
     bundleHash?: string;
     message: string;
 };
+/** 批量授权 TokenManager 参数（直接 RPC 提交） */
+export type ApproveFourTokenManagerBatchParams = {
+    privateKeys: string[];
+    tokenAddress: string;
+    amounts: string[];
+    config: FourSignConfig;
+};
+/** 批量授权 TokenManager 结果 */
+export type ApproveFourTokenManagerBatchResult = {
+    success: boolean;
+    signedTransactions: string[];
+    approvedCount: number;
+    skippedCount: number;
+    txHashes?: string[];
+    message: string;
+};
+/** Swap 签名配置（不含 Merkle 字段） */
+export type FourSwapSignConfig = {
+    rpcUrl: string;
+    gasLimit?: number | bigint;
+    gasLimitMultiplier?: number;
+    minGasPriceGwei?: number;
+    maxGasPriceGwei?: number;
+    txType?: 0 | 2;
+    chainId?: number;
+    reserveGasBNB?: number;
+    userType?: UserType;
+    bribeAmount?: number;
+};
+/** Swap Merkle 配置（保留兼容） */
+export type FourSwapConfig = CommonBundleConfig & {
+    apiKey: string;
+    customRpcUrl?: string;
+    bundleBlockOffset?: number;
+    reserveGasBNB?: number;
+    waitForConfirmation?: boolean;
+    waitTimeoutMs?: number;
+    skipApprovalCheck?: boolean;
+};
+export type FourBundleSwapSignParams = {
+    sellerPrivateKey: string;
+    sellAmount?: string;
+    sellPercentage?: number;
+    buyerPrivateKey: string;
+    tokenAddress: string;
+    config: FourSwapSignConfig;
+    startNonces?: number[];
+};
+export type FourBundleSwapParams = {
+    sellerPrivateKey: string;
+    sellAmount?: string;
+    sellPercentage?: number;
+    buyerPrivateKey: string;
+    tokenAddress: string;
+    config: FourSwapConfig;
+};
+export type FourSwapResult = {
+    signedTransactions: string[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        sellerAddress: string;
+        buyerAddress: string;
+        sellAmount: string;
+        buyAmount: string;
+        hasApproval?: boolean;
+        profitAmount?: string;
+    };
+};
+export type FourBatchSwapSignParams = {
+    sellerPrivateKey: string;
+    sellAmount?: string;
+    sellPercentage?: number;
+    buyerPrivateKeys: string[];
+    buyerRatios?: number[];
+    tokenAddress: string;
+    config: FourSwapSignConfig;
+    startNonces?: number[];
+};
+export type FourBatchSwapResult = {
+    signedTransactions: string[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        sellerAddress: string;
+        buyerAddresses: string[];
+        sellAmount: string;
+        buyAmounts: string[];
+        hasApproval?: boolean;
+        profitAmount?: string;
+    };
+};
+export type FourQuickBatchSwapSignParams = {
+    sellerPrivateKey: string;
+    sellAmount?: string;
+    sellPercentage?: number;
+    buyerPrivateKeys: string[];
+    buyerRatios?: number[];
+    buyerAmounts?: string[];
+    tokenAddress: string;
+    config: FourSwapSignConfig;
+    disperseHopCount?: number;
+    startNonces?: number[];
+};
+export type FourQuickBatchSwapResult = {
+    signedTransactions: string[];
+    disperseHopWallets?: GeneratedWallet[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        sellerAddress: string;
+        buyerAddresses: string[];
+        sellAmount: string;
+        estimatedBNBOut: string;
+        transferAmounts: string[];
+        profitAmount?: string;
+        disperseHopCount?: number;
+    };
+};
+export type * from './swap-internal.js';
+export type * from './buy-first.js';

package/dist/bundle/four-meme/types/index.js

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

package/dist/bundle/four-meme/types/swap-internal.d.ts

@@ -0,0 +1,19 @@
+import type { Wallet } from 'ethers';
+import type { GeneratedWallet } from '../../../utils/wallet.js';
+export type SellerNoncePlan = {
+    bribeNonce?: number;
+    approvalNonce?: number;
+    sellerNonce: number;
+    profitNonce?: number;
+};
+export type DisperseHopPath = {
+    targetAddress: string;
+    hopWallets: Wallet[];
+    hopWalletsInfo: GeneratedWallet[];
+};
+export type MultiNoncePlan = {
+    buyerNonces: number[];
+    sellerNonces: number[];
+    bribeNonce?: number;
+    profitNonce?: number;
+};

package/dist/bundle/four-meme/types/swap-internal.js

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

package/dist/bundle/four-meme/types.d.ts

@@ -0,0 +1 @@
+export type * from './types/index.js';

package/dist/bundle/four-meme/utils-disperse.d.ts

@@ -0,0 +1,7 @@
+import type { DisperseSignParams, DisperseMerkleResult } from './types.js';
+/**
+ * 分发（仅签名版本 - 不依赖 Merkle）
+ * ✅ 精简版：只负责签名交易，不提交到 Merkle
+ * ✅ 优化版：支持 startNonce 参数避免并行调用时的 nonce 冲突
+ */
+export declare function disperseWithBundleMerkle(params: DisperseSignParams): Promise<DisperseMerkleResult>;