four-flap-meme-sdk 2.2.8 → 2.2.11

package/dist/chains/xlayer/eoa/eoa-bundle-swap-helpers.d.ts

@@ -1,126 +0,0 @@
-import { ethers, Wallet, JsonRpcProvider } from 'ethers';
-import { type GeneratedWallet } from '../../../utils/wallet.js';
-/**
-
- * XLayer EOA 模式批量换手
-
- *
-
- * 专门为 XLayer 链设计，不影响 BSC 链的逻辑
-
- * - 使用 PotatoSwap V3 Quoter
-
- * - 使用 WOKB 作为 Wrapped Native Token
-
- * - 支持多跳转账和利润刮取
-
- */
-export declare const XLAYER_CHAIN_ID: 196;
-export declare const WOKB_ADDRESS: string;
-export declare const POTATO_V2_ROUTER: string;
-export declare const POTATO_V3_ROUTER: string;
-export declare const NATIVE_TRANSFER_GAS_LIMIT: 21055n;
-export declare const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
-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 XLayerEoaSwapConfig {
-    rpcUrl: string;
-    gasLimit?: number | bigint;
-    gasLimitMultiplier?: number;
-    minGasPriceGwei?: number;
-    maxGasPriceGwei?: number;
-    txType?: 0 | 2;
-    reserveGasBNB?: number;
-    userType?: UserType;
-    bribeAmount?: number;
-}
-export interface XLayerQuickBatchSwapParams {
-    sellerPrivateKey: string;
-    sellAmount?: string;
-    sellPercentage?: number;
-    buyerPrivateKeys: string[];
-    buyerRatios?: number[];
-    buyerAmounts?: string[];
-    tokenAddress: string;
-    routeParams: RouteParams;
-    config: XLayerEoaSwapConfig;
-    quoteToken?: string;
-    quoteTokenDecimals?: number;
-    disperseHopCount?: number;
-    startNonces?: number[];
-}
-export interface XLayerQuickBatchSwapResult {
-    signedTransactions: string[];
-    disperseHopWallets?: GeneratedWallet[];
-    profitHopWallets?: GeneratedWallet[];
-    metadata?: {
-        sellerAddress: string;
-        buyerAddresses: string[];
-        sellAmount: string;
-        estimatedOutput: string;
-        transferAmounts: string[];
-        profitAmount?: string;
-        useNativeToken: boolean;
-        disperseHopCount?: number;
-    };
-}
-export interface XLayerCrossSwapParams {
-    sellerPrivateKeys: string[];
-    sellAmounts: string[];
-    buyerPrivateKeys: string[];
-    tokenAddress: string;
-    routeParams: RouteParams;
-    config: XLayerEoaSwapConfig;
-    quoteToken?: string;
-    quoteTokenDecimals?: number;
-    buyersPerSell?: number;
-    disperseHopCount?: number;
-    /** ✅ 预获取的 nonce（地址 -> nonce），避免 nonce 不同步 */
-    startNonces?: Map<string, number>;
-}
-export interface XLayerCrossSwapResult {
-    signedTransactions: string[];
-    rounds: Array<{
-        sellerAddress: string;
-        buyerAddresses: string[];
-        sellAmount: string;
-        bundleHash?: string;
-    }>;
-    disperseHopWallets?: GeneratedWallet[];
-    profitHopWallets?: GeneratedWallet[];
-}
-export declare function createXLayerContext(config: XLayerEoaSwapConfig): {
-    chainId: 196;
-    provider: ethers.JsonRpcProvider;
-};
-export declare function getGasLimit(config: XLayerEoaSwapConfig, defaultGas?: number): bigint;
-export declare function getGasPrice(provider: JsonRpcProvider, config: XLayerEoaSwapConfig): Promise<bigint>;
-export declare function getProfitRateBps(userType?: UserType): number;
-export declare function calculateProfitAmount(estimatedOutput: bigint, userType?: UserType): bigint;
-export declare function quoteSellOutput(provider: JsonRpcProvider, routeParams: RouteParams, sellAmountWei: bigint): Promise<bigint>;
-export declare function getERC20ToOkbQuote(provider: JsonRpcProvider, tokenAddress: string, tokenAmount: bigint, version?: 'v2' | 'v3', fee?: number): Promise<bigint>;
-export type DisperseHopPath = {
-    targetAddress: string;
-    hopWallets: Wallet[];
-    hopWalletsInfo: GeneratedWallet[];
-};
-export declare function generateDisperseHopPaths(targetAddresses: string[], hopCount: number, provider: JsonRpcProvider): DisperseHopPath[];
-export declare function buildNativeHopChain(payer: Wallet, path: DisperseHopPath, finalAmount: bigint, gasPrice: bigint, txType: 0 | 2, payerNonce: number): Promise<string[]>;

