four-flap-meme-sdk 3.0.0 → 4.0.0

package/dist/domains/flap/vault/constants.d.ts

@@ -0,0 +1,220 @@
+/**
+ * Flap Tax Vaults — 常量（地址 / 标签 / ABI）
+ */
+import type { VaultType } from './types.js';
+/**
+ * 金库类型显示标签
+ */
+export declare const VAULT_TYPE_LABELS: Record<VaultType, string>;
+/**
+ * 金库类型分类（对齐 flap.sh 的 category 字段）
+ */
+export declare const VAULT_TYPE_CATEGORIES: {
+    official: VaultType[];
+    community: VaultType[];
+};
+/**
+ * VaultPortal 合约地址
+ *
+ * ⚠️ 金库代币通过 VaultPortal 创建，不是普通 Portal
+ * 来源：flap.sh/_next/static/chunks/2601-*.js
+ */
+export declare const VAULT_PORTAL_ADDRESSES: Record<string, string>;
+/**
+ * VaultFactory 合约地址（每种金库类型 + 每条链）
+ *
+ * ⚠️ 直接从 flap.sh 前端 JS 源码中提取的真实地址
+ * 来源：flap.sh/_next/static/chunks/2601-*.js 中 taxVaults.vaultTypes[]
+ */
+export declare const VAULT_FACTORY_ADDRESSES: Record<string, Record<string, string>>;
+/**
+ * 金库额外配置（如 XVault 的 relayer 端点）
+ */
+export declare const VAULT_EXTRA_CONFIG: Record<string, Record<string, Record<string, string>>>;
+/**
+ * Flap Guardian 合约地址
+ */
+export declare const FLAP_GUARDIAN_ADDRESSES: {
+    readonly BSC: "0x9e27098dcD8844bcc6287a557E0b4D09C86B8a4b";
+};
+/**
+ * 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: "newTaxTokenWithVault";
+    readonly inputs: readonly [{
+        readonly name: "params";
+        readonly type: "tuple";
+        readonly internalType: "struct IVaultPortalTypes.NewTaxTokenWithVaultParams";
+        readonly components: readonly [{
+            readonly name: "name";
+            readonly type: "string";
+            readonly internalType: "string";
+        }, {
+            readonly name: "symbol";
+            readonly type: "string";
+            readonly internalType: "string";
+        }, {
+            readonly name: "meta";
+            readonly type: "string";
+            readonly internalType: "string";
+        }, {
+            readonly name: "dexThresh";
+            readonly type: "uint8";
+            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";
+            readonly internalType: "enum IPortalTypes.MigratorType";
+        }, {
+            readonly name: "quoteToken";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "quoteAmt";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "permitData";
+            readonly type: "bytes";
+            readonly internalType: "bytes";
+        }, {
+            readonly name: "extensionID";
+            readonly type: "bytes32";
+            readonly internalType: "bytes32";
+        }, {
+            readonly name: "extensionData";
+            readonly type: "bytes";
+            readonly internalType: "bytes";
+        }, {
+            readonly name: "dexId";
+            readonly type: "uint8";
+            readonly internalType: "enum IPortalTypes.DEXId";
+        }, {
+            readonly name: "lpFeeProfile";
+            readonly type: "uint8";
+            readonly internalType: "enum IPortalTypes.V3LPFeeProfile";
+        }, {
+            readonly name: "taxDuration";
+            readonly type: "uint64";
+            readonly internalType: "uint64";
+        }, {
+            readonly name: "antiFarmerDuration";
+            readonly type: "uint64";
+            readonly internalType: "uint64";
+        }, {
+            readonly name: "mktBps";
+            readonly type: "uint16";
+            readonly internalType: "uint16";
+        }, {
+            readonly name: "deflationBps";
+            readonly type: "uint16";
+            readonly internalType: "uint16";
+        }, {
+            readonly name: "dividendBps";
+            readonly type: "uint16";
+            readonly internalType: "uint16";
+        }, {
+            readonly name: "lpBps";
+            readonly type: "uint16";
+            readonly internalType: "uint16";
+        }, {
+            readonly name: "minimumShareBalance";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "vaultFactory";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "vaultData";
+            readonly type: "bytes";
+            readonly internalType: "bytes";
+        }];
+    }];
+    readonly outputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "getVault";
+    readonly inputs: readonly [{
+        readonly name: "taxToken";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "info";
+        readonly type: "tuple";
+        readonly internalType: "struct IVaultPortalTypes.VaultInfo";
+        readonly components: readonly [{
+            readonly name: "vault";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "vaultFactory";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "description";
+            readonly type: "string";
+            readonly internalType: "string";
+        }, {
+            readonly name: "isOfficial";
+            readonly type: "bool";
+            readonly internalType: "bool";
+        }, {
+            readonly name: "riskLevel";
+            readonly type: "uint8";
+            readonly internalType: "enum IVaultPortalTypes.RiskLevel";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "predictTaxTokenV1Address";
+    readonly inputs: readonly [{
+        readonly name: "salt";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "predictedAddress";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}];
+/**
+ * IVaultFactory ABI（V1）
+ */
+export declare const VAULT_FACTORY_ABI: string[];
+/**
+ * VaultFactoryBaseV2 ABI
+ */
+export declare const VAULT_FACTORY_V2_ABI: string[];
+/**
+ * VaultBase ABI（V1）
+ */
+export declare const VAULT_BASE_ABI: string[];
+/**
+ * VaultBaseV2 ABI
+ */
+export declare const VAULT_BASE_V2_ABI: string[];
+/** extensionID/extensionData 在金库模式下始终为零值 */
+export declare const NONE_EXTENSION_ID: string;

