four-flap-meme-sdk 1.9.49 → 2.1.0

package/dist/utils/hop-chains.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 多跳（Hop Chain）转账链生成工具
+ *
+ * 提取自 chains/bsc/four/swap.ts、chains/bsc/pancake/bundle-swap.ts、shared/flap/portal-bundle-merkle/swap.ts
+ * 消除三个文件之间的复制代码
+ */
+import { ethers, Wallet, JsonRpcProvider } from 'ethers';
+import type { DisperseHopPath } from './types/hop-chains.js';
+export type { DisperseHopPath } from './types/hop-chains.js';
+export declare const NATIVE_TRANSFER_GAS_LIMIT: 21055n;
+export declare const ERC20_TRANSFER_GAS_LIMIT_HOP: 65000n;
+export declare const BRIBE_GAS_LIMIT: 21000n;
+/**
+
+/**
+ * 给交易对象附加 gasPrice/maxFeePerGas（根据 txType）
+ * 消除 `if (txType === 2) { ... } else { ... }` 手写重复
+ */
+export declare function applyTxTypeGas(tx: ethers.TransactionLike, gasPrice: bigint, txType: 0 | 2): void;
+/**
+ * 生成分发多跳路径
+ */
+export declare function generateDisperseHopPaths(targetAddresses: string[], hopCount: number, provider: JsonRpcProvider): DisperseHopPath[];
+/**
+ * 构建原生代币多跳转账链
+ */
+export declare function buildNativeHopChain(payer: Wallet, path: DisperseHopPath, finalAmount: bigint, gasPrice: bigint, chainId: number, txType: 0 | 2, payerNonce: number): Promise<string[]>;
+/**
+ * 构建 ERC20 多跳转账链（需要配合 BNB 多跳使用）
+ */
+export declare function buildERC20HopChain(payer: Wallet, path: DisperseHopPath, erc20Address: string, erc20Amount: bigint, gasPrice: bigint, chainId: number, txType: 0 | 2, payerNonce: number): Promise<string[]>;
+/**
+ * 构建 BNB 多跳转账链（为 ERC20 中间钱包预留 gas）
+ */
+export declare function buildBNBHopChainForERC20(payer: Wallet, path: DisperseHopPath, finalGasAmount: bigint, gasPrice: bigint, chainId: number, txType: 0 | 2, payerNonce: number): Promise<string[]>;

package/dist/utils/hop-chains.js

