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

package/dist/esm/nft/clients/metaplex-onchain-client.js

@@ -0,0 +1,404 @@
+/**
+ * Metaplex On-Chain Client
+ * Direct on-chain NFT collection analysis using Solana RPC and DAS API
+ * Alternative to marketplace APIs for decentralized, trustless data
+ * @see https://developers.metaplex.com/
+ */
+import { PublicKey } from '@solana/web3.js';
+import { createBaseUmi } from '@metaplex-foundation/umi';
+import { publicKey as umiPublicKey } from '@metaplex-foundation/umi';
+import { fetchDigitalAsset, mplTokenMetadata, } from '@metaplex-foundation/mpl-token-metadata';
+/**
+ * MetaplexOnChainClient - Direct on-chain NFT analysis
+ *
+ * Provides trustless, decentralized collection statistics without
+ * relying on centralized marketplace APIs. Uses Metaplex standards,
+ * Solana RPC queries, and optional DAS API for faster bulk operations.
+ *
+ * **Use Cases:**
+ * - Collections not listed on major marketplaces
+ * - Trustless verification of collection data
+ * - Real-time holder distribution analysis
+ * - Independent supply and holder calculations
+ *
+ * **Trade-offs:**
+ * - Slower than marketplace APIs (requires multiple RPC calls)
+ * - No historical price data (no marketplace context)
+ * - No marketplace-specific metrics (listings, sales, volume)
+ * - Higher RPC costs for large collections (1000+ NFTs)
+ *
+ * **Recommended:** Use with Helius DAS API for production deployments
+ */
+export class MetaplexOnChainClient {
+    connection;
+    rpcEndpoint;
+    timeout;
+    logLevel;
+    dasEndpoint;
+    umi;
+    constructor(config) {
+        this.connection = config.connection;
+        this.rpcEndpoint = config.rpcEndpoint || this.connection.rpcEndpoint;
+        this.timeout = config.timeout || 30000;
+        this.logLevel = config.logLevel || 'error';
+        this.dasEndpoint = config.dasEndpoint;
+        // Initialize Umi with Metaplex Token Metadata plugin
+        this.umi = createBaseUmi();
+        this.umi.use(mplTokenMetadata());
+    }
+    /**
+     * Get collection metadata from on-chain data using Metaplex standards
+     * @param collectionMint - Collection mint address
+     * @returns Collection metadata parsed from Metaplex Token Metadata
+     */
+    async getCollectionMetadata(collectionMint) {
+        this.logDebug(`Fetching on-chain metadata for collection: ${collectionMint}`);
+        try {
+            const mint = umiPublicKey(collectionMint);
+            // Fetch digital asset using Metaplex library
+            const digitalAsset = await fetchDigitalAsset(this.umi, mint);
+            // Extract metadata
+            const metadata = digitalAsset.metadata;
+            // Helper to unwrap Option types from Metaplex
+            const unwrapOption = (option) => {
+                if (!option || option.__option === 'None')
+                    return undefined;
+                return option.__option === 'Some' ? option.value : option;
+            };
+            const creators = unwrapOption(metadata.creators) || [];
+            const collection = unwrapOption(metadata.collection);
+            const result = {
+                collectionMint,
+                name: metadata.name,
+                symbol: metadata.symbol,
+                uri: metadata.uri,
+                updateAuthority: metadata.updateAuthority.toString(),
+                creators: creators.map((creator) => ({
+                    address: creator.address.toString(),
+                    verified: creator.verified,
+                    share: creator.share,
+                })),
+                sellerFeeBasisPoints: metadata.sellerFeeBasisPoints,
+                isMutable: metadata.isMutable,
+                collection: collection ? {
+                    verified: collection.verified,
+                    key: collection.key.toString(),
+                } : undefined,
+            };
+            this.logInfo(`Metadata fetched: ${result.name} (${result.symbol})`);
+            return result;
+        }
+        catch (error) {
+            this.logError(`Failed to fetch collection metadata: ${error.message}`);
+            throw new Error(`On-chain metadata fetch failed: ${error.message}`);
+        }
+    }
+    /**
+     * Get all NFTs in a collection by creator
+     * Uses DAS API if available (recommended), falls back to RPC
+     * @param creatorAddress - Creator/collection address
+     * @param options - Query options
+     * @returns Array of NFTs with owner and metadata
+     */
+    async getCollectionNFTs(creatorAddress, options) {
+        this.logDebug(`Fetching NFTs for creator: ${creatorAddress}`);
+        try {
+            // Use DAS API if available (much faster for large collections)
+            if (this.dasEndpoint) {
+                return await this.getCollectionNFTsViaDAS(creatorAddress, options);
+            }
+            // Fallback to RPC queries (slower, more expensive)
+            this.logInfo('WARNING: Fetching via RPC - slow for large collections. Consider using DAS API (Helius)');
+            // For production: Implement getProgramAccounts with filters
+            // This requires significant RPC calls and is expensive
+            throw new Error('RPC-only collection fetching not implemented. Please provide dasEndpoint for production use.');
+        }
+        catch (error) {
+            this.logError(`Failed to fetch collection NFTs: ${error.message}`);
+            throw new Error(`On-chain NFT fetch failed: ${error.message}`);
+        }
+    }
+    /**
+     * Get NFTs via DAS (Digital Asset Standard) API - RECOMMENDED
+     * Supports Helius, Triton, and other DAS-compatible providers
+     * @private
+     */
+    async getCollectionNFTsViaDAS(creatorAddress, options) {
+        if (!this.dasEndpoint) {
+            throw new Error('DAS endpoint not configured');
+        }
+        this.logDebug(`Fetching NFTs via DAS API: ${creatorAddress}`);
+        try {
+            const response = await fetch(this.dasEndpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    jsonrpc: '2.0',
+                    id: 'get-assets-by-creator',
+                    method: 'getAssetsByCreator',
+                    params: {
+                        creatorAddress,
+                        onlyVerified: true,
+                        page: options?.offset ? Math.floor(options.offset / 1000) + 1 : 1,
+                        limit: options?.limit || 1000,
+                    },
+                }),
+            });
+            const data = await response.json();
+            if (data.error) {
+                throw new Error(`DAS API error: ${data.error.message}`);
+            }
+            const assets = data.result?.items || [];
+            const nfts = assets.map((asset) => ({
+                mint: asset.id,
+                owner: asset.ownership?.owner || 'unknown',
+                metadata: {
+                    name: asset.content?.metadata?.name || 'Unknown',
+                    symbol: asset.content?.metadata?.symbol || '',
+                    uri: asset.content?.json_uri || '',
+                    sellerFeeBasisPoints: asset.royalty?.basis_points || 0,
+                },
+                collection: asset.grouping?.find((g) => g.group_key === 'collection')?.group_value,
+                verified: asset.grouping?.find((g) => g.group_key === 'collection')?.verified || false,
+            }));
+            this.logInfo(`Fetched ${nfts.length} NFTs via DAS API (total in response)`);
+            return nfts;
+        }
+        catch (error) {
+            this.logError(`DAS API fetch failed: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * Calculate on-chain collection statistics
+     * Analyzes holder distribution, supply, and concentration risk
+     * @param creatorAddress - Creator/collection address
+     * @returns Comprehensive on-chain statistics
+     */
+    async calculateOnChainStats(creatorAddress) {
+        this.logDebug(`Calculating on-chain stats for: ${creatorAddress}`);
+        try {
+            // Fetch all NFTs in collection
+            const nfts = await this.getCollectionNFTs(creatorAddress);
+            // Calculate holder distribution
+            const holderMap = new Map();
+            let verifiedCount = 0;
+            for (const nft of nfts) {
+                if (nft.owner && nft.owner !== 'unknown') {
+                    holderMap.set(nft.owner, (holderMap.get(nft.owner) || 0) + 1);
+                }
+                if (nft.verified) {
+                    verifiedCount++;
+                }
+            }
+            const totalSupply = nfts.length;
+            const uniqueHolders = holderMap.size;
+            // Calculate holder distribution (whales/medium/retail)
+            const holderCounts = Array.from(holderMap.entries());
+            const distribution = {
+                whales: 0,
+                medium: 0,
+                retail: 0,
+            };
+            for (const [, count] of holderCounts) {
+                const percentage = (count / totalSupply) * 100;
+                if (percentage > 10) {
+                    distribution.whales++;
+                }
+                else if (percentage >= 1) {
+                    distribution.medium++;
+                }
+                else {
+                    distribution.retail++;
+                }
+            }
+            // Get top 10 holders
+            const topHolders = holderCounts
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, 10)
+                .map(([address, count]) => ({
+                address,
+                count,
+                percentage: (count / totalSupply) * 100,
+            }));
+            const stats = {
+                collectionMint: creatorAddress,
+                totalSupply,
+                verifiedNFTs: verifiedCount,
+                holders: holderMap.size,
+                uniqueHolders,
+                holderDistribution: distribution,
+                topHolders,
+                nftsByCreator: totalSupply,
+                dataSource: 'on-chain',
+                timestamp: Date.now(),
+            };
+            this.logInfo(`Stats calculated: ${totalSupply} NFTs, ${uniqueHolders} unique holders`);
+            return stats;
+        }
+        catch (error) {
+            this.logError(`Failed to calculate on-chain stats: ${error.message}`);
+            throw new Error(`On-chain stats calculation failed: ${error.message}`);
+        }
+    }
+    /**
+     * Get holder distribution analysis with concentration risk
+     * Uses Herfindahl-Hirschman Index (HHI) for concentration measurement
+     * @param creatorAddress - Creator/collection address
+     * @returns Holder distribution data with risk score
+     */
+    async getHolderDistribution(creatorAddress) {
+        this.logDebug(`Analyzing holder distribution for: ${creatorAddress}`);
+        try {
+            const stats = await this.calculateOnChainStats(creatorAddress);
+            const distribution = new Map();
+            stats.topHolders.forEach(holder => {
+                distribution.set(holder.address, holder.count);
+            });
+            // Calculate concentration risk using Herfindahl-Hirschman Index
+            // HHI = sum of squared market shares
+            let hhi = 0;
+            stats.topHolders.forEach(holder => {
+                const share = holder.percentage / 100;
+                hhi += share * share;
+            });
+            const concentrationRisk = Math.min(100, hhi * 100);
+            this.logInfo(`Distribution analyzed: ${stats.uniqueHolders} holders, concentration risk: ${concentrationRisk.toFixed(2)}`);
+            return {
+                totalHolders: stats.uniqueHolders,
+                distribution,
+                concentrationRisk,
+            };
+        }
+        catch (error) {
+            this.logError(`Failed to analyze holder distribution: ${error.message}`);
+            throw new Error(`Holder distribution analysis failed: ${error.message}`);
+        }
+    }
+    /**
+     * Get all NFTs owned by a specific wallet
+     * @param ownerAddress - Wallet address
+     * @returns Array of owned NFTs
+     */
+    async getNFTsByOwner(ownerAddress) {
+        this.logDebug(`Fetching NFTs for owner: ${ownerAddress}`);
+        try {
+            // Use DAS API if available (fastest method)
+            if (this.dasEndpoint) {
+                const response = await fetch(this.dasEndpoint, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({
+                        jsonrpc: '2.0',
+                        id: 'get-assets-by-owner',
+                        method: 'getAssetsByOwner',
+                        params: {
+                            ownerAddress,
+                            page: 1,
+                            limit: 1000,
+                        },
+                    }),
+                });
+                const data = await response.json();
+                if (data.error) {
+                    throw new Error(`DAS API error: ${data.error.message}`);
+                }
+                const assets = data.result?.items || [];
+                const nfts = assets.map((asset) => ({
+                    mint: asset.id,
+                    owner: ownerAddress,
+                    metadata: {
+                        name: asset.content?.metadata?.name || 'Unknown',
+                        symbol: asset.content?.metadata?.symbol || '',
+                        uri: asset.content?.json_uri || '',
+                        sellerFeeBasisPoints: asset.royalty?.basis_points || 0,
+                    },
+                    collection: asset.grouping?.find((g) => g.group_key === 'collection')?.group_value,
+                    verified: asset.grouping?.find((g) => g.group_key === 'collection')?.verified || false,
+                }));
+                this.logInfo(`Fetched ${nfts.length} NFTs for owner via DAS`);
+                return nfts;
+            }
+            // Fallback to Token Program queries (slower)
+            this.logInfo('Fetching NFTs via Token Program (no DAS API)');
+            const owner = new PublicKey(ownerAddress);
+            const tokenAccounts = await this.connection.getParsedTokenAccountsByOwner(owner, {
+                programId: new PublicKey('TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA'),
+            });
+            // Filter for NFTs (amount = 1, decimals = 0)
+            const nftAccounts = tokenAccounts.value.filter(account => {
+                const parsed = account.account.data.parsed;
+                return parsed.info.tokenAmount.decimals === 0 &&
+                    parsed.info.tokenAmount.amount === '1';
+            });
+            const nfts = nftAccounts.map(account => ({
+                mint: account.account.data.parsed.info.mint,
+                owner: ownerAddress,
+                metadata: {
+                    name: 'Unknown', // Would require additional metadata fetch
+                    symbol: '',
+                    uri: '',
+                    sellerFeeBasisPoints: 0,
+                },
+                verified: false,
+            }));
+            this.logInfo(`Fetched ${nfts.length} NFTs for owner via Token Program`);
+            return nfts;
+        }
+        catch (error) {
+            this.logError(`Failed to fetch NFTs by owner: ${error.message}`);
+            throw new Error(`Owner NFT fetch failed: ${error.message}`);
+        }
+    }
+    /**
+     * Health check - verify RPC and DAS API connectivity
+     * @returns True if services are accessible
+     */
+    async healthCheck() {
+        try {
+            // Check RPC connectivity
+            await this.connection.getLatestBlockhash();
+            // Check DAS API if configured
+            if (this.dasEndpoint) {
+                const response = await fetch(this.dasEndpoint, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({
+                        jsonrpc: '2.0',
+                        id: 'health-check',
+                        method: 'getHealth',
+                        params: [],
+                    }),
+                });
+                if (!response.ok) {
+                    this.logError(`DAS API health check failed: ${response.status}`);
+                    return false;
+                }
+            }
+            return true;
+        }
+        catch (error) {
+            this.logError(`Health check failed: ${error.message}`);
+            return false;
+        }
+    }
+    // =========================================================================
+    // Private Methods - Logging
+    // =========================================================================
+    logDebug(message) {
+        if (this.logLevel === 'debug') {
+            console.log(`[MetaplexOnChainClient:DEBUG] ${message}`);
+        }
+    }
+    logInfo(message) {
+        if (this.logLevel === 'debug' || this.logLevel === 'info') {
+            console.log(`[MetaplexOnChainClient:INFO] ${message}`);
+        }
+    }
+    logError(message) {
+        if (this.logLevel !== 'none') {
+            console.error(`[MetaplexOnChainClient:ERROR] ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=metaplex-onchain-client.js.map

package/dist/esm/nft/clients/metaplex-onchain-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metaplex-onchain-client.js","sourceRoot":"","sources":["../../../../src/nft/clients/metaplex-onchain-client.ts"],"names":[],"mappings":"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"}

package/dist/esm/nft/clients/tensor-client.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Tensor API Client
+ * Production-ready integration with Tensor marketplace API
+ * @see https://docs.tensor.trade/tensorswap-api
+ */
+import { TensorCollectionStats, TensorListing, TensorSale } from '../types.nft';
+export interface TensorClientConfig {
+    baseUrl?: string;
+    apiKey?: string;
+    rateLimit?: number;
+    timeout?: number;
+    fetch?: typeof fetch;
+    logLevel?: 'debug' | 'info' | 'error' | 'none';
+}
+/**
+ * TensorClient - Tensor API integration
+ * Handles rate limiting, error handling, and response validation
+ */
+export declare class TensorClient {
+    private readonly baseUrl;
+    private readonly apiKey?;
+    private readonly timeout;
+    private readonly fetchImpl;
+    private readonly logLevel;
+    private readonly rateLimiter;
+    constructor(config?: TensorClientConfig);
+    /**
+     * Get collection statistics from Tensor
+     * @param slug - Collection slug (e.g. "mad_lads")
+     * @returns Collection statistics including floor price, volume, sales
+     */
+    getCollectionStats(slug: string): Promise<TensorCollectionStats>;
+    /**
+     * Get current floor price for a collection
+     * @param slug - Collection slug
+     * @returns Floor price in lamports
+     */
+    getFloorPrice(slug: string): Promise<number>;
+    /**
+     * Get active listings for a collection
+     * @param slug - Collection slug
+     * @param options - Pagination and filter options
+     * @returns Array of active listings
+     */
+    getListings(slug: string, options?: {
+        limit?: number;
+        page?: number;
+        sortBy?: 'price' | 'listedAt';
+        sortDirection?: 'asc' | 'desc';
+    }): Promise<TensorListing[]>;
+    /**
+     * Get recent sales for a collection
+     * @param slug - Collection slug
+     * @param options - Pagination options
+     * @returns Array of recent sales
+     */
+    getSales(slug: string, options?: {
+        limit?: number;
+        page?: number;
+    }): Promise<TensorSale[]>;
+    /**
+     * Get listing for a specific NFT mint
+     * @param mint - NFT mint address
+     * @returns Listing information or null if not listed
+     */
+    getMintListing(mint: string): Promise<TensorListing | null>;
+    /**
+     * Health check - verify Tensor API is accessible
+     * @returns True if API is healthy
+     */
+    healthCheck(): Promise<boolean>;
+    private makeRequest;
+    private enforceRateLimit;
+    private isNotFoundError;
+    private logDebug;
+    private logInfo;
+    private logError;
+}
+//# sourceMappingURL=tensor-client.d.ts.map

package/dist/esm/nft/clients/tensor-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tensor-client.d.ts","sourceRoot":"","sources":["../../../../src/nft/clients/tensor-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,UAAU,EAGX,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;CAChD;AAOD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAC/D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;gBAE9B,MAAM,CAAC,EAAE,kBAAkB;IA0BvC;;;;OAIG;IACG,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAUtE;;;;OAIG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKlD;;;;;OAKG;IACG,WAAW,CACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;QAC9B,aAAa,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;KAChC,GACA,OAAO,CAAC,aAAa,EAAE,CAAC;IAgB3B;;;;;OAKG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GACA,OAAO,CAAC,UAAU,EAAE,CAAC;IAcxB;;;;OAIG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAiBjE;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;YAevB,WAAW;YA6DX,gBAAgB;IAa9B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,QAAQ;CAKjB"}