package/dist/domains/flap/vault/constants.js

@@ -0,0 +1,173 @@
+/**
+ * Flap Tax Vaults — 常量（地址 / 标签 / ABI）
+ */
+import { ZeroAddress } from 'ethers';
+/**
+ * 金库类型显示标签
+ */
+export const VAULT_TYPE_LABELS = {
+    none: '无金库（标准税收）',
+    gift: 'FlapXVault — 禮物金庫',
+    split: 'SplitVault — 分配金庫',
+    buyback_burn: 'SnowBallVault — Buyback & Burn',
+    burnToEarn: 'BlackHoleVault — 燃燒分紅',
+    buildYourVault: 'Build Your Vault — 構建您的金庫',
+};
+/**
+ * 金库类型分类（对齐 flap.sh 的 category 字段）
+ */
+export const VAULT_TYPE_CATEGORIES = {
+    official: ['gift', 'split', 'buyback_burn'],
+    community: ['burnToEarn', 'buildYourVault'],
+};
+/**
+ * VaultPortal 合约地址
+ *
+ * ⚠️ 金库代币通过 VaultPortal 创建，不是普通 Portal
+ * 来源：flap.sh/_next/static/chunks/2601-*.js
+ */
+export const VAULT_PORTAL_ADDRESSES = {
+    BSC: '0x90497450f2a706f1951b5bdda52B4E5d16f34C06',
+    BASE: '0x027e3704fC5C16522e9393d04C60A3ac5c0d775f',
+};
+/**
+ * VaultFactory 合约地址（每种金库类型 + 每条链）
+ *
+ * ⚠️ 直接从 flap.sh 前端 JS 源码中提取的真实地址
+ * 来源：flap.sh/_next/static/chunks/2601-*.js 中 taxVaults.vaultTypes[]
+ */
+export const VAULT_FACTORY_ADDRESSES = {
+    BSC: {
+        gift: '0x025549F52B03cF36f9e1a337c02d3AA7Af66ab32',
+        split: '0xfab75Dc774cB9B38b91749B8833360B46a52345F',
+        // bnbshare: '0x53AD93F2454cFA532656f80E30571159d7E726A7', // 已禁用 (enabled: false)
+        buyback_burn: '0xB64655dab7156c29B63C70fb3ED7f071e2658D19',
+        burnToEarn: '0x47A216040Dc9e0AfE2e6fc5dcC44f7bBD1B60d25',
+        buildYourVault: ZeroAddress, // 用户自定义地址
+    },
+    BASE: {
+        gift: '0xa02DA44D67DB6D692efa7f751b5952bd670d5326',
+        split: '0x1ae091F75D593eb7dC6539600a185C8A6076A424',
+        buyback_burn: '0x6F97fA674a6FE5EC37e309B63aB54E33c9e64d2E',
+        burnToEarn: '0x47A216040Dc9e0AfE2e6fc5dcC44f7bBD1B60d25',
+        buildYourVault: ZeroAddress,
+    },
+};
+/**
+ * 金库额外配置（如 XVault 的 relayer 端点）
+ */
+export const VAULT_EXTRA_CONFIG = {
+    BSC: {
+        gift: { XVaultRelayerEndpoint: 'https://xoracle.taxed.fun/' },
+    },
+    BASE: {
+        gift: { XVaultRelayerEndpoint: 'https://xrelayer.taxed.fun/' },
+    },
+};
+/**
+ * Flap Guardian 合约地址
+ */
+export const FLAP_GUARDIAN_ADDRESSES = {
+    BSC: '0x9e27098dcD8844bcc6287a557E0b4D09C86B8a4b',
+};
+/**
+ * VaultPortal ABI — newTaxTokenWithVault
+ *
+ * ⚠️ 从 flap.sh 前端 JS 源码提取的真实 ABI
+ * 来源：flap.sh/_next/static/chunks/6288-*.js（VaultPortal 合约 ABI）
+ */
+export const VAULT_PORTAL_ABI = [
+    {
+        type: 'function',
+        name: 'newTaxTokenWithVault',
+        inputs: [
+            {
+                name: 'params',
+                type: 'tuple',
+                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 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' },
+                    { name: 'permitData', type: 'bytes', internalType: 'bytes' },
+                    { name: 'extensionID', type: 'bytes32', internalType: 'bytes32' },
+                    { name: 'extensionData', type: 'bytes', internalType: 'bytes' },
+                    { name: 'dexId', type: 'uint8', internalType: 'enum IPortalTypes.DEXId' },
+                    { name: 'lpFeeProfile', type: 'uint8', internalType: 'enum IPortalTypes.V3LPFeeProfile' },
+                    { name: 'taxDuration', type: 'uint64', internalType: 'uint64' },
+                    { name: 'antiFarmerDuration', type: 'uint64', internalType: 'uint64' },
+                    { name: 'mktBps', type: 'uint16', internalType: 'uint16' },
+                    { name: 'deflationBps', type: 'uint16', internalType: 'uint16' },
+                    { name: 'dividendBps', type: 'uint16', internalType: 'uint16' },
+                    { name: 'lpBps', type: 'uint16', internalType: 'uint16' },
+                    { name: 'minimumShareBalance', type: 'uint256', internalType: 'uint256' },
+                    { name: 'vaultFactory', type: 'address', internalType: 'address' },
+                    { name: 'vaultData', type: 'bytes', internalType: 'bytes' },
+                ],
+            },
+        ],
+        outputs: [{ name: 'token', type: 'address', internalType: 'address' }],
+        stateMutability: 'payable',
+    },
+    {
+        type: 'function',
+        name: 'getVault',
+        inputs: [{ name: 'taxToken', type: 'address', internalType: 'address' }],
+        outputs: [
+            {
+                name: 'info',
+                type: 'tuple',
+                internalType: 'struct IVaultPortalTypes.VaultInfo',
+                components: [
+                    { name: 'vault', type: 'address', internalType: 'address' },
+                    { name: 'vaultFactory', type: 'address', internalType: 'address' },
+                    { name: 'description', type: 'string', internalType: 'string' },
+                    { name: 'isOfficial', type: 'bool', internalType: 'bool' },
+                    { name: 'riskLevel', type: 'uint8', internalType: 'enum IVaultPortalTypes.RiskLevel' },
+                ],
+            },
+        ],
+        stateMutability: 'view',
+    },
+    {
+        type: 'function',
+        name: 'predictTaxTokenV1Address',
+        inputs: [{ name: 'salt', type: 'bytes32', internalType: 'bytes32' }],
+        outputs: [{ name: 'predictedAddress', type: 'address', internalType: 'address' }],
+        stateMutability: 'view',
+    },
+];
+/**
+ * IVaultFactory ABI（V1）
+ */
+export const VAULT_FACTORY_ABI = [
+    'function newVault(address token, address beneficiary, bytes vaultData) external returns (address)',
+];
+/**
+ * VaultFactoryBaseV2 ABI
+ */
+export const VAULT_FACTORY_V2_ABI = [
+    ...VAULT_FACTORY_ABI,
+    'function vaultDataSchema() public pure returns (tuple(string description, tuple(string name, string fieldType, string description, uint8 decimals)[] fields, bool isArray))',
+];
+/**
+ * VaultBase ABI（V1）
+ */
+export const VAULT_BASE_ABI = ['function description() public view returns (string)'];
+/**
+ * VaultBaseV2 ABI
+ */
+export const VAULT_BASE_V2_ABI = [
+    ...VAULT_BASE_ABI,
+    'function vaultUISchema() public pure returns (tuple(string vaultType, string description, tuple(string name, string description, tuple(string name, string fieldType, string description, uint8 decimals)[] inputs, tuple(string name, string fieldType, string description, uint8 decimals)[] outputs, tuple(string tokenType, string amountFieldName)[] approvals, bool isInputArray, bool isOutputArray, bool isWriteMethod)[] methods))',
+    'function taxToken() public view returns (address)',
+    'function lpToken() public view returns (address)',
+];
+/** extensionID/extensionData 在金库模式下始终为零值 */
+export const NONE_EXTENSION_ID = '0x' + '00'.repeat(32);

