@oobe-protocol-labs/synapse-sap-sdk 0.4.1 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cjs/constants/index.js +4 -1
- package/dist/cjs/constants/index.js.map +1 -1
- package/dist/cjs/constants/network.js +81 -0
- package/dist/cjs/constants/network.js.map +1 -0
- package/dist/cjs/core/client.js +23 -0
- package/dist/cjs/core/client.js.map +1 -1
- package/dist/cjs/index.js +17 -2
- package/dist/cjs/index.js.map +1 -1
- package/dist/cjs/parser/client.js +146 -0
- package/dist/cjs/parser/client.js.map +1 -0
- package/dist/cjs/parser/complete.js +177 -0
- package/dist/cjs/parser/complete.js.map +1 -0
- package/dist/cjs/parser/index.js +57 -0
- package/dist/cjs/parser/index.js.map +1 -0
- package/dist/cjs/parser/inner.js +185 -0
- package/dist/cjs/parser/inner.js.map +1 -0
- package/dist/cjs/parser/instructions.js +114 -0
- package/dist/cjs/parser/instructions.js.map +1 -0
- package/dist/cjs/parser/transaction.js +153 -0
- package/dist/cjs/parser/transaction.js.map +1 -0
- package/dist/cjs/parser/types.js +14 -0
- package/dist/cjs/parser/types.js.map +1 -0
- package/dist/cjs/registries/x402.js +5 -2
- package/dist/cjs/registries/x402.js.map +1 -1
- package/dist/esm/constants/index.js +2 -0
- package/dist/esm/constants/index.js.map +1 -1
- package/dist/esm/constants/network.js +78 -0
- package/dist/esm/constants/network.js.map +1 -0
- package/dist/esm/core/client.js +23 -0
- package/dist/esm/core/client.js.map +1 -1
- package/dist/esm/index.js +4 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/parser/client.js +142 -0
- package/dist/esm/parser/client.js.map +1 -0
- package/dist/esm/parser/complete.js +173 -0
- package/dist/esm/parser/complete.js.map +1 -0
- package/dist/esm/parser/index.js +43 -0
- package/dist/esm/parser/index.js.map +1 -0
- package/dist/esm/parser/inner.js +180 -0
- package/dist/esm/parser/inner.js.map +1 -0
- package/dist/esm/parser/instructions.js +109 -0
- package/dist/esm/parser/instructions.js.map +1 -0
- package/dist/esm/parser/transaction.js +149 -0
- package/dist/esm/parser/transaction.js.map +1 -0
- package/dist/esm/parser/types.js +13 -0
- package/dist/esm/parser/types.js.map +1 -0
- package/dist/esm/registries/x402.js +5 -2
- package/dist/esm/registries/x402.js.map +1 -1
- package/dist/types/constants/index.d.ts +2 -0
- package/dist/types/constants/index.d.ts.map +1 -1
- package/dist/types/constants/network.d.ts +81 -0
- package/dist/types/constants/network.d.ts.map +1 -0
- package/dist/types/core/client.d.ts +19 -0
- package/dist/types/core/client.d.ts.map +1 -1
- package/dist/types/index.d.ts +5 -1
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/parser/client.d.ts +123 -0
- package/dist/types/parser/client.d.ts.map +1 -0
- package/dist/types/parser/complete.d.ts +90 -0
- package/dist/types/parser/complete.d.ts.map +1 -0
- package/dist/types/parser/index.d.ts +40 -0
- package/dist/types/parser/index.d.ts.map +1 -0
- package/dist/types/parser/inner.d.ts +114 -0
- package/dist/types/parser/inner.d.ts.map +1 -0
- package/dist/types/parser/instructions.d.ts +76 -0
- package/dist/types/parser/instructions.d.ts.map +1 -0
- package/dist/types/parser/transaction.d.ts +77 -0
- package/dist/types/parser/transaction.d.ts.map +1 -0
- package/dist/types/parser/types.d.ts +154 -0
- package/dist/types/parser/types.d.ts.map +1 -0
- package/dist/types/registries/x402.d.ts +35 -2
- package/dist/types/registries/x402.d.ts.map +1 -1
- package/package.json +6 -1
- package/src/constants/index.ts +4 -0
- package/src/constants/network.ts +89 -0
- package/src/core/client.ts +25 -0
- package/src/index.ts +27 -0
- package/src/parser/client.ts +211 -0
- package/src/parser/complete.ts +232 -0
- package/src/parser/index.ts +71 -0
- package/src/parser/inner.ts +255 -0
- package/src/parser/instructions.ts +135 -0
- package/src/parser/transaction.ts +200 -0
- package/src/parser/types.ts +182 -0
- package/src/registries/x402.ts +38 -3
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
* ```
|
|
23
23
|
*/
|
|
24
24
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
25
|
-
exports.TOOL_CATEGORY_ADDRESS_LIST = exports.TOOL_CATEGORY_ADDRESSES = exports.PROGRAM_METADATA_PROGRAM = exports.IDL_ACCOUNT_ADDRESS = exports.GLOBAL_REGISTRY_BUMP = exports.GLOBAL_REGISTRY_ADDRESS = exports.SAP_UPGRADE_AUTHORITY = exports.SAP_PROGRAM = exports.HTTP_METHOD_VALUES = exports.TOOL_CATEGORY_VALUES = exports.VAULT_PROTOCOL_VERSION = exports.AGENT_VERSION = exports.LIMITS = exports.SEEDS = exports.SAP_PROGRAM_ID = exports.LOCALNET_SAP_PROGRAM_ID = exports.DEVNET_SAP_PROGRAM_ID = exports.MAINNET_SAP_PROGRAM_ID = exports.SAP_PROGRAM_ADDRESS = void 0;
|
|
25
|
+
exports.TOOL_CATEGORY_ADDRESS_LIST = exports.TOOL_CATEGORY_ADDRESSES = exports.PROGRAM_METADATA_PROGRAM = exports.IDL_ACCOUNT_ADDRESS = exports.GLOBAL_REGISTRY_BUMP = exports.GLOBAL_REGISTRY_ADDRESS = exports.SAP_UPGRADE_AUTHORITY = exports.SAP_PROGRAM = exports.SapNetwork = exports.HTTP_METHOD_VALUES = exports.TOOL_CATEGORY_VALUES = exports.VAULT_PROTOCOL_VERSION = exports.AGENT_VERSION = exports.LIMITS = exports.SEEDS = exports.SAP_PROGRAM_ID = exports.LOCALNET_SAP_PROGRAM_ID = exports.DEVNET_SAP_PROGRAM_ID = exports.MAINNET_SAP_PROGRAM_ID = exports.SAP_PROGRAM_ADDRESS = void 0;
|
|
26
26
|
// ── Program IDs ──────────────────────────────────────
|
|
27
27
|
var programs_1 = require("./programs");
|
|
28
28
|
Object.defineProperty(exports, "SAP_PROGRAM_ADDRESS", { enumerable: true, get: function () { return programs_1.SAP_PROGRAM_ADDRESS; } });
|
|
@@ -40,6 +40,9 @@ Object.defineProperty(exports, "AGENT_VERSION", { enumerable: true, get: functio
|
|
|
40
40
|
Object.defineProperty(exports, "VAULT_PROTOCOL_VERSION", { enumerable: true, get: function () { return limits_1.VAULT_PROTOCOL_VERSION; } });
|
|
41
41
|
Object.defineProperty(exports, "TOOL_CATEGORY_VALUES", { enumerable: true, get: function () { return limits_1.TOOL_CATEGORY_VALUES; } });
|
|
42
42
|
Object.defineProperty(exports, "HTTP_METHOD_VALUES", { enumerable: true, get: function () { return limits_1.HTTP_METHOD_VALUES; } });
|
|
43
|
+
// ── Network Identifiers (x402) ───────────────────────────────
|
|
44
|
+
var network_1 = require("./network");
|
|
45
|
+
Object.defineProperty(exports, "SapNetwork", { enumerable: true, get: function () { return network_1.SapNetwork; } });
|
|
43
46
|
// ── Mainnet Addresses ────────────────────────────────────────
|
|
44
47
|
var addresses_1 = require("./addresses");
|
|
45
48
|
Object.defineProperty(exports, "SAP_PROGRAM", { enumerable: true, get: function () { return addresses_1.SAP_PROGRAM; } });
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/constants/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAEH,wDAAwD;AACxD,uCAMoB;AALlB,+GAAA,mBAAmB,OAAA;AACnB,kHAAA,sBAAsB,OAAA;AACtB,iHAAA,qBAAqB,OAAA;AACrB,mHAAA,uBAAuB,OAAA;AACvB,0GAAA,cAAc,OAAA;AAGhB,wDAAwD;AACxD,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AAGd,wDAAwD;AACxD,mCAMkB;AALhB,gGAAA,MAAM,OAAA;AACN,uGAAA,aAAa,OAAA;AACb,gHAAA,sBAAsB,OAAA;AACtB,8GAAA,oBAAoB,OAAA;AACpB,4GAAA,kBAAkB,OAAA;AAEpB,gEAAgE;AAChE,yCASqB;AARnB,wGAAA,WAAW,OAAA;AACX,kHAAA,qBAAqB,OAAA;AACrB,oHAAA,uBAAuB,OAAA;AACvB,iHAAA,oBAAoB,OAAA;AACpB,gHAAA,mBAAmB,OAAA;AACnB,qHAAA,wBAAwB,OAAA;AACxB,oHAAA,uBAAuB,OAAA;AACvB,uHAAA,0BAA0B,OAAA"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/constants/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAEH,wDAAwD;AACxD,uCAMoB;AALlB,+GAAA,mBAAmB,OAAA;AACnB,kHAAA,sBAAsB,OAAA;AACtB,iHAAA,qBAAqB,OAAA;AACrB,mHAAA,uBAAuB,OAAA;AACvB,0GAAA,cAAc,OAAA;AAGhB,wDAAwD;AACxD,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AAGd,wDAAwD;AACxD,mCAMkB;AALhB,gGAAA,MAAM,OAAA;AACN,uGAAA,aAAa,OAAA;AACb,gHAAA,sBAAsB,OAAA;AACtB,8GAAA,oBAAoB,OAAA;AACpB,4GAAA,kBAAkB,OAAA;AAEpB,gEAAgE;AAChE,qCAAuC;AAA9B,qGAAA,UAAU,OAAA;AAGnB,gEAAgE;AAChE,yCASqB;AARnB,wGAAA,WAAW,OAAA;AACX,kHAAA,qBAAqB,OAAA;AACrB,oHAAA,uBAAuB,OAAA;AACvB,iHAAA,oBAAoB,OAAA;AACpB,gHAAA,mBAAmB,OAAA;AACnB,qHAAA,wBAAwB,OAAA;AACxB,oHAAA,uBAAuB,OAAA;AACvB,uHAAA,0BAA0B,OAAA"}
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* @module constants/network
|
|
4
|
+
* @description Solana network identifiers for x402 payment headers.
|
|
5
|
+
*
|
|
6
|
+
* x402 providers validate the `X-Payment-Network` header against their
|
|
7
|
+
* own network identifier. Some providers (e.g. Coinbase, Phantom) accept
|
|
8
|
+
* the human-readable cluster name (`solana:mainnet-beta`), while others
|
|
9
|
+
* (e.g. Kamiyo, Helius x402) require the Solana genesis-hash form
|
|
10
|
+
* (`solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`).
|
|
11
|
+
*
|
|
12
|
+
* Use {@link SapNetwork} to select the correct format, or pass any
|
|
13
|
+
* custom string where needed.
|
|
14
|
+
*
|
|
15
|
+
* @category Constants
|
|
16
|
+
* @since v0.4.3
|
|
17
|
+
*
|
|
18
|
+
* @example
|
|
19
|
+
* ```ts
|
|
20
|
+
* import { SapNetwork } from "@synapse-sap/sdk";
|
|
21
|
+
*
|
|
22
|
+
* // Standard cluster name (default)
|
|
23
|
+
* const ctx = await x402.preparePayment(agentWallet, {
|
|
24
|
+
* pricePerCall: 1000, deposit: 100_000,
|
|
25
|
+
* networkIdentifier: SapNetwork.SOLANA_MAINNET,
|
|
26
|
+
* });
|
|
27
|
+
*
|
|
28
|
+
* // Genesis-hash form for providers that require it
|
|
29
|
+
* const ctx2 = await x402.preparePayment(agentWallet, {
|
|
30
|
+
* pricePerCall: 1000, deposit: 100_000,
|
|
31
|
+
* networkIdentifier: SapNetwork.SOLANA_MAINNET_GENESIS,
|
|
32
|
+
* });
|
|
33
|
+
* ```
|
|
34
|
+
*/
|
|
35
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
36
|
+
exports.SapNetwork = void 0;
|
|
37
|
+
// ═══════════════════════════════════════════════════════════════════
|
|
38
|
+
// SAP Network Identifiers
|
|
39
|
+
// ═══════════════════════════════════════════════════════════════════
|
|
40
|
+
/**
|
|
41
|
+
* @name SapNetwork
|
|
42
|
+
* @description Network identifier strings for x402 `X-Payment-Network` headers.
|
|
43
|
+
*
|
|
44
|
+
* Two mainnet forms exist because x402 providers disagree on the canonical
|
|
45
|
+
* identifier:
|
|
46
|
+
*
|
|
47
|
+
* | Constant | Value | Accepted by |
|
|
48
|
+
* |-------------------------|----------------------------------------------|----------------------|
|
|
49
|
+
* | `SOLANA_MAINNET` | `solana:mainnet-beta` | Coinbase, Phantom |
|
|
50
|
+
* | `SOLANA_MAINNET_GENESIS`| `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp` | Kamiyo, Helius x402 |
|
|
51
|
+
* | `SOLANA_DEVNET` | `solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1` | Devnet providers |
|
|
52
|
+
* | `SOLANA_DEVNET_NAMED` | `solana:devnet` | Local / test flows |
|
|
53
|
+
*
|
|
54
|
+
* If your provider requires a different format, pass a raw string instead.
|
|
55
|
+
*
|
|
56
|
+
* @category Constants
|
|
57
|
+
* @since v0.4.3
|
|
58
|
+
*/
|
|
59
|
+
exports.SapNetwork = {
|
|
60
|
+
/**
|
|
61
|
+
* Mainnet-beta, human-readable cluster name.
|
|
62
|
+
* Default value used by the SDK prior to v0.4.3.
|
|
63
|
+
*/
|
|
64
|
+
SOLANA_MAINNET: "solana:mainnet-beta",
|
|
65
|
+
/**
|
|
66
|
+
* Mainnet-beta, genesis-hash form (CAIP-2 compliant).
|
|
67
|
+
* Required by Kamiyo, Helius x402, and other providers that validate
|
|
68
|
+
* against the Solana genesis hash.
|
|
69
|
+
*/
|
|
70
|
+
SOLANA_MAINNET_GENESIS: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
|
|
71
|
+
/**
|
|
72
|
+
* Devnet, genesis-hash form (CAIP-2 compliant).
|
|
73
|
+
*/
|
|
74
|
+
SOLANA_DEVNET: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
|
|
75
|
+
/**
|
|
76
|
+
* Devnet, human-readable cluster name.
|
|
77
|
+
* Useful for local development and test validators.
|
|
78
|
+
*/
|
|
79
|
+
SOLANA_DEVNET_NAMED: "solana:devnet",
|
|
80
|
+
};
|
|
81
|
+
//# sourceMappingURL=network.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"network.js","sourceRoot":"","sources":["../../../src/constants/network.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;;;AAEH,sEAAsE;AACtE,2BAA2B;AAC3B,sEAAsE;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AACU,QAAA,UAAU,GAAG;IACxB;;;OAGG;IACH,cAAc,EAAE,qBAAqB;IAErC;;;;OAIG;IACH,sBAAsB,EAAE,yCAAyC;IAEjE;;OAEG;IACH,aAAa,EAAE,yCAAyC;IAExD;;;OAGG;IACH,mBAAmB,EAAE,eAAe;CAC5B,CAAC"}
|
package/dist/cjs/core/client.js
CHANGED
|
@@ -40,6 +40,7 @@ const escrow_1 = require("../modules/escrow");
|
|
|
40
40
|
const attestation_1 = require("../modules/attestation");
|
|
41
41
|
const ledger_1 = require("../modules/ledger");
|
|
42
42
|
const events_1 = require("../events");
|
|
43
|
+
const client_1 = require("../parser/client");
|
|
43
44
|
const discovery_1 = require("../registries/discovery");
|
|
44
45
|
const x402_1 = require("../registries/x402");
|
|
45
46
|
const session_1 = require("../registries/session");
|
|
@@ -111,6 +112,8 @@ class SapClient {
|
|
|
111
112
|
#attestation;
|
|
112
113
|
#ledger;
|
|
113
114
|
#events;
|
|
115
|
+
// ── Lazy parser singleton ─────────────────────
|
|
116
|
+
#parser;
|
|
114
117
|
// ── Lazy registry singletons ──────────────────────
|
|
115
118
|
#discovery;
|
|
116
119
|
#x402;
|
|
@@ -295,6 +298,26 @@ class SapClient {
|
|
|
295
298
|
get events() {
|
|
296
299
|
return (this.#events ??= new events_1.EventParser(this.program));
|
|
297
300
|
}
|
|
301
|
+
/**
|
|
302
|
+
* @name parser
|
|
303
|
+
* @description Transaction parser: decode instruction names, arguments,
|
|
304
|
+
* accounts, inner CPI calls, and protocol events from raw transaction
|
|
305
|
+
* responses. Designed for indexers and explorers.
|
|
306
|
+
* @returns {TransactionParser} The lazily-instantiated `TransactionParser` singleton.
|
|
307
|
+
* @category Modules
|
|
308
|
+
* @since v0.5.0
|
|
309
|
+
* @see {@link TransactionParser}
|
|
310
|
+
*
|
|
311
|
+
* @example
|
|
312
|
+
* ```ts
|
|
313
|
+
* const tx = await connection.getTransaction(sig, { ... });
|
|
314
|
+
* const parsed = client.parser.parseTransaction(tx);
|
|
315
|
+
* console.log(parsed?.instructions.map(i => i.name));
|
|
316
|
+
* ```
|
|
317
|
+
*/
|
|
318
|
+
get parser() {
|
|
319
|
+
return (this.#parser ??= new client_1.TransactionParser(this.program));
|
|
320
|
+
}
|
|
298
321
|
// ═════════════════════════════════════════════
|
|
299
322
|
// Registry Accessors (high-level abstractions)
|
|
300
323
|
// ═════════════════════════════════════════════
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/core/client.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/core/client.ts"],"names":[],"mappings":"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"}
|
package/dist/cjs/index.js
CHANGED
|
@@ -16,6 +16,7 @@
|
|
|
16
16
|
* | `modules/` | Low-level per-domain instruction wrappers |
|
|
17
17
|
* | `registries/` | High-level abstractions (discovery, x402, …) |
|
|
18
18
|
* | `plugin/` | SynapseAgentKit adapter (52 tools) |
|
|
19
|
+
* | `parser/` | Transaction decode, instruction + event parse |
|
|
19
20
|
* | `idl/` | Embedded Anchor IDL |
|
|
20
21
|
*
|
|
21
22
|
* @example
|
|
@@ -44,8 +45,8 @@
|
|
|
44
45
|
* @since v0.1.0
|
|
45
46
|
*/
|
|
46
47
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
47
|
-
exports.
|
|
48
|
-
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;
|
|
48
|
+
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.SapNetwork = 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;
|
|
49
|
+
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 = exports.SapRpcError = void 0;
|
|
49
50
|
// ── Core ─────────────────────────────────────────────
|
|
50
51
|
var core_1 = require("./core");
|
|
51
52
|
Object.defineProperty(exports, "SapClient", { enumerable: true, get: function () { return core_1.SapClient; } });
|
|
@@ -73,6 +74,7 @@ Object.defineProperty(exports, "AGENT_VERSION", { enumerable: true, get: functio
|
|
|
73
74
|
Object.defineProperty(exports, "VAULT_PROTOCOL_VERSION", { enumerable: true, get: function () { return constants_1.VAULT_PROTOCOL_VERSION; } });
|
|
74
75
|
Object.defineProperty(exports, "TOOL_CATEGORY_VALUES", { enumerable: true, get: function () { return constants_1.TOOL_CATEGORY_VALUES; } });
|
|
75
76
|
Object.defineProperty(exports, "HTTP_METHOD_VALUES", { enumerable: true, get: function () { return constants_1.HTTP_METHOD_VALUES; } });
|
|
77
|
+
Object.defineProperty(exports, "SapNetwork", { enumerable: true, get: function () { return constants_1.SapNetwork; } });
|
|
76
78
|
// ── IDL ──────────────────────────────────────────────
|
|
77
79
|
var index_1 = require("./idl/index");
|
|
78
80
|
Object.defineProperty(exports, "SAP_IDL", { enumerable: true, get: function () { return index_1.SAP_IDL; } });
|
|
@@ -139,6 +141,19 @@ var postgres_1 = require("./postgres");
|
|
|
139
141
|
Object.defineProperty(exports, "SapPostgres", { enumerable: true, get: function () { return postgres_1.SapPostgres; } });
|
|
140
142
|
Object.defineProperty(exports, "SapSyncEngine", { enumerable: true, get: function () { return postgres_1.SapSyncEngine; } });
|
|
141
143
|
Object.defineProperty(exports, "SAP_TABLE_MAP", { enumerable: true, get: function () { return postgres_1.SAP_TABLE_MAP; } });
|
|
144
|
+
// ── Parser (transaction decode + instruction + events) ─
|
|
145
|
+
var parser_1 = require("./parser");
|
|
146
|
+
Object.defineProperty(exports, "parseSapInstructionsFromTransaction", { enumerable: true, get: function () { return parser_1.parseSapInstructionsFromTransaction; } });
|
|
147
|
+
Object.defineProperty(exports, "parseSapInstructionNamesFromTransaction", { enumerable: true, get: function () { return parser_1.parseSapInstructionNamesFromTransaction; } });
|
|
148
|
+
Object.defineProperty(exports, "parseSapInstructionsFromList", { enumerable: true, get: function () { return parser_1.parseSapInstructionsFromList; } });
|
|
149
|
+
Object.defineProperty(exports, "parseSapInstructionNamesFromList", { enumerable: true, get: function () { return parser_1.parseSapInstructionNamesFromList; } });
|
|
150
|
+
Object.defineProperty(exports, "containsSapInstruction", { enumerable: true, get: function () { return parser_1.containsSapInstruction; } });
|
|
151
|
+
Object.defineProperty(exports, "parseSapTransactionComplete", { enumerable: true, get: function () { return parser_1.parseSapTransactionComplete; } });
|
|
152
|
+
Object.defineProperty(exports, "parseSapTransactionBatch", { enumerable: true, get: function () { return parser_1.parseSapTransactionBatch; } });
|
|
153
|
+
Object.defineProperty(exports, "decodeInnerInstructions", { enumerable: true, get: function () { return parser_1.decodeInnerInstructions; } });
|
|
154
|
+
Object.defineProperty(exports, "filterSapInnerInstructions", { enumerable: true, get: function () { return parser_1.filterSapInnerInstructions; } });
|
|
155
|
+
Object.defineProperty(exports, "extractAccountKeys", { enumerable: true, get: function () { return parser_1.extractAccountKeys; } });
|
|
156
|
+
Object.defineProperty(exports, "TransactionParser", { enumerable: true, get: function () { return parser_1.TransactionParser; } });
|
|
142
157
|
// ── Registries (high-level developer abstractions) ────
|
|
143
158
|
var index_4 = require("./registries/index");
|
|
144
159
|
Object.defineProperty(exports, "DiscoveryRegistry", { enumerable: true, get: function () { return index_4.DiscoveryRegistry; } });
|
package/dist/cjs/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* @module parser/client
|
|
4
|
+
* @description Object-oriented wrapper for transaction parsing.
|
|
5
|
+
*
|
|
6
|
+
* Binds the Anchor `Program` reference so callers do not need to
|
|
7
|
+
* pass it on every call. Designed as a lazy singleton accessible
|
|
8
|
+
* from {@link SapClient.parser}.
|
|
9
|
+
*
|
|
10
|
+
* @category Parser
|
|
11
|
+
* @since v0.5.0
|
|
12
|
+
*
|
|
13
|
+
* @example
|
|
14
|
+
* ```ts
|
|
15
|
+
* const client = SapClient.from(provider);
|
|
16
|
+
*
|
|
17
|
+
* // Parse a full transaction
|
|
18
|
+
* const parsed = client.parser.parseTransaction(txResponse);
|
|
19
|
+
*
|
|
20
|
+
* // Quick instruction names
|
|
21
|
+
* const names = client.parser.instructionNames(txResponse);
|
|
22
|
+
*
|
|
23
|
+
* // From pre-built instructions
|
|
24
|
+
* const decoded = client.parser.fromInstructions(ixList);
|
|
25
|
+
* ```
|
|
26
|
+
*/
|
|
27
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
28
|
+
exports.TransactionParser = void 0;
|
|
29
|
+
const transaction_1 = require("./transaction");
|
|
30
|
+
const instructions_1 = require("./instructions");
|
|
31
|
+
const complete_1 = require("./complete");
|
|
32
|
+
const inner_1 = require("./inner");
|
|
33
|
+
/**
|
|
34
|
+
* Stateful transaction parser bound to a specific Anchor `Program`.
|
|
35
|
+
*
|
|
36
|
+
* Stores the program reference, instruction coder, and program ID
|
|
37
|
+
* internally so that repeated parse calls require only the
|
|
38
|
+
* transaction data as input.
|
|
39
|
+
*
|
|
40
|
+
* @name TransactionParser
|
|
41
|
+
* @category Parser
|
|
42
|
+
* @since v0.5.0
|
|
43
|
+
*/
|
|
44
|
+
class TransactionParser {
|
|
45
|
+
program;
|
|
46
|
+
coder;
|
|
47
|
+
programId;
|
|
48
|
+
/**
|
|
49
|
+
* Create a new TransactionParser.
|
|
50
|
+
*
|
|
51
|
+
* @param program - An Anchor `Program` built from the SAP IDL.
|
|
52
|
+
*/
|
|
53
|
+
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
54
|
+
constructor(program) {
|
|
55
|
+
this.program = program;
|
|
56
|
+
this.coder = program.coder.instruction;
|
|
57
|
+
this.programId = program.programId;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Full parse: instructions + inner calls + events.
|
|
61
|
+
*
|
|
62
|
+
* @param tx - Raw transaction response from `connection.getTransaction`.
|
|
63
|
+
* @param options - Optional filters for instructions, events, and inner calls.
|
|
64
|
+
* @param addressLookupTables - Resolved lookup tables for v0 transactions.
|
|
65
|
+
* @returns Complete parsed transaction, or `null` if the input is nullish.
|
|
66
|
+
*
|
|
67
|
+
* @since v0.5.0
|
|
68
|
+
*/
|
|
69
|
+
parseTransaction(tx, options, addressLookupTables) {
|
|
70
|
+
return (0, complete_1.parseSapTransactionComplete)(tx, this.program, this.programId, options, addressLookupTables);
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* Parse a batch of transactions.
|
|
74
|
+
*
|
|
75
|
+
* @param txs - Array of transaction responses (may contain `null` entries).
|
|
76
|
+
* @param options - Optional parse filters.
|
|
77
|
+
* @param addressLookupTables - Resolved lookup tables for v0 transactions.
|
|
78
|
+
* @returns Non-null parsed transactions.
|
|
79
|
+
*
|
|
80
|
+
* @since v0.5.0
|
|
81
|
+
*/
|
|
82
|
+
parseBatch(txs, options, addressLookupTables) {
|
|
83
|
+
return (0, complete_1.parseSapTransactionBatch)(txs, this.program, this.programId, options, addressLookupTables);
|
|
84
|
+
}
|
|
85
|
+
/**
|
|
86
|
+
* Decode top-level SAP instructions from a transaction response.
|
|
87
|
+
*
|
|
88
|
+
* @param tx - Raw transaction response.
|
|
89
|
+
* @param addressLookupTables - Resolved lookup tables for v0 transactions.
|
|
90
|
+
* @returns Decoded SAP instructions.
|
|
91
|
+
*
|
|
92
|
+
* @since v0.5.0
|
|
93
|
+
*/
|
|
94
|
+
instructionsFromTransaction(tx, addressLookupTables) {
|
|
95
|
+
return (0, transaction_1.parseSapInstructionsFromTransaction)(tx, this.coder, this.programId, addressLookupTables);
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* Extract only the instruction names from a transaction response.
|
|
99
|
+
*
|
|
100
|
+
* @param tx - Raw transaction response.
|
|
101
|
+
* @param addressLookupTables - Resolved lookup tables for v0 transactions.
|
|
102
|
+
* @returns Instruction name strings.
|
|
103
|
+
*
|
|
104
|
+
* @since v0.5.0
|
|
105
|
+
*/
|
|
106
|
+
instructionNames(tx, addressLookupTables) {
|
|
107
|
+
return this.instructionsFromTransaction(tx, addressLookupTables).map((ix) => ix.name);
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* Decode SAP instructions from a pre-built instruction array.
|
|
111
|
+
*
|
|
112
|
+
* @param instructions - The instruction list to decode.
|
|
113
|
+
* @returns Decoded SAP instructions.
|
|
114
|
+
*
|
|
115
|
+
* @since v0.5.0
|
|
116
|
+
*/
|
|
117
|
+
fromInstructions(instructions) {
|
|
118
|
+
return (0, instructions_1.parseSapInstructionsFromList)(instructions, this.coder, this.programId);
|
|
119
|
+
}
|
|
120
|
+
/**
|
|
121
|
+
* Check if any instruction in the list targets the SAP program.
|
|
122
|
+
*
|
|
123
|
+
* @param instructions - The instruction array to inspect.
|
|
124
|
+
* @returns `true` if at least one instruction targets SAP.
|
|
125
|
+
*
|
|
126
|
+
* @since v0.5.0
|
|
127
|
+
*/
|
|
128
|
+
isSapTransaction(instructions) {
|
|
129
|
+
return (0, instructions_1.containsSapInstruction)(instructions, this.programId);
|
|
130
|
+
}
|
|
131
|
+
/**
|
|
132
|
+
* Decode inner (CPI) instructions from transaction metadata.
|
|
133
|
+
*
|
|
134
|
+
* @param innerGroups - The `tx.meta.innerInstructions` array.
|
|
135
|
+
* @param tx - The transaction response (for account key resolution).
|
|
136
|
+
* @returns Decoded inner instructions.
|
|
137
|
+
*
|
|
138
|
+
* @since v0.5.0
|
|
139
|
+
*/
|
|
140
|
+
decodeInner(innerGroups, tx) {
|
|
141
|
+
const accountKeys = (0, inner_1.extractAccountKeys)(tx);
|
|
142
|
+
return (0, inner_1.decodeInnerInstructions)(innerGroups, accountKeys, this.coder, this.programId);
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
exports.TransactionParser = TransactionParser;
|
|
146
|
+
//# sourceMappingURL=client.js.map
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* @module parser/complete
|
|
4
|
+
* @description Full SAP transaction parser: instructions + args + accounts + events.
|
|
5
|
+
*
|
|
6
|
+
* This is "Case 2 Complete": given a raw transaction response, produce a
|
|
7
|
+
* single {@link ParsedSapTransaction} containing every decoded instruction,
|
|
8
|
+
* all inner (CPI) calls, and all SAP events extracted from the logs.
|
|
9
|
+
*
|
|
10
|
+
* Designed for indexer pipelines where the decode step must be pure,
|
|
11
|
+
* deterministic, and fully testable without an RPC connection.
|
|
12
|
+
*
|
|
13
|
+
* @category Parser
|
|
14
|
+
* @since v0.5.0
|
|
15
|
+
*
|
|
16
|
+
* @example
|
|
17
|
+
* ```ts
|
|
18
|
+
* import { parseSapTransactionComplete } from "@synapse-sap/sdk/parser";
|
|
19
|
+
* import { SAP_PROGRAM_ID, SAP_IDL } from "@synapse-sap/sdk";
|
|
20
|
+
* import { Program } from "\@coral-xyz/anchor";
|
|
21
|
+
*
|
|
22
|
+
* const program = new Program(SAP_IDL, provider);
|
|
23
|
+
* const tx = await connection.getTransaction(sig, {
|
|
24
|
+
* commitment: "confirmed",
|
|
25
|
+
* maxSupportedTransactionVersion: 0,
|
|
26
|
+
* });
|
|
27
|
+
*
|
|
28
|
+
* const parsed = parseSapTransactionComplete(tx, program, SAP_PROGRAM_ID);
|
|
29
|
+
* console.log(parsed.instructions.map(i => i.name));
|
|
30
|
+
* console.log(parsed.events.map(e => e.name));
|
|
31
|
+
* ```
|
|
32
|
+
*/
|
|
33
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
34
|
+
exports.parseSapTransactionComplete = parseSapTransactionComplete;
|
|
35
|
+
exports.parseSapTransactionBatch = parseSapTransactionBatch;
|
|
36
|
+
const events_1 = require("../events");
|
|
37
|
+
const transaction_1 = require("./transaction");
|
|
38
|
+
const inner_1 = require("./inner");
|
|
39
|
+
// ================================================================
|
|
40
|
+
// Public API
|
|
41
|
+
// ================================================================
|
|
42
|
+
/**
|
|
43
|
+
* Parse a complete SAP transaction into a unified result.
|
|
44
|
+
*
|
|
45
|
+
* Combines three stages:
|
|
46
|
+
* 1. **Instruction decode** - top-level SAP instructions with args and accounts
|
|
47
|
+
* 2. **Inner instruction decode** - CPI calls with full account reconstruction
|
|
48
|
+
* 3. **Event extraction** - SAP events decoded from the transaction logs
|
|
49
|
+
*
|
|
50
|
+
* All three stages are safe: malformed data produces `null` fields
|
|
51
|
+
* rather than exceptions. This makes the function suitable for
|
|
52
|
+
* batch-processing in indexer workers where a single bad transaction
|
|
53
|
+
* must not halt the pipeline.
|
|
54
|
+
*
|
|
55
|
+
* @param tx - The raw transaction response from `connection.getTransaction`.
|
|
56
|
+
* @param program - An Anchor `Program` instance built from the SAP IDL.
|
|
57
|
+
* The coder and program ID are extracted automatically.
|
|
58
|
+
* @param sapProgramId - The SAP program public key. Passed explicitly so
|
|
59
|
+
* callers can target devnet/localnet deployments independently.
|
|
60
|
+
* @param options - Optional filters for instructions, events, and inner calls.
|
|
61
|
+
* @param addressLookupTables - Resolved lookup table accounts for v0 transactions.
|
|
62
|
+
* @returns A fully parsed transaction, or `null` if the input is `null`/`undefined`.
|
|
63
|
+
*
|
|
64
|
+
* @category Parser
|
|
65
|
+
* @since v0.5.0
|
|
66
|
+
*/
|
|
67
|
+
function parseSapTransactionComplete(tx,
|
|
68
|
+
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
69
|
+
program, sapProgramId, options, addressLookupTables) {
|
|
70
|
+
if (!tx)
|
|
71
|
+
return null;
|
|
72
|
+
const opts = {
|
|
73
|
+
includeInner: options?.includeInner ?? false,
|
|
74
|
+
includeEvents: options?.includeEvents ?? true,
|
|
75
|
+
instructionFilter: options?.instructionFilter ?? [],
|
|
76
|
+
eventFilter: options?.eventFilter ?? [],
|
|
77
|
+
};
|
|
78
|
+
// Extract coder from the program
|
|
79
|
+
const coder = program.coder.instruction;
|
|
80
|
+
// 1. Top-level instructions
|
|
81
|
+
let instructions = (0, transaction_1.parseSapInstructionsFromTransaction)(tx, coder, sapProgramId, addressLookupTables);
|
|
82
|
+
if (opts.instructionFilter.length > 0) {
|
|
83
|
+
const filterSet = new Set(opts.instructionFilter);
|
|
84
|
+
instructions = instructions.filter((ix) => filterSet.has(ix.name));
|
|
85
|
+
}
|
|
86
|
+
// 2. Inner (CPI) instructions
|
|
87
|
+
let innerInstructions = [];
|
|
88
|
+
if (opts.includeInner && tx.meta?.innerInstructions) {
|
|
89
|
+
const accountKeys = (0, inner_1.extractAccountKeys)(tx);
|
|
90
|
+
innerInstructions = (0, inner_1.decodeInnerInstructions)(tx.meta.innerInstructions, accountKeys, coder, sapProgramId);
|
|
91
|
+
}
|
|
92
|
+
// 3. Events from logs
|
|
93
|
+
let events = [];
|
|
94
|
+
const logs = tx.meta?.logMessages ?? [];
|
|
95
|
+
if (opts.includeEvents && logs.length > 0) {
|
|
96
|
+
const eventParser = new events_1.EventParser(program);
|
|
97
|
+
events = eventParser.parseLogs(logs);
|
|
98
|
+
if (opts.eventFilter.length > 0) {
|
|
99
|
+
const filterSet = new Set(opts.eventFilter);
|
|
100
|
+
events = events.filter((e) => filterSet.has(e.name));
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
// 4. Metadata
|
|
104
|
+
const signature = extractSignature(tx);
|
|
105
|
+
const slot = tx.slot ?? null;
|
|
106
|
+
const blockTime = tx.blockTime ?? null;
|
|
107
|
+
const success = tx.meta?.err === null || tx.meta?.err === undefined;
|
|
108
|
+
return {
|
|
109
|
+
signature,
|
|
110
|
+
slot,
|
|
111
|
+
blockTime,
|
|
112
|
+
success,
|
|
113
|
+
instructions,
|
|
114
|
+
innerInstructions,
|
|
115
|
+
events,
|
|
116
|
+
logs,
|
|
117
|
+
};
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* Parse multiple transactions in batch.
|
|
121
|
+
*
|
|
122
|
+
* Convenience wrapper for indexer pipelines that process pages of
|
|
123
|
+
* transactions. Skips `null` entries and failed decodes silently.
|
|
124
|
+
*
|
|
125
|
+
* @param txs - Array of transaction responses (may contain `null` entries).
|
|
126
|
+
* @param program - The Anchor SAP program instance.
|
|
127
|
+
* @param sapProgramId - The SAP program public key.
|
|
128
|
+
* @param options - Optional parse filters applied to every transaction.
|
|
129
|
+
* @param addressLookupTables - Lookup tables for v0 transactions.
|
|
130
|
+
* @returns An array of non-null parsed transactions.
|
|
131
|
+
*
|
|
132
|
+
* @category Parser
|
|
133
|
+
* @since v0.5.0
|
|
134
|
+
*
|
|
135
|
+
* @example
|
|
136
|
+
* ```ts
|
|
137
|
+
* const signatures = await connection.getSignaturesForAddress(agentPda);
|
|
138
|
+
* const txs = await Promise.all(
|
|
139
|
+
* signatures.map(s => connection.getTransaction(s.signature, { ... }))
|
|
140
|
+
* );
|
|
141
|
+
* const parsed = parseSapTransactionBatch(txs, program, SAP_PROGRAM_ID, {
|
|
142
|
+
* includeEvents: true,
|
|
143
|
+
* includeInner: true,
|
|
144
|
+
* });
|
|
145
|
+
* ```
|
|
146
|
+
*/
|
|
147
|
+
function parseSapTransactionBatch(txs,
|
|
148
|
+
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
149
|
+
program, sapProgramId, options, addressLookupTables) {
|
|
150
|
+
const results = [];
|
|
151
|
+
for (const tx of txs) {
|
|
152
|
+
const parsed = parseSapTransactionComplete(tx, program, sapProgramId, options, addressLookupTables);
|
|
153
|
+
if (parsed)
|
|
154
|
+
results.push(parsed);
|
|
155
|
+
}
|
|
156
|
+
return results;
|
|
157
|
+
}
|
|
158
|
+
// ================================================================
|
|
159
|
+
// Internal
|
|
160
|
+
// ================================================================
|
|
161
|
+
/**
|
|
162
|
+
* Extract the transaction signature from the response.
|
|
163
|
+
* Different RPC clients expose it in different locations.
|
|
164
|
+
*
|
|
165
|
+
* @internal
|
|
166
|
+
*/
|
|
167
|
+
function extractSignature(tx) {
|
|
168
|
+
// Some clients expose signatures on the transaction object
|
|
169
|
+
const txObj = tx.transaction;
|
|
170
|
+
if ("signatures" in txObj && Array.isArray(txObj.signatures) && txObj.signatures.length > 0) {
|
|
171
|
+
const first = txObj.signatures[0];
|
|
172
|
+
if (typeof first === "string")
|
|
173
|
+
return first;
|
|
174
|
+
}
|
|
175
|
+
return null;
|
|
176
|
+
}
|
|
177
|
+
//# sourceMappingURL=complete.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"complete.js","sourceRoot":"","sources":["../../../src/parser/complete.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* @module parser
|
|
4
|
+
* @description Transaction parsing utilities for SAP v2.
|
|
5
|
+
*
|
|
6
|
+
* Provides modular, composable functions for decoding on-chain SAP
|
|
7
|
+
* transactions into typed instruction data, argument objects, account
|
|
8
|
+
* lists, and protocol events.
|
|
9
|
+
*
|
|
10
|
+
* Three levels of parsing are available depending on your use case:
|
|
11
|
+
*
|
|
12
|
+
* | Function | Input | Output |
|
|
13
|
+
* |----------|-------|--------|
|
|
14
|
+
* | `parseSapInstructionsFromTransaction` | `TransactionResponse` (RPC) | Decoded instructions |
|
|
15
|
+
* | `parseSapInstructionsFromList` | `TransactionInstruction[]` | Decoded instructions |
|
|
16
|
+
* | `parseSapTransactionComplete` | `TransactionResponse` (RPC) | Instructions + events + inner calls |
|
|
17
|
+
*
|
|
18
|
+
* All functions are pure and stateless: they accept the Anchor coder
|
|
19
|
+
* (or full Program) as a parameter, making them safe for server-side
|
|
20
|
+
* indexer workers, edge functions (Node.js runtime), and test suites.
|
|
21
|
+
*
|
|
22
|
+
* @category Parser
|
|
23
|
+
* @since v0.5.0
|
|
24
|
+
*
|
|
25
|
+
* @example
|
|
26
|
+
* ```ts
|
|
27
|
+
* import {
|
|
28
|
+
* parseSapTransactionComplete,
|
|
29
|
+
* parseSapInstructionsFromList,
|
|
30
|
+
* containsSapInstruction,
|
|
31
|
+
* } from "@synapse-sap/sdk/parser";
|
|
32
|
+
* ```
|
|
33
|
+
*/
|
|
34
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
35
|
+
exports.TransactionParser = exports.extractAccountKeys = exports.filterSapInnerInstructions = exports.decodeInnerInstructions = exports.parseSapTransactionBatch = exports.parseSapTransactionComplete = exports.containsSapInstruction = exports.parseSapInstructionNamesFromList = exports.parseSapInstructionsFromList = exports.parseSapInstructionNamesFromTransaction = exports.parseSapInstructionsFromTransaction = void 0;
|
|
36
|
+
// ── Case 2A: from TransactionResponse ────────────────
|
|
37
|
+
var transaction_1 = require("./transaction");
|
|
38
|
+
Object.defineProperty(exports, "parseSapInstructionsFromTransaction", { enumerable: true, get: function () { return transaction_1.parseSapInstructionsFromTransaction; } });
|
|
39
|
+
Object.defineProperty(exports, "parseSapInstructionNamesFromTransaction", { enumerable: true, get: function () { return transaction_1.parseSapInstructionNamesFromTransaction; } });
|
|
40
|
+
// ── Case 2B: from TransactionInstruction[] ───────────
|
|
41
|
+
var instructions_1 = require("./instructions");
|
|
42
|
+
Object.defineProperty(exports, "parseSapInstructionsFromList", { enumerable: true, get: function () { return instructions_1.parseSapInstructionsFromList; } });
|
|
43
|
+
Object.defineProperty(exports, "parseSapInstructionNamesFromList", { enumerable: true, get: function () { return instructions_1.parseSapInstructionNamesFromList; } });
|
|
44
|
+
Object.defineProperty(exports, "containsSapInstruction", { enumerable: true, get: function () { return instructions_1.containsSapInstruction; } });
|
|
45
|
+
// ── Case 2 Complete: instructions + events + inner ───
|
|
46
|
+
var complete_1 = require("./complete");
|
|
47
|
+
Object.defineProperty(exports, "parseSapTransactionComplete", { enumerable: true, get: function () { return complete_1.parseSapTransactionComplete; } });
|
|
48
|
+
Object.defineProperty(exports, "parseSapTransactionBatch", { enumerable: true, get: function () { return complete_1.parseSapTransactionBatch; } });
|
|
49
|
+
// ── Inner instruction utilities ──────────────────────
|
|
50
|
+
var inner_1 = require("./inner");
|
|
51
|
+
Object.defineProperty(exports, "decodeInnerInstructions", { enumerable: true, get: function () { return inner_1.decodeInnerInstructions; } });
|
|
52
|
+
Object.defineProperty(exports, "filterSapInnerInstructions", { enumerable: true, get: function () { return inner_1.filterSapInnerInstructions; } });
|
|
53
|
+
Object.defineProperty(exports, "extractAccountKeys", { enumerable: true, get: function () { return inner_1.extractAccountKeys; } });
|
|
54
|
+
// ── OOP wrapper (for SapClient integration) ──────────
|
|
55
|
+
var client_1 = require("./client");
|
|
56
|
+
Object.defineProperty(exports, "TransactionParser", { enumerable: true, get: function () { return client_1.TransactionParser; } });
|
|
57
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|