four-flap-meme-sdk 2.0.0 → 2.1.0

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

@@ -1,84 +0,0 @@
-import { FixedNumber } from 'ethers';
-/**
- * CDPV2 Bonding Curve 实现
- * 使用 ethers FixedNumber 进行高精度计算，避免浮点数精度损失
- *
- * 公式：
- * - Supply (S) = 1,000,000,000 + h - k / (R + r)
- * - Reserve (R) = k / (1,000,000,000 + h - S) - r
- * - Price (P) = k / (1,000,000,000 + h - S)²
- */
-const BILLION = FixedNumber.fromString('1000000000');
-export class CDPV2 {
-    static defaultDexSupplyThreshold() {
-        return FixedNumber.fromString('800000000');
-    }
-    static getCurve(r, h, k) {
-        if (h == null)
-            return new CDPV2(r, 0, 1e9 * r);
-        return new CDPV2(r, h, k);
-    }
-    constructor(r, h = 0, k = 0) {
-        this.r = r;
-        this.h = h;
-        this.k = k;
-    }
-    /**
-     * 根据储备量估算供应量
-     * Supply = BILLION + h - k / (reserve + r)
-     * @returns FixedNumber 对象，保持高精度
-     */
-    estimateSupply(reserve) {
-        if (!reserve || reserve === '0')
-            return FixedNumber.fromString('0');
-        const R = FixedNumber.fromString(reserve);
-        const r = FixedNumber.fromString(this.r.toString());
-        const h = FixedNumber.fromString(this.h.toString());
-        const k = FixedNumber.fromString(this.k.toString());
-        // k / (R + r)
-        const divisor = k.div(R.add(r));
-        // BILLION + h - divisor
-        return BILLION.add(h).sub(divisor);
-    }
-    /**
-     * 根据供应量估算储备量
-     * Reserve = k / (BILLION + h - amount) - r
-     * @returns FixedNumber 对象，保持高精度
-     */
-    estimateReserve(amount) {
-        if (!amount || amount === '0')
-            return FixedNumber.fromString('0');
-        const S = FixedNumber.fromString(amount);
-        const h = FixedNumber.fromString(this.h.toString());
-        const k = FixedNumber.fromString(this.k.toString());
-        const r = FixedNumber.fromString(this.r.toString());
-        // k / (BILLION + h - S)
-        const dividend = k.div(BILLION.add(h).sub(S));
-        // dividend - r
-        return dividend.sub(r);
-    }
-    /**
-     * 计算当前价格
-     * Price = k / (BILLION + h - supply)²
-     * @returns FixedNumber 对象，保持高精度
-     */
-    price(supply) {
-        const S = FixedNumber.fromString(supply || '0');
-        const h = FixedNumber.fromString(this.h.toString());
-        const k = FixedNumber.fromString(this.k.toString());
-        // BILLION + h - S
-        const denominator = BILLION.add(h).sub(S);
-        // denominator²
-        const denominatorSquared = denominator.mul(denominator);
-        // k / denominator²
-        return k.div(denominatorSquared);
-    }
-    /**
-     * 计算完全稀释估值 (FDV)
-     * FDV = price * BILLION
-     * @returns FixedNumber 对象，保持高精度
-     */
-    fdv(supply) {
-        return this.price(supply).mul(BILLION);
-    }
-}

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

