@varity-labs/sdk 2.0.0-alpha.1

package/dist/thirdweb/GatewayClient.js

@@ -0,0 +1,257 @@
+/**
+ * thirdweb Gateway Client
+ *
+ * Production-grade RPC infrastructure powered by thirdweb
+ * Provides reliable, fast, and scalable blockchain node access
+ *
+ * Features:
+ * - High-performance RPC endpoints
+ * - Automatic failover and load balancing
+ * - Request rate limiting and throttling
+ * - Chain-specific optimizations
+ * - Analytics and monitoring
+ * - WebSocket support for real-time data
+ */
+import { ChainRegistry } from '../chains';
+/**
+ * thirdweb Gateway Client
+ *
+ * Production RPC infrastructure for blockchain applications
+ */
+export class GatewayClient {
+    constructor(config = {}) {
+        this.requestId = 0;
+        this.apiKey = config.apiKey;
+        this.gatewayUrl = config.gatewayUrl || 'https://gateway.thirdweb.com';
+        this.timeout = config.timeout || 30000;
+        this.enableRetries = config.enableRetries !== false;
+        this.maxRetries = config.maxRetries || 3;
+        this.stats = {
+            totalRequests: 0,
+            successfulRequests: 0,
+            failedRequests: 0,
+            averageResponseTime: 0,
+            requestsPerMinute: 0,
+            errorRate: 0,
+        };
+    }
+    /**
+     * Get RPC URL for a specific chain
+     */
+    getRpcUrl(chain) {
+        let chainObj;
+        if (typeof chain === 'number') {
+            chainObj = ChainRegistry.getChain(chain);
+        }
+        else {
+            chainObj = chain;
+        }
+        // Use thirdweb gateway if available, otherwise use chain's default RPC
+        if (this.apiKey) {
+            return `${this.gatewayUrl}/v1/${chainObj.id}/${this.apiKey}`;
+        }
+        // Fallback to chain's default RPC
+        return chainObj.rpc || '';
+    }
+    /**
+     * Get WebSocket URL for a specific chain
+     */
+    getWebSocketUrl(chain) {
+        const rpcUrl = this.getRpcUrl(chain);
+        // Convert HTTP(S) to WS(S)
+        return rpcUrl.replace('https://', 'wss://').replace('http://', 'ws://');
+    }
+    /**
+     * Make an RPC request
+     */
+    async request(chain, options) {
+        const startTime = Date.now();
+        this.stats.totalRequests++;
+        try {
+            const url = this.getRpcUrl(chain);
+            const id = ++this.requestId;
+            const response = await this.makeRequest(url, {
+                jsonrpc: '2.0',
+                id,
+                method: options.method,
+                params: options.params || [],
+            }, options.timeout || this.timeout);
+            const responseTime = Date.now() - startTime;
+            this.updateStats(true, responseTime);
+            return response;
+        }
+        catch (error) {
+            this.updateStats(false, Date.now() - startTime);
+            throw error;
+        }
+    }
+    /**
+     * Batch multiple RPC requests
+     */
+    async batchRequest(chain, requests) {
+        const url = this.getRpcUrl(chain);
+        const batchPayload = requests.map((req, index) => ({
+            jsonrpc: '2.0',
+            id: ++this.requestId,
+            method: req.method,
+            params: req.params || [],
+        }));
+        const responses = await this.makeRequest(url, batchPayload, this.timeout);
+        return Array.isArray(responses) ? responses : [responses];
+    }
+    /**
+     * Create a WebSocket connection
+     */
+    connectWebSocket(options) {
+        const url = this.getWebSocketUrl(options.chain);
+        const ws = new WebSocket(url);
+        ws.onopen = () => {
+            console.log(`WebSocket connected to ${options.chain.name}`);
+            options.onConnect?.();
+        };
+        ws.onmessage = (event) => {
+            try {
+                const data = JSON.parse(event.data);
+                options.onMessage?.(data);
+            }
+            catch (error) {
+                options.onError?.(error);
+            }
+        };
+        ws.onerror = (event) => {
+            options.onError?.(new Error('WebSocket error'));
+        };
+        ws.onclose = () => {
+            console.log(`WebSocket disconnected from ${options.chain.name}`);
+            options.onDisconnect?.();
+            if (options.autoReconnect) {
+                setTimeout(() => this.connectWebSocket(options), 5000);
+            }
+        };
+        return ws;
+    }
+    /**
+     * Subscribe to new blocks
+     */
+    async subscribeToBlocks(chain, callback) {
+        const chainObj = typeof chain === 'number' ? ChainRegistry.getChain(chain) : chain;
+        const ws = this.connectWebSocket({
+            chain: chainObj,
+            onMessage: (data) => {
+                if (data.method === 'eth_subscription' && data.params?.subscription) {
+                    callback(data.params.result);
+                }
+            },
+        });
+        // Subscribe to new blocks
+        ws.send(JSON.stringify({
+            jsonrpc: '2.0',
+            id: ++this.requestId,
+            method: 'eth_subscribe',
+            params: ['newHeads'],
+        }));
+        // Return unsubscribe function
+        return () => ws.close();
+    }
+    /**
+     * Subscribe to contract events
+     */
+    async subscribeToLogs(chain, filter, callback) {
+        const chainObj = typeof chain === 'number' ? ChainRegistry.getChain(chain) : chain;
+        const ws = this.connectWebSocket({
+            chain: chainObj,
+            onMessage: (data) => {
+                if (data.method === 'eth_subscription' && data.params?.subscription) {
+                    callback(data.params.result);
+                }
+            },
+        });
+        // Subscribe to logs
+        ws.send(JSON.stringify({
+            jsonrpc: '2.0',
+            id: ++this.requestId,
+            method: 'eth_subscribe',
+            params: ['logs', filter],
+        }));
+        // Return unsubscribe function
+        return () => ws.close();
+    }
+    /**
+     * Get gateway statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Reset statistics
+     */
+    resetStats() {
+        this.stats = {
+            totalRequests: 0,
+            successfulRequests: 0,
+            failedRequests: 0,
+            averageResponseTime: 0,
+            requestsPerMinute: 0,
+            errorRate: 0,
+        };
+    }
+    /**
+     * Make HTTP request with retry logic
+     */
+    async makeRequest(url, payload, timeout, retries = 0) {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), timeout);
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(payload),
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            const data = await response.json();
+            if (data.error) {
+                throw new Error(`RPC Error: ${data.error.message}`);
+            }
+            return data;
+        }
+        catch (error) {
+            if (this.enableRetries && retries < this.maxRetries) {
+                // Exponential backoff
+                const delay = Math.pow(2, retries) * 1000;
+                await new Promise(resolve => setTimeout(resolve, delay));
+                return this.makeRequest(url, payload, timeout, retries + 1);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Update statistics
+     */
+    updateStats(success, responseTime) {
+        if (success) {
+            this.stats.successfulRequests++;
+        }
+        else {
+            this.stats.failedRequests++;
+        }
+        // Update average response time
+        const totalResponses = this.stats.successfulRequests + this.stats.failedRequests;
+        this.stats.averageResponseTime =
+            (this.stats.averageResponseTime * (totalResponses - 1) + responseTime) / totalResponses;
+        // Calculate error rate
+        this.stats.errorRate =
+            (this.stats.failedRequests / this.stats.totalRequests) * 100;
+    }
+}
+/**
+ * Create Gateway client instance
+ */
+export function createGatewayClient(config) {
+    return new GatewayClient(config);
+}

package/dist/thirdweb/NebulaClient.d.ts

@@ -0,0 +1,292 @@
+/**
+ * thirdweb Nebula AI Client
+ *
+ * Natural language blockchain interactions powered by AI
+ * Enables developers to interact with smart contracts using plain English
+ *
+ * Features:
+ * - Generate smart contracts from natural language descriptions
+ * - Query blockchain data using natural language
+ * - Explain transaction data in human-readable format
+ * - Generate contract interaction code
+ * - Analyze contracts for security issues
+ */
+import type { ThirdwebClient, Chain } from 'thirdweb';
+/**
+ * Nebula AI configuration
+ */
+export interface NebulaConfig {
+    /**
+     * thirdweb client instance
+     */
+    client: ThirdwebClient;
+    /**
+     * API key for Nebula AI (optional - uses client's credentials if not provided)
+     */
+    apiKey?: string;
+}
+/**
+ * Contract generation options
+ */
+export interface GenerateContractOptions {
+    /**
+     * Natural language description of the contract
+     * @example "Create a marketplace contract where users can list NFTs for sale"
+     */
+    prompt: string;
+    /**
+     * Contract type hint (optional)
+     */
+    contractType?: 'token' | 'nft' | 'marketplace' | 'dao' | 'custom';
+    /**
+     * Solidity version (default: 0.8.20)
+     */
+    solidityVersion?: string;
+    /**
+     * Include security features (default: true)
+     */
+    includeSecurity?: boolean;
+}
+/**
+ * Generated contract result
+ */
+export interface GeneratedContract {
+    /**
+     * Generated Solidity source code
+     */
+    sourceCode: string;
+    /**
+     * Contract ABI
+     */
+    abi: any[];
+    /**
+     * Contract bytecode
+     */
+    bytecode: string;
+    /**
+     * Explanation of the contract
+     */
+    explanation: string;
+    /**
+     * Detected security issues (if any)
+     */
+    securityIssues?: string[];
+}
+/**
+ * Blockchain query options
+ */
+export interface QueryChainOptions {
+    /**
+     * Natural language query
+     * @example "What is the total supply of USDC on Arbitrum?"
+     */
+    prompt: string;
+    /**
+     * Chain to query
+     */
+    chain: Chain;
+    /**
+     * Contract address (optional - if querying specific contract)
+     */
+    contractAddress?: string;
+}
+/**
+ * Query result
+ */
+export interface QueryResult {
+    /**
+     * Answer to the query
+     */
+    answer: string;
+    /**
+     * Structured data (if applicable)
+     */
+    data?: any;
+    /**
+     * Sources used to answer the query
+     */
+    sources?: string[];
+    /**
+     * Confidence score (0-1)
+     */
+    confidence: number;
+}
+/**
+ * Transaction explanation options
+ */
+export interface ExplainTransactionOptions {
+    /**
+     * Transaction hash
+     */
+    txHash: string;
+    /**
+     * Chain where transaction occurred
+     */
+    chain: Chain;
+    /**
+     * Detail level
+     */
+    detail?: 'simple' | 'detailed' | 'technical';
+}
+/**
+ * Transaction explanation
+ */
+export interface TransactionExplanation {
+    /**
+     * Human-readable summary
+     */
+    summary: string;
+    /**
+     * Detailed breakdown
+     */
+    details: {
+        from: string;
+        to: string;
+        value: string;
+        function: string;
+        parameters: Record<string, any>;
+    };
+    /**
+     * Risk assessment
+     */
+    risks?: string[];
+    /**
+     * Gas cost explanation
+     */
+    gasCost: {
+        total: string;
+        explanation: string;
+    };
+}
+/**
+ * Code generation options
+ */
+export interface GenerateCodeOptions {
+    /**
+     * Natural language description of what to do
+     * @example "Call the mint function with 1000 tokens"
+     */
+    prompt: string;
+    /**
+     * Contract address
+     */
+    contractAddress: string;
+    /**
+     * Chain
+     */
+    chain: Chain;
+    /**
+     * Programming language
+     */
+    language?: 'typescript' | 'python' | 'go' | 'rust';
+}
+/**
+ * Generated code
+ */
+export interface GeneratedCode {
+    /**
+     * Generated code
+     */
+    code: string;
+    /**
+     * Explanation of the code
+     */
+    explanation: string;
+    /**
+     * Required dependencies
+     */
+    dependencies?: string[];
+}
+/**
+ * Contract analysis options
+ */
+export interface AnalyzeContractOptions {
+    /**
+     * Contract source code or address
+     */
+    contract: string;
+    /**
+     * Chain (if analyzing deployed contract)
+     */
+    chain?: Chain;
+    /**
+     * Analysis focus
+     */
+    focus?: 'security' | 'gas' | 'general';
+}
+/**
+ * Contract analysis result
+ */
+export interface ContractAnalysis {
+    /**
+     * Overall assessment
+     */
+    summary: string;
+    /**
+     * Security issues found
+     */
+    security: {
+        severity: 'critical' | 'high' | 'medium' | 'low';
+        issue: string;
+        location: string;
+        recommendation: string;
+    }[];
+    /**
+     * Gas optimization suggestions
+     */
+    gasOptimizations?: {
+        location: string;
+        currentCost: string;
+        optimizedCost: string;
+        suggestion: string;
+    }[];
+    /**
+     * Best practices violations
+     */
+    bestPractices?: string[];
+}
+/**
+ * thirdweb Nebula AI Client
+ *
+ * Interact with blockchain using natural language powered by AI
+ */
+export declare class NebulaClient {
+    private client;
+    private apiKey?;
+    private baseUrl;
+    constructor(config: NebulaConfig);
+    /**
+     * Generate a smart contract from natural language description
+     */
+    generateContract(options: GenerateContractOptions): Promise<GeneratedContract>;
+    /**
+     * Query blockchain data using natural language
+     */
+    queryChain(options: QueryChainOptions): Promise<QueryResult>;
+    /**
+     * Explain a transaction in human-readable format
+     */
+    explainTransaction(options: ExplainTransactionOptions): Promise<TransactionExplanation>;
+    /**
+     * Generate code to interact with a contract
+     */
+    generateCode(options: GenerateCodeOptions): Promise<GeneratedCode>;
+    /**
+     * Analyze a contract for security issues and optimizations
+     */
+    analyzeContract(options: AnalyzeContractOptions): Promise<ContractAnalysis>;
+    /**
+     * Make HTTP request to Nebula API
+     */
+    private request;
+    /**
+     * Mock response for development
+     * TODO: Remove when Nebula AI is fully released
+     */
+    private getMockResponse;
+}
+/**
+ * Create Nebula AI client instance
+ */
+export declare function createNebulaClient(config: NebulaConfig): NebulaClient;
+//# sourceMappingURL=NebulaClient.d.ts.map

package/dist/thirdweb/NebulaClient.d.ts.map

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