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

package/dist/esm/ai/pda-manager.js

@@ -0,0 +1,213 @@
+/**
+ * PDA Manager - Synapse SDK Implementation
+ *
+ * Professional PDA (Program Derived Address) manager inspired by OOBE Protocol
+ * but implemented using Synapse SDK's modular architecture and batch methods.
+ * No Raydium dependencies - pure Solana Web3.js integration.
+ *
+ * @module PDAManager
+ * @author Synapse Gateway Team
+ */
+import { PublicKey, SystemProgram } from '@solana/web3.js';
+import * as crypto from 'crypto';
+import { SolanaRpcMethods } from '../methods/solana-rpc.js';
+/**
+ * Default PDA seeds configuration
+ */
+export const DEFAULT_PDA_CONFIG = {
+    merkleDbSeed: 'merkle_db',
+    merkleRootSeed: 'merkle_root',
+    personalityDbSeed: 'personality_db',
+    personalityRootSeed: 'personality_root',
+};
+/**
+ * PDAManager - manages Program Derived Addresses for Merkle storage
+ *
+ * This class provides utilities to derive and manage PDAs used for storing
+ * large amounts of transaction data on-chain using a Merkle tree approach.
+ * Compatible with OOBE Protocol patterns but using pure Solana libraries.
+ */
+export class PDAManager {
+    client;
+    wallet;
+    config;
+    programId;
+    rpcMethods;
+    batchConfig;
+    /**
+     * Create a new PDAManager instance
+     * @param client - Synapse client for RPC calls
+     * @param walletAddress - User wallet address
+     * @param config - Optional PDA configuration
+     * @param programId - Optional program ID (defaults to System Program)
+     * @param batchConfig - Optional batch processing configuration
+     */
+    constructor(client, walletAddress, config, programId, batchConfig) {
+        this.client = client;
+        this.wallet = new PublicKey(walletAddress);
+        this.config = { ...DEFAULT_PDA_CONFIG, ...config };
+        this.programId = programId ? new PublicKey(programId) : SystemProgram.programId;
+        this.rpcMethods = new SolanaRpcMethods(client);
+        this.batchConfig = {
+            batchSize: 100,
+            delayMs: 500,
+            maxRetries: 3,
+            retryDelayMs: 1000,
+            ...batchConfig,
+        };
+    }
+    /**
+     * Generate a deterministic seed buffer from a string seed and wallet
+     * Uses SHA-256 hashing for deterministic derivation (OOBE-compatible)
+     * @param seed - Base seed string
+     * @param wallet - Wallet public key
+     * @returns 32-byte seed buffer
+     */
+    generateSeed(seed, wallet) {
+        const combined = `${seed}@${wallet.toBase58()}`;
+        const hash = crypto.createHash('sha256').update(combined).digest('hex');
+        // Take first 32 bytes (64 hex chars) as seed
+        return Buffer.from(hash.slice(0, 64), 'hex');
+    }
+    /**
+     * Get user PDAs for Merkle data storage
+     * Derives two PDAs: one for storing leaf/chunk data, one for roots
+     * @param customConfig - Optional custom seed configuration
+     * @returns UserPDAs with leaf and root addresses + bumps
+     */
+    getUserPDAs(customConfig) {
+        const config = { ...this.config, ...customConfig };
+        // Derive Leaf/DB PDA
+        const leafSeed = this.generateSeed(config.merkleDbSeed, this.wallet);
+        const [leafPDA, leafBump] = PublicKey.findProgramAddressSync([leafSeed], this.programId);
+        // Derive Root PDA
+        const rootSeed = this.generateSeed(config.merkleRootSeed, this.wallet);
+        const [rootPDA, rootBump] = PublicKey.findProgramAddressSync([rootSeed], this.programId);
+        return {
+            leafPDA,
+            rootPDA,
+            leafBump,
+            rootBump,
+        };
+    }
+    /**
+     * Get user PDAs for Personality storage (OOBE Agent personality system)
+     * Similar to getUserPDAs but uses personality-specific seeds
+     * @returns UserPDAs for personality data
+     */
+    getUserPersonalityPDAs() {
+        const { personalityDbSeed, personalityRootSeed } = this.config;
+        // Derive Personality Leaf PDA
+        const leafSeed = this.generateSeed(personalityDbSeed, this.wallet);
+        const [leafPDA, leafBump] = PublicKey.findProgramAddressSync([leafSeed], this.programId);
+        // Derive Personality Root PDA
+        const rootSeed = this.generateSeed(personalityRootSeed, this.wallet);
+        const [rootPDA, rootBump] = PublicKey.findProgramAddressSync([rootSeed], this.programId);
+        return {
+            leafPDA,
+            rootPDA,
+            leafBump,
+            rootBump,
+        };
+    }
+    /**
+     * Check if PDA accounts exist on-chain
+     * Uses Synapse client's batch() for optimal performance
+     * @param pdas - UserPDAs to check
+     * @returns Object indicating which PDAs exist
+     */
+    async checkPDAExistence(pdas) {
+        try {
+            // Use batch() for parallel account checks
+            const results = await this.client.batch([
+                {
+                    method: 'getAccountInfo',
+                    params: [pdas.leafPDA.toBase58(), { commitment: 'confirmed', encoding: 'base64' }],
+                },
+                {
+                    method: 'getAccountInfo',
+                    params: [pdas.rootPDA.toBase58(), { commitment: 'confirmed', encoding: 'base64' }],
+                },
+            ]);
+            return {
+                leafExists: results[0]?.value !== null,
+                rootExists: results[1]?.value !== null,
+            };
+        }
+        catch (error) {
+            return { leafExists: false, rootExists: false };
+        }
+    }
+    /**
+     * Get PDA account info using Synapse client
+     * @param pda - PDA public key
+     * @returns Account info or null
+     */
+    async getPDAAccountInfo(pda) {
+        try {
+            return await this.rpcMethods.getAccountInfo(pda.toBase58(), { commitment: 'confirmed', encoding: 'base64' });
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Get multiple PDA account infos using batch for optimal performance
+     * @param pdas - Array of PDA public keys
+     * @returns Array of account infos (null if not found)
+     */
+    async getBatchPDAAccountInfo(pdas) {
+        if (pdas.length === 0)
+            return [];
+        try {
+            // Use batch() for parallel requests
+            const requests = pdas.map((pda) => ({
+                method: 'getAccountInfo',
+                params: [pda.toBase58(), { commitment: 'confirmed', encoding: 'base64' }],
+            }));
+            const results = await this.client.batch(requests);
+            return results.map((res) => res?.value || null);
+        }
+        catch {
+            return pdas.map(() => null);
+        }
+    }
+    /**
+     * Validate PDA derivation (utility for debugging)
+     * @param pda - PDA to validate
+     * @param seeds - Seeds used for derivation
+     * @returns true if PDA matches expected derivation
+     */
+    validatePDA(pda, seeds) {
+        try {
+            const [derived] = PublicKey.findProgramAddressSync(seeds, this.programId);
+            return derived.equals(pda);
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get all PDAs for a wallet (convenience method)
+     * Returns both standard and personality PDAs
+     */
+    getAllUserPDAs() {
+        return {
+            standard: this.getUserPDAs(),
+            personality: this.getUserPersonalityPDAs(),
+        };
+    }
+    /**
+     * Get batch configuration
+     */
+    getBatchConfig() {
+        return { ...this.batchConfig };
+    }
+    /**
+     * Update batch configuration
+     */
+    updateBatchConfig(config) {
+        this.batchConfig = { ...this.batchConfig, ...config };
+    }
+}
+//# sourceMappingURL=pda-manager.js.map

package/dist/esm/ai/pda-manager.js.map

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

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

@@ -0,0 +1,172 @@
+/**
+ * AI module types - OOBE Protocol compatible
+ *
+ * Types and interfaces for AI agents compatible with the OOBE Protocol
+ * (https://github.com/CryptoFamilyNFT/oobe-protocol). These types support
+ * LangChain StructuredTool patterns, multi-LLM providers, and Agent-based
+ * dependency injection.
+ *
+ * NOTE: LangChain types are declared as 'any' here since @langchain packages
+ * are peer dependencies. Install @langchain/core for full type safety.
+ */
+/**
+ * Minimal Agent interface compatible with OOBE Protocol Agent class.
+ * Real implementations should use the full oobe-protocol Agent.
+ */
+export interface OOBECompatibleAgent {
+    getCurrentLLM(): Promise<any>;
+    switchLLMProvider?(config: any): Promise<any>;
+    walletAddress?: string;
+    logger?: any;
+    executeAction?(actionName: string, input: Record<string, any>): Promise<any>;
+}
+/**
+ * Market analysis suggestion from an AI agent
+ */
+export interface AgentTradeSuggestion {
+    id: string;
+    symbol: string;
+    side: 'buy' | 'sell';
+    size: number;
+    price?: number;
+    confidence?: number;
+    reasoning?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Risk assessment report from an AI agent
+ */
+export interface AgentRiskReport {
+    score: number;
+    level?: 'low' | 'medium' | 'high' | 'critical';
+    reasons?: string[];
+    details?: Record<string, any>;
+}
+/**
+ * AgentAdapter interface for pluggable intelligence.
+ * Implement this to integrate LangChain, Langraph, or custom AI logic.
+ */
+export interface AgentAdapter {
+    analyzeMarket(context: {
+        pairs: string[];
+        client: any;
+        agent?: OOBECompatibleAgent;
+    }): Promise<AgentTradeSuggestion[]>;
+    evaluateRisk?(context: {
+        client: any;
+        agent?: OOBECompatibleAgent;
+    }): Promise<AgentRiskReport>;
+    proposeStrategies?(context: {
+        client: any;
+        agent?: OOBECompatibleAgent;
+    }): Promise<any>;
+}
+/**
+ * AI agent configuration
+ */
+export interface AIAgentConfig {
+    agentId: string;
+    description?: string;
+    capabilities: string[];
+    tier: 'basic' | 'advanced' | 'premium';
+    oobeAgent?: OOBECompatibleAgent;
+}
+/**
+ * Blockchain context for AI operations
+ */
+export interface AIContext {
+    currentSlot?: number;
+    epochInfo?: any;
+    networkStatus: 'healthy' | 'degraded' | 'unhealthy';
+    availableMethods: string[];
+}
+/**
+ * Batch operation configuration
+ */
+export interface BatchOptionRequest {
+    batchSize: number;
+    delayMs?: number;
+    maxRetries?: number;
+    retryDelayMs?: number;
+}
+/**
+ * Standard AI response wrapper
+ */
+export interface AIResponse<T = any> {
+    data: T;
+    context: AIContext;
+    metadata: {
+        latency: number;
+        cacheHit: boolean;
+        upstreamUsed: string;
+        timestamp: string;
+    };
+}
+/**
+ * Market prediction from quantum/AI analysis
+ */
+export interface QuantumPrediction {
+    asset: string;
+    timeframe: string;
+    direction: 'bullish' | 'bearish' | 'neutral';
+    confidence: number;
+    priceTarget: number;
+    supportLevels?: number[];
+    resistanceLevels?: number[];
+    signals?: string[];
+}
+/**
+ * Trade execution record
+ */
+export interface TradeExecution {
+    id: string;
+    source: string;
+    type: string;
+    symbol: string;
+    side: 'buy' | 'sell';
+    size: number;
+    price?: number;
+    timestamp: string;
+    status: 'pending' | 'filled' | 'failed' | 'cancelled';
+    expectedProfit?: number;
+    actualProfit?: number | null;
+    metadata?: Record<string, any>;
+}
+/**
+ * Multi-chain signal analysis
+ */
+export interface MultiChainSignal {
+    chain: string;
+    signal: string;
+    strength: number;
+    impact: 'positive' | 'negative' | 'neutral';
+    crossChainCorrelation: number;
+    arbitrageOpportunities: Array<{
+        fromChain: string;
+        toChain: string;
+        asset: string;
+        profitPotential: number;
+    }>;
+}
+/**
+ * Trading strategy metadata
+ */
+export interface AutoTradingStrategy {
+    id: string;
+    name: string;
+    description: string;
+    active: boolean;
+    riskScore: number;
+    expectedReturn: number;
+    maxDrawdown: number;
+    winRate: number;
+    averageHoldTime: string;
+    signals: string[];
+    performance: {
+        totalTrades: number;
+        profitableTrades: number;
+        totalPnL: number;
+        sharpeRatio: number;
+    };
+}
+//# sourceMappingURL=types.ai.d.ts.map

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

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

package/dist/esm/ai/types.ai.js

@@ -0,0 +1,13 @@
+/**
+ * AI module types - OOBE Protocol compatible
+ *
+ * Types and interfaces for AI agents compatible with the OOBE Protocol
+ * (https://github.com/CryptoFamilyNFT/oobe-protocol). These types support
+ * LangChain StructuredTool patterns, multi-LLM providers, and Agent-based
+ * dependency injection.
+ *
+ * NOTE: LangChain types are declared as 'any' here since @langchain packages
+ * are peer dependencies. Install @langchain/core for full type safety.
+ */
+export {};
+//# sourceMappingURL=types.ai.js.map

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

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

package/dist/esm/ai/zero-combine-fetcher.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Zero Combine Fetcher - Synapse SDK Implementation
+ *
+ * Professional implementation of the OOBE Protocol's ZeroCombine pattern for
+ * fetching and reconstructing large transaction datasets split across multiple
+ * on-chain memo chunks. Uses Synapse SDK's batch capabilities for efficiency.
+ *
+ * @module ZeroCombineFetcher
+ * @author SteveTheHead
+ */
+import type { SynapseClient } from '../client';
+import { PDAManager, type UserPDAs } from './pda-manager';
+/**
+ * Zero Chunk structure (128 bytes: 2 merkle leaves + previous signature)
+ */
+export interface ZeroChunk {
+    /** First 64 bytes - Merkle Leaf 1 */
+    leaf1: string;
+    /** Second 64 bytes - Merkle Leaf 2 */
+    leaf2: string;
+    /** Remaining bytes - Previous transaction signature */
+    prevSign: string;
+}
+/**
+ * Confirmed signature info (simplified)
+ */
+export interface SignatureInfo {
+    signature: string;
+    slot: number;
+    blockTime: number | null;
+    memo: string | null;
+    err: any;
+    confirmationStatus?: string;
+}
+/**
+ * Proof record - complete reconstructed transaction proof
+ */
+export interface ProofRecord {
+    /** Merkle root hash */
+    root: string;
+    /** Signature of the proof transaction */
+    proofSignature: string;
+    /** Original zero chunk transaction */
+    transaction: {
+        signature: string;
+        slot: number;
+        memo: ZeroChunk;
+    };
+    /** First chunk content */
+    firstChunkContent: {
+        prev_chunk_sign: string;
+        content: string;
+    };
+    /** All cycled content chunks */
+    cycledContent: Array<{
+        prev_chunk_sign?: string;
+        content?: string;
+        leaf1?: string;
+        leaf2?: string;
+        prevSign?: string;
+        result?: string;
+    }>;
+}
+/**
+ * Batch configuration for fetching
+ * Includes all batch processing options
+ */
+export interface FetchConfig {
+    batchSize: number;
+    delayMs?: number;
+    maxRetries?: number;
+    retryDelayMs?: number;
+}
+/**
+ * Zero Combine Fetcher Result
+ */
+export interface ZeroCombineResult {
+    tools: ProofRecord[];
+}
+/**
+ * ZeroCombineFetcher - fetches and reconstructs large transaction datasets
+ *
+ * This class implements the OOBE Protocol pattern for storing large data on-chain
+ * by splitting it across multiple memo transactions and linking them via signatures.
+ * Uses Synapse SDK's efficient batching for optimal performance.
+ */
+export declare class ZeroCombineFetcher {
+    private client;
+    private pdaManager;
+    private config;
+    /**
+     * Create a new ZeroCombineFetcher instance
+     * @param client - Synapse client for RPC calls
+     * @param walletAddress - User wallet address
+     * @param fetchConfig - Optional fetch configuration
+     */
+    constructor(client: SynapseClient, walletAddress: string, fetchConfig?: FetchConfig);
+    /**
+     * Execute the full fetch and reconstruction process
+     * @param pdas - Optional custom PDAs (if null, will derive from wallet)
+     * @returns ZeroCombineResult with all reconstructed proof records
+     */
+    execute(pdas?: UserPDAs | null): Promise<ZeroCombineResult>;
+    /**
+     * Fetch all transactions from Root PDA
+     * Root PDA contains merkle roots and proof signatures
+     * Uses optimized batch fetching for maximum performance
+     * @param rootPDA - Root PDA public key
+     * @returns Array of signature info with decoded memos
+     */
+    private getRootTransactions;
+    /**
+     * Fetch and structure transactions from DB/Leaf PDA
+     * Uses optimized batch fetching for maximum performance
+     * @param leafPDA - Leaf PDA public key
+     * @param rootTransactions - Root transactions to match against
+     * @returns Zero transactions and all DB transactions
+     */
+    private getDbTransactions;
+    /**
+     * Fetch first chunk content for a batch of transactions
+     * @param batch - Batch of transactions to process
+     * @param allTransactions - All DB transactions for lookup
+     * @returns Transactions enriched with first chunk content
+     */
+    private fetchFirstChunkBatch;
+    /**
+     * Resolve all memo chunks by following prev_chunk_sign links
+     * @param transactions - Transactions with first chunk
+     * @param allTransactions - All DB transactions for lookup
+     * @returns Complete proof records with all chunks resolved
+     */
+    private resolveMemoChunksBatch;
+    /**
+     * Extract memo from transaction details
+     * @param tx - Transaction object
+     * @returns Memo string or null
+     */
+    private extractMemoFromTransaction;
+    /**
+     * Decode memo from base64 or raw string
+     * @param memo - Memo to decode
+     * @returns Decoded memo string
+     */
+    private decodeMemo;
+    /**
+     * Sleep utility for batch delays
+     * @param ms - Milliseconds to sleep
+     */
+    private sleep;
+    /**
+     * Get PDA manager instance (for advanced usage)
+     */
+    getPDAManager(): PDAManager;
+    /**
+     * Get batch configuration
+     */
+    getBatchConfig(): FetchConfig;
+    /**
+     * Update batch configuration
+     */
+    updateBatchConfig(config: Partial<FetchConfig>): void;
+    /**
+     * Batch fetch multiple proof records for different wallets
+     * Uses optimized batching for parallel fetching
+     * @param walletAddresses - Array of wallet addresses to fetch for
+     * @returns Map of wallet address to their proof records
+     */
+    batchExecuteForWallets(walletAddresses: string[]): Promise<Map<string, ZeroCombineResult>>;
+}
+//# sourceMappingURL=zero-combine-fetcher.d.ts.map

package/dist/esm/ai/zero-combine-fetcher.d.ts.map

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