@@ -1,37 +0,0 @@
-/**
- * Flap Protocol 错误代码
- */
-export type FlapErrorCode = 'TOKEN_ALREADY_EXISTS' | 'TOKEN_NOT_FOUND' | 'TOKEN_NOT_TRADABLE' | 'ALREADY_ON_DEX' | 'INSUFFICIENT_BALANCE' | 'SLIPPAGE_EXCEEDED' | 'INVALID_TOKEN' | 'INVALID_QUOTE_TOKEN' | 'INVALID_AMOUNT' | 'TAX_RATE_TOO_HIGH' | 'PERMIT_EXPIRED' | 'PERMIT_INVALID' | 'UNKNOWN_ERROR';
-/**
- * 解析 Flap Protocol 错误信息
- *
- * @param error - 捕获的错误对象
- * @returns 错误代码或 null（无法识别的错误）
- *
- * @example
- * ```typescript
- * try {
- *   await portal.swapExactInput(...);
- * } catch (err) {
- *   const errorCode = parseFlapError(err);
- *   if (errorCode === 'SLIPPAGE_EXCEEDED') {
- *     console.log('滑点过大，请调整参数');
- *   }
- * }
- * ```
- */
-export declare function parseFlapError(error: any): FlapErrorCode | null;
-/**
- * 获取错误的友好提示信息（中文）
- *
- * @param errorCode - 错误代码
- * @returns 友好的错误提示
- */
-export declare function getFlapErrorMessage(errorCode: FlapErrorCode | null): string;
-/**
- * 获取错误的友好提示信息（英文）
- *
- * @param errorCode - 错误代码
- * @returns 友好的错误提示
- */
-export declare function getFlapErrorMessageEn(errorCode: FlapErrorCode | null): string;

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

@@ -1,114 +0,0 @@
-/**
- * 解析 Flap Protocol 错误信息
- *
- * @param error - 捕获的错误对象
- * @returns 错误代码或 null（无法识别的错误）
- *
- * @example
- * ```typescript
- * try {
- *   await portal.swapExactInput(...);
- * } catch (err) {
- *   const errorCode = parseFlapError(err);
- *   if (errorCode === 'SLIPPAGE_EXCEEDED') {
- *     console.log('滑点过大，请调整参数');
- *   }
- * }
- * ```
- */
-export function parseFlapError(error) {
-    const msg = error?.message || error?.data?.message || String(error);
-    const msgLower = msg.toLowerCase();
-    // Token 状态相关错误
-    if (msgLower.includes('token already exists') || msgLower.includes('already created')) {
-        return 'TOKEN_ALREADY_EXISTS';
-    }
-    if (msgLower.includes('token not found') || msgLower.includes('invalid token')) {
-        return 'TOKEN_NOT_FOUND';
-    }
-    if (msgLower.includes('not tradable') || msgLower.includes('trading disabled')) {
-        return 'TOKEN_NOT_TRADABLE';
-    }
-    if (msgLower.includes('already on dex') || msgLower.includes('already migrated')) {
-        return 'ALREADY_ON_DEX';
-    }
-    // 余额相关错误
-    if (msgLower.includes('insufficient balance') || msgLower.includes('insufficient funds')) {
-        return 'INSUFFICIENT_BALANCE';
-    }
-    // 滑点错误
-    if (msgLower.includes('slippage') || msgLower.includes('min output')) {
-        return 'SLIPPAGE_EXCEEDED';
-    }
-    // 参数验证错误
-    if (msgLower.includes('invalid amount') || msgLower.includes('amount too small')) {
-        return 'INVALID_AMOUNT';
-    }
-    if (msgLower.includes('invalid quote token') || msgLower.includes('quote token not supported')) {
-        return 'INVALID_QUOTE_TOKEN';
-    }
-    if (msgLower.includes('tax rate') && msgLower.includes('too high')) {
-        return 'TAX_RATE_TOO_HIGH';
-    }
-    // Permit 相关错误
-    if (msgLower.includes('permit expired') || msgLower.includes('deadline')) {
-        return 'PERMIT_EXPIRED';
-    }
-    if (msgLower.includes('permit') && (msgLower.includes('invalid') || msgLower.includes('signature'))) {
-        return 'PERMIT_INVALID';
-    }
-    // 无法识别的错误
-    return null;
-}
-/**
- * 获取错误的友好提示信息（中文）
- *
- * @param errorCode - 错误代码
- * @returns 友好的错误提示
- */
-export function getFlapErrorMessage(errorCode) {
-    if (!errorCode)
-        return '未知错误，请检查交易参数';
-    const messages = {
-        TOKEN_ALREADY_EXISTS: '代币已存在，请使用不同的参数创建',
-        TOKEN_NOT_FOUND: '代币不存在或地址无效',
-        TOKEN_NOT_TRADABLE: '代币当前不可交易',
-        ALREADY_ON_DEX: '代币已迁移到 DEX，无法在联合曲线上交易',
-        INSUFFICIENT_BALANCE: '余额不足',
-        SLIPPAGE_EXCEEDED: '滑点过大，请调整最小输出数量或重试',
-        INVALID_TOKEN: '无效的代币地址',
-        INVALID_QUOTE_TOKEN: '不支持的 quote token',
-        INVALID_AMOUNT: '无效的交易数量',
-        TAX_RATE_TOO_HIGH: '税率设置过高（最大 10%）',
-        PERMIT_EXPIRED: 'Permit 签名已过期',
-        PERMIT_INVALID: 'Permit 签名无效',
-        UNKNOWN_ERROR: '未知错误',
-    };
-    return messages[errorCode];
-}
-/**
- * 获取错误的友好提示信息（英文）
- *
- * @param errorCode - 错误代码
- * @returns 友好的错误提示
- */
-export function getFlapErrorMessageEn(errorCode) {
-    if (!errorCode)
-        return 'Unknown error, please check transaction parameters';
-    const messages = {
-        TOKEN_ALREADY_EXISTS: 'Token already exists, please use different parameters',
-        TOKEN_NOT_FOUND: 'Token not found or invalid address',
-        TOKEN_NOT_TRADABLE: 'Token is not tradable at the moment',
-        ALREADY_ON_DEX: 'Token has been migrated to DEX, cannot trade on bonding curve',
-        INSUFFICIENT_BALANCE: 'Insufficient balance',
-        SLIPPAGE_EXCEEDED: 'Slippage tolerance exceeded, please adjust parameters or retry',
-        INVALID_TOKEN: 'Invalid token address',
-        INVALID_QUOTE_TOKEN: 'Quote token not supported',
-        INVALID_AMOUNT: 'Invalid trade amount',
-        TAX_RATE_TOO_HIGH: 'Tax rate too high (maximum 10%)',
-        PERMIT_EXPIRED: 'Permit signature expired',
-        PERMIT_INVALID: 'Invalid permit signature',
-        UNKNOWN_ERROR: 'Unknown error',
-    };
-    return messages[errorCode];
-}

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