package/dist/domains/flap/vault/encode.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Flap Tax Vaults — 编码与参数构建（encode）
+ */
+import type { TaxVaultConfig, VaultDataSchema, VaultType } from './types.js';
+/**
+ * 根据 VaultDataSchema 和用户输入编码 vaultData
+ */
+export declare function encodeVaultData(schema: VaultDataSchema, fieldValues: Record<string, string | number | boolean>): string;
+/**
+ * 获取指定链和金库类型的 VaultFactory 合约地址
+ */
+export declare function getVaultFactoryAddress(chain: string, vaultType: VaultType): string | null;
+/**
+ * 获取指定链的 VaultPortal 合约地址
+ */
+export declare function getVaultPortalAddress(chain: string): string | null;
+/**
+ * 构建金库参数（用于 VaultPortal.newTaxTokenWithVault）
+ *
+ * ⚠️ 重要：返回的是 vaultFactory 和 vaultData，不是 extensionID/extensionData
+ * extensionID/extensionData 在金库模式下始终为零值
+ *
+ * @returns { vaultFactory, vaultData } 直接传给 VaultPortal
+ */
+export declare function buildVaultParams(config?: TaxVaultConfig, chain?: string): {
+    vaultFactory: string;
+    vaultData: string;
+};
+/**
+ * 旧版兼容：将 TaxVaultConfig 转换为 extensionID 和 extensionData
+ *
+ * ⚠️ 注意：真实的 Flap 平台在金库模式下 extensionID/extensionData 始终为零值
+ * 金库参数通过 VaultPortal 的 vaultFactory/vaultData 传递
+ * 此函数仅用于向后兼容
+ */
+export declare function buildVaultExtensionParams(): {
+    extensionID: string;
+    extensionData: string;
+};

