four-flap-meme-sdk 2.2.8 → 2.2.10

package/dist/shared/foundation/types/erc20.d.ts

@@ -1,65 +0,0 @@
-import type { ContractTransactionReceipt } from 'ethers';
-import type { NonceManager } from '../nonce/nonce-manager.js';
-export type EnsureAllowanceResult = {
-    /** 是否已经授权 */
-    alreadyApproved: boolean;
-    /** 当前授权额度 */
-    currentAllowance: bigint;
-    /** 需要的授权额度 */
-    requiredAllowance: bigint;
-    /** 授权交易回执（如果发送了新交易） */
-    txReceipt?: ContractTransactionReceipt | null;
-};
-export type EnsureAllowanceBatchItemResult = EnsureAllowanceResult & {
-    owner: string;
-};
-export type ApproveTokenBatchParams = {
-    chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD';
-    platform: 'flap' | 'four' | 'pancake-v2' | 'pancake-v3';
-    rpcUrl: string;
-    privateKeys: string[];
-    tokenAddress: string;
-    amounts: (bigint | 'max')[];
-    signOnly?: boolean;
-    gasPriceGwei?: number;
-    gasLimit?: number;
-    chainId?: number;
-    skipValidation?: boolean;
-};
-export type ApproveTokenBatchRawParams = {
-    rpcUrl: string;
-    privateKeys: string[];
-    tokenAddress: string;
-    spenderAddress: string;
-    amounts: (bigint | 'max')[];
-    signOnly?: boolean;
-    gasPriceGwei?: number;
-    gasLimit?: number;
-    chainId?: number;
-    nonceManager?: NonceManager;
-    skipValidation?: boolean;
-};
-export type ApproveTokenBatchResult = {
-    success: boolean;
-    approvedCount: number;
-    results: Array<{
-        owner: string;
-        alreadyApproved: boolean;
-        currentAllowance: bigint;
-        requiredAllowance: bigint;
-        txHash?: string;
-        error?: string;
-    }>;
-};
-export type ApproveTokenBatchSignResult = {
-    signedTransactions: string[];
-    results: Array<{
-        owner: string;
-        alreadyApproved: boolean;
-        currentAllowance: bigint;
-        requiredAllowance: bigint;
-        signedTx?: string;
-    }>;
-    needApproveCount: number;
-    alreadyApprovedCount: number;
-};

package/dist/shared/foundation/types/erc20.js

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

package/dist/shared/foundation/types/holders-maker.d.ts

@@ -1,64 +0,0 @@
-/**
- * 刷持有人 - 类型定义
- */
-import type { GeneratedWallet } from '../../../utils/wallet.js';
-export type HoldersMakerChain = 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
-export type HoldersMakerTradeType = 'four' | 'flap' | 'v2' | 'v3' | 'daoaas';
-export type BaseTokenType = 'native' | 'usdt' | 'usdc';
-export type HoldersMakerConfig = {
-    rpcUrl: string;
-    chain?: HoldersMakerChain;
-    chainId?: number;
-    tradeType?: HoldersMakerTradeType;
-    gasLimit?: number;
-    gasPriceGwei?: number;
-    bribeAmount?: number;
-    txType?: 0 | 2;
-    maxWalletsPerBatch?: number;
-    fourApiUrl?: string;
-    disperseHopCount?: number;
-    v2Path?: string[];
-    v3TokenIn?: string;
-    v3Fee?: number;
-    v3LpAddresses?: string[];
-    v3Tokens?: string[];
-    v2RouterAddress?: string;
-};
-export type HoldersMakerParams = {
-    payerPrivateKey: string;
-    holdersCount: number;
-    buyAmountPerHolder: string;
-    tokenAddress: string;
-    baseToken?: BaseTokenType;
-    baseTokenAddress?: string;
-    baseTokenDecimals?: number;
-    config: HoldersMakerConfig;
-};
-export type TransactionLayer = {
-    name: string;
-    startIndex: number;
-    endIndex: number;
-    count: number;
-};
-export type BatchResult = {
-    batchIndex: number;
-    success: boolean;
-    signedTransactions?: string[];
-    txHashes?: string[];
-    error?: string;
-    walletCount: number;
-    transactionLayers?: TransactionLayer[];
-    disperseHopCount?: number;
-};
-export type HoldersMakerResult = {
-    success: boolean;
-    newWallets: GeneratedWallet[];
-    disperseHopWallets?: GeneratedWallet[];
-    profitHopWallets?: GeneratedWallet[];
-    signedTransactions: string[][];
-    batchResults: BatchResult[];
-    successBatchCount: number;
-    totalBatchCount: number;
-    error?: string;
-    disperseHopCount?: number;
-};

