four-flap-meme-sdk 2.0.0 → 2.2.0

package/dist/shared/flap 2/vanity.js

@@ -1,110 +0,0 @@
-import { getCreate2Address, keccak256, randomBytes } from 'ethers';
-import { FLAP_ORIGINAL_PORTAL_ADDRESSES, FLAP_TOKEN_IMPL_ADDRESSES, getVanitySuffix } from './constants.js';
-/**
- * 预测 vanity 地址（CREATE2 proxy bytecode 方案）
- * 使用 ethers v6 的 getCreate2Address
- */
-export function predictVanityTokenAddress(salt, portal, tokenImpl) {
-    // 规范化 salt 到 bytes32（避免前端传入的短字符串导致不可预期行为）
-    const normalizedSalt = /^0x[0-9a-fA-F]{64}$/.test(salt)
-        ? salt.toLowerCase()
-        : keccak256(salt);
-    // 构建 EIP-1167 minimal proxy bytecode
-    const bytecode = '0x3d602d80600a3d3981f3363d3d373d3d3d363d73' + tokenImpl.slice(2).toLowerCase() + '5af43d82803e903d91602b57fd5bf3';
-    const bytecodeHash = keccak256(bytecode);
-    return getCreate2Address(portal, normalizedSalt, bytecodeHash);
-}
-/**
- * 预测 vanity 地址（使用链枚举）
- * SDK 自动使用该链的 Portal 和 TokenImpl 地址
- * 注意：使用 Flap 平台的原始 Portal 地址进行 CREATE2 计算
- * BSC/MONAD 默认使用 NORMAL 实现（非税版）
- * @param taxedV5 - 是否使用 V5 高级税代币实现 (mkt/deflation/dividend/lp)
- */
-export function predictVanityTokenAddressByChain(chain, salt, taxed = false, taxedV5 = false // ✅ 新增：V5 高级税代币标识
-) {
-    // 使用 Flap 平台的原始 Portal 地址（用于 CREATE2）
-    const portal = FLAP_ORIGINAL_PORTAL_ADDRESSES[chain];
-    let tokenImpl;
-    if (chain === 'BSC') {
-        if (taxedV5) {
-            // ✅ V5 高级税代币使用新的实现地址
-            tokenImpl = FLAP_TOKEN_IMPL_ADDRESSES.BSC_TAXED_V5;
-        }
-        else {
-            tokenImpl = taxed ? FLAP_TOKEN_IMPL_ADDRESSES.BSC_TAXED : FLAP_TOKEN_IMPL_ADDRESSES.BSC_NORMAL;
-        }
-    }
-    else if (chain === 'MONAD') {
-        // ✅ Monad 链支持税版和普通版
-        tokenImpl = taxed ? FLAP_TOKEN_IMPL_ADDRESSES.MONAD_TAXED : FLAP_TOKEN_IMPL_ADDRESSES.MONAD_NORMAL;
-    }
-    else {
-        tokenImpl = FLAP_TOKEN_IMPL_ADDRESSES[chain];
-    }
-    if (!portal || !tokenImpl) {
-        throw new Error(`Flap Protocol not fully deployed on ${chain}`);
-    }
-    return predictVanityTokenAddress(salt, portal, tokenImpl);
-}
-/**
- * 寻找满足后缀的 salt（默认 8888）
- * 注意：该方法为同步 CPU 搜索，谨慎设置迭代限制
- */
-export async function findSaltEnding(opts) {
-    const suffix = (opts.suffix ?? '8888').toLowerCase();
-    // 若未提供 seed，默认使用随机种子，避免每次结果都相同
-    let salt = opts.seed ?? keccak256(randomBytes(32));
-    let iterations = 0;
-    const limit = opts.maxIterations ?? 1000000;
-    while (iterations < limit) {
-        const addr = predictVanityTokenAddress(salt, opts.portal, opts.tokenImpl);
-        if (addr.toLowerCase().endsWith(suffix)) {
-            return { salt, address: addr, iterations };
-        }
-        salt = keccak256(salt);
-        iterations++;
-    }
-    throw new Error('findSaltEnding: maxIterations reached');
-}
-/**
- * 寻找满足后缀的 salt（使用链枚举）
- * SDK 自动使用该链的 Portal 和 TokenImpl 地址
- * 注意：使用 Flap 平台的原始 Portal 地址进行 CREATE2 计算
- * BSC/MONAD 默认使用 NORMAL 实现（非税版）
- * XLayer 只有标准版，后缀是 1111
- * @param taxedV5 - 是否使用 V5 高级税代币实现 (mkt/deflation/dividend/lp)
- */
-export async function findSaltEndingByChain(opts) {
-    // 使用 Flap 平台的原始 Portal 地址（用于 CREATE2）
-    const portal = FLAP_ORIGINAL_PORTAL_ADDRESSES[opts.chain];
-    let tokenImpl;
-    if (opts.chain === 'BSC') {
-        if (opts.taxedV5) {
-            // ✅ V5 高级税代币使用新的实现地址
-            tokenImpl = FLAP_TOKEN_IMPL_ADDRESSES.BSC_TAXED_V5;
-        }
-        else {
-            tokenImpl = opts.taxed ? FLAP_TOKEN_IMPL_ADDRESSES.BSC_TAXED : FLAP_TOKEN_IMPL_ADDRESSES.BSC_NORMAL;
-        }
-    }
-    else if (opts.chain === 'MONAD') {
-        // ✅ Monad 链支持税版和普通版
-        tokenImpl = opts.taxed ? FLAP_TOKEN_IMPL_ADDRESSES.MONAD_TAXED : FLAP_TOKEN_IMPL_ADDRESSES.MONAD_NORMAL;
-    }
-    else {
-        tokenImpl = FLAP_TOKEN_IMPL_ADDRESSES[opts.chain];
-    }
-    if (!portal || !tokenImpl) {
-        throw new Error(`Flap Protocol not fully deployed on ${opts.chain}`);
-    }
-    // ✅ 如果未指定后缀，根据链自动选择正确的后缀
-    const suffix = opts.suffix ?? getVanitySuffix(opts.chain, opts.taxed);
-    return findSaltEnding({
-        portal,
-        tokenImpl,
-        suffix,
-        maxIterations: opts.maxIterations,
-        seed: opts.seed
-    });
-}

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