package/dist/domains/flap/vault/encode.js

@@ -0,0 +1,135 @@
+/**
+ * Flap Tax Vaults — 编码与参数构建（encode）
+ */
+import { AbiCoder, ZeroAddress } from 'ethers';
+import { NONE_EXTENSION_ID, VAULT_FACTORY_ADDRESSES, VAULT_PORTAL_ADDRESSES } from './constants.js';
+const abiCoder = AbiCoder.defaultAbiCoder();
+/**
+ * 根据 VaultDataSchema 和用户输入编码 vaultData
+ */
+export function encodeVaultData(schema, fieldValues) {
+    if (schema.fields.length === 0 && !schema.isArray) {
+        return '0x';
+    }
+    const types = [];
+    const values = [];
+    for (const field of schema.fields) {
+        const rawValue = fieldValues[field.name];
+        types.push(mapFieldTypeToAbiType(field.fieldType));
+        values.push(processFieldValue(field, rawValue));
+    }
+    if (schema.isArray) {
+        const tupleType = `tuple(${types.join(',')})`;
+        return abiCoder.encode([`${tupleType}[]`], [[values]]);
+    }
+    else {
+        return abiCoder.encode(types, values);
+    }
+}
+function mapFieldTypeToAbiType(fieldType) {
+    if (fieldType === 'time')
+        return 'uint256';
+    return 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 'bytes':
+            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));
+    }
+    if (field.fieldType === 'bool') {
+        return Boolean(rawValue);
+    }
+    return rawValue;
+}
+/**
+ * 获取指定链和金库类型的 VaultFactory 合约地址
+ */
+export function getVaultFactoryAddress(chain, vaultType) {
+    const chainKey = chain.toUpperCase();
+    const factories = VAULT_FACTORY_ADDRESSES[chainKey];
+    if (!factories)
+        return null;
+    return factories[vaultType] || null;
+}
+/**
+ * 获取指定链的 VaultPortal 合约地址
+ */
+export function getVaultPortalAddress(chain) {
+    const chainKey = chain.toUpperCase();
+    return VAULT_PORTAL_ADDRESSES[chainKey] || null;
+}
+/**
+ * 构建金库参数（用于 VaultPortal.newTaxTokenWithVault）
+ *
+ * ⚠️ 重要：返回的是 vaultFactory 和 vaultData，不是 extensionID/extensionData
+ * extensionID/extensionData 在金库模式下始终为零值
+ *
+ * @returns { vaultFactory, vaultData } 直接传给 VaultPortal
+ */
+export function buildVaultParams(config, chain) {
+    if (!config || config.vaultType === 'none') {
+        return {
+            vaultFactory: ZeroAddress,
+            vaultData: '0x',
+        };
+    }
+    // 1. 确定 vaultFactory 地址
+    let vaultFactory;
+    if (config.factoryAddress && config.factoryAddress !== ZeroAddress) {
+        vaultFactory = config.factoryAddress;
+    }
+    else if (chain) {
+        const addr = getVaultFactoryAddress(chain, config.vaultType);
+        if (!addr || addr === ZeroAddress) {
+            throw new Error(`链 "${chain}" 上没有 "${config.vaultType}" 类型的官方金库工厂`);
+        }
+        vaultFactory = addr;
+    }
+    else {
+        throw new Error(`金库类型 "${config.vaultType}" 必须提供 factoryAddress 或 chain`);
+    }
+    // 2. 确定 vaultData
+    let vaultData;
+    if (config.rawVaultData) {
+        vaultData = config.rawVaultData;
+    }
+    else if (config.vaultDataSchema && config.vaultDataFields) {
+        vaultData = encodeVaultData(config.vaultDataSchema, config.vaultDataFields);
+    }
+    else if (config.vaultDataSchema && config.vaultDataSchema.fields.length === 0 && !config.vaultDataSchema.isArray) {
+        vaultData = '0x';
+    }
+    else {
+        // 默认空数据（部分工厂不需要 vaultData）
+        vaultData = '0x';
+    }
+    return { vaultFactory, vaultData };
+}
+/**
+ * 旧版兼容：将 TaxVaultConfig 转换为 extensionID 和 extensionData
+ *
+ * ⚠️ 注意：真实的 Flap 平台在金库模式下 extensionID/extensionData 始终为零值
+ * 金库参数通过 VaultPortal 的 vaultFactory/vaultData 传递
+ * 此函数仅用于向后兼容
+ */
+export function buildVaultExtensionParams() {
+    // 金库模式下 extensionID/extensionData 始终为零值
+    return {
+        extensionID: NONE_EXTENSION_ID,
+        extensionData: '0x',
+    };
+}

