four-flap-meme-sdk 2.2.2 → 2.2.3

package/dist/shared/flap/vault.js

@@ -4,19 +4,16 @@
  * ⚠️ 重要：基于 flap.sh/launch 实际源码分析，金库模式架构如下：
  *
  * 1. 金库代币通过 VaultPortal 合约创建（不是普通 Portal）
- * 2. 调用函数：VaultPortal.newTokenV6WithVault(params) + tokenVersion = TOKEN_TAXED_V3
+ * 2. 调用函数：VaultPortal.newTaxTokenWithVault(params)
  * 3. 参数中 extensionID/extensionData 始终为零值
  * 4. 真正的金库配置通过 vaultFactory（工厂地址）和 vaultData（ABI 编码数据）传递
  * 5. 每种金库类型对应一个具体的 VaultFactory 合约地址
  *
- * ⚠️ newTaxTokenWithVault 已在链上废弃并始终 revert，请勿再使用。
- *
- * VaultPortal.newTokenV6WithVault 参数结构：
- *   - 基础参数（与 Portal.newTokenV6 相同，无 beneficiary）：name, symbol, meta, dexThresh, salt,
+ * VaultPortal.newTaxTokenWithVault 参数结构：
+ *   - 基础参数（与 Portal.newTokenV5 相同）：name, symbol, meta, dexThresh, salt, taxRate,
  *     migratorType, quoteToken, quoteAmt, permitData, extensionID(全零), extensionData("0x"),
- *     dexId, lpFeeProfile, buyTaxRate, sellTaxRate, taxDuration, antiFarmerDuration,
- *     mktBps, deflationBps, dividendBps, lpBps, minimumShareBalance, dividendToken,
- *     commissionReceiver, tokenVersion(=TOKEN_TAXED_V3)
+ *     dexId, lpFeeProfile, taxDuration, antiFarmerDuration, mktBps, deflationBps, dividendBps,
+ *     lpBps, minimumShareBalance
  *   - 金库专属参数：vaultFactory(address), vaultData(bytes)
  *
  * 金库分类（来自 flap.sh 源码）：
@@ -31,8 +28,32 @@
  * @module vault
  */
 import { Contract, AbiCoder, ZeroAddress } from 'ethers';
-import { TokenVersion } from './portal.js';
-import { getVanitySuffix } from './constants.js';
+function mapFieldDescriptor(f) {
+    return {
+        name: f.name,
+        fieldType: f.fieldType,
+        description: f.description,
+        decimals: Number(f.decimals),
+    };
+}
+function mapApproveAction(a) {
+    return {
+        tokenType: a.tokenType,
+        amountFieldName: a.amountFieldName,
+    };
+}
+function mapVaultMethodSchema(m) {
+    return {
+        name: m.name,
+        description: m.description,
+        inputs: m.inputs.map(mapFieldDescriptor),
+        outputs: m.outputs.map(mapFieldDescriptor),
+        approvals: m.approvals.map(mapApproveAction),
+        isInputArray: m.isInputArray,
+        isOutputArray: m.isOutputArray,
+        isWriteMethod: m.isWriteMethod,
+    };
+}
 /**
  * 金库类型显示标签
  */
