@oobe-protocol-labs/synapse-sap-sdk 0.1.0

package/dist/esm/events/index.js

@@ -0,0 +1,132 @@
+/**
+ * @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");
+ * ```
+ */
+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
+    constructor(program) {
+        this.parser = new AnchorEventParser(program.programId, program.coder);
+    }
+    /**
+     * 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);
+        }
+        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);
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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"}

package/dist/esm/idl/index.js

@@ -0,0 +1,57 @@
+/**
+ * @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
+ */
+import idlJson from "./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
+export const SAP_IDL = idlJson;
+/**
+ * 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
+ */
+export const IDL_PROGRAM_ADDRESS = idlJson.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
+ */
+export const IDL_METADATA = idlJson.metadata;
+export default SAP_IDL;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/idl/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,OAAO,MAAM,0BAA0B,CAAC;AAiB/C;;;;;;;;;GASG;AACH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,OAAO,GAAG,OAAc,CAAC;AAEtC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAW,OAAO,CAAC,OAAO,CAAC;AAE3D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC;AAE7C,eAAe,OAAO,CAAC"}