@@ -1,22 +0,0 @@
-/**
- * Flap Protocol 模块
- *
- * 跨链支持的 Flap 协议功能
- *
- * 注意：由于历史原因，多个文件中有同名但不同的 FlapChain 类型
- * 使用时请从具体文件导入
- */
-export { FlapPortal, FlapPortalWriter, type FlapChain, // 主要的 FlapChain 定义
-type PortalConfig, type TokenStateV2, type TokenStateV3, type TokenStateV4, type TokenStateV5, type TokenStateV7, type QuoteExactInputParams, type ExactInputParams, type ExactInputV3Params, type NewTokenV3Params, type NewTokenV4Params, type NewTokenV5Params, type TaxDistributionConfig, validateTaxDistribution, TokenStatus, TokenVersion, DexThreshType, MigratorType, V3LPFeeProfile, lpFeeProfileToV3Fee, DEXId, } from './portal.js';
-export { CDPV2 } from './curve.js';
-export { buildPermitPiggybackAuto } from './permit.js';
-export { uploadTokenMeta, type TokenMetaInput } from './ipfs.js';
-export { PinataClient, type PinataConfig, pinFileToIPFSWithJWT, pinImageByPath, pinFileToIPFSWithJWTWeb, pinDataURLWithJWTWeb, dataURLToBlob, type PinataPinResp } from './pinata.js';
-export { predictVanityTokenAddressByChain, findSaltEndingByChain } from './vanity.js';
-export { getFlapMetaByAddress, getFlapMetasByAddresses } from './meta.js';
-export { parseFlapError, getFlapErrorMessage, getFlapErrorMessageEn, type FlapErrorCode } from './errors.js';
-export { FLAP_DEFAULT_FEE_RATES, FLAP_IPFS_API_URL, FLAP_VANITY_SUFFIX, FLAP_DEX_THRESHOLDS, FLAP_TOTAL_SUPPLY, ZERO_ADDRESS, CHAIN_TAX_SUPPORT, getVanitySuffix, isChainSupportTax, FLAP_PORTAL_ADDRESSES } from './constants.js';
-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 { 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, type VaultType, type TaxVaultConfig, type VaultInfo, type FieldDescriptor, type VaultDataSchema, type ApproveAction, type VaultMethodSchema, type VaultUISchema, encodeVaultData, buildVaultParams, buildVaultExtensionParams, getVaultFactoryAddress, getVaultPortalAddress, queryVaultDataSchema, queryVaultUISchema, queryVaultDescription, validateVaultFactory, getVaultInfo, isValidContract, } from './vault.js';

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

