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

package/dist/cjs/grpc/parser/geyser-parser.d.ts

@@ -0,0 +1,184 @@
+/**
+ * GeyserParser — high-level entry point for dev consumption.
+ *
+ * Developers instantiate this once with their preferred config
+ * and feed every raw update from a Yellowstone gRPC `subscribe()` stream.
+ * They choose between **raw** (zero-cost pass-through) or **parsed**
+ * (fully decoded, typed, human-readable) output — or both.
+ *
+ * @module grpc/parser/geyser-parser
+ * @since 1.0.0
+ *
+ * @example
+ * ```ts
+ * import { GeyserParser } from '@oobe-protocol-labs/synapse-client-sdk';
+ *
+ * const parser = new GeyserParser({ skipVotes: true });
+ *
+ * grpcStream.on('data', (raw) => {
+ *   // Option A — get the fully parsed update
+ *   const parsed = parser.parse(raw);
+ *   if (!parsed) return; // filtered out
+ *
+ *   switch (parsed.type) {
+ *     case 'transaction':
+ *       console.log(parsed.data.signature, parsed.data.programNamesInvoked);
+ *       break;
+ *     case 'account':
+ *       console.log(parsed.data.pubkey, parsed.data.sol, 'SOL');
+ *       break;
+ *   }
+ *
+ *   // Option B — keep the raw wire format untouched
+ *   const rawMsg = parser.passthrough(raw);
+ *
+ *   // Option C — parse selectively
+ *   if (raw.update_oneof === 'transaction') {
+ *     const tx = parser.parseTransaction(raw.transaction!);
+ *     console.log(tx.signature, tx.feeSol);
+ *   }
+ * });
+ * ```
+ */
+import { EventEmitter } from 'eventemitter3';
+import type { RawGeyserUpdate, RawTransactionInfo, RawAccountInfo, RawSlotInfo, RawBlockMeta, RawEntry, GeyserParserConfig, ParsedGeyserUpdate, ParsedTransaction, ParsedAccountUpdate, ParsedSlotUpdate, ParsedBlockMeta, ParsedEntry } from './types';
+/** Events emitted by {@link GeyserParser}. @since 1.0.0 */
+export interface GeyserParserEvents {
+    /** Emitted for every successfully parsed update. */
+    update: (update: ParsedGeyserUpdate) => void;
+    /** Emitted specifically for parsed transactions. */
+    transaction: (tx: ParsedTransaction, filters: string[]) => void;
+    /** Emitted specifically for parsed account updates. */
+    account: (acct: ParsedAccountUpdate, filters: string[]) => void;
+    /** Emitted specifically for slot updates. */
+    slot: (slot: ParsedSlotUpdate, filters: string[]) => void;
+    /** Emitted for block meta updates. */
+    blockMeta: (meta: ParsedBlockMeta, filters: string[]) => void;
+    /** Emitted for entry updates. */
+    entry: (entry: ParsedEntry, filters: string[]) => void;
+    /** Emitted when an update is filtered out. */
+    filtered: (raw: RawGeyserUpdate, reason: string) => void;
+    /** Emitted when parsing fails for a single message. */
+    error: (error: Error, raw: RawGeyserUpdate) => void;
+}
+/** Runtime statistics tracked by {@link GeyserParser}. @since 1.0.0 */
+export interface GeyserParserStats {
+    totalReceived: number;
+    totalParsed: number;
+    totalFiltered: number;
+    totalErrors: number;
+    byType: {
+        transaction: number;
+        account: number;
+        slot: number;
+        block_meta: number;
+        entry: number;
+        ping: number;
+    };
+}
+/**
+ * High-level Geyser gRPC subscription parser.
+ *
+ * Features:
+ * - **Raw mode** (`passthrough`) — zero-cost, returns the raw wire message
+ * - **Parsed mode** (`parse`) — fully decoded, typed output
+ * - **Event-based** — optionally emit per-type events for reactive pipelines
+ * - **Stats tracking** — counts by type, filtered, errors
+ * - **Config hot-reload** — change `skipVotes`, custom programs, etc. at runtime
+ * @since 1.0.0
+ */
+export declare class GeyserParser extends EventEmitter<GeyserParserEvents> {
+    private _config;
+    private _stats;
+    constructor(config?: GeyserParserConfig);
+    /** Get the current parser configuration. @since 1.0.0 */
+    get config(): Readonly<Required<GeyserParserConfig>>;
+    /** Update configuration at runtime (partial merge). @since 1.0.0 */
+    updateConfig(patch: Partial<GeyserParserConfig>): void;
+    /** Register additional custom program IDs → names. @since 1.0.0 */
+    addPrograms(programs: Record<string, string>): void;
+    /** Get current parser statistics. @since 1.0.0 */
+    get stats(): Readonly<GeyserParserStats>;
+    /** Reset all statistics counters to zero. @since 1.0.0 */
+    resetStats(): void;
+    /**
+     * Return the raw update as-is — zero decoding cost.
+     *
+     * Useful when devs want the protobuf wire format for
+     * custom decoding, storage, or forwarding.
+     * @since 1.0.0
+     */
+    passthrough<T extends RawGeyserUpdate>(raw: T): T;
+    /**
+     * Parse any raw Geyser update into a fully typed object.
+     *
+     * Returns `null` when the update is filtered out by config
+     * (e.g. vote transactions when `skipVotes: true`).
+     *
+     * Emits typed events for reactive consumption.
+     * @since 1.0.0
+     */
+    parse(raw: RawGeyserUpdate): ParsedGeyserUpdate | null;
+    /**
+     * Convenience: parse a batch of raw updates, returning only non-null results.
+     * @since 1.0.0
+     */
+    parseBatch(updates: RawGeyserUpdate[]): ParsedGeyserUpdate[];
+    /**
+     * Parse a raw transaction update directly.
+     * Use when you already know the `update_oneof` type.
+     * @since 1.0.0
+     */
+    parseTransaction(raw: {
+        transaction: RawTransactionInfo;
+        slot: string;
+    }, timestamp?: Date): ParsedTransaction;
+    /**
+     * Parse a raw account update directly.
+     * @since 1.0.0
+     */
+    parseAccountUpdate(raw: {
+        account: RawAccountInfo;
+        slot: string;
+        is_startup: boolean;
+    }, timestamp?: Date): ParsedAccountUpdate;
+    /**
+     * Parse a raw slot update directly.
+     * @since 1.0.0
+     */
+    parseSlotUpdate(raw: RawSlotInfo, timestamp?: Date): ParsedSlotUpdate;
+    /**
+     * Parse a raw block meta update directly.
+     * @since 1.0.0
+     */
+    parseBlockMeta(raw: RawBlockMeta, timestamp?: Date): ParsedBlockMeta;
+    /**
+     * Parse a raw entry update directly.
+     * @since 1.0.0
+     */
+    parseEntry(raw: RawEntry, timestamp?: Date): ParsedEntry;
+    /**
+     * Create a transform callback suitable for piping a stream.
+     *
+     * @example
+     * ```ts
+     * grpcStream.on('data', parser.createHandler());
+     * ```
+     * @since 1.0.0
+     */
+    createHandler(): (raw: RawGeyserUpdate) => ParsedGeyserUpdate | null;
+    /**
+     * Create a handler that only forwards non-null results to a callback.
+     *
+     * @example
+     * ```ts
+     * grpcStream.on('data', parser.createFilteredHandler((update) => {
+     *   console.log(update.type, update.data);
+     * }));
+     * ```
+     * @since 1.0.0
+     */
+    createFilteredHandler(cb: (update: ParsedGeyserUpdate) => void): (raw: RawGeyserUpdate) => void;
+    private _filterReason;
+}
+//# sourceMappingURL=geyser-parser.d.ts.map

