four-flap-meme-sdk 2.2.5 → 2.2.7

package/dist/shared/flap/portal-bundle-merkle/core.js

@@ -24,6 +24,21 @@ function resolveCreateTokenLaunchFlags(params) {
         params.migratorType === MigratorType.PCS_INFINITY_CL_MIGRATOR;
     return { normalizedTax, isTaxLaunch, hasVault, useV4Portal, useClInfinityLaunch };
 }
+/**
+ * 无捆绑钱包、仅 Dev 自跟买、原生报价 → Flap 文档方式 A（create 内 quoteAmt + msg.value）
+ */
+function canUseLaunchMethodA(privateKeys, buyAmounts, devAddress, useNativeToken) {
+    if (!useNativeToken || buyAmounts.length !== 1 || privateKeys.length !== 2) {
+        return false;
+    }
+    try {
+        const buyerAddr = new Wallet(privateKeys[1]).address;
+        return buyerAddr.toLowerCase() === devAddress.toLowerCase();
+    }
+    catch {
+        return false;
+    }
+}
 export async function createTokenWithBundleBuyMerkle(params) {
     const { chain, privateKeys, buyAmounts, tokenInfo, tokenAddress, config } = params;
     if (privateKeys.length === 0) {
@@ -40,6 +55,16 @@ export async function createTokenWithBundleBuyMerkle(params) {
     const originalPortalAddr = FLAP_ORIGINAL_PORTAL_ADDRESSES[chain];
     const portal = new ethers.Contract(originalPortalAddr, PORTAL_ABI, devWallet);
     const { normalizedTax, useV4Portal, useClInfinityLaunch } = resolveCreateTokenLaunchFlags(params);
+    const inputToken = params.quoteToken && params.quoteToken !== ZERO_ADDRESS ? params.quoteToken : ZERO_ADDRESS;
+    const useNativeToken = inputToken === ZERO_ADDRESS;
+    const extractProfit = config.extractProfitOnLaunch === false ? false : shouldExtractProfit(config);
+    const useMethodA = canUseLaunchMethodA(privateKeys, buyAmounts, devWallet.address, useNativeToken);
+    let methodAQuoteAmt = 0n;
+    let methodABuyMeta;
+    if (useMethodA) {
+        methodABuyMeta = analyzeBuyFunds(buyAmounts, config, extractProfit);
+        methodAQuoteAmt = methodABuyMeta.fundsList[0] ?? 0n;
+    }
     const createTxPromise = populateCreateTokenTransaction({
         chain,
         devWallet,
@@ -58,6 +83,7 @@ export async function createTokenWithBundleBuyMerkle(params) {
         useV4Portal,
         useClInfinityLaunch,
         taxConfig: normalizedTax,
+        initialQuoteAmt: useMethodA ? methodAQuoteAmt : 0n,
     });
     const [gasPrice, createTxUnsigned, devNonce] = await Promise.all([
         resolveGasPrice(provider, config),
@@ -72,19 +98,60 @@ export async function createTokenWithBundleBuyMerkle(params) {
         gasPrice,
         chainId,
         type: getTxType(config),
+        value: useMethodA ? methodAQuoteAmt : 0n,
     };
     const signedCreateTx = await devWallet.signTransaction(createTxRequest);
     signedTxs.push(signedCreateTx);
+    if (useMethodA && methodABuyMeta) {
+        const { totalBuyAmount, totalProfit } = methodABuyMeta;
+        const bribeAmount = getBribeAmount(config);
+        const bribeTxs = [];
+        let nextDevNonce = devNonce + 1;
+        if (bribeAmount > 0n) {
+            const bribeTx = await devWallet.signTransaction({
+                to: BLOCKRAZOR_BUILDER_EOA,
+                value: bribeAmount,
+                nonce: nextDevNonce,
+                gasPrice,
+                gasLimit: GAS_LIMITS.BRIBE,
+                chainId,
+                type: getTxType(config),
+            });
+            bribeTxs.push(bribeTx);
+            nextDevNonce += 1;
+        }
+        const profitTxs = [];
+        let profitHopWallets;
+        if (extractProfit && totalProfit > 0n) {
+            const profitHopResult = await buildProfitHopTransactions({
+                provider,
+                payerWallet: devWallet,
+                profitAmount: totalProfit,
+                profitRecipient: getProfitRecipient(),
+                hopCount: PROFIT_HOP_COUNT,
+                gasPrice,
+                chainId,
+                txType: getTxType(config),
+                startNonce: nextDevNonce,
+            });
+            profitTxs.push(...profitHopResult.signedTransactions);
+            profitHopWallets = profitHopResult.hopWallets;
+        }
+        nonceManager.clearTemp();
+        return {
+            signedTransactions: [...bribeTxs, ...signedTxs, ...profitTxs],
+            tokenAddress,
+            profitHopWallets,
+            metadata: {
+                ...buildProfitMetadata(extractProfit, totalBuyAmount, totalProfit, 0),
+                launchMethod: 'quoteAmt',
+            },
+        };
+    }
     const buyers = createWallets(privateKeys.slice(1), provider);
-    // 发币+捆绑买：默认刮利润（与 emitservice isAddressRevenue 末笔校验、BSC 白名单 slice(-3) 对齐）
-    // 仅当显式 extractProfitOnLaunch: false 时关闭（需后端同步放宽校验）
-    const extractProfit = config.extractProfitOnLaunch === false ? false : shouldExtractProfit(config);
     const { fundsList, originalAmounts, totalBuyAmount, totalProfit } = analyzeBuyFunds(buyAmounts, config, extractProfit);
     const maxFundsIndex = findMaxIndex(originalAmounts);
     const gasLimits = buildGasLimitList(buyers.length, config);
-    // ✅ 支持 quoteToken：如果传入了 quoteToken 且非零地址，则使用它
-    const inputToken = params.quoteToken && params.quoteToken !== ZERO_ADDRESS ? params.quoteToken : ZERO_ADDRESS;
-    const useNativeToken = inputToken === ZERO_ADDRESS;
     // ✅ 如果使用非原生代币（如 USDC），需要根据精度转换金额
     let adjustedFundsList = fundsList;
     let profitTokenAmount = totalProfit;
@@ -160,7 +227,10 @@ export async function createTokenWithBundleBuyMerkle(params) {
         signedTransactions: [...bribeTxs, ...signedTxs, ...signedBuys, ...profitTxs],
         tokenAddress,
         profitHopWallets, // ✅ 返回利润多跳钱包
-        metadata: buildProfitMetadata(extractProfit, totalBuyAmount, totalProfit, buyers.length),
+        metadata: {
+            ...buildProfitMetadata(extractProfit, totalBuyAmount, totalProfit, buyers.length),
+            launchMethod: 'swapExactInput',
+        },
     };
 }
 /**

package/dist/shared/flap/portal-create-token.d.ts

@@ -51,6 +51,8 @@ export type PopulateCreateTokenParams = {
     useClInfinityLaunch?: boolean;
     /** 高级税币 / 税币 V3 配置 */
     taxConfig?: NormalizedTaxLaunchConfig;
+    /** 创建时内嵌买入（Flap 文档方式 A：quoteAmt + msg.value） */
+    initialQuoteAmt?: bigint;
 };
 /** 将 TaxV2Config（含 distribution 嵌套）或 flat 结构归一化 */
 export declare function normalizeTaxLaunchConfig(input?: {
@@ -74,7 +76,4 @@ export declare function normalizeTaxLaunchConfig(input?: {
         minimumShareBalance?: number;
     };
 }, fallbackTaxRate?: number): NormalizedTaxLaunchConfig | undefined;
-/**
- * 构建发币 populateTransaction（优先 V6/V7，Vault 走 VaultPortal）
- */
 export declare function populateCreateTokenTransaction(params: PopulateCreateTokenParams): Promise<import("ethers").ContractTransaction>;

package/dist/shared/flap/portal-create-token.js

@@ -38,7 +38,7 @@ function buildV6TaxParams(params, taxConfig, dist) {
         salt: params.salt ?? zeroBytes32(),
         migratorType: (params.migratorType ?? MigratorType.V2_MIGRATOR) & 0xff,
         quoteToken: params.quoteToken || ZERO_ADDRESS,
-        quoteAmt: 0n,
+        quoteAmt: resolveCreateQuoteAmt(params),
         beneficiary: params.beneficiary,
         permitData: '0x',
         extensionID: params.extensionID ?? zeroBytes32(),
@@ -91,10 +91,14 @@ export function normalizeTaxLaunchConfig(input, fallbackTaxRate) {
 /**
  * 构建发币 populateTransaction（优先 V6/V7，Vault 走 VaultPortal）
  */
+function resolveCreateQuoteAmt(params) {
+    return params.initialQuoteAmt ?? 0n;
+}
 export async function populateCreateTokenTransaction(params) {
     const taxConfig = params.taxConfig;
     const { buyTaxRate, sellTaxRate } = resolveTaxRates(taxConfig, params.taxRate);
     const isTaxLaunch = buyTaxRate > 0 || sellTaxRate > 0;
+    const quoteAmt = resolveCreateQuoteAmt(params);
     // 1) Vault 金库税币
     if (taxConfig?.vaultConfig && taxConfig.vaultConfig.vaultType !== 'none') {
         validateTaxDistribution(taxConfig.mktBps, taxConfig.deflationBps, taxConfig.dividendBps, taxConfig.lpBps);
@@ -114,7 +118,7 @@ export async function populateCreateTokenTransaction(params) {
             taxRate: Math.max(buyTaxRate, sellTaxRate) & 0xffff,
             migratorType: (params.migratorType ?? MigratorType.V2_MIGRATOR) & 0xff,
             quoteToken: params.quoteToken || ZERO_ADDRESS,
-            quoteAmt: 0n,
+            quoteAmt,
             permitData: '0x',
             extensionID: zeroBytes32(),
             extensionData: '0x',
@@ -163,7 +167,7 @@ export async function populateCreateTokenTransaction(params) {
             taxRate: (params.taxRate ?? 0) & 0xffff,
             migratorType: (params.migratorType ?? MigratorType.V3_MIGRATOR) & 0xff,
             quoteToken: params.quoteToken || ZERO_ADDRESS,
-            quoteAmt: 0n,
+            quoteAmt,
             beneficiary: params.beneficiary,
             permitData: '0x',
             extensionID: params.extensionID ?? zeroBytes32(),
@@ -189,7 +193,7 @@ export async function populateCreateTokenTransaction(params) {
             salt: params.salt ?? zeroBytes32(),
             migratorType: MigratorType.PCS_INFINITY_CL_MIGRATOR,
             quoteToken: params.quoteToken || ZERO_ADDRESS,
-            quoteAmt: 0n,
+            quoteAmt,
             permitData: '0x',
             extensionID: params.extensionID ?? zeroBytes32(),
             extensionData: params.extensionData ?? '0x',
@@ -218,7 +222,7 @@ export async function populateCreateTokenTransaction(params) {
             taxRate: (params.taxRate ?? 0) & 0xffff,
             migratorType: (params.migratorType ?? MigratorType.V3_MIGRATOR) & 0xff,
             quoteToken: params.quoteToken || ZERO_ADDRESS,
-            quoteAmt: 0n,
+            quoteAmt,
             beneficiary: params.beneficiary,
             permitData: '0x',
             extensionID: params.extensionID,
@@ -234,7 +238,7 @@ export async function populateCreateTokenTransaction(params) {
         salt: params.salt ?? zeroBytes32(),
         migratorType: (params.migratorType ?? MigratorType.V2_MIGRATOR) & 0xff,
         quoteToken: params.quoteToken || ZERO_ADDRESS,
-        quoteAmt: 0n,
+        quoteAmt,
         beneficiary: params.beneficiary,
         permitData: '0x',
         extensionID: params.extensionID ?? zeroBytes32(),

package/dist/shared/flap/vanity.d.ts

@@ -10,7 +10,8 @@ export declare function predictVanityTokenAddress(salt: string, portal: string,
  * BSC/MONAD 默认使用 NORMAL 实现（非税版）
  * @param taxedV5 - 是否使用 V5 高级税代币实现 (mkt/deflation/dividend/lp)
  */
-export declare function predictVanityTokenAddressByChain(chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD', salt: string, taxed?: boolean, taxedV5?: boolean): string;
+export declare function predictVanityTokenAddressByChain(chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD', salt: string, taxed?: boolean, taxedV5?: boolean, // ✅ V5 高级税代币标识 (mkt/deflation/dividend/lp)
+taxedV3?: boolean): string;
 /**
  * 寻找满足后缀的 salt（默认 8888）
  * 注意：该方法为同步 CPU 搜索，谨慎设置迭代限制
@@ -41,6 +42,7 @@ export declare function findSaltEndingByChain(opts: {
     seed?: string;
     taxed?: boolean;
     taxedV5?: boolean;
+    taxedV3?: boolean;
 }): Promise<{
     salt: string;
     address: string;

package/dist/shared/flap/vanity.js

@@ -19,13 +19,14 @@ export function predictVanityTokenAddress(salt, portal, tokenImpl) {
  * BSC/MONAD 默认使用 NORMAL 实现（非税版）
  * @param taxedV5 - 是否使用 V5 高级税代币实现 (mkt/deflation/dividend/lp)
  */
-export function predictVanityTokenAddressByChain(chain, salt, taxed = false, taxedV5 = false) {
+export function predictVanityTokenAddressByChain(chain, salt, taxed = false, taxedV5 = false, // ✅ V5 高级税代币标识 (mkt/deflation/dividend/lp)
+taxedV3 = false) {
     // 使用 Flap 平台的原始 Portal 地址（用于 CREATE2）
     const portal = FLAP_ORIGINAL_PORTAL_ADDRESSES[chain];
     let tokenImpl;
     if (chain === 'BSC') {
-        if (taxedV5) {
-            // ✅ V5 高级税代币使用新的实现地址
+        if (taxedV5 || taxedV3) {
+            // ✅ V5 高级税代币（含 vault）使用新的实现地址
             tokenImpl = FLAP_TOKEN_IMPL_ADDRESSES.BSC_TAXED_V5;
         }
         else {
@@ -77,8 +78,8 @@ export async function findSaltEndingByChain(opts) {
     const portal = FLAP_ORIGINAL_PORTAL_ADDRESSES[opts.chain];
     let tokenImpl;
     if (opts.chain === 'BSC') {
-        if (opts.taxedV5) {
-            // ✅ V5 高级税代币使用新的实现地址
+        if (opts.taxedV5 || opts.taxedV3) {
+            // ✅ V5 高级税代币（含 vault）使用新的实现地址
             tokenImpl = FLAP_TOKEN_IMPL_ADDRESSES.BSC_TAXED_V5;
         }
         else {
@@ -95,8 +96,8 @@ export async function findSaltEndingByChain(opts) {
     if (!portal || !tokenImpl) {
         throw new Error(`Flap Protocol not fully deployed on ${opts.chain}`);
     }
-    // ✅ 如果未指定后缀，根据链自动选择正确的后缀
-    const suffix = opts.suffix ?? getVanitySuffix(opts.chain, opts.taxed);
+    // ✅ 如果未指定后缀，根据链自动选择正确的后缀（税代币 / V5 / V3 vault 均使用 tax 后缀）
+    const suffix = opts.suffix ?? getVanitySuffix(opts.chain, opts.taxed || opts.taxedV5 || opts.taxedV3);
     return findSaltEnding({
         portal,
         tokenImpl,

package/package.json

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