four-flap-meme-sdk 4.3.13 → 4.3.15

package/dist/bundle/four-meme/core/create-openfour.js

@@ -11,7 +11,7 @@ import { getTxType, getGasPriceConfig, getBribeAmount, calculateProfit, getProfi
 import { signBribeTransaction } from '../../../core/sign-context-helpers.js';
 import { createChainContext, loginFourClient, resolveTokenImage } from '../core-helpers.js';
 import { OPENFOUR_CORE_ABI } from '../../../abis/openfour.js';
-import { computeOpenFourCreateValueWei, decodeOpenFourCreateArg, isOpenFourPresaleNative, loadOpenFourAddresses, } from '../../../domains/openfour/index.js';
+import { OPENFOUR_CREATE_EXPIRED_MESSAGE, computeOpenFourCreateValueWei, decodeOpenFourCreateArg, isOpenFourPresaleNative, loadOpenFourAddresses, shouldRefreshOpenFourCreateArg, } from '../../../domains/openfour/index.js';
 import { signQuoteApproveIfNeeded } from './create-token-quote.js';
 const BSC_SUBMIT_FEE_DUST_WEI = 10n ** 12n;
 export function openFourSubmitProfitWei(nativeFlowWei) {
@@ -32,6 +32,23 @@ function signedNativeFlowWei(signedTxs) {
         }
     }, 0n);
 }
