@oobe-protocol-labs/synapse-sap-sdk 0.13.0 → 0.15.0

package/dist/esm/events/index.js

@@ -1,132 +1,44 @@
-/**
- * @module events
- * @description Decode SAP v2 events from transaction logs.
- *
- * Uses Anchor's event parser under the hood. Provides a
- * strongly-typed, filterable event stream.
- *
- * @category Events
- * @since v0.1.0
- *
- * @example
- * ```ts
- * import { EventParser } from "@synapse-sap/sdk/events";
- *
- * const events = client.events.parseLogs(txLogs);
- * for (const event of events) {
- *   if (event.name === "PaymentSettledEvent") {
- *     console.log(event.data);
- *   }
- * }
- * ```
- */
-import { EventParser as AnchorEventParser } from "@coral-xyz/anchor";
-// ═══════════════════════════════════════════════════════════════════
-//  Event Name Literals
-// ═══════════════════════════════════════════════════════════════════
-/**
- * Exhaustive list of all SAP v2 event name strings.
- *
- * @name SAP_EVENT_NAMES
- * @description Frozen array of every event discriminant emitted by the program.
- *   Useful for log filtering and exhaustive switch checks.
- * @category Events
- * @since v0.1.0
- * @see {@link SapEventName}
- */
-export const SAP_EVENT_NAMES = [
-    "RegisteredEvent",
-    "UpdatedEvent",
-    "DeactivatedEvent",
-    "ReactivatedEvent",
-    "ClosedEvent",
-    "FeedbackEvent",
-    "FeedbackUpdatedEvent",
-    "FeedbackRevokedEvent",
-    "ReputationUpdatedEvent",
-    "CallsReportedEvent",
-    "VaultInitializedEvent",
-    "SessionOpenedEvent",
-    "MemoryInscribedEvent",
-    "EpochOpenedEvent",
-    "SessionClosedEvent",
-    "VaultClosedEvent",
-    "SessionPdaClosedEvent",
-    "EpochPageClosedEvent",
-    "VaultNonceRotatedEvent",
-    "DelegateAddedEvent",
-    "DelegateRevokedEvent",
-    "ToolPublishedEvent",
-    "ToolSchemaInscribedEvent",
-    "ToolUpdatedEvent",
-    "ToolDeactivatedEvent",
-    "ToolReactivatedEvent",
-    "ToolClosedEvent",
-    "ToolInvocationReportedEvent",
-    "CheckpointCreatedEvent",
-    "EscrowCreatedEvent",
-    "EscrowDepositedEvent",
-    "PaymentSettledEvent",
-    "EscrowWithdrawnEvent",
-    "BatchSettledEvent",
-    "AttestationCreatedEvent",
-    "AttestationRevokedEvent",
-    "LedgerEntryEvent",
-    "LedgerSealedEvent",
-];
-/**
- * Typed wrapper around Anchor’s `EventParser` for SAP v2 programs.
- *
- * Extracts strongly-typed {@link ParsedEvent} objects from raw
- * transaction log lines.
- *
- * @name EventParser
- * @description Instantiate with an Anchor `Program` and call {@link EventParser.parseLogs}
- *   to decode events, or {@link EventParser.filterByName} to narrow results.
- * @category Events
- * @since v0.1.0
- *
- * @example
- * ```ts
- * const parser = new EventParser(program);
- * const events = parser.parseLogs(txLogs);
- * const settled = parser.filterByName(events, "PaymentSettledEvent");
- * ```
- */
+// ================================================================
+//  synapse-sap-sdk / src/events/index.ts
+//  All program event parsers
+// ================================================================
 export class EventParser {
-    parser;
-    /**
-     * Create a new `EventParser`.
-     *
-     * @param program - An Anchor `Program` instance whose IDL defines the events to decode.
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    program;
     constructor(program) {
-        this.parser = new AnchorEventParser(program.programId, program.coder);
+        this.program = program;
     }
-    /**
-     * Parse raw transaction log lines into typed events.
-     *
-     * @param logs - Array of log strings from a confirmed transaction.
-     * @returns {ParsedEvent[]} Decoded events found in the logs.
-     */
     parseLogs(logs) {
         const events = [];
-        const generator = this.parser.parseLogs(logs);
-        for (const event of generator) {
-            events.push(event);
+        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;
     }
-    /**
-     * Filter a list of parsed events by event name.
-     *
-     * @param events - The full array of {@link ParsedEvent} objects to filter.
-     * @param name   - The {@link SapEventName} to match against.
-     * @returns {ParsedEvent[]} Only events whose `name` matches.
-     */
-    filterByName(events, name) {
-        return events.filter((e) => e.name === name);
-    }
+}
+export function parseEventsFromLogs(logs, signature) {
+    const parser = new EventParser({});
+    return parser.parseLogs(logs).map((e) => ({ ...e, signature }));
+}
+export async function fetchTransactionEvents(connection, signature) {
+    const tx = await connection.getTransaction(signature, { commitment: "confirmed" });
+    if (!tx || !tx.meta?.logMessages)
+        return [];
+    return parseEventsFromLogs(tx.meta.logMessages, signature);
 }
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAoB,WAAW,IAAI,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAsKvF,sEAAsE;AACtE,uBAAuB;AACvB,sEAAsE;AAEtE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,iBAAiB;IACjB,cAAc;IACd,kBAAkB;IAClB,kBAAkB;IAClB,aAAa;IACb,eAAe;IACf,sBAAsB;IACtB,sBAAsB;IACtB,wBAAwB;IACxB,oBAAoB;IACpB,uBAAuB;IACvB,oBAAoB;IACpB,sBAAsB;IACtB,kBAAkB;IAClB,oBAAoB;IACpB,kBAAkB;IAClB,uBAAuB;IACvB,sBAAsB;IACtB,wBAAwB;IACxB,oBAAoB;IACpB,sBAAsB;IACtB,oBAAoB;IACpB,0BAA0B;IAC1B,kBAAkB;IAClB,sBAAsB;IACtB,sBAAsB;IACtB,iBAAiB;IACjB,6BAA6B;IAC7B,wBAAwB;IACxB,oBAAoB;IACpB,sBAAsB;IACtB,qBAAqB;IACrB,sBAAsB;IACtB,mBAAmB;IACnB,yBAAyB;IACzB,yBAAyB;IACzB,kBAAkB;IAClB,mBAAmB;CACX,CAAC;AAgCX;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,WAAW;IACL,MAAM,CAAoB;IAE3C;;;;OAIG;IACH,8DAA8D;IAC9D,YAAY,OAAqB;QAC/B,IAAI,CAAC,MAAM,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACxE,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,IAAc;QACtB,MAAM,MAAM,GAAkB,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9C,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,KAAoB,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACH,YAAY,CACV,MAAqB,EACrB,IAAO;QAEP,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC/C,CAAC;CACF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/events/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,yCAAyC;AACzC,6BAA6B;AAC7B,mEAAmE;AAqBnE,MAAM,OAAO,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;AAED,MAAM,UAAU,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;AAED,MAAM,CAAC,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/{src/idl/index.ts → dist/esm/idl/index.d.ts}

@@ -21,12 +21,6 @@
  * @category IDL
  * @since v0.1.0
  */
-
-import idlJson from "./synapse_agent_sap.json";
-
-// ── Anchor IDL shape ────────────────────────────────
-// We use `typeof idlJson` so the type stays in sync with
-// the JSON artifact automatically — no manual maintenance.
 /**
  * TypeScript type representing the Anchor IDL for the `synapse_agent_sap` program.
  *
@@ -36,9 +30,7 @@ import idlJson from "./synapse_agent_sap.json";
  * @category IDL
  * @since v0.1.0
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 export type SynapseAgentSapIDL = any;
-
 /**
  * The complete Anchor IDL object for the `synapse_agent_sap` program.
  *
@@ -49,9 +41,7 @@ export type SynapseAgentSapIDL = any;
  * @category IDL
  * @since v0.1.0
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export const SAP_IDL = idlJson as any;
-
+export declare const SAP_IDL: any;
 /**
  * Program address embedded in the IDL metadata.
  *
@@ -60,8 +50,7 @@ export const SAP_IDL = idlJson as any;
  * @category IDL
  * @since v0.1.0
  */
-export const IDL_PROGRAM_ADDRESS: string = idlJson.address;
-
+export declare const IDL_PROGRAM_ADDRESS: string;
 /**
  * IDL metadata block (name, version, spec, description).
  *
@@ -71,6 +60,11 @@ export const IDL_PROGRAM_ADDRESS: string = idlJson.address;
  * @category IDL
  * @since v0.1.0
  */
-export const IDL_METADATA = idlJson.metadata;
-
+export declare const IDL_METADATA: {
+    name: string;
+    version: string;
+    spec: string;
+    description: string;
+};
 export default SAP_IDL;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/idl/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH;;;;;;;;GAQG;AAEH,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAErC;;;;;;;;;GASG;AAEH,eAAO,MAAM,OAAO,EAAc,GAAG,CAAC;AAEtC;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAwB,CAAC;AAE3D;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY;;;;;CAAmB,CAAC;AAE7C,eAAe,OAAO,CAAC"}