@@ -0,0 +1,215 @@
+/**
+ * 多跳（Hop Chain）转账链生成工具
+ *
+ * 提取自 chains/bsc/four/swap.ts、chains/bsc/pancake/bundle-swap.ts、shared/flap/portal-bundle-merkle/swap.ts
+ * 消除三个文件之间的复制代码
+ */
+import { ethers, Wallet } from 'ethers';
+import { GAS_LIMITS } from '../shared/constants/index.js';
+import { ERC20_ABI } from '../abis/common.js';
+import { generateWallets } from './wallet.js';
+export const NATIVE_TRANSFER_GAS_LIMIT = GAS_LIMITS.NATIVE_TRANSFER;
+export const ERC20_TRANSFER_GAS_LIMIT_HOP = GAS_LIMITS.ERC20_TRANSFER;
+export const BRIBE_GAS_LIMIT = GAS_LIMITS.BRIBE;
+/**
+
+/**
+ * 给交易对象附加 gasPrice/maxFeePerGas（根据 txType）
+ * 消除 `if (txType === 2) { ... } else { ... }` 手写重复
+ */
+export function applyTxTypeGas(tx, gasPrice, txType) {
+    if (txType === 2) {
+        tx.maxFeePerGas = gasPrice;
+        tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+    }
+    else {
+        tx.gasPrice = gasPrice;
+    }
+}
+// ============================================================================
+// 生成多跳路径
+// ============================================================================
+/**
+ * 生成分发多跳路径
+ */
+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, chainId, 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,
+            type: txType,
+        };
+        applyTxTypeGas(tx, gasPrice, txType);
+        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,
+        type: txType,
+    };
+    applyTxTypeGas(firstTx, gasPrice, txType);
+    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,
+            type: txType,
+        };
+        applyTxTypeGas(tx, gasPrice, txType);
+        signedTxs.push(await fromWallet.signTransaction(tx));
+    }
+    return signedTxs;
+}
+// ============================================================================
+// ERC20 多跳
+// ============================================================================
+/**
+ * 构建 ERC20 多跳转账链（需要配合 BNB 多跳使用）
+ */
+export async function buildERC20HopChain(payer, path, erc20Address, erc20Amount, gasPrice, chainId, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    const erc20Interface = new ethers.Interface(ERC20_ABI);
+    if (hopCount === 0) {
+        const data = erc20Interface.encodeFunctionData('transfer', [path.targetAddress, erc20Amount]);
+        const tx = {
+            to: erc20Address,
+            data,
+            value: 0n,
+            nonce: payerNonce,
+            gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+            chainId,
+            type: txType,
+        };
+        applyTxTypeGas(tx, gasPrice, txType);
+        signedTxs.push(await payer.signTransaction(tx));
+        return signedTxs;
+    }
+    // payer → hop1
+    const firstData = erc20Interface.encodeFunctionData('transfer', [path.hopWallets[0].address, erc20Amount]);
+    const firstTx = {
+        to: erc20Address,
+        data: firstData,
+        value: 0n,
+        nonce: payerNonce,
+        gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+        chainId,
+        type: txType,
+    };
+    applyTxTypeGas(firstTx, gasPrice, txType);
+    signedTxs.push(await payer.signTransaction(firstTx));
+    // hop1 → hop2 → ... → target (nonce=1，nonce=0 用于 BNB 转发)
+    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 data = erc20Interface.encodeFunctionData('transfer', [toAddress, erc20Amount]);
+        const tx = {
+            to: erc20Address,
+            data,
+            value: 0n,
+            nonce: 1, // nonce=0 已用于 BNB 转发
+            gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+            chainId,
+            type: txType,
+        };
+        applyTxTypeGas(tx, gasPrice, txType);
+        signedTxs.push(await fromWallet.signTransaction(tx));
+    }
+    return signedTxs;
+}
+// ============================================================================
+// BNB 多跳（为 ERC20 中间钱包预留 Gas）
+// ============================================================================
+/**
+ * 构建 BNB 多跳转账链（为 ERC20 中间钱包预留 gas）
+ */
+export async function buildBNBHopChainForERC20(payer, path, finalGasAmount, gasPrice, chainId, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    if (hopCount === 0) {
+        // 无多跳时不需要转 gas
+        return signedTxs;
+    }
+    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
+    const erc20GasCost = ERC20_TRANSFER_GAS_LIMIT_HOP * gasPrice;
+    // 每个中间钱包需要: BNB 转发 gas + ERC20 转发 gas
+    const gasPerHop = hopGasCost + erc20GasCost * 2n; // 2倍安全系数
+    // 计算每跳需要的金额
+    const amountsPerHop = [];
+    for (let i = 0; i < hopCount; i++) {
+        const remainingHops = hopCount - i;
+        amountsPerHop.push(finalGasAmount + gasPerHop * BigInt(remainingHops));
+    }
+    // payer → hop1
+    const firstTx = {
+        to: path.hopWallets[0].address,
+        value: amountsPerHop[0],
+        nonce: payerNonce,
+        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+        chainId,
+        type: txType,
+    };
+    applyTxTypeGas(firstTx, gasPrice, txType);
+    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 ? finalGasAmount : amountsPerHop[i + 1];
+        const tx = {
+            to: toAddress,
+            value: amount,
+            nonce: 1, // nonce=0 已用于 ERC20 转发
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            chainId,
+            type: txType,
+        };
+        applyTxTypeGas(tx, gasPrice, txType);
+        signedTxs.push(await fromWallet.signTransaction(tx));
+    }
+    return signedTxs;
+}

package/dist/utils/lp-inspect-helpers.d.ts

