four-flap-meme-sdk 2.2.19 → 3.0.0

package/dist/chains/bsc/iro.d.ts

@@ -0,0 +1,5 @@
+/**
+ * BSC IRO 平台子路径（与包根 `bscIro*` 扁平别名一致）
+ */
+export { IroFactoryQuery as BscIroFactoryQuery, createProject as bscIroCreateProject, encodeCreateProjectCall as bscIroEncodeCreateProjectCall, parseCreateProjectEvent as bscIroParseCreateProjectEvent, IroTokenQuery as BscIroTokenQuery, subscribe as bscIroSubscribe, pledge as bscIroPledge, batchSubscribe as bscIroBatchSubscribe, batchSubscribeForSubmit as bscIroBatchSubscribeForSubmit, IroPoolQuery as BscIroPoolQuery, poolRemovePledge as bscIroPoolRemovePledge, poolExtract as bscIroPoolExtract, poolTransferAwards as bscIroPoolTransferAwards, batchExtract as bscIroBatchExtract, IRO_FACTORY_ADDRESS as BSC_IRO_FACTORY_ADDRESS, IRO_FACTORY_ABI as BSC_IRO_FACTORY_ABI, IRO_TOKEN_ABI as BSC_IRO_TOKEN_ABI, IRO_POOL_ABI as BSC_IRO_POOL_ABI, IRO_PLATFORM_URL as BSC_IRO_PLATFORM_URL, IRO_TESTNET_PLATFORM_URL as BSC_IRO_TESTNET_PLATFORM_URL, setIroApiBase as setBscIroApiBase, setIroTestApiBase as setBscIroTestApiBase, iroApiCreateProject as bscIroApiCreateProject, iroApiUploadImage as bscIroApiUploadImage, } from './platforms/iro/index.js';
+export type { WhiteListQuota as BscIroWhiteListQuota, IroCreateProjectParams as BscIroCreateProjectParams, IroFactoryTokenInfo as BscIroFactoryTokenInfo, IroSubscribeParams as BscIroSubscribeParams, IroPledgeParams as BscIroPledgeParams, IroTokenPrice as BscIroTokenPrice, IroPoolRemovePledgeParams as BscIroPoolRemovePledgeParams, IroPoolExtractParams as BscIroPoolExtractParams, IroPoolTransferAwardsParams as BscIroPoolTransferAwardsParams, IroTokenInfo as BscIroTokenInfo, IroTxResult as BscIroTxResult, IroCreateProjectResult as BscIroCreateProjectResult, IroQueryConfig as BscIroQueryConfig, IroCreateParams as BscIroCreateParams, IroApiCreateProjectRequest as BscIroApiCreateProjectRequest, IroBatchSubscribeForSubmitParams as BscIroBatchSubscribeForSubmitParams, IroBatchSubscribeForSubmitResult as BscIroBatchSubscribeForSubmitResult, } from './platforms/iro/index.js';

package/dist/chains/bsc/iro.js

@@ -0,0 +1,4 @@
+/**
+ * BSC IRO 平台子路径（与包根 `bscIro*` 扁平别名一致）
+ */
+export { IroFactoryQuery as BscIroFactoryQuery, createProject as bscIroCreateProject, encodeCreateProjectCall as bscIroEncodeCreateProjectCall, parseCreateProjectEvent as bscIroParseCreateProjectEvent, IroTokenQuery as BscIroTokenQuery, subscribe as bscIroSubscribe, pledge as bscIroPledge, batchSubscribe as bscIroBatchSubscribe, batchSubscribeForSubmit as bscIroBatchSubscribeForSubmit, IroPoolQuery as BscIroPoolQuery, poolRemovePledge as bscIroPoolRemovePledge, poolExtract as bscIroPoolExtract, poolTransferAwards as bscIroPoolTransferAwards, batchExtract as bscIroBatchExtract, IRO_FACTORY_ADDRESS as BSC_IRO_FACTORY_ADDRESS, IRO_FACTORY_ABI as BSC_IRO_FACTORY_ABI, IRO_TOKEN_ABI as BSC_IRO_TOKEN_ABI, IRO_POOL_ABI as BSC_IRO_POOL_ABI, IRO_PLATFORM_URL as BSC_IRO_PLATFORM_URL, IRO_TESTNET_PLATFORM_URL as BSC_IRO_TESTNET_PLATFORM_URL, setIroApiBase as setBscIroApiBase, setIroTestApiBase as setBscIroTestApiBase, iroApiCreateProject as bscIroApiCreateProject, iroApiUploadImage as bscIroApiUploadImage, } from './platforms/iro/index.js';

package/dist/chains/bsc/pancake/bundle-buy-first-helpers.d.ts