package/dist/shared/foundation/types/holders-maker.js

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

package/dist/shared/foundation/types/index.d.ts

@@ -1,7 +0,0 @@
-export type { Aggregate3CallResult } from './multicall.js';
-export type { EnsureAllowanceResult, EnsureAllowanceBatchItemResult, ApproveTokenBatchParams, ApproveTokenBatchRawParams, ApproveTokenBatchResult, ApproveTokenBatchSignResult, } from './erc20.js';
-export type { HoldersMakerChain, HoldersMakerTradeType, BaseTokenType, HoldersMakerConfig, HoldersMakerParams, TransactionLayer, BatchResult, HoldersMakerResult, } from './holders-maker.js';
-export type { DexConfig, ChainDexConfig, PoolPairInfo, V3PoolInfo, DexPoolInfo, BestPoolInfo, LPPlatform, LPInfo, InspectOptions, } from './lp-inspect.js';
-export type { BundleSubmitResult, SignedTransactionsResult, AirdropDisperseParams, AirdropDisperseSignParams, AirdropSweepParams, AirdropSweepSignParams, DisperseParams, DisperseSignParams, SweepParams, SweepSignParams, } from './airdrop-sweep.js';
-export type { PrivateSaleSignConfig, PrivateSaleTransferParams, BatchPrivateSaleParams, PrivateSaleResult, } from './private-sale.js';
-export type { SupportedChain, QuoteParams, QuoteResult } from './quote-helpers.js';

package/dist/shared/foundation/types/index.js

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

package/dist/shared/foundation/types/lp-inspect.d.ts

@@ -1,102 +0,0 @@
-/**
- * LP 查询 - 类型定义
- */
-import type { FlapChain } from '../../flap/portal.js';
-export interface DexConfig {
-    name: string;
-    v2Factory?: string;
-    v3Factory?: string;
-    v2Router?: string;
-    v3Router?: string;
-    quoterV2?: string;
-    enabled: boolean;
-}
-export interface ChainDexConfig {
-    wrappedNative: string;
-    wrappedNativeSymbol: string;
-    stableCoins: Array<{
-        address: string;
-        symbol: string;
-        decimals: number;
-    }>;
-    dexes: Record<string, DexConfig>;
-}
-export interface PoolPairInfo {
-    quoteToken: string;
-    quoteSymbol: string;
-    quoteDecimals: number;
-    pairAddress: string;
-    reserveToken: string;
-    reserveQuote: string;
-    reserveQuoteRaw?: bigint;
-    reserveTokenRaw?: bigint;
-    poolRatio?: string;
-}
-export interface V3PoolInfo extends PoolPairInfo {
-    fee: number;
-}
-export interface DexPoolInfo {
-    dexName: string;
-    dexKey: string;
-    v2Pairs: PoolPairInfo[];
-    v3Pools: V3PoolInfo[];
-}
-export interface BestPoolInfo {
-    dex: string;
-    dexKey: string;
-    version: 'v2' | 'v3';
-    fee?: number;
-    quoteToken: string;
-    quoteSymbol: string;
-    quoteDecimals: number;
-    pairAddress: string;
-    liquidity: string;
-    liquidityRaw: bigint;
-    reserveToken?: string;
-    reserveTokenRaw?: bigint;
-    poolRatio?: string;
-}
-export type LPPlatform = 'FOUR' | 'FLAP' | 'DAOAAS' | 'PANCAKESWAP_V2' | 'PANCAKESWAP_V3' | 'UNISWAP_V2' | 'UNISWAP_V3' | 'IROSWAP_V2' | 'MULTI_DEX' | 'UNKNOWN';
-export interface LPInfo {
-    platform: LPPlatform;
-    decimals?: number;
-    totalSupply?: string;
-    totalSupplyRaw?: bigint;
-    taxRate?: number;
-    four?: {
-        helper: string;
-        reserveNative?: string;
-        offerTokens?: string;
-        lastPrice?: string;
-    };
-    flap?: {
-        quoteToken?: string;
-        quoteSymbol?: string;
-        quoteDecimals?: number;
-        reserveNative?: string;
-        circulatingSupply?: string;
-        price?: string;
-        taxRate?: number;
-    };
-    daoaas?: {
-        quoteToken?: string;
-        quoteSymbol?: string;
-        quoteDecimals?: number;
-        reserveNative?: string;
-        circulatingSupply?: string;
-        price?: string;
-        status?: number;
-    };
-    allPools: DexPoolInfo[];
-    bestPools: BestPoolInfo[];
-}
-export interface InspectOptions {
-    chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
-    rpcUrl: string;
-    flapChain?: FlapChain;
-    v3FeeTiers?: number[];
-    customDexConfig?: Partial<ChainDexConfig>;
-    multicall3?: string;
-    debug?: boolean;
-    formatBalances?: boolean;
-}

