four-flap-meme-sdk 1.8.7 → 1.8.8

package/dist/index.d.ts

@@ -50,6 +50,7 @@ export { flapBundleBuyFirstMerkle, type FlapBuyFirstSignConfig, type FlapBuyFirs
 export { pancakeBundleBuyFirstMerkle, type PancakeBuyFirstSignConfig, type PancakeBuyFirstConfig, type PancakeBundleBuyFirstSignParams, type PancakeBundleBuyFirstParams, type PancakeBuyFirstResult } from './chains/bsc/pancake/bundle-buy-first.js';
 export { flapBundleCurveToDex, type CurveToDexChain, type DexPoolType, type CurveToDexSignConfig, type CurveBuyerConfig, type DexBuyerConfig, type FlapCurveToDexParams, type FlapCurveToDexResult } from './shared/flap/portal-bundle-merkle/curve-to-dex.js';
 export { flapBundleCreateToDex, type CreateToDexChain, type CreateToDexSignConfig, type CreateTokenInfo, type FlapCreateToDexParams, type FlapCreateToDexResult } from './shared/flap/portal-bundle-merkle/create-to-dex.js';
+export { VAULT_EXTENSION_IDS, VAULT_TYPE_LABELS, TAX_VAULT_ABI, VAULT_FACTORY_ABI, type VaultType, type TaxVaultConfig, type VaultInfo, type VaultRewards, getVaultExtensionId, encodeVaultExtensionData, buildVaultExtensionParams, getVaultTypeFromExtensionId, getVaultInfo, getVaultRewards, claimVaultRewards, isValidVaultContract, } from './shared/flap/vault.js';
 export { PROFIT_CONFIG } from './shared/constants/index.js';
 export { quoteV2, quoteV3, quote, getTokenToNativeQuote, getNativeToTokenQuote, getWrappedNativeAddress, // ✅ 来自 quote-helpers，与 shared/constants 同名但实现可能不同
 getStableCoins, V3_FEE_TIERS, // ✅ 来自 quote-helpers

package/dist/index.js

@@ -95,6 +95,8 @@ export { pancakeBundleBuyFirstMerkle } from './chains/bsc/pancake/bundle-buy-fir
 export { flapBundleCurveToDex } from './shared/flap/portal-bundle-merkle/curve-to-dex.js';
 // ✅ 发币 + 一键买到外盘（Create → Curve → DEX）- 新代币
 export { flapBundleCreateToDex } from './shared/flap/portal-bundle-merkle/create-to-dex.js';
+// ✅ Tax Vault 金库模块
+export { VAULT_EXTENSION_IDS, VAULT_TYPE_LABELS, TAX_VAULT_ABI, VAULT_FACTORY_ABI, getVaultExtensionId, encodeVaultExtensionData, buildVaultExtensionParams, getVaultTypeFromExtensionId, getVaultInfo, getVaultRewards, claimVaultRewards, isValidVaultContract, } from './shared/flap/vault.js';
 // ✅ 硬编码利润配置（统一管理）- 从 shared/constants 导出
 export { PROFIT_CONFIG } from './shared/constants/index.js';
 // ✅ V2/V3 报价工具（统一管理）

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

@@ -19,3 +19,4 @@ export { FLAP_DEFAULT_FEE_RATES, FLAP_IPFS_API_URL, FLAP_VANITY_SUFFIX, FLAP_DEX
 export * from './abi.js';
 export { createTokenWithBundleBuy, batchBuyWithBundle, batchSellWithBundle, type FlapBundleConfig, type FlapChainForBundle, type FlapCreateWithBundleBuyParams, type FlapCreateWithBundleBuyResult, type FlapBatchBuyParams, type FlapBatchBuyResult, type FlapBatchSellParams, type FlapBatchSellResult, flapPrivateBuy, flapPrivateSell, flapBatchPrivateBuy, flapBatchPrivateSell, type FlapPrivateBuyParams, type FlapPrivateSellParams, type FlapBatchPrivateBuyParams, type FlapBatchPrivateSellParams, type FlapBatchPrivateSellResult, } from './portal-bundle.js';
 export * from './portal-bundle-merkle/index.js';
+export { VAULT_EXTENSION_IDS, VAULT_TYPE_LABELS, TAX_VAULT_ABI, VAULT_FACTORY_ABI, type VaultType, type TaxVaultConfig, type VaultInfo, type VaultRewards, getVaultExtensionId, encodeVaultExtensionData, buildVaultExtensionParams, getVaultTypeFromExtensionId, getVaultInfo, getVaultRewards, claimVaultRewards, isValidVaultContract, } from './vault.js';

package/dist/shared/flap/index.js

@@ -21,3 +21,11 @@ export * from './abi.js';
 export { createTokenWithBundleBuy, batchBuyWithBundle, batchSellWithBundle, flapPrivateBuy, flapPrivateSell, flapBatchPrivateBuy, flapBatchPrivateSell, } from './portal-bundle.js';
 // portal-bundle-merkle 子模块
 export * from './portal-bundle-merkle/index.js';
+// ✅ Tax Vault 金库模块
+export { 
+// 常量
+VAULT_EXTENSION_IDS, VAULT_TYPE_LABELS, TAX_VAULT_ABI, VAULT_FACTORY_ABI, 
+// 编码/解码工具
+getVaultExtensionId, encodeVaultExtensionData, buildVaultExtensionParams, getVaultTypeFromExtensionId, 
+// 链上查询
+getVaultInfo, getVaultRewards, claimVaultRewards, isValidVaultContract, } from './vault.js';

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

@@ -4,6 +4,7 @@ import { ADDRESSES, ZERO_ADDRESS } from '../../../utils/constants.js';
 import { GAS_LIMITS, CHAINS } from '../../constants/index.js';
 import { MULTICALL3_ABI, V2_ROUTER_QUOTE_ABI } from '../../abis/common.js';
 import { FLAP_PORTAL_ADDRESSES, FLAP_ORIGINAL_PORTAL_ADDRESSES } from '../constants.js';
+import { buildVaultExtensionParams } from '../vault.js';
 import { CHAIN_ID_MAP, PORTAL_ABI, getErrorMessage, getTxType, getGasPriceConfig, shouldExtractProfit, calculateProfit, getProfitRecipient, getBribeAmount, BLOCKRAZOR_BUILDER_EOA } from './config.js';
 // ✅ 常量
 const MULTICALL3_ADDRESS = ADDRESSES.BSC.Multicall3;
@@ -119,6 +120,10 @@ export async function createTokenWithBundleBuyMerkle(params) {
         if (total !== 10000) {
             throw new Error(`Tax distribution must sum to 10000 (100%), got ${total}`);
         }
+        // ✅ 如果配置了 Tax Vault，使用金库的 extensionID/extensionData
+        const vaultParams = buildVaultExtensionParams(tv2.vaultConfig);
+        const finalExtensionID = params.extensionID || vaultParams.extensionID;
+        const finalExtensionData = params.extensionData || vaultParams.extensionData;
         createTxPromise = portal.newTokenV5.populateTransaction({
             name: tokenInfo.name,
             symbol: tokenInfo.symbol,
@@ -131,8 +136,8 @@ export async function createTokenWithBundleBuyMerkle(params) {
             quoteAmt: 0n,
             beneficiary: devWallet.address,
             permitData: '0x',
-            extensionID: params.extensionID ?? '0x' + '00'.repeat(32),
-            extensionData: params.extensionData ?? '0x',
+            extensionID: finalExtensionID,
+            extensionData: finalExtensionData,
             dexId: (params.dexId ?? 0) & 0xff,
             lpFeeProfile: (params.lpFeeProfile ?? 0) & 0xff,
             taxDuration: BigInt(tv2.taxDuration),

package/dist/shared/flap/portal-bundle-merkle/create-to-dex.d.ts

@@ -84,6 +84,8 @@ export interface FlapCreateToDexParams {
         dividendBps: number;
         lpBps: number;
         minimumShareBalance?: number;
+        /** ✅ Tax Vault 金库配置（可选） */
+        vaultConfig?: import('../vault.js').TaxVaultConfig;
     };
     /** V3 扩展 ID */
     extensionID?: string;

package/dist/shared/flap/portal-bundle-merkle/create-to-dex.js

@@ -10,6 +10,7 @@
 import { ethers, Contract, Wallet } from 'ethers';
 import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../../utils/bundle-helpers.js';
 import { FLAP_PORTAL_ADDRESSES, FLAP_ORIGINAL_PORTAL_ADDRESSES } from '../constants.js';
+import { buildVaultExtensionParams } from '../vault.js';
 import { PROFIT_CONFIG, ZERO_ADDRESS } from '../../../utils/constants.js';
 import { GAS_LIMITS } from '../../constants/index.js';
 import { getGasPriceConfig, getTxType, getProfitRecipient, getBribeAmount, BLOCKRAZOR_BUILDER_EOA, PORTAL_ABI } from './config.js';
@@ -333,6 +334,10 @@ export async function flapBundleCreateToDex(params) {
             if (total !== 10000) {
                 throw new Error(`Tax distribution must sum to 10000 (100%), got ${total}`);
             }
+            // ✅ 如果配置了 Tax Vault，使用金库的 extensionID/extensionData
+            const vaultParams = buildVaultExtensionParams(tv2.vaultConfig);
+            const finalExtensionID = params.extensionID || vaultParams.extensionID;
+            const finalExtensionData = params.extensionData || vaultParams.extensionData;
             createUnsigned = await originalPortal.newTokenV5.populateTransaction({
                 name: tokenInfo.name,
                 symbol: tokenInfo.symbol,
@@ -345,8 +350,8 @@ export async function flapBundleCreateToDex(params) {
                 quoteAmt: 0n,
                 beneficiary: devWallet.address,
                 permitData: '0x',
-                extensionID: params.extensionID ?? '0x' + '00'.repeat(32),
-                extensionData: params.extensionData ?? '0x',
+                extensionID: finalExtensionID,
+                extensionData: finalExtensionData,
                 dexId: (params.dexId ?? 0) & 0xff,
                 lpFeeProfile: (params.lpFeeProfile ?? 0) & 0xff,
                 // Tax Token V2 专属字段

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

@@ -21,3 +21,6 @@ export { flapBundleCurveToDex } from './curve-to-dex.js';
 export { flapBundleCreateToDex } from './create-to-dex.js';
 // ✅ 内盘换手方法（一卖一买、一卖多买、快捷资金利用率、交叉换手）
 export { flapBundleSwapMerkle, flapBatchSwapMerkle, flapQuickBatchSwapMerkle, flapCrossSwapMerkle } from './swap.js';
+// ✅ Tax Vault 金库类型（types.ts 中 TaxV2Config.vaultConfig 使用的类型）
+// 注意：TaxVaultConfig 完整导出在 flap/index.ts → vault.js 中
+// 这里仅从 types.ts 导出 TaxV2Config 中嵌套使用时的类型引用

package/dist/shared/flap/portal-bundle-merkle/types.d.ts

@@ -1,4 +1,5 @@
 import type { GeneratedWallet } from '../../../utils/wallet.js';
+import type { TaxVaultConfig } from '../vault.js';
 /**
  * ✅ 利润模式：
  * - 'single': 单一模式（默认），从金额最大的钱包统一扣除所有利润，只有一组多跳交易
@@ -32,6 +33,8 @@ export type TaxV2Config = {
     antiFarmerDuration: number;
     /** 税收分配配置 */
     distribution: TaxDistributionConfig;
+    /** ✅ Tax Vault 金库配置（可选） */
+    vaultConfig?: TaxVaultConfig;
 };
 export type FlapSignConfig = {
     rpcUrl: string;

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

@@ -0,0 +1,204 @@
+/**
+ * Flap Tax Vaults（税收金库）
+ *
+ * Tax Vaults 是 Flap Protocol 的扩展功能，允许开发者创建自定义智能合约
+ * 来管理税收代币的税费收入。通过 newTokenV5 的 extensionID/extensionData 参数集成。
+ *
+ * 工作原理：
+ * 1. extensionID = 金库类型标识符（bytes32）
+ * 2. extensionData = ABI 编码的金库初始化参数
+ * 3. 代币创建后，税费自动流入金库合约
+ * 4. 金库合约根据预设规则分配税费收入
+ *
+ * @module vault
+ */
+import { type JsonRpcProvider, type Wallet } from 'ethers';
+/**
+ * Flap 预定义金库扩展 ID
+ *
+ * 这些 ID 用于标识金库类型，作为 newTokenV5 的 extensionID 参数
+ * 计算方式：keccak256(vaultTypeName)
+ *
+ * ⚠️ 注意：当 Flap 官方发布正式的 Vault Extension ID 时，需要更新这些值
+ */
+export declare const VAULT_EXTENSION_IDS: {
+    /** 无金库（默认） */
+    readonly NONE: string;
+    /** 标准税收金库 - 累积税费并允许受益人提取 */
+    readonly STANDARD: string;
+    /** 自动回购金库 - 税费用于自动回购代币并销毁 */
+    readonly AUTO_BUYBACK: string;
+    /** 分红金库 - 税费按持仓比例分配给持有者 */
+    readonly DIVIDEND: string;
+    /** 流动性金库 - 税费自动添加到流动性池 */
+    readonly LIQUIDITY: string;
+    /** 自定义金库 - 用户部署的自定义合约 */
+    readonly CUSTOM: string;
+};
+/**
+ * 金库类型标签（用于 UI 显示）
+ */
+export declare const VAULT_TYPE_LABELS: Record<string, string>;
+/** 金库类型枚举 */
+export type VaultType = 'none' | 'standard' | 'auto_buyback' | 'dividend' | 'liquidity' | 'custom';
+/**
+ * Tax Vault 配置
+ * 用于在创建代币时指定金库设置
+ */
+export interface TaxVaultConfig {
+    /** 金库类型 */
+    vaultType: VaultType;
+    /**
+     * 自定义金库合约地址
+     * 仅当 vaultType === 'custom' 时必填
+     * 合约必须实现 ITaxVault 接口
+     */
+    vaultAddress?: string;
+    /**
+     * 自定义扩展 ID（bytes32）
+     * 高级用法：直接指定 extensionID，覆盖 vaultType 对应的默认值
+     */
+    customExtensionId?: string;
+    /**
+     * 自定义扩展数据（hex）
+     * 高级用法：直接指定 extensionData
+     * 不提供时，SDK 将根据 vaultType 自动编码
+     */
+    customExtensionData?: string;
+    /**
+     * 自动回购参数（vaultType === 'auto_buyback' 时使用）
+     */
+    buybackConfig?: {
+        /** 回购间隔（秒） */
+        interval: number;
+        /** 每次回购的最大金额（原生代币，wei） */
+        maxAmount: bigint;
+        /** 回购的代币是否销毁（true=销毁，false=发送到 beneficiary） */
+        burnAfterBuy: boolean;
+    };
+    /**
+     * 分红参数（vaultType === 'dividend' 时使用）
+     */
+    dividendConfig?: {
+        /** 最低持仓门槛（代币数量，ether 单位） */
+        minimumBalance: number;
+        /** 分红周期（秒） */
+        distributionInterval: number;
+    };
+    /**
+     * 流动性参数（vaultType === 'liquidity' 时使用）
+     */
+    liquidityConfig?: {
+        /** 自动添加流动性的触发阈值（原生代币，ether 单位） */
+        threshold: number;
+        /** 添加到的 DEX 池类型 */
+        poolType: 'v2' | 'v3';
+    };
+}
+/**
+ * 金库信息（链上查询结果）
+ */
+export interface VaultInfo {
+    /** 金库合约地址 */
+    address: string;
+    /** 金库中的代币余额 */
+    tokenBalance: bigint;
+    /** 金库中的原生代币余额 */
+    nativeBalance: bigint;
+    /** 金库所有者 */
+    owner: string;
+    /** 关联的代币地址 */
+    tokenAddress: string;
+    /** 是否已激活 */
+    isActive: boolean;
+}
+/**
+ * 金库奖励信息
+ */
+export interface VaultRewards {
+    /** 待领取的代币奖励 */
+    pendingTokenRewards: bigint;
+    /** 待领取的原生代币奖励 */
+    pendingNativeRewards: bigint;
+    /** 已领取的总代币奖励 */
+    claimedTokenRewards: bigint;
+    /** 已领取的总原生代币奖励 */
+    claimedNativeRewards: bigint;
+}
+/**
+ * ITaxVault 接口 ABI
+ * 所有 Flap Tax Vault 合约必须实现此接口
+ *
+ * ⚠️ 注意：这是基于 Flap 文档推断的标准接口
+ * 当官方发布正式接口规范时，需要更新此 ABI
+ */
+export declare const TAX_VAULT_ABI: string[];
+/**
+ * Vault Factory ABI
+ * 用于部署新的金库合约
+ */
+export declare const VAULT_FACTORY_ABI: string[];
+/**
+ * 根据 VaultType 获取对应的 extensionID
+ */
+export declare function getVaultExtensionId(vaultType: VaultType): string;
+/**
+ * 编码金库配置为 extensionData
+ *
+ * @param config - 金库配置
+ * @returns ABI 编码的 extensionData（hex string）
+ */
+export declare function encodeVaultExtensionData(config: TaxVaultConfig): string;
+/**
+ * 将 TaxVaultConfig 转换为 newTokenV5 需要的 extensionID 和 extensionData
+ *
+ * @param config - 金库配置
+ * @returns { extensionID, extensionData }
+ */
+export declare function buildVaultExtensionParams(config?: TaxVaultConfig): {
+    extensionID: string;
+    extensionData: string;
+};
+/**
+ * 查询金库信息
+ *
+ * @param provider - RPC Provider
+ * @param vaultAddress - 金库合约地址
+ * @returns 金库信息
+ */
+export declare function getVaultInfo(provider: JsonRpcProvider, vaultAddress: string): Promise<VaultInfo | null>;
+/**
+ * 查询用户在金库中的奖励
+ *
+ * @param provider - RPC Provider
+ * @param vaultAddress - 金库合约地址
+ * @param userAddress - 用户地址
+ * @returns 奖励信息
+ */
+export declare function getVaultRewards(provider: JsonRpcProvider, vaultAddress: string, userAddress: string): Promise<VaultRewards>;
+/**
+ * 从金库领取奖励
+ *
+ * @param wallet - 签名钱包
+ * @param vaultAddress - 金库合约地址
+ * @returns 交易收据
+ */
+export declare function claimVaultRewards(wallet: Wallet, vaultAddress: string): Promise<{
+    txHash: string;
+    amount: bigint;
+}>;
+/**
+ * 验证金库合约是否有效（是否部署了代码）
+ *
+ * @param provider - RPC Provider
+ * @param vaultAddress - 金库合约地址
+ * @returns 是否为有效合约
+ */
+export declare function isValidVaultContract(provider: JsonRpcProvider, vaultAddress: string): Promise<boolean>;
+/**
+ * 获取代币关联的金库地址（通过 extensionID 推断）
+ *
+ * @param extensionID - 代币的 extensionID（从 getTokenV5 获取）
+ * @returns 金库类型
+ */
+export declare function getVaultTypeFromExtensionId(extensionID: string): VaultType;

package/dist/shared/flap/vault.js

@@ -0,0 +1,288 @@
+/**
+ * Flap Tax Vaults（税收金库）
+ *
+ * Tax Vaults 是 Flap Protocol 的扩展功能，允许开发者创建自定义智能合约
+ * 来管理税收代币的税费收入。通过 newTokenV5 的 extensionID/extensionData 参数集成。
+ *
+ * 工作原理：
+ * 1. extensionID = 金库类型标识符（bytes32）
+ * 2. extensionData = ABI 编码的金库初始化参数
+ * 3. 代币创建后，税费自动流入金库合约
+ * 4. 金库合约根据预设规则分配税费收入
+ *
+ * @module vault
+ */
+import { Contract, AbiCoder, keccak256, toUtf8Bytes, ZeroAddress } from 'ethers';
+// ============================================================================
+// 常量
+// ============================================================================
+/**
+ * Flap 预定义金库扩展 ID
+ *
+ * 这些 ID 用于标识金库类型，作为 newTokenV5 的 extensionID 参数
+ * 计算方式：keccak256(vaultTypeName)
+ *
+ * ⚠️ 注意：当 Flap 官方发布正式的 Vault Extension ID 时，需要更新这些值
+ */
+export const VAULT_EXTENSION_IDS = {
+    /** 无金库（默认） */
+    NONE: '0x' + '00'.repeat(32),
+    /** 标准税收金库 - 累积税费并允许受益人提取 */
+    STANDARD: keccak256(toUtf8Bytes('FlapTaxVault.Standard')),
+    /** 自动回购金库 - 税费用于自动回购代币并销毁 */
+    AUTO_BUYBACK: keccak256(toUtf8Bytes('FlapTaxVault.AutoBuyback')),
+    /** 分红金库 - 税费按持仓比例分配给持有者 */
+    DIVIDEND: keccak256(toUtf8Bytes('FlapTaxVault.Dividend')),
+    /** 流动性金库 - 税费自动添加到流动性池 */
+    LIQUIDITY: keccak256(toUtf8Bytes('FlapTaxVault.Liquidity')),
+    /** 自定义金库 - 用户部署的自定义合约 */
+    CUSTOM: keccak256(toUtf8Bytes('FlapTaxVault.Custom')),
+};
+/**
+ * 金库类型标签（用于 UI 显示）
+ */
+export const VAULT_TYPE_LABELS = {
+    none: '无金库（标准税收）',
+    standard: '标准税收金库',
+    auto_buyback: '自动回购金库',
+    dividend: '分红金库',
+    liquidity: '流动性金库',
+    custom: '自定义金库',
+};
+// ============================================================================
+// ABI 定义
+// ============================================================================
+/**
+ * ITaxVault 接口 ABI
+ * 所有 Flap Tax Vault 合约必须实现此接口
+ *
+ * ⚠️ 注意：这是基于 Flap 文档推断的标准接口
+ * 当官方发布正式接口规范时，需要更新此 ABI
+ */
+export const TAX_VAULT_ABI = [
+    // 查询方法
+    'function token() external view returns (address)',
+    'function owner() external view returns (address)',
+    'function isActive() external view returns (bool)',
+    'function totalTaxCollected() external view returns (uint256)',
+    'function pendingRewards(address user) external view returns (uint256)',
+    'function claimedRewards(address user) external view returns (uint256)',
+    // 写入方法
+    'function claimRewards() external returns (uint256)',
+    'function withdraw(uint256 amount) external',
+    'function withdrawNative(uint256 amount) external',
+    'function activate() external',
+    'function deactivate() external',
+    // 事件
+    'event TaxReceived(address indexed token, uint256 amount)',
+    'event RewardsClaimed(address indexed user, uint256 amount)',
+    'event VaultActivated()',
+    'event VaultDeactivated()',
+];
+/**
+ * Vault Factory ABI
+ * 用于部署新的金库合约
+ */
+export const VAULT_FACTORY_ABI = [
+    'function createVault(address token, address owner, bytes32 vaultType, bytes initData) external returns (address)',
+    'function getVault(address token) external view returns (address)',
+    'function getVaultsByOwner(address owner) external view returns (address[])',
+    'event VaultCreated(address indexed token, address indexed vault, address indexed owner, bytes32 vaultType)',
+];
+// ============================================================================
+// 编码/解码工具
+// ============================================================================
+const abiCoder = AbiCoder.defaultAbiCoder();
+/**
+ * 根据 VaultType 获取对应的 extensionID
+ */
+export function getVaultExtensionId(vaultType) {
+    switch (vaultType) {
+        case 'none':
+            return VAULT_EXTENSION_IDS.NONE;
+        case 'standard':
+            return VAULT_EXTENSION_IDS.STANDARD;
+        case 'auto_buyback':
+            return VAULT_EXTENSION_IDS.AUTO_BUYBACK;
+        case 'dividend':
+            return VAULT_EXTENSION_IDS.DIVIDEND;
+        case 'liquidity':
+            return VAULT_EXTENSION_IDS.LIQUIDITY;
+        case 'custom':
+            return VAULT_EXTENSION_IDS.CUSTOM;
+        default:
+            return VAULT_EXTENSION_IDS.NONE;
+    }
+}
+/**
+ * 编码金库配置为 extensionData
+ *
+ * @param config - 金库配置
+ * @returns ABI 编码的 extensionData（hex string）
+ */
+export function encodeVaultExtensionData(config) {
+    if (config.customExtensionData) {
+        return config.customExtensionData;
+    }
+    switch (config.vaultType) {
+        case 'none':
+            return '0x';
+        case 'standard':
+            // 标准金库无额外参数
+            return '0x';
+        case 'auto_buyback': {
+            if (!config.buybackConfig)
+                return '0x';
+            return abiCoder.encode(['uint256', 'uint256', 'bool'], [config.buybackConfig.interval, config.buybackConfig.maxAmount, config.buybackConfig.burnAfterBuy]);
+        }
+        case 'dividend': {
+            if (!config.dividendConfig)
+                return '0x';
+            return abiCoder.encode(['uint256', 'uint256'], [config.dividendConfig.minimumBalance, config.dividendConfig.distributionInterval]);
+        }
+        case 'liquidity': {
+            if (!config.liquidityConfig)
+                return '0x';
+            const poolTypeInt = config.liquidityConfig.poolType === 'v3' ? 1 : 0;
+            return abiCoder.encode(['uint256', 'uint8'], [config.liquidityConfig.threshold, poolTypeInt]);
+        }
+        case 'custom': {
+            if (!config.vaultAddress) {
+                throw new Error('自定义金库必须提供 vaultAddress');
+            }
+            // 自定义金库：编码金库合约地址
+            return abiCoder.encode(['address'], [config.vaultAddress]);
+        }
+        default:
+            return '0x';
+    }
+}
+/**
+ * 将 TaxVaultConfig 转换为 newTokenV5 需要的 extensionID 和 extensionData
+ *
+ * @param config - 金库配置
+ * @returns { extensionID, extensionData }
+ */
+export function buildVaultExtensionParams(config) {
+    if (!config || config.vaultType === 'none') {
+        return {
+            extensionID: VAULT_EXTENSION_IDS.NONE,
+            extensionData: '0x',
+        };
+    }
+    return {
+        extensionID: config.customExtensionId || getVaultExtensionId(config.vaultType),
+        extensionData: encodeVaultExtensionData(config),
+    };
+}
+// ============================================================================
+// 链上查询
+// ============================================================================
+/**
+ * 查询金库信息
+ *
+ * @param provider - RPC Provider
+ * @param vaultAddress - 金库合约地址
+ * @returns 金库信息
+ */
+export async function getVaultInfo(provider, vaultAddress) {
+    try {
+        const vault = new Contract(vaultAddress, TAX_VAULT_ABI, provider);
+        const [tokenAddress, owner, isActive, nativeBalance] = await Promise.all([
+            vault.token().catch(() => ZeroAddress),
+            vault.owner().catch(() => ZeroAddress),
+            vault.isActive().catch(() => false),
+            provider.getBalance(vaultAddress),
+        ]);
+        // 如果金库关联了代币，查询代币余额
+        let tokenBalance = 0n;
+        if (tokenAddress !== ZeroAddress) {
+            const erc20 = new Contract(tokenAddress, [
+                'function balanceOf(address) view returns (uint256)',
+            ], provider);
+            tokenBalance = await erc20.balanceOf(vaultAddress).catch(() => 0n);
+        }
+        return {
+            address: vaultAddress,
+            tokenBalance,
+            nativeBalance,
+            owner: owner,
+            tokenAddress: tokenAddress,
+            isActive: isActive,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 查询用户在金库中的奖励
+ *
+ * @param provider - RPC Provider
+ * @param vaultAddress - 金库合约地址
+ * @param userAddress - 用户地址
+ * @returns 奖励信息
+ */
+export async function getVaultRewards(provider, vaultAddress, userAddress) {
+    const vault = new Contract(vaultAddress, TAX_VAULT_ABI, provider);
+    const [pendingTokenRewards, claimedTokenRewards] = await Promise.all([
+        vault.pendingRewards(userAddress).catch(() => 0n),
+        vault.claimedRewards(userAddress).catch(() => 0n),
+    ]);
+    return {
+        pendingTokenRewards: pendingTokenRewards,
+        pendingNativeRewards: 0n, // 需要根据实际合约接口调整
+        claimedTokenRewards: claimedTokenRewards,
+        claimedNativeRewards: 0n,
+    };
+}
+/**
+ * 从金库领取奖励
+ *
+ * @param wallet - 签名钱包
+ * @param vaultAddress - 金库合约地址
+ * @returns 交易收据
+ */
+export async function claimVaultRewards(wallet, vaultAddress) {
+    const vault = new Contract(vaultAddress, TAX_VAULT_ABI, wallet);
+    const tx = await vault.claimRewards();
+    const receipt = await tx.wait();
+    return {
+        txHash: receipt.hash,
+        amount: 0n, // 从事件中解析实际金额
+    };
+}
+/**
+ * 验证金库合约是否有效（是否部署了代码）
+ *
+ * @param provider - RPC Provider
+ * @param vaultAddress - 金库合约地址
+ * @returns 是否为有效合约
+ */
+export async function isValidVaultContract(provider, vaultAddress) {
+    try {
+        const code = await provider.getCode(vaultAddress);
+        return code !== '0x' && code !== '0x0';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 获取代币关联的金库地址（通过 extensionID 推断）
+ *
+ * @param extensionID - 代币的 extensionID（从 getTokenV5 获取）
+ * @returns 金库类型
+ */
+export function getVaultTypeFromExtensionId(extensionID) {
+    if (!extensionID || extensionID === VAULT_EXTENSION_IDS.NONE) {
+        return 'none';
+    }
+    for (const [key, value] of Object.entries(VAULT_EXTENSION_IDS)) {
+        if (value.toLowerCase() === extensionID.toLowerCase()) {
+            return key.toLowerCase();
+        }
+    }
+    // 未知的 extensionID，视为自定义金库
+    return 'custom';
+}

package/package.json

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