package/dist/cjs/grpc/parser/geyser-parser.d.ts.map

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

package/dist/cjs/grpc/parser/geyser-parser.js

@@ -0,0 +1,279 @@
+"use strict";
+/**
+ * GeyserParser — high-level entry point for dev consumption.
+ *
+ * Developers instantiate this once with their preferred config
+ * and feed every raw update from a Yellowstone gRPC `subscribe()` stream.
+ * They choose between **raw** (zero-cost pass-through) or **parsed**
+ * (fully decoded, typed, human-readable) output — or both.
+ *
+ * @module grpc/parser/geyser-parser
+ * @since 1.0.0
+ *
+ * @example
+ * ```ts
+ * import { GeyserParser } from '@oobe-protocol-labs/synapse-client-sdk';
+ *
+ * const parser = new GeyserParser({ skipVotes: true });
+ *
+ * grpcStream.on('data', (raw) => {
+ *   // Option A — get the fully parsed update
+ *   const parsed = parser.parse(raw);
+ *   if (!parsed) return; // filtered out
+ *
+ *   switch (parsed.type) {
+ *     case 'transaction':
+ *       console.log(parsed.data.signature, parsed.data.programNamesInvoked);
+ *       break;
+ *     case 'account':
+ *       console.log(parsed.data.pubkey, parsed.data.sol, 'SOL');
+ *       break;
+ *   }
+ *
+ *   // Option B — keep the raw wire format untouched
+ *   const rawMsg = parser.passthrough(raw);
+ *
+ *   // Option C — parse selectively
+ *   if (raw.update_oneof === 'transaction') {
+ *     const tx = parser.parseTransaction(raw.transaction!);
+ *     console.log(tx.signature, tx.feeSol);
+ *   }
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeyserParser = void 0;
+const eventemitter3_1 = require("eventemitter3");
+const decoder_1 = require("./decoder");
+/* ═══════════════════════════════════════════════════════════════
+ *  GeyserParser class
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * High-level Geyser gRPC subscription parser.
+ *
+ * Features:
+ * - **Raw mode** (`passthrough`) — zero-cost, returns the raw wire message
+ * - **Parsed mode** (`parse`) — fully decoded, typed output
+ * - **Event-based** — optionally emit per-type events for reactive pipelines
+ * - **Stats tracking** — counts by type, filtered, errors
+ * - **Config hot-reload** — change `skipVotes`, custom programs, etc. at runtime
+ * @since 1.0.0
+ */
+class GeyserParser extends eventemitter3_1.EventEmitter {
+    _config;
+    _stats;
+    constructor(config = {}) {
+        super();
+        this._config = {
+            skipZeroBalanceChanges: config.skipZeroBalanceChanges ?? true,
+            skipVotes: config.skipVotes ?? false,
+            customPrograms: config.customPrograms ?? {},
+            includeInnerInstructions: config.includeInnerInstructions ?? true,
+            includeTokenBalances: config.includeTokenBalances ?? true,
+        };
+        this._stats = {
+            totalReceived: 0,
+            totalParsed: 0,
+            totalFiltered: 0,
+            totalErrors: 0,
+            byType: {
+                transaction: 0,
+                account: 0,
+                slot: 0,
+                block_meta: 0,
+                entry: 0,
+                ping: 0,
+            },
+        };
+    }
+    /* ─── Configuration ──────────────────────────────────────── */
+    /** Get the current parser configuration. @since 1.0.0 */
+    get config() {
+        return this._config;
+    }
+    /** Update configuration at runtime (partial merge). @since 1.0.0 */
+    updateConfig(patch) {
+        if (patch.skipZeroBalanceChanges !== undefined)
+            this._config.skipZeroBalanceChanges = patch.skipZeroBalanceChanges;
+        if (patch.skipVotes !== undefined)
+            this._config.skipVotes = patch.skipVotes;
+        if (patch.customPrograms !== undefined)
+            this._config.customPrograms = { ...this._config.customPrograms, ...patch.customPrograms };
+        if (patch.includeInnerInstructions !== undefined)
+            this._config.includeInnerInstructions = patch.includeInnerInstructions;
+        if (patch.includeTokenBalances !== undefined)
+            this._config.includeTokenBalances = patch.includeTokenBalances;
+    }
+    /** Register additional custom program IDs → names. @since 1.0.0 */
+    addPrograms(programs) {
+        this._config.customPrograms = { ...this._config.customPrograms, ...programs };
+    }
+    /* ─── Statistics ─────────────────────────────────────────── */
+    /** Get current parser statistics. @since 1.0.0 */
+    get stats() {
+        return this._stats;
+    }
+    /** Reset all statistics counters to zero. @since 1.0.0 */
+    resetStats() {
+        this._stats = {
+            totalReceived: 0,
+            totalParsed: 0,
+            totalFiltered: 0,
+            totalErrors: 0,
+            byType: { transaction: 0, account: 0, slot: 0, block_meta: 0, entry: 0, ping: 0 },
+        };
+    }
+    /* ─── Raw mode (pass-through) ────────────────────────────── */
+    /**
+     * Return the raw update as-is — zero decoding cost.
+     *
+     * Useful when devs want the protobuf wire format for
+     * custom decoding, storage, or forwarding.
+     * @since 1.0.0
+     */
+    passthrough(raw) {
+        this._stats.totalReceived++;
+        return raw;
+    }
+    /* ─── Parsed mode ────────────────────────────────────────── */
+    /**
+     * Parse any raw Geyser update into a fully typed object.
+     *
+     * Returns `null` when the update is filtered out by config
+     * (e.g. vote transactions when `skipVotes: true`).
+     *
+     * Emits typed events for reactive consumption.
+     * @since 1.0.0
+     */
+    parse(raw) {
+        this._stats.totalReceived++;
+        try {
+            const result = (0, decoder_1.parseGeyserUpdate)(raw, this._config);
+            if (!result) {
+                this._stats.totalFiltered++;
+                this.emit('filtered', raw, this._filterReason(raw));
+                return null;
+            }
+            this._stats.totalParsed++;
+            this._stats.byType[result.type]++;
+            // Emit typed events
+            this.emit('update', result);
+            switch (result.type) {
+                case 'transaction':
+                    this.emit('transaction', result.data, result.filters);
+                    break;
+                case 'account':
+                    this.emit('account', result.data, result.filters);
+                    break;
+                case 'slot':
+                    this.emit('slot', result.data, result.filters);
+                    break;
+                case 'block_meta':
+                    this.emit('blockMeta', result.data, result.filters);
+                    break;
+                case 'entry':
+                    this.emit('entry', result.data, result.filters);
+                    break;
+            }
+            return result;
+        }
+        catch (err) {
+            this._stats.totalErrors++;
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.emit('error', error, raw);
+            return null;
+        }
+    }
+    /**
+     * Convenience: parse a batch of raw updates, returning only non-null results.
+     * @since 1.0.0
+     */
+    parseBatch(updates) {
+        const results = [];
+        for (const raw of updates) {
+            const parsed = this.parse(raw);
+            if (parsed)
+                results.push(parsed);
+        }
+        return results;
+    }
+    /* ─── Per-type parsing helpers ──────────────────────────── */
+    /**
+     * Parse a raw transaction update directly.
+     * Use when you already know the `update_oneof` type.
+     * @since 1.0.0
+     */
+    parseTransaction(raw, timestamp) {
+        return (0, decoder_1.parseTransaction)(raw, this._config, timestamp);
+    }
+    /**
+     * Parse a raw account update directly.
+     * @since 1.0.0
+     */
+    parseAccountUpdate(raw, timestamp) {
+        return (0, decoder_1.parseAccountUpdate)(raw, this._config, timestamp);
+    }
+    /**
+     * Parse a raw slot update directly.
+     * @since 1.0.0
+     */
+    parseSlotUpdate(raw, timestamp) {
+        return (0, decoder_1.parseSlotUpdate)(raw, timestamp);
+    }
+    /**
+     * Parse a raw block meta update directly.
+     * @since 1.0.0
+     */
+    parseBlockMeta(raw, timestamp) {
+        return (0, decoder_1.parseBlockMeta)(raw, timestamp);
+    }
+    /**
+     * Parse a raw entry update directly.
+     * @since 1.0.0
+     */
+    parseEntry(raw, timestamp) {
+        return (0, decoder_1.parseEntry)(raw, timestamp);
+    }
+    /* ─── Stream adapter ─────────────────────────────────────── */
+    /**
+     * Create a transform callback suitable for piping a stream.
+     *
+     * @example
+     * ```ts
+     * grpcStream.on('data', parser.createHandler());
+     * ```
+     * @since 1.0.0
+     */
+    createHandler() {
+        return (raw) => this.parse(raw);
+    }
+    /**
+     * Create a handler that only forwards non-null results to a callback.
+     *
+     * @example
+     * ```ts
+     * grpcStream.on('data', parser.createFilteredHandler((update) => {
+     *   console.log(update.type, update.data);
+     * }));
+     * ```
+     * @since 1.0.0
+     */
+    createFilteredHandler(cb) {
+        return (raw) => {
+            const parsed = this.parse(raw);
+            if (parsed)
+                cb(parsed);
+        };
+    }
+    /* ─── Internal helpers ──────────────────────────────────── */
+    _filterReason(raw) {
+        if (raw.update_oneof === 'transaction') {
+            if (this._config.skipVotes && raw.transaction?.transaction.is_vote) {
+                return 'vote_skipped';
+            }
+        }
+        return 'unknown';
+    }
+}
+exports.GeyserParser = GeyserParser;
+//# sourceMappingURL=geyser-parser.js.map