package/dist/domains/flap/vault/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Flap Tax Vaults barrel
+ *
+ * 原超长文件按职责拆分为：
+ * - types.ts：类型定义
+ * - constants.ts：地址 / 标签 / ABI 常量
+ * - encode.ts：编码与参数构建
+ * - query.ts：链上查询
+ *
+ * 对外 export 符号与路径保持不变。
+ */
+export { NONE_EXTENSION_ID, VAULT_TYPE_LABELS, VAULT_TYPE_CATEGORIES, VAULT_FACTORY_ADDRESSES, VAULT_PORTAL_ADDRESSES, VAULT_PORTAL_ABI, VAULT_EXTRA_CONFIG, FLAP_GUARDIAN_ADDRESSES, VAULT_FACTORY_ABI, VAULT_FACTORY_V2_ABI, VAULT_BASE_ABI, VAULT_BASE_V2_ABI, } from './constants.js';
+export type { VaultType, TaxVaultConfig, VaultInfo, FieldDescriptor, VaultDataSchema, ApproveAction, VaultMethodSchema, VaultUISchema, } from './types.js';
+export { encodeVaultData, buildVaultParams, buildVaultExtensionParams, getVaultFactoryAddress, getVaultPortalAddress, } from './encode.js';
+export { queryVaultDataSchema, queryVaultUISchema, queryVaultDescription, validateVaultFactory, getVaultInfo, isValidContract, } from './query.js';

