four-flap-meme-sdk 2.2.19 → 3.0.0

package/dist/{shared → domains}/flap/vault.d.ts

@@ -1,12 +1,20 @@
 /**
  * Flap Tax Vaults（税收金库）
  *
+ * ⚠️ 重要：基于 flap.sh/launch 实际源码分析，金库模式架构如下：
+ *
  * 1. 金库代币通过 VaultPortal 合约创建（不是普通 Portal）
- * 2. 调用函数：VaultPortal.newTokenV6WithVault(params) + tokenVersion = TOKEN_TAXED_V3
- * 3. newTaxTokenWithVault 已在链上废弃，请勿再使用
- * 4. 金库配置通过 vaultFactory + vaultData 传递；extensionID/extensionData 始终为零
+ * 2. 调用函数：VaultPortal.newTaxTokenWithVault(params)
+ * 3. 参数中 extensionID/extensionData 始终为零值
+ * 4. 真正的金库配置通过 vaultFactory（工厂地址）和 vaultData（ABI 编码数据）传递
+ * 5. 每种金库类型对应一个具体的 VaultFactory 合约地址
  *
- * @see https://docs.flap.sh/flap/developers/token-launcher-developers/launch-token-through-vaultportal
+ * VaultPortal.newTaxTokenWithVault 参数结构：
+ *   - 基础参数（与 Portal.newTokenV5 相同）：name, symbol, meta, dexThresh, salt, taxRate,
+ *     migratorType, quoteToken, quoteAmt, permitData, extensionID(全零), extensionData("0x"),
+ *     dexId, lpFeeProfile, taxDuration, antiFarmerDuration, mktBps, deflationBps, dividendBps,
+ *     lpBps, minimumShareBalance
+ *   - 金库专属参数：vaultFactory(address), vaultData(bytes)
  *
  * 金库分类（来自 flap.sh 源码）：
  *   官方金库 (official)：
@@ -20,8 +28,6 @@
  * @module vault
  */
 import { type JsonRpcProvider } from 'ethers';
