four-flap-meme-sdk 2.0.0 → 2.2.0

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

@@ -1,366 +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 { Contract, AbiCoder, 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 合约地址（从 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',
-};
-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 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(config) {
-    // 金库模式下 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((f) => ({
-                name: f.name,
-                fieldType: f.fieldType,
-                description: f.description,
-                decimals: Number(f.decimals),
-            })),
-            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((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 {
-        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: String(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;
-    }
-}
-/**
- * 验证合约是否有效（是否部署了代码）
- */
-export async function isValidContract(provider, address) {
-    try {
-        const code = await provider.getCode(address);
-        return code !== '0x' && code !== '0x0';
-    }
-    catch {
-        return false;
-    }
-}

package/dist/shared/four 2/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * Four.meme 工具模块
- *
- * 提供 Four.meme 平台相关的工具函数：
- * - TaxToken：税币识别、状态查询、奖励领取
- */
-export { isTaxToken, isAntiSniperFeeMode, getCreatorType, getTaxTokenInfo, getClaimableFee, getClaimedFee, getUserRewardInfo, buildClaimFeeTx, buildBatchClaimFeeTxs, validateFourTokenTaxInfo, TAX_TOKEN_ABI, TransferMode, type TaxTokenConfig, type TaxTokenRewardStats, type TaxTokenUserInfo, type TaxTokenInfo, } from './tax-token.js';

package/dist/shared/four 2/index.js

@@ -1,22 +0,0 @@
-/**
- * Four.meme 工具模块
- *
- * 提供 Four.meme 平台相关的工具函数：
- * - TaxToken：税币识别、状态查询、奖励领取
- */
-// TaxToken 工具
-export { 
-// 识别方法
-isTaxToken, isAntiSniperFeeMode, getCreatorType, 
-// 状态查询
-getTaxTokenInfo, 
-// 用户奖励
-getClaimableFee, getClaimedFee, getUserRewardInfo, 
-// 奖励领取
-buildClaimFeeTx, buildBatchClaimFeeTxs, 
-// 校验工具
-validateFourTokenTaxInfo, 
-// ABI
-TAX_TOKEN_ABI, 
-// 类型
-TransferMode, } from './tax-token.js';

package/dist/shared/four 2/tax-token.d.ts

@@ -1,176 +0,0 @@
-import TaxTokenAbi from '../abis/TaxToken.json';
-/** TaxToken 转账模式 */
-export declare enum TransferMode {
-    /** 正常转账模式 - 允许所有转账 */
-    NORMAL = 0,
-    /** 限制转账模式 - 禁止所有转账 */
-    RESTRICTED = 1,
-    /** 受控转账模式 - 只允许与 owner 相关的转账 */
-    CONTROLLED = 2
-}
-/** TaxToken 税收配置状态 */
-export type TaxTokenConfig = {
-    /** 交易费率（基点，10000 = 100%） */
-    feeRate: bigint;
-    /** 创始人分配比例（百分比，100 = 100%） */
-    rateFounder: bigint;
-    /** 持有者分配比例 */
-    rateHolder: bigint;
-    /** 销毁比例 */
-    rateBurn: bigint;
-    /** 流动性比例 */
-    rateLiquidity: bigint;
-    /** 创始人地址 */
-    founder: string;
-    /** 报价代币地址 */
-    quote: string;
-    /** PancakeSwap 配对地址 */
-    pair: string;
-    /** 当前转账模式 */
-    mode: TransferMode;
-    /** 最低分发阈值 */
-    minDispatch: bigint;
-    /** 最低持仓参与分红门槛 */
-    minShare: bigint;
-};
-/** TaxToken 奖励统计数据 */
-export type TaxTokenRewardStats = {
-    /** 总持仓份额 */
-    totalShares: bigint;
-    /** 每份额累计奖励 */
-    feePerShare: bigint;
-    /** 累积待分发手续费 */
-    feeAccumulated: bigint;
-    /** 已分发手续费总额 */
-    feeDispatched: bigint;
-    /** 分配给创始人的代币总额 */
-    feeFounder: bigint;
-    /** 分配给持有者的代币总额 */
-    feeHolder: bigint;
-    /** 销毁的代币总额 */
-    feeBurn: bigint;
-    /** 注入流动性的代币总额 */
-    feeLiquidity: bigint;
-    /** 创始人获得的报价代币总额 */
-    quoteFounder: bigint;
-    /** 持有者获得的报价代币总额 */
-    quoteHolder: bigint;
-    /** 已领取的报价代币总额 */
-    quoteClaimed: bigint;
-};
-/** 用户在 TaxToken 中的奖励信息 */
-export type TaxTokenUserInfo = {
-    /** 用户持仓份额 */
-    share: bigint;
-    /** 已计入的奖励债务 */
-    rewardDebt: bigint;
-    /** 可领取的奖励金额（报价代币） */
-    claimable: bigint;
-    /** 已领取的奖励金额（报价代币） */
-    claimed: bigint;
-};
-/** TaxToken 完整信息 */
-export type TaxTokenInfo = {
-    config: TaxTokenConfig;
-    rewardStats: TaxTokenRewardStats;
-};
-/**
- * 链上判断代币是否是 TaxToken
- *
- * 原理：读取 TokenManager2._tokenInfos[token].template，
- * 提取 creatorType = (template >> 10) & 0x3F，判断是否等于 5
- *
- * @param tokenAddress - 代币合约地址
- * @param rpcUrl - BSC RPC URL
- * @returns 是否为 TaxToken
- */
-export declare function isTaxToken(tokenAddress: string, rpcUrl: string): Promise<boolean>;
-/**
- * 链上判断代币是否启用了 AntiSniperFeeMode
- *
- * 原理：读取 TokenManager2._tokenInfoEx1s[token].feeSetting > 0
- *
- * @param tokenAddress - 代币合约地址
- * @param rpcUrl - BSC RPC URL
- * @returns 是否启用 AntiSniperFeeMode
- */
-export declare function isAntiSniperFeeMode(tokenAddress: string, rpcUrl: string): Promise<boolean>;
-/**
- * 获取代币的 creatorType
- *
- * @param tokenAddress - 代币合约地址
- * @param rpcUrl - BSC RPC URL
- * @returns creatorType 数值
- */
-export declare function getCreatorType(tokenAddress: string, rpcUrl: string): Promise<number>;
-/**
- * 获取 TaxToken 的完整配置信息
- *
- * @param tokenAddress - TaxToken 合约地址
- * @param rpcUrl - BSC RPC URL
- * @returns 税收配置 + 奖励统计
- */
-export declare function getTaxTokenInfo(tokenAddress: string, rpcUrl: string): Promise<TaxTokenInfo>;
-/**
- * 查询用户在 TaxToken 中的可领取奖励
- *
- * @param tokenAddress - TaxToken 合约地址
- * @param account - 用户钱包地址
- * @param rpcUrl - BSC RPC URL
- * @returns 可领取的报价代币数量（wei）
- */
-export declare function getClaimableFee(tokenAddress: string, account: string, rpcUrl: string): Promise<bigint>;
-/**
- * 查询用户在 TaxToken 中的已领取奖励
- *
- * @param tokenAddress - TaxToken 合约地址
- * @param account - 用户钱包地址
- * @param rpcUrl - BSC RPC URL
- * @returns 已领取的报价代币数量（wei）
- */
-export declare function getClaimedFee(tokenAddress: string, account: string, rpcUrl: string): Promise<bigint>;
-/**
- * 查询用户在 TaxToken 中的完整奖励信息
- *
- * @param tokenAddress - TaxToken 合约地址
- * @param account - 用户钱包地址
- * @param rpcUrl - BSC RPC URL
- * @returns 用户奖励信息（份额、债务、可领取、已领取）
- */
-export declare function getUserRewardInfo(tokenAddress: string, account: string, rpcUrl: string): Promise<TaxTokenUserInfo>;
-/**
- * 构建 TaxToken 奖励领取的签名交易（不发送）
- *
- * @param tokenAddress - TaxToken 合约地址
- * @param privateKey - 用户私钥
- * @param rpcUrl - BSC RPC URL
- * @returns 签名后的交易 hex
- */
-export declare function buildClaimFeeTx(tokenAddress: string, privateKey: string, rpcUrl: string): Promise<string>;
-/**
- * 批量构建 TaxToken 奖励领取交易（多个钱包）
- *
- * @param tokenAddress - TaxToken 合约地址
- * @param privateKeys - 用户私钥数组
- * @param rpcUrl - BSC RPC URL
- * @returns 签名后的交易 hex 数组
- */
-export declare function buildBatchClaimFeeTxs(tokenAddress: string, privateKeys: string[], rpcUrl: string): Promise<string[]>;
-/**
- * 验证 FourTokenTaxInfo 参数合法性
- *
- * @param info - 税币配置
- * @returns 验证结果，valid=true 表示合法
- */
-export declare function validateFourTokenTaxInfo(info: {
-    feeRate: number;
-    burnRate: number;
-    divideRate: number;
-    liquidityRate: number;
-    recipientRate: number;
-    minSharing: number;
-}): {
-    valid: boolean;
-    error?: string;
-};
-export { TaxTokenAbi as TAX_TOKEN_ABI };