@@ -1,33 +0,0 @@
-/**
- * Flap Protocol 模块
- *
- * 跨链支持的 Flap 协议功能
- *
- * 注意：由于历史原因，多个文件中有同名但不同的 FlapChain 类型
- * 使用时请从具体文件导入
- */
-// 核心模块 - 显式导出避免冲突
-export { FlapPortal, FlapPortalWriter, validateTaxDistribution, TokenStatus, TokenVersion, DexThreshType, MigratorType, V3LPFeeProfile, lpFeeProfileToV3Fee, DEXId, } from './portal.js';
-export { CDPV2 } from './curve.js';
-export { buildPermitPiggybackAuto } from './permit.js';
-export { uploadTokenMeta } from './ipfs.js';
-export { PinataClient, pinFileToIPFSWithJWT, pinImageByPath, pinFileToIPFSWithJWTWeb, pinDataURLWithJWTWeb, dataURLToBlob } from './pinata.js';
-export { predictVanityTokenAddressByChain, findSaltEndingByChain } from './vanity.js';
-export { getFlapMetaByAddress, getFlapMetasByAddresses } from './meta.js';
-export { parseFlapError, getFlapErrorMessage, getFlapErrorMessageEn } from './errors.js';
-export { FLAP_DEFAULT_FEE_RATES, FLAP_IPFS_API_URL, FLAP_VANITY_SUFFIX, FLAP_DEX_THRESHOLDS, FLAP_TOTAL_SUPPLY, ZERO_ADDRESS, CHAIN_TAX_SUPPORT, getVanitySuffix, isChainSupportTax, FLAP_PORTAL_ADDRESSES } from './constants.js';
-export * from './abi.js';
-// Bundle 功能
-export { createTokenWithBundleBuy, batchBuyWithBundle, batchSellWithBundle, flapPrivateBuy, flapPrivateSell, flapBatchPrivateBuy, flapBatchPrivateSell, } from './portal-bundle.js';
-// portal-bundle-merkle 子模块
-export * from './portal-bundle-merkle/index.js';
-// ✅ Tax Vault 金库模块（基于 VaultPortal + VaultFactory 规范）
-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, 
-// ABI
-VAULT_FACTORY_ABI, VAULT_FACTORY_V2_ABI, VAULT_BASE_ABI, VAULT_BASE_V2_ABI, 
-// 工具函数
-encodeVaultData, buildVaultParams, buildVaultExtensionParams, getVaultFactoryAddress, getVaultPortalAddress, 
-// 链上查询
-queryVaultDataSchema, queryVaultUISchema, queryVaultDescription, validateVaultFactory, getVaultInfo, isValidContract, } from './vault.js';

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