@@ -0,0 +1,9 @@
+export declare const DEFAULT_V3_FEE_TIERS: number[];
+import type { ChainDexConfig } from '../shared/foundation/types/lp-inspect.js';
+export declare const CHAIN_DEX_CONFIGS: Record<string, ChainDexConfig>;
+/** 运行时配置存储（内存） */
+export declare const runtimeConfigs: Record<string, ChainDexConfig>;
+/**
+ * 从 Router 合约获取 Factory 地址
+ * 支持 Uniswap V2 Router 和 V3 SwapRouter02
+ */

package/dist/utils/lp-inspect-helpers.js

@@ -0,0 +1,109 @@
+export const DEFAULT_V3_FEE_TIERS = [100, 500, 2500, 3000, 10000];
+import { ADDRESSES } from '../shared/constants/index.js';
+export const CHAIN_DEX_CONFIGS = {
+    BSC: {
+        wrappedNative: '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c',
+        wrappedNativeSymbol: 'WBNB',
+        stableCoins: [
+            { address: '0x55d398326f99059fF775485246999027B3197955', symbol: 'USDT', decimals: 18 },
+            { address: '0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d', symbol: 'USDC', decimals: 18 },
+        ],
+        dexes: {
+            PANCAKESWAP: {
+                name: 'PancakeSwap',
+                v2Factory: '0xcA143Ce32Fe78f1f7019d7d551a6402fC5350c73',
+                v3Factory: '0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865',
+                enabled: true,
+            },
+            IROSWAP: {
+                name: 'IROSwap',
+                v2Factory: ADDRESSES.BSC.IroSwapV2Factory,
+                v2Router: ADDRESSES.BSC.IroSwapV2Router,
+                enabled: true,
+            },
+        },
+    },
+    MONAD: {
+        wrappedNative: '0x3bd359c1119da7da1d913d1c4d2b7c461115433a',
+        wrappedNativeSymbol: 'WMON',
+        stableCoins: [{ address: '0x754704bc059f8c67012fed69bc8a327a5aafb603', symbol: 'USDC', decimals: 6 }],
+        dexes: {
+            PANCAKESWAP: {
+                name: 'PancakeSwap',
+                v2Factory: '0x44c90b66eb4c4f814cea6aaf2ac71ca88fa77308',
+                v3Factory: '0x40ce898c43df68c8c4229cd5ce21d3ce1f3ddcf1',
+                enabled: true,
+            },
+            UNISWAP: {
+                name: 'Uniswap',
+                v2Factory: '0x182a927119d56008d921126764bf884221b10f59',
+                v3Factory: '0x204faca1764b154221e35c0d20abb3c525710498',
+                v2Router: '0x4b2ab38dbf28d31d467aa8993f6c2585981d6804',
+                v3Router: '0xd6145b2d3f379919e8cdeda7b97e37c4b2ca9c40',
+                quoterV2: '0x661e93cca42afacb172121ef892830ca3b70f08d',
+                enabled: true,
+            },
+        },
+    },
+    // ✅ 新增 XLayer 配置
+    XLAYER: {
+        wrappedNative: '0xe538905cf8410324e03a5a23c1c177a474d59b2b',
+        wrappedNativeSymbol: 'WOKB',
+        stableCoins: [
+            { address: '0x1e4a5963abfd975d8c9021ce480b42188849d41d', symbol: 'USDT', decimals: 6 },
+            { address: '0x74b7f16337b8972027f6196a17a631ac6de26d22', symbol: 'USDC', decimals: 6 },
+            // ✅ XLayer: USD₮0 / USDT0（常见外盘配对）
+            { address: '0x779ded0c9e1022225f8e0630b35a9b54be713736', symbol: 'USDT0', decimals: 6 },
+        ],
+        dexes: {
+            POTATOSWAP: {
+                name: 'PotatoSwap',
+                v2Factory: '0x630DB8E822805c82Ca40a54daE02dd5aC31f7fcF', // V2 Factory
+                v2Router: '0x881fb2f98c13d521009464e7d1cbf16e1b394e8e', // ✅ V2 Router (标准 Uniswap V2 风格)
+                v3Router: '0xB45D0149249488333E3F3f9F359807F4b810C1FC', // SwapRouter02 (V3 风格)
+                v3Factory: '0xa1415fAe79c4B196d087F02b8aD5a622B8A827E5', // V3 Factory
+                quoterV2: '0x5A6f3723346aF54a4D0693bfC1718D64d4915C3e', // QuoterV2
+                enabled: true,
+            },
+            DYORSWAP: {
+                name: 'DYORSwap',
+                v2Factory: '0x2CcaDb1e437AA9cDc741574bDa154686B1F04C09', // ✅ V2 Factory
+                v2Router: '0xfb001fbbace32f09cb6d3c449b935183de53ee96', // DYORSwap Router (SwapRouter02 风格)
+                enabled: true, // ✅ 已启用
+            },
+        },
+    },
+    ENI: {
+        wrappedNative: '0x6d1e851446f4d004ae2a72f9afed85e8829a205e',
+        wrappedNativeSymbol: 'WEGAS',
+        stableCoins: [
+            { address: '0xDC1a8A35b0BaA3229b13f348ED708a2fd50b5e3a', symbol: 'USDT', decimals: 18 },
+            { address: '0xaFF944b96c1BAEA587159ec446280E468B32ee15', symbol: 'USDC', decimals: 18 },
+        ],
+        dexes: {
+            DSWAP: {
+                name: 'DSWAP',
+                v2Factory: '0x548c0e26ce90b333c07abb6d55546304d46d269d',
+                v2Router: '0x97ed8be49d9a8b86247090aa41e908e76b8fcf22',
+                v3Factory: '0xa97c5a70Be5B81f573a688F656E7bE569B492A56',
+                v3Router: '0xcdE487F5B460a516f31FaC520D4e18BA1C8cda49',
+                enabled: true,
+            },
+            IROSWAP: {
+                name: 'IROSwap',
+                v2Factory: ADDRESSES.ENI.IroSwapV2Factory,
+                v2Router: ADDRESSES.ENI.IroSwapV2Router,
+                enabled: true,
+            },
+        },
+    },
+};
+// ============================================================================
+// 动态配置 API
+// ============================================================================
+/** 运行时配置存储（内存） */
+export const runtimeConfigs = {};
+/**
+ * 从 Router 合约获取 Factory 地址
+ * 支持 Uniswap V2 Router 和 V3 SwapRouter02
+ */

