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

package/dist/esm/advanced/types.d.ts

@@ -0,0 +1,228 @@
+/**
+ * 🚀 SYNAPSE ADVANCED SDK - ADVANCED TYPES
+ * Enterprise-grade type definitions
+ */
+/**
+ * @name AdvancedTypes
+ * @module advanced/types
+ * @description Type declarations for advanced client modules such as smart caching, circuit breaker, load balancing, and batch processing.
+ */
+export interface AdvancedClientConfig {
+    endpoint: string;
+    apiKey: string;
+    wsEndpoint?: string;
+    features?: {
+        smartCaching?: boolean;
+        circuitBreaker?: boolean;
+        loadBalancing?: boolean;
+        batchOptimization?: boolean;
+        retryStrategies?: boolean;
+        securityChecks?: boolean;
+        advancedMetrics?: boolean;
+        aiOptimizations?: boolean;
+    };
+    performance?: {
+        maxConcurrency?: number;
+        timeout?: number;
+        retryAttempts?: number;
+        cacheSize?: number;
+        compressionLevel?: number;
+    };
+    security?: {
+        enableSignatureVerification?: boolean;
+        enableRateLimitBackoff?: boolean;
+        enableQuotaMonitoring?: boolean;
+        enableThreatDetection?: boolean;
+    };
+}
+export interface SmartCacheConfig {
+    strategy: 'aggressive' | 'balanced' | 'conservative' | 'custom';
+    ttlMultiplier?: number;
+    maxSize?: number;
+    enablePredictive?: boolean;
+    enableDistributed?: boolean;
+    compressionLevel?: 'none' | 'low' | 'medium' | 'high';
+}
+export interface CacheEntry<T = any> {
+    data: T;
+    timestamp: number;
+    ttl: number;
+    hitCount: number;
+    size: number;
+    compressed: boolean;
+    tags: string[];
+}
+export interface CacheStats {
+    hitRate: number;
+    missRate: number;
+    totalHits: number;
+    totalMisses: number;
+    totalRequests: number;
+    averageLatency: number;
+    memoryUsage: number;
+    compressionRatio: number;
+}
+export interface CircuitBreakerConfig {
+    failureThreshold: number;
+    timeout: number;
+    retryInterval: number;
+    monitorWindow: number;
+    enableFallback: boolean;
+}
+export interface CircuitState {
+    state: 'closed' | 'open' | 'half-open';
+    failures: number;
+    lastFailureTime: number;
+    successCount: number;
+    totalRequests: number;
+}
+export interface LoadBalancerConfig {
+    strategy: 'round-robin' | 'weighted' | 'least-latency' | 'health-based' | 'adaptive';
+    healthCheckInterval: number;
+    enableStickySessions: boolean;
+    enableGeoRouting: boolean;
+}
+export interface UpstreamHealth {
+    endpoint: string;
+    healthy: boolean;
+    latency: number;
+    lastCheck: number;
+    errorRate: number;
+    throughput: number;
+    weight: number;
+}
+export interface BatcherConfig {
+    maxBatchSize: number;
+    maxWaitTime: number;
+    enablePriority: boolean;
+    enableOptimization: boolean;
+}
+export interface BatchJob {
+    id: string;
+    method: string;
+    params: any[];
+    priority: 'low' | 'medium' | 'high' | 'critical';
+    timeout: number;
+    resolve: (result: any) => void;
+    reject: (error: any) => void;
+    timestamp: number;
+}
+export interface BatchResult {
+    batchId: string;
+    results: any[];
+    errors: any[];
+    timing: {
+        queued: number;
+        executed: number;
+        total: number;
+    };
+    optimization: {
+        originalRequests: number;
+        batchedRequests: number;
+        savedRequests: number;
+        efficiency: number;
+    };
+}
+export interface RetryConfig {
+    strategy: 'exponential' | 'linear' | 'fibonacci' | 'custom';
+    maxAttempts: number;
+    baseDelay: number;
+    maxDelay: number;
+    jitter: boolean;
+    enableCircuitBreaker: boolean;
+}
+export interface RetryAttempt {
+    attempt: number;
+    error: Error;
+    delay: number;
+    timestamp: number;
+}
+export interface PerformanceConfig {
+    enableConnectionPooling: boolean;
+    enableCompression: boolean;
+    enableRequestOptimization: boolean;
+    enableResponseOptimization: boolean;
+    memoryThreshold: number;
+    cpuThreshold: number;
+}
+export interface AdvancedPerformanceMetrics {
+    throughput: {
+        rps: number;
+        peakRps: number;
+        averageRps: number;
+    };
+    latency: {
+        p50: number;
+        p95: number;
+        p99: number;
+        average: number;
+    };
+    memory: {
+        used: number;
+        free: number;
+        peak: number;
+    };
+    cpu: {
+        usage: number;
+        peak: number;
+    };
+    network: {
+        bytesIn: number;
+        bytesOut: number;
+        connectionsActive: number;
+    };
+}
+export interface SecurityConfig {
+    enableThreatDetection: boolean;
+    enableRateLimitProtection: boolean;
+    enableSignatureValidation: boolean;
+    enableEncryption: boolean;
+    maxRequestsPerSecond: number;
+    blacklist: string[];
+    whitelist: string[];
+}
+export interface SecurityThreat {
+    type: 'rate-limit' | 'malformed-request' | 'suspicious-pattern' | 'blacklisted-ip';
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    description: string;
+    timestamp: number;
+    source: string;
+}
+export interface MetricsConfig {
+    enableRealTime: boolean;
+    enableHistorical: boolean;
+    retention: number;
+    aggregationInterval: number;
+    enableAlerts: boolean;
+}
+export interface AdvancedMetricsData {
+    performance: AdvancedPerformanceMetrics;
+    security: {
+        threatsDetected: number;
+        requestsBlocked: number;
+        securityScore: number;
+    };
+    reliability: {
+        uptime: number;
+        errorRate: number;
+        successRate: number;
+        mttr: number;
+    };
+    business: {
+        apiCallsToday: number;
+        quotaUsage: number;
+        costOptimization: number;
+        efficiency: number;
+    };
+}
+export interface AdvancedEvents {
+    'performance-warning': (data: AdvancedPerformanceMetrics) => void;
+    'security-threat': (threat: SecurityThreat) => void;
+    'circuit-breaker-open': (upstream: string) => void;
+    'cache-optimization': (stats: CacheStats) => void;
+    'batch-completed': (result: BatchResult) => void;
+    'retry-exhausted': (error: Error, attempts: RetryAttempt[]) => void;
+    'quota-warning': (remaining: number) => void;
+    'upstream-degraded': (upstream: UpstreamHealth) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/advanced/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/advanced/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;GAIG;AAGH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE;QACT,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,2BAA2B,CAAC,EAAE,OAAO,CAAC;QACtC,sBAAsB,CAAC,EAAE,OAAO,CAAC;QACjC,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,qBAAqB,CAAC,EAAE,OAAO,CAAC;KACjC,CAAC;CACH;AAID,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,YAAY,GAAG,UAAU,GAAG,cAAc,GAAG,QAAQ,CAAC;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACvD;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,GAAG;IACjC,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAID,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAID,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,aAAa,GAAG,UAAU,GAAG,eAAe,GAAG,cAAc,GAAG,UAAU,CAAC;IACrF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,GAAG,EAAE,CAAC;IACf,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,YAAY,EAAE;QACZ,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAID,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,iBAAiB;IAChC,uBAAuB,EAAE,OAAO,CAAC;IACjC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,yBAAyB,EAAE,OAAO,CAAC;IACnC,0BAA0B,EAAE,OAAO,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE;QACV,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,GAAG,EAAE;QACH,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAID,MAAM,WAAW,cAAc;IAC7B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,yBAAyB,EAAE,OAAO,CAAC;IACnC,yBAAyB,EAAE,OAAO,CAAC;IACnC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,GAAG,mBAAmB,GAAG,oBAAoB,GAAG,gBAAgB,CAAC;IACnF,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,0BAA0B,CAAC;IACxC,QAAQ,EAAE;QACR,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,WAAW,EAAE;QACX,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,QAAQ,EAAE;QACR,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAID,MAAM,WAAW,cAAc;IAC7B,qBAAqB,EAAE,CAAC,IAAI,EAAE,0BAA0B,KAAK,IAAI,CAAC;IAClE,iBAAiB,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IACpD,sBAAsB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,oBAAoB,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAClD,iBAAiB,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IACjD,iBAAiB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;IACpE,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,mBAAmB,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;CACzD"}

package/dist/esm/advanced/types.js

@@ -0,0 +1,6 @@
+/**
+ * 🚀 SYNAPSE ADVANCED SDK - ADVANCED TYPES
+ * Enterprise-grade type definitions
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/advanced/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/advanced/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/esm/ai/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * AI Module - OOBE Protocol Compatible
+ *
+ * AI modules compatible with OOBE Protocol agents.
+ * Includes PDA management, Merkle operations, and data fetching utilities
+ * with optimized batch processing support.
+ */
+export { PDAManager } from './pda-manager';
+export type { PDAConfig, UserPDAs } from './pda-manager';
+export { ZeroCombineFetcher } from './zero-combine-fetcher';
+export type { ZeroChunk, SignatureInfo, ProofRecord, FetchConfig, ZeroCombineResult, } from './zero-combine-fetcher';
+export { MerkleOperation } from './merkle-operation';
+export type { MerkleLeaf, MerkleProof, MerkleValidationResult, ChunkInfo, InscriptionResult, } from './merkle-operation';
+export type { OOBECompatibleAgent, AgentTradeSuggestion, AgentRiskReport, AgentAdapter, AIAgentConfig, AIContext, AIResponse, TradeExecution, MultiChainSignal, AutoTradingStrategy, BatchOptionRequest, } from './types.ai';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EACV,SAAS,EACT,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EACV,UAAU,EACV,WAAW,EACX,sBAAsB,EACtB,SAAS,EACT,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,SAAS,EACT,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/esm/ai/index.js

@@ -0,0 +1,14 @@
+/**
+ * AI Module - OOBE Protocol Compatible
+ *
+ * AI modules compatible with OOBE Protocol agents.
+ * Includes PDA management, Merkle operations, and data fetching utilities
+ * with optimized batch processing support.
+ */
+// PDA Management
+export { PDAManager } from './pda-manager.js';
+// Zero Combine Fetcher for large datasets
+export { ZeroCombineFetcher } from './zero-combine-fetcher.js';
+// Merkle Operations
+export { MerkleOperation } from './merkle-operation.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iBAAiB;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,0CAA0C;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAS5D,oBAAoB;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/esm/ai/merkle-operation.d.ts

@@ -0,0 +1,245 @@
+/**
+ * Merkle Operation - Synapse SDK Implementation
+ *
+ * Professional Merkle tree operations for proof generation, verification and
+ * on-chain inscription. Inspired by OOBE Protocol but optimized for Synapse SDK
+ * with efficient batching and modular architecture.
+ *
+ * @module MerkleOperation
+ * @author Synapse Gateway Team
+ */
+import { PublicKey, Transaction, Connection, Keypair, Signer } from '@solana/web3.js';
+import type { SynapseClient } from '../client';
+import { PDAManager, type UserPDAs } from './pda-manager';
+import type { BatchOptionRequest } from './types.ai';
+/**
+ * Merkle tree node/leaf
+ */
+export interface MerkleLeaf {
+    /** Input hash (32 bytes hex) */
+    input: string;
+    /** Result hash (32 bytes hex) */
+    result: string;
+}
+/**
+ * Merkle proof
+ */
+export interface MerkleProof {
+    /** Leaf hash */
+    leaf: string;
+    /** Proof hashes */
+    proof: string[];
+    /** Root hash */
+    root: string;
+}
+/**
+ * Merkle validation result
+ */
+export interface MerkleValidationResult {
+    /** Merkle root hash */
+    merkleRoot: string;
+    /** Merkle proof */
+    merkleProof: string[];
+    /** Merkle leaf data */
+    merkleLeaf: MerkleLeaf;
+    /** Compressed events (base64) */
+    merkleEvents: string;
+}
+/**
+ * Chunk info for on-chain inscription
+ */
+export interface ChunkInfo {
+    /** Chunk data buffer */
+    data: Buffer;
+    /** Is first chunk */
+    isFirst: boolean;
+    /** Is last chunk */
+    isLast: boolean;
+    /** Chunk index */
+    index: number;
+}
+/**
+ * Inscription result
+ */
+export interface InscriptionResult {
+    /** DB PDA where data was stored */
+    dbAccountStore: PublicKey;
+    /** Root PDA where proof was stored */
+    dbAccountRoot: PublicKey;
+    /** Zero chunk signature (last data chunk) */
+    zeroChunkSign: string;
+    /** Root transaction signature */
+    signatureRoot: string;
+    /** Merkle root */
+    merkleRoot: string;
+    /** Merkle proof */
+    merkleProof: string[];
+    /** Merkle leaf */
+    merkleLeaf: MerkleLeaf;
+    /** Compressed events */
+    merkleEvents: string;
+}
+/**
+ * MerkleOperation - handles Merkle tree operations and on-chain storage
+ *
+ * This class provides utilities for:
+ * - Generating Merkle trees from event data
+ * - Creating and verifying proofs
+ * - Splitting large data into chunks
+ * - Inscribing data on-chain via memo transactions
+ *
+ * For on-chain operations, you can provide either:
+ * - A Solana Connection + Signer for real transaction signing
+ * - Just use SynapseClient (will require pre-signed transactions)
+ */
+export declare class MerkleOperation {
+    private client;
+    private pdaManager;
+    private walletAddress;
+    private batchConfig;
+    private signer?;
+    private rpcMethods;
+    private leaves;
+    private tree;
+    private root;
+    /**
+     * Create a new MerkleOperation instance
+     * @param client - Synapse client for RPC calls
+     * @param walletAddress - User wallet address
+     * @param batchConfig - Optional batch processing configuration
+     * @param signer - Optional Signer/Keypair for signing transactions
+     */
+    constructor(client: SynapseClient, walletAddress: string, batchConfig?: BatchOptionRequest, connection?: Connection, signer?: Signer | Keypair);
+    /**
+     * Create Merkle tree from data array
+     * @param data - Array of data items to hash
+     * @returns Merkle root hash (hex)
+     */
+    createMerkleTree(data: string[]): string;
+    /**
+     * Get Merkle proof for a leaf
+     * @param leafData - Data to generate proof for
+     * @returns Merkle proof
+     */
+    getMerkleProof(leafData: string): MerkleProof;
+    /**
+     * Verify a Merkle proof
+     * @param leaf - Leaf hash
+     * @param proof - Proof hashes
+     * @param root - Expected root hash
+     * @returns true if proof is valid
+     */
+    verifyProof(leaf: string, proof: string[], root: string): boolean;
+    /**
+     * Batch verify multiple Merkle proofs
+     * @param proofs - Array of proof objects to verify
+     * @returns Array of verification results
+     */
+    batchVerifyProofs(proofs: Array<{
+        leaf: string;
+        proof: string[];
+        root: string;
+    }>): boolean[]; /**
+   * Calculate optimal chunks from buffer
+   * Splits data into chunks while respecting size limits for memo transactions
+   * @param buffer - Data buffer to chunk
+   * @param minChunkSize - Minimum chunk size (default: 1)
+   * @param maxChunkSize - Maximum chunk size (default: 560 for memo safety)
+   * @returns Array of chunk buffers
+   */
+    calculateChunks(buffer: Buffer, minChunkSize?: number, maxChunkSize?: number): Buffer[];
+    /**
+     * Create zero chunk (128 bytes: 2 merkle leaves + previous signature)
+     * @param leaf - Merkle leaf data
+     * @returns Zero chunk buffer (128 bytes)
+     */
+    createZeroChunk(leaf: MerkleLeaf): Buffer;
+    /**
+     * On-chain Merkle inscription - stores data + proof on Solana
+     * Uses PDA accounts to store chunked data and merkle roots
+     * @param validationResult - Merkle validation result to inscribe
+     * @param pdas - Optional custom PDAs
+     * @returns Inscription result with signatures and PDAs
+     */
+    inscribeOnChain(validationResult: MerkleValidationResult, pdas?: UserPDAs): Promise<InscriptionResult>;
+    /**
+     * Send a memo transaction to store data
+     * Uses Synapse client for transaction submission with Memo Program
+     *
+     * Two modes of operation:
+     * 1. With Connection + Signer: Signs and sends transaction directly
+     * 2. Without Connection: Returns unsigned transaction for external signing
+     *
+     * @param pda - Target PDA
+     * @param data - Data buffer to store in memo
+     * @returns Transaction signature
+     */
+    private sendMemoTransaction;
+    /**
+     * Create and send multiple memo transactions in batch
+     * Uses optimized batching for better performance
+     * @param pda - Target PDA
+     * @param dataChunks - Array of data buffers to send
+     * @returns Array of transaction signatures
+     */
+    private batchSendMemoTransactions;
+    /**
+     * Hash data using SHA-256
+     * @param data - Data to hash
+     * @returns Hex hash string
+     */
+    private hash;
+    /**
+     * Trim trailing zeros from buffer
+     * @param buffer - Buffer to trim
+     * @returns Trimmed buffer
+     */
+    private trimTrailingZeros;
+    /**
+     * Sleep utility
+     * @param ms - Milliseconds to sleep
+     */
+    private sleep;
+    /**
+     * Get current Merkle root
+     */
+    getRoot(): string;
+    /**
+     * Get all leaves
+     */
+    getLeaves(): string[];
+    /**
+     * Get PDA manager
+     */
+    getPDAManager(): PDAManager;
+    /**
+     * Get batch configuration
+     */
+    getBatchConfig(): BatchOptionRequest;
+    /**
+     * Update batch configuration
+     */
+    updateBatchConfig(config: Partial<BatchOptionRequest>): void;
+    /**
+     * Set signer for transaction signing
+     * @param signer - Keypair or Signer instance
+     */
+    setSigner(signer: Signer | Keypair): void;
+    /**
+     * Get unsigned transaction for external signing
+     * Useful for wallet adapter integration
+     * @param pda - Target PDA
+     * @param data - Data buffer to store in memo
+     * @returns Unsigned Transaction object
+     */
+    createUnsignedMemoTransaction(pda: PublicKey, data: Buffer): Promise<Transaction>;
+    /**
+     * Batch inscribe multiple validation results on-chain
+     * Uses client.batch() for optimal performance when inscribing multiple proofs
+     * @param validationResults - Array of merkle validation results
+     * @param pdas - Optional custom PDAs
+     * @returns Array of inscription results
+     */
+    batchInscribeOnChain(validationResults: MerkleValidationResult[], pdas?: UserPDAs): Promise<InscriptionResult[]>;
+}
+//# sourceMappingURL=merkle-operation.d.ts.map

package/dist/esm/ai/merkle-operation.d.ts.map

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