@oobe-protocol-labs/synapse-sap-sdk 0.14.0 → 0.15.1

package/dist/cjs/events/geyser.js

@@ -0,0 +1,295 @@
+"use strict";
+/**
+ * @module events/geyser
+ * @description Yellowstone gRPC (Geyser) event stream for SAP v2.
+ *
+ * Drop-in alternative to the WebSocket `connection.onLogs()` pipeline.
+ * Uses Triton / Helius / any Yellowstone-compatible gRPC endpoint to
+ * receive program transaction updates with sub-second latency and
+ * automatic reconnection.
+ *
+ * @category Events
+ * @since v0.6.3
+ *
+ * @example
+ * ```ts
+ * import { GeyserEventStream } from "@oobe-protocol-labs/synapse-sap-sdk";
+ * import { EventParser }       from "@oobe-protocol-labs/synapse-sap-sdk";
+ *
+ * const stream = new GeyserEventStream({
+ *   endpoint:  "https://grpc.triton.one",
+ *   token:     process.env.GEYSER_TOKEN!,
+ *   programId: "SAPpUhsWLJG1FfkGRcXagEDMrMsWGjbky7AyhGpFETZ",
+ * });
+ *
+ * const parser = new EventParser(program);
+ *
+ * stream.on("logs", (logs, signature, slot) => {
+ *   const events = parser.parseLogs(logs);
+ *   for (const event of events) {
+ *     console.log(event.name, event.data);
+ *   }
+ * });
+ *
+ * stream.on("error", (err) => console.error("gRPC error:", err));
+ *
+ * await stream.connect();
+ * // ... later
+ * await stream.disconnect();
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeyserEventStream = void 0;
+const events_1 = require("events");
+// ═══════════════════════════════════════════════════════════════════
+//  Constants
+// ═══════════════════════════════════════════════════════════════════
+const SAP_PROGRAM_ID = "SAPpUhsWLJG1FfkGRcXagEDMrMsWGjbky7AyhGpFETZ";
+const COMMITMENT_MAP = {
+    processed: 0,
+    confirmed: 1,
+    finalized: 2,
+};
+// ═══════════════════════════════════════════════════════════════════
+//  GeyserEventStream
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Yellowstone gRPC event stream for SAP v2 programs.
+ *
+ * Wraps `@triton-one/yellowstone-grpc` and emits parsed log lines
+ * compatible with the existing {@link EventParser}.
+ *
+ * @name GeyserEventStream
+ * @category Events
+ * @since v0.6.3
+ *
+ * @example
+ * ```ts
+ * const stream = new GeyserEventStream({
+ *   endpoint: "https://grpc.triton.one",
+ *   token:    process.env.GEYSER_TOKEN!,
+ * });
+ *
+ * stream.on("logs", (logs, sig, slot) => {
+ *   const events = parser.parseLogs(logs);
+ *   events.forEach(e => db.insertEvent(e));
+ * });
+ *
+ * await stream.connect();
+ * ```
+ */
+class GeyserEventStream extends events_1.EventEmitter {
+    config;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    client = null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    stream = null;
+    reconnectAttempts = 0;
+    _connected = false;
+    _stopped = false;
+    constructor(config) {
+        super();
+        this.config = {
+            endpoint: config.endpoint,
+            token: config.token,
+            programId: config.programId ?? SAP_PROGRAM_ID,
+            commitment: config.commitment ?? "confirmed",
+            autoReconnect: config.autoReconnect ?? true,
+            reconnectDelayMs: config.reconnectDelayMs ?? 3_000,
+            maxReconnectAttempts: config.maxReconnectAttempts ?? 0,
+            includeFailedTxs: config.includeFailedTxs ?? false,
+        };
+    }
+    /** Whether the gRPC stream is currently connected. */
+    get connected() {
+        return this._connected;
+    }
+    /**
+     * Connect to the Yellowstone gRPC endpoint and start streaming.
+     *
+     * @throws If `@triton-one/yellowstone-grpc` is not installed.
+     */
+    async connect() {
+        this._stopped = false;
+        this.reconnectAttempts = 0;
+        // Dynamic import — yellowstone is an optional peer dependency
+        let YellowstoneClient;
+        try {
+            const mod = await Promise.resolve().then(() => __importStar(require("@triton-one/yellowstone-grpc")));
+            YellowstoneClient = mod.default ?? mod.Client;
+        }
+        catch {
+            throw new Error("Missing dependency: @triton-one/yellowstone-grpc\n" +
+                "Install it with: npm i @triton-one/yellowstone-grpc");
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.client = new YellowstoneClient(this.config.endpoint, this.config.token, undefined);
+        await this.subscribe();
+    }
+    /**
+     * Disconnect from the gRPC stream and stop reconnection.
+     */
+    async disconnect() {
+        this._stopped = true;
+        this._connected = false;
+        if (this.stream) {
+            try {
+                this.stream.cancel?.();
+                this.stream = null;
+            }
+            catch {
+                // ignore cancel errors
+            }
+        }
+        this.emit("disconnected", "manual");
+    }
+    // ─── Internal ──────────────────────────────────────
+    async subscribe() {
+        if (!this.client || this._stopped)
+            return;
+        try {
+            this.stream = await this.client.subscribe();
+        }
+        catch (err) {
+            this.emit("error", err instanceof Error ? err : new Error(String(err)));
+            await this.maybeReconnect();
+            return;
+        }
+        // Build the subscription request
+        const request = {
+            accounts: {},
+            slots: {},
+            transactions: {
+                sap: {
+                    vote: false,
+                    failed: this.config.includeFailedTxs,
+                    signature: undefined,
+                    accountInclude: [this.config.programId],
+                    accountExclude: [],
+                    accountRequired: [],
+                },
+            },
+            transactionsStatus: {},
+            blocks: {},
+            blocksMeta: {},
+            entry: {},
+            commitment: COMMITMENT_MAP[this.config.commitment] ?? 1,
+            accountsDataSlice: [],
+            ping: { id: 1 },
+        };
+        // Send subscription
+        try {
+            await new Promise((resolve, reject) => {
+                this.stream.write(request, (err) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+        }
+        catch (err) {
+            this.emit("error", err instanceof Error ? err : new Error(String(err)));
+            await this.maybeReconnect();
+            return;
+        }
+        this._connected = true;
+        this.reconnectAttempts = 0;
+        this.emit("connected");
+        // Listen for data
+        this.stream.on("data", (data) => {
+            try {
+                this.handleMessage(data);
+            }
+            catch (err) {
+                this.emit("error", err instanceof Error ? err : new Error(String(err)));
+            }
+        });
+        this.stream.on("error", (err) => {
+            this.emit("error", err);
+        });
+        this.stream.on("end", () => {
+            this._connected = false;
+            this.emit("disconnected", "stream-end");
+            this.maybeReconnect();
+        });
+        this.stream.on("close", () => {
+            this._connected = false;
+            this.emit("disconnected", "stream-close");
+            this.maybeReconnect();
+        });
+    }
+    handleMessage(data) {
+        // Respond to pings to keep the stream alive
+        if (data.ping) {
+            this.stream?.write({ ping: { id: data.ping.id } }, () => { });
+            return;
+        }
+        // Extract transaction data
+        const tx = data.transaction;
+        if (!tx?.transaction?.transaction)
+            return;
+        const meta = tx.transaction.meta;
+        if (!meta)
+            return;
+        // Extract log messages from the transaction meta
+        const logs = meta.logMessages ?? [];
+        if (logs.length === 0)
+            return;
+        const signature = tx.transaction.signature
+            ? Buffer.from(tx.transaction.signature).toString("base64")
+            : "unknown";
+        const slot = Number(tx.slot ?? 0);
+        this.emit("logs", logs, signature, slot);
+    }
+    async maybeReconnect() {
+        if (this._stopped || !this.config.autoReconnect)
+            return;
+        const max = this.config.maxReconnectAttempts;
+        if (max > 0 && this.reconnectAttempts >= max) {
+            this.emit("error", new Error(`Max reconnect attempts (${max}) exceeded`));
+            return;
+        }
+        this.reconnectAttempts++;
+        this.emit("reconnecting", this.reconnectAttempts);
+        await new Promise((r) => setTimeout(r, this.config.reconnectDelayMs));
+        if (!this._stopped) {
+            await this.subscribe();
+        }
+    }
+}
+exports.GeyserEventStream = GeyserEventStream;
+//# sourceMappingURL=geyser.js.map

package/dist/cjs/events/geyser.js.map

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

package/dist/cjs/events/index.js

@@ -4,38 +4,44 @@
 //  All program event parsers
 // ================================================================
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventParser = void 0;
 exports.parseEventsFromLogs = parseEventsFromLogs;
 exports.fetchTransactionEvents = fetchTransactionEvents;
-const EVENT_DISCRIMS = {
-    EscrowCreated: new Uint8Array([0]),
-    SettlementFiled: new Uint8Array([0]),
-    SettlementFinalized: new Uint8Array([0]),
-    DisputeFiled: new Uint8Array([0]),
-    DisputeResolved: new Uint8Array([0]),
-    StakeEvent: new Uint8Array([0]),
-    SubscriptionEvent: new Uint8Array([0]),
-};
-/** Parse program logs for emitted events */
-function parseEventsFromLogs(logs, signature) {
-    const events = [];
-    for (const log of logs) {
-        if (!log.includes("Program log:"))
-            continue;
-        const payload = log.replace(/^Program log:\s*/, "");
-        // Anchor event format: "Event <name> <base64encoded>"
-        for (const [name, _discrim] of Object.entries(EVENT_DISCRIMS)) {
-            if (payload.startsWith(`Event ${name} `)) {
-                const b64 = payload.slice(`Event ${name} `.length);
-                // TODO: full Borsh deserialization for each event schema
-                events.push({ name, data: { raw: b64 }, signature, slot: 0 });
+class EventParser {
+    program;
+    constructor(program) {
+        this.program = program;
+    }
+    parseLogs(logs) {
+        const events = [];
+        for (const log of logs) {
+            if (!log.includes("Program log:"))
+                continue;
+            const payload = log.replace(/^Program log:\s*/, "");
+            for (const name of [
+                "EscrowCreated",
+                "SettlementFiled",
+                "SettlementFinalized",
+                "DisputeFiled",
+                "DisputeResolved",
+                "StakeEvent",
+                "SubscriptionEvent",
+            ]) {
+                if (payload.startsWith(`Event ${name} `)) {
+                    const b64 = payload.slice(`Event ${name} `.length);
+                    events.push({ name, data: { raw: b64 }, signature: "", slot: 0 });
+                }
             }
         }
+        return events;
     }
-    return events;
 }
-/** Fetch + parse events for a given transaction */
-async function fetchTransactionEvents(connection, // Connection
-signature) {
+exports.EventParser = EventParser;
+function parseEventsFromLogs(logs, signature) {
+    const parser = new EventParser({});
+    return parser.parseLogs(logs).map((e) => ({ ...e, signature }));
+}
+async function fetchTransactionEvents(connection, signature) {
     const tx = await connection.getTransaction(signature, { commitment: "confirmed" });
     if (!tx || !tx.meta?.logMessages)
         return [];

package/dist/cjs/events/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/events/index.ts"],"names":[],"mappings":";AAAA,mEAAmE;AACnE,yCAAyC;AACzC,6BAA6B;AAC7B,mEAAmE;;AAsBnE,kDAkBC;AAGD,wDAOC;AAvCD,MAAM,cAAc,GAA+B;IACjD,aAAa,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,eAAe,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,mBAAmB,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,YAAY,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,eAAe,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,UAAU,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,iBAAiB,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;CACvC,CAAC;AAEF,4CAA4C;AAC5C,SAAgB,mBAAmB,CACjC,IAAc,EACd,SAAiB;IAEjB,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC;YAAE,SAAS;QAC5C,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;QACpD,sDAAsD;QACtD,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YAC9D,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,CAAC,EAAE,CAAC;gBACzC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;gBACnD,yDAAyD;gBACzD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mDAAmD;AAC5C,KAAK,UAAU,sBAAsB,CAC1C,UAAe,EAAE,aAAa;AAC9B,SAA+B;IAE/B,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,cAAc,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW;QAAE,OAAO,EAAE,CAAC;IAC5C,OAAO,mBAAmB,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/events/index.ts"],"names":[],"mappings":";AAAA,mEAAmE;AACnE,yCAAyC;AACzC,6BAA6B;AAC7B,mEAAmE;;;AAgDnE,kDAMC;AAED,wDAOC;AA1CD,MAAa,WAAW;IACF;IAApB,YAAoB,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAExC,SAAS,CAAC,IAAc;QACtB,MAAM,MAAM,GAAkB,EAAE,CAAC;QACjC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAAE,SAAS;YAC5C,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;YACpD,KAAK,MAAM,IAAI,IAAI;gBACjB,eAAe;gBACf,iBAAiB;gBACjB,qBAAqB;gBACrB,cAAc;gBACd,iBAAiB;gBACjB,YAAY;gBACZ,mBAAmB;aACF,EAAE,CAAC;gBACpB,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,CAAC,EAAE,CAAC;oBACzC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;oBACnD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;gBACpE,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAzBD,kCAyBC;AAED,SAAgB,mBAAmB,CACjC,IAAc,EACd,SAA+B;IAE/B,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,EAAa,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;AAClE,CAAC;AAEM,KAAK,UAAU,sBAAsB,CAC1C,UAAe,EACf,SAA+B;IAE/B,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,cAAc,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW;QAAE,OAAO,EAAE,CAAC;IAC5C,OAAO,mBAAmB,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AAC7D,CAAC"}

package/dist/cjs/idl/index.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * @module idl
+ * @description Embedded IDL for the SAP v2 program.
+ *
+ * The JSON artifact is bundled with the SDK so it works as a
+ * standalone package without needing the program workspace.
+ *
+ * ### Updating the IDL
+ *
+ * After rebuilding the Anchor program, run:
+ * ```sh
+ * yarn sync-idl            # copies from ../target/idl/
+ * ```
+ * or manually copy the file into `src/idl/synapse_agent_sap.json`.
+ *
+ * @example
+ * ```ts
+ * import { SAP_IDL, type SynapseAgentSapIDL } from "@synapse-sap/sdk/idl";
+ * ```
+ *
+ * @category IDL
+ * @since v0.1.0
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IDL_METADATA = exports.IDL_PROGRAM_ADDRESS = exports.SAP_IDL = void 0;
+const synapse_agent_sap_json_1 = __importDefault(require("./synapse_agent_sap.json"));
+/**
+ * The complete Anchor IDL object for the `synapse_agent_sap` program.
+ *
+ * @name SAP_IDL
+ * @description Pre-loaded IDL JSON artifact bundled with the SDK.
+ *   Can be passed directly to `new anchor.Program()` or used for
+ *   instruction introspection.
+ * @category IDL
+ * @since v0.1.0
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+exports.SAP_IDL = synapse_agent_sap_json_1.default;
+/**
+ * Program address embedded in the IDL metadata.
+ *
+ * @name IDL_PROGRAM_ADDRESS
+ * @description The deployed program address as declared in the Anchor IDL.
+ * @category IDL
+ * @since v0.1.0
+ */
+exports.IDL_PROGRAM_ADDRESS = synapse_agent_sap_json_1.default.address;
+/**
+ * IDL metadata block (name, version, spec, description).
+ *
+ * @name IDL_METADATA
+ * @description Anchor IDL metadata containing program name, version string,
+ *   spec version, and human-readable description.
+ * @category IDL
+ * @since v0.1.0
+ */
+exports.IDL_METADATA = synapse_agent_sap_json_1.default.metadata;
+exports.default = exports.SAP_IDL;
+//# sourceMappingURL=index.js.map

package/dist/cjs/idl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/idl/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;;;;AAEH,sFAA+C;AAiB/C;;;;;;;;;GASG;AACH,8DAA8D;AACjD,QAAA,OAAO,GAAG,gCAAc,CAAC;AAEtC;;;;;;;GAOG;AACU,QAAA,mBAAmB,GAAW,gCAAO,CAAC,OAAO,CAAC;AAE3D;;;;;;;;GAQG;AACU,QAAA,YAAY,GAAG,gCAAO,CAAC,QAAQ,CAAC;AAE7C,kBAAe,eAAO,CAAC"}