package/dist/shared/foundation/types/lp-inspect.js

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

package/dist/shared/foundation/types/multicall.d.ts

@@ -1,5 +0,0 @@
-/** Multicall3 `aggregate3` 单条返回（与 IERC20 balanceOf / getEthBalance 解码路径一致） */
-export type Aggregate3CallResult = {
-    success: boolean;
-    returnData: string;
-};

package/dist/shared/foundation/types/multicall.js

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

package/dist/shared/foundation/types/private-sale.d.ts

@@ -1,35 +0,0 @@
-/**
- * 私募转账签名 — 类型定义
- */
-import type { GeneratedWallet } from '../../../utils/wallet.js';
-export interface PrivateSaleSignConfig {
-    rpcUrl: string;
-    chainId?: number;
-    gasLimit?: number;
-    gasPriceGwei?: number;
-    bribeAmount?: number;
-    extractProfit?: boolean;
-    profitBps?: number;
-}
-export interface PrivateSaleTransferParams {
-    senderPrivateKey: string;
-    recipient: string;
-    amount: number;
-}
-export interface BatchPrivateSaleParams {
-    transfers: PrivateSaleTransferParams[];
-    config: PrivateSaleSignConfig;
-}
-export interface PrivateSaleResult {
-    signedTransactions: string[];
-    profitHopWallets?: GeneratedWallet[];
-    metadata: {
-        totalCount: number;
-        bribeCount: number;
-        transferCount: number;
-        profitCount: number;
-        totalAmountWei: string;
-        totalProfitWei: string;
-        bribeAmountWei: string;
-    };
-}

package/dist/shared/foundation/types/private-sale.js

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

package/dist/shared/foundation/types/quote-helpers.d.ts

@@ -1,17 +0,0 @@
-import type { JsonRpcProvider } from 'ethers';
-export type SupportedChain = 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
-export interface QuoteParams {
-    provider: JsonRpcProvider;
-    tokenIn: string;
-    tokenOut: string;
-    amountIn: bigint;
-    chain: string;
-    version?: 'v2' | 'v3';
-    fee?: number;
-    routerOverride?: string;
-}
-export interface QuoteResult {
-    amountOut: bigint;
-    path?: string[];
-    fee?: number;
-}

package/dist/shared/foundation/types/quote-helpers.js

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

package/dist/types/errors.d.ts

@@ -1,27 +0,0 @@
-/**
- * 统一 SDK 错误代码
- *
- * 合并 Four.meme (parseFourError) 和 Flap Protocol (parseFlapError) 的错误代码。
- */
-export declare enum SdkErrorCode {
-    UNKNOWN_ERROR = "UNKNOWN_ERROR",
-    INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
-    SLIPPAGE_EXCEEDED = "SLIPPAGE_EXCEEDED",
-    TRANSACTION_FAILED = "TRANSACTION_FAILED",
-    TOKEN_ALREADY_EXISTS = "TOKEN_ALREADY_EXISTS",
-    TOKEN_NOT_FOUND = "TOKEN_NOT_FOUND",
-    TOKEN_NOT_TRADABLE = "TOKEN_NOT_TRADABLE",
-    ALREADY_ON_DEX = "ALREADY_ON_DEX",
-    FOUR_GWEI_PRECISION = "FOUR_GWEI_PRECISION",
-    FOUR_ZERO_ADDRESS = "FOUR_ZERO_ADDRESS",
-    FOUR_SLIPPAGE = "FOUR_SLIPPAGE",
-    FOUR_INSUFFICIENT_FUNDS = "FOUR_INSUFFICIENT_FUNDS",
-    FOUR_FEE_TOO_HIGH = "FOUR_FEE_TOO_HIGH",
-    FOUR_ORDER_TOO_SMALL = "FOUR_ORDER_TOO_SMALL",
-    INVALID_AMOUNT = "INVALID_AMOUNT",
-    INVALID_TOKEN = "INVALID_TOKEN",
-    INVALID_QUOTE_TOKEN = "INVALID_QUOTE_TOKEN",
-    TAX_RATE_TOO_HIGH = "TAX_RATE_TOO_HIGH",
-    PERMIT_EXPIRED = "PERMIT_EXPIRED",
-    PERMIT_INVALID = "PERMIT_INVALID"
-}