@@ -110,28 +131,28 @@ export const FLAP_GUARDIAN_ADDRESSES = {
 // ============================================================================
 // ABI 定义
 // ============================================================================
-/** VaultPortal 金库发射必须使用 TOKEN_TAXED_V3（enum = 6） */
-export const TOKEN_TAXED_V3_VERSION = TokenVersion.TOKEN_TAXED_V3;
 /**
- * VaultPortal ABI — newTokenV6WithVault（当前唯一支持的金库发射入口）
+ * VaultPortal ABI — newTaxTokenWithVault
  *
- * 来源：Flap 官方 VaultPortal 文档
- * https://docs.flap.sh/flap/developers/token-launcher-developers/launch-token-through-vaultportal
+ * ⚠️ 从 flap.sh 前端 JS 源码提取的真实 ABI
+ * 来源：flap.sh/_next/static/chunks/6288-*.js（VaultPortal 合约 ABI）
  */
 export const VAULT_PORTAL_ABI = [
     {
         type: 'function',
-        name: 'newTokenV6WithVault',
-        inputs: [{
+        name: 'newTaxTokenWithVault',
+        inputs: [
+            {
                 name: 'params',
                 type: 'tuple',
-                internalType: 'struct IVaultPortalTypes.NewTokenV6WithVaultParams',
+                internalType: 'struct IVaultPortalTypes.NewTaxTokenWithVaultParams',
                 components: [
                     { name: 'name', type: 'string', internalType: 'string' },
                     { name: 'symbol', type: 'string', internalType: 'string' },
                     { name: 'meta', type: 'string', internalType: 'string' },
-                    { name: 'dexThresh', type: 'uint8', internalType: 'enum IPortalTypes.DexThreshType' },
+                    { name: 'dexThresh', type: 'uint8', internalType: 'enum IPortalCommonTypes.DexThreshType' },
                     { name: 'salt', type: 'bytes32', internalType: 'bytes32' },
+                    { name: 'taxRate', type: 'uint16', internalType: 'uint16' },
                     { name: 'migratorType', type: 'uint8', internalType: 'enum IPortalTypes.MigratorType' },
                     { name: 'quoteToken', type: 'address', internalType: 'address' },
                     { name: 'quoteAmt', type: 'uint256', internalType: 'uint256' },
@@ -140,8 +161,6 @@ export const VAULT_PORTAL_ABI = [
                     { name: 'extensionData', type: 'bytes', internalType: 'bytes' },
                     { name: 'dexId', type: 'uint8', internalType: 'enum IPortalTypes.DEXId' },
                     { name: 'lpFeeProfile', type: 'uint8', internalType: 'enum IPortalTypes.V3LPFeeProfile' },
-                    { name: 'buyTaxRate', type: 'uint16', internalType: 'uint16' },
-                    { name: 'sellTaxRate', type: 'uint16', internalType: 'uint16' },
                     { name: 'taxDuration', type: 'uint64', internalType: 'uint64' },
                     { name: 'antiFarmerDuration', type: 'uint64', internalType: 'uint64' },
                     { name: 'mktBps', type: 'uint16', internalType: 'uint16' },
@@ -149,13 +168,11 @@ export const VAULT_PORTAL_ABI = [
                     { name: 'dividendBps', type: 'uint16', internalType: 'uint16' },
                     { name: 'lpBps', type: 'uint16', internalType: 'uint16' },
                     { name: 'minimumShareBalance', type: 'uint256', internalType: 'uint256' },
-                    { name: 'dividendToken', type: 'address', internalType: 'address' },
-                    { name: 'commissionReceiver', type: 'address', internalType: 'address' },
-                    { name: 'tokenVersion', type: 'uint8', internalType: 'enum IPortalTypes.TokenVersion' },
                     { name: 'vaultFactory', type: 'address', internalType: 'address' },
                     { name: 'vaultData', type: 'bytes', internalType: 'bytes' },
-                ]
-            }],
+                ],
+            },
+        ],
         outputs: [{ name: 'token', type: 'address', internalType: 'address' }],
         stateMutability: 'payable',
     },
@@ -163,7 +180,8 @@ export const VAULT_PORTAL_ABI = [
         type: 'function',
         name: 'getVault',
         inputs: [{ name: 'taxToken', type: 'address', internalType: 'address' }],
-        outputs: [{
+        outputs: [
+            {
                 name: 'info',
                 type: 'tuple',
                 internalType: 'struct IVaultPortalTypes.VaultInfo',
@@ -173,8 +191,9 @@ export const VAULT_PORTAL_ABI = [
                     { name: 'description', type: 'string', internalType: 'string' },
                     { name: 'isOfficial', type: 'bool', internalType: 'bool' },
                     { name: 'riskLevel', type: 'uint8', internalType: 'enum IVaultPortalTypes.RiskLevel' },
-                ]
-            }],
+                ],
+            },
+        ],
         stateMutability: 'view',
     },
     {
@@ -201,9 +220,7 @@ export const VAULT_FACTORY_V2_ABI = [
 /**
  * VaultBase ABI（V1）
  */
-export const VAULT_BASE_ABI = [
-    'function description() public view returns (string)',
-];
+export const VAULT_BASE_ABI = ['function description() public view returns (string)'];
 /**
  * VaultBaseV2 ABI
  */
@@ -252,16 +269,21 @@ function mapFieldTypeToAbiType(fieldType) {
 function processFieldValue(field, rawValue) {
     if (rawValue === undefined || rawValue === null) {
         switch (field.fieldType) {
-            case 'address': return ZeroAddress;
-            case 'bool': return false;
-            case 'string': return '';
+            case 'address':
+                return ZeroAddress;
+            case 'bool':
+                return false;
+            case 'string':
+                return '';
             case 'bytes':
-            case 'bytes32': return '0x' + '00'.repeat(32);
-            default: return 0;
+            case 'bytes32':
+                return '0x' + '00'.repeat(32);
+            default:
+                return 0;
         }
     }
     if (field.decimals > 0 && typeof rawValue === 'number') {
-        return BigInt(Math.round(rawValue * (10 ** field.decimals)));
+        return BigInt(Math.round(rawValue * 10 ** field.decimals));
     }
     if (field.fieldType === 'bool') {
         return Boolean(rawValue);
@@ -286,7 +308,7 @@ export function getVaultPortalAddress(chain) {
     return VAULT_PORTAL_ADDRESSES[chainKey] || null;
 }
 /**
- * 构建金库参数（用于 VaultPortal.newTokenV6WithVault）
+ * 构建金库参数（用于 VaultPortal.newTaxTokenWithVault）
  *
  * ⚠️ 重要：返回的是 vaultFactory 和 vaultData，不是 extensionID/extensionData
  * extensionID/extensionData 在金库模式下始终为零值
@@ -332,82 +354,6 @@ export function buildVaultParams(config, chain) {
     }
     return { vaultFactory, vaultData };
 }
-function normalizeTaxV2Fields(taxV2) {
-    if ('distribution' in taxV2) {
-        return {
-            taxDuration: taxV2.taxDuration,
-            antiFarmerDuration: taxV2.antiFarmerDuration,
-            mktBps: taxV2.distribution.mktBps,
-            deflationBps: taxV2.distribution.deflationBps,
-            dividendBps: taxV2.distribution.dividendBps,
-            lpBps: taxV2.distribution.lpBps,
-            minimumShareBalance: taxV2.distribution.minimumShareBalance,
-            vaultConfig: taxV2.vaultConfig,
-        };
-    }
-    return taxV2;
-}
-/**
- * 构建 VaultPortal.newTokenV6WithVault 参数
- *
- * ⚠️ tokenVersion 固定为 TOKEN_TAXED_V3；buyTaxRate/sellTaxRate 必须 > 0
- */
-export function buildNewTokenV6WithVaultParams(input) {
-    const tv2 = normalizeTaxV2Fields(input.taxV2);
-    const total = tv2.mktBps + tv2.deflationBps + tv2.dividendBps + tv2.lpBps;
-    if (total !== 10000) {
-        throw new Error(`Tax distribution must sum to 10000 (100%), got ${total}`);
-    }
-    if (tv2.mktBps <= 0) {
-        throw new Error('Vault launch requires mktBps > 0');
-    }
-    const buyTaxRate = (input.buyTaxRate ?? input.taxRate) & 0xffff;
-    const sellTaxRate = (input.sellTaxRate ?? input.taxRate) & 0xffff;
-    if (buyTaxRate <= 0 || sellTaxRate <= 0) {
-        throw new Error('Vault launch requires buyTaxRate and sellTaxRate > 0');
-    }
-    const { vaultFactory, vaultData } = buildVaultParams(tv2.vaultConfig, input.chain);
-    return {
-        name: input.tokenInfo.name,
-        symbol: input.tokenInfo.symbol,
-        meta: input.tokenInfo.meta,
-        dexThresh: (input.dexThresh ?? 1) & 0xff,
-        salt: input.salt ?? ('0x' + '00'.repeat(32)),
-        migratorType: (input.migratorType ?? 0) & 0xff,
-        quoteToken: input.quoteToken || ZeroAddress,
-        quoteAmt: input.quoteAmt ?? 0n,
-        permitData: '0x',
-        extensionID: NONE_EXTENSION_ID,
-        extensionData: '0x',
-        dexId: (input.dexId ?? 0) & 0xff,
-        lpFeeProfile: (input.lpFeeProfile ?? 0) & 0xff,
-        buyTaxRate,
-        sellTaxRate,
-        taxDuration: BigInt(tv2.taxDuration),
-        antiFarmerDuration: BigInt(tv2.antiFarmerDuration),
-        mktBps: tv2.mktBps & 0xffff,
-        deflationBps: tv2.deflationBps & 0xffff,
-        dividendBps: tv2.dividendBps & 0xffff,
-        lpBps: tv2.lpBps & 0xffff,
-        minimumShareBalance: BigInt(tv2.minimumShareBalance ?? 10000) * (10n ** 18n),
-        dividendToken: ZeroAddress,
-        commissionReceiver: ZeroAddress,
-        tokenVersion: TOKEN_TAXED_V3_VERSION,
-        vaultFactory,
-        vaultData,
-    };
-}
-/**
- * 金库发射 Vanity 地址搜索参数
- * TOKEN_TAXED_V3 使用 tokenImplTaxedV3 + 后缀 7777
- */
-export function getVaultLaunchVanityOptions(chain) {
-    return {
-        taxed: true,
-        taxedV3: true,
-        suffix: getVanitySuffix(chain, true),
-    };
-}
 /**
  * 旧版兼容：将 TaxVaultConfig 转换为 extensionID 和 extensionData
  *
@@ -415,7 +361,7 @@ export function getVaultLaunchVanityOptions(chain) {
  * 金库参数通过 VaultPortal 的 vaultFactory/vaultData 传递
  * 此函数仅用于向后兼容
  */
-export function buildVaultExtensionParams(config) {
+export function buildVaultExtensionParams() {
     // 金库模式下 extensionID/extensionData 始终为零值
     return {
         extensionID: NONE_EXTENSION_ID,
@@ -431,15 +377,10 @@ export function buildVaultExtensionParams(config) {
 export async function queryVaultDataSchema(provider, factoryAddress) {
     try {
         const factory = new Contract(factoryAddress, VAULT_FACTORY_V2_ABI, provider);
-        const raw = await factory.vaultDataSchema();
+        const raw = (await factory.vaultDataSchema());
         return {
             description: raw.description,
-            fields: raw.fields.map((f) => ({
-                name: f.name,
-                fieldType: f.fieldType,
-                description: f.description,
-                decimals: Number(f.decimals),
-            })),
+            fields: raw.fields.map(mapFieldDescriptor),
             isArray: raw.isArray,
         };
     }
@@ -453,33 +394,11 @@ export async function queryVaultDataSchema(provider, factoryAddress) {
 export async function queryVaultUISchema(provider, vaultAddress) {
     try {
         const vault = new Contract(vaultAddress, VAULT_BASE_V2_ABI, provider);
-        const raw = await vault.vaultUISchema();
+        const raw = (await vault.vaultUISchema());
         return {
             vaultType: raw.vaultType,
             description: raw.description,
-            methods: raw.methods.map((m) => ({
-                name: m.name,
-                description: m.description,
-                inputs: m.inputs.map((f) => ({
-                    name: f.name,
-                    fieldType: f.fieldType,
-                    description: f.description,
-                    decimals: Number(f.decimals),
-                })),
-                outputs: m.outputs.map((f) => ({
-                    name: f.name,
-                    fieldType: f.fieldType,
-                    description: f.description,
-                    decimals: Number(f.decimals),
-                })),
-                approvals: m.approvals.map((a) => ({
-                    tokenType: a.tokenType,
-                    amountFieldName: a.amountFieldName,
-                })),
-                isInputArray: m.isInputArray,
-                isOutputArray: m.isOutputArray,
-                isWriteMethod: m.isWriteMethod,
-            })),
+            methods: raw.methods.map(mapVaultMethodSchema),
         };
     }
     catch {
@@ -524,7 +443,7 @@ export async function validateVaultFactory(provider, factoryAddress) {
 export async function getVaultInfo(provider, vaultPortalAddress, taxTokenAddress) {
     try {
         const portal = new Contract(vaultPortalAddress, VAULT_PORTAL_ABI, provider);
-        const info = await portal.getVault(taxTokenAddress);
+        const info = (await portal.getVault(taxTokenAddress));
         return {
             vault: info.vault,
             vaultFactory: info.vaultFactory,

package/dist/shared/foundation/dex/v3-path.d.ts

@@ -0,0 +1,6 @@
+export declare function getDeadline(minutes?: number): number;
+export declare function encodeV3Path(tokens: string[], fees: number[]): string;
+export declare function decodeV3Path(path: string): {
+    tokens: string[];
+    fees: number[];
+};

package/dist/shared/foundation/dex/v3-path.js

@@ -0,0 +1,35 @@
+import { GAS_CONFIG } from '../../constants/gas.js';
+export function getDeadline(minutes = GAS_CONFIG.DEFAULT_DEADLINE_MINUTES) {
+    return Math.floor(Date.now() / 1000) + 60 * minutes;
+}
+export function encodeV3Path(tokens, fees) {
+    if (tokens.length < 2) {
+        throw new Error('V3 path 需要至少 2 个代币');
+    }
+    if (fees.length !== tokens.length - 1) {
+        throw new Error(`费率数量 (${fees.length}) 必须等于代币数量 - 1 (${tokens.length - 1})`);
+    }
+    let path = '0x';
+    for (let i = 0; i < tokens.length; i++) {
+        path += tokens[i].slice(2).toLowerCase().padStart(40, '0');
+        if (i < fees.length) {
+            path += fees[i].toString(16).padStart(6, '0');
+        }
+    }
+    return path;
+}
+export function decodeV3Path(path) {
+    const cleanPath = path.startsWith('0x') ? path.slice(2) : path;
+    const tokens = [];
+    const fees = [];
+    let offset = 0;
+    while (offset < cleanPath.length) {
+        tokens.push('0x' + cleanPath.slice(offset, offset + 40));
+        offset += 40;
+        if (offset < cleanPath.length) {
+            fees.push(parseInt(cleanPath.slice(offset, offset + 6), 16));
+            offset += 6;
+        }
+    }
+    return { tokens, fees };
+}

package/dist/shared/foundation/gas/bundle-gas.d.ts

@@ -0,0 +1,49 @@
+import { JsonRpcProvider, type TransactionRequest } from 'ethers';
+export interface GasPriceConfig {
+    baseGasPrice?: bigint;
+    multiplierPercent?: number;
+    minGasPrice?: bigint;
+    maxGasPrice?: bigint;
+}
+export declare function getOptimizedGasPrice(provider: JsonRpcProvider, config?: GasPriceConfig): Promise<bigint>;
+export interface GasEstimateConfig {
+    multiplier?: number;
+    fallbackGasLimit?: bigint;
+    allowFailure?: boolean;
+}
+export declare function estimateGasWithSafety(provider: JsonRpcProvider, txRequest: TransactionRequest, config?: GasEstimateConfig): Promise<bigint>;
+export declare function estimateGasBatch(provider: JsonRpcProvider, txRequests: TransactionRequest[], config?: GasEstimateConfig): Promise<bigint[]>;
+export interface BuildTransactionOptions {
+    from: string;
+    to?: string;
+    data?: string;
+    value?: bigint;
+    nonce: number;
+    gasPrice: bigint;
+    gasLimit: bigint;
+    chainId: number;
+    type?: 0 | 2;
+}
+export declare function buildTransaction(options: BuildTransactionOptions): TransactionRequest;
+export interface CommonBundleConfig {
+    gasLimit?: number;
+    gasLimitMultiplier?: number;
+    minGasPriceGwei?: number;
+    maxGasPriceGwei?: number;
+    txType?: 0 | 2;
+    chainId?: number;
+}
+export declare function getGasLimit(config: CommonBundleConfig, defaultGas?: number): bigint;
+export declare function getGasPriceConfig(config: CommonBundleConfig): GasPriceConfig;
+export declare function getTxType(config: CommonBundleConfig): 0 | 2;
+export type LegacyGasFields = {
+    type: 0;
+    gasPrice: bigint;
+};
+export type Eip1559GasFields = {
+    type: 2;
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+};
+export type TxGasFields = LegacyGasFields | Eip1559GasFields;
+export declare function buildGasFields(txType: number, gasPrice: bigint): TxGasFields;

package/dist/shared/foundation/gas/bundle-gas.js

@@ -0,0 +1,93 @@
+import { ethers } from 'ethers';
+export async function getOptimizedGasPrice(provider, config) {
+    const feeData = await provider.getFeeData();
+    const chainGasPrice = feeData.gasPrice || ethers.parseUnits('3', 'gwei');
+    let gasPrice;
+    if (config?.baseGasPrice) {
+        gasPrice = config.baseGasPrice;
+    }
+    else {
+        gasPrice = chainGasPrice;
+    }
+    const multiplier = config?.multiplierPercent ?? 50;
+    gasPrice = (gasPrice * BigInt(100 + multiplier)) / 100n;
+    if (gasPrice < chainGasPrice) {
+        gasPrice = chainGasPrice;
+    }
+    if (config?.minGasPrice && gasPrice < config.minGasPrice) {
+        gasPrice = config.minGasPrice;
+    }
+    if (config?.maxGasPrice && gasPrice > config.maxGasPrice) {
+        gasPrice = config.maxGasPrice;
+    }
+    return gasPrice;
+}
+export async function estimateGasWithSafety(provider, txRequest, config) {
+    const multiplier = config?.multiplier ?? 1.2;
+    const fallback = config?.fallbackGasLimit ?? 600000n;
+    const allowFailure = config?.allowFailure ?? true;
+    try {
+        const estimated = await provider.estimateGas(txRequest);
+        return BigInt(Math.ceil(Number(estimated) * multiplier));
+    }
+    catch (error) {
+        if (!allowFailure) {
+            throw error;
+        }
+        return fallback;
+    }
+}
+export async function estimateGasBatch(provider, txRequests, config) {
+    return Promise.all(txRequests.map((req) => estimateGasWithSafety(provider, req, config)));
+}
+export function buildTransaction(options) {
+    const tx = {
+        from: options.from,
+        nonce: options.nonce,
+        gasLimit: options.gasLimit,
+        chainId: options.chainId,
+    };
+    if (options.to)
+        tx.to = options.to;
+    if (options.data)
+        tx.data = options.data;
+    if (options.value)
+        tx.value = options.value;
+    if (options.type === 2) {
+        tx.type = 2;
+        tx.maxFeePerGas = options.gasPrice;
+        tx.maxPriorityFeePerGas = options.gasPrice / 10n;
+    }
+    else {
+        tx.type = 0;
+        tx.gasPrice = options.gasPrice;
+    }
+    return tx;
+}
+export function getGasLimit(config, defaultGas = 500000) {
+    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 function getGasPriceConfig(config) {
+    const gasPriceConfig = {};
+    if (config.minGasPriceGwei !== undefined) {
+        gasPriceConfig.baseGasPrice = ethers.parseUnits(String(config.minGasPriceGwei), 'gwei');
+        gasPriceConfig.multiplierPercent = 0;
+    }
+    if (config.maxGasPriceGwei !== undefined) {
+        gasPriceConfig.maxGasPrice = ethers.parseUnits(String(config.maxGasPriceGwei), 'gwei');
+    }
+    return gasPriceConfig;
+}
+export function getTxType(config) {
+    return config.txType ?? 0;
+}
+export function buildGasFields(txType, gasPrice) {
+    if (txType === 2) {
+        return { type: 2, maxFeePerGas: gasPrice, maxPriorityFeePerGas: gasPrice / 10n || 1n };
+    }
+    return { type: 0, gasPrice };
+}

package/dist/shared/foundation/gas/profit-hop.d.ts

@@ -0,0 +1,20 @@
+import { JsonRpcProvider, Wallet } from 'ethers';
+import { type GeneratedWallet } from '../../../utils/wallet.js';
+export interface ProfitHopConfig {
+    provider: JsonRpcProvider;
+    payerWallet: Wallet;
+    profitAmount: bigint;
+    profitRecipient: string;
+    hopCount?: number;
+    gasPrice: bigint;
+    chainId: number;
+    txType: number;
+    startNonce?: number;
+}
+export interface ProfitHopResult {
+    signedTransactions: string[];
+    hopWallets: GeneratedWallet[];
+    totalNonceUsed: number;
+}
+export declare const PROFIT_HOP_COUNT = 2;
+export declare function buildProfitHopTransactions(config: ProfitHopConfig): Promise<ProfitHopResult>;

package/dist/shared/foundation/gas/profit-hop.js

@@ -0,0 +1,72 @@
+import { Wallet } from 'ethers';
+import { generateWallets } from '../../../utils/wallet.js';
+import { GAS_LIMITS, CHAINS } from '../../constants/index.js';
+import { NonceManager } from '../nonce/nonce-manager.js';
+import { buildGasFields } from './bundle-gas.js';
+export const PROFIT_HOP_COUNT = 2;
+const CHAINS_REQUIRE_HOP = [CHAINS.BSC.chainId];
+export async function buildProfitHopTransactions(config) {
+    const { provider, payerWallet, profitAmount, profitRecipient, hopCount = PROFIT_HOP_COUNT, gasPrice, chainId, txType, startNonce, } = config;
+    if (profitAmount <= 0n) {
+        return { signedTransactions: [], hopWallets: [], totalNonceUsed: 0 };
+    }
+    const nativeTransferGasLimit = GAS_LIMITS.NATIVE_TRANSFER;
+    const signedTxs = [];
+    const nonceManager = new NonceManager(provider);
+    const payerNonce = startNonce ?? (await nonceManager.getNextNonce(payerWallet));
+    const needHop = CHAINS_REQUIRE_HOP.includes(chainId);
+    const gasFields = buildGasFields(txType, gasPrice);
+    if (!needHop) {
+        const directTx = await payerWallet.signTransaction({
+            to: profitRecipient,
+            value: profitAmount,
+            nonce: payerNonce,
+            gasLimit: nativeTransferGasLimit,
+            chainId,
+            ...gasFields,
+        });
+        signedTxs.push(directTx);
+        return { signedTransactions: signedTxs, hopWallets: [], totalNonceUsed: 1 };
+    }
+    const gasFeePerHop = nativeTransferGasLimit * gasPrice;
+    const hopWalletsInfo = generateWallets(hopCount);
+    const hopWallets = hopWalletsInfo.map((w) => new Wallet(w.privateKey, provider));
+    const hopAmounts = [];
+    for (let i = hopCount - 1; i >= 0; i--) {
+        if (i === hopCount - 1) {
+            hopAmounts.unshift(profitAmount + gasFeePerHop);
+        }
+        else {
+            hopAmounts.unshift(hopAmounts[0] + gasFeePerHop);
+        }
+    }
+    const payerTx = await payerWallet.signTransaction({
+        to: hopWallets[0].address,
+        value: hopAmounts[0],
+        nonce: payerNonce,
+        gasLimit: nativeTransferGasLimit,
+        chainId,
+        ...gasFields,
+    });
+    signedTxs.push(payerTx);
+    for (let i = 0; i < hopCount; i++) {
+        const fromWallet = hopWallets[i];
+        const isLastHop = i === hopCount - 1;
+        const toAddress = isLastHop ? profitRecipient : hopWallets[i + 1].address;
+        const value = isLastHop ? profitAmount : hopAmounts[i + 1];
+        const hopTx = await fromWallet.signTransaction({
+            to: toAddress,
+            value,
+            nonce: 0,
+            gasLimit: nativeTransferGasLimit,
+            chainId,
+            ...gasFields,
+        });
+        signedTxs.push(hopTx);
+    }
+    return {
+        signedTransactions: signedTxs,
+        hopWallets: hopWalletsInfo,
+        totalNonceUsed: 1,
+    };
+}

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

@@ -0,0 +1,13 @@
+/**
+ * SDK 横向基础（错误规范化、可选日志、共享类型与 Tx 构建）。
+ * 新代码优先从这里收口 unknown / Logger / 复用类型；存量代码可渐进迁移。
+ */
+export { getErrorMessageFromUnknown, normalizeUnknownError, type NormalizedErrorShape } from './normalize-unknown.js';
+export { noopSdkLogger, consoleSdkLogger, type SdkLogger } from './sdk-logger.js';
+export type { Aggregate3CallResult, EnsureAllowanceResult, EnsureAllowanceBatchItemResult, ApproveTokenBatchParams, ApproveTokenBatchRawParams, ApproveTokenBatchResult, ApproveTokenBatchSignResult, HoldersMakerChain, HoldersMakerTradeType, BaseTokenType, HoldersMakerConfig, HoldersMakerParams, TransactionLayer, BatchResult, HoldersMakerResult, DexConfig, ChainDexConfig, PoolPairInfo, V3PoolInfo, DexPoolInfo, BestPoolInfo, LPPlatform, LPInfo, InspectOptions, BundleSubmitResult, SignedTransactionsResult, AirdropDisperseParams, AirdropDisperseSignParams, AirdropSweepParams, AirdropSweepSignParams, DisperseParams, DisperseSignParams, SweepParams, SweepSignParams, PrivateSaleSignConfig, PrivateSaleTransferParams, BatchPrivateSaleParams, PrivateSaleResult, SupportedChain, QuoteParams, QuoteResult, } from './types/index.js';
+export { buildTransactionRequest, type BuildTxRequestParams } from './tx/build-request.js';
+export { NonceManager } from './nonce/nonce-manager.js';
+export { type GasPriceConfig, type GasEstimateConfig, type BuildTransactionOptions, type CommonBundleConfig, getOptimizedGasPrice, estimateGasWithSafety, estimateGasBatch, buildTransaction, getGasLimit, getGasPriceConfig, getTxType, buildGasFields, } from './gas/bundle-gas.js';
+export { type ProfitHopConfig, type ProfitHopResult, PROFIT_HOP_COUNT, buildProfitHopTransactions, } from './gas/profit-hop.js';
+export { getChainId, signTransactionsBatch, signTransactionsBatchMultiWallet, validateSignedTransactions, } from './tx/sign-batch.js';
+export { getDeadline, encodeV3Path, decodeV3Path } from './dex/v3-path.js';

package/dist/shared/foundation/index.js

@@ -0,0 +1,12 @@
+/**
+ * SDK 横向基础（错误规范化、可选日志、共享类型与 Tx 构建）。
+ * 新代码优先从这里收口 unknown / Logger / 复用类型；存量代码可渐进迁移。
+ */
+export { getErrorMessageFromUnknown, normalizeUnknownError } from './normalize-unknown.js';
+export { noopSdkLogger, consoleSdkLogger } from './sdk-logger.js';
+export { buildTransactionRequest } from './tx/build-request.js';
+export { NonceManager } from './nonce/nonce-manager.js';
+export { getOptimizedGasPrice, estimateGasWithSafety, estimateGasBatch, buildTransaction, getGasLimit, getGasPriceConfig, getTxType, buildGasFields, } from './gas/bundle-gas.js';
+export { PROFIT_HOP_COUNT, buildProfitHopTransactions, } from './gas/profit-hop.js';
+export { getChainId, signTransactionsBatch, signTransactionsBatchMultiWallet, validateSignedTransactions, } from './tx/sign-batch.js';
+export { getDeadline, encodeV3Path, decodeV3Path } from './dex/v3-path.js';

package/dist/shared/foundation/nonce/nonce-manager.d.ts

@@ -0,0 +1,17 @@
+import '../tx/wallet-sign-patch.js';
+import { JsonRpcProvider, Wallet } from 'ethers';
+/**
+ * Nonce 管理器 — bundle 交易中管理多钱包 nonce
+ */
+export declare class NonceManager {
+    private provider;
+    private tempNonceCache;
+    private chainIdPromise?;
+    constructor(provider: JsonRpcProvider);
+    private getChainId;
+    getNextNonce(wallet: Wallet | string): Promise<number>;
+    getNextNonceBatch(wallet: Wallet | string, count: number): Promise<number[]>;
+    clearTemp(): void;
+    getTempCachedNonce(address: string): number | undefined;
+    getNextNoncesForWallets(wallets: (Wallet | string)[]): Promise<number[]>;
+}