@@ -0,0 +1,155 @@
+/**
+ * PancakeSwap V2/V3 通用捆绑换手（Merkle Bundle）- 先买后卖
+ *
+ * 功能：钱包B先买入代币 → 钱包A卖出相同数量 → 原子执行
+ */
+import { ethers } from 'ethers';
+import type { GeneratedWallet } from '../../../utils/wallet.js';
+import { CommonBundleConfig } from '../../../utils/bundle-helpers.js';
+export interface PancakeBuyFirstSignConfig {
+    rpcUrl: string;
+    gasLimit?: number | bigint;
+    gasLimitMultiplier?: number;
+    minGasPriceGwei?: number;
+    maxGasPriceGwei?: number;
+    txType?: 0 | 2;
+    chainId?: number;
+    reserveGasBNB?: number;
+    skipQuoteOnError?: boolean;
+    userType?: UserType;
+    bribeAmount?: number;
+    v2RouterAddress?: string;
+}
+/**
+ * 获取 Gas Limit
+ */
+export declare function getGasLimit(config: PancakeBuyFirstSignConfig | PancakeBuyFirstConfig, defaultGas?: number): bigint;
+export declare function getGasPrice(provider: ethers.JsonRpcProvider, config: PancakeBuyFirstSignConfig | PancakeBuyFirstConfig): Promise<bigint>;
+export declare const PANCAKE_V2_ROUTER_ABI: string[];
+export declare const PANCAKE_V3_ROUTER_ABI: (string | {
+    inputs: {
+        components: {
+            name: string;
+            type: string;
+        }[];
+        name: string;
+        type: string;
+    }[];
+    name: string;
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+    stateMutability: string;
+    type: string;
+})[];
+export declare const ERC20_BALANCE_OF_ABI: string[];
+export declare const PANCAKE_V2_ROUTER_ADDRESS: "0x10ED43C718714eb63d5aA57B78B54704E256024E";
+export declare const PANCAKE_V3_ROUTER_ADDRESS: "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4";
+export declare const FLAT_FEE = 0n;
+/** 最大 Bundle 签名数 */
+export declare const MAX_BUNDLE_SIGNATURES = 50;
+/** 贿赂交易数 */
+export declare const BRIBE_TX_COUNT = 1;
+/** 利润中转交易数（支付者 1 笔 + 中转钱包 PROFIT_HOP_COUNT 笔 + 最终接收 1 笔） */
+export declare const PROFIT_TX_COUNT: number;
+/** 最大买卖交易数 */
+export declare const MAX_SWAP_TX_COUNT: number;
+export type UserType = 'v0' | 'v1';
+/**
+ * 根据 userType 获取每笔交易的利润率
+ */
+export declare function getProfitRatePerTxBps(userType?: UserType): number;
+/**
+ * 验证买卖笔数
+ */
+export declare function validateSwapCounts(buyCount: number, sellCount: number): void;
+export { splitAmountByWeight as splitAmount } from '../../../core/amount/split-by-weight.js';
+/** 多笔买卖 nonce 规划（与 Flap 一致） */
+export type MultiNoncePlan = {
+    buyerNonces: number[];
+    sellerNonces: number[];
+    bribeNonce?: number;
+    profitNonce?: number;
+};
+export type SwapRouteType = 'v2' | 'v3-single' | 'v3-multi';
+export interface V2RouteParams {
+    routeType: 'v2';
+    v2Path: string[];
+}
+export interface V3SingleRouteParams {
+    routeType: 'v3-single';
+    v3TokenIn: string;
+    v3TokenOut: string;
+    v3Fee: number;
+    v2Path?: string[];
+}
+export interface V3MultiRouteParams {
+    routeType: 'v3-multi';
+    v3LpAddresses: string[];
+    v3ExactTokenIn: string;
+    v2Path?: string[];
+}
+export type RouteParams = V2RouteParams | V3SingleRouteParams | V3MultiRouteParams;
+export interface PancakeBuyFirstConfig extends CommonBundleConfig {
+    apiKey: string;
+    customRpcUrl?: string;
+    bundleBlockOffset?: number;
+    reserveGasBNB?: number;
+    waitForConfirmation?: boolean;
+    waitTimeoutMs?: number;
+}
+export interface PancakeBundleBuyFirstSignParams {
+    buyerPrivateKey?: string;
+    buyerPrivateKeys?: string[];
+    sellerPrivateKey?: string;
+    sellerPrivateKeys?: string[];
+    tokenAddress: string;
+    routeParams: RouteParams;
+    buyerFunds?: string;
+    buyerFundsPercentage?: number;
+    config: PancakeBuyFirstSignConfig;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    startNonces?: number[];
+    buyCount?: number;
+    sellCount?: number;
+    taxRateBps?: number;
+}
+export interface PancakeBundleBuyFirstParams {
+    buyerPrivateKey: string;
+    sellerPrivateKey: string;
+    tokenAddress: string;
+    routeParams: RouteParams;
+    buyerFunds?: string;
+    buyerFundsPercentage?: number;
+    config: PancakeBuyFirstConfig;
+}
+/** ✅ Pancake BuyFirst 结果（简化版） */
+export type PancakeBuyFirstResult = {
+    signedTransactions: string[];
+    profitHopWallets?: GeneratedWallet[];
+    metadata?: {
+        buyerAddress: string;
+        sellerAddress: string;
+        buyAmount: string;
+        sellAmount: string;
+        profitAmount?: string;
+        buyCount?: number;
+        sellCount?: number;
+        buyAmounts?: string[];
+        sellAmounts?: string[];
+    };
+};
+export type PancakeContext = {
+    chainId: number;
+    provider: ethers.JsonRpcProvider;
+};
+export type BuyerFundsResult = {
+    buyerFundsWei: bigint;
+    buyerBalance: bigint;
+    reserveGas: bigint;
+};
+export type QuoteTokenResult = {
+    quotedTokenOut: bigint;
+};