-import { TokenVersion } from './portal.js';
-import type { TaxV2Config } from './portal-bundle-merkle/types.js';
 /**
  * FieldDescriptor — 字段描述符
  * 对应 Solidity 结构体 IVaultSchemasV1.FieldDescriptor
@@ -111,18 +117,19 @@ export declare const VAULT_EXTRA_CONFIG: Record<string, Record<string, Record<st
 export declare const FLAP_GUARDIAN_ADDRESSES: {
     readonly BSC: "0x9e27098dcD8844bcc6287a557E0b4D09C86B8a4b";
 };
-/** VaultPortal 金库发射必须使用 TOKEN_TAXED_V3（enum = 6） */
-export declare const TOKEN_TAXED_V3_VERSION = TokenVersion.TOKEN_TAXED_V3;
 /**
- * VaultPortal ABI — newTokenV6WithVault（当前唯一支持的金库发射入口）
+ * VaultPortal ABI — newTaxTokenWithVault
+ *
+ * ⚠️ 从 flap.sh 前端 JS 源码提取的真实 ABI
+ * 来源：flap.sh/_next/static/chunks/6288-*.js（VaultPortal 合约 ABI）
  */
 export declare const VAULT_PORTAL_ABI: readonly [{
     readonly type: "function";
-    readonly name: "newTokenV6WithVault";
+    readonly name: "newTaxTokenWithVault";
     readonly inputs: readonly [{
         readonly name: "params";
         readonly type: "tuple";
-        readonly internalType: "struct IVaultPortalTypes.NewTokenV6WithVaultParams";
+        readonly internalType: "struct IVaultPortalTypes.NewTaxTokenWithVaultParams";
         readonly components: readonly [{
             readonly name: "name";
             readonly type: "string";
@@ -138,11 +145,15 @@ export declare const VAULT_PORTAL_ABI: readonly [{
         }, {
             readonly name: "dexThresh";
             readonly type: "uint8";
-            readonly internalType: "enum IPortalTypes.DexThreshType";
+            readonly internalType: "enum IPortalCommonTypes.DexThreshType";
         }, {
             readonly name: "salt";
             readonly type: "bytes32";
             readonly internalType: "bytes32";
+        }, {
+            readonly name: "taxRate";
+            readonly type: "uint16";
+            readonly internalType: "uint16";
         }, {
             readonly name: "migratorType";
             readonly type: "uint8";
@@ -175,14 +186,6 @@ export declare const VAULT_PORTAL_ABI: readonly [{
             readonly name: "lpFeeProfile";
             readonly type: "uint8";
             readonly internalType: "enum IPortalTypes.V3LPFeeProfile";
-        }, {
-            readonly name: "buyTaxRate";
-            readonly type: "uint16";
-            readonly internalType: "uint16";
-        }, {
-            readonly name: "sellTaxRate";
-            readonly type: "uint16";
-            readonly internalType: "uint16";
         }, {
             readonly name: "taxDuration";
             readonly type: "uint64";
@@ -211,18 +214,6 @@ export declare const VAULT_PORTAL_ABI: readonly [{
             readonly name: "minimumShareBalance";
             readonly type: "uint256";
             readonly internalType: "uint256";
-        }, {
-            readonly name: "dividendToken";
-            readonly type: "address";
-            readonly internalType: "address";
-        }, {
-            readonly name: "commissionReceiver";
-            readonly type: "address";
-            readonly internalType: "address";
-        }, {
-            readonly name: "tokenVersion";
-            readonly type: "uint8";
-            readonly internalType: "enum IPortalTypes.TokenVersion";
         }, {
             readonly name: "vaultFactory";
             readonly type: "address";
@@ -351,67 +342,8 @@ export declare function getVaultFactoryAddress(chain: string, vaultType: VaultTy
  * 获取指定链的 VaultPortal 合约地址
  */
 export declare function getVaultPortalAddress(chain: string): string | null;
-export type BuildNewTokenV6WithVaultInput = {
-    tokenInfo: {
-        name: string;
-        symbol: string;
-        meta: string;
-    };
-    taxV2: TaxV2Config;
-    chain: string;
-    salt?: string;
-    taxRate?: number;
-    buyTaxRate?: number;
-    sellTaxRate?: number;
-    dexThresh?: number;
-    migratorType?: number;
-    quoteToken?: string;
-    quoteAmt?: bigint;
-    dexId?: number;
-    lpFeeProfile?: number;
-};
-/**
- * 构建 VaultPortal.newTokenV6WithVault 参数（TOKEN_TAXED_V3）
- */
-export declare function buildNewTokenV6WithVaultParams(input: BuildNewTokenV6WithVaultInput): {
-    name: string;
-    symbol: string;
-    meta: string;
-    dexThresh: number;
-    salt: string;
-    migratorType: number;
-    quoteToken: string;
-    quoteAmt: bigint;
-    permitData: string;
-    extensionID: string;
-    extensionData: string;
-    dexId: number;
-    lpFeeProfile: number;
-    buyTaxRate: number;
-    sellTaxRate: number;
-    taxDuration: bigint;
-    antiFarmerDuration: bigint;
-    mktBps: number;
-    deflationBps: number;
-    dividendBps: number;
-    lpBps: number;
-    minimumShareBalance: bigint;
-    dividendToken: string;
-    commissionReceiver: string;
-    tokenVersion: TokenVersion;
-    vaultFactory: string;
-    vaultData: string;
-};
-/** 金库发射 Vanity：TOKEN_TAXED_V3 + 后缀 7777 */
-export declare function getVaultLaunchVanityOptions(chain: string): {
-    taxed: boolean;
-    taxedV3: boolean;
-    taxedV5: boolean;
-    suffix: string;
-    chain: "BSC" | "XLAYER" | "MONAD" | "BASE" | "MORPH";
-};
 /**
- * 构建金库参数（用于 VaultPortal.newTokenV6WithVault）
+ * 构建金库参数（用于 VaultPortal.newTaxTokenWithVault）
  *
  * ⚠️ 重要：返回的是 vaultFactory 和 vaultData，不是 extensionID/extensionData
  * extensionID/extensionData 在金库模式下始终为零值
@@ -429,7 +361,7 @@ export declare function buildVaultParams(config?: TaxVaultConfig, chain?: string
  * 金库参数通过 VaultPortal 的 vaultFactory/vaultData 传递
  * 此函数仅用于向后兼容
  */
-export declare function buildVaultExtensionParams(config?: TaxVaultConfig): {
+export declare function buildVaultExtensionParams(): {
     extensionID: string;
     extensionData: string;
 };

package/dist/{shared → domains}/flap/vault.js

@@ -1,12 +1,20 @@
 /**
  * Flap Tax Vaults（税收金库）
  *
+ * ⚠️ 重要：基于 flap.sh/launch 实际源码分析，金库模式架构如下：
+ *
  * 1. 金库代币通过 VaultPortal 合约创建（不是普通 Portal）
- * 2. 调用函数：VaultPortal.newTokenV6WithVault(params) + tokenVersion = TOKEN_TAXED_V3
- * 3. newTaxTokenWithVault 已在链上废弃，请勿再使用
- * 4. 金库配置通过 vaultFactory + vaultData 传递；extensionID/extensionData 始终为零
+ * 2. 调用函数：VaultPortal.newTaxTokenWithVault(params)
+ * 3. 参数中 extensionID/extensionData 始终为零值
+ * 4. 真正的金库配置通过 vaultFactory（工厂地址）和 vaultData（ABI 编码数据）传递
+ * 5. 每种金库类型对应一个具体的 VaultFactory 合约地址
  *
- * @see https://docs.flap.sh/flap/developers/token-launcher-developers/launch-token-through-vaultportal
+ * VaultPortal.newTaxTokenWithVault 参数结构：
+ *   - 基础参数（与 Portal.newTokenV5 相同）：name, symbol, meta, dexThresh, salt, taxRate,
+ *     migratorType, quoteToken, quoteAmt, permitData, extensionID(全零), extensionData("0x"),
+ *     dexId, lpFeeProfile, taxDuration, antiFarmerDuration, mktBps, deflationBps, dividendBps,
+ *     lpBps, minimumShareBalance
+ *   - 金库专属参数：vaultFactory(address), vaultData(bytes)
  *
  * 金库分类（来自 flap.sh 源码）：
  *   官方金库 (official)：
@@ -20,9 +28,33 @@
  * @module vault
  */
 import { Contract, AbiCoder, ZeroAddress } from 'ethers';
-import { TokenVersion } from './portal.js';
-import { getVanitySuffix } from './constants.js';
-import { normalizeTaxV2Fields, resolveDividendTokenForQuote } from './launch-v6.js';
+import { getErrorMessageFromUnknown } from '../../core/index.js';
+function mapFieldDescriptor(f) {
+    return {
+        name: f.name,
+        fieldType: f.fieldType,
+        description: f.description,
+        decimals: Number(f.decimals),
+    };
+}
+function mapApproveAction(a) {
+    return {
+        tokenType: a.tokenType,
+        amountFieldName: a.amountFieldName,
+    };
+}
+function mapVaultMethodSchema(m) {
+    return {
+        name: m.name,
+        description: m.description,
+        inputs: m.inputs.map(mapFieldDescriptor),
+        outputs: m.outputs.map(mapFieldDescriptor),
+        approvals: m.approvals.map(mapApproveAction),
+        isInputArray: m.isInputArray,
+        isOutputArray: m.isOutputArray,
+        isWriteMethod: m.isWriteMethod,
+    };
+}
 /**
  * 金库类型显示标签
  */
@@ -100,25 +132,28 @@ export const FLAP_GUARDIAN_ADDRESSES = {
 // ============================================================================
 // ABI 定义
 // ============================================================================
-/** VaultPortal 金库发射必须使用 TOKEN_TAXED_V3（enum = 6） */
-export const TOKEN_TAXED_V3_VERSION = TokenVersion.TOKEN_TAXED_V3;
 /**
- * VaultPortal ABI — newTokenV6WithVault（当前唯一支持的金库发射入口）
+ * VaultPortal ABI — newTaxTokenWithVault
+ *
+ * ⚠️ 从 flap.sh 前端 JS 源码提取的真实 ABI
+ * 来源：flap.sh/_next/static/chunks/6288-*.js（VaultPortal 合约 ABI）
  */
 export const VAULT_PORTAL_ABI = [
     {
         type: 'function',
-        name: 'newTokenV6WithVault',
-        inputs: [{
+        name: 'newTaxTokenWithVault',
+        inputs: [
+            {
                 name: 'params',
                 type: 'tuple',
-                internalType: 'struct IVaultPortalTypes.NewTokenV6WithVaultParams',
+                internalType: 'struct IVaultPortalTypes.NewTaxTokenWithVaultParams',
                 components: [
                     { name: 'name', type: 'string', internalType: 'string' },
                     { name: 'symbol', type: 'string', internalType: 'string' },
                     { name: 'meta', type: 'string', internalType: 'string' },
-                    { name: 'dexThresh', type: 'uint8', internalType: 'enum IPortalTypes.DexThreshType' },
+                    { name: 'dexThresh', type: 'uint8', internalType: 'enum IPortalCommonTypes.DexThreshType' },
                     { name: 'salt', type: 'bytes32', internalType: 'bytes32' },
+                    { name: 'taxRate', type: 'uint16', internalType: 'uint16' },
                     { name: 'migratorType', type: 'uint8', internalType: 'enum IPortalTypes.MigratorType' },
                     { name: 'quoteToken', type: 'address', internalType: 'address' },
                     { name: 'quoteAmt', type: 'uint256', internalType: 'uint256' },
@@ -127,8 +162,6 @@ export const VAULT_PORTAL_ABI = [
                     { name: 'extensionData', type: 'bytes', internalType: 'bytes' },
                     { name: 'dexId', type: 'uint8', internalType: 'enum IPortalTypes.DEXId' },
                     { name: 'lpFeeProfile', type: 'uint8', internalType: 'enum IPortalTypes.V3LPFeeProfile' },
-                    { name: 'buyTaxRate', type: 'uint16', internalType: 'uint16' },
-                    { name: 'sellTaxRate', type: 'uint16', internalType: 'uint16' },
                     { name: 'taxDuration', type: 'uint64', internalType: 'uint64' },
                     { name: 'antiFarmerDuration', type: 'uint64', internalType: 'uint64' },
                     { name: 'mktBps', type: 'uint16', internalType: 'uint16' },
@@ -136,13 +169,11 @@ export const VAULT_PORTAL_ABI = [
                     { name: 'dividendBps', type: 'uint16', internalType: 'uint16' },
                     { name: 'lpBps', type: 'uint16', internalType: 'uint16' },
                     { name: 'minimumShareBalance', type: 'uint256', internalType: 'uint256' },
-                    { name: 'dividendToken', type: 'address', internalType: 'address' },
-                    { name: 'commissionReceiver', type: 'address', internalType: 'address' },
-                    { name: 'tokenVersion', type: 'uint8', internalType: 'enum IPortalTypes.TokenVersion' },
                     { name: 'vaultFactory', type: 'address', internalType: 'address' },
                     { name: 'vaultData', type: 'bytes', internalType: 'bytes' },
-                ]
-            }],
+                ],
+            },
+        ],
         outputs: [{ name: 'token', type: 'address', internalType: 'address' }],
         stateMutability: 'payable',
     },
@@ -150,7 +181,8 @@ export const VAULT_PORTAL_ABI = [
         type: 'function',
         name: 'getVault',
         inputs: [{ name: 'taxToken', type: 'address', internalType: 'address' }],
-        outputs: [{
+        outputs: [
+            {
                 name: 'info',
                 type: 'tuple',
                 internalType: 'struct IVaultPortalTypes.VaultInfo',
@@ -160,8 +192,9 @@ export const VAULT_PORTAL_ABI = [
                     { name: 'description', type: 'string', internalType: 'string' },
                     { name: 'isOfficial', type: 'bool', internalType: 'bool' },
                     { name: 'riskLevel', type: 'uint8', internalType: 'enum IVaultPortalTypes.RiskLevel' },
-                ]
-            }],
+                ],
+            },
+        ],
         stateMutability: 'view',
     },
     {
@@ -188,9 +221,7 @@ export const VAULT_FACTORY_V2_ABI = [
 /**
  * VaultBase ABI（V1）
  */
-export const VAULT_BASE_ABI = [
-    'function description() public view returns (string)',
-];
+export const VAULT_BASE_ABI = ['function description() public view returns (string)'];
 /**
  * VaultBaseV2 ABI
  */
@@ -239,16 +270,21 @@ function mapFieldTypeToAbiType(fieldType) {
 function processFieldValue(field, rawValue) {
     if (rawValue === undefined || rawValue === null) {
         switch (field.fieldType) {
-            case 'address': return ZeroAddress;
-            case 'bool': return false;
-            case 'string': return '';
+            case 'address':
+                return ZeroAddress;
+            case 'bool':
+                return false;
+            case 'string':
+                return '';
             case 'bytes':
-            case 'bytes32': return '0x' + '00'.repeat(32);
-            default: return 0;
+            case 'bytes32':
+                return '0x' + '00'.repeat(32);
+            default:
+                return 0;
         }
     }
     if (field.decimals > 0 && typeof rawValue === 'number') {
-        return BigInt(Math.round(rawValue * (10 ** field.decimals)));
+        return BigInt(Math.round(rawValue * 10 ** field.decimals));
     }
     if (field.fieldType === 'bool') {
         return Boolean(rawValue);
@@ -273,66 +309,7 @@ export function getVaultPortalAddress(chain) {
     return VAULT_PORTAL_ADDRESSES[chainKey] || null;
 }
 /**
- * 构建 VaultPortal.newTokenV6WithVault 参数（TOKEN_TAXED_V3）
- */
-export function buildNewTokenV6WithVaultParams(input) {
-    const tv2 = normalizeTaxV2Fields(input.taxV2);
-    const total = tv2.mktBps + tv2.deflationBps + tv2.dividendBps + tv2.lpBps;
-    if (total !== 10000) {
-        throw new Error(`Tax distribution must sum to 10000 (100%), got ${total}`);
-    }
-    if (tv2.mktBps <= 0) {
-        throw new Error('Vault launch requires mktBps > 0');
-    }
-    const buyTaxRate = (input.buyTaxRate ?? input.taxRate ?? 0) & 0xffff;
-    const sellTaxRate = (input.sellTaxRate ?? input.taxRate ?? 0) & 0xffff;
-    if (buyTaxRate <= 0 || sellTaxRate <= 0) {
-        throw new Error('Vault launch requires buyTaxRate and sellTaxRate > 0');
-    }
-    const { vaultFactory, vaultData } = buildVaultParams(tv2.vaultConfig, input.chain);
-    return {
-        name: input.tokenInfo.name,
-        symbol: input.tokenInfo.symbol,
-        meta: input.tokenInfo.meta,
-        dexThresh: (input.dexThresh ?? 1) & 0xff,
-        salt: input.salt ?? ('0x' + '00'.repeat(32)),
-        migratorType: (input.migratorType ?? 0) & 0xff,
-        quoteToken: input.quoteToken || ZeroAddress,
-        quoteAmt: input.quoteAmt ?? 0n,
-        permitData: '0x',
-        extensionID: NONE_EXTENSION_ID,
-        extensionData: '0x',
-        dexId: (input.dexId ?? 0) & 0xff,
-        lpFeeProfile: (input.lpFeeProfile ?? 0) & 0xff,
-        buyTaxRate,
-        sellTaxRate,
-        taxDuration: BigInt(tv2.taxDuration),
-        antiFarmerDuration: BigInt(tv2.antiFarmerDuration),
-        mktBps: tv2.mktBps & 0xffff,
-        deflationBps: tv2.deflationBps & 0xffff,
-        dividendBps: tv2.dividendBps & 0xffff,
-        lpBps: tv2.lpBps & 0xffff,
-        minimumShareBalance: BigInt(tv2.minimumShareBalance ?? 10000) * (10n ** 18n),
-        dividendToken: resolveDividendTokenForQuote(input.quoteToken),
-        commissionReceiver: ZeroAddress,
-        tokenVersion: TOKEN_TAXED_V3_VERSION,
-        vaultFactory,
-        vaultData,
-    };
-}
-/** 金库发射 Vanity：TOKEN_TAXED_V3 + 后缀 7777 */
-export function getVaultLaunchVanityOptions(chain) {
-    const c = chain.toUpperCase();
-    return {
-        taxed: true,
-        taxedV3: true,
-        taxedV5: false,
-        suffix: getVanitySuffix(c, true),
-        chain: c,
-    };
-}
-/**
- * 构建金库参数（用于 VaultPortal.newTokenV6WithVault）
+ * 构建金库参数（用于 VaultPortal.newTaxTokenWithVault）
  *
  * ⚠️ 重要：返回的是 vaultFactory 和 vaultData，不是 extensionID/extensionData
  * extensionID/extensionData 在金库模式下始终为零值
@@ -385,7 +362,7 @@ export function buildVaultParams(config, chain) {
  * 金库参数通过 VaultPortal 的 vaultFactory/vaultData 传递
  * 此函数仅用于向后兼容
  */
-export function buildVaultExtensionParams(config) {
+export function buildVaultExtensionParams() {
     // 金库模式下 extensionID/extensionData 始终为零值
     return {
         extensionID: NONE_EXTENSION_ID,
@@ -401,15 +378,10 @@ export function buildVaultExtensionParams(config) {
 export async function queryVaultDataSchema(provider, factoryAddress) {
     try {
         const factory = new Contract(factoryAddress, VAULT_FACTORY_V2_ABI, provider);
-        const raw = await factory.vaultDataSchema();
+        const raw = (await factory.vaultDataSchema());
         return {
             description: raw.description,
-            fields: raw.fields.map((f) => ({
-                name: f.name,
-                fieldType: f.fieldType,
-                description: f.description,
-                decimals: Number(f.decimals),
-            })),
+            fields: raw.fields.map(mapFieldDescriptor),
             isArray: raw.isArray,
         };
     }
@@ -423,33 +395,11 @@ export async function queryVaultDataSchema(provider, factoryAddress) {
 export async function queryVaultUISchema(provider, vaultAddress) {
     try {
         const vault = new Contract(vaultAddress, VAULT_BASE_V2_ABI, provider);
-        const raw = await vault.vaultUISchema();
+        const raw = (await vault.vaultUISchema());
         return {
             vaultType: raw.vaultType,
             description: raw.description,
-            methods: raw.methods.map((m) => ({
-                name: m.name,
-                description: m.description,
-                inputs: m.inputs.map((f) => ({
-                    name: f.name,
-                    fieldType: f.fieldType,
-                    description: f.description,
-                    decimals: Number(f.decimals),
-                })),
-                outputs: m.outputs.map((f) => ({
-                    name: f.name,
-                    fieldType: f.fieldType,
-                    description: f.description,
-                    decimals: Number(f.decimals),
-                })),
-                approvals: m.approvals.map((a) => ({
-                    tokenType: a.tokenType,
-                    amountFieldName: a.amountFieldName,
-                })),
-                isInputArray: m.isInputArray,
-                isOutputArray: m.isOutputArray,
-                isWriteMethod: m.isWriteMethod,
-            })),
+            methods: raw.methods.map(mapVaultMethodSchema),
         };
     }
     catch {
@@ -485,7 +435,7 @@ export async function validateVaultFactory(provider, factoryAddress) {
         };
     }
     catch (e) {
-        return { isValid: false, isV2: false, schema: null, error: String(e) };
+        return { isValid: false, isV2: false, schema: null, error: getErrorMessageFromUnknown(e) };
     }
 }
 /**
@@ -494,7 +444,7 @@ export async function validateVaultFactory(provider, factoryAddress) {
 export async function getVaultInfo(provider, vaultPortalAddress, taxTokenAddress) {
     try {
         const portal = new Contract(vaultPortalAddress, VAULT_PORTAL_ABI, provider);
-        const info = await portal.getVault(taxTokenAddress);
+        const info = (await portal.getVault(taxTokenAddress));
         return {
             vault: info.vault,
             vaultFactory: info.vaultFactory,

package/dist/{flows → domains/flows}/create.d.ts

@@ -1,3 +1,4 @@
+import type { ContractTransactionReceipt } from 'ethers';
 export type CreateTokenFlowInput = {
     rpcUrl: string;
     privateKey: string;
@@ -28,7 +29,7 @@ export type CreateTokenFlowOutput = {
         createArg: string;
         signature: string;
     };
-    txReceipt: any;
+    txReceipt: ContractTransactionReceipt | null;
     tokenAddress?: string;
 };
 export declare function createTokenFlow(input: CreateTokenFlowInput): Promise<CreateTokenFlowOutput>;

package/dist/{flows → domains/flows}/create.js

@@ -1,5 +1,5 @@
-import { FourClient, buildLoginMessage } from '../shared/clients/four.js';
-import { createTokenOnChain } from '../contracts/tm.js';
+import { FourClient, buildLoginMessage } from '../../core/clients/four.js';
+import { createTokenOnChain } from '../four/contracts/tm.js';
 import { Wallet, parseEther } from 'ethers';
 import { readFileSync } from 'fs';
 import { basename } from 'path';
@@ -9,12 +9,12 @@ import { basename } from 'path';
 function getMimeType(filename) {
     const ext = filename.toLowerCase().split('.').pop();
     const mimeTypes = {
-        'jpg': 'image/jpeg',
-        'jpeg': 'image/jpeg',
-        'png': 'image/png',
-        'gif': 'image/gif',
-        'bmp': 'image/bmp',
-        'webp': 'image/webp',
+        jpg: 'image/jpeg',
+        jpeg: 'image/jpeg',
+        png: 'image/png',
+        gif: 'image/gif',
+        bmp: 'image/bmp',
+        webp: 'image/webp',
     };
     return mimeTypes[ext || 'png'] || 'image/png';
 }

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

@@ -0,0 +1,9 @@
+/**
+ * 高层业务流程（flows）入口。
+ *
+ * flows 职责：薄编排层，组合 API 客户端（clients）、合约封装（contracts）与 ethers，
+ * 不承载复杂链上逻辑——新 flow 应将链特化逻辑下沉到 `shared/` 或 `chains/`。
+ *
+ * 当前仅导出 `createTokenFlow`（four.meme 发币）；后续新增 flow 请在本目录新增模块并在此 re-export。
+ */
+export { createTokenFlow, type CreateTokenFlowInput, type CreateTokenFlowOutput } from './create.js';

package/dist/domains/flows/index.js

@@ -0,0 +1,9 @@
+/**
+ * 高层业务流程（flows）入口。
+ *
+ * flows 职责：薄编排层，组合 API 客户端（clients）、合约封装（contracts）与 ethers，
+ * 不承载复杂链上逻辑——新 flow 应将链特化逻辑下沉到 `shared/` 或 `chains/`。
+ *
+ * 当前仅导出 `createTokenFlow`（four.meme 发币）；后续新增 flow 请在本目录新增模块并在此 re-export。
+ */
+export { createTokenFlow } from './create.js';

package/dist/{contracts → domains/four/contracts}/helper3.d.ts

@@ -1,4 +1,19 @@
 import { JsonRpcProvider, Wallet } from 'ethers';
+/** 与 Helper3 `getTokenInfo` 返回值一致（作 `calcBuyAmount` 等函数的 `ti` 入参） */
+export type TokenManagerHelper3TokenInfo = {
+    version: bigint;
+    tokenManager: string;
+    quote: string;
+    lastPrice: bigint;
+    tradingFeeRate: bigint;
+    minTradingFee: bigint;
+    launchTime: bigint;
+    offers: bigint;
+    maxOffers: bigint;
+    funds: bigint;
+    maxFunds: bigint;
+    liquidityAdded: boolean;
+};
 type Providerish = JsonRpcProvider;
 type Signerish = Wallet;
 export declare class Helper3 {
@@ -7,14 +22,14 @@ export declare class Helper3 {
     protected constructor(address: string, provider: Providerish);
     static connectByChain(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string): Helper3;
     private get contract();
-    getTokenInfo(token: string): Promise<any>;
+    getTokenInfo(token: string): Promise<TokenManagerHelper3TokenInfo>;
     tryBuy(token: string, amount: bigint, funds: bigint): Promise<any>;
     trySell(token: string, amount: bigint): Promise<any>;
     calcInitialPrice(maxRaising: bigint, totalSupply: bigint, offers: bigint, reserves: bigint): Promise<any>;
-    calcBuyAmount(ti: any, funds: bigint): Promise<any>;
-    calcBuyCost(ti: any, amount: bigint): Promise<any>;
-    calcSellCost(ti: any, amount: bigint): Promise<any>;
-    calcTradingFee(ti: any, funds: bigint): Promise<any>;
+    calcBuyAmount(ti: TokenManagerHelper3TokenInfo, funds: bigint): Promise<any>;
+    calcBuyCost(ti: TokenManagerHelper3TokenInfo, amount: bigint): Promise<any>;
+    calcSellCost(ti: TokenManagerHelper3TokenInfo, amount: bigint): Promise<any>;
+    calcTradingFee(ti: TokenManagerHelper3TokenInfo, funds: bigint): Promise<any>;
     getPancakePair(token: string): Promise<any>;
     WETH(): Promise<any>;
     WHITE_LIST(): Promise<any>;