@oobe-protocol-labs/synapse-client-sdk 1.0.0-beta

package/dist/esm/nft/advanced-features.d.ts

@@ -0,0 +1,205 @@
+/**
+ * @file nft/advanced-features.ts
+ * @module SolanaNFT
+ * @author Keepeeto
+ * @license MIT
+ * @description Advanced NFT features: collection analytics, marketplace aggregation,
+ *              AI-powered rarity calculation, and investment recommendations.
+ */
+import { EventEmitter } from 'eventemitter3';
+import type { SynapseClient } from '../client';
+export interface CollectionStats {
+    collectionAddress: string;
+    name?: string;
+    totalSupply: number;
+    holders: number;
+    floorPrice: number;
+    volume24h: number;
+    volume7d: number;
+    volume30d: number;
+    avgPrice24h: number;
+    sales24h: number;
+    listed: number;
+    listedPercent: number;
+    uniqueHolders: number;
+    holderDistribution: {
+        whales: number;
+        medium: number;
+        retail: number;
+    };
+    priceHistory: Array<{
+        timestamp: number;
+        floorPrice: number;
+        volume: number;
+    }>;
+    topSales: Array<{
+        mint: string;
+        price: number;
+        timestamp: number;
+        buyer?: string;
+        seller?: string;
+    }>;
+}
+export interface CollectionTrends {
+    trending: 'up' | 'down' | 'stable';
+    volumeChange24h: number;
+    priceChange24h: number;
+    momentum: number;
+    sentiment: 'bullish' | 'bearish' | 'neutral';
+    signals: string[];
+}
+/**
+ * Collection Analytics Engine
+ * Provides deep analytics for NFT collections
+ */
+export declare class CollectionAnalytics extends EventEmitter {
+    private client;
+    private cache;
+    private cacheTTL;
+    constructor(client: SynapseClient);
+    /**
+     * Get comprehensive collection statistics
+     */
+    getStats(collectionAddress: string, options?: {
+        useCache?: boolean;
+    }): Promise<CollectionStats>;
+    /**
+     * Analyze collection trends
+     */
+    analyzeTrends(collectionAddress: string): Promise<CollectionTrends>;
+    /**
+     * Compare multiple collections
+     */
+    compareCollections(collectionAddresses: string[]): Promise<{
+        collections: Array<CollectionStats & {
+            trends: CollectionTrends;
+        }>;
+        rankings: {
+            byVolume: string[];
+            byFloorPrice: string[];
+            byMomentum: string[];
+        };
+    }>;
+    private fetchCollectionStats;
+    private calculatePercentChange;
+    private calculateMomentum;
+    private determineSentiment;
+    private generateSignals;
+}
+export interface MarketplaceListing {
+    marketplace: 'magic-eden' | 'tensor' | 'solanart' | 'opensea' | 'hyperspace' | 'unknown';
+    mint: string;
+    price: number;
+    seller: string;
+    listingUrl: string;
+    timestamp: number;
+    royalties?: number;
+    attributes?: Record<string, string>;
+}
+export interface MarketplaceFloorPrices {
+    mint: string;
+    prices: Array<{
+        marketplace: string;
+        price: number;
+        url: string;
+    }>;
+    lowestPrice: number;
+    bestMarketplace: string;
+    priceDifference: number;
+    savings: number;
+}
+/**
+ * Marketplace Aggregator
+ * Aggregates listings from multiple NFT marketplaces
+ */
+export declare class MarketplaceAggregator extends EventEmitter {
+    private client;
+    constructor(client: SynapseClient);
+    /**
+     * Find all listings for an NFT across marketplaces
+     */
+    findListings(mint: string, options?: {
+        marketplaces?: string[];
+        maxPrice?: number;
+    }): Promise<MarketplaceListing[]>;
+    /**
+     * Compare floor prices across marketplaces
+     */
+    compareFloorPrices(mint: string): Promise<MarketplaceFloorPrices>;
+    private fetchFromMarketplace;
+}
+export interface RarityScore {
+    mint: string;
+    overallRarity: number;
+    rank?: number;
+    traits: Array<{
+        trait: string;
+        value: string;
+        rarity: number;
+        occurrence: number;
+    }>;
+    statisticalRarity: number;
+    aiEnhancedRarity: number;
+    valueEstimate: number;
+}
+export interface RarityAlgorithmConfig {
+    algorithm: 'statistical' | 'trait-normalized' | 'ai-enhanced' | 'hybrid';
+    weights?: {
+        traitRarity?: number;
+        traitCount?: number;
+        aesthetic?: number;
+    };
+}
+/**
+ * AI Rarity Calculator
+ * Advanced rarity calculation with multiple algorithms
+ */
+export declare class AIRarityCalculator extends EventEmitter {
+    private client;
+    private config;
+    constructor(client: SynapseClient, config?: RarityAlgorithmConfig);
+    /**
+     * Calculate rarity score for an NFT
+     */
+    calculateRarity(mint: string, collectionAddress?: string): Promise<RarityScore>;
+    /**
+     * Batch calculate rarity for multiple NFTs
+     */
+    batchCalculateRarity(mints: string[], collectionAddress?: string): Promise<RarityScore[]>;
+    private fetchMetadata;
+    private fetchCollectionTraits;
+    private calculateWithAlgorithm;
+}
+export interface InvestmentRecommendation {
+    mint: string;
+    collectionAddress: string;
+    recommendation: 'strong-buy' | 'buy' | 'hold' | 'sell' | 'strong-sell';
+    confidence: number;
+    targetPrice: number;
+    reasoning: string[];
+    metrics: {
+        rarityScore: number;
+        volumeTrend: number;
+        priceMomentum: number;
+        holderQuality: number;
+    };
+    risks: string[];
+    timeHorizon: 'short' | 'medium' | 'long';
+}
+/**
+ * AI Investment Advisor
+ * Provides data-driven investment recommendations for NFTs
+ */
+export declare class AIInvestmentAdvisor extends EventEmitter {
+    private client;
+    private rarityCalc;
+    private collectionAnalytics;
+    constructor(client: SynapseClient);
+    /**
+     * Get investment recommendation for an NFT
+     */
+    getRecommendation(mint: string, collectionAddress: string, currentPrice: number): Promise<InvestmentRecommendation>;
+    private calculateHolderQuality;
+    private determineRecommendation;
+}
+//# sourceMappingURL=advanced-features.d.ts.map

package/dist/esm/nft/advanced-features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-features.d.ts","sourceRoot":"","sources":["../../../src/nft/advanced-features.ts"],"names":[],"mappings":"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"}