package/dist/chains/bsc/pancake/bundle-buy-first-helpers.js

@@ -0,0 +1,80 @@
+/**
+ * PancakeSwap V2/V3 通用捆绑换手（Merkle Bundle）- 先买后卖
+ *
+ * 功能：钱包B先买入代币 → 钱包A卖出相同数量 → 原子执行
+ */
+import { ethers } from 'ethers';
+import { PROFIT_HOP_COUNT } from '../../../utils/bundle-helpers.js';
+import { V2_ROUTER_ABI, V3_ROUTER02_ABI, ERC20_BALANCE_ABI } from '../../../abis/common.js';
+import { getProfitRateBps } from '../../../core/constants/index.js';
+import { ADDRESSES } from '../../../core/constants/index.js';
+/**
+ * 获取 Gas Limit
+ */
+export function getGasLimit(config, defaultGas = 800000) {
+    if (config.gasLimit !== undefined) {
+        return typeof config.gasLimit === 'bigint' ? config.gasLimit : BigInt(config.gasLimit);
+    }
+    const multiplier = config.gasLimitMultiplier ?? 1.0;
+    const calculatedGas = Math.ceil(defaultGas * multiplier);
+    return BigInt(calculatedGas);
+}
+export async function getGasPrice(provider, config) {
+    const feeData = await provider.getFeeData();
+    let gasPrice = feeData.gasPrice || ethers.parseUnits('3', 'gwei');
+    if (config.minGasPriceGwei) {
+        const minGas = ethers.parseUnits(config.minGasPriceGwei.toString(), 'gwei');
+        if (gasPrice < minGas)
+            gasPrice = minGas;
+    }
+    if (config.maxGasPriceGwei) {
+        const maxGas = ethers.parseUnits(config.maxGasPriceGwei.toString(), 'gwei');
+        if (gasPrice > maxGas)
+            gasPrice = maxGas;
+    }
+    return gasPrice;
+}
+// ✅ ABI 别名（从公共模块导入）
+export const PANCAKE_V2_ROUTER_ABI = V2_ROUTER_ABI;
+export const PANCAKE_V3_ROUTER_ABI = V3_ROUTER02_ABI;
+export const ERC20_BALANCE_OF_ABI = ERC20_BALANCE_ABI;
+// ✅ 使用官方 PancakeSwap Router 地址
+export const PANCAKE_V2_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV2Router;
+export const PANCAKE_V3_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV3Router;
+// 常量
+export const FLAT_FEE = 0n;
+// ==================== 多笔买卖常量 ====================
+/** 最大 Bundle 签名数 */
+export const MAX_BUNDLE_SIGNATURES = 50;
+/** 贿赂交易数 */
+export const BRIBE_TX_COUNT = 1;
+/** 利润中转交易数（支付者 1 笔 + 中转钱包 PROFIT_HOP_COUNT 笔 + 最终接收 1 笔） */
+export const PROFIT_TX_COUNT = PROFIT_HOP_COUNT + 2; // 2 + 2 = 4
+/** 最大买卖交易数 */
+export const MAX_SWAP_TX_COUNT = MAX_BUNDLE_SIGNATURES - BRIBE_TX_COUNT - PROFIT_TX_COUNT; // 50 - 1 - 4 = 45
+/**
+ * 根据 userType 获取每笔交易的利润率
+ */
+export function getProfitRatePerTxBps(userType) {
+    if (userType === 'v1') {
+        return getProfitRateBps('v1Double');
+    }
+    return getProfitRateBps('v0Double'); // v0 或默认
+}
+/**
+ * 验证买卖笔数
+ */
+export function validateSwapCounts(buyCount, sellCount) {
+    if (buyCount < 1) {
+        throw new Error(`买入笔数必须至少为 1，当前为 ${buyCount}`);
+    }
+    if (sellCount < 1) {
+        throw new Error(`卖出笔数必须至少为 1，当前为 ${sellCount}`);
+    }
+    const totalSwaps = buyCount + sellCount;
+    if (totalSwaps > MAX_SWAP_TX_COUNT) {
+        throw new Error(`买卖笔数总和 (${totalSwaps}) 超出限制 (${MAX_SWAP_TX_COUNT})，` +
+            `最大签名数为 ${MAX_BUNDLE_SIGNATURES}（${BRIBE_TX_COUNT} 贿赂 + ${PROFIT_TX_COUNT} 利润 + ${MAX_SWAP_TX_COUNT} 买卖）`);
+    }
+}
+export { splitAmountByWeight as splitAmount } from '../../../core/amount/split-by-weight.js';

