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

package/dist/cjs/ai/zero-combine-fetcher.js

@@ -0,0 +1,412 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZeroCombineFetcher = void 0;
+const pda_manager_1 = require("./pda-manager");
+/**
+ * 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.
+ */
+class ZeroCombineFetcher {
+    client;
+    pdaManager;
+    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, walletAddress, fetchConfig) {
+        this.client = client;
+        this.pdaManager = new pda_manager_1.PDAManager(client, walletAddress);
+        this.config = {
+            batchSize: 100,
+            delayMs: 2000,
+            maxRetries: 3,
+            retryDelayMs: 1000,
+            ...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
+     */
+    async execute(pdas) {
+        // Get or use provided PDAs
+        const userPDAs = pdas || this.pdaManager.getUserPDAs();
+        // Fetch root transactions
+        const rootTransactions = await this.getRootTransactions(userPDAs.rootPDA);
+        if (rootTransactions.length === 0) {
+            throw new Error('No transactions found in Root PDA');
+        }
+        // Fetch and structure DB transactions
+        const { zeroTransactions, allDbTransactions } = await this.getDbTransactions(userPDAs.leafPDA, rootTransactions);
+        // Process in batches
+        const allProofRecords = [];
+        for (let i = 0; i < zeroTransactions.length; i += this.config.batchSize) {
+            const batch = zeroTransactions.slice(i, i + this.config.batchSize);
+            // Fetch first chunk content for batch
+            const withFirstChunk = await this.fetchFirstChunkBatch(batch, allDbTransactions);
+            // Resolve all memo chunks
+            const fullRecords = await this.resolveMemoChunksBatch(withFirstChunk, allDbTransactions);
+            allProofRecords.push(...fullRecords);
+            // Delay between batches to avoid rate limiting
+            if (i + this.config.batchSize < zeroTransactions.length) {
+                await this.sleep(this.config.delayMs);
+            }
+        }
+        return {
+            tools: allProofRecords,
+        };
+    }
+    /**
+     * 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
+     */
+    async getRootTransactions(rootPDA) {
+        const signatures = [];
+        let lastSignature = null;
+        // Paginate through all transactions using getSignaturesForAddress
+        while (true) {
+            const batch = await this.client.call('getSignaturesForAddress', [
+                rootPDA.toBase58(),
+                {
+                    limit: 1000,
+                    before: lastSignature || undefined,
+                },
+            ]);
+            if (batch.length === 0)
+                break;
+            // Process batch: fetch transaction details for all signatures in parallel
+            const txRequests = batch.map((sig) => ({
+                method: 'getTransaction',
+                params: [sig.signature, { encoding: 'json', maxSupportedTransactionVersion: 0 }],
+            }));
+            const txDetails = await this.client.batch(txRequests);
+            // Extract and decode memos from transaction details
+            const valid = batch
+                .map((sig, index) => {
+                const tx = txDetails[index];
+                const memo = this.extractMemoFromTransaction(tx);
+                return {
+                    signature: sig.signature,
+                    slot: sig.slot,
+                    blockTime: sig.blockTime,
+                    memo: memo ? this.decodeMemo(memo) : null,
+                    err: sig.err,
+                    confirmationStatus: sig.confirmationStatus,
+                };
+            })
+                .filter((sig) => sig.signature && sig.memo);
+            signatures.push(...valid);
+            lastSignature = batch[batch.length - 1].signature;
+            if (batch.length < 1000)
+                break;
+            // Small delay to avoid rate limiting (use configured delay)
+            await this.sleep(this.config.delayMs || 500);
+        }
+        return signatures;
+    }
+    /**
+     * 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
+     */
+    async getDbTransactions(leafPDA, rootTransactions) {
+        // Fetch all DB transactions with batch optimization
+        const allDbTransactions = [];
+        let lastSignature = null;
+        while (true) {
+            const batch = await this.client.call('getSignaturesForAddress', [
+                leafPDA.toBase58(),
+                {
+                    limit: 1000,
+                    before: lastSignature || undefined,
+                },
+            ]);
+            if (batch.length === 0)
+                break;
+            // Batch fetch transaction details for all signatures
+            const txRequests = batch.map((sig) => ({
+                method: 'getTransaction',
+                params: [sig.signature, { encoding: 'json', maxSupportedTransactionVersion: 0 }],
+            }));
+            const txDetails = await this.client.batch(txRequests);
+            // Extract memos and build signature info
+            const valid = batch
+                .map((sig, index) => {
+                const tx = txDetails[index];
+                const memo = this.extractMemoFromTransaction(tx);
+                return {
+                    signature: sig.signature,
+                    slot: sig.slot,
+                    blockTime: sig.blockTime,
+                    memo: memo ? this.decodeMemo(memo) : null,
+                    err: sig.err,
+                };
+            })
+                .filter((sig) => sig.signature && sig.memo);
+            allDbTransactions.push(...valid);
+            lastSignature = batch[batch.length - 1].signature;
+            if (batch.length < 1000)
+                break;
+            // Small delay to avoid rate limiting (use configured delay)
+            await this.sleep(this.config.delayMs || 500);
+        }
+        // Filter zero chunk transactions (128 bytes: 64+64+64)
+        const zeroTransactions = allDbTransactions
+            .filter((sig) => {
+            if (!sig.memo)
+                return false;
+            const cleaned = sig.memo.replace(/\[\\d+\]\s*/, '').replace(/\\|\s+/g, '');
+            const parts = cleaned.split('|');
+            return (parts.length === 3 &&
+                parts[0].length === 64 &&
+                parts[1].length === 64 &&
+                parts[2].length >= 64);
+        })
+            .map((sig) => {
+            const parts = sig.memo.split('|');
+            return {
+                signature: sig.signature,
+                slot: sig.slot,
+                memo: {
+                    leaf1: parts[0],
+                    leaf2: parts[1],
+                    prevSign: parts[2],
+                },
+            };
+        });
+        // Match zero transactions with root transactions
+        const matched = [];
+        for (const rootTx of rootTransactions) {
+            if (!rootTx.memo)
+                continue;
+            let rootMemo;
+            try {
+                rootMemo = JSON.parse(rootTx.memo);
+            }
+            catch {
+                continue;
+            }
+            if (!rootMemo.proofSignature)
+                continue;
+            const matchingZero = zeroTransactions.find((zero) => zero.signature === rootMemo.proofSignature);
+            if (matchingZero) {
+                matched.push({
+                    root: rootMemo.root,
+                    proofSignature: rootMemo.proofSignature,
+                    transaction: matchingZero,
+                });
+            }
+        }
+        return { zeroTransactions: matched, allDbTransactions };
+    }
+    /**
+     * 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
+     */
+    async fetchFirstChunkBatch(batch, allTransactions) {
+        return await Promise.all(batch.map(async (tx) => {
+            const firstSignature = tx.transaction.memo.prevSign;
+            const firstTx = allTransactions.find((t) => t.signature === firstSignature);
+            if (!firstTx || !firstTx.memo) {
+                return { ...tx, firstChunkContent: null };
+            }
+            let memo = firstTx.memo;
+            if (!memo.includes('|')) {
+                memo = `single|${memo}`;
+            }
+            const parts = memo.split('|');
+            return {
+                ...tx,
+                firstChunkContent: {
+                    prev_chunk_sign: parts[0],
+                    content: parts.slice(1).join('|').replace(/\\+/g, '').replace(/^"|"$/g, ''),
+                },
+            };
+        }));
+    }
+    /**
+     * 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
+     */
+    async resolveMemoChunksBatch(transactions, allTransactions) {
+        return await Promise.all(transactions.map(async (tx) => {
+            if (!tx.firstChunkContent)
+                return null;
+            const { prev_chunk_sign, content } = tx.firstChunkContent;
+            const chunks = [{ prev_chunk_sign, content }];
+            let prevSign = prev_chunk_sign;
+            // Follow the chain of previous signatures
+            while (prevSign && prevSign !== 'single') {
+                const prevTx = allTransactions.find((t) => t.signature === prevSign);
+                if (!prevTx || !prevTx.memo)
+                    break;
+                let memo = prevTx.memo;
+                if (!memo.includes('|')) {
+                    memo = `single|${memo}`;
+                }
+                const parts = memo.split('|');
+                const chunkData = {
+                    prev_chunk_sign: parts[0],
+                    content: parts.slice(1).join('|').replace(/\\+/g, '').replace(/^"|"$/g, ''),
+                };
+                chunks.push(chunkData);
+                prevSign = chunkData.prev_chunk_sign;
+            }
+            // Reconstruct final content
+            const finalContent = chunks
+                .reverse()
+                .map((c) => c.content)
+                .join('');
+            const cycledContent = [
+                { result: finalContent },
+                {
+                    leaf1: tx.transaction.memo.leaf1,
+                    leaf2: tx.transaction.memo.leaf2,
+                    prevSign: tx.transaction.memo.prevSign,
+                },
+                ...chunks,
+            ];
+            return {
+                root: tx.root,
+                proofSignature: tx.proofSignature,
+                transaction: tx.transaction,
+                firstChunkContent: tx.firstChunkContent,
+                cycledContent,
+            };
+        })).then((records) => records.filter((r) => r !== null));
+    }
+    /**
+     * Extract memo from transaction details
+     * @param tx - Transaction object
+     * @returns Memo string or null
+     */
+    extractMemoFromTransaction(tx) {
+        if (!tx || !tx.transaction)
+            return null;
+        try {
+            // Look for memo program in instructions
+            const instructions = tx.transaction.message?.instructions || [];
+            const memoInstruction = instructions.find((ix) => ix.programId === 'MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr' ||
+                ix.program === 'spl-memo');
+            if (memoInstruction && memoInstruction.data) {
+                return memoInstruction.data;
+            }
+            // Fallback: check meta.logMessages for memo
+            const logs = tx.meta?.logMessages || [];
+            for (const log of logs) {
+                if (log.startsWith('Program log: Memo (len')) {
+                    const match = log.match(/: "(.+)"$/);
+                    if (match)
+                        return match[1];
+                }
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Decode memo from base64 or raw string
+     * @param memo - Memo to decode
+     * @returns Decoded memo string
+     */
+    decodeMemo(memo) {
+        try {
+            // Try base64 decode
+            return Buffer.from(memo, 'base64').toString('utf-8');
+        }
+        catch {
+            // Return as-is if not base64
+            return memo;
+        }
+    }
+    /**
+     * Sleep utility for batch delays
+     * @param ms - Milliseconds to sleep
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Get PDA manager instance (for advanced usage)
+     */
+    getPDAManager() {
+        return this.pdaManager;
+    }
+    /**
+     * Get batch configuration
+     */
+    getBatchConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update batch configuration
+     */
+    updateBatchConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * 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
+     */
+    async batchExecuteForWallets(walletAddresses) {
+        const results = new Map();
+        const batchSize = this.config.batchSize || 10;
+        // Process wallets in batches
+        for (let i = 0; i < walletAddresses.length; i += batchSize) {
+            const batch = walletAddresses.slice(i, i + batchSize);
+            // Fetch in parallel within batch
+            const batchResults = await Promise.all(batch.map(async (address) => {
+                try {
+                    const pdaManager = new pda_manager_1.PDAManager(this.client, address);
+                    const pdas = pdaManager.getUserPDAs();
+                    const result = await this.execute(pdas);
+                    return { address, result };
+                }
+                catch (error) {
+                    return { address, result: { tools: [] } };
+                }
+            }));
+            // Store results
+            batchResults.forEach(({ address, result }) => {
+                results.set(address, result);
+            });
+            // Delay between batches
+            if (i + batchSize < walletAddresses.length) {
+                await this.sleep(this.config.delayMs || 2000);
+            }
+        }
+        return results;
+    }
+}
+exports.ZeroCombineFetcher = ZeroCombineFetcher;
+//# sourceMappingURL=zero-combine-fetcher.js.map

package/dist/cjs/ai/zero-combine-fetcher.js.map

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

package/dist/cjs/client.d.ts

@@ -0,0 +1,83 @@
+import { EventEmitter } from 'eventemitter3';
+import { SynapseConfig, RequestOptions, ClientStats } from './types';
+import { SignatureInfo } from './ai';
+/**
+ * @name SynapseClient
+ * @description The core client for interacting with the Synapse RPC Gateway. This class handles all low-level communication with the gateway, including request serialization, response deserialization, and error handling.
+ * @author SteveTheHead
+ * @author 0xArmorer
+ * @constructor SynapseConfig
+ */
+export declare class SynapseClient extends EventEmitter {
+    private config;
+    private requestId;
+    private stats;
+    constructor(config: SynapseConfig);
+    /**
+     * Get endpoint URL
+     */
+    get endpoint(): string;
+    /**
+     * Get API key
+     */
+    get apiKey(): string | undefined;
+    /**
+     * Make a single RPC call
+     * Uses zero-copy operations, early returns, and minimal branching
+     */
+    call<T = any>(method: string, params?: any, options?: RequestOptions): Promise<T>;
+    /**
+     * Send an RPC request with automatic upstream rotation on "method not allowed" errors.
+     */
+    private sendRpcWithRotation;
+    /**
+     * Make multiple RPC calls in batch
+     */
+    batch<T = any>(requests: Array<{
+        method: string;
+        params?: any[];
+    }>, options?: RequestOptions): Promise<T[]>;
+    /**
+     * Internal HTTP request handler
+     */
+    private makeHttpRequest;
+    /**
+     * Get a signature for a given address and message.
+     * @param address The base-58 encoded account address (required).
+     * @param options Optional configuration object:
+     *   - commitment: string
+     *   - minContextSlot: number
+     *   - limit: number
+     *   - before: string
+     *   - until: string
+     * @returns The signature info array.
+     */
+    getSignatureForAddress(address: string, options?: {
+        commitment?: string;
+        minContextSlot?: number;
+        limit?: number;
+        before?: string;
+        until?: string;
+    }): Promise<SignatureInfo[]>;
+    /**
+     * Update latency statistics
+     */
+    private updateLatencyStats;
+    /**
+     * Get client statistics
+     */
+    getStats(): ClientStats;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+    /**
+     * Health check
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Get gateway performance metrics
+     */
+    getGatewayMetrics(): Promise<any>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/cjs/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EACL,aAAa,EAGb,cAAc,EAGd,WAAW,EACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAErC;;;;;;GAMG;AAEH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,MAAM,CAAsD;IACpE,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,KAAK,CAAc;gBAEf,MAAM,EAAE,aAAa;IAwBjC;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAE/B;IAED;;;OAGG;IACG,IAAI,CAAC,CAAC,GAAG,GAAG,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,GAAQ,EAChB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC;IAqEb;;OAEG;YACW,mBAAmB;IAkDjC;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,GAAG,EACjB,QAAQ,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC,EACnD,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,EAAE,CAAC;IA6Bf;;OAEG;YACW,eAAe;IAyC7B;;;;;;;;;;OAUG;IACG,sBAAsB,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GACA,OAAO,CAAC,aAAa,EAAE,CAAC;IAK3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACH,QAAQ,IAAI,WAAW;IAOvB;;OAEG;IACH,UAAU,IAAI,IAAI;IAYlB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAerC;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC;CAWxC"}