@oobe-protocol-labs/synapse-sap-sdk 0.4.1 → 0.4.2

package/dist/cjs/core/client.js

@@ -40,6 +40,7 @@ const escrow_1 = require("../modules/escrow");
 const attestation_1 = require("../modules/attestation");
 const ledger_1 = require("../modules/ledger");
 const events_1 = require("../events");
+const client_1 = require("../parser/client");
 const discovery_1 = require("../registries/discovery");
 const x402_1 = require("../registries/x402");
 const session_1 = require("../registries/session");
@@ -111,6 +112,8 @@ class SapClient {
     #attestation;
     #ledger;
     #events;
+    // ── Lazy parser singleton ─────────────────────
+    #parser;
     // ── Lazy registry singletons ──────────────────────
     #discovery;
     #x402;
@@ -295,6 +298,26 @@ class SapClient {
     get events() {
         return (this.#events ??= new events_1.EventParser(this.program));
     }
+    /**
+     * @name parser
+     * @description Transaction parser: decode instruction names, arguments,
+     * accounts, inner CPI calls, and protocol events from raw transaction
+     * responses. Designed for indexers and explorers.
+     * @returns {TransactionParser} The lazily-instantiated `TransactionParser` singleton.
+     * @category Modules
+     * @since v0.5.0
+     * @see {@link TransactionParser}
+     *
+     * @example
+     * ```ts
+     * const tx = await connection.getTransaction(sig, { ... });
+     * const parsed = client.parser.parseTransaction(tx);
+     * console.log(parsed?.instructions.map(i => i.name));
+     * ```
+     */
+    get parser() {
+        return (this.#parser ??= new client_1.TransactionParser(this.program));
+    }
     // ═════════════════════════════════════════════
     //  Registry Accessors (high-level abstractions)
     // ═════════════════════════════════════════════

package/dist/cjs/core/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/core/client.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;;;;;AAEH,8CAAiE;AAEjE,4CAA8C;AAC9C,4CAA+C;AAC/C,kDAAqD;AACrD,kDAAqD;AACrD,4CAA+C;AAC/C,4CAA+C;AAC/C,8CAAiD;AACjD,wDAA2D;AAC3D,8CAAiD;AACjD,sCAAwC;AACxC,uDAA4D;AAC5D,6CAAkD;AAClD,mDAAuD;AACvD,mDAAqD;AAErD,oEAAoE;AACpE,2FAAgD;AAMhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAa,SAAS;IACpB;;;;;;;OAOG;IACM,OAAO,CAAa;IAE7B;;;;;;;;OAQG;IACM,YAAY,CAAY;IAEjC,qDAAqD;IACrD,MAAM,CAAe;IACrB,SAAS,CAAkB;IAC3B,SAAS,CAAkB;IAC3B,MAAM,CAAe;IACrB,MAAM,CAAe;IACrB,OAAO,CAAgB;IACvB,YAAY,CAAqB;IACjC,OAAO,CAAgB;IACvB,OAAO,CAAe;IAEtB,qDAAqD;IACrD,UAAU,CAAqB;IAC/B,KAAK,CAAgB;IACrB,QAAQ,CAAkB;IAE1B,YAAoB,OAAmB;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,YAAY,GAAI,OAAO,CAAC,QAA2B,CAAC,MAAM,CAAC,SAAS,CAAC;IAC5E,CAAC;IAED,gDAAgD;IAChD,mBAAmB;IACnB,gDAAgD;IAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,MAAM,CAAC,IAAI,CACT,QAAwB,EACxB,YAAuB,0BAAc;QAErC,8DAA8D;QAC9D,MAAM,OAAO,GAAG,IAAI,gBAAO,CAAC,gCAAU,EAAE,QAAQ,CAAC,CAAC;QAClD,qCAAqC;QACrC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,0BAAc,CAAC,EAAE,CAAC;YACtC,8DAA8D;YAC7D,OAAe,CAAC,SAAS,GAAG,SAAS,CAAC;QACzC,CAAC;QACD,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,WAAW,CAAC,OAAmB;QACpC,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,gDAAgD;IAChD,sCAAsC;IACtC,gDAAgD;IAEhD;;;;;;;;OAQG;IACH,IAAI,KAAK;QACP,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,mBAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,QAAQ;QACV,OAAO,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI,yBAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,QAAQ;QACV,OAAO,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI,yBAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,KAAK;QACP,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,mBAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,KAAK;QACP,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,mBAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,MAAM;QACR,OAAO,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,qBAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,WAAW;QACb,OAAO,CAAC,IAAI,CAAC,YAAY,KAAK,IAAI,+BAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,MAAM;QACR,OAAO,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,qBAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,MAAM;QACR,OAAO,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,oBAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,gDAAgD;IAChD,gDAAgD;IAChD,gDAAgD;IAEhD;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,SAAS;QACX,OAAO,CAAC,IAAI,CAAC,UAAU,KAAK,IAAI,6BAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,IAAI;QACN,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,mBAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,OAAO;QACT,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,wBAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,sBAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;CACF;AA1UD,8BA0UC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/core/client.ts"],"names":[],"mappings":"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"}

package/dist/cjs/index.js

@@ -16,6 +16,7 @@
  * | `modules/`        | Low-level per-domain instruction wrappers     |
  * | `registries/`     | High-level abstractions (discovery, x402, …)  |
  * | `plugin/`         | SynapseAgentKit adapter (52 tools)            |
+ * | `parser/`         | Transaction decode, instruction + event parse |
  * | `idl/`            | Embedded Anchor IDL                           |
  *
  * @example
@@ -45,7 +46,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SapRpcError = exports.SapValidationError = exports.SapError = exports.serializeValue = exports.serializeAccount = exports.assert = exports.hashToArray = exports.sha256 = exports.deriveLedgerPage = exports.deriveLedger = exports.deriveAttestation = exports.deriveEscrow = exports.deriveTool = exports.deriveCheckpoint = exports.deriveVaultDelegate = exports.deriveEpochPage = exports.deriveSession = exports.deriveVault = exports.deriveToolCategoryIndex = exports.deriveProtocolIndex = exports.deriveCapabilityIndex = exports.deriveFeedback = exports.deriveAgentStats = exports.deriveAgent = exports.deriveGlobalRegistry = exports.IDL_METADATA = exports.IDL_PROGRAM_ADDRESS = exports.SAP_IDL = exports.HTTP_METHOD_VALUES = exports.TOOL_CATEGORY_VALUES = exports.VAULT_PROTOCOL_VERSION = exports.AGENT_VERSION = exports.LIMITS = exports.SEEDS = exports.LOCALNET_SAP_PROGRAM_ID = exports.DEVNET_SAP_PROGRAM_ID = exports.MAINNET_SAP_PROGRAM_ID = exports.SAP_PROGRAM_ID = exports.SAP_PROGRAM_ADDRESS = exports.CompressionType = exports.SchemaType = exports.DelegatePermission = exports.ToolCategory = exports.ToolHttpMethod = exports.SettlementMode = exports.PluginType = exports.TokenType = exports.KeypairWallet = exports.SapConnection = exports.SapClient = void 0;
-exports.AgentBuilder = exports.SessionManager = exports.X402Registry = exports.DiscoveryRegistry = exports.SAP_TABLE_MAP = exports.SapSyncEngine = exports.SapPostgres = exports.SAP_PROTOCOLS = exports.SAPPlugin = exports.createSAPPlugin = exports.BaseModule = exports.LedgerModule = exports.AttestationModule = exports.EscrowModule = exports.VaultModule = exports.ToolsModule = exports.IndexingModule = exports.FeedbackModule = exports.AgentModule = exports.SAP_EVENT_NAMES = exports.EventParser = exports.SapPermissionError = exports.SapTimeoutError = exports.SapAccountNotFoundError = void 0;
+exports.AgentBuilder = exports.SessionManager = exports.X402Registry = exports.DiscoveryRegistry = exports.TransactionParser = exports.extractAccountKeys = exports.filterSapInnerInstructions = exports.decodeInnerInstructions = exports.parseSapTransactionBatch = exports.parseSapTransactionComplete = exports.containsSapInstruction = exports.parseSapInstructionNamesFromList = exports.parseSapInstructionsFromList = exports.parseSapInstructionNamesFromTransaction = exports.parseSapInstructionsFromTransaction = exports.SAP_TABLE_MAP = exports.SapSyncEngine = exports.SapPostgres = exports.SAP_PROTOCOLS = exports.SAPPlugin = exports.createSAPPlugin = exports.BaseModule = exports.LedgerModule = exports.AttestationModule = exports.EscrowModule = exports.VaultModule = exports.ToolsModule = exports.IndexingModule = exports.FeedbackModule = exports.AgentModule = exports.SAP_EVENT_NAMES = exports.EventParser = exports.SapPermissionError = exports.SapTimeoutError = exports.SapAccountNotFoundError = void 0;
 // ── Core ─────────────────────────────────────────────
 var core_1 = require("./core");
 Object.defineProperty(exports, "SapClient", { enumerable: true, get: function () { return core_1.SapClient; } });
@@ -139,6 +140,19 @@ var postgres_1 = require("./postgres");
 Object.defineProperty(exports, "SapPostgres", { enumerable: true, get: function () { return postgres_1.SapPostgres; } });
 Object.defineProperty(exports, "SapSyncEngine", { enumerable: true, get: function () { return postgres_1.SapSyncEngine; } });
 Object.defineProperty(exports, "SAP_TABLE_MAP", { enumerable: true, get: function () { return postgres_1.SAP_TABLE_MAP; } });
+// ── Parser (transaction decode + instruction + events) ─
+var parser_1 = require("./parser");
+Object.defineProperty(exports, "parseSapInstructionsFromTransaction", { enumerable: true, get: function () { return parser_1.parseSapInstructionsFromTransaction; } });
+Object.defineProperty(exports, "parseSapInstructionNamesFromTransaction", { enumerable: true, get: function () { return parser_1.parseSapInstructionNamesFromTransaction; } });
+Object.defineProperty(exports, "parseSapInstructionsFromList", { enumerable: true, get: function () { return parser_1.parseSapInstructionsFromList; } });
+Object.defineProperty(exports, "parseSapInstructionNamesFromList", { enumerable: true, get: function () { return parser_1.parseSapInstructionNamesFromList; } });
+Object.defineProperty(exports, "containsSapInstruction", { enumerable: true, get: function () { return parser_1.containsSapInstruction; } });
+Object.defineProperty(exports, "parseSapTransactionComplete", { enumerable: true, get: function () { return parser_1.parseSapTransactionComplete; } });
+Object.defineProperty(exports, "parseSapTransactionBatch", { enumerable: true, get: function () { return parser_1.parseSapTransactionBatch; } });
+Object.defineProperty(exports, "decodeInnerInstructions", { enumerable: true, get: function () { return parser_1.decodeInnerInstructions; } });
+Object.defineProperty(exports, "filterSapInnerInstructions", { enumerable: true, get: function () { return parser_1.filterSapInnerInstructions; } });
+Object.defineProperty(exports, "extractAccountKeys", { enumerable: true, get: function () { return parser_1.extractAccountKeys; } });
+Object.defineProperty(exports, "TransactionParser", { enumerable: true, get: function () { return parser_1.TransactionParser; } });
 // ── Registries (high-level developer abstractions) ────
 var index_4 = require("./registries/index");
 Object.defineProperty(exports, "DiscoveryRegistry", { enumerable: true, get: function () { return index_4.DiscoveryRegistry; } });

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;;;;AAEH,wDAAwD;AACxD,+BAAiE;AAAxD,iGAAA,SAAS,OAAA;AAAE,qGAAA,aAAa,OAAA;AAAE,qGAAA,aAAa,OAAA;AAoDhD,iCASiB;AARf,kGAAA,SAAS,OAAA;AACT,mGAAA,UAAU,OAAA;AACV,uGAAA,cAAc,OAAA;AACd,uGAAA,cAAc,OAAA;AACd,qGAAA,YAAY,OAAA;AACZ,2GAAA,kBAAkB,OAAA;AAClB,mGAAA,UAAU,OAAA;AACV,wGAAA,eAAe,OAAA;AAGjB,wDAAwD;AACxD,yCAYqB;AAXnB,gHAAA,mBAAmB,OAAA;AACnB,2GAAA,cAAc,OAAA;AACd,mHAAA,sBAAsB,OAAA;AACtB,kHAAA,qBAAqB,OAAA;AACrB,oHAAA,uBAAuB,OAAA;AACvB,kGAAA,KAAK,OAAA;AACL,mGAAA,MAAM,OAAA;AACN,0GAAA,aAAa,OAAA;AACb,mHAAA,sBAAsB,OAAA;AACtB,iHAAA,oBAAoB,OAAA;AACpB,+GAAA,kBAAkB,OAAA;AAGpB,wDAAwD;AACxD,qCAAyE;AAAhE,gGAAA,OAAO,OAAA;AAAE,4GAAA,mBAAmB,OAAA;AAAE,qGAAA,YAAY,OAAA;AAGnD,wDAAwD;AACxD,6BAkBe;AAjBb,2GAAA,oBAAoB,OAAA;AACpB,kGAAA,WAAW,OAAA;AACX,uGAAA,gBAAgB,OAAA;AAChB,qGAAA,cAAc,OAAA;AACd,4GAAA,qBAAqB,OAAA;AACrB,0GAAA,mBAAmB,OAAA;AACnB,8GAAA,uBAAuB,OAAA;AACvB,kGAAA,WAAW,OAAA;AACX,oGAAA,aAAa,OAAA;AACb,sGAAA,eAAe,OAAA;AACf,0GAAA,mBAAmB,OAAA;AACnB,uGAAA,gBAAgB,OAAA;AAChB,iGAAA,UAAU,OAAA;AACV,mGAAA,YAAY,OAAA;AACZ,wGAAA,iBAAiB,OAAA;AACjB,mGAAA,YAAY,OAAA;AACZ,uGAAA,gBAAgB,OAAA;AAGlB,wDAAwD;AACxD,iCAAsD;AAA7C,+FAAA,MAAM,OAAA;AAAE,oGAAA,WAAW,OAAA;AAAE,+FAAA,MAAM,OAAA;AACpC,iCAA2D;AAAlD,yGAAA,gBAAgB,OAAA;AAAE,uGAAA,cAAc,OAAA;AAEzC,wDAAwD;AACxD,mCAOkB;AANhB,kGAAA,QAAQ,OAAA;AACR,4GAAA,kBAAkB,OAAA;AAClB,qGAAA,WAAW,OAAA;AACX,iHAAA,uBAAuB,OAAA;AACvB,yGAAA,eAAe,OAAA;AACf,4GAAA,kBAAkB,OAAA;AAGpB,wDAAwD;AACxD,mCAAwD;AAA/C,qGAAA,WAAW,OAAA;AAAE,yGAAA,eAAe,OAAA;AAarC,wDAAwD;AACxD,yCAUyB;AATvB,oGAAA,WAAW,OAAA;AACX,uGAAA,cAAc,OAAA;AACd,uGAAA,cAAc,OAAA;AACd,oGAAA,WAAW,OAAA;AACX,oGAAA,WAAW,OAAA;AACX,qGAAA,YAAY,OAAA;AACZ,0GAAA,iBAAiB,OAAA;AACjB,qGAAA,YAAY,OAAA;AACZ,mGAAA,UAAU,OAAA;AAIZ,wDAAwD;AACxD,wCAA4D;AAAnD,wGAAA,eAAe,OAAA;AAAE,kGAAA,SAAS,OAAA;AAYnC,gDAAmD;AAA1C,0GAAA,aAAa,OAAA;AAEtB,4DAA4D;AAC5D,uCAAuE;AAA9D,uGAAA,WAAW,OAAA;AAAE,yGAAA,aAAa,OAAA;AAAE,yGAAA,aAAa,OAAA;AAelD,0DAA0D;AAC1D,mCAYkB;AAXhB,6HAAA,mCAAmC,OAAA;AACnC,iIAAA,uCAAuC,OAAA;AACvC,sHAAA,4BAA4B,OAAA;AAC5B,0HAAA,gCAAgC,OAAA;AAChC,gHAAA,sBAAsB,OAAA;AACtB,qHAAA,2BAA2B,OAAA;AAC3B,kHAAA,wBAAwB,OAAA;AACxB,iHAAA,uBAAuB,OAAA;AACvB,oHAAA,0BAA0B,OAAA;AAC1B,4GAAA,kBAAkB,OAAA;AAClB,2GAAA,iBAAiB,OAAA;AAYnB,yDAAyD;AACzD,4CAK4B;AAJ1B,0GAAA,iBAAiB,OAAA;AACjB,qGAAA,YAAY,OAAA;AACZ,uGAAA,cAAc,OAAA;AACd,qGAAA,YAAY,OAAA"}

package/dist/cjs/parser/client.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * @module parser/client
+ * @description Object-oriented wrapper for transaction parsing.
+ *
+ * Binds the Anchor `Program` reference so callers do not need to
+ * pass it on every call. Designed as a lazy singleton accessible
+ * from {@link SapClient.parser}.
+ *
+ * @category Parser
+ * @since v0.5.0
+ *
+ * @example
+ * ```ts
+ * const client = SapClient.from(provider);
+ *
+ * // Parse a full transaction
+ * const parsed = client.parser.parseTransaction(txResponse);
+ *
+ * // Quick instruction names
+ * const names = client.parser.instructionNames(txResponse);
+ *
+ * // From pre-built instructions
+ * const decoded = client.parser.fromInstructions(ixList);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionParser = void 0;
+const transaction_1 = require("./transaction");
+const instructions_1 = require("./instructions");
+const complete_1 = require("./complete");
+const inner_1 = require("./inner");
+/**
+ * Stateful transaction parser bound to a specific Anchor `Program`.
+ *
+ * Stores the program reference, instruction coder, and program ID
+ * internally so that repeated parse calls require only the
+ * transaction data as input.
+ *
+ * @name TransactionParser
+ * @category Parser
+ * @since v0.5.0
+ */
+class TransactionParser {
+    program;
+    coder;
+    programId;
+    /**
+     * Create a new TransactionParser.
+     *
+     * @param program - An Anchor `Program` built from the SAP IDL.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    constructor(program) {
+        this.program = program;
+        this.coder = program.coder.instruction;
+        this.programId = program.programId;
+    }
+    /**
+     * Full parse: instructions + inner calls + events.
+     *
+     * @param tx - Raw transaction response from `connection.getTransaction`.
+     * @param options - Optional filters for instructions, events, and inner calls.
+     * @param addressLookupTables - Resolved lookup tables for v0 transactions.
+     * @returns Complete parsed transaction, or `null` if the input is nullish.
+     *
+     * @since v0.5.0
+     */
+    parseTransaction(tx, options, addressLookupTables) {
+        return (0, complete_1.parseSapTransactionComplete)(tx, this.program, this.programId, options, addressLookupTables);
+    }
+    /**
+     * Parse a batch of transactions.
+     *
+     * @param txs - Array of transaction responses (may contain `null` entries).
+     * @param options - Optional parse filters.
+     * @param addressLookupTables - Resolved lookup tables for v0 transactions.
+     * @returns Non-null parsed transactions.
+     *
+     * @since v0.5.0
+     */
+    parseBatch(txs, options, addressLookupTables) {
+        return (0, complete_1.parseSapTransactionBatch)(txs, this.program, this.programId, options, addressLookupTables);
+    }
+    /**
+     * Decode top-level SAP instructions from a transaction response.
+     *
+     * @param tx - Raw transaction response.
+     * @param addressLookupTables - Resolved lookup tables for v0 transactions.
+     * @returns Decoded SAP instructions.
+     *
+     * @since v0.5.0
+     */
+    instructionsFromTransaction(tx, addressLookupTables) {
+        return (0, transaction_1.parseSapInstructionsFromTransaction)(tx, this.coder, this.programId, addressLookupTables);
+    }
+    /**
+     * Extract only the instruction names from a transaction response.
+     *
+     * @param tx - Raw transaction response.
+     * @param addressLookupTables - Resolved lookup tables for v0 transactions.
+     * @returns Instruction name strings.
+     *
+     * @since v0.5.0
+     */
+    instructionNames(tx, addressLookupTables) {
+        return this.instructionsFromTransaction(tx, addressLookupTables).map((ix) => ix.name);
+    }
+    /**
+     * Decode SAP instructions from a pre-built instruction array.
+     *
+     * @param instructions - The instruction list to decode.
+     * @returns Decoded SAP instructions.
+     *
+     * @since v0.5.0
+     */
+    fromInstructions(instructions) {
+        return (0, instructions_1.parseSapInstructionsFromList)(instructions, this.coder, this.programId);
+    }
+    /**
+     * Check if any instruction in the list targets the SAP program.
+     *
+     * @param instructions - The instruction array to inspect.
+     * @returns `true` if at least one instruction targets SAP.
+     *
+     * @since v0.5.0
+     */
+    isSapTransaction(instructions) {
+        return (0, instructions_1.containsSapInstruction)(instructions, this.programId);
+    }
+    /**
+     * Decode inner (CPI) instructions from transaction metadata.
+     *
+     * @param innerGroups - The `tx.meta.innerInstructions` array.
+     * @param tx - The transaction response (for account key resolution).
+     * @returns Decoded inner instructions.
+     *
+     * @since v0.5.0
+     */
+    decodeInner(innerGroups, tx) {
+        const accountKeys = (0, inner_1.extractAccountKeys)(tx);
+        return (0, inner_1.decodeInnerInstructions)(innerGroups, accountKeys, this.coder, this.programId);
+    }
+}
+exports.TransactionParser = TransactionParser;
+//# sourceMappingURL=client.js.map

package/dist/cjs/parser/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/parser/client.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;;AAiBH,+CAAoE;AACpE,iDAAsF;AACtF,yCAAmF;AACnF,mCAIiB;AAEjB;;;;;;;;;;GAUG;AACH,MAAa,iBAAiB;IAUC;IATZ,KAAK,CAAsB;IAC3B,SAAS,CAAY;IAEtC;;;;OAIG;IACH,8DAA8D;IAC9D,YAA6B,OAAqB;QAArB,YAAO,GAAP,OAAO,CAAc;QAChD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,WAA6C,CAAC;QACzE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACrC,CAAC;IAED;;;;;;;;;OASG;IACH,gBAAgB,CACd,EAAyE,EACzE,OAA4B,EAC5B,mBAAiD;QAEjD,OAAO,IAAA,sCAA2B,EAChC,EAAE,EACF,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,SAAS,EACd,OAAO,EACP,mBAAmB,CACpB,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,UAAU,CACR,GAA8E,EAC9E,OAA4B,EAC5B,mBAAiD;QAEjD,OAAO,IAAA,mCAAwB,EAC7B,GAAG,EACH,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,SAAS,EACd,OAAO,EACP,mBAAmB,CACpB,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,2BAA2B,CACzB,EAAsD,EACtD,mBAAiD;QAEjD,OAAO,IAAA,iDAAmC,EACxC,EAAE,EACF,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,SAAS,EACd,mBAAmB,CACpB,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,gBAAgB,CACd,EAAsD,EACtD,mBAAiD;QAEjD,OAAO,IAAI,CAAC,2BAA2B,CAAC,EAAE,EAAE,mBAAmB,CAAC,CAAC,GAAG,CAClE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAChB,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB,CACd,YAAsC;QAEtC,OAAO,IAAA,2CAA4B,EAAC,YAAY,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB,CAAC,YAAsC;QACrD,OAAO,IAAA,qCAAsB,EAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;;OAQG;IACH,WAAW,CACT,WAAoC,EACpC,EAAsD;QAEtD,MAAM,WAAW,GAAG,IAAA,0BAAkB,EAAC,EAAE,CAAC,CAAC;QAC3C,OAAO,IAAA,+BAAuB,EAC5B,WAAW,EACX,WAAW,EACX,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,SAAS,CACf,CAAC;IACJ,CAAC;CACF;AArJD,8CAqJC"}

package/dist/cjs/parser/complete.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * @module parser/complete
+ * @description Full SAP transaction parser: instructions + args + accounts + events.
+ *
+ * This is "Case 2 Complete": given a raw transaction response, produce a
+ * single {@link ParsedSapTransaction} containing every decoded instruction,
+ * all inner (CPI) calls, and all SAP events extracted from the logs.
+ *
+ * Designed for indexer pipelines where the decode step must be pure,
+ * deterministic, and fully testable without an RPC connection.
+ *
+ * @category Parser
+ * @since v0.5.0
+ *
+ * @example
+ * ```ts
+ * import { parseSapTransactionComplete } from "@synapse-sap/sdk/parser";
+ * import { SAP_PROGRAM_ID, SAP_IDL } from "@synapse-sap/sdk";
+ * import { Program } from "\@coral-xyz/anchor";
+ *
+ * const program = new Program(SAP_IDL, provider);
+ * const tx = await connection.getTransaction(sig, {
+ *   commitment: "confirmed",
+ *   maxSupportedTransactionVersion: 0,
+ * });
+ *
+ * const parsed = parseSapTransactionComplete(tx, program, SAP_PROGRAM_ID);
+ * console.log(parsed.instructions.map(i => i.name));
+ * console.log(parsed.events.map(e => e.name));
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSapTransactionComplete = parseSapTransactionComplete;
+exports.parseSapTransactionBatch = parseSapTransactionBatch;
+const events_1 = require("../events");
+const transaction_1 = require("./transaction");
+const inner_1 = require("./inner");
+// ================================================================
+//  Public API
+// ================================================================
+/**
+ * Parse a complete SAP transaction into a unified result.
+ *
+ * Combines three stages:
+ * 1. **Instruction decode** - top-level SAP instructions with args and accounts
+ * 2. **Inner instruction decode** - CPI calls with full account reconstruction
+ * 3. **Event extraction** - SAP events decoded from the transaction logs
+ *
+ * All three stages are safe: malformed data produces `null` fields
+ * rather than exceptions. This makes the function suitable for
+ * batch-processing in indexer workers where a single bad transaction
+ * must not halt the pipeline.
+ *
+ * @param tx - The raw transaction response from `connection.getTransaction`.
+ * @param program - An Anchor `Program` instance built from the SAP IDL.
+ *   The coder and program ID are extracted automatically.
+ * @param sapProgramId - The SAP program public key. Passed explicitly so
+ *   callers can target devnet/localnet deployments independently.
+ * @param options - Optional filters for instructions, events, and inner calls.
+ * @param addressLookupTables - Resolved lookup table accounts for v0 transactions.
+ * @returns A fully parsed transaction, or `null` if the input is `null`/`undefined`.
+ *
+ * @category Parser
+ * @since v0.5.0
+ */
+function parseSapTransactionComplete(tx, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+program, sapProgramId, options, addressLookupTables) {
+    if (!tx)
+        return null;
+    const opts = {
+        includeInner: options?.includeInner ?? false,
+        includeEvents: options?.includeEvents ?? true,
+        instructionFilter: options?.instructionFilter ?? [],
+        eventFilter: options?.eventFilter ?? [],
+    };
+    // Extract coder from the program
+    const coder = program.coder.instruction;
+    // 1. Top-level instructions
+    let instructions = (0, transaction_1.parseSapInstructionsFromTransaction)(tx, coder, sapProgramId, addressLookupTables);
+    if (opts.instructionFilter.length > 0) {
+        const filterSet = new Set(opts.instructionFilter);
+        instructions = instructions.filter((ix) => filterSet.has(ix.name));
+    }
+    // 2. Inner (CPI) instructions
+    let innerInstructions = [];
+    if (opts.includeInner && tx.meta?.innerInstructions) {
+        const accountKeys = (0, inner_1.extractAccountKeys)(tx);
+        innerInstructions = (0, inner_1.decodeInnerInstructions)(tx.meta.innerInstructions, accountKeys, coder, sapProgramId);
+    }
+    // 3. Events from logs
+    let events = [];
+    const logs = tx.meta?.logMessages ?? [];
+    if (opts.includeEvents && logs.length > 0) {
+        const eventParser = new events_1.EventParser(program);
+        events = eventParser.parseLogs(logs);
+        if (opts.eventFilter.length > 0) {
+            const filterSet = new Set(opts.eventFilter);
+            events = events.filter((e) => filterSet.has(e.name));
+        }
+    }
+    // 4. Metadata
+    const signature = extractSignature(tx);
+    const slot = tx.slot ?? null;
+    const blockTime = tx.blockTime ?? null;
+    const success = tx.meta?.err === null || tx.meta?.err === undefined;
+    return {
+        signature,
+        slot,
+        blockTime,
+        success,
+        instructions,
+        innerInstructions,
+        events,
+        logs,
+    };
+}
+/**
+ * Parse multiple transactions in batch.
+ *
+ * Convenience wrapper for indexer pipelines that process pages of
+ * transactions. Skips `null` entries and failed decodes silently.
+ *
+ * @param txs - Array of transaction responses (may contain `null` entries).
+ * @param program - The Anchor SAP program instance.
+ * @param sapProgramId - The SAP program public key.
+ * @param options - Optional parse filters applied to every transaction.
+ * @param addressLookupTables - Lookup tables for v0 transactions.
+ * @returns An array of non-null parsed transactions.
+ *
+ * @category Parser
+ * @since v0.5.0
+ *
+ * @example
+ * ```ts
+ * const signatures = await connection.getSignaturesForAddress(agentPda);
+ * const txs = await Promise.all(
+ *   signatures.map(s => connection.getTransaction(s.signature, { ... }))
+ * );
+ * const parsed = parseSapTransactionBatch(txs, program, SAP_PROGRAM_ID, {
+ *   includeEvents: true,
+ *   includeInner: true,
+ * });
+ * ```
+ */
+function parseSapTransactionBatch(txs, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+program, sapProgramId, options, addressLookupTables) {
+    const results = [];
+    for (const tx of txs) {
+        const parsed = parseSapTransactionComplete(tx, program, sapProgramId, options, addressLookupTables);
+        if (parsed)
+            results.push(parsed);
+    }
+    return results;
+}
+// ================================================================
+//  Internal
+// ================================================================
+/**
+ * Extract the transaction signature from the response.
+ * Different RPC clients expose it in different locations.
+ *
+ * @internal
+ */
+function extractSignature(tx) {
+    // Some clients expose signatures on the transaction object
+    const txObj = tx.transaction;
+    if ("signatures" in txObj && Array.isArray(txObj.signatures) && txObj.signatures.length > 0) {
+        const first = txObj.signatures[0];
+        if (typeof first === "string")
+            return first;
+    }
+    return null;
+}
+//# sourceMappingURL=complete.js.map

package/dist/cjs/parser/complete.js.map

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

package/dist/cjs/parser/index.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * @module parser
+ * @description Transaction parsing utilities for SAP v2.
+ *
+ * Provides modular, composable functions for decoding on-chain SAP
+ * transactions into typed instruction data, argument objects, account
+ * lists, and protocol events.
+ *
+ * Three levels of parsing are available depending on your use case:
+ *
+ * | Function | Input | Output |
+ * |----------|-------|--------|
+ * | `parseSapInstructionsFromTransaction` | `TransactionResponse` (RPC) | Decoded instructions |
+ * | `parseSapInstructionsFromList` | `TransactionInstruction[]` | Decoded instructions |
+ * | `parseSapTransactionComplete` | `TransactionResponse` (RPC) | Instructions + events + inner calls |
+ *
+ * All functions are pure and stateless: they accept the Anchor coder
+ * (or full Program) as a parameter, making them safe for server-side
+ * indexer workers, edge functions (Node.js runtime), and test suites.
+ *
+ * @category Parser
+ * @since v0.5.0
+ *
+ * @example
+ * ```ts
+ * import {
+ *   parseSapTransactionComplete,
+ *   parseSapInstructionsFromList,
+ *   containsSapInstruction,
+ * } from "@synapse-sap/sdk/parser";
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionParser = exports.extractAccountKeys = exports.filterSapInnerInstructions = exports.decodeInnerInstructions = exports.parseSapTransactionBatch = exports.parseSapTransactionComplete = exports.containsSapInstruction = exports.parseSapInstructionNamesFromList = exports.parseSapInstructionsFromList = exports.parseSapInstructionNamesFromTransaction = exports.parseSapInstructionsFromTransaction = void 0;
+// ── Case 2A: from TransactionResponse ────────────────
+var transaction_1 = require("./transaction");
+Object.defineProperty(exports, "parseSapInstructionsFromTransaction", { enumerable: true, get: function () { return transaction_1.parseSapInstructionsFromTransaction; } });
+Object.defineProperty(exports, "parseSapInstructionNamesFromTransaction", { enumerable: true, get: function () { return transaction_1.parseSapInstructionNamesFromTransaction; } });
+// ── Case 2B: from TransactionInstruction[] ───────────
+var instructions_1 = require("./instructions");
+Object.defineProperty(exports, "parseSapInstructionsFromList", { enumerable: true, get: function () { return instructions_1.parseSapInstructionsFromList; } });
+Object.defineProperty(exports, "parseSapInstructionNamesFromList", { enumerable: true, get: function () { return instructions_1.parseSapInstructionNamesFromList; } });
+Object.defineProperty(exports, "containsSapInstruction", { enumerable: true, get: function () { return instructions_1.containsSapInstruction; } });
+// ── Case 2 Complete: instructions + events + inner ───
+var complete_1 = require("./complete");
+Object.defineProperty(exports, "parseSapTransactionComplete", { enumerable: true, get: function () { return complete_1.parseSapTransactionComplete; } });
+Object.defineProperty(exports, "parseSapTransactionBatch", { enumerable: true, get: function () { return complete_1.parseSapTransactionBatch; } });
+// ── Inner instruction utilities ──────────────────────
+var inner_1 = require("./inner");
+Object.defineProperty(exports, "decodeInnerInstructions", { enumerable: true, get: function () { return inner_1.decodeInnerInstructions; } });
+Object.defineProperty(exports, "filterSapInnerInstructions", { enumerable: true, get: function () { return inner_1.filterSapInnerInstructions; } });
+Object.defineProperty(exports, "extractAccountKeys", { enumerable: true, get: function () { return inner_1.extractAccountKeys; } });
+// ── OOP wrapper (for SapClient integration) ──────────
+var client_1 = require("./client");
+Object.defineProperty(exports, "TransactionParser", { enumerable: true, get: function () { return client_1.TransactionParser; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/parser/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;;AAWH,wDAAwD;AACxD,6CAGuB;AAFrB,kIAAA,mCAAmC,OAAA;AACnC,sIAAA,uCAAuC,OAAA;AAGzC,wDAAwD;AACxD,+CAIwB;AAHtB,4HAAA,4BAA4B,OAAA;AAC5B,gIAAA,gCAAgC,OAAA;AAChC,sHAAA,sBAAsB,OAAA;AAGxB,wDAAwD;AACxD,uCAGoB;AAFlB,uHAAA,2BAA2B,OAAA;AAC3B,oHAAA,wBAAwB,OAAA;AAG1B,wDAAwD;AACxD,iCAIiB;AAHf,gHAAA,uBAAuB,OAAA;AACvB,mHAAA,0BAA0B,OAAA;AAC1B,2GAAA,kBAAkB,OAAA;AAIpB,wDAAwD;AACxD,mCAA6C;AAApC,2GAAA,iBAAiB,OAAA"}