four-flap-meme-sdk 2.2.8 → 2.2.11

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

@@ -1,20 +1,12 @@
 /**
  * Flap Tax Vaults（税收金库）
  *
- * ⚠️ 重要：基于 flap.sh/launch 实际源码分析，金库模式架构如下：
- *
  * 1. 金库代币通过 VaultPortal 合约创建（不是普通 Portal）
- * 2. 调用函数：VaultPortal.newTaxTokenWithVault(params)
- * 3. 参数中 extensionID/extensionData 始终为零值
- * 4. 真正的金库配置通过 vaultFactory（工厂地址）和 vaultData（ABI 编码数据）传递
- * 5. 每种金库类型对应一个具体的 VaultFactory 合约地址
+ * 2. 调用函数：VaultPortal.newTokenV6WithVault(params) + tokenVersion = TOKEN_TAXED_V3
+ * 3. newTaxTokenWithVault 已在链上废弃，请勿再使用
+ * 4. 金库配置通过 vaultFactory + vaultData 传递；extensionID/extensionData 始终为零
  *
- * 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)
+ * @see https://docs.flap.sh/flap/developers/token-launcher-developers/launch-token-through-vaultportal
  *
  * 金库分类（来自 flap.sh 源码）：
  *   官方金库 (official)：
@@ -28,6 +20,8 @@
  * @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
@@ -117,19 +111,18 @@ 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 — newTaxTokenWithVault
- *
- * ⚠️ 从 flap.sh 前端 JS 源码提取的真实 ABI
- * 来源：flap.sh/_next/static/chunks/6288-*.js（VaultPortal 合约 ABI）
+ * VaultPortal ABI — newTokenV6WithVault（当前唯一支持的金库发射入口）
  */
 export declare const VAULT_PORTAL_ABI: readonly [{
     readonly type: "function";
-    readonly name: "newTaxTokenWithVault";
+    readonly name: "newTokenV6WithVault";
     readonly inputs: readonly [{
         readonly name: "params";
         readonly type: "tuple";
-        readonly internalType: "struct IVaultPortalTypes.NewTaxTokenWithVaultParams";
+        readonly internalType: "struct IVaultPortalTypes.NewTokenV6WithVaultParams";
         readonly components: readonly [{
             readonly name: "name";
             readonly type: "string";
@@ -145,15 +138,11 @@ export declare const VAULT_PORTAL_ABI: readonly [{
         }, {
             readonly name: "dexThresh";
             readonly type: "uint8";
-            readonly internalType: "enum IPortalCommonTypes.DexThreshType";
+            readonly internalType: "enum IPortalTypes.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";
@@ -186,6 +175,14 @@ 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";
@@ -214,6 +211,18 @@ 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";
@@ -342,8 +351,67 @@ 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.newTaxTokenWithVault）
+ * 构建金库参数（用于 VaultPortal.newTokenV6WithVault）
  *
  * ⚠️ 重要：返回的是 vaultFactory 和 vaultData，不是 extensionID/extensionData
  * extensionID/extensionData 在金库模式下始终为零值
@@ -361,7 +429,7 @@ export declare function buildVaultParams(config?: TaxVaultConfig, chain?: string
  * 金库参数通过 VaultPortal 的 vaultFactory/vaultData 传递
  * 此函数仅用于向后兼容
  */
-export declare function buildVaultExtensionParams(): {
+export declare function buildVaultExtensionParams(config?: TaxVaultConfig): {
     extensionID: string;
     extensionData: string;
 };

package/dist/shared/flap/vault.js

@@ -1,20 +1,12 @@
 /**
  * Flap Tax Vaults（税收金库）
  *
- * ⚠️ 重要：基于 flap.sh/launch 实际源码分析，金库模式架构如下：
- *
  * 1. 金库代币通过 VaultPortal 合约创建（不是普通 Portal）
- * 2. 调用函数：VaultPortal.newTaxTokenWithVault(params)
- * 3. 参数中 extensionID/extensionData 始终为零值
- * 4. 真正的金库配置通过 vaultFactory（工厂地址）和 vaultData（ABI 编码数据）传递
- * 5. 每种金库类型对应一个具体的 VaultFactory 合约地址
+ * 2. 调用函数：VaultPortal.newTokenV6WithVault(params) + tokenVersion = TOKEN_TAXED_V3
+ * 3. newTaxTokenWithVault 已在链上废弃，请勿再使用
+ * 4. 金库配置通过 vaultFactory + vaultData 传递；extensionID/extensionData 始终为零
  *
- * 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)
+ * @see https://docs.flap.sh/flap/developers/token-launcher-developers/launch-token-through-vaultportal
  *
  * 金库分类（来自 flap.sh 源码）：
  *   官方金库 (official)：
@@ -28,32 +20,9 @@
  * @module vault
  */
 import { Contract, AbiCoder, ZeroAddress } from 'ethers';
-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,
-    };
-}
+import { TokenVersion } from './portal.js';
+import { getVanitySuffix } from './constants.js';
+import { normalizeTaxV2Fields } from './launch-v6.js';
 /**
  * 金库类型显示标签
  */
@@ -131,28 +100,25 @@ export const FLAP_GUARDIAN_ADDRESSES = {
 // ============================================================================
 // ABI 定义
 // ============================================================================
+/** VaultPortal 金库发射必须使用 TOKEN_TAXED_V3（enum = 6） */
+export const TOKEN_TAXED_V3_VERSION = TokenVersion.TOKEN_TAXED_V3;
 /**
- * VaultPortal ABI — newTaxTokenWithVault
- *
- * ⚠️ 从 flap.sh 前端 JS 源码提取的真实 ABI
- * 来源：flap.sh/_next/static/chunks/6288-*.js（VaultPortal 合约 ABI）
+ * VaultPortal ABI — newTokenV6WithVault（当前唯一支持的金库发射入口）
  */
 export const VAULT_PORTAL_ABI = [
     {
         type: 'function',
-        name: 'newTaxTokenWithVault',
-        inputs: [
-            {
+        name: 'newTokenV6WithVault',
+        inputs: [{
                 name: 'params',
                 type: 'tuple',
-                internalType: 'struct IVaultPortalTypes.NewTaxTokenWithVaultParams',
+                internalType: 'struct IVaultPortalTypes.NewTokenV6WithVaultParams',
                 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 IPortalCommonTypes.DexThreshType' },
+                    { name: 'dexThresh', type: 'uint8', internalType: 'enum IPortalTypes.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' },
@@ -161,6 +127,8 @@ 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' },
@@ -168,11 +136,13 @@ 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',
     },
@@ -180,8 +150,7 @@ 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',
@@ -191,9 +160,8 @@ 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',
     },
     {
@@ -220,7 +188,9 @@ 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
  */
@@ -269,21 +239,16 @@ 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);
@@ -308,7 +273,66 @@ export function getVaultPortalAddress(chain) {
     return VAULT_PORTAL_ADDRESSES[chainKey] || null;
 }
 /**
- * 构建金库参数（用于 VaultPortal.newTaxTokenWithVault）
+ * 构建 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: ZeroAddress,
+        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）
  *
  * ⚠️ 重要：返回的是 vaultFactory 和 vaultData，不是 extensionID/extensionData
  * extensionID/extensionData 在金库模式下始终为零值
@@ -361,7 +385,7 @@ export function buildVaultParams(config, chain) {
  * 金库参数通过 VaultPortal 的 vaultFactory/vaultData 传递
  * 此函数仅用于向后兼容
  */
-export function buildVaultExtensionParams() {
+export function buildVaultExtensionParams(config) {
     // 金库模式下 extensionID/extensionData 始终为零值
     return {
         extensionID: NONE_EXTENSION_ID,
@@ -377,10 +401,15 @@ export function buildVaultExtensionParams() {
 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(mapFieldDescriptor),
+            fields: raw.fields.map((f) => ({
+                name: f.name,
+                fieldType: f.fieldType,
+                description: f.description,
+                decimals: Number(f.decimals),
+            })),
             isArray: raw.isArray,
         };
     }
@@ -394,11 +423,33 @@ 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(mapVaultMethodSchema),
+            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,
+            })),
         };
     }
     catch {
@@ -443,7 +494,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/shared/four/tax-token.d.ts

@@ -1,4 +1,4 @@
-import TaxTokenAbi from '../../abis/contracts/TaxToken.json';
+import TaxTokenAbi from '../abis/TaxToken.json';
 /** TaxToken 转账模式 */
 export declare enum TransferMode {
     /** 正常转账模式 - 允许所有转账 */

package/dist/shared/four/tax-token.js

@@ -5,7 +5,7 @@
  * 基于 Four.meme 官方文档: API-Contract-TaxToken.md
  */
 import { ethers, Contract, Wallet, JsonRpcProvider } from 'ethers';
-import TaxTokenAbi from '../../abis/contracts/TaxToken.json' with { type: 'json' };
+import TaxTokenAbi from '../abis/TaxToken.json' with { type: 'json' };
 // ============================================================================
 // 常量
 // ============================================================================
@@ -123,28 +123,11 @@ export async function getTaxTokenInfo(tokenAddress, rpcUrl) {
     const token = new Contract(tokenAddress, TAX_TOKEN_READ_ABI, provider);
     // 批量查询所有状态（利用 Promise.all 减少 RPC 调用轮次）
     const [feeRate, rateFounder, rateHolder, rateBurn, rateLiquidity, founder, quote, pair, mode, minDispatch, minShare, totalShares, feePerShare, feeAccumulated, feeDispatched, feeFounderVal, feeHolderVal, feeBurnVal, feeLiquidityVal, quoteFounderVal, quoteHolderVal, quoteClaimed,] = await Promise.all([
-        token.feeRate(),
-        token.rateFounder(),
-        token.rateHolder(),
-        token.rateBurn(),
-        token.rateLiquidity(),
-        token.founder(),
-        token.quote(),
-        token.pair(),
-        token._mode(),
-        token.minDispatch(),
-        token.minShare(),
-        token.totalShares(),
-        token.feePerShare(),
-        token.feeAccumulated(),
-        token.feeDispatched(),
-        token.feeFounder(),
-        token.feeHolder(),
-        token.feeBurn(),
-        token.feeLiquidity(),
-        token.quoteFounder(),
-        token.quoteHolder(),
-        token.quoteClaimed(),
+        token.feeRate(), token.rateFounder(), token.rateHolder(), token.rateBurn(), token.rateLiquidity(),
+        token.founder(), token.quote(), token.pair(), token._mode(), token.minDispatch(), token.minShare(),
+        token.totalShares(), token.feePerShare(), token.feeAccumulated(), token.feeDispatched(),
+        token.feeFounder(), token.feeHolder(), token.feeBurn(), token.feeLiquidity(),
+        token.quoteFounder(), token.quoteHolder(), token.quoteClaimed(),
     ]);
     return {
         config: {
@@ -298,10 +281,7 @@ export function validateFourTokenTaxInfo(info) {
     // 四项比例之和必须为 100
     const rateSum = info.burnRate + info.divideRate + info.liquidityRate + info.recipientRate;
     if (rateSum !== 100) {
-        return {
-            valid: false,
-            error: `burnRate + divideRate + liquidityRate + recipientRate 必须等于 100，当前: ${rateSum}`,
-        };
+        return { valid: false, error: `burnRate + divideRate + liquidityRate + recipientRate 必须等于 100，当前: ${rateSum}` };
     }
     // 每项比例 >= 0
     if (info.burnRate < 0 || info.divideRate < 0 || info.liquidityRate < 0 || info.recipientRate < 0) {

package/dist/shared/index.d.ts

@@ -7,10 +7,4 @@
  * - four: Four.meme 工具（TaxToken 等）
  */
 export * from './constants/index.js';
-/** 错误规范化、可选 Logger（与根 `index` 导出同源） */
-export * as foundation from './foundation/index.js';
-/** HTTP / Bundle / BlockRazor 等（亦支持子路径 `four-flap-meme-sdk/clients`） */
-export * as clients from './clients/index.js';
 export * as FourUtils from './four/index.js';
-/** Flap 链标识（与 `./constants` 同源） */
-export type { FlapChain } from './flap/portal.js';

package/dist/shared/index.js

@@ -7,8 +7,4 @@
  * - four: Four.meme 工具（TaxToken 等）
  */
 export * from './constants/index.js';
-/** 错误规范化、可选 Logger（与根 `index` 导出同源） */
-export * as foundation from './foundation/index.js';
-/** HTTP / Bundle / BlockRazor 等（亦支持子路径 `four-flap-meme-sdk/clients`） */
-export * as clients from './clients/index.js';
 export * as FourUtils from './four/index.js';

package/dist/utils/airdrop-sweep.d.ts

@@ -1,8 +1,80 @@
-import type { AirdropDisperseSignParams, SignedTransactionsResult, AirdropSweepSignParams } from './types/airdrop-sweep.js';
-export declare function disperseWithBundle(params: AirdropDisperseSignParams): Promise<SignedTransactionsResult>;
+import type { SoulPointSignatureMode, VNormalizationMode } from '../shared/clients/club48.js';
+/** ✅ Bundle 提交结果（完整版 - 包含 bundleUuid） */
+export type BundleSubmitResult = {
+    bundleUuid: string;
+    signedTxs: string[];
+};
+/** ✅ 签名结果（精简版 - 仅返回签名交易） */
+export type SignedTransactionsResult = {
+    signedTransactions: string[];
+};
+/** ✅ 分散参数（完整版 - 包含 Bundle 提交） */
+export type DisperseParams = {
+    rpcUrl: string;
+    chainId: number;
+    fromPrivateKey: string;
+    recipients: string[];
+    amount?: string;
+    amounts?: string[];
+    tokenAddress?: string;
+    bundleEndpoint?: string;
+    gasPriceGwei?: string;
+    transferGasLimit?: bigint;
+    nativeGasLimit?: bigint;
+    blockOffset?: number;
+    spMode?: SoulPointSignatureMode;
+    spPrivateKey?: string;
+    spVMode?: VNormalizationMode;
+};
+/** ✅ 分散参数（精简版 - 仅签名） */
+export type DisperseSignParams = {
+    rpcUrl: string;
+    chainId: number;
+    fromPrivateKey: string;
+    recipients: string[];
+    amount?: string;
+    amounts?: string[];
+    tokenAddress?: string;
+    gasPriceGwei?: string;
+    transferGasLimit?: bigint;
+    nativeGasLimit?: bigint;
+};
+export declare function disperseWithBundle(params: DisperseSignParams): Promise<SignedTransactionsResult>;
+/** ✅ 归集参数（完整版 - 包含 Bundle 提交） */
+export type SweepParams = {
+    rpcUrl: string;
+    chainId: number;
+    sourcePrivateKeys: string[];
+    target: string;
+    ratioPct?: number;
+    amount?: string;
+    tokenAddress?: string;
+    bundleEndpoint?: string;
+    gasPriceGwei?: string;
+    transferGasLimit?: bigint;
+    nativeGasLimit?: bigint;
+    blockOffset?: number;
+    skipIfInsufficient?: boolean;
+    spMode?: SoulPointSignatureMode;
+    spPrivateKey?: string;
+    spVMode?: VNormalizationMode;
+};
+/** ✅ 归集参数（精简版 - 仅签名） */
+export type SweepSignParams = {
+    rpcUrl: string;
+    chainId: number;
+    sourcePrivateKeys: string[];
+    target: string;
+    ratioPct?: number;
+    amount?: string;
+    tokenAddress?: string;
+    gasPriceGwei?: string;
+    transferGasLimit?: bigint;
+    nativeGasLimit?: bigint;
+    skipIfInsufficient?: boolean;
+};
 /**
  * 归集（仅签名版本 - 不提交 Bundle）
  * ✅ 精简版：只负责签名交易，不提交
  */
-export declare function sweepWithBundle(params: AirdropSweepSignParams): Promise<SignedTransactionsResult>;
-export type { BundleSubmitResult, SignedTransactionsResult, AirdropDisperseParams, AirdropDisperseSignParams, AirdropSweepParams, AirdropSweepSignParams, DisperseParams, DisperseSignParams, SweepParams, SweepSignParams, } from './types/airdrop-sweep.js';
+export declare function sweepWithBundle(params: SweepSignParams): Promise<SignedTransactionsResult>;