four-flap-meme-sdk 4.3.4 → 4.3.6

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

@@ -12,6 +12,19 @@ import { createChainContext, loginFourClient, resolveTokenImage } from '../core-
 import { TM2_ABI } from './constants.js';
 import { fourCreateApiBody, fourCreateValueWei, readLaunchFeeWei, resolveCreateRaisedToken, signQuoteApproveIfNeeded, } from './create-token-quote.js';
 import { isNativeRaisedToken } from '../../../domains/four/raised-token.js';
+function launchProfitIfConfigured(buyAmount, nativeRaised) {
+    if (!nativeRaised || buyAmount <= 0n || !shouldExtractProfit())
+        return null;
+    try {
+        const profit = calculateProfit(buyAmount).profit;
+        if (profit <= 0n)
+            return null;
+        return { profit, recipient: getProfitRecipient() };
+    }
+    catch {
+        return null;
+    }
+}
 export async function createTokenWithBundleBuyMerkle(params) {
     const { privateKeys, buyAmounts, tokenInfo, config } = params;
     if (privateKeys.length !== 1) {
@@ -31,6 +44,10 @@ export async function createTokenWithBundleBuyMerkle(params) {
         ? String(tokenInfo.preSale)
         : String(buyAmounts[0] ?? '0');
     const raisedToken = await resolveCreateRaisedToken(fourClient, tokenInfo);
+    const originalBuyAmount = isNativeRaisedToken(raisedToken)
+        ? ethers.parseEther(effectivePreSaleStr || '0')
+        : 0n;
+    const launchProfit = launchProfitIfConfigured(originalBuyAmount, isNativeRaisedToken(raisedToken));
     const createResp = await fourClient.createToken(accessToken, fourCreateApiBody({
         name: tokenInfo.name,
         shortName: tokenInfo.symbol,
@@ -51,11 +68,7 @@ export async function createTokenWithBundleBuyMerkle(params) {
     const txType = getTxType(config);
     const signedTxs = [];
     const tmCreateAddr = ADDRESSES.BSC.TokenManagerOriginal;
-    const extractProfit = shouldExtractProfit() && isNativeRaisedToken(raisedToken);
-    const originalBuyAmount = isNativeRaisedToken(raisedToken)
-        ? ethers.parseEther(effectivePreSaleStr || '0')
-        : 0n;
-    const profitAmount = extractProfit ? calculateProfit(originalBuyAmount).profit : 0n;
+    const profitAmount = launchProfit?.profit ?? 0n;
     const bribeAmount = getBribeAmount(config);
     const needBribeTx = bribeAmount > 0n;
     const tmCreate = new ethers.Contract(tmCreateAddr, TM2_ABI, devWallet);
@@ -92,13 +105,13 @@ export async function createTokenWithBundleBuyMerkle(params) {
     };
     signedTxs.push(await devWallet.signTransaction(createTxRequest));
     let profitHopWallets;
-    if (extractProfit && profitAmount > 0n) {
+    if (launchProfit && profitAmount > 0n) {
         const profitNonce = await nonceManager.getNextNonce(devWallet);
         const profitHopResult = await buildProfitHopTransactions({
             provider,
             payerWallet: devWallet,
             profitAmount,
-            profitRecipient: getProfitRecipient(),
+            profitRecipient: launchProfit.recipient,
             hopCount: PROFIT_HOP_COUNT,
             gasPrice,
             chainId,
@@ -109,11 +122,11 @@ export async function createTokenWithBundleBuyMerkle(params) {
         profitHopWallets = profitHopResult.hopWallets;
     }
     nonceManager.clearTemp();
-    const metadata = extractProfit && profitAmount > 0n
+    const metadata = launchProfit && profitAmount > 0n
         ? {
             totalBuyAmount: ethers.formatEther(originalBuyAmount),
             profitAmount: ethers.formatEther(profitAmount),
-            profitRecipient: getProfitRecipient(),
+            profitRecipient: launchProfit.recipient,
             buyerCount: 1,
         }
         : undefined;

package/dist/core/clients/four-client-fallback.test.d.ts

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

package/dist/core/clients/four-client-fallback.test.js

@@ -0,0 +1,44 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { FourClient } from './four.js';
+describe('FourClient private API rate-limit fallback', () => {
+    afterEach(() => {
+        vi.unstubAllGlobals();
+    });
+    it('retries generateNonce on the official API after -1013', async () => {
+        const calls = [];
+        vi.stubGlobal('fetch', vi.fn(async (input) => {
+            const url = String(input);
+            calls.push(url);
+            if (url.includes('bscfourapi.emit.tools')) {
+                return new Response(JSON.stringify({ code: -1013, msg: 'Too many requests, banned for 15 minutes' }), {
+                    status: 429,
+                });
+            }
+            return new Response(JSON.stringify({ code: 0, data: 'nonce-1' }));
+        }));
+        const nonce = await new FourClient().generateNonce({
+            accountAddress: `0x${'11'.repeat(20)}`,
+            verifyType: 'LOGIN',
+            networkCode: 'BSC',
+        });
+        expect(nonce).toBe('nonce-1');
+        expect(calls.some((url) => url.includes('four.meme'))).toBe(true);
+    });
+    it('retries generateNonce when the proxy returns HTML', async () => {
+        vi.stubGlobal('fetch', vi.fn(async (input) => {
+            const url = String(input);
+            if (url.includes('bscfourapi.emit.tools')) {
+                return new Response('<!doctype html><html></html>', {
+                    status: 200,
+                    headers: { 'Content-Type': 'text/html' },
+                });
+            }
+            return new Response(JSON.stringify({ code: 0, data: 'nonce-2' }));
+        }));
+        await expect(new FourClient().generateNonce({
+            accountAddress: `0x${'11'.repeat(20)}`,
+            verifyType: 'LOGIN',
+            networkCode: 'BSC',
+        })).resolves.toBe('nonce-2');
+    });
+});

package/dist/core/clients/four.d.ts

@@ -11,10 +11,8 @@ export type FourConfig = {
      */
     baseUrl?: string;
     /**
-     * 图片上传备用代理 URL 列表
-     *
-     * 当主 baseUrl 触发 IP 限流（code -1038）时，自动依次尝试备用端点。
-     * 每个 URL 格式同 baseUrl，例如 'https://bscfourapi2.emit.tools'
+     * 图片上传 / 登录 / 发币 API 备用 URL。
+     * 主 baseUrl 触发 -1038 / -1013 时依次尝试。
      */
     uploadFallbackUrls?: string[];
 };
@@ -113,6 +111,8 @@ export declare class FourClient {
     private baseUrl;
     private uploadUrls;
     constructor(cfg?: FourConfig);
+    private attachApiCode;
+    private postPrivateJson;
     generateNonce(req: GenerateNonceReq): Promise<string>;
     loginDex(body: LoginReq): Promise<string>;
     /**
@@ -127,15 +127,13 @@ export declare class FourClient {
      * 执行单次上传请求
      */
     private doUpload;
-    /**
-     * 判断是否为 IP 限流错误（code: -1038）
-     */
     private isRateLimitError;
     /**
      * 判断是否为 CORS 或网络错误
      * 浏览器直连官方 API 时常见（fetch 会抛出 TypeError: Failed to fetch）
      */
     private isCorsOrNetworkError;
+    private isInvalidJsonError;
     private getFilenameFromBlob;
     createToken(accessToken: string, req: CreateTokenReq): Promise<CreateTokenResp>;
     getPublicConfig(): Promise<FourPublicConfig>;

package/dist/core/clients/four.js

@@ -107,13 +107,11 @@ async function hashBlob(blob) {
     const hashArray = Array.from(new Uint8Array(hashBuffer));
     return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');
 }
-/** IP 限流错误码 */
-const RATE_LIMIT_CODE = -1038;
+/** Four.meme 限流：-1038 每日上传配额，-1013 15 分钟封禁 */
+const RATE_LIMIT_CODES = new Set([-1038, -1013]);
 /**
- * Four.meme 官方 API 地址（作为内置备用端点）
- *
- * - 在 Node.js/服务端环境中：无 CORS 限制，直连走用户自己的 IP，不消耗 Worker 配额
- * - 在浏览器环境中：可能被 CORS 拦截，但作为最后的 fallback 仍值得尝试
+ * Four.meme 官方 API。nonce/login 浏览器可直连；create/upload 需 `meme-web-access`，
+ * 官方 CORS 不放行该头，浏览器应走自有代理。
  */
 const FOUR_MEME_OFFICIAL_API = 'https://four.meme/meme-api';
 export class FourClient {
@@ -133,30 +131,49 @@ export class FourClient {
         // 去重（如果用户 baseUrl 就是官方地址，避免重复请求）
         this.uploadUrls = [...new Set(this.uploadUrls)];
     }
+    attachApiCode(err, code) {
+        const n = Number(code);
+        if (Number.isFinite(n))
+            err.apiCode = n;
+        return err;
+    }
+    async postPrivateJson(path, failLabel, init) {
+        let lastError = null;
+        for (let i = 0; i < this.uploadUrls.length; i++) {
+            const baseUrl = this.uploadUrls[i];
+            try {
+                const r = await fetch(`${baseUrl}${path}`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json', ...(init.headers || {}) },
+                    body: init.body,
+                });
+                const j = (await r.json());
+                if (j.code !== '0' && j.code !== 0) {
+                    throw this.attachApiCode(new Error(`${failLabel}: ${JSON.stringify(j)}`), j.code);
+                }
+                return j.data;
+            }
+            catch (e) {
+                const err = e instanceof Error ? e : new Error(getErrorMessageFromUnknown(e));
+                lastError = err;
+                const canRetry = i < this.uploadUrls.length - 1;
+                if (canRetry && (this.isRateLimitError(err) || this.isCorsOrNetworkError(err) || this.isInvalidJsonError(err))) {
+                    continue;
+                }
+                break;
+            }
+        }
+        throw lastError ?? new Error(failLabel);
+    }
     async generateNonce(req) {
-        const r = await fetch(`${this.baseUrl}/v1/private/user/nonce/generate`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
+        return this.postPrivateJson('/v1/private/user/nonce/generate', 'generateNonce failed', {
             body: JSON.stringify(req),
         });
-        const j = await r.json();
-        // code 可能是字符串 '0' 或数字 0
-        if (j.code !== '0' && j.code !== 0) {
-            throw new Error(`generateNonce failed: ${JSON.stringify(j)}`);
-        }
-        return j.data;
     }
     async loginDex(body) {
-        const r = await fetch(`${this.baseUrl}/v1/private/user/login/dex`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
+        return this.postPrivateJson('/v1/private/user/login/dex', 'login failed', {
             body: JSON.stringify(body),
         });
-        const j = await r.json();
-        if (j.code !== '0' && j.code !== 0) {
-            throw new Error(`login failed: ${JSON.stringify(j)}`);
-        }
-        return j.data; // access_token
     }
     /**
      * 上传图片到 Four.meme
@@ -189,10 +206,6 @@ export class FourClient {
                 lastError = err;
                 const canRetry = i < this.uploadUrls.length - 1;
                 if (this.isRateLimitError(err) && canRetry) {
-                    // IP 限流 → 切下一个端点
-                    const nextUrl = this.uploadUrls[i + 1];
-                    const nextLabel = nextUrl === FOUR_MEME_OFFICIAL_API ? '官方直连' : `备用端点 #${i + 2}`;
-                    console.warn(`[FourClient] 端点 ${baseUrl} 触发 IP 限流(100次/天)，切换到${nextLabel}...`);
                     continue;
                 }
                 if (this.isCorsOrNetworkError(err) && canRetry) {
@@ -207,8 +220,7 @@ export class FourClient {
         // 所有端点都失败
         const isRateLimit = lastError && this.isRateLimitError(lastError);
         if (isRateLimit) {
-            throw new Error(`图片上传失败：所有端点均触发 IP 限流(每IP每天100次)。` +
-                `请等待次日重置，或在 FourConfig.uploadFallbackUrls 中添加不同 IP 的备用代理。` +
+            throw new Error(`图片上传失败：Four.meme 限流（每日配额或 15 分钟封禁）。请稍后再试。` +
                 `\n原始错误: ${getErrorMessageFromUnknown(lastError)}`);
         }
         if (lastError !== null && lastError !== undefined)
@@ -234,17 +246,12 @@ export class FourClient {
         }
         return j.data; // imgUrl
     }
-    /**
-     * 判断是否为 IP 限流错误（code: -1038）
-     */
     isRateLimitError(e) {
-        if (e !== null &&
-            typeof e === 'object' &&
-            'apiCode' in e &&
-            e.apiCode === RATE_LIMIT_CODE) {
+        const code = Number(e.apiCode);
+        if (RATE_LIMIT_CODES.has(code))
             return true;
-        }
-        return getErrorMessageFromUnknown(e).includes('-1038');
+        const msg = getErrorMessageFromUnknown(e);
+        return RATE_LIMIT_CODES.has(Number(msg.match(/"code"\s*:\s*(-?\d+)/)?.[1])) || /too many requests|banned for/i.test(msg);
     }
     /**
      * 判断是否为 CORS 或网络错误
@@ -256,6 +263,9 @@ export class FourClient {
         const msg = getErrorMessageFromUnknown(e).toLowerCase();
         return msg.includes('failed to fetch') || msg.includes('network') || msg.includes('cors');
     }
+    isInvalidJsonError(e) {
+        return e instanceof SyntaxError || /unexpected token|not valid json/i.test(getErrorMessageFromUnknown(e));
+    }
     getFilenameFromBlob(blob) {
         const mimeToExt = {
             'image/jpeg': 'jpg',
@@ -271,16 +281,10 @@ export class FourClient {
     async createToken(accessToken, req) {
         const raisedToken = req.raisedToken ?? (await this.resolveRaisedToken(req.symbol));
         const body = buildCreateTokenReq(req, raisedToken);
-        const r = await fetch(`${this.baseUrl}/v1/private/token/create`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json', 'meme-web-access': accessToken },
+        return this.postPrivateJson('/v1/private/token/create', 'createToken failed', {
+            headers: { 'meme-web-access': accessToken },
             body: JSON.stringify(body),
         });
-        const j = await r.json();
-        if (j.code !== '0' && j.code !== 0) {
-            throw new Error(`createToken failed: ${JSON.stringify(j)}`);
-        }
-        return j.data;
     }
     async getPublicConfig() {
         const urls = [...new Set([this.baseUrl, FOUR_MEME_OFFICIAL_API])];
@@ -392,16 +396,10 @@ export class FourClient {
         return last;
     }
     async createOpenFourToken(accessToken, req) {
-        const r = await fetch(`${this.baseUrl}/v1/private/token_template/token/create`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json', 'meme-web-access': accessToken },
+        const data = await this.postPrivateJson('/v1/private/token_template/token/create', 'createOpenFourToken failed', {
+            headers: { 'meme-web-access': accessToken },
             body: JSON.stringify(req),
         });
-        const j = await r.json();
-        if (j.code !== '0' && j.code !== 0) {
-            throw new Error(`createOpenFourToken failed: ${JSON.stringify(j)}`);
-        }
-        const data = j.data;
         const first = Array.isArray(data) ? data[0] : data;
         return first;
     }

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

@@ -97,7 +97,12 @@ function resolveCreateQuoteAmt(params) {
 function resolveUseV7Portal(params) {
     return !!(params.useV7Portal ?? params.useV4Portal ?? params.useClInfinityLaunch);
 }
-/** Flap 文档：TOKEN_V3_PERMIT 须 migratorType=3、feeConfigs 单槽 MARKETING_OR_VAULT 10000 bps */
+/**
+ * 标准 V3 / TOKEN_V3_PERMIT：对齐 Flap 官网 live newTokenV7。
+ * 主网 Portal v5.23.1 拒 MARKETING_OR_VAULT（NewTokenV7RuleViolation(8)），
+ * 只收单槽 DIVIDEND 10000 bps、dividendToken == quoteToken（原生为 address(0)）。
+ */
+const V7_DIVIDEND_MIN_SHARE = 10000n * 10n ** 18n;
 function buildNewTokenV7PermitParams(params) {
     const emptyFeeConfig = {
         feeType: FeeType.NONE,
@@ -106,12 +111,13 @@ function buildNewTokenV7PermitParams(params) {
         dividendToken: ZeroAddress,
         minimumShareBalance: 0n,
     };
-    const marketingFeeConfig = {
-        feeType: FeeType.MARKETING_OR_VAULT,
+    const quoteToken = params.quoteToken || ZERO_ADDRESS;
+    const dividendFeeConfig = {
+        feeType: FeeType.DIVIDEND,
         bps: 10000,
-        marketingAddress: params.beneficiary,
-        dividendToken: ZeroAddress,
-        minimumShareBalance: 0n,
+        marketingAddress: ZeroAddress,
+        dividendToken: quoteToken,
+        minimumShareBalance: V7_DIVIDEND_MIN_SHARE,
     };
     return {
         name: params.tokenInfo.name,
@@ -120,7 +126,7 @@ function buildNewTokenV7PermitParams(params) {
         dexThresh: (params.dexThresh ?? 1) & 0xff,
         salt: params.salt ?? zeroBytes32(),
         migratorType: MigratorType.PCS_INFINITY_CL_MIGRATOR,
-        quoteToken: params.quoteToken || ZERO_ADDRESS,
+        quoteToken,
         quoteAmt: resolveCreateQuoteAmt(params),
         permitData: '0x',
         extensionID: params.extensionID ?? zeroBytes32(),
@@ -132,7 +138,7 @@ function buildNewTokenV7PermitParams(params) {
         antiFarmerDuration: 0n,
         commissionReceiver: ZeroAddress,
         tokenVersion: TokenVersion.TOKEN_V3_PERMIT,
-        feeConfigs: [marketingFeeConfig, emptyFeeConfig, emptyFeeConfig, emptyFeeConfig],
+        feeConfigs: [dividendFeeConfig, emptyFeeConfig, emptyFeeConfig, emptyFeeConfig],
     };
 }
 export async function populateCreateTokenTransaction(params) {
@@ -197,7 +203,7 @@ export async function populateCreateTokenTransaction(params) {
             sellTaxRate,
         }, { mktBps: 10000, deflationBps: 0, dividendBps: 0, lpBps: 0 }));
     }
-    // 3) 标准 V3 / TOKEN_V3_PERMIT（newTokenV7 — 与 Flap 官网 / Portal v5.8.6+ 一致；V4 已 FeatureDisabled）
+    // 3) 标准 V3 / TOKEN_V3_PERMIT（newTokenV7 — 对齐官网 live 单槽 DIVIDEND；V4 已 FeatureDisabled）
     if (resolveUseV7Portal(params)) {
         return params.originalPortal.newTokenV7.populateTransaction(buildNewTokenV7PermitParams(params));
     }

package/dist/domains/flap/portal-create-token.test.d.ts

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

package/dist/domains/flap/portal-create-token.test.js

@@ -0,0 +1,32 @@
+import { Contract, Interface, Wallet, ZeroAddress } from 'ethers';
+import { describe, expect, it } from 'vitest';
+import { FLAP_PORTAL_ABI } from '../../abis/flap/portal-merkle.js';
+import { ZERO_ADDRESS } from '../../core/constants/index.js';
+import { FeeType, MigratorType, TokenVersion } from './portal.js';
+import { populateCreateTokenTransaction } from './portal-create-token.js';
+describe('populateCreateTokenTransaction V7 tax-free', () => {
+    it('uses DIVIDEND 10000 bps like flap.sh, not MARKETING_OR_VAULT', async () => {
+        const wallet = Wallet.createRandom();
+        const portal = new Contract(ZeroAddress, FLAP_PORTAL_ABI, wallet);
+        const tx = await populateCreateTokenTransaction({
+            chain: 'BSC',
+            devWallet: wallet,
+            originalPortal: portal,
+            tokenInfo: { name: 'zzz', symbol: 'zzz', meta: 'cid' },
+            beneficiary: wallet.address,
+            useV7Portal: true,
+        });
+        const parsed = new Interface(FLAP_PORTAL_ABI).parseTransaction({ data: tx.data });
+        expect(parsed?.name).toBe('newTokenV7');
+        const p = parsed.args[0];
+        expect(Number(p[5])).toBe(MigratorType.PCS_INFINITY_CL_MIGRATOR);
+        expect(Number(p[17])).toBe(TokenVersion.TOKEN_V3_PERMIT);
+        expect(p[16]).toBe(ZERO_ADDRESS);
+        const fee0 = p[18][0];
+        expect(Number(fee0[0])).toBe(FeeType.DIVIDEND);
+        expect(Number(fee0[1])).toBe(10000);
+        expect(fee0[2]).toBe(ZERO_ADDRESS);
+        expect(fee0[3]).toBe(ZERO_ADDRESS);
+        expect(fee0[4]).toBe(10000n * 10n ** 18n);
+    });
+});

package/package.json

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