package/dist/cjs/grpc/parser/geyser-parser.js.map

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

package/dist/cjs/grpc/parser/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Geyser gRPC Subscription Parser — barrel exports.
+ *
+ * @module grpc/parser
+ * @since 1.0.0
+ */
+export type { RawBuffer, RawTimestamp, RawTransactionInfo, RawTokenBalance, RawInnerInstruction, RawCompiledInstruction, RawAccountInfo, RawSlotInfo, RawBlockMeta, RawEntry, RawGeyserUpdate, BalanceChange, TokenBalanceChange, ParsedInstruction, ParsedTransaction, ParsedAccountUpdate, ParsedSlotUpdate, ParsedBlockMeta, ParsedEntry, ParsedGeyserUpdate, GeyserParserConfig, } from './types';
+export { KNOWN_PROGRAMS, KNOWN_PROGRAMS_COUNT, SYSTEM_PROGRAMS, SPL_PROGRAMS, JUPITER_PROGRAMS, RAYDIUM_PROGRAMS, METEORA_PROGRAMS, ORCA_PROGRAMS, METAPLEX_PROGRAMS, MARINADE_PROGRAMS, OTHER_PROGRAMS, resolveProgram, resolveProgramBatch, isProgramInCategory, getProgramCategory, } from './programs';
+export { base58Encode, rawBufferToBytes, rawBufferToBase58, rawBufferToHex, rawBufferToBase64, parseTimestamp, computeBalanceChanges, computeTokenBalanceChanges, parseTransaction, parseAccountUpdate, parseSlotUpdate, parseBlockMeta, parseEntry, parseGeyserUpdate, } from './decoder';
+export { GeyserParser } from './geyser-parser';
+export type { GeyserParserEvents, GeyserParserStats } from './geyser-parser';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/grpc/parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/grpc/parser/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,SAAS,EACT,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,0BAA0B,EAC1B,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,UAAU,EACV,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/cjs/grpc/parser/index.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Geyser gRPC Subscription Parser — barrel exports.
+ *
+ * @module grpc/parser
+ * @since 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeyserParser = exports.parseGeyserUpdate = exports.parseEntry = exports.parseBlockMeta = exports.parseSlotUpdate = exports.parseAccountUpdate = exports.parseTransaction = exports.computeTokenBalanceChanges = exports.computeBalanceChanges = exports.parseTimestamp = exports.rawBufferToBase64 = exports.rawBufferToHex = exports.rawBufferToBase58 = exports.rawBufferToBytes = exports.base58Encode = exports.getProgramCategory = exports.isProgramInCategory = exports.resolveProgramBatch = exports.resolveProgram = exports.OTHER_PROGRAMS = exports.MARINADE_PROGRAMS = exports.METAPLEX_PROGRAMS = exports.ORCA_PROGRAMS = exports.METEORA_PROGRAMS = exports.RAYDIUM_PROGRAMS = exports.JUPITER_PROGRAMS = exports.SPL_PROGRAMS = exports.SYSTEM_PROGRAMS = exports.KNOWN_PROGRAMS_COUNT = exports.KNOWN_PROGRAMS = void 0;
+// ── Known programs ──────────────────────────────────────────────
+var programs_1 = require("./programs");
+Object.defineProperty(exports, "KNOWN_PROGRAMS", { enumerable: true, get: function () { return programs_1.KNOWN_PROGRAMS; } });
+Object.defineProperty(exports, "KNOWN_PROGRAMS_COUNT", { enumerable: true, get: function () { return programs_1.KNOWN_PROGRAMS_COUNT; } });
+Object.defineProperty(exports, "SYSTEM_PROGRAMS", { enumerable: true, get: function () { return programs_1.SYSTEM_PROGRAMS; } });
+Object.defineProperty(exports, "SPL_PROGRAMS", { enumerable: true, get: function () { return programs_1.SPL_PROGRAMS; } });
+Object.defineProperty(exports, "JUPITER_PROGRAMS", { enumerable: true, get: function () { return programs_1.JUPITER_PROGRAMS; } });
+Object.defineProperty(exports, "RAYDIUM_PROGRAMS", { enumerable: true, get: function () { return programs_1.RAYDIUM_PROGRAMS; } });
+Object.defineProperty(exports, "METEORA_PROGRAMS", { enumerable: true, get: function () { return programs_1.METEORA_PROGRAMS; } });
+Object.defineProperty(exports, "ORCA_PROGRAMS", { enumerable: true, get: function () { return programs_1.ORCA_PROGRAMS; } });
+Object.defineProperty(exports, "METAPLEX_PROGRAMS", { enumerable: true, get: function () { return programs_1.METAPLEX_PROGRAMS; } });
+Object.defineProperty(exports, "MARINADE_PROGRAMS", { enumerable: true, get: function () { return programs_1.MARINADE_PROGRAMS; } });
+Object.defineProperty(exports, "OTHER_PROGRAMS", { enumerable: true, get: function () { return programs_1.OTHER_PROGRAMS; } });
+Object.defineProperty(exports, "resolveProgram", { enumerable: true, get: function () { return programs_1.resolveProgram; } });
+Object.defineProperty(exports, "resolveProgramBatch", { enumerable: true, get: function () { return programs_1.resolveProgramBatch; } });
+Object.defineProperty(exports, "isProgramInCategory", { enumerable: true, get: function () { return programs_1.isProgramInCategory; } });
+Object.defineProperty(exports, "getProgramCategory", { enumerable: true, get: function () { return programs_1.getProgramCategory; } });
+// ── Decoder functions ───────────────────────────────────────────
+var decoder_1 = require("./decoder");
+Object.defineProperty(exports, "base58Encode", { enumerable: true, get: function () { return decoder_1.base58Encode; } });
+Object.defineProperty(exports, "rawBufferToBytes", { enumerable: true, get: function () { return decoder_1.rawBufferToBytes; } });
+Object.defineProperty(exports, "rawBufferToBase58", { enumerable: true, get: function () { return decoder_1.rawBufferToBase58; } });
+Object.defineProperty(exports, "rawBufferToHex", { enumerable: true, get: function () { return decoder_1.rawBufferToHex; } });
+Object.defineProperty(exports, "rawBufferToBase64", { enumerable: true, get: function () { return decoder_1.rawBufferToBase64; } });
+Object.defineProperty(exports, "parseTimestamp", { enumerable: true, get: function () { return decoder_1.parseTimestamp; } });
+Object.defineProperty(exports, "computeBalanceChanges", { enumerable: true, get: function () { return decoder_1.computeBalanceChanges; } });
+Object.defineProperty(exports, "computeTokenBalanceChanges", { enumerable: true, get: function () { return decoder_1.computeTokenBalanceChanges; } });
+Object.defineProperty(exports, "parseTransaction", { enumerable: true, get: function () { return decoder_1.parseTransaction; } });
+Object.defineProperty(exports, "parseAccountUpdate", { enumerable: true, get: function () { return decoder_1.parseAccountUpdate; } });
+Object.defineProperty(exports, "parseSlotUpdate", { enumerable: true, get: function () { return decoder_1.parseSlotUpdate; } });
+Object.defineProperty(exports, "parseBlockMeta", { enumerable: true, get: function () { return decoder_1.parseBlockMeta; } });
+Object.defineProperty(exports, "parseEntry", { enumerable: true, get: function () { return decoder_1.parseEntry; } });
+Object.defineProperty(exports, "parseGeyserUpdate", { enumerable: true, get: function () { return decoder_1.parseGeyserUpdate; } });
+// ── GeyserParser class ─────────────────────────────────────────
+var geyser_parser_1 = require("./geyser-parser");
+Object.defineProperty(exports, "GeyserParser", { enumerable: true, get: function () { return geyser_parser_1.GeyserParser; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/grpc/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/grpc/parser/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA2BH,mEAAmE;AACnE,uCAgBoB;AAflB,0GAAA,cAAc,OAAA;AACd,gHAAA,oBAAoB,OAAA;AACpB,2GAAA,eAAe,OAAA;AACf,wGAAA,YAAY,OAAA;AACZ,4GAAA,gBAAgB,OAAA;AAChB,4GAAA,gBAAgB,OAAA;AAChB,4GAAA,gBAAgB,OAAA;AAChB,yGAAA,aAAa,OAAA;AACb,6GAAA,iBAAiB,OAAA;AACjB,6GAAA,iBAAiB,OAAA;AACjB,0GAAA,cAAc,OAAA;AACd,0GAAA,cAAc,OAAA;AACd,+GAAA,mBAAmB,OAAA;AACnB,+GAAA,mBAAmB,OAAA;AACnB,8GAAA,kBAAkB,OAAA;AAGpB,mEAAmE;AACnE,qCAemB;AAdjB,uGAAA,YAAY,OAAA;AACZ,2GAAA,gBAAgB,OAAA;AAChB,4GAAA,iBAAiB,OAAA;AACjB,yGAAA,cAAc,OAAA;AACd,4GAAA,iBAAiB,OAAA;AACjB,yGAAA,cAAc,OAAA;AACd,gHAAA,qBAAqB,OAAA;AACrB,qHAAA,0BAA0B,OAAA;AAC1B,2GAAA,gBAAgB,OAAA;AAChB,6GAAA,kBAAkB,OAAA;AAClB,0GAAA,eAAe,OAAA;AACf,yGAAA,cAAc,OAAA;AACd,qGAAA,UAAU,OAAA;AACV,4GAAA,iBAAiB,OAAA;AAGnB,kEAAkE;AAClE,iDAA+C;AAAtC,6GAAA,YAAY,OAAA"}

package/dist/cjs/grpc/parser/programs.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Known Solana program registry — maps program IDs to human-readable names.
+ *
+ * Covers system programs, SPL programs, major DeFi protocols (Jupiter,
+ * Raydium, Meteora, Orca), NFT programs (Metaplex), and infrastructure.
+ *
+ * Use `resolveProgram()` for single lookups or `resolveProgramBatch()`
+ * for bulk resolution. Both support custom program registries.
+ *
+ * @module grpc/parser/programs
+ * @since 1.0.0
+ */
+declare const SYSTEM_PROGRAMS: Record<string, string>;
+declare const SPL_PROGRAMS: Record<string, string>;
+declare const JUPITER_PROGRAMS: Record<string, string>;
+declare const RAYDIUM_PROGRAMS: Record<string, string>;
+declare const METEORA_PROGRAMS: Record<string, string>;
+declare const ORCA_PROGRAMS: Record<string, string>;
+declare const METAPLEX_PROGRAMS: Record<string, string>;
+declare const MARINADE_PROGRAMS: Record<string, string>;
+declare const OTHER_PROGRAMS: Record<string, string>;
+/** Complete program registry. Frozen at module load. @since 1.0.0 */
+export declare const KNOWN_PROGRAMS: Readonly<Record<string, string>>;
+export { SYSTEM_PROGRAMS, SPL_PROGRAMS, JUPITER_PROGRAMS, RAYDIUM_PROGRAMS, METEORA_PROGRAMS, ORCA_PROGRAMS, METAPLEX_PROGRAMS, MARINADE_PROGRAMS, OTHER_PROGRAMS, };
+/**
+ * Resolve a single program ID to a human-readable name.
+ *
+ * @param programId - Base58 program ID.
+ * @param custom - Optional extra registry (takes priority over built-in).
+ * @returns The name if known, otherwise `undefined`.
+ *
+ * @example
+ * ```ts
+ * resolveProgram('JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4');
+ * // => 'Jupiter Aggregator v6'
+ * ```
+ * @since 1.0.0
+ */
+export declare function resolveProgram(programId: string, custom?: Record<string, string>): string | undefined;
+/**
+ * Resolve multiple program IDs at once.
+ *
+ * @param programIds - Array of base58 program IDs.
+ * @param custom - Optional extra registry.
+ * @returns Map of programId → name (only known programs included).
+ * @since 1.0.0
+ */
+export declare function resolveProgramBatch(programIds: readonly string[], custom?: Record<string, string>): Map<string, string>;
+/**
+ * Check if a program ID belongs to a specific protocol category.
+ *
+ * @example
+ * ```ts
+ * isProgramInCategory('JUP6...', 'jupiter'); // true
+ * isProgramInCategory('whirL...', 'raydium'); // false
+ * ```
+ * @since 1.0.0
+ */
+export declare function isProgramInCategory(programId: string, category: 'system' | 'spl' | 'jupiter' | 'raydium' | 'meteora' | 'orca' | 'metaplex' | 'marinade'): boolean;
+/**
+ * Get the protocol category of a program ID.
+ *
+ * @returns Category name or `'unknown'`.
+ * @since 1.0.0
+ */
+export declare function getProgramCategory(programId: string): 'system' | 'spl' | 'jupiter' | 'raydium' | 'meteora' | 'orca' | 'metaplex' | 'marinade' | 'other' | 'unknown';
+/** Total number of known programs. @since 1.0.0 */
+export declare const KNOWN_PROGRAMS_COUNT: number;
+//# sourceMappingURL=programs.d.ts.map

package/dist/cjs/grpc/parser/programs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"programs.d.ts","sourceRoot":"","sources":["../../../../src/grpc/parser/programs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,QAAA,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAoB3C,CAAC;AAGF,QAAA,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOxC,CAAC;AAGF,QAAA,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAY5C,CAAC;AAGF,QAAA,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQ5C,CAAC;AAGF,QAAA,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQ5C,CAAC;AAGF,QAAA,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKzC,CAAC;AAGF,QAAA,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAY7C,CAAC;AAGF,QAAA,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG7C,CAAC;AAGF,QAAA,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAyC1C,CAAC;AAMF,qEAAqE;AACrE,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAU1D,CAAC;AAMH,OAAO,EACL,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,GACf,CAAC;AAMF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,GAAG,SAAS,CAEpB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAOrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAChG,OAAO,CAYT;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,GAChB,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAW/G;AAED,mDAAmD;AACnD,eAAO,MAAM,oBAAoB,QAAqC,CAAC"}