four-flap-meme-sdk 3.0.0 → 4.0.0

package/dist/domains/flap/vault.js

@@ -1,471 +1,7 @@
 /**
  * Flap Tax Vaults（税收金库）
  *
- * ⚠️ 重要：基于 flap.sh/launch 实际源码分析，金库模式架构如下：
- *
- * 1. 金库代币通过 VaultPortal 合约创建（不是普通 Portal）
- * 2. 调用函数：VaultPortal.newTaxTokenWithVault(params)
- * 3. 参数中 extensionID/extensionData 始终为零值
- * 4. 真正的金库配置通过 vaultFactory（工厂地址）和 vaultData（ABI 编码数据）传递
- * 5. 每种金库类型对应一个具体的 VaultFactory 合约地址
- *
- * 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)：
- *     - gift (FlapXVault)：禮物金庫，指定一个地址接收税费
- *     - split (SplitVault)：分配金庫，按比例将税费分配给多个接收者
- *     - buyback & burn (SnowBallVault)：自动回购并销毁代币
- *   社区金库 (community)：
- *     - burnToEarn (BlackHoleVault)：燃燒分紅，燃烧代币以赚取分红奖励
- *     - buildYourVault：構建您的金庫，用户输入自定义 VaultFactory 地址
- *
- * @module vault
- */
-import { Contract, AbiCoder, ZeroAddress } from 'ethers';
-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,
-    };
-}
-/**
- * 金库类型显示标签
- */
-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 合约地址（从 flap.sh 源码提取）
-// ============================================================================
-/**
- * VaultPortal 合约地址
- *
- * ⚠️ 金库代币通过 VaultPortal 创建，不是普通 Portal
- * 来源：flap.sh/_next/static/chunks/2601-*.js
- */
-export const VAULT_PORTAL_ADDRESSES = {
-    BSC: '0x90497450f2a706f1951b5bdda52B4E5d16f34C06',
-    BASE: '0x027e3704fC5C16522e9393d04C60A3ac5c0d775f',
-};
-// ============================================================================
-// VaultFactory 合约地址（从 flap.sh 源码提取）
-// ============================================================================
-/**
- * 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',
-};
-// ============================================================================
-// ABI 定义
-// ============================================================================
-/**
- * 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);
-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',
-    };
-}
-// ============================================================================
-// 链上查询
-// ============================================================================
-/**
- * 从 VaultFactory 合约读取 vaultDataSchema
- */
-export async function queryVaultDataSchema(provider, factoryAddress) {
-    try {
-        const factory = new Contract(factoryAddress, VAULT_FACTORY_V2_ABI, provider);
-        const raw = (await factory.vaultDataSchema());
-        return {
-            description: raw.description,
-            fields: raw.fields.map(mapFieldDescriptor),
-            isArray: raw.isArray,
-        };
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * 从金库合约读取 vaultUISchema
- */
-export async function queryVaultUISchema(provider, vaultAddress) {
-    try {
-        const vault = new Contract(vaultAddress, VAULT_BASE_V2_ABI, provider);
-        const raw = (await vault.vaultUISchema());
-        return {
-            vaultType: raw.vaultType,
-            description: raw.description,
-            methods: raw.methods.map(mapVaultMethodSchema),
-        };
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * 读取金库合约的动态描述
- */
-export async function queryVaultDescription(provider, vaultAddress) {
-    try {
-        const vault = new Contract(vaultAddress, VAULT_BASE_ABI, provider);
-        return await vault.description();
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * 验证合约是否是有效的 VaultFactory
- */
-export async function validateVaultFactory(provider, factoryAddress) {
-    try {
-        const code = await provider.getCode(factoryAddress);
-        if (code === '0x' || code === '0x0') {
-            return { isValid: false, isV2: false, schema: null, error: '地址没有部署合约' };
-        }
-        const schema = await queryVaultDataSchema(provider, factoryAddress);
-        return {
-            isValid: true,
-            isV2: schema !== null,
-            schema,
-        };
-    }
-    catch (e) {
-        return { isValid: false, isV2: false, schema: null, error: getErrorMessageFromUnknown(e) };
-    }
-}
-/**
- * 从 VaultPortal 查询代币的金库信息
- */
-export async function getVaultInfo(provider, vaultPortalAddress, taxTokenAddress) {
-    try {
-        const portal = new Contract(vaultPortalAddress, VAULT_PORTAL_ABI, provider);
-        const info = (await portal.getVault(taxTokenAddress));
-        return {
-            vault: info.vault,
-            vaultFactory: info.vaultFactory,
-            description: info.description,
-            isOfficial: info.isOfficial,
-            riskLevel: Number(info.riskLevel),
-        };
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * 验证合约是否有效（是否部署了代码）
+ * 原超长文件按职责拆分为 vault/ 目录下的多个子文件，
+ * 对外 export 符号与路径保持不变（见 vault/index.ts）。
  */
-export async function isValidContract(provider, address) {
-    try {
-        const code = await provider.getCode(address);
-        return code !== '0x' && code !== '0x0';
-    }
-    catch {
-        return false;
-    }
-}
+export * from './vault/index.js';

package/dist/domains/flap/writer.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Flap Portal — 写操作（writer）
+ */
+import { FlapPortal } from './reader.js';
+import type { PortalConfig, ExactInputParams, ExactInputV3Params, NewTokenV3Params, NewTokenV4Params, NewTokenV5Params } from './types.js';
+export declare class FlapPortalWriter extends FlapPortal {
+    private wallet;
+    constructor(cfg: PortalConfig, privateKey: string);
+    buy(token: string, to: string, minAmount: bigint, msgValue: bigint): Promise<any>;
+    sell(token: string, amount: bigint, minEth: bigint): Promise<any>;
+    swapExactInput(params: ExactInputParams, msgValue?: bigint): Promise<any>;
+    swapExactInputBuy(params: ExactInputParams, msgValue?: bigint): Promise<any>;
+    swapExactInputSell(params: ExactInputParams): Promise<any>;
+    swapExactInputV3(params: ExactInputV3Params, msgValue?: bigint): Promise<any>;
+    newTokenV2(args: {
+        name: string;
+        symbol: string;
+        meta: string;
+        dexThresh: number;
+        salt: string;
+        taxRate: number;
+        migratorType: number;
+        quoteToken: string;
+        quoteAmt: bigint;
+        beneficiary: string;
+        permitData?: string;
+        msgValue?: bigint;
+    }): Promise<any>;
+    newTokenV3(args: NewTokenV3Params & {
+        msgValue?: bigint;
+    }): Promise<any>;
+    /**
+     * 创建代币 V4 版本
+     * 相比 V3 新增了 DEX 选择和 LP 费率配置
+     *
+     * @param args 创建代币参数
+     * @param args.dexId DEX ID，选择迁移到哪个 DEX（使用 DEXId 枚举）
+     * @param args.lpFeeProfile LP 费率档位（使用 V3LPFeeProfile 枚举）
+     *
+     * @example
+     * ```typescript
+     * await portal.newTokenV4({
+     *   name: 'My Token',
+     *   symbol: 'MTK',
+     *   meta: 'bafkreicwlkpvrcqg4bbhyp2fnhdwbqos5ghka6gdjra3tdkgxxs74hqsze',
+     *   dexThresh: DexThreshType.FOUR_FIFTHS,
+     *   salt: '0x...',
+     *   taxRate: 0,
+     *   migratorType: MigratorType.V3_MIGRATOR,
+     *   quoteToken: '0x0000000000000000000000000000000000000000',
+     *   quoteAmt: 0n,
+     *   beneficiary: '0x...',
+     *   extensionID: '0x0000000000000000000000000000000000000000000000000000000000000000',
+     *   dexId: DEXId.DEX0,
+     *   lpFeeProfile: V3LPFeeProfile.LP_FEE_PROFILE_STANDARD,
+     *   msgValue: parseEther('0.01'),
+     * });
+     * ```
+     *
+     * @note BNB 链上使用 LP_FEE_PROFILE_LOW (0.01%) 需要白名单地址
+     */
+    newTokenV4(args: NewTokenV4Params & {
+        msgValue?: bigint;
+    }): Promise<any>;
+    /**
+     * 创建 Token V5（支持 Tax Token V2 高级税收分配）
+     *
+     * 当 taxRate > 0 时，支持以下税收分配：
+     * - mktBps: 营销分配（发送到 beneficiary 地址）
+     * - deflationBps: 通缩销毁（直接销毁）
+     * - dividendBps: 持有者分红（发送到分红合约）
+     * - lpBps: 流动性提供（LP 发送到 dead address）
+     *
+     * 注意：mktBps + deflationBps + dividendBps + lpBps 必须等于 10000 (100%)
+     *
+     * @example
+     * ```typescript
+     * // 创建一个 3% 税率的代币，税收分配：40% 营销，30% 销毁，20% 分红，10% 流动性
+     * await portal.newTokenV5({
+     *   name: 'My Tax Token',
+     *   symbol: 'MTT',
+     *   meta: 'bafkrei...',
+     *   dexThresh: DexThreshType.FOUR_FIFTHS,
+     *   salt: '0x...',
+     *   taxRate: 300,  // 3%
+     *   migratorType: MigratorType.V2_MIGRATOR,  // 税代币必须使用 V2 迁移器
+     *   quoteToken: '0x0000000000000000000000000000000000000000',
+     *   quoteAmt: 0n,
+     *   beneficiary: '0x...',
+     *   extensionID: '0x0000000000000000000000000000000000000000000000000000000000000000',
+     *   dexId: DEXId.DEX0,
+     *   lpFeeProfile: V3LPFeeProfile.LP_FEE_PROFILE_STANDARD,
+     *   taxDuration: 365n * 24n * 60n * 60n,  // 1 年
+     *   antiFarmerDuration: 60n * 60n,  // 1 小时
+     *   mktBps: 4000,  // 40%
+     *   deflationBps: 3000,  // 30%
+     *   dividendBps: 2000,  // 20%
+     *   lpBps: 1000,  // 10%
+     *   minimumShareBalance: 10000n * 10n ** 18n,  // 10K 代币
+     *   msgValue: parseEther('0.01'),
+     * });
+     * ```
+     *
+     * @note 税代币（taxRate > 0）必须使用 V2_MIGRATOR
+     */
+    newTokenV5(args: NewTokenV5Params & {
+        msgValue?: bigint;
+    }): Promise<any>;
+    claim(token: string): Promise<{
+        txHash: string;
+        tokenAmount: bigint;
+        ethAmount: bigint;
+    }>;
+    delegateClaim(token: string): Promise<{
+        txHash: string;
+        tokenAmount: bigint;
+        ethAmount: bigint;
+    }>;
+    /**
+     * 获取当前使用的 Portal 合约地址
+     * 用于事件监听等场景
+     */
+    getContractAddress(): string;
+}