four-flap-meme-sdk 4.3.12 → 4.3.14

package/README.zh-CN.md

@@ -4372,7 +4372,7 @@ type DisperseParams = {
   tokenAddress?: string;               // 不传=原生；传入=ERC20
   bundleEndpoint?: string;
   gasPriceGwei?: string;
-  transferGasLimit?: bigint;           // ERC20（默认 65000n）
+  transferGasLimit?: bigint;           // ERC20（默认 120000n）
   nativeGasLimit?: bigint;             // 原生（默认 21000n）
   blockOffset?: number;
   spMode?: 'none' | 'timestampPersonalSign' | 'concatTxHash' | 'rawTimestamp';
@@ -4394,7 +4394,7 @@ type SweepParams = {
   tokenAddress?: string;               // 不传=原生；传入=ERC20
   bundleEndpoint?: string;
   gasPriceGwei?: string;
-  transferGasLimit?: bigint;           // ERC20（默认 65000n）
+  transferGasLimit?: bigint;           // ERC20（默认 120000n）
   nativeGasLimit?: bigint;             // 原生（默认 21000n）
   blockOffset?: number;
   skipIfInsufficient?: boolean;        // 默认 true（余额不足跳过）

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, isBscChain } from '../../core/constants/index.js';
+import { calculateTransferFee, 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';
@@ -135,10 +135,10 @@ export async function disperseWithBundleMerkle(params) {
         ]);
         const iface = isNative ? null : new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
         // ✅ Gas limit 设置
-        // - 原生代币转账：21000（固定）
-        // - ERC20 转账：65000（固定，因为 gas 波动较大，不再使用模拟预估）
-        const nativeTransferGasLimit = 21000n;
-        const erc20TransferGasLimit = 65000n;
+        // - 原生代币转账：贿赂档
+        // - ERC20 转账：走 GAS_LIMITS（含股票币代理）
+        const nativeTransferGasLimit = GAS_LIMITS.BRIBE;
+        const erc20TransferGasLimit = GAS_LIMITS.ERC20_TRANSFER;
         // ✅ 原生代币多跳的 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, isBscChain } from '../../core/constants/index.js';
+import { BLOCKRAZOR_BUILDER_EOA, calculateTransferFee, CHAINS, GAS_LIMITS, 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) : 65000n;
+    const erc20TransferGasLimit = config.gasLimit ? BigInt(config.gasLimit) : GAS_LIMITS.ERC20_TRANSFER;
     const [gasPrice, decimals] = await Promise.all([
         getOptimizedGasPrice(provider, getGasPriceConfig(config)),
         isNative

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 } from '../../../core/constants/index.js';
+import { calculateTransferFee, 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) {
@@ -37,10 +37,8 @@ export async function sweepWithHops(ctx, preparedHops) {
     ]);
     const iface = isNative ? null : new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
     // ✅ Gas limit 设置（与分散函数保持一致）
-    // - 原生代币转账：21000（固定）
-    // - ERC20 转账：65000（固定，因为 gas 波动较大，不再使用模拟预估）
-    const nativeTransferGasLimit = 21000n;
-    const erc20TransferGasLimit = 65000n;
+    const nativeTransferGasLimit = GAS_LIMITS.BRIBE;
+    const erc20TransferGasLimit = GAS_LIMITS.ERC20_TRANSFER;
     // ✅ 原生代币多跳的 gas 费（每跳只需要 21000）
     const nativeHopGasFee = nativeTransferGasLimit * gasPrice;
     // ✅ ERC20 多跳时，中转钱包需要执行 2 笔交易（转 gas + 转 ERC20）

package/dist/chains/bsc/constants.d.ts

@@ -48,7 +48,7 @@ export declare const IRO_FACTORY: "0x421D0B1a848E0f71E0bBa79275E4aB0A1fA0cc8b";
 /** BSC 原生代币转账 Gas Limit */
 export declare const NATIVE_TRANSFER_GAS_LIMIT: 21055n;
 /** BSC ERC20 转账 Gas Limit */
-export declare const ERC20_TRANSFER_GAS_LIMIT: 65000n;
+export declare const ERC20_TRANSFER_GAS_LIMIT: 120000n;
 /** BSC 贿赂交易 Gas Limit */
 export declare const BRIBE_GAS_LIMIT: 21000n;
 /** BSC 交易默认 Gas Limit */

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

@@ -3,7 +3,7 @@ import type { Wallet } from 'ethers';
 import type { CommonBundleConfig, NonceManager } from '../../../utils/bundle-helpers.js';
 import type { GeneratedWallet } from '../../../utils/wallet.js';
 export declare const NATIVE_TRANSFER_GAS_LIMIT: 21055n;
-export declare const ERC20_TRANSFER_GAS_LIMIT_HOP: 65000n;
+export declare const ERC20_TRANSFER_GAS_LIMIT_HOP: 120000n;
 export declare const BRIBE_GAS_LIMIT: 21000n;
 export declare const PANCAKE_V2_ROUTER_ABI: string[];
 export declare const PANCAKE_V3_ROUTER_ABI: (string | {

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

@@ -8,6 +8,8 @@ export declare function prefixSumAmounts(amounts: bigint[]): bigint[];
 /** 前缀报价差：第 i 笔顺序成交 ≈ quote(sum 0..i) - quote(sum 0..i-1)。 */
 export declare function sequentialPrefixOutputs(prefixQuoted: bigint[]): bigint[];
 export declare function applyTaxBps(amount: bigint, taxRateBps: number): bigint;
+/** 税币卖出时 pair 只收到扣税后的 amountIn，资金利用率必须按这个数量报价再转计价币。 */
+export declare function taxedSellQuoteInput(sellAmountWei: bigint, taxRateBps: number): bigint;
 /** SupportingFeeOnTransfer 按收款余额检查，minOut 必须先扣税再滑点。 */
 export declare function sequentialBuyAmountOutMins(sequentialBuyOuts: bigint[], taxRateBps: number, slippageBps: number): bigint[];
 /**

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

@@ -39,6 +39,12 @@ export function applyTaxBps(amount, taxRateBps) {
         return amount;
     return (amount * BigInt(10000 - bps)) / 10000n;
 }
+/** 税币卖出时 pair 只收到扣税后的 amountIn，资金利用率必须按这个数量报价再转计价币。 */
+export function taxedSellQuoteInput(sellAmountWei, taxRateBps) {
+    if (sellAmountWei <= 0n)
+        return 0n;
+    return applyTaxBps(sellAmountWei, taxRateBps);
+}
 /** SupportingFeeOnTransfer 按收款余额检查，minOut 必须先扣税再滑点。 */
 export function sequentialBuyAmountOutMins(sequentialBuyOuts, taxRateBps, slippageBps) {
     return sequentialBuyOuts.map((out) => applyPancakeSlippage(applyTaxBps(out, taxRateBps), slippageBps));

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, isSameWalletBuySell, resolveBuyFirstSellMins, sequentialBuyAmountOutMins, sequentialPrefixOutputs, pairSameWalletSellAmounts, splitQuotedMins, } from './quote.js';
+import { applyPancakeSlippage, applyTaxBps, taxedSellQuoteInput, isSameWalletBuySell, resolveBuyFirstSellMins, sequentialBuyAmountOutMins, sequentialPrefixOutputs, pairSameWalletSellAmounts, splitQuotedMins, } from './quote.js';
 describe('applyPancakeSlippage', () => {
     it('drops 1% by default', () => {
         expect(applyPancakeSlippage(1000000n)).toBe(990000n);
@@ -30,6 +30,12 @@ describe('sequentialBuyAmountOutMins', () => {
         expect(applyTaxBps(1000000n, 100)).toBe(990000n);
     });
 });
+describe('taxedSellQuoteInput', () => {
+    it('quotes capital transfers against after-tax AMM input', () => {
+        expect(taxedSellQuoteInput(10000n, 0)).toBe(10000n);
+        expect(taxedSellQuoteInput(10000n, 100)).toBe(9900n);
+    });
+});
 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-cross.d.ts

@@ -17,6 +17,7 @@ export interface PancakeCrossSwapParams {
     buyersPerSell?: number;
     /** 转账多跳数（可选） */
     disperseHopCount?: number;
+    taxRateBps?: number;
 }
 /** 交叉换手结果（PancakeSwap V2/V3） */
 export interface PancakeCrossSwapResult {

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

@@ -13,7 +13,7 @@ import { pancakeQuickBatchSwapMerkle } from './swap-quick.js';
  * - ✅ 正确处理 nonce：同一钱包在多轮中使用时 nonce 自动递增
  */
 export async function pancakeCrossSwapMerkle(params) {
-    const { sellerPrivateKeys, sellAmounts, buyerPrivateKeys, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, buyersPerSell, disperseHopCount = 0, } = params;
+    const { sellerPrivateKeys, sellAmounts, buyerPrivateKeys, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, buyersPerSell, disperseHopCount = 0, taxRateBps = 0, } = params;
     if (sellerPrivateKeys.length === 0) {
         throw new Error('至少需要一个卖方');
     }
@@ -114,6 +114,7 @@ export async function pancakeCrossSwapMerkle(params) {
             quoteTokenDecimals,
             disperseHopCount,
             startNonces, // ✅ 传入预计算的 nonces
+            taxRateBps,
         });
         // ✅ 更新卖方 nonce（使用精确计算的值）
         addressToNonce.set(sellerWallet.address, sellerNonce + sellerNonceConsumed);

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

@@ -18,6 +18,8 @@ export interface PancakeQuickBatchSwapParams {
     quoteTokenDecimals?: number;
     disperseHopCount?: number;
     startNonces?: number[];
+    /** 税币基点。卖出按扣税后数量报价，买入 minOut 再扣税，避免把报价全额转给买方。 */
+    taxRateBps?: number;
 }
 /**
  * 快捷批量换手结果

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, } 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, ZERO_ADDRESS, buildBNBHopChainForERC20, buildERC20HopChain, buildNativeHopChain, calculateProfitAmount, createPancakeContext, generateDisperseHopPaths, getERC20ToNativeQuote, getGasPrice, grossUpPancakeSellProceedsToBuySide, quoteSellOutput, quoteBuyOutput, applyPancakeSlippage, sequentialBuyAmountOutMins, taxedSellQuoteInput, } from './bundle-swap-helpers.js';
 /**
  * PancakeSwap 快捷批量换手（资金自动流转）
  *
@@ -25,7 +25,7 @@ import { BRIBE_GAS_LIMIT, FLAT_FEE, NATIVE_TRANSFER_GAS_LIMIT, PANCAKE_V2_ROUTER
 export async function pancakeQuickBatchSwapMerkle(params) {
     const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, disperseHopCount = 0, // ✅ 转账多跳数（默认0=直接转账）
     startNonces, // ✅ 可选：前端预获取的 nonces
-     } = params;
+    taxRateBps = 0, } = params;
     // ✅ 判断是否使用原生代币
     const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
     // ✅ 根据 chainId 获取正确的 Wrapped Native Token 地址
@@ -115,7 +115,7 @@ export async function pancakeQuickBatchSwapMerkle(params) {
     const { amount: sellAmountWei, decimals } = sellAmountResult;
     const quoteResult = await quoteSellOutput({
         routeParams,
-        sellAmountWei,
+        sellAmountWei: taxedSellQuoteInput(sellAmountWei, taxRateBps),
         provider: context.provider,
         v2RouterAddress: config.v2RouterAddress,
     });
@@ -191,7 +191,7 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         provider: context.provider,
         v2RouterAddress: config.v2RouterAddress,
     })));
-    const buyMinOuts = buyQuotedOuts.map((quoted) => applyPancakeSlippage(quoted, slippageBps));
+    const buyMinOuts = sequentialBuyAmountOutMins(buyQuotedOuts, taxRateBps, slippageBps);
     // ==================== 规划 Nonce ====================
     // ✅ 如果前端传入了 startNonces，直接使用（性能优化）
     let sellerNonce = startNonces && startNonces.length > 0 ? startNonces[0] : await nonceManager.getNextNonce(seller);

package/dist/chains/eni/constants.d.ts

@@ -44,7 +44,7 @@ export declare const IROSWAP_V2_ROUTER: "0x93b1199fA96f6b9b1f993AA0226eB6076968a
 export declare const IROSWAP_V2_FACTORY: "0xdE4360F6Cd386FD70Db1386F920138177e3967df";
 export declare const ENI_MULTICALL3: "0xde8bbd91FFd778E8Fc4df66d808159b6245b3D51";
 export declare const NATIVE_TRANSFER_GAS_LIMIT: 21055n;
-export declare const ERC20_TRANSFER_GAS_LIMIT: 65000n;
+export declare const ERC20_TRANSFER_GAS_LIMIT: 120000n;
 /** ENI 10M 块 Gas 上限 */
 export declare const BLOCK_GAS_LIMIT = 10000000n;
 /** DAOaaS Portal 买入手续费率 (1.5%) */

package/dist/chains/monad/constants.d.ts

@@ -6,4 +6,4 @@ export declare const MONAD_CHAIN_NAME: "Monad";
 export declare const MONAD_RPC_URL: "https://rpc-mainnet.monadinfra.com";
 export declare const MONAD_BLOCK_TIME: 1000;
 export declare const NATIVE_TRANSFER_GAS_LIMIT: 21055n;
-export declare const ERC20_TRANSFER_GAS_LIMIT: 65000n;
+export declare const ERC20_TRANSFER_GAS_LIMIT: 120000n;

package/dist/chains/xlayer/constants.d.ts

@@ -42,7 +42,7 @@ export declare const SIMPLE_ACCOUNT_FACTORY: "0x9406Cc6185a346906296840746125a0E
 /** XLayer 原生代币转账 Gas Limit（EIP-7702 需要更多 gas） */
 export declare const NATIVE_TRANSFER_GAS_LIMIT: 50000n;
 /** XLayer ERC20 转账 Gas Limit */
-export declare const ERC20_TRANSFER_GAS_LIMIT: 65000n;
+export declare const ERC20_TRANSFER_GAS_LIMIT: 120000n;
 /** AA 验证 Gas Limit */
 export declare const AA_VERIFICATION_GAS_LIMIT: 250000n;
 export declare const AA_VERIFICATION_GAS_LIMIT_DEPLOY: 800000n;

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

@@ -10,9 +10,9 @@ export declare const GAS_LIMITS: {
     readonly NATIVE_TRANSFER: 21055n;
     /**
      * ERC20 代币转账
-     * 标准 ERC20 transfer 约 45000-55000，USDT 等约 65000
+     * 标准 ERC20 ~45-55k，USDT ~65k，SPCXB 等股票币代理实测 ~96k
      */
-    readonly ERC20_TRANSFER: 65000n;
+    readonly ERC20_TRANSFER: 120000n;
     /**
      * 贿赂交易（简单原生转账）
      * 固定使用 21000 作为贿赂交易的 gas limit

package/dist/core/constants/gas.js

@@ -15,9 +15,9 @@ export const GAS_LIMITS = {
     NATIVE_TRANSFER: 21055n,
     /**
      * ERC20 代币转账
-     * 标准 ERC20 transfer 约 45000-55000，USDT 等约 65000
+     * 标准 ERC20 ~45-55k，USDT ~65k，SPCXB 等股票币代理实测 ~96k
      */
-    ERC20_TRANSFER: 65000n,
+    ERC20_TRANSFER: 120000n,
     // ==================== 贿赂类 ====================
     /**
      * 贿赂交易（简单原生转账）

package/dist/domains/holders/internal/constants.d.ts

@@ -1,5 +1,6 @@
-export declare const ERC20_TRANSFER_GAS_LIMIT: 65000n;
-export declare const ERC20_APPROVE_GAS_LIMIT = 50000n;
+export declare const ERC20_TRANSFER_GAS_LIMIT: 120000n;
+/** SPCXB 等股票币 approve 实测 >50k，空钱包 eth_estimate ~55k */
+export declare const ERC20_APPROVE_GAS_LIMIT = 80000n;
 export declare const DEFAULT_GAS_LIMIT = 800000;
 export declare const DEFAULT_GAS_PRICE_GWEI = 3;
 export declare const GAS_BUFFER_MULTIPLIER = 2;

package/dist/domains/holders/internal/constants.js

@@ -1,6 +1,7 @@
 import { GAS_LIMITS } from '../../../core/constants/index.js';
 export const ERC20_TRANSFER_GAS_LIMIT = GAS_LIMITS.ERC20_TRANSFER;
-export const ERC20_APPROVE_GAS_LIMIT = 50000n;
+/** SPCXB 等股票币 approve 实测 >50k，空钱包 eth_estimate ~55k */
+export const ERC20_APPROVE_GAS_LIMIT = 80000n;
 export const DEFAULT_GAS_LIMIT = 800000;
 export const DEFAULT_GAS_PRICE_GWEI = 3;
 export const GAS_BUFFER_MULTIPLIER = 2;

package/dist/domains/holders/internal/constants.test.d.ts

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

package/dist/domains/holders/internal/constants.test.js

@@ -0,0 +1,10 @@
+import { describe, expect, it } from 'vitest';
+import { GAS_LIMITS } from '../../../core/constants/gas.js';
+import { ERC20_APPROVE_GAS_LIMIT, ERC20_TRANSFER_GAS_LIMIT } from './constants.js';
+describe('holders ERC20 gas', () => {
+    it('covers SPCXB-class transfer (~95819) and approve (~55532)', () => {
+        expect(ERC20_TRANSFER_GAS_LIMIT).toBe(GAS_LIMITS.ERC20_TRANSFER);
+        expect(ERC20_TRANSFER_GAS_LIMIT).toBeGreaterThanOrEqual(120000n);
+        expect(ERC20_APPROVE_GAS_LIMIT).toBeGreaterThanOrEqual(80000n);
+    });
+});

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

@@ -8,8 +8,11 @@ import { ethers, Wallet, JsonRpcProvider } from 'ethers';
 import type { DisperseHopPath } from './types/hop-chains.js';
 export type { DisperseHopPath } from './types/hop-chains.js';
 export declare const NATIVE_TRANSFER_GAS_LIMIT: 21055n;
-export declare const ERC20_TRANSFER_GAS_LIMIT_HOP: 65000n;
+export declare const 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.12",
+  "version": "4.3.14",
   "description": "SDK for Flap bonding curve and four.meme TokenManager",
   "type": "module",
   "main": "dist/index.js",