package/dist/domains/flap/vault/index.js

@@ -0,0 +1,14 @@
+/**
+ * Flap Tax Vaults barrel
+ *
+ * 原超长文件按职责拆分为：
+ * - types.ts：类型定义
+ * - constants.ts：地址 / 标签 / ABI 常量
+ * - encode.ts：编码与参数构建
+ * - query.ts：链上查询
+ *
+ * 对外 export 符号与路径保持不变。
+ */
+export { NONE_EXTENSION_ID, VAULT_TYPE_LABELS, VAULT_TYPE_CATEGORIES, VAULT_FACTORY_ADDRESSES, VAULT_PORTAL_ADDRESSES, VAULT_PORTAL_ABI, VAULT_EXTRA_CONFIG, FLAP_GUARDIAN_ADDRESSES, VAULT_FACTORY_ABI, VAULT_FACTORY_V2_ABI, VAULT_BASE_ABI, VAULT_BASE_V2_ABI, } from './constants.js';
+export { encodeVaultData, buildVaultParams, buildVaultExtensionParams, getVaultFactoryAddress, getVaultPortalAddress, } from './encode.js';
+export { queryVaultDataSchema, queryVaultUISchema, queryVaultDescription, validateVaultFactory, getVaultInfo, isValidContract, } from './query.js';

package/dist/domains/flap/vault/query.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Flap Tax Vaults — 链上查询（query）
+ */
+import { type JsonRpcProvider } from 'ethers';
+import { type VaultDataSchema, type VaultUISchema } from './types.js';
+/**
+ * 从 VaultFactory 合约读取 vaultDataSchema
+ */
+export declare function queryVaultDataSchema(provider: JsonRpcProvider, factoryAddress: string): Promise<VaultDataSchema | null>;
+/**
+ * 从金库合约读取 vaultUISchema
+ */
+export declare function queryVaultUISchema(provider: JsonRpcProvider, vaultAddress: string): Promise<VaultUISchema | null>;
+/**
+ * 读取金库合约的动态描述
+ */
+export declare function queryVaultDescription(provider: JsonRpcProvider, vaultAddress: string): Promise<string | null>;
+/**
+ * 验证合约是否是有效的 VaultFactory
+ */
+export declare function validateVaultFactory(provider: JsonRpcProvider, factoryAddress: string): Promise<{
+    isValid: boolean;
+    isV2: boolean;
+    schema: VaultDataSchema | null;
+    error?: string;
+}>;
+/**
+ * 从 VaultPortal 查询代币的金库信息
+ */
+export declare function getVaultInfo(provider: JsonRpcProvider, vaultPortalAddress: string, taxTokenAddress: string): Promise<{
+    vault: string;
+    vaultFactory: string;
+    description: string;
+    isOfficial: boolean;
+    riskLevel: number;
+} | null>;
+/**
+ * 验证合约是否有效（是否部署了代码）
+ */
+export declare function isValidContract(provider: JsonRpcProvider, address: string): Promise<boolean>;