package/dist/chains/xlayer/eoa/eoa-bundle-swap-helpers.js

@@ -1,228 +0,0 @@
-import { ethers, Wallet } from 'ethers';
-import { createXLayerProvider } from '../../../utils/provider-factory.js';
-import { GAS_LIMITS, CHAINS, getProfitRateBps as getSharedProfitRateBps } from '../../../shared/constants/index.js';
-import { quoteV2, quoteV3 } from '../../../utils/quote-helpers.js';
-import { generateWallets } from '../../../utils/wallet.js';
-import { WOKB, POTATOSWAP_V2_ROUTER, POTATOSWAP_SWAP_ROUTER02 } from './constants.js';
-/**
-
- * XLayer EOA 模式批量换手
-
- *
-
- * 专门为 XLayer 链设计，不影响 BSC 链的逻辑
-
- * - 使用 PotatoSwap V3 Quoter
-
- * - 使用 WOKB 作为 Wrapped Native Token
-
- * - 支持多跳转账和利润刮取
-
- */
-// ✅ 从 XLayer 常量导入正确的路由地址
-// ==================== XLayer 专用常量 ====================
-export const XLAYER_CHAIN_ID = CHAINS.XLAYER.chainId;
-const XLAYER_CHAIN_NAME = CHAINS.XLAYER.name;
-export const WOKB_ADDRESS = ethers.getAddress(WOKB);
-// ✅ 强制校验和，避免大小写错误导致的 bad address checksum
-export const POTATO_V2_ROUTER = ethers.getAddress(POTATOSWAP_V2_ROUTER);
-export const POTATO_V3_ROUTER = ethers.getAddress(POTATOSWAP_SWAP_ROUTER02); // ✅ SwapRouter02 用于 V3 交易
-export const NATIVE_TRANSFER_GAS_LIMIT = GAS_LIMITS.NATIVE_TRANSFER;
-export const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
-// ==================== 工具函数 ====================
-export function createXLayerContext(config) {
-    const provider = createXLayerProvider(config.rpcUrl);
-    return { chainId: XLAYER_CHAIN_ID, provider };
-}
-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;
-    return BigInt(Math.ceil(defaultGas * multiplier));
-}
-export async function getGasPrice(provider, config) {
-    const feeData = await provider.getFeeData();
-    let gasPrice = feeData.gasPrice || ethers.parseUnits('0.1', '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;
-}
-export function getProfitRateBps(userType) {
-    if (userType === 'v0')
-        return getSharedProfitRateBps('v0Single');
-    if (userType === 'v1')
-        return getSharedProfitRateBps('v1Single');
-    return getSharedProfitRateBps('v0Single');
-}
-export function calculateProfitAmount(estimatedOutput, userType) {
-    if (estimatedOutput <= 0n)
-        return 0n;
-    const rateBps = getProfitRateBps(userType);
-    return (estimatedOutput * BigInt(rateBps)) / 10000n;
-}
-// ==================== 报价函数 ====================
-export async function quoteSellOutput(provider, routeParams, sellAmountWei) {
-    if (routeParams.routeType === 'v2') {
-        const { v2Path } = routeParams;
-        const tokenIn = v2Path[0];
-        const tokenOut = v2Path[v2Path.length - 1];
-        const result = await quoteV2(provider, tokenIn, tokenOut, sellAmountWei, XLAYER_CHAIN_NAME);
-        if (result.amountOut > 0n) {
-            return result.amountOut;
-        }
-        throw new Error('V2 报价失败');
-    }
-    if (routeParams.routeType === 'v3-single') {
-        const params = routeParams;
-        const result = await quoteV3(provider, params.v3TokenIn, params.v3TokenOut, sellAmountWei, XLAYER_CHAIN_NAME, params.v3Fee);
-        if (result.amountOut > 0n) {
-            return result.amountOut;
-        }
-        // ❗️兜底：如果 V3 报价失败且提供了 v2Path，则尝试 V2 报价（避免因为无对应费率池导致失败）
-        if (params.v2Path && params.v2Path.length >= 2) {
-            const tokenIn = params.v2Path[0];
-            const tokenOut = params.v2Path[params.v2Path.length - 1];
-            const v2Result = await quoteV2(provider, tokenIn, tokenOut, sellAmountWei, XLAYER_CHAIN_NAME);
-            if (v2Result.amountOut > 0n) {
-                return v2Result.amountOut;
-            }
-        }
-        throw new Error(`V3 单跳报价失败: tokenIn=${params.v3TokenIn}, tokenOut=${params.v3TokenOut}, fee=${params.v3Fee}`);
-    }
-    if (routeParams.routeType === 'v3-multi') {
-        const params = routeParams;
-        const tokenIn = params.v3ExactTokenIn;
-        const result = await quoteV3(provider, tokenIn, WOKB_ADDRESS, sellAmountWei, XLAYER_CHAIN_NAME);
-        if (result.amountOut > 0n) {
-            return result.amountOut;
-        }
-        // ❗️兜底：如果 V3 多跳失败且提供 v2Path，则尝试 V2 报价
-        if (params.v2Path && params.v2Path.length >= 2) {
-            const tokenInV2 = params.v2Path[0];
-            const tokenOutV2 = params.v2Path[params.v2Path.length - 1];
-            const v2Result = await quoteV2(provider, tokenInV2, tokenOutV2, sellAmountWei, XLAYER_CHAIN_NAME);
-            if (v2Result.amountOut > 0n) {
-                return v2Result.amountOut;
-            }
-        }
-        throw new Error(`V3 多跳报价失败`);
-    }
-    // ✅ 用类型判断收窄 RouteParams 联合类型
-    const routeType = routeParams.routeType ??
-        routeParams.routeType ??
-        routeParams.routeType;
-    throw new Error(`不支持的路由类型: ${routeType}`);
-}
-export async function getERC20ToOkbQuote(provider, tokenAddress, tokenAmount, version = 'v2', fee) {
-    if (tokenAmount <= 0n)
-        return 0n;
-    const tokenLower = tokenAddress.toLowerCase();
-    const wokbLower = WOKB_ADDRESS.toLowerCase();
-    if (tokenLower === wokbLower)
-        return tokenAmount;
-    if (version === 'v3') {
-        const result = await quoteV3(provider, tokenAddress, WOKB_ADDRESS, tokenAmount, XLAYER_CHAIN_NAME, fee);
-        if (result.amountOut > 0n) {
-            return result.amountOut;
-        }
-        return 0n;
-    }
-    const result = await quoteV2(provider, tokenAddress, WOKB_ADDRESS, tokenAmount, XLAYER_CHAIN_NAME);
-    if (result.amountOut > 0n) {
-        return result.amountOut;
-    }
-    return 0n;
-}
-export function generateDisperseHopPaths(targetAddresses, hopCount, provider) {
-    if (hopCount <= 0) {
-        return targetAddresses.map((addr) => ({
-            targetAddress: addr,
-            hopWallets: [],
-            hopWalletsInfo: [],
-        }));
-    }
-    return targetAddresses.map((targetAddress) => {
-        const hopWalletsInfo = generateWallets(hopCount);
-        const hopWallets = hopWalletsInfo.map((w) => new Wallet(w.privateKey, provider));
-        return { targetAddress, hopWallets, hopWalletsInfo };
-    });
-}
-export async function buildNativeHopChain(payer, path, finalAmount, gasPrice, txType, payerNonce) {
-    const signedTxs = [];
-    const hopCount = path.hopWallets.length;
-    if (hopCount === 0) {
-        const tx = {
-            to: path.targetAddress,
-            value: finalAmount,
-            nonce: payerNonce,
-            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-            chainId: XLAYER_CHAIN_ID,
-            type: txType,
-        };
-        if (txType === 2) {
-            tx.maxFeePerGas = gasPrice;
-            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
-        }
-        else {
-            tx.gasPrice = gasPrice;
-        }
-        signedTxs.push(await payer.signTransaction(tx));
-        return signedTxs;
-    }
-    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
-    const amountsPerHop = [];
-    for (let i = 0; i < hopCount; i++) {
-        const remainingHops = hopCount - i;
-        amountsPerHop.push(finalAmount + hopGasCost * BigInt(remainingHops));
-    }
-    // payer → hop1
-    const firstTx = {
-        to: path.hopWallets[0].address,
-        value: amountsPerHop[0],
-        nonce: payerNonce,
-        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-        chainId: XLAYER_CHAIN_ID,
-        type: txType,
-    };
-    if (txType === 2) {
-        firstTx.maxFeePerGas = gasPrice;
-        firstTx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
-    }
-    else {
-        firstTx.gasPrice = gasPrice;
-    }
-    signedTxs.push(await payer.signTransaction(firstTx));
-    // hop1 → hop2 → ... → target
-    for (let i = 0; i < hopCount; i++) {
-        const fromWallet = path.hopWallets[i];
-        const toAddress = i === hopCount - 1 ? path.targetAddress : path.hopWallets[i + 1].address;
-        const amount = i === hopCount - 1 ? finalAmount : amountsPerHop[i + 1];
-        const tx = {
-            to: toAddress,
-            value: amount,
-            nonce: 0,
-            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-            chainId: XLAYER_CHAIN_ID,
-            type: txType,
-        };
-        if (txType === 2) {
-            tx.maxFeePerGas = gasPrice;
-            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
-        }
-        else {
-            tx.gasPrice = gasPrice;
-        }
-        signedTxs.push(await fromWallet.signTransaction(tx));
-    }
-    return signedTxs;
-}
-// ==================== XLayer 快捷批量换手 ====================

package/dist/contracts/tm-bundle-helpers.d.ts

@@ -1,88 +0,0 @@
-import { JsonRpcProvider } from 'ethers';
-import type { TransactionRequest } from 'ethers';
-import type { SoulPointSignatureMode, VNormalizationMode } from '../shared/clients/club48.js';
-import { BundleStatus } from '../shared/clients/club48.js';
-import type { GeneratedWallet } from '../utils/wallet.js';
-/**
- * four.meme Bundle 交易方法
- * 使用 48.club Bundle 服务实现原子化交易
- */
-export { BUNDLE_ERRORS as ERRORS, getBundleErrorMessage as getErrorMessage } from '../bundle-core/errors.js';
-export type FourBundleConfig = {
-    rpcUrl: string;
-    fourApiUrl?: string;
-    club48Endpoint?: string;
-    club48ExplorerEndpoint?: string;
-    spMode?: SoulPointSignatureMode;
-    spVMode?: VNormalizationMode;
-    spPrivateKey?: string;
-    bundleBlockOffset?: number;
-    noMerge?: boolean;
-    tipAmountWei?: bigint;
-    txType?: 0 | 2;
-    gasLimitMultiplier?: number;
-    customSubmitFn?: (signedTxs: string[]) => Promise<string>;
-};
-/**
- * 等待交易上链（不使用 club48 客户端）
- */
-export type FourProviderBundleWaitStatus = {
-    status: 'INCLUDED';
-    includedBlock?: number;
-} | {
-    status: 'FAILED';
-} | {
-    status: 'PENDING';
-};
-export declare function waitForBundleWithProvider(provider: JsonRpcProvider, firstTxSigned: string, _bundleUuid: string): Promise<FourProviderBundleWaitStatus>;
-/**
- * 估算 gas 并应用用户配置的倍数
- */
-export declare function estimateGasWithMultiplier(provider: JsonRpcProvider, txRequest: TransactionRequest, multiplier?: number): Promise<bigint>;
-/**
- * 获取交易类型（用户可配置）
- */
-export declare function getTxType(config: FourBundleConfig): 0 | 2;
-/**
- * 构建完整的交易请求（包含 gas 估算和交易类型）
- */
-export declare function buildTxRequest(provider: JsonRpcProvider, unsigned: TransactionRequest, from: string, nonce: number, gasPrice: bigint, config: FourBundleConfig, value?: bigint): Promise<TransactionRequest & {
-    gasLimit: bigint;
-    chainId: number;
-    type: 0 | 2;
-}>;
-export type FourCreateWithBundleBuyParams = {
-    privateKeys: string[];
-    buyAmounts: string[];
-    b0Amount?: string;
-    tokenInfo: {
-        name: string;
-        symbol: string;
-        description: string;
-        imageUrl?: string;
-        imageFile?: Blob;
-        label?: 'Meme' | 'AI' | 'Defi' | 'Games' | 'Infra' | 'De-Sci' | 'Social' | 'Depin' | 'Charity' | 'Others';
-        preSale?: string;
-        webUrl?: string;
-        twitterUrl?: string;
-        telegramUrl?: string;
-    };
-    config: FourBundleConfig;
-};
-export type FourCreateWithBundleBuyResult = {
-    bundleUuid: string;
-    tokenAddress?: string;
-    status: BundleStatus | FourProviderBundleWaitStatus;
-    createTx: string;
-    buyTxs: string[];
-    profitTxs: string[];
-    profitHopWallets?: GeneratedWallet[];
-};
-/**
- * four.meme: 创建代币 + 捆绑购买
- *
- * 用户只需传入：
- * - dev 私钥 + N 个买家私钥
- * - 对应的购买金额
- * - 代币基本信息
- */

package/dist/contracts/tm-bundle-helpers.js

@@ -1,72 +0,0 @@
-import { ethers } from 'ethers';
-/**
- * four.meme Bundle 交易方法
- * 使用 48.club Bundle 服务实现原子化交易
- */
-// 错误信息国际化（实现见 bundle-core/errors）
-export { BUNDLE_ERRORS as ERRORS, getBundleErrorMessage as getErrorMessage } from '../bundle-core/errors.js';
-export async function waitForBundleWithProvider(provider, firstTxSigned, _bundleUuid) {
-    const maxAttempts = 60; // 最多等待 60 秒
-    for (let i = 0; i < maxAttempts; i++) {
-        await new Promise((resolve) => setTimeout(resolve, 1000));
-        try {
-            const txHash = ethers.Transaction.from(firstTxSigned).hash;
-            if (!txHash)
-                continue;
-            const receipt = await provider.getTransactionReceipt(txHash);
-            if (receipt) {
-                if (receipt.status === 1) {
-                    return { status: 'INCLUDED', includedBlock: receipt.blockNumber };
-                }
-                else {
-                    return { status: 'FAILED' };
-                }
-            }
-        }
-        catch (_error) {
-            // 继续等待
-        }
-    }
-    return { status: 'PENDING' };
-}
-// ========================================
-// 辅助函数：估算 gas 并应用配置
-// ========================================
-/**
- * 估算 gas 并应用用户配置的倍数
- */
-export async function estimateGasWithMultiplier(provider, txRequest, multiplier) {
-    const estimated = await provider.estimateGas(txRequest);
-    const mult = multiplier ?? 1.2; // 默认 20% 安全余量
-    return BigInt(Math.ceil(Number(estimated) * mult));
-}
-/**
- * 获取交易类型（用户可配置）
- */
-export function getTxType(config) {
-    return config.txType ?? 0; // 默认 Legacy (type 0)，适用于 48.club/BSC
-}
-/**
- * 构建完整的交易请求（包含 gas 估算和交易类型）
- */
-export async function buildTxRequest(provider, unsigned, from, nonce, gasPrice, config, value) {
-    const gasLimit = await estimateGasWithMultiplier(provider, { ...unsigned, from, value }, config.gasLimitMultiplier);
-    const txType = getTxType(config);
-    return {
-        ...unsigned,
-        from,
-        nonce,
-        gasLimit,
-        gasPrice,
-        chainId: 56,
-        type: txType,
-    };
-}
-/**
- * four.meme: 创建代币 + 捆绑购买
- *
- * 用户只需传入：
- * - dev 私钥 + N 个买家私钥
- * - 对应的购买金额
- * - 代币基本信息
- */

package/dist/contracts/tm-bundle-merkle/utils-disperse.d.ts

@@ -1 +0,0 @@
-export { disperseWithBundleMerkle } from '../../bundle-core/four-meme/utils-disperse.js';

package/dist/contracts/tm-bundle-merkle/utils-disperse.js

@@ -1 +0,0 @@
-export { disperseWithBundleMerkle } from '../../bundle-core/four-meme/utils-disperse.js';

package/dist/contracts/tm-bundle-merkle/utils-pairwise.d.ts

@@ -1 +0,0 @@
-export { pairwiseTransferWithBundleMerkle } from '../../bundle-core/four-meme/utils-pairwise.js';

package/dist/contracts/tm-bundle-merkle/utils-pairwise.js

@@ -1 +0,0 @@
-export { pairwiseTransferWithBundleMerkle } from '../../bundle-core/four-meme/utils-pairwise.js';

package/dist/contracts/tm-bundle-merkle/utils-sweep.d.ts

@@ -1 +0,0 @@
-export { sweepWithBundleMerkle } from '../../bundle-core/four-meme/utils-sweep.js';

package/dist/contracts/tm-bundle-merkle/utils-sweep.js

@@ -1 +0,0 @@
-export { sweepWithBundleMerkle } from '../../bundle-core/four-meme/utils-sweep.js';