package/dist/chains/bsc/pancake/bundle-buy-first.d.ts

@@ -1,92 +1,2 @@
-/**
- * PancakeSwap V2/V3 通用捆绑换手（Merkle Bundle）- 先买后卖
- *
- * 功能：钱包B先买入代币 → 钱包A卖出相同数量 → 原子执行
- */
-import { CommonBundleConfig } from '../../../utils/bundle-helpers.js';
-import type { GeneratedWallet } from '../../../utils/wallet.js';
-export interface PancakeBuyFirstSignConfig {
-    rpcUrl: string;
-    gasLimit?: number | bigint;
-    gasLimitMultiplier?: number;
-    minGasPriceGwei?: number;
-    maxGasPriceGwei?: number;
-    txType?: 0 | 2;
-    chainId?: number;
-    reserveGasBNB?: number;
-    skipQuoteOnError?: boolean;
-    userType?: UserType;
-    bribeAmount?: number;
-    v2RouterAddress?: string;
-}
-export type UserType = 'v0' | 'v1';
-export type SwapRouteType = 'v2' | 'v3-single' | 'v3-multi';
-export interface V2RouteParams {
-    routeType: 'v2';
-    v2Path: string[];
-}
-export interface V3SingleRouteParams {
-    routeType: 'v3-single';
-    v3TokenIn: string;
-    v3TokenOut: string;
-    v3Fee: number;
-    v2Path?: string[];
-}
-export interface V3MultiRouteParams {
-    routeType: 'v3-multi';
-    v3LpAddresses: string[];
-    v3ExactTokenIn: string;
-    v2Path?: string[];
-}
-export type RouteParams = V2RouteParams | V3SingleRouteParams | V3MultiRouteParams;
-export interface PancakeBuyFirstConfig extends CommonBundleConfig {
-    apiKey: string;
-    customRpcUrl?: string;
-    bundleBlockOffset?: number;
-    reserveGasBNB?: number;
-    waitForConfirmation?: boolean;
-    waitTimeoutMs?: number;
-}
-export interface PancakeBundleBuyFirstSignParams {
-    buyerPrivateKey?: string;
-    buyerPrivateKeys?: string[];
-    sellerPrivateKey?: string;
-    sellerPrivateKeys?: string[];
-    tokenAddress: string;
-    routeParams: RouteParams;
-    buyerFunds?: string;
-    buyerFundsPercentage?: number;
-    config: PancakeBuyFirstSignConfig;
-    quoteToken?: string;
-    quoteTokenDecimals?: number;
-    startNonces?: number[];
-    buyCount?: number;
-    sellCount?: number;
-    taxRateBps?: number;
-}
-export interface PancakeBundleBuyFirstParams {
-    buyerPrivateKey: string;
-    sellerPrivateKey: string;
-    tokenAddress: string;
-    routeParams: RouteParams;
-    buyerFunds?: string;
-    buyerFundsPercentage?: number;
-    config: PancakeBuyFirstConfig;
-}
-/** ✅ Pancake BuyFirst 结果（简化版） */
-export type PancakeBuyFirstResult = {
-    signedTransactions: string[];
-    profitHopWallets?: GeneratedWallet[];
-    metadata?: {
-        buyerAddress: string;
-        sellerAddress: string;
-        buyAmount: string;
-        sellAmount: string;
-        profitAmount?: string;
-        buyCount?: number;
-        sellCount?: number;
-        buyAmounts?: string[];
-        sellAmounts?: string[];
-    };
-};
+import { PancakeBundleBuyFirstSignParams, PancakeBuyFirstResult } from './bundle-buy-first-helpers.js';
 export declare function pancakeBundleBuyFirstMerkle(params: PancakeBundleBuyFirstSignParams): Promise<PancakeBuyFirstResult>;