package/dist/types/errors.js

@@ -1,34 +0,0 @@
-/**
- * 统一 SDK 错误代码
- *
- * 合并 Four.meme (parseFourError) 和 Flap Protocol (parseFlapError) 的错误代码。
- */
-export var SdkErrorCode;
-(function (SdkErrorCode) {
-    // Generic
-    SdkErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
-    // Transaction / Bundle
-    SdkErrorCode["INSUFFICIENT_BALANCE"] = "INSUFFICIENT_BALANCE";
-    SdkErrorCode["SLIPPAGE_EXCEEDED"] = "SLIPPAGE_EXCEEDED";
-    SdkErrorCode["TRANSACTION_FAILED"] = "TRANSACTION_FAILED";
-    // Token state
-    SdkErrorCode["TOKEN_ALREADY_EXISTS"] = "TOKEN_ALREADY_EXISTS";
-    SdkErrorCode["TOKEN_NOT_FOUND"] = "TOKEN_NOT_FOUND";
-    SdkErrorCode["TOKEN_NOT_TRADABLE"] = "TOKEN_NOT_TRADABLE";
-    SdkErrorCode["ALREADY_ON_DEX"] = "ALREADY_ON_DEX";
-    // Four.meme specific
-    SdkErrorCode["FOUR_GWEI_PRECISION"] = "FOUR_GWEI_PRECISION";
-    SdkErrorCode["FOUR_ZERO_ADDRESS"] = "FOUR_ZERO_ADDRESS";
-    SdkErrorCode["FOUR_SLIPPAGE"] = "FOUR_SLIPPAGE";
-    SdkErrorCode["FOUR_INSUFFICIENT_FUNDS"] = "FOUR_INSUFFICIENT_FUNDS";
-    SdkErrorCode["FOUR_FEE_TOO_HIGH"] = "FOUR_FEE_TOO_HIGH";
-    SdkErrorCode["FOUR_ORDER_TOO_SMALL"] = "FOUR_ORDER_TOO_SMALL";
-    // Validation
-    SdkErrorCode["INVALID_AMOUNT"] = "INVALID_AMOUNT";
-    SdkErrorCode["INVALID_TOKEN"] = "INVALID_TOKEN";
-    SdkErrorCode["INVALID_QUOTE_TOKEN"] = "INVALID_QUOTE_TOKEN";
-    SdkErrorCode["TAX_RATE_TOO_HIGH"] = "TAX_RATE_TOO_HIGH";
-    // Permit
-    SdkErrorCode["PERMIT_EXPIRED"] = "PERMIT_EXPIRED";
-    SdkErrorCode["PERMIT_INVALID"] = "PERMIT_INVALID";
-})(SdkErrorCode || (SdkErrorCode = {}));

package/dist/utils/holders-maker/addresses.d.ts

@@ -1,12 +0,0 @@
-export declare const FOUR_TM2_ABI: string[];
-export declare const PANCAKE_V2_ROUTER_ADDRESS: "0x10ED43C718714eb63d5aA57B78B54704E256024E";
-export declare const PANCAKE_V3_ROUTER_ADDRESS: "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4";
-export declare const WBNB_ADDRESS: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
-export declare const USDT_ADDRESS: "0x55d398326f99059fF775485246999027B3197955";
-export declare const USDC_ADDRESS: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d";
-export declare const XLAYER_V2_ROUTER_ADDRESS: "0x881fb2f98c13d521009464e7d1cbf16e1b394e8e";
-export declare const XLAYER_V3_ROUTER_ADDRESS: "0xBB069e9465BcabC4F488d21e793BDEf0F2d41D41";
-export declare const WOKB_ADDRESS: "0xe538905cf8410324e03a5a23c1c177a474d59b2b";
-export declare const ENI_V2_ROUTER_ADDRESS: "0x97ed8be49d9a8b86247090aa41e908e76b8fcf22";
-export declare const ENI_DAOAAS_PORTAL_ADDRESS: "0x0078341F4CD09D7E6D3125ef6eb4cB2F46CA8310";
-export declare const WEGAS_ADDRESS: "0x6d1e851446f4d004ae2a72f9afed85e8829a205e";