+async function readChainTimestamp(provider) {
+    const block = await provider.getBlock('latest');
+    return BigInt(block?.timestamp ?? Math.floor(Date.now() / 1000));
+}
+async function fetchFreshOpenFourCreateArg(fourClient, accessToken, body, provider) {
+    const pull = () => fourClient.createOpenFourToken(accessToken, body);
+    let createResp = await pull();
+    let decoded = decodeOpenFourCreateArg(createResp.createArg);
+    if (shouldRefreshOpenFourCreateArg(decoded.validTimestamp, await readChainTimestamp(provider))) {
+        createResp = await pull();
+        decoded = decodeOpenFourCreateArg(createResp.createArg);
+    }
+    if (shouldRefreshOpenFourCreateArg(decoded.validTimestamp, await readChainTimestamp(provider))) {
+        throw new Error(OPENFOUR_CREATE_EXPIRED_MESSAGE);
+    }
+    return createResp;
+}
 function toRaisedToken(cfg) {
     return {
         symbol: cfg.symbol,
@@ -84,8 +101,8 @@ export async function createOpenFourTokenMerkle(params) {
         totalSupply: cfg.totalSupply,
         raisedAmount: cfg.raisedAmount,
     };
-    const createResp = await fourClient.createOpenFourToken(accessToken, body);
     const addrs = await loadOpenFourAddresses(provider);
+    const createResp = await fetchFreshOpenFourCreateArg(fourClient, accessToken, body, provider);
     const decoded = decodeOpenFourCreateArg(createResp.createArg);
     const valueWei = computeOpenFourCreateValueWei(decoded, addrs.wrappedNative);
     const gasPrice = await getOptimizedGasPrice(provider, getGasPriceConfig(config));

package/dist/chains/bsc/pancake/bundle-swap-types.d.ts

@@ -138,6 +138,8 @@ export interface PancakeBundleSwapSignParams {
     quoteToken?: string;
     quoteTokenDecimals?: number;
     startNonces?: number[];
+    /** 税币基点。卖出按扣税后数量报价，买入 minOut 再扣税。 */
+    taxRateBps?: number;
 }
 export interface PancakeBundleSwapParams {
     sellerPrivateKey: string;

package/dist/chains/bsc/pancake/quote.d.ts

@@ -1,6 +1,20 @@
 import { ethers } from 'ethers';
 import { applySlippageBps } from '../../../core/constants/index.js';
 import { type QuoteBNBResult, type QuoteSellParams, type RouteParams, type UserType } from './bundle-swap-types.js';
+/** 路由卖出端的计价代币（path 最后一项 / v3TokenOut）。 */
+export declare function routeQuoteToken(routeParams: RouteParams): string | undefined;
+/**
+ * 股票池 / USDT 池 path 不是 WBNB 时，即使调用方漏传 quoteToken 也不能走 ETH 买卖。
+ * Pancake swapExactETH* 要求 path[0]==WETH，否则 INVALID_PATH。
+ */
+export declare function resolvePancakeQuoteMode(params: {
+    quoteToken?: string;
+    routeParams: RouteParams;
+    wrappedNative: string;
+}): {
+    useNativeToken: boolean;
+    quoteToken?: string;
+};
 /** Pancake 买卖 minOut；实现见 core applySlippageBps。 */
 export declare const applyPancakeSlippage: typeof applySlippageBps;
 export declare function splitQuotedMins(quotedTotal: bigint, amounts: bigint[], slippageBps?: number): bigint[];

package/dist/chains/bsc/pancake/quote.js

@@ -1,6 +1,36 @@
 import { ADDRESSES, applySlippageBps, getProfitRateBps as getSharedProfitRateBps, calculateBundleSwapRoundTripProfit } from '../../../core/constants/index.js';
 import { quoteV2, quoteV3 } from '../../../core/quote/quote-helpers.js';
-import { WBNB_ADDRESS, } from './bundle-swap-types.js';
+import { WBNB_ADDRESS, ZERO_ADDRESS, } from './bundle-swap-types.js';
+function normalizeAddr(addr) {
+    return String(addr || '').trim().toLowerCase();
+}
+/** 路由卖出端的计价代币（path 最后一项 / v3TokenOut）。 */
+export function routeQuoteToken(routeParams) {
+    if (routeParams.routeType === 'v2' && routeParams.v2Path?.length) {
+        return routeParams.v2Path[routeParams.v2Path.length - 1];
+    }
+    if (routeParams.routeType === 'v3-single') {
+        return routeParams.v3TokenOut;
+    }
+    const multiPath = routeParams.v2Path;
+    if (multiPath?.length)
+        return multiPath[multiPath.length - 1];
+    return undefined;
+}
+/**
+ * 股票池 / USDT 池 path 不是 WBNB 时，即使调用方漏传 quoteToken 也不能走 ETH 买卖。
+ * Pancake swapExactETH* 要求 path[0]==WETH，否则 INVALID_PATH。
+ */
+export function resolvePancakeQuoteMode(params) {
+    const wrapped = normalizeAddr(params.wrappedNative);
+    const explicit = normalizeAddr(params.quoteToken);
+    const token = explicit && explicit !== normalizeAddr(ZERO_ADDRESS) ? params.quoteToken.trim() : routeQuoteToken(params.routeParams);
+    const tokenNorm = normalizeAddr(token);
+    if (!tokenNorm || tokenNorm === normalizeAddr(ZERO_ADDRESS) || tokenNorm === wrapped) {
+        return { useNativeToken: true };
+    }
+    return { useNativeToken: false, quoteToken: token };
+}
 /** Pancake 买卖 minOut；实现见 core applySlippageBps。 */
 export const applyPancakeSlippage = applySlippageBps;
 export function splitQuotedMins(quotedTotal, amounts, slippageBps = 100) {

package/dist/chains/bsc/pancake/quote.test.js

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'vitest';
 import { reverseBuyRouteParams } from './bundle-buy-first-quote.js';
-import { applyPancakeSlippage, applyTaxBps, taxedSellQuoteInput, isSameWalletBuySell, resolveBuyFirstSellMins, sequentialBuyAmountOutMins, sequentialPrefixOutputs, pairSameWalletSellAmounts, splitQuotedMins, } from './quote.js';
+import { applyPancakeSlippage, applyTaxBps, taxedSellQuoteInput, isSameWalletBuySell, resolveBuyFirstSellMins, sequentialBuyAmountOutMins, sequentialPrefixOutputs, pairSameWalletSellAmounts, splitQuotedMins, resolvePancakeQuoteMode, } from './quote.js';
 describe('applyPancakeSlippage', () => {
     it('drops 1% by default', () => {
         expect(applyPancakeSlippage(1000000n)).toBe(990000n);
@@ -36,6 +36,26 @@ describe('taxedSellQuoteInput', () => {
         expect(taxedSellQuoteInput(10000n, 100)).toBe(9900n);
     });
 });
+describe('resolvePancakeQuoteMode', () => {
+    const wbnb = '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c';
+    const spcxb = '0xbe9D156892E55e7154BcD3cB0FEA677F9D3103E1';
+    const token = '0x7db2f0c15f74ab0dc0d4f49650dd60c45ffb7777';
+    it('treats omitted quoteToken as ERC20 when v2 path ends at a stock quote', () => {
+        const mode = resolvePancakeQuoteMode({
+            routeParams: { routeType: 'v2', v2Path: [token, spcxb] },
+            wrappedNative: wbnb,
+        });
+        expect(mode.useNativeToken).toBe(false);
+        expect(mode.quoteToken?.toLowerCase()).toBe(spcxb.toLowerCase());
+    });
+    it('keeps native mode when v2 path ends at wrapped BNB', () => {
+        const mode = resolvePancakeQuoteMode({
+            routeParams: { routeType: 'v2', v2Path: [token, wbnb] },
+            wrappedNative: wbnb,
+        });
+        expect(mode.useNativeToken).toBe(true);
+    });
+});
 describe('pairSameWalletSellAmounts', () => {
     it('pairs each wash wallet sell to that wallet guaranteed buy out', () => {
         expect(pairSameWalletSellAmounts(true, [900n, 700n], 2)).toEqual([900n, 700n]);

package/dist/chains/bsc/pancake/swap-batch.d.ts

@@ -16,6 +16,7 @@ export interface PancakeBatchSwapSignParams {
     quoteToken?: string;
     quoteTokenDecimals?: number;
     startNonces?: number[];
+    taxRateBps?: number;
 }
 /**
  * 批量换手结果

package/dist/chains/bsc/pancake/swap-batch.js

@@ -6,7 +6,7 @@ import { getGasLimit } from '../../../core/gas/bundle-gas.js';
 import { ethers, Contract, Wallet } from 'ethers';
 import { calculateSellAmount } from '../../../utils/swap-helpers.js';
 import { NonceManager, getDeadline, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../../utils/bundle-helpers.js';
-import { BRIBE_GAS_LIMIT, ERC20_BALANCE_OF_ABI, FLAT_FEE, PANCAKE_V2_ROUTER_ABI, PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, PANCAKE_V3_ROUTER_ADDRESS, WBNB_ADDRESS, ZERO_ADDRESS, calculateProfitAmount, createPancakeContext, getERC20ToNativeQuote, getGasPrice, grossUpPancakeSellProceedsToBuySide, quoteSellOutput, quoteBuyOutput, applyPancakeSlippage, } from './bundle-swap-helpers.js';
+import { BRIBE_GAS_LIMIT, ERC20_BALANCE_OF_ABI, FLAT_FEE, PANCAKE_V2_ROUTER_ABI, PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, PANCAKE_V3_ROUTER_ADDRESS, WBNB_ADDRESS, calculateProfitAmount, createPancakeContext, getERC20ToNativeQuote, getGasPrice, grossUpPancakeSellProceedsToBuySide, quoteSellOutput, quoteBuyOutput, applyPancakeSlippage, resolvePancakeQuoteMode, taxedSellQuoteInput, sequentialBuyAmountOutMins, } from './bundle-swap-helpers.js';
 /**
  * PancakeSwap 批量换手（一卖多买）
  *
@@ -17,7 +17,7 @@ import { BRIBE_GAS_LIMIT, ERC20_BALANCE_OF_ABI, FLAT_FEE, PANCAKE_V2_ROUTER_ABI,
  */
 export async function pancakeBatchSwapMerkle(params) {
     const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerAmounts, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, startNonces, // ✅ 可选：前端预获取的 nonces
-     } = params;
+    taxRateBps = 0, } = params;
     // ✅ 校验买方数量（最多 24 个）
     const MAX_BUYERS = 24;
     if (buyerPrivateKeys.length === 0) {
@@ -26,7 +26,13 @@ export async function pancakeBatchSwapMerkle(params) {
     if (buyerPrivateKeys.length > MAX_BUYERS) {
         throw new Error(`买方钱包数量超过限制: ${buyerPrivateKeys.length} > ${MAX_BUYERS}`);
     }
-    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
+    const quoteMode = resolvePancakeQuoteMode({
+        quoteToken,
+        routeParams,
+        wrappedNative: WBNB_ADDRESS,
+    });
+    const useNativeToken = quoteMode.useNativeToken;
+    const effectiveQuoteToken = quoteMode.quoteToken;
     const context = createPancakeContext(config);
     const seller = new Wallet(sellerPrivateKey, context.provider);
     const buyers = buyerPrivateKeys.map((pk) => new Wallet(pk, context.provider));
@@ -42,7 +48,7 @@ export async function pancakeBatchSwapMerkle(params) {
     const { amount: sellAmountWei, decimals } = sellAmountResult;
     const quoteResult = await quoteSellOutput({
         routeParams,
-        sellAmountWei,
+        sellAmountWei: taxedSellQuoteInput(sellAmountWei, taxRateBps),
         provider: context.provider,
         v2RouterAddress: config.v2RouterAddress,
     });
@@ -70,7 +76,7 @@ export async function pancakeBatchSwapMerkle(params) {
     }
     // ✅ 并行验证所有买方余额
     const reserveGas = ethers.parseEther((config.reserveGasBNB ?? 0.0005).toString());
-    const erc20Contract = useNativeToken ? null : new Contract(quoteToken, ERC20_BALANCE_OF_ABI, context.provider);
+    const erc20Contract = useNativeToken ? null : new Contract(effectiveQuoteToken, ERC20_BALANCE_OF_ABI, context.provider);
     await Promise.all(buyers.map(async (buyer, i) => {
         const buyAmount = buyAmountsWei[i];
         if (useNativeToken) {
@@ -96,7 +102,7 @@ export async function pancakeBatchSwapMerkle(params) {
         provider: context.provider,
         v2RouterAddress: config.v2RouterAddress,
     })));
-    const buyMinOuts = buyQuotedOuts.map((quoted) => applyPancakeSlippage(quoted, slippageBps));
+    const buyMinOuts = sequentialBuyAmountOutMins(buyQuotedOuts, taxRateBps, slippageBps);
     const deadline = getDeadline();
     const v3RouterIface = new ethers.Interface(PANCAKE_V3_ROUTER_ABI);
     const batchV2Addr = config.v2RouterAddress || PANCAKE_V2_ROUTER_ADDRESS;
@@ -219,7 +225,7 @@ export async function pancakeBatchSwapMerkle(params) {
         tokenAddress,
         sellAmountWei,
         sellProceedsWei: estimatedBNBOut,
-        quoteTokenIn: useNativeToken ? WBNB_ADDRESS : quoteToken,
+        quoteTokenIn: useNativeToken ? WBNB_ADDRESS : effectiveQuoteToken,
         version,
         fee,
         v2RouterAddress: config.v2RouterAddress,
@@ -229,7 +235,7 @@ export async function pancakeBatchSwapMerkle(params) {
         profitAmount = calculateProfitAmount(profitNotional, config.userType);
     }
     else {
-        const estimatedBNBValue = await getERC20ToNativeQuote(context.provider, quoteToken, profitNotional, version, fee);
+        const estimatedBNBValue = await getERC20ToNativeQuote(context.provider, effectiveQuoteToken, profitNotional, version, fee);
         profitAmount = calculateProfitAmount(estimatedBNBValue, config.userType);
     }
     // 计算利润 nonce

package/dist/chains/bsc/pancake/swap-quick.js

@@ -7,7 +7,7 @@ import { ethers, Contract, Wallet } from 'ethers';
 import { calculateSellAmount } from '../../../utils/swap-helpers.js';
 import { NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../../utils/bundle-helpers.js';
 import { ERC20_ABI } from '../../../abis/common.js';
-import { BRIBE_GAS_LIMIT, FLAT_FEE, NATIVE_TRANSFER_GAS_LIMIT, PANCAKE_V2_ROUTER_ABI, PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, PANCAKE_V3_ROUTER_ADDRESS, WBNB_ADDRESS, ZERO_ADDRESS, buildBNBHopChainForERC20, buildERC20HopChain, buildNativeHopChain, calculateProfitAmount, createPancakeContext, generateDisperseHopPaths, getERC20ToNativeQuote, getGasPrice, grossUpPancakeSellProceedsToBuySide, quoteSellOutput, quoteBuyOutput, applyPancakeSlippage, sequentialBuyAmountOutMins, taxedSellQuoteInput, } from './bundle-swap-helpers.js';
+import { BRIBE_GAS_LIMIT, FLAT_FEE, NATIVE_TRANSFER_GAS_LIMIT, PANCAKE_V2_ROUTER_ABI, PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, PANCAKE_V3_ROUTER_ADDRESS, WBNB_ADDRESS, buildBNBHopChainForERC20, buildERC20HopChain, buildNativeHopChain, calculateProfitAmount, createPancakeContext, generateDisperseHopPaths, getERC20ToNativeQuote, getGasPrice, grossUpPancakeSellProceedsToBuySide, quoteSellOutput, quoteBuyOutput, applyPancakeSlippage, sequentialBuyAmountOutMins, taxedSellQuoteInput, resolvePancakeQuoteMode, } from './bundle-swap-helpers.js';
 /**
  * PancakeSwap 快捷批量换手（资金自动流转）
  *
@@ -26,13 +26,17 @@ export async function pancakeQuickBatchSwapMerkle(params) {
     const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, disperseHopCount = 0, // ✅ 转账多跳数（默认0=直接转账）
     startNonces, // ✅ 可选：前端预获取的 nonces
     taxRateBps = 0, } = params;
-    // ✅ 判断是否使用原生代币
-    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
-    // ✅ 根据 chainId 获取正确的 Wrapped Native Token 地址
     const chainId = config.chainId ?? CHAINS.BSC.chainId;
     const WRAPPED_NATIVE = chainId === CHAINS.XLAYER.chainId
-        ? ADDRESSES.XLAYER.WOKB.toLowerCase() // XLayer: WOKB
-        : ADDRESSES.BSC.WBNB.toLowerCase(); // BSC: WBNB
+        ? ADDRESSES.XLAYER.WOKB.toLowerCase()
+        : ADDRESSES.BSC.WBNB.toLowerCase();
+    const quoteMode = resolvePancakeQuoteMode({
+        quoteToken,
+        routeParams,
+        wrappedNative: WRAPPED_NATIVE,
+    });
+    const useNativeToken = quoteMode.useNativeToken;
+    const effectiveQuoteToken = quoteMode.quoteToken;
     // ✅ 动态计算最大买方数量（根据多跳数）
     // 固定开销: 贿赂(1) + 卖出(1) + 利润多跳(PROFIT_HOP_COUNT + 1)
     // BNB 模式（无多跳）: 转账(N) + 买入(N) = 2N
@@ -98,8 +102,8 @@ export async function pancakeQuickBatchSwapMerkle(params) {
     }
     else {
         // ERC20 模式：输出必须是指定的 quoteToken
-        if (!sellOutputToken || sellOutputToken.toLowerCase() !== quoteToken.toLowerCase()) {
-            throw new Error(`ERC20 模式要求卖出路径以 ${quoteToken} 结尾（当前输出: ${sellOutputToken || '未知'}）。`);
+        if (!sellOutputToken || sellOutputToken.toLowerCase() !== effectiveQuoteToken.toLowerCase()) {
+            throw new Error(`ERC20 模式要求卖出路径以 ${effectiveQuoteToken} 结尾（当前输出: ${sellOutputToken || '未知'}）。`);
         }
     }
     // ✅ 创建共享资源
@@ -127,7 +131,7 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         tokenAddress,
         sellAmountWei,
         sellProceedsWei: estimatedOutput,
-        quoteTokenIn: useNativeToken ? WBNB_ADDRESS : quoteToken,
+        quoteTokenIn: useNativeToken ? WBNB_ADDRESS : effectiveQuoteToken,
         version,
         fee,
         v2RouterAddress: config.v2RouterAddress,
@@ -137,7 +141,7 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         profitAmount = calculateProfitAmount(profitNotional, config.userType);
     }
     else {
-        const estimatedBNBValue = await getERC20ToNativeQuote(context.provider, quoteToken, profitNotional, version, fee);
+        const estimatedBNBValue = await getERC20ToNativeQuote(context.provider, effectiveQuoteToken, profitNotional, version, fee);
         profitAmount = calculateProfitAmount(estimatedBNBValue, config.userType);
     }
     const distributableAmount = estimatedOutput - (useNativeToken ? profitAmount : 0n);
@@ -295,7 +299,7 @@ export async function pancakeQuickBatchSwapMerkle(params) {
             transferTxs = await Promise.all(buyers.map((buyer, i) => {
                 const transferData = erc20Interface.encodeFunctionData('transfer', [buyer.address, transferAmountsWei[i]]);
                 return seller.signTransaction({
-                    to: quoteToken,
+                    to: effectiveQuoteToken,
                     data: transferData,
                     value: 0n,
                     nonce: transferNonces[i],
@@ -333,7 +337,7 @@ export async function pancakeQuickBatchSwapMerkle(params) {
             // 2. 构建 ERC20 多跳链
             const erc20HopChains = await Promise.all(hopPaths.map((path, i) => {
                 const payerNonce = sellerNonce + i; // ✅ payer 每个 buyer 只用 1 个 nonce
-                return buildERC20HopChain(seller, path, quoteToken, transferAmountsWei[i], gasPrice, context.chainId, txType, payerNonce);
+                return buildERC20HopChain(seller, path, effectiveQuoteToken, transferAmountsWei[i], gasPrice, context.chainId, txType, payerNonce);
             }));
             const erc20Txs = erc20HopChains.flat();
             sellerNonce += buyers.length; // ✅ payer 只增加 buyers.length 个 nonce

package/dist/chains/bsc/pancake/swap-single.js

@@ -6,12 +6,17 @@ import { getGasLimit } from '../../../core/gas/bundle-gas.js';
 import { ethers, Wallet } from 'ethers';
 import { calculateSellAmount } from '../../../utils/swap-helpers.js';
 import { NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../../utils/bundle-helpers.js';
-import { BRIBE_GAS_LIMIT, ZERO_ADDRESS, buildNoncePlanFromNonces, buildSwapTransactions, WBNB_ADDRESS, calculateBuyerBudget, calculateProfitAmount, createPancakeContext, getERC20ToNativeQuote, getGasPrice, grossUpPancakeSellProceedsToBuySide, planNonces, quoteSellOutput, applyPancakeSlippage, quoteBuyOutput, validateFinalBalances, } from './bundle-swap-helpers.js';
+import { BRIBE_GAS_LIMIT, buildNoncePlanFromNonces, buildSwapTransactions, WBNB_ADDRESS, calculateBuyerBudget, calculateProfitAmount, createPancakeContext, getERC20ToNativeQuote, getGasPrice, grossUpPancakeSellProceedsToBuySide, planNonces, quoteSellOutput, applyPancakeSlippage, quoteBuyOutput, resolvePancakeQuoteMode, taxedSellQuoteInput, sequentialBuyAmountOutMins, validateFinalBalances, } from './bundle-swap-helpers.js';
 export async function pancakeBundleSwapMerkle(params) {
     const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKey, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, startNonces, // ✅ 可选：前端预获取的 nonces
-     } = params;
-    // ✅ 判断是否使用原生代币（BNB）或 ERC20 代币（如 USDT）
-    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
+    taxRateBps = 0, } = params;
+    const quoteMode = resolvePancakeQuoteMode({
+        quoteToken,
+        routeParams,
+        wrappedNative: WBNB_ADDRESS,
+    });
+    const useNativeToken = quoteMode.useNativeToken;
+    const effectiveQuoteToken = quoteMode.quoteToken;
     const context = createPancakeContext(config);
     const seller = new Wallet(sellerPrivateKey, context.provider);
     const buyer = new Wallet(buyerPrivateKey, context.provider);
@@ -28,7 +33,7 @@ export async function pancakeBundleSwapMerkle(params) {
     const { amount: sellAmountWei, decimals } = sellAmountResult;
     const quoteResult = await quoteSellOutput({
         routeParams,
-        sellAmountWei,
+        sellAmountWei: taxedSellQuoteInput(sellAmountWei, taxRateBps),
         provider: context.provider,
         v2RouterAddress: config.v2RouterAddress,
     });
@@ -37,7 +42,7 @@ export async function pancakeBundleSwapMerkle(params) {
         quotedBNBOut: quoteResult.estimatedBNBOut,
         reserveGasBNB: config.reserveGasBNB,
         useNativeToken,
-        quoteToken,
+        quoteToken: effectiveQuoteToken,
         quoteTokenDecimals,
         provider: context.provider,
     });
@@ -48,6 +53,7 @@ export async function pancakeBundleSwapMerkle(params) {
         v2RouterAddress: config.v2RouterAddress,
     });
     const slippageBps = config.slippageBps ?? 100;
+    const buyMinOut = sequentialBuyAmountOutMins([quotedBuyOut], taxRateBps, slippageBps)[0] ?? 0n;
     const swapUnsigned = await buildSwapTransactions({
         routeParams,
         sellAmountWei,
@@ -58,7 +64,7 @@ export async function pancakeBundleSwapMerkle(params) {
         useNativeToken,
         v2RouterAddress: config.v2RouterAddress,
         sellAmountOutMin: applyPancakeSlippage(quoteResult.estimatedBNBOut, slippageBps),
-        buyAmountOutMin: applyPancakeSlippage(quotedBuyOut, slippageBps),
+        buyAmountOutMin: buyMinOut,
     });
     const version = routeParams.routeType === 'v2' ? 'v2' : 'v3';
     const fee = routeParams.routeType === 'v3-single' ? routeParams.v3Fee : undefined;
@@ -67,7 +73,7 @@ export async function pancakeBundleSwapMerkle(params) {
         tokenAddress,
         sellAmountWei,
         sellProceedsWei: quoteResult.estimatedBNBOut,
-        quoteTokenIn: useNativeToken ? WBNB_ADDRESS : quoteToken,
+        quoteTokenIn: useNativeToken ? WBNB_ADDRESS : effectiveQuoteToken,
         version,
         fee,
         v2RouterAddress: config.v2RouterAddress,
@@ -77,7 +83,7 @@ export async function pancakeBundleSwapMerkle(params) {
         profitAmount = calculateProfitAmount(profitNotional, config.userType);
     }
     else {
-        const estimatedBNBValue = await getERC20ToNativeQuote(context.provider, quoteToken, profitNotional, version, fee);
+        const estimatedBNBValue = await getERC20ToNativeQuote(context.provider, effectiveQuoteToken, profitNotional, version, fee);
         profitAmount = calculateProfitAmount(estimatedBNBValue, config.userType);
     }
     // ✅ 获取贿赂金额

package/dist/domains/four/tax-token.test.js

@@ -73,6 +73,7 @@ describe('OpenFour create value', () => {
             createFee: parseEther('0.01'),
             presaleQuote: parseEther('0.2'),
             quoteAsset: wbnb,
+            validTimestamp: 0n,
         };
         expect(isOpenFourPresaleNative({ ...decoded, wrappedNative: wbnb })).toBe(true);
         expect(computeOpenFourCreateValueWei(decoded, wbnb)).toBe(parseEther('0.21'));
@@ -82,6 +83,7 @@ describe('OpenFour create value', () => {
             createFee: parseEther('0.01'),
             presaleQuote: parseEther('100'),
             quoteAsset: usdt,
+            validTimestamp: 0n,
         };
         expect(isOpenFourPresaleNative({ ...decoded, wrappedNative: wbnb })).toBe(false);
         expect(computeOpenFourCreateValueWei(decoded, wbnb)).toBe(parseEther('0.01'));

package/dist/domains/openfour/create-arg.d.ts

@@ -2,8 +2,13 @@ export type OpenFourDecodedCreateArg = {
     createFee: bigint;
     presaleQuote: bigint;
     quoteAsset: string;
+    validTimestamp: bigint;
 };
+/** Four 签名在链上只活到 validTimestamp；提交前至少留这么多秒，否则重拉 createArg。 */
+export declare const OPENFOUR_CREATE_MIN_REMAIN_SEC = 15n;
+export declare const OPENFOUR_CREATE_EXPIRED_MESSAGE = "OpenFour \u53D1\u5E01\u7B7E\u540D\u5DF2\u8FC7\u671F\uFF0C\u8BF7\u518D\u70B9\u4E00\u6B21\u53D1\u5C04\u3002Four \u7684 validTimestamp \u5F88\u77ED\uFF0C\u63A5\u53E3\u6162\u65F6\u7B7E\u540D\u5230\u8FBE\u94FE\u4E0A\u5C31\u5DF2\u7ECF\u5931\u6548\u3002";
 export declare function decodeOpenFourCreateArg(rawCreateArg: string): OpenFourDecodedCreateArg;
+export declare function shouldRefreshOpenFourCreateArg(validTimestamp: bigint, chainTimestamp: bigint, minRemainSec?: bigint): boolean;
 export declare function isOpenFourPresaleNative(params: {
     presaleQuote: bigint;
     quoteAsset: string;

package/dist/domains/openfour/create-arg.js

@@ -40,6 +40,9 @@ const ABI_13 = [
     }),
 ];
 const coder = AbiCoder.defaultAbiCoder();
+/** Four 签名在链上只活到 validTimestamp；提交前至少留这么多秒，否则重拉 createArg。 */
+export const OPENFOUR_CREATE_MIN_REMAIN_SEC = 15n;
+export const OPENFOUR_CREATE_EXPIRED_MESSAGE = 'OpenFour 发币签名已过期，请再点一次发射。Four 的 validTimestamp 很短，接口慢时签名到达链上就已经失效。';
 function toBigInt(value) {
     if (value == null)
         return 0n;
@@ -60,8 +63,12 @@ export function decodeOpenFourCreateArg(rawCreateArg) {
         createFee: toBigInt(row.createFee),
         presaleQuote: toBigInt(row.presaleQuote),
         quoteAsset: String(row.initParams?.quoteAsset ?? ''),
+        validTimestamp: toBigInt(row.validTimestamp),
     };
 }
+export function shouldRefreshOpenFourCreateArg(validTimestamp, chainTimestamp, minRemainSec = OPENFOUR_CREATE_MIN_REMAIN_SEC) {
+    return validTimestamp < chainTimestamp + minRemainSec;
+}
 export function isOpenFourPresaleNative(params) {
     if (params.presaleQuote <= 0n)
         return false;

package/dist/domains/openfour/create-arg.test.d.ts

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

package/dist/domains/openfour/create-arg.test.js

@@ -0,0 +1,81 @@
+import { AbiCoder, ParamType, ZeroAddress, ZeroHash } from 'ethers';
+import { describe, expect, it } from 'vitest';
+import { OPENFOUR_CREATE_MIN_REMAIN_SEC, decodeOpenFourCreateArg, shouldRefreshOpenFourCreateArg, } from './create-arg.js';
+const INIT = [
+    { name: 'name', type: 'string' },
+    { name: 'symbol', type: 'string' },
+    { name: 'tokenUri', type: 'string' },
+    { name: 'maxSupply', type: 'uint256' },
+    { name: 'saleAmount', type: 'uint256' },
+    { name: 'raiseAmount', type: 'uint256' },
+    { name: 'quoteAsset', type: 'address' },
+    { name: 'tokenSalt', type: 'bytes32' },
+    { name: 'tokenParams', type: 'bytes' },
+    { name: 'vaultParams', type: 'bytes' },
+    { name: 'curveParams', type: 'bytes' },
+    { name: 'tradeParams', type: 'bytes' },
+    { name: 'migrateParams', type: 'bytes' },
+    { name: 'customDataParams', type: 'bytes' },
+];
+const ABI = [
+    ParamType.from({
+        type: 'tuple',
+        components: [
+            { name: 'requestId', type: 'uint256' },
+            { name: 'presetId', type: 'uint256' },
+            { name: 'validTimestamp', type: 'uint256' },
+            { name: 'createFee', type: 'uint256' },
+            { name: 'presaleQuote', type: 'uint256' },
+            { name: 'antiSniperEnabled', type: 'bool' },
+            { name: 'initParams', type: 'tuple', components: INIT },
+        ],
+    }),
+];
+function encodeArg(validTimestamp, quoteAsset = ZeroAddress) {
+    return AbiCoder.defaultAbiCoder().encode(ABI, [
+        [
+            1n,
+            2n,
+            validTimestamp,
+            0n,
+            10000000000000000n,
+            false,
+            [
+                'test',
+                'test',
+                'https://example.com/t.json',
+                1n,
+                1n,
+                1n,
+                quoteAsset,
+                ZeroHash,
+                '0x',
+                '0x',
+                '0x',
+                '0x',
+                '0x',
+                '0x',
+            ],
+        ],
+    ]);
+}
+describe('decodeOpenFourCreateArg', () => {
+    it('reads validTimestamp and quoteAsset', () => {
+        const quote = '0xbe9D156892E55e7154BcD3cB0FEA677F9D3103E1';
+        const decoded = decodeOpenFourCreateArg(encodeArg(1789979444n, quote));
+        expect(decoded.validTimestamp).toBe(1789979444n);
+        expect(decoded.presaleQuote).toBe(10000000000000000n);
+        expect(decoded.quoteAsset.toLowerCase()).toBe(quote.toLowerCase());
+    });
+});
+describe('shouldRefreshOpenFourCreateArg', () => {
+    it('refreshes when the deadline is already past', () => {
+        expect(shouldRefreshOpenFourCreateArg(100n, 101n)).toBe(true);
+    });
+    it('refreshes when remaining time is shorter than the submit buffer', () => {
+        expect(shouldRefreshOpenFourCreateArg(100n + OPENFOUR_CREATE_MIN_REMAIN_SEC - 1n, 100n)).toBe(true);
+    });
+    it('keeps a signature with enough remaining time', () => {
+        expect(shouldRefreshOpenFourCreateArg(100n + OPENFOUR_CREATE_MIN_REMAIN_SEC, 100n)).toBe(false);
+    });
+});

package/dist/domains/openfour/index.d.ts

@@ -1,4 +1,4 @@
 export type { OpenFourAddresses, OpenFourCreateReq, OpenFourInitParams, OpenFourModuleSchema, OpenFourParamDescriptor, OpenFourPresetSchemas, OpenFourTemplate, OpenFourTemplateConfig, } from './types.js';
 export { collectOpenFourSchemaParams, defaultOpenFourFormFromSchema, emptyOpenFourInitParams, encodeOpenFourInitParams, encodeOpenFourModuleParams, } from './schema.js';
-export { computeOpenFourCreateValueWei, decodeOpenFourCreateArg, isOpenFourPresaleNative, type OpenFourDecodedCreateArg, } from './create-arg.js';
+export { OPENFOUR_CREATE_EXPIRED_MESSAGE, OPENFOUR_CREATE_MIN_REMAIN_SEC, computeOpenFourCreateValueWei, decodeOpenFourCreateArg, isOpenFourPresaleNative, shouldRefreshOpenFourCreateArg, type OpenFourDecodedCreateArg, } from './create-arg.js';
 export { loadOpenFourAddresses, loadOpenFourPresetSchemas } from './registry.js';

package/dist/domains/openfour/index.js

@@ -1,3 +1,3 @@
 export { collectOpenFourSchemaParams, defaultOpenFourFormFromSchema, emptyOpenFourInitParams, encodeOpenFourInitParams, encodeOpenFourModuleParams, } from './schema.js';
-export { computeOpenFourCreateValueWei, decodeOpenFourCreateArg, isOpenFourPresaleNative, } from './create-arg.js';
+export { OPENFOUR_CREATE_EXPIRED_MESSAGE, OPENFOUR_CREATE_MIN_REMAIN_SEC, computeOpenFourCreateValueWei, decodeOpenFourCreateArg, isOpenFourPresaleNative, shouldRefreshOpenFourCreateArg, } from './create-arg.js';
 export { loadOpenFourAddresses, loadOpenFourPresetSchemas } from './registry.js';

package/dist/exports/root-foundations.d.ts

@@ -15,7 +15,7 @@ export { ensureSellApprovalV1, checkSellApprovalV1, ensureSellApprovalV2, checkS
 export { parseFourError, type FourErrorCode } from '../utils/errors.js';
 export { getTokenManagerV1, getTokenManagerV2, getTokenManagerHelper3, getTokenManagerV1Writer, getTokenManagerV2Writer, getTokenManagerHelper3Writer, getTokenManagerAddress, type ChainName, } from '../utils/contract-factory.js';
 export { FourClient, buildLoginMessage, buildCreateTokenReq, type FourConfig, type GenerateNonceReq, type LoginReq, type CreateTokenReq, type CreateTokenCustom, type CreateTokenResp, type FourTokenTaxInfo, type FourRaisedToken, type FourTokenLabel, } from '../core/clients/four.js';
-export { collectOpenFourSchemaParams, computeOpenFourCreateValueWei, decodeOpenFourCreateArg, defaultOpenFourFormFromSchema, emptyOpenFourInitParams, encodeOpenFourInitParams, encodeOpenFourModuleParams, isOpenFourPresaleNative, loadOpenFourAddresses, loadOpenFourPresetSchemas, type OpenFourAddresses, type OpenFourCreateReq, type OpenFourDecodedCreateArg, type OpenFourInitParams, type OpenFourModuleSchema, type OpenFourParamDescriptor, type OpenFourPresetSchemas, type OpenFourTemplate, type OpenFourTemplateConfig, } from '../domains/openfour/index.js';
+export { OPENFOUR_CREATE_EXPIRED_MESSAGE, OPENFOUR_CREATE_MIN_REMAIN_SEC, collectOpenFourSchemaParams, computeOpenFourCreateValueWei, decodeOpenFourCreateArg, defaultOpenFourFormFromSchema, emptyOpenFourInitParams, encodeOpenFourInitParams, encodeOpenFourModuleParams, isOpenFourPresaleNative, shouldRefreshOpenFourCreateArg, loadOpenFourAddresses, loadOpenFourPresetSchemas, type OpenFourAddresses, type OpenFourCreateReq, type OpenFourDecodedCreateArg, type OpenFourInitParams, type OpenFourModuleSchema, type OpenFourParamDescriptor, type OpenFourPresetSchemas, type OpenFourTemplate, type OpenFourTemplateConfig, } from '../domains/openfour/index.js';
 export { FOUR_TOKEN_LABELS, FOUR_BNB_RAISED_TOKEN_FALLBACK, parseRaisedTokens, publishedRaisedTokens, pickRaisedToken, isNativeRaisedToken, computeFourCreateValueWei, raisedTokenTradingFeeBps, } from '../domains/four/raised-token.js';
 export { createTokenOnChain, tryBuy, trySell, buyTokenWithFunds, sellToken, tradeBuy, tradeSell, type CreateOnChainParams, type TryBuyResult, type TrySellResult, } from '../domains/four/contracts/tm.js';
 export { TM1, type FourChainV1 } from '../domains/four/contracts/tm1.js';

package/dist/exports/root-foundations.js

@@ -50,7 +50,7 @@ checkAllowanceRaw, approveTokenRaw, checkAllowanceBatchRaw, approveTokenBatchRaw
 export { parseFourError } from '../utils/errors.js';
 export { getTokenManagerV1, getTokenManagerV2, getTokenManagerHelper3, getTokenManagerV1Writer, getTokenManagerV2Writer, getTokenManagerHelper3Writer, getTokenManagerAddress, } from '../utils/contract-factory.js';
 export { FourClient, buildLoginMessage, buildCreateTokenReq, } from '../core/clients/four.js';
-export { collectOpenFourSchemaParams, computeOpenFourCreateValueWei, decodeOpenFourCreateArg, defaultOpenFourFormFromSchema, emptyOpenFourInitParams, encodeOpenFourInitParams, encodeOpenFourModuleParams, isOpenFourPresaleNative, loadOpenFourAddresses, loadOpenFourPresetSchemas, } from '../domains/openfour/index.js';
+export { OPENFOUR_CREATE_EXPIRED_MESSAGE, OPENFOUR_CREATE_MIN_REMAIN_SEC, collectOpenFourSchemaParams, computeOpenFourCreateValueWei, decodeOpenFourCreateArg, defaultOpenFourFormFromSchema, emptyOpenFourInitParams, encodeOpenFourInitParams, encodeOpenFourModuleParams, isOpenFourPresaleNative, shouldRefreshOpenFourCreateArg, loadOpenFourAddresses, loadOpenFourPresetSchemas, } from '../domains/openfour/index.js';
 export { FOUR_TOKEN_LABELS, FOUR_BNB_RAISED_TOKEN_FALLBACK, parseRaisedTokens, publishedRaisedTokens, pickRaisedToken, isNativeRaisedToken, computeFourCreateValueWei, raisedTokenTradingFeeBps, } from '../domains/four/raised-token.js';
 export { createTokenOnChain, tryBuy, trySell, buyTokenWithFunds, sellToken, tradeBuy, tradeSell, } from '../domains/four/contracts/tm.js';
 export { TM1 } from '../domains/four/contracts/tm1.js';

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

@@ -10,6 +10,9 @@ export type { DisperseHopPath } from './types/hop-chains.js';
 export declare const NATIVE_TRANSFER_GAS_LIMIT: 21055n;
 export declare const ERC20_TRANSFER_GAS_LIMIT_HOP: 120000n;
 export declare const BRIBE_GAS_LIMIT: 21000n;
+/** 末跳且买地址自备 gas 时，hop 不再转发原生币，ERC20 必须从 nonce 0 起。 */
+export declare function hopForwardsNativeGas(index: number, hopCount: number, finalGasAmount: bigint): boolean;
+export declare function hopErc20Nonce(index: number, hopCount: number, finalGasAmount: bigint): number;
 /**
  * 给交易对象附加 gasPrice/maxFeePerGas（根据 txType）
  */
@@ -25,7 +28,7 @@ export declare function buildNativeHopChain(payer: Wallet, path: DisperseHopPath
 /**
  * 构建 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[]>;
+export declare function buildERC20HopChain(payer: Wallet, path: DisperseHopPath, erc20Address: string, erc20Amount: bigint, gasPrice: bigint, chainId: number, txType: 0 | 2, payerNonce: number, finalNativeForwardAmount?: bigint): Promise<string[]>;
 /**
  * 构建 BNB 多跳转账链（为 ERC20 中间钱包预留 gas）
  */

package/dist/utils/hop-chains.js

@@ -11,6 +11,15 @@ 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;
+/** 末跳且买地址自备 gas 时，hop 不再转发原生币，ERC20 必须从 nonce 0 起。 */
+export function hopForwardsNativeGas(index, hopCount, finalGasAmount) {
+    if (hopCount <= 0 || index < 0 || index >= hopCount)
+        return false;
+    return !(index === hopCount - 1 && finalGasAmount === 0n);
+}
+export function hopErc20Nonce(index, hopCount, finalGasAmount) {
+    return hopForwardsNativeGas(index, hopCount, finalGasAmount) ? 1 : 0;
+}
 /**
  * 给交易对象附加 gasPrice/maxFeePerGas（根据 txType）
  */
@@ -107,7 +116,7 @@ export async function buildNativeHopChain(payer, path, finalAmount, gasPrice, ch
 /**
  * 构建 ERC20 多跳转账链（需要配合 BNB 多跳使用）
  */
-export async function buildERC20HopChain(payer, path, erc20Address, erc20Amount, gasPrice, chainId, txType, payerNonce) {
+export async function buildERC20HopChain(payer, path, erc20Address, erc20Amount, gasPrice, chainId, txType, payerNonce, finalNativeForwardAmount = 0n) {
     const signedTxs = [];
     const hopCount = path.hopWallets.length;
     const erc20Interface = new ethers.Interface(ERC20_ABI);
@@ -139,7 +148,7 @@ export async function buildERC20HopChain(payer, path, erc20Address, erc20Amount,
     };
     applyTxTypeGas(firstTx, gasPrice, txType);
     signedTxs.push(await payer.signTransaction(firstTx));
-    // hop1 → hop2 → ... → target (nonce=1，nonce=0 用于 BNB 转发)
+    // hop1 → hop2 → ... → target。末跳若不再转发 BNB，ERC20 用 nonce=0。
     for (let i = 0; i < hopCount; i++) {
         const fromWallet = path.hopWallets[i];
         const toAddress = i === hopCount - 1 ? path.targetAddress : path.hopWallets[i + 1].address;
@@ -148,7 +157,7 @@ export async function buildERC20HopChain(payer, path, erc20Address, erc20Amount,
             to: erc20Address,
             data,
             value: 0n,
-            nonce: 1, // nonce=0 已用于 BNB 转发
+            nonce: hopErc20Nonce(i, hopCount, finalNativeForwardAmount),
             gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
             chainId,
             type: txType,
@@ -197,7 +206,7 @@ export async function buildBNBHopChainForERC20(payer, path, finalGasAmount, gasP
         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];
-        if (i === hopCount - 1 && amount === 0n)
+        if (!hopForwardsNativeGas(i, hopCount, finalGasAmount))
             continue;
         const tx = {
             to: toAddress,

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

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

package/dist/utils/hop-chains.test.js

@@ -0,0 +1,16 @@
+import { describe, expect, it } from 'vitest';
+import { hopErc20Nonce, hopForwardsNativeGas } from './hop-chains.js';
+describe('hopErc20Nonce', () => {
+    it('uses nonce 0 on a single hop when the buyer keeps its own gas', () => {
+        expect(hopForwardsNativeGas(0, 1, 0n)).toBe(false);
+        expect(hopErc20Nonce(0, 1, 0n)).toBe(0);
+    });
+    it('keeps nonce 1 on intermediate hops and 0 on the last hop', () => {
+        expect(hopErc20Nonce(0, 2, 0n)).toBe(1);
+        expect(hopErc20Nonce(1, 2, 0n)).toBe(0);
+    });
+    it('uses nonce 1 on the last hop when it also forwards native gas', () => {
+        expect(hopForwardsNativeGas(0, 1, 1n)).toBe(true);
+        expect(hopErc20Nonce(0, 1, 1n)).toBe(1);
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "four-flap-meme-sdk",
-  "version": "4.3.13",
+  "version": "4.3.15",
   "description": "SDK for Flap bonding curve and four.meme TokenManager",
   "type": "module",
   "main": "dist/index.js",