@@ -1,240 +0,0 @@
-/**
- * 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 { type JsonRpcProvider } from 'ethers';
-/**
- * FieldDescriptor — 字段描述符
- * 对应 Solidity 结构体 IVaultSchemasV1.FieldDescriptor
- */
-export interface FieldDescriptor {
-    name: string;
-    fieldType: string;
-    description: string;
-    decimals: number;
-}
-/**
- * VaultDataSchema — 工厂数据模式
- * 对应 VaultFactoryBaseV2.vaultDataSchema() 返回值
- */
-export interface VaultDataSchema {
-    description: string;
-    fields: FieldDescriptor[];
-    isArray: boolean;
-}
-/**
- * ApproveAction — ERC-20 授权操作
- */
-export interface ApproveAction {
-    tokenType: string;
-    amountFieldName: string;
-}
-/**
- * VaultMethodSchema — 金库方法描述
- */
-export interface VaultMethodSchema {
-    name: string;
-    description: string;
-    inputs: FieldDescriptor[];
-    outputs: FieldDescriptor[];
-    approvals: ApproveAction[];
-    isInputArray: boolean;
-    isOutputArray: boolean;
-    isWriteMethod: boolean;
-}
-/**
- * VaultUISchema — 金库 UI 模式
- */
-export interface VaultUISchema {
-    vaultType: string;
-    description: string;
-    methods: VaultMethodSchema[];
-}
-/**
- * 金库类型枚举
- *
- * ⚠️ 基于 flap.sh 实际 JS 源码中 taxVaults.vaultTypes[] 配置
- * 每种类型对应一个 VaultFactory 合约地址
- */
-export type VaultType = 'none' | 'gift' | 'split' | 'buyback_burn' | 'burnToEarn' | 'buildYourVault';
-/**
- * 金库类型显示标签
- */
-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";
-};
-import { VAULT_PORTAL_ABI, VAULT_FACTORY_ABI, VAULT_FACTORY_V2_ABI, VAULT_BASE_ABI, VAULT_BASE_V2_ABI } from '../../abis/flap/vault.js';
-export { VAULT_PORTAL_ABI, VAULT_FACTORY_ABI, VAULT_FACTORY_V2_ABI, VAULT_BASE_ABI, VAULT_BASE_V2_ABI, };
-/** extensionID/extensionData 在金库模式下始终为零值 */
-export declare const NONE_EXTENSION_ID: string;
-/**
- * Tax Vault 创建配置
- *
- * ⚠️ 金库模式下的核心参数：
- *   - vaultFactory: VaultFactory 合约地址（直接传递给 VaultPortal）
- *   - vaultData: ABI 编码的金库初始化数据（由 vaultDataSchema 决定格式）
- *   - extensionID 和 extensionData 始终为零值
- */
-export interface TaxVaultConfig {
-    /** 金库类型 */
-    vaultType: VaultType;
-    /**
-     * VaultFactory 合约地址
-     * - 官方金库：从 VAULT_FACTORY_ADDRESSES 自动获取
-     * - buildYourVault：用户手动输入
-     */
-    factoryAddress?: string;
-    /**
-     * 金库初始化数据（原始 hex）
-     * 直接使用此数据作为 vaultData
-     */
-    rawVaultData?: string;
-    /**
-     * 金库数据字段值
-     * key = vaultDataSchema 中 field.name, value = 用户输入
-     */
-    vaultDataFields?: Record<string, string | number | boolean>;
-    /**
-     * 工厂的 vaultDataSchema
-     */
-    vaultDataSchema?: VaultDataSchema;
-}
-/**
- * 根据 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(config?: TaxVaultConfig): {
-    extensionID: string;
-    extensionData: string;
-};
-/**
- * 从 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>;
-/**
- * 金库信息（链上查询结果）
- */
-export interface VaultInfo {
-    /** 金库合约地址 */
-    address: string;
-    /** 金库中的原生代币余额 */
-    nativeBalance: bigint;
-    /** 金库描述 */
-    description: string | null;
-    /** 是否为 V2 金库 */
-    isV2: boolean;
-    /** V2 金库的 UI 模式 */
-    uiSchema: VaultUISchema | null;
-}