@@ -1,21 +0,0 @@
-export type TokenMetaInput = {
-    website?: string | null;
-    twitter?: string | null;
-    telegram?: string | null;
-    description: string;
-    creator: string;
-};
-/**
- * 上传代币元数据到 IPFS
- * @param file 图片文件（File 对象）
- * @param meta 元数据信息
- * @param apiUrl IPFS GraphQL 端点（可选，默认使用 Flap 官方端点）
- * @returns IPFS CID
- *
- * ⚠️ 注意：
- * - 默认端点 (FLAP_IPFS_API_URL) 是占位符，可能不可用
- * - 建议联系 Flap 团队获取真实的 IPFS GraphQL 端点
- * - 或使用自己的 IPFS 服务（Pinata、Infura、Web3.Storage 等）
- * - 或在 newTokenV2/newTokenV3 中直接传入 imageFile，让 SDK 自动处理
- */
-export declare function uploadTokenMeta(file: File, meta: TokenMetaInput, apiUrl?: string): Promise<string>;

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

@@ -1,38 +0,0 @@
-import { FLAP_IPFS_API_URL } from './constants.js';
-/**
- * 上传代币元数据到 IPFS
- * @param file 图片文件（File 对象）
- * @param meta 元数据信息
- * @param apiUrl IPFS GraphQL 端点（可选，默认使用 Flap 官方端点）
- * @returns IPFS CID
- *
- * ⚠️ 注意：
- * - 默认端点 (FLAP_IPFS_API_URL) 是占位符，可能不可用
- * - 建议联系 Flap 团队获取真实的 IPFS GraphQL 端点
- * - 或使用自己的 IPFS 服务（Pinata、Infura、Web3.Storage 等）
- * - 或在 newTokenV2/newTokenV3 中直接传入 imageFile，让 SDK 自动处理
- */
-export async function uploadTokenMeta(file, meta, apiUrl) {
-    const endpoint = apiUrl || FLAP_IPFS_API_URL;
-    // 如果使用默认端点，给出警告
-    if (!apiUrl && endpoint === FLAP_IPFS_API_URL) {
-        console.warn('⚠️ Warning: Using default IPFS endpoint which may not be available.\n' +
-            'Please either:\n' +
-            '1. Pass a valid IPFS GraphQL endpoint as the 3rd parameter\n' +
-            '2. Contact Flap team for the real IPFS endpoint\n' +
-            '3. Use your own IPFS service (Pinata, Infura, Web3.Storage, etc.)');
-    }
-    const form = new FormData();
-    const MUTATION_CREATE = `mutation Create($file: Upload!, $meta: MetadataInput!) { create(file: $file, meta: $meta) }`;
-    form.append('operations', JSON.stringify({ query: MUTATION_CREATE, variables: { file: null, meta } }));
-    form.append('map', JSON.stringify({ '0': ['variables.file'] }));
-    form.append('0', file);
-    const res = await fetch(endpoint, { method: 'POST', body: form });
-    if (!res.ok) {
-        throw new Error(`IPFS upload failed: ${res.statusText} (${res.status})\n` +
-            `Endpoint: ${endpoint}\n` +
-            `This endpoint may not be valid. Please provide a working IPFS GraphQL endpoint.`);
-    }
-    const j = await res.json();
-    return j?.data?.create;
-}

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

@@ -1,30 +0,0 @@
-import { JsonRpcProvider } from 'ethers';
-export type FlapChain = 'BSC' | 'BASE' | 'XLAYER' | 'MORPH';
-export type FetchMetaOptions = {
-    ipfsGateway?: string;
-    multicall3?: string;
-};
-/**
- * 根据代币地址直接读取合约 metaURI()/meta()（IPFS CID），并拉取元数据 JSON。
- */
-export declare function getFlapMetaByAddress(chain: FlapChain, rpcUrl: string, tokenAddress: string, opts?: FetchMetaOptions): Promise<{
-    cid: string;
-    data?: any;
-} | undefined>;
-export declare function getFlapMetasByAddresses(chain: FlapChain, rpcUrl: string, tokenAddresses: string[], opts?: FetchMetaOptions): Promise<Array<{
-    token: string;
-    cid?: string;
-    data?: any;
-    imageUrl?: string;
-    error?: string;
-}>>;
-/**
- * 使用 Multicall3 批量读取 metaURI()/meta()，metaURI 优先、meta 兜底。
- */
-export declare function getFlapMetaUrisWithMulticall(provider: JsonRpcProvider, chain: FlapChain, tokenAddresses: string[], multicall3?: string, ipfsGateway?: string): Promise<Array<{
-    token: string;
-    cid?: string;
-    data?: any;
-    imageUrl?: string;
-    error?: string;
-}>>;

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