package/dist/utils/holders-maker/addresses.js

@@ -1,15 +0,0 @@
-import { ADDRESSES } from '../constants.js';
-export const FOUR_TM2_ABI = [
-    'function buyTokenAMAP(uint256 origin, address token, address to, uint256 funds, uint256 minAmount) payable',
-];
-export const PANCAKE_V2_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV2Router;
-export const PANCAKE_V3_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV3Router;
-export const WBNB_ADDRESS = ADDRESSES.BSC.WBNB;
-export const USDT_ADDRESS = ADDRESSES.BSC.USDT;
-export const USDC_ADDRESS = ADDRESSES.BSC.USDC;
-export const XLAYER_V2_ROUTER_ADDRESS = ADDRESSES.XLAYER.PotatoSwapV2Router;
-export const XLAYER_V3_ROUTER_ADDRESS = ADDRESSES.XLAYER.PotatoSwapV3Router;
-export const WOKB_ADDRESS = ADDRESSES.XLAYER.WOKB;
-export const ENI_V2_ROUTER_ADDRESS = ADDRESSES.ENI.DswapV2Router;
-export const ENI_DAOAAS_PORTAL_ADDRESS = ADDRESSES.ENI.DaoaasPortal;
-export const WEGAS_ADDRESS = ADDRESSES.ENI.WEGAS;

package/dist/utils/holders-maker/buy-tx.d.ts

@@ -1,44 +0,0 @@
-import { Wallet } from 'ethers';
-import type { HoldersMakerChain } from '../../shared/foundation/types/holders-maker.js';
-/**
- * 构建 Flap 买入交易
- * 使用 swapExactInput 方法
- */
-export declare function buildFlapBuyTx(wallet: Wallet, tokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number, txType: 0 | 2, chain: HoldersMakerChain): Promise<string>;
-/**
- * 构建 Four 内盘买入交易
- * 使用 buyTokenAMAP 方法
- */
-export declare function buildFourBuyTx(wallet: Wallet, tokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number, txType: 0 | 2): Promise<string>;
-/**
- * 构建 DAOaaS 内盘买入交易 (ENI 链)
- * EGAS → Token (使用 DAOaaS Portal buy)
- */
-export declare function buildDaoaasBuyTx(wallet: Wallet, tokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number): Promise<string>;
-/**
- * 构建 V2 买入交易
- * BNB/OKB → Token (使用 swapExactETHForTokensSupportingFeeOnTransferTokens)
- */
-export declare function buildV2BuyTx(wallet: Wallet, tokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number, txType: 0 | 2, v2Path?: string[], chain?: HoldersMakerChain, v2RouterOverride?: string): Promise<string>;
-/**
- * 构建 V3 单跳买入交易
- * BNB/OKB → Token (使用 exactInputSingle + multicall)
- *
- * ✅ 修复：根据链类型选择正确的 Router ABI 版本
- * - XLayer/Monad: 旧版 Router（exactInputSingle 包含 deadline，multicall(bytes[])）
- * - BSC: 新版 SwapRouter02（exactInputSingle 不含 deadline，multicall(uint256,bytes[])）
- */
-export declare function buildV3BuyTx(wallet: Wallet, tokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number, txType: 0 | 2, v3Fee?: number, // 默认 0.25% 手续费
-chain?: HoldersMakerChain): Promise<string>;
-/**
- * 构建 V2 买入交易（ERC20 输入）
- * USDT/USDC → Token (使用 swapExactTokensForTokensSupportingFeeOnTransferTokens)
- */
-export declare function buildV2BuyTxWithERC20(wallet: Wallet, tokenAddress: string, baseTokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number, txType: 0 | 2, v2RouterOverride?: string, chain?: HoldersMakerChain): Promise<string>;
-/**
- * 构建 V3 买入交易（ERC20 输入）
- * USDT/USDC → Token (使用 exactInputSingle + multicall)
- *
- * ✅ 修复：使用 ethers.Interface 手动编码 calldata，避免 multicall 重载问题
- */
-export declare function buildV3BuyTxWithERC20(wallet: Wallet, tokenAddress: string, baseTokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number, txType: 0 | 2, v3Fee?: number): Promise<string>;