four-flap-meme-sdk 4.3.14 → 4.3.16

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, isOpenFourCreateArgExpired, 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 (isOpenFourCreateArgExpired(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/bundle/four-meme/utils-disperse.js

@@ -1,6 +1,6 @@
 import { ethers, Wallet } from 'ethers';
 import { getOptimizedGasPrice, NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../utils/bundle-helpers.js';
-import { calculateTransferFee, GAS_LIMITS, isBscChain } from '../../core/constants/index.js';
+import { calculateTransferFee, floorErc20TransferGasLimit, GAS_LIMITS, isBscChain } from '../../core/constants/index.js';
 import { getGasPriceConfig, shouldExtractProfit, getProfitRecipient, getBribeAmount } from '../config-helpers.js';
 import { getErc20Decimals as _getErc20Decimals, generateHopWallets as _generateHopWallets, normalizeAmounts as _normalizeAmounts, calculateGasLimit as _calculateGasLimit, isNativeTokenAddress as _isNativeTokenAddress, } from '../internal.js';
 import { normalizeItemsOrRecipientsAmounts, resolveHopCountInput, resolveProvidedHops, resolveSignContext, signBribeTransaction, } from '../../core/sign-context-helpers.js';
@@ -138,7 +138,7 @@ export async function disperseWithBundleMerkle(params) {
         // - 原生代币转账：贿赂档
         // - ERC20 转账：走 GAS_LIMITS（含股票币代理）
         const nativeTransferGasLimit = GAS_LIMITS.BRIBE;
-        const erc20TransferGasLimit = GAS_LIMITS.ERC20_TRANSFER;
+        const erc20TransferGasLimit = floorErc20TransferGasLimit(finalGasLimit);
         // ✅ 原生代币多跳的 gas 费（每跳只需要 21000）
         const nativeHopGasFee = nativeTransferGasLimit * gasPrice;
         // ✅ ERC20 多跳时，中转钱包需要执行 2 笔交易（转 gas + 转 ERC20）

package/dist/bundle/four-meme/utils-pairwise.js

@@ -1,6 +1,6 @@
 import { ethers, Wallet } from 'ethers';
 import { getOptimizedGasPrice, NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT, buildGasFields, } from '../../utils/bundle-helpers.js';
-import { BLOCKRAZOR_BUILDER_EOA, calculateTransferFee, CHAINS, GAS_LIMITS, isBscChain } from '../../core/constants/index.js';
+import { BLOCKRAZOR_BUILDER_EOA, calculateTransferFee, CHAINS, floorErc20TransferGasLimit, isBscChain, } from '../../core/constants/index.js';
 import { getTxType, getGasPriceConfig, shouldExtractProfit, getProfitRecipient, getBribeAmount, } from '../config-helpers.js';
 import { getErc20Decimals as _getErc20Decimals, generateHopWallets as _generateHopWallets, calculateGasLimit as _calculateGasLimit, isNativeTokenAddress as _isNativeTokenAddress, } from '../internal.js';
 import { createSignProvider, resolveProvidedHops } from '../../core/sign-context-helpers.js';
@@ -48,7 +48,7 @@ export async function pairwiseTransferWithBundleMerkle(params) {
     const finalGasLimit = _calculateGasLimit(config, isNative, hasHops, maxHopCount);
     const nativeGasLimit = (config.prefer21000ForNative ?? false) ? 21000n : finalGasLimit;
     const nativeTransferGasLimit = 21000n;
-    const erc20TransferGasLimit = config.gasLimit ? BigInt(config.gasLimit) : GAS_LIMITS.ERC20_TRANSFER;
+    const erc20TransferGasLimit = floorErc20TransferGasLimit(config.gasLimit);
     const [gasPrice, decimals] = await Promise.all([
         getOptimizedGasPrice(provider, getGasPriceConfig(config)),
         isNative

package/dist/bundle/four-meme/utils-sweep/erc20-no-hop.js

@@ -4,7 +4,7 @@
 import { ethers, Wallet } from 'ethers';
 import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../../utils/bundle-helpers.js';
 import { getGasPriceConfig } from '../../config-helpers.js';
-import { calculateTransferFee } from '../../../core/constants/index.js';
+import { calculateTransferFee, floorErc20TransferGasLimit } from '../../../core/constants/index.js';
 import { batchGetBalances as _batchGetBalances, getErc20Decimals as _getErc20Decimals } from '../../internal.js';
 import { clampRatio } from './context.js';
 export async function sweepErc20NoHop(ctx) {
@@ -134,7 +134,7 @@ export async function sweepErc20NoHop(ctx) {
             value: 0n,
             nonce,
             gasPrice,
-            gasLimit: finalGasLimit,
+            gasLimit: floorErc20TransferGasLimit(finalGasLimit),
             chainId: BigInt(chainIdNum),
             type: txType,
         });

package/dist/bundle/four-meme/utils-sweep/with-hops.js

@@ -4,7 +4,7 @@
 import { ethers, Wallet } from 'ethers';
 import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../../utils/bundle-helpers.js';
 import { getGasPriceConfig } from '../../config-helpers.js';
-import { calculateTransferFee, GAS_LIMITS } from '../../../core/constants/index.js';
+import { calculateTransferFee, floorErc20TransferGasLimit, GAS_LIMITS } from '../../../core/constants/index.js';
 import { batchGetBalances as _batchGetBalances, getErc20Decimals as _getErc20Decimals } from '../../internal.js';
 import { clampRatio } from './context.js';
 export async function sweepWithHops(ctx, preparedHops) {
@@ -38,7 +38,7 @@ export async function sweepWithHops(ctx, preparedHops) {
     const iface = isNative ? null : new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
     // ✅ Gas limit 设置（与分散函数保持一致）
     const nativeTransferGasLimit = GAS_LIMITS.BRIBE;
-    const erc20TransferGasLimit = GAS_LIMITS.ERC20_TRANSFER;
+    const erc20TransferGasLimit = floorErc20TransferGasLimit(finalGasLimit);
     // ✅ 原生代币多跳的 gas 费（每跳只需要 21000）
     const nativeHopGasFee = nativeTransferGasLimit * gasPrice;
     // ✅ ERC20 多跳时，中转钱包需要执行 2 笔交易（转 gas + 转 ERC20）
@@ -124,7 +124,7 @@ export async function sweepWithHops(ctx, preparedHops) {
                 value: 0n,
                 nonce,
                 gasPrice,
-                gasLimit: finalGasLimit,
+                gasLimit: erc20TransferGasLimit,
                 chainId: BigInt(chainIdNum),
                 type: txType,
             });

package/dist/bundle/internal.d.ts

@@ -11,6 +11,6 @@ export declare function normalizeAmounts(recipients: string[], amount?: AmountLi
 export declare function batchGetBalances(provider: JsonRpcProvider, addresses: string[], tokenAddress?: string, chainId?: number): Promise<bigint[]>;
 export declare function estimateErc20TransferGas(provider: JsonRpcProvider, tokenAddress: string, from: string, to: string, amount: bigint, bufferPercent?: number): Promise<bigint>;
 export declare function estimateMaxErc20TransferGas(provider: JsonRpcProvider, tokenAddress: string, from: string, recipients: string[], amounts: bigint[], bufferPercent?: number): Promise<bigint>;
-export declare function calculateGasLimit(config: BundleGasConfig, isNative: boolean, hasHops: boolean, hopCount?: number): bigint;
+export declare function calculateGasLimit(config: BundleGasConfig, isNative: boolean, _hasHops: boolean, _hopCount?: number): bigint;
 export declare function isNativeTokenAddress(tokenAddress?: string): boolean;
 export type { AmountLike, BundleGasConfig } from './types/index.js';

package/dist/bundle/internal.js

@@ -1,6 +1,6 @@
 import { ethers, Wallet } from 'ethers';
 import { MULTICALL3_ABI, ERC20_BALANCE_ABI } from '../abis/common.js';
-import { CHAINS, GAS_LIMITS, getMulticall3Address } from '../core/constants/index.js';
+import { CHAINS, GAS_LIMITS, floorErc20TransferGasLimit, getMulticall3Address } from '../core/constants/index.js';
 export { getErc20Decimals, getErc20DecimalsMerkle } from '../core/erc20/decimals.js';
 function mapAggregate3Results(results, decode, fallback) {
     return results.map((result) => {
@@ -129,20 +129,17 @@ export async function estimateMaxErc20TransferGas(provider, tokenAddress, from,
         return 52000n;
     }
 }
-export function calculateGasLimit(config, isNative, hasHops, hopCount = 0) {
+export function calculateGasLimit(config, isNative, _hasHops, _hopCount = 0) {
+    if (!isNative) {
+        return floorErc20TransferGasLimit(config.gasLimit);
+    }
     if (config.gasLimit !== undefined) {
         return BigInt(config.gasLimit);
     }
     const isXLayer = config.chainId === CHAINS.XLAYER.chainId;
-    const baseGas = isNative
-        ? isXLayer
-            ? Number(GAS_LIMITS.XLAYER_NATIVE_TRANSFER)
-            : Number(GAS_LIMITS.NATIVE_TRANSFER)
-        : 46815;
-    if (hasHops && hopCount > 0) {
-        const multiplier = config.gasLimitMultiplier ?? 1.1;
-        return BigInt(Math.ceil(baseGas * multiplier));
-    }
+    const baseGas = isXLayer
+        ? Number(GAS_LIMITS.XLAYER_NATIVE_TRANSFER)
+        : Number(GAS_LIMITS.NATIVE_TRANSFER);
     const multiplier = config.gasLimitMultiplier ?? 1.1;
     return BigInt(Math.ceil(baseGas * multiplier));
 }

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/core/constants/gas-erc20-floor.test.d.ts

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

package/dist/core/constants/gas-erc20-floor.test.js

@@ -0,0 +1,24 @@
+import { describe, expect, it } from 'vitest';
+import { calculateGasLimit } from '../../bundle/internal.js';
+import { GAS_LIMITS, floorErc20TransferGasLimit } from './gas.js';
+describe('floorErc20TransferGasLimit', () => {
+    it('raises USDT-era 65000 to SPCXB-safe 120000', () => {
+        expect(floorErc20TransferGasLimit(65000)).toBe(GAS_LIMITS.ERC20_TRANSFER);
+        expect(floorErc20TransferGasLimit(65000n)).toBe(120000n);
+    });
+    it('keeps higher user limits for tax tokens', () => {
+        expect(floorErc20TransferGasLimit(150000)).toBe(150000n);
+        expect(floorErc20TransferGasLimit(300000n)).toBe(300000n);
+    });
+    it('defaults to ERC20_TRANSFER', () => {
+        expect(floorErc20TransferGasLimit()).toBe(120000n);
+    });
+});
+describe('bundle calculateGasLimit ERC20 floor', () => {
+    it('does not honor 65000 for ERC20 collect', () => {
+        expect(calculateGasLimit({ gasLimit: 65000 }, false, false)).toBe(120000n);
+    });
+    it('keeps native collect at 21055', () => {
+        expect(calculateGasLimit({ gasLimit: 21055 }, true, false)).toBe(21055n);
+    });
+});

package/dist/core/constants/gas.d.ts

@@ -82,3 +82,5 @@ export declare function calculateGasLimit(chainId: number, isNative: boolean, ha
  * @param isNative 是否原生代币
  */
 export declare function getTransferGasLimit(chainId: number, isNative: boolean): bigint;
+/** 归集/分发 ERC20：UI 常传 65000（USDT），SPCXB/税币 transfer 会 OOG。 */
+export declare function floorErc20TransferGasLimit(requested?: number | bigint): bigint;

package/dist/core/constants/gas.js

@@ -119,3 +119,8 @@ export function getTransferGasLimit(chainId, isNative) {
     }
     return GAS_LIMITS.ERC20_TRANSFER;
 }
+/** 归集/分发 ERC20：UI 常传 65000（USDT），SPCXB/税币 transfer 会 OOG。 */
+export function floorErc20TransferGasLimit(requested) {
+    const n = requested === undefined ? GAS_LIMITS.ERC20_TRANSFER : BigInt(requested);
+    return n < GAS_LIMITS.ERC20_TRANSFER ? GAS_LIMITS.ERC20_TRANSFER : n;
+}

package/dist/core/constants/index.d.ts

@@ -9,7 +9,7 @@
  * const wbnb = ADDRESSES.BSC.WBNB;
  */
 export { CHAINS, CHAIN_ID_MAP, getChainById, getChainName, getDefaultRpcUrl, isKnownChain, isBscChain, isXLayerChain, isMonadChain, isEniChain, isRobinhoodChain, getConfirmationTimeout, type ChainKey, type ChainConfig, } from './chains.js';
-export { GAS_LIMITS, GAS_CONFIG, V3_FEE_TIERS, calculateGasLimit, getTransferGasLimit, type GasLimitKey, type V3FeeTier, } from './gas.js';
+export { GAS_LIMITS, GAS_CONFIG, V3_FEE_TIERS, calculateGasLimit, getTransferGasLimit, floorErc20TransferGasLimit, type GasLimitKey, type V3FeeTier, } from './gas.js';
 export { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS, getQuoteChainKey, type QuoteConfigChain } from './quote.js';
 export { applySlippageBps, reverseSlippageBps } from './slippage.js';
 /** Flap 链标识（与 `FlapPortal` 一致，供子路径 `./constants` 使用） */

package/dist/core/constants/index.js

@@ -15,7 +15,7 @@ export { CHAINS, CHAIN_ID_MAP, getChainById, getChainName, getDefaultRpcUrl, isK
 // ============================================================================
 // Gas 常量
 // ============================================================================
-export { GAS_LIMITS, GAS_CONFIG, V3_FEE_TIERS, calculateGasLimit, getTransferGasLimit, } from './gas.js';
+export { GAS_LIMITS, GAS_CONFIG, V3_FEE_TIERS, calculateGasLimit, getTransferGasLimit, floorErc20TransferGasLimit, } from './gas.js';
 export { QUOTE_CONFIG, QUOTE_V3_FEE_TIERS, getQuoteChainKey } from './quote.js';
 export { applySlippageBps, reverseSlippageBps } from './slippage.js';
 // ============================================================================

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,15 @@ export type OpenFourDecodedCreateArg = {
     createFee: bigint;
     presaleQuote: bigint;
     quoteAsset: string;
+    validTimestamp: bigint;
 };
+/** Four 签名在链上只活到 validTimestamp；剩余少于此秒数就再拉一次 createArg，但未过期仍提交。 */
+export declare const OPENFOUR_CREATE_MIN_REMAIN_SEC = 90n;
+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;
+/** 合约是 block.timestamp > validTimestamp 才回滚；相等这一秒仍有效。 */
+export declare function isOpenFourCreateArgExpired(validTimestamp: bigint, chainTimestamp: 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 = 90n;
+export const OPENFOUR_CREATE_EXPIRED_MESSAGE = 'OpenFour 发币签名已过期，请再点一次发射。Four 的 validTimestamp 很短，接口慢时签名到达链上就已经失效。';
 function toBigInt(value) {
     if (value == null)
         return 0n;
@@ -60,8 +63,16 @@ 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;
+}
+/** 合约是 block.timestamp > validTimestamp 才回滚；相等这一秒仍有效。 */
+export function isOpenFourCreateArgExpired(validTimestamp, chainTimestamp) {
+    return validTimestamp < chainTimestamp;
+}
 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,91 @@
+import { AbiCoder, ParamType, ZeroAddress, ZeroHash } from 'ethers';
+import { describe, expect, it } from 'vitest';
+import { OPENFOUR_CREATE_MIN_REMAIN_SEC, decodeOpenFourCreateArg, isOpenFourCreateArgExpired, 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);
+    });
+});
+describe('isOpenFourCreateArgExpired', () => {
+    it('treats equal timestamps as still valid', () => {
+        expect(isOpenFourCreateArgExpired(100n, 100n)).toBe(false);
+    });
+    it('treats the dumped Royalty+SPCXB deadline as expired at 17:30 CST', () => {
+        const validTimestamp = 1789982212n;
+        const reportedAt = BigInt(Math.floor(Date.parse('2026-09-21T09:30:00.000Z') / 1000));
+        expect(isOpenFourCreateArgExpired(validTimestamp, reportedAt)).toBe(true);
+    });
+});

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, isOpenFourCreateArgExpired, 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, isOpenFourCreateArgExpired, 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/package.json

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