package/dist/utils/lp-inspect.d.ts

@@ -1,115 +1,4 @@
-import { type FlapChain } from '../shared/flap/portal.js';
-/** DEX 配置 */
-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;
-}
-/** V3 池子信息（带 fee） */
-export interface V3PoolInfo extends PoolPairInfo {
-    fee: number;
-}
-/** DEX 池子信息 */
-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;
-}
-/** LP 平台类型 */
-export type LPPlatform = 'FOUR' | 'FLAP' | 'DAOAAS' | 'PANCAKESWAP_V2' | 'PANCAKESWAP_V3' | 'UNISWAP_V2' | 'UNISWAP_V3' | 'IROSWAP_V2' | 'MULTI_DEX' | 'UNKNOWN';
-/** LP 信息返回类型 */
-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;
-}
-/**
- * 从 Router 合约获取 Factory 地址
- * 支持 Uniswap V2 Router 和 V3 SwapRouter02
- */
+import type { ChainDexConfig, DexConfig, InspectOptions, LPInfo } from './types/lp-inspect.js';
 export declare function getFactoryFromRouter(routerAddress: string, rpcUrl: string, routerType?: 'v2' | 'v3'): Promise<{
     v2Factory?: string;
     v3Factory?: string;
@@ -148,3 +37,4 @@ export declare function getQuoteTokens(chain: string): Array<{
     isNative: boolean;
 }>;
 export declare function inspectTokenLP(token: string, opts: InspectOptions): Promise<LPInfo>;
+export type { LPInfo, LPPlatform, InspectOptions, DexConfig, ChainDexConfig } from './types/lp-inspect.js';