@@ -1,195 +0,0 @@
-import { JsonRpcProvider, Contract, Interface } from 'ethers';
-import { ADDRESSES } from '../../utils/constants.js';
-const DEFAULT_GATEWAYS = {
-    BSC: 'https://ipfs.io/ipfs/',
-    BASE: 'https://ipfs.io/ipfs/',
-    XLAYER: 'https://ipfs.io/ipfs/',
-    MORPH: 'https://ipfs.io/ipfs/'
-};
-function normalizeCid(cidOrUrl) {
-    if (!cidOrUrl)
-        return cidOrUrl;
-    if (cidOrUrl.startsWith('ipfs://'))
-        return cidOrUrl.slice('ipfs://'.length);
-    return cidOrUrl;
-}
-async function fetchIpfsJson(cid, gateway) {
-    const url = `${gateway}${normalizeCid(cid)}`;
-    const resp = await fetch(url);
-    if (!resp.ok)
-        throw new Error(`IPFS fetch failed: ${resp.status} ${await resp.text()}`);
-    return await resp.json();
-}
-async function readCidFromToken(provider, tokenAddress) {
-    const abi = [
-        'function metaURI() view returns (string)',
-        'function meta() view returns (string)'
-    ];
-    const c = new Contract(tokenAddress, abi, provider);
-    try {
-        const v = await c.metaURI();
-        if (typeof v === 'string' && v.length > 0)
-            return v;
-    }
-    catch { }
-    try {
-        const v = await c.meta();
-        if (typeof v === 'string' && v.length > 0)
-            return v;
-    }
-    catch { }
-    return undefined;
-}
-/**
- * 根据代币地址直接读取合约 metaURI()/meta()（IPFS CID），并拉取元数据 JSON。
- */
-export async function getFlapMetaByAddress(chain, rpcUrl, tokenAddress, opts = {}) {
-    const provider = new JsonRpcProvider(rpcUrl);
-    // 优先尝试：直接从代币合约读取 metaURI()/meta()
-    try {
-        const onChainCid = await readCidFromToken(provider, tokenAddress);
-        if (onChainCid) {
-            const gateway = opts.ipfsGateway || DEFAULT_GATEWAYS[chain];
-            try {
-                const data = await fetchIpfsJson(onChainCid, gateway);
-                return { cid: onChainCid, data };
-            }
-            catch {
-                return { cid: onChainCid };
-            }
-        }
-    }
-    catch { }
-    return undefined;
-}
-export async function getFlapMetasByAddresses(chain, rpcUrl, tokenAddresses, opts = {}) {
-    if (!tokenAddresses?.length)
-        return [];
-    const provider = new JsonRpcProvider(rpcUrl);
-    const uris = await getFlapMetaUrisWithMulticall(provider, chain, tokenAddresses, opts.multicall3, opts.ipfsGateway);
-    const gateway = opts.ipfsGateway || DEFAULT_GATEWAYS[chain];
-    const results = await Promise.all(uris.map(async (u) => {
-        if (!u.cid)
-            return { token: u.token, error: u.error };
-        if (u.data || u.imageUrl) {
-            return { token: u.token, cid: u.cid, data: u.data, imageUrl: u.imageUrl };
-        }
-        try {
-            const data = await fetchIpfsJson(u.cid, gateway);
-            return { token: u.token, cid: u.cid, data };
-        }
-        catch {
-            return { token: u.token, cid: u.cid, imageUrl: `${gateway}${normalizeCid(u.cid)}` };
-        }
-    }));
-    return results;
-}
-/**
- * 使用 Multicall3 批量读取 metaURI()/meta()，metaURI 优先、meta 兜底。
- */
-export async function getFlapMetaUrisWithMulticall(provider, chain, tokenAddresses, multicall3, ipfsGateway) {
-    // ✅ 所有链使用相同的 Multicall3 地址
-    const DEFAULT_MULTICALL3 = {
-        BSC: ADDRESSES.BSC.Multicall3,
-        BASE: ADDRESSES.BSC.Multicall3, // 所有链使用相同地址
-        XLAYER: ADDRESSES.BSC.Multicall3,
-        MORPH: ADDRESSES.BSC.Multicall3
-    };
-    const mcAddress = multicall3 || DEFAULT_MULTICALL3[chain];
-    const mcAbi = [
-        'function tryAggregate(bool requireSuccess, tuple(address target, bytes callData)[] calls) public returns (tuple(bool success, bytes returnData)[])'
-    ];
-    const mc = new Contract(mcAddress, mcAbi, provider);
-    const iface = new Interface([
-        'function metaURI() view returns (string)',
-        'function meta() view returns (string)'
-    ]);
-    // 第一轮：metaURI()
-    const callDataMetaURI = iface.encodeFunctionData('metaURI', []);
-    const calls1 = tokenAddresses.map((t) => ({ target: t, callData: callDataMetaURI }));
-    let res1 = [];
-    try {
-        res1 = await mc.tryAggregate(false, calls1);
-    }
-    catch (e) {
-        // 如果 multicall 不可用，降级为逐个查询
-        const fallbacks = await Promise.all(tokenAddresses.map(async (t) => {
-            try {
-                const cid = await readCidFromToken(provider, t);
-                return { token: t, cid };
-            }
-            catch (err) {
-                return { token: t, error: String(err?.message || err) };
-            }
-        }));
-        return fallbacks;
-    }
-    const needMeta = [];
-    const interim = tokenAddresses.map((t, i) => {
-        const r = res1[i];
-        if (r && r.success && r.returnData && r.returnData !== '0x') {
-            try {
-                const [uri] = iface.decodeFunctionResult('metaURI', r.returnData);
-                return { token: t, cid: String(uri) };
-            }
-            catch (e) {
-                needMeta.push(t);
-                return { token: t };
-            }
-        }
-        needMeta.push(t);
-        return { token: t };
-    });
-    if (needMeta.length === 0) {
-        // 尝试拉取 JSON，否则返回 imageUrl
-        const gateway = ipfsGateway || DEFAULT_GATEWAYS[chain];
-        const enriched = await Promise.all(interim.map(async (x) => {
-            if (!x.cid)
-                return x;
-            try {
-                const data = await fetchIpfsJson(x.cid, gateway);
-                return { ...x, data };
-            }
-            catch {
-                return { ...x, imageUrl: `${gateway}${normalizeCid(x.cid)}` };
-            }
-        }));
-        return enriched;
-    }
-    // 第二轮：meta() 兜底
-    const callDataMeta = iface.encodeFunctionData('meta', []);
-    const calls2 = needMeta.map((t) => ({ target: t, callData: callDataMeta }));
-    const res2 = await mc.tryAggregate(false, calls2);
-    let idx = 0;
-    for (let i = 0; i < interim.length; i++) {
-        if (interim[i].cid)
-            continue;
-        const r = res2[idx++];
-        if (r && r.success && r.returnData && r.returnData !== '0x') {
-            try {
-                const [uri] = iface.decodeFunctionResult('meta', r.returnData);
-                interim[i].cid = String(uri);
-            }
-            catch (e) {
-                interim[i].error = String(e?.message || e);
-            }
-        }
-        else {
-            interim[i].error = 'meta() call failed';
-        }
-    }
-    // 为所有项填充 data 或 imageUrl
-    const gateway = ipfsGateway || DEFAULT_GATEWAYS[chain];
-    const enriched = await Promise.all(interim.map(async (x) => {
-        if (!x.cid)
-            return x;
-        try {
-            const data = await fetchIpfsJson(x.cid, gateway);
-            return { ...x, data };
-        }
-        catch {
-            return { ...x, imageUrl: `${gateway}${normalizeCid(x.cid)}` };
-        }
-    }));
-    return enriched;
-}

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

@@ -1,16 +0,0 @@
-/**
- * 构建 Permit Piggyback 数据
- * 自动签名并使用正确的 Portal 代理地址
- *
- * @param chain 链名称
- * @param privateKey 用户私钥
- * @param tokenAddress ERC20 代币地址（需要支持 EIP-2612 Permit）
- * @param value 授权金额
- * @param deadline 截止时间戳
- * @param nonce Permit nonce（通常从代币合约的 nonces(owner) 获取）
- * @returns Permit Piggyback 编码数据（Hex string）
- */
-export declare function buildPermitPiggybackAuto(chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH', privateKey: string, tokenAddress: string, value: bigint, deadline: bigint, nonce: bigint, opts?: {
-    rpcUrl?: string;
-    tokenNameOverride?: string;
-}): Promise<string>;

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

@@ -1,67 +0,0 @@
-import { Wallet, AbiCoder, Contract, JsonRpcProvider } from 'ethers';
-import { FLAP_PORTAL_ADDRESSES } from './constants.js';
-import { CHAIN } from '../../utils/constants.js';
-/**
- * 构建 Permit Piggyback 数据
- * 自动签名并使用正确的 Portal 代理地址
- *
- * @param chain 链名称
- * @param privateKey 用户私钥
- * @param tokenAddress ERC20 代币地址（需要支持 EIP-2612 Permit）
- * @param value 授权金额
- * @param deadline 截止时间戳
- * @param nonce Permit nonce（通常从代币合约的 nonces(owner) 获取）
- * @returns Permit Piggyback 编码数据（Hex string）
- */
-export async function buildPermitPiggybackAuto(chain, privateKey, tokenAddress, value, deadline, nonce, opts) {
-    const spender = FLAP_PORTAL_ADDRESSES[chain];
-    if (!spender) {
-        throw new Error(`Flap Portal not deployed on ${chain}`);
-    }
-    // 创建钱包
-    const wallet = new Wallet(privateKey);
-    const owner = wallet.address;
-    // 获取 chainId
-    const chainId = CHAIN[chain].chainId;
-    // 读取代币 name（优先 override，其次链上查询，不可用时回退为空字符串）
-    let tokenName = opts?.tokenNameOverride ?? '';
-    if (!tokenName && opts?.rpcUrl) {
-        try {
-            const erc20 = new Contract(tokenAddress, ['function name() view returns (string)'], new JsonRpcProvider(opts.rpcUrl));
-            tokenName = await erc20.name();
-        }
-        catch { }
-    }
-    // 构建 EIP-2612 Permit 消息（name 可能为空字符串，符合部分实现）
-    const domain = {
-        name: tokenName,
-        version: '1',
-        chainId,
-        verifyingContract: tokenAddress,
-    };
-    const types = {
-        Permit: [
-            { name: 'owner', type: 'address' },
-            { name: 'spender', type: 'address' },
-            { name: 'value', type: 'uint256' },
-            { name: 'nonce', type: 'uint256' },
-            { name: 'deadline', type: 'uint256' },
-        ],
-    };
-    const message = {
-        owner,
-        spender,
-        value: value.toString(),
-        nonce: nonce.toString(),
-        deadline: deadline.toString(),
-    };
-    // 签名
-    const signature = await wallet.signTypedData(domain, types, message);
-    // 解析签名为 v, r, s
-    const r = `0x${signature.slice(2, 66)}`;
-    const s = `0x${signature.slice(66, 130)}`;
-    const v = parseInt(signature.slice(130, 132), 16);
-    // 使用 ethers AbiCoder 编码 Permit Piggyback 数据
-    const abiCoder = AbiCoder.defaultAbiCoder();
-    return abiCoder.encode(['address', 'address', 'uint256', 'uint256', 'uint8', 'bytes32', 'bytes32'], [owner, spender, value, deadline, v, r, s]);
-}