@oobe-protocol-labs/synapse-sap-sdk 0.1.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.
Files changed (315) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +882 -0
  3. package/dist/cjs/constants/index.js +43 -0
  4. package/dist/cjs/constants/index.js.map +1 -0
  5. package/dist/cjs/constants/limits.js +161 -0
  6. package/dist/cjs/constants/limits.js.map +1 -0
  7. package/dist/cjs/constants/programs.js +78 -0
  8. package/dist/cjs/constants/programs.js.map +1 -0
  9. package/dist/cjs/constants/seeds.js +57 -0
  10. package/dist/cjs/constants/seeds.js.map +1 -0
  11. package/dist/cjs/core/client.js +391 -0
  12. package/dist/cjs/core/client.js.map +1 -0
  13. package/dist/cjs/core/connection.js +319 -0
  14. package/dist/cjs/core/connection.js.map +1 -0
  15. package/dist/cjs/core/index.js +24 -0
  16. package/dist/cjs/core/index.js.map +1 -0
  17. package/dist/cjs/errors/index.js +334 -0
  18. package/dist/cjs/errors/index.js.map +1 -0
  19. package/dist/cjs/events/index.js +136 -0
  20. package/dist/cjs/events/index.js.map +1 -0
  21. package/dist/cjs/idl/index.js +63 -0
  22. package/dist/cjs/idl/index.js.map +1 -0
  23. package/dist/cjs/idl/synapse_agent_sap.json +9710 -0
  24. package/dist/cjs/index.js +147 -0
  25. package/dist/cjs/index.js.map +1 -0
  26. package/dist/cjs/modules/agent.js +272 -0
  27. package/dist/cjs/modules/agent.js.map +1 -0
  28. package/dist/cjs/modules/attestation.js +147 -0
  29. package/dist/cjs/modules/attestation.js.map +1 -0
  30. package/dist/cjs/modules/base.js +128 -0
  31. package/dist/cjs/modules/base.js.map +1 -0
  32. package/dist/cjs/modules/escrow.js +246 -0
  33. package/dist/cjs/modules/escrow.js.map +1 -0
  34. package/dist/cjs/modules/feedback.js +166 -0
  35. package/dist/cjs/modules/feedback.js.map +1 -0
  36. package/dist/cjs/modules/index.js +35 -0
  37. package/dist/cjs/modules/index.js.map +1 -0
  38. package/dist/cjs/modules/indexing.js +375 -0
  39. package/dist/cjs/modules/indexing.js.map +1 -0
  40. package/dist/cjs/modules/ledger.js +234 -0
  41. package/dist/cjs/modules/ledger.js.map +1 -0
  42. package/dist/cjs/modules/tools.js +319 -0
  43. package/dist/cjs/modules/tools.js.map +1 -0
  44. package/dist/cjs/modules/vault.js +410 -0
  45. package/dist/cjs/modules/vault.js.map +1 -0
  46. package/dist/cjs/pda/index.js +377 -0
  47. package/dist/cjs/pda/index.js.map +1 -0
  48. package/dist/cjs/plugin/index.js +934 -0
  49. package/dist/cjs/plugin/index.js.map +1 -0
  50. package/dist/cjs/plugin/protocols.js +282 -0
  51. package/dist/cjs/plugin/protocols.js.map +1 -0
  52. package/dist/cjs/plugin/schemas.js +831 -0
  53. package/dist/cjs/plugin/schemas.js.map +1 -0
  54. package/dist/cjs/postgres/adapter.js +715 -0
  55. package/dist/cjs/postgres/adapter.js.map +1 -0
  56. package/dist/cjs/postgres/index.js +50 -0
  57. package/dist/cjs/postgres/index.js.map +1 -0
  58. package/dist/cjs/postgres/serializers.js +381 -0
  59. package/dist/cjs/postgres/serializers.js.map +1 -0
  60. package/dist/cjs/postgres/sync.js +221 -0
  61. package/dist/cjs/postgres/sync.js.map +1 -0
  62. package/dist/cjs/postgres/types.js +44 -0
  63. package/dist/cjs/postgres/types.js.map +1 -0
  64. package/dist/cjs/registries/builder.js +414 -0
  65. package/dist/cjs/registries/builder.js.map +1 -0
  66. package/dist/cjs/registries/discovery.js +362 -0
  67. package/dist/cjs/registries/discovery.js.map +1 -0
  68. package/dist/cjs/registries/index.js +51 -0
  69. package/dist/cjs/registries/index.js.map +1 -0
  70. package/dist/cjs/registries/session.js +433 -0
  71. package/dist/cjs/registries/session.js.map +1 -0
  72. package/dist/cjs/registries/x402.js +577 -0
  73. package/dist/cjs/registries/x402.js.map +1 -0
  74. package/dist/cjs/types/accounts.js +13 -0
  75. package/dist/cjs/types/accounts.js.map +1 -0
  76. package/dist/cjs/types/common.js +13 -0
  77. package/dist/cjs/types/common.js.map +1 -0
  78. package/dist/cjs/types/enums.js +174 -0
  79. package/dist/cjs/types/enums.js.map +1 -0
  80. package/dist/cjs/types/index.js +36 -0
  81. package/dist/cjs/types/index.js.map +1 -0
  82. package/dist/cjs/types/instructions.js +92 -0
  83. package/dist/cjs/types/instructions.js.map +1 -0
  84. package/dist/cjs/utils/hash.js +58 -0
  85. package/dist/cjs/utils/hash.js.map +1 -0
  86. package/dist/cjs/utils/index.js +27 -0
  87. package/dist/cjs/utils/index.js.map +1 -0
  88. package/dist/cjs/utils/serialization.js +105 -0
  89. package/dist/cjs/utils/serialization.js.map +1 -0
  90. package/dist/cjs/utils/validation.js +36 -0
  91. package/dist/cjs/utils/validation.js.map +1 -0
  92. package/dist/esm/constants/index.js +29 -0
  93. package/dist/esm/constants/index.js.map +1 -0
  94. package/dist/esm/constants/limits.js +158 -0
  95. package/dist/esm/constants/limits.js.map +1 -0
  96. package/dist/esm/constants/programs.js +75 -0
  97. package/dist/esm/constants/programs.js.map +1 -0
  98. package/dist/esm/constants/seeds.js +54 -0
  99. package/dist/esm/constants/seeds.js.map +1 -0
  100. package/dist/esm/core/client.js +384 -0
  101. package/dist/esm/core/client.js.map +1 -0
  102. package/dist/esm/core/connection.js +315 -0
  103. package/dist/esm/core/connection.js.map +1 -0
  104. package/dist/esm/core/index.js +19 -0
  105. package/dist/esm/core/index.js.map +1 -0
  106. package/dist/esm/errors/index.js +325 -0
  107. package/dist/esm/errors/index.js.map +1 -0
  108. package/dist/esm/events/index.js +132 -0
  109. package/dist/esm/events/index.js.map +1 -0
  110. package/dist/esm/idl/index.js +57 -0
  111. package/dist/esm/idl/index.js.map +1 -0
  112. package/dist/esm/idl/synapse_agent_sap.json +9710 -0
  113. package/dist/esm/index.js +70 -0
  114. package/dist/esm/index.js.map +1 -0
  115. package/dist/esm/modules/agent.js +268 -0
  116. package/dist/esm/modules/agent.js.map +1 -0
  117. package/dist/esm/modules/attestation.js +143 -0
  118. package/dist/esm/modules/attestation.js.map +1 -0
  119. package/dist/esm/modules/base.js +124 -0
  120. package/dist/esm/modules/base.js.map +1 -0
  121. package/dist/esm/modules/escrow.js +242 -0
  122. package/dist/esm/modules/escrow.js.map +1 -0
  123. package/dist/esm/modules/feedback.js +162 -0
  124. package/dist/esm/modules/feedback.js.map +1 -0
  125. package/dist/esm/modules/index.js +23 -0
  126. package/dist/esm/modules/index.js.map +1 -0
  127. package/dist/esm/modules/indexing.js +371 -0
  128. package/dist/esm/modules/indexing.js.map +1 -0
  129. package/dist/esm/modules/ledger.js +230 -0
  130. package/dist/esm/modules/ledger.js.map +1 -0
  131. package/dist/esm/modules/tools.js +315 -0
  132. package/dist/esm/modules/tools.js.map +1 -0
  133. package/dist/esm/modules/vault.js +406 -0
  134. package/dist/esm/modules/vault.js.map +1 -0
  135. package/dist/esm/pda/index.js +357 -0
  136. package/dist/esm/pda/index.js.map +1 -0
  137. package/dist/esm/plugin/index.js +927 -0
  138. package/dist/esm/plugin/index.js.map +1 -0
  139. package/dist/esm/plugin/protocols.js +279 -0
  140. package/dist/esm/plugin/protocols.js.map +1 -0
  141. package/dist/esm/plugin/schemas.js +828 -0
  142. package/dist/esm/plugin/schemas.js.map +1 -0
  143. package/dist/esm/postgres/adapter.js +678 -0
  144. package/dist/esm/postgres/adapter.js.map +1 -0
  145. package/dist/esm/postgres/index.js +27 -0
  146. package/dist/esm/postgres/index.js.map +1 -0
  147. package/dist/esm/postgres/serializers.js +362 -0
  148. package/dist/esm/postgres/serializers.js.map +1 -0
  149. package/dist/esm/postgres/sync.js +217 -0
  150. package/dist/esm/postgres/sync.js.map +1 -0
  151. package/dist/esm/postgres/types.js +41 -0
  152. package/dist/esm/postgres/types.js.map +1 -0
  153. package/dist/esm/registries/builder.js +410 -0
  154. package/dist/esm/registries/builder.js.map +1 -0
  155. package/dist/esm/registries/discovery.js +358 -0
  156. package/dist/esm/registries/discovery.js.map +1 -0
  157. package/dist/esm/registries/index.js +44 -0
  158. package/dist/esm/registries/index.js.map +1 -0
  159. package/dist/esm/registries/session.js +429 -0
  160. package/dist/esm/registries/session.js.map +1 -0
  161. package/dist/esm/registries/x402.js +573 -0
  162. package/dist/esm/registries/x402.js.map +1 -0
  163. package/dist/esm/types/accounts.js +12 -0
  164. package/dist/esm/types/accounts.js.map +1 -0
  165. package/dist/esm/types/common.js +12 -0
  166. package/dist/esm/types/common.js.map +1 -0
  167. package/dist/esm/types/enums.js +171 -0
  168. package/dist/esm/types/enums.js.map +1 -0
  169. package/dist/esm/types/index.js +25 -0
  170. package/dist/esm/types/index.js.map +1 -0
  171. package/dist/esm/types/instructions.js +89 -0
  172. package/dist/esm/types/instructions.js.map +1 -0
  173. package/dist/esm/utils/hash.js +53 -0
  174. package/dist/esm/utils/hash.js.map +1 -0
  175. package/dist/esm/utils/index.js +19 -0
  176. package/dist/esm/utils/index.js.map +1 -0
  177. package/dist/esm/utils/serialization.js +98 -0
  178. package/dist/esm/utils/serialization.js.map +1 -0
  179. package/dist/esm/utils/validation.js +33 -0
  180. package/dist/esm/utils/validation.js.map +1 -0
  181. package/dist/types/constants/index.d.ts +27 -0
  182. package/dist/types/constants/index.d.ts.map +1 -0
  183. package/dist/types/constants/limits.d.ts +149 -0
  184. package/dist/types/constants/limits.d.ts.map +1 -0
  185. package/dist/types/constants/programs.d.ts +69 -0
  186. package/dist/types/constants/programs.d.ts.map +1 -0
  187. package/dist/types/constants/seeds.d.ts +61 -0
  188. package/dist/types/constants/seeds.d.ts.map +1 -0
  189. package/dist/types/core/client.d.ts +323 -0
  190. package/dist/types/core/client.d.ts.map +1 -0
  191. package/dist/types/core/connection.d.ts +279 -0
  192. package/dist/types/core/connection.d.ts.map +1 -0
  193. package/dist/types/core/index.d.ts +20 -0
  194. package/dist/types/core/index.d.ts.map +1 -0
  195. package/dist/types/errors/index.d.ts +276 -0
  196. package/dist/types/errors/index.d.ts.map +1 -0
  197. package/dist/types/events/index.d.ts +248 -0
  198. package/dist/types/events/index.d.ts.map +1 -0
  199. package/dist/types/idl/index.d.ts +70 -0
  200. package/dist/types/idl/index.d.ts.map +1 -0
  201. package/dist/types/index.d.ts +68 -0
  202. package/dist/types/index.d.ts.map +1 -0
  203. package/dist/types/modules/agent.d.ts +166 -0
  204. package/dist/types/modules/agent.d.ts.map +1 -0
  205. package/dist/types/modules/attestation.d.ts +96 -0
  206. package/dist/types/modules/attestation.d.ts.map +1 -0
  207. package/dist/types/modules/base.d.ts +126 -0
  208. package/dist/types/modules/base.d.ts.map +1 -0
  209. package/dist/types/modules/escrow.d.ts +151 -0
  210. package/dist/types/modules/escrow.d.ts.map +1 -0
  211. package/dist/types/modules/feedback.d.ts +105 -0
  212. package/dist/types/modules/feedback.d.ts.map +1 -0
  213. package/dist/types/modules/index.d.ts +24 -0
  214. package/dist/types/modules/index.d.ts.map +1 -0
  215. package/dist/types/modules/indexing.d.ts +200 -0
  216. package/dist/types/modules/indexing.d.ts.map +1 -0
  217. package/dist/types/modules/ledger.d.ts +150 -0
  218. package/dist/types/modules/ledger.d.ts.map +1 -0
  219. package/dist/types/modules/tools.d.ts +182 -0
  220. package/dist/types/modules/tools.d.ts.map +1 -0
  221. package/dist/types/modules/vault.d.ts +240 -0
  222. package/dist/types/modules/vault.d.ts.map +1 -0
  223. package/dist/types/pda/index.d.ts +296 -0
  224. package/dist/types/pda/index.d.ts.map +1 -0
  225. package/dist/types/plugin/index.d.ts +171 -0
  226. package/dist/types/plugin/index.d.ts.map +1 -0
  227. package/dist/types/plugin/protocols.d.ts +152 -0
  228. package/dist/types/plugin/protocols.d.ts.map +1 -0
  229. package/dist/types/plugin/schemas.d.ts +823 -0
  230. package/dist/types/plugin/schemas.d.ts.map +1 -0
  231. package/dist/types/postgres/adapter.d.ts +355 -0
  232. package/dist/types/postgres/adapter.d.ts.map +1 -0
  233. package/dist/types/postgres/index.d.ts +24 -0
  234. package/dist/types/postgres/index.d.ts.map +1 -0
  235. package/dist/types/postgres/serializers.d.ts +30 -0
  236. package/dist/types/postgres/serializers.d.ts.map +1 -0
  237. package/dist/types/postgres/sync.d.ts +132 -0
  238. package/dist/types/postgres/sync.d.ts.map +1 -0
  239. package/dist/types/postgres/types.d.ts +167 -0
  240. package/dist/types/postgres/types.d.ts.map +1 -0
  241. package/dist/types/registries/builder.d.ts +340 -0
  242. package/dist/types/registries/builder.d.ts.map +1 -0
  243. package/dist/types/registries/discovery.d.ts +333 -0
  244. package/dist/types/registries/discovery.d.ts.map +1 -0
  245. package/dist/types/registries/index.d.ts +48 -0
  246. package/dist/types/registries/index.d.ts.map +1 -0
  247. package/dist/types/registries/session.d.ts +323 -0
  248. package/dist/types/registries/session.d.ts.map +1 -0
  249. package/dist/types/registries/x402.d.ts +463 -0
  250. package/dist/types/registries/x402.d.ts.map +1 -0
  251. package/dist/types/types/accounts.d.ts +565 -0
  252. package/dist/types/types/accounts.d.ts.map +1 -0
  253. package/dist/types/types/common.d.ts +166 -0
  254. package/dist/types/types/common.d.ts.map +1 -0
  255. package/dist/types/types/enums.d.ts +238 -0
  256. package/dist/types/types/enums.d.ts.map +1 -0
  257. package/dist/types/types/index.d.ts +28 -0
  258. package/dist/types/types/index.d.ts.map +1 -0
  259. package/dist/types/types/instructions.d.ts +366 -0
  260. package/dist/types/types/instructions.d.ts.map +1 -0
  261. package/dist/types/utils/hash.d.ts +48 -0
  262. package/dist/types/utils/hash.d.ts.map +1 -0
  263. package/dist/types/utils/index.d.ts +19 -0
  264. package/dist/types/utils/index.d.ts.map +1 -0
  265. package/dist/types/utils/serialization.d.ts +69 -0
  266. package/dist/types/utils/serialization.d.ts.map +1 -0
  267. package/dist/types/utils/validation.d.ts +29 -0
  268. package/dist/types/utils/validation.d.ts.map +1 -0
  269. package/package.json +178 -0
  270. package/src/constants/index.ts +44 -0
  271. package/src/constants/limits.ts +165 -0
  272. package/src/constants/programs.ts +83 -0
  273. package/src/constants/seeds.ts +66 -0
  274. package/src/core/client.ts +416 -0
  275. package/src/core/connection.ts +409 -0
  276. package/src/core/index.ts +20 -0
  277. package/src/errors/index.ts +346 -0
  278. package/src/events/index.ts +335 -0
  279. package/src/idl/index.ts +76 -0
  280. package/src/idl/synapse_agent_sap.json +9710 -0
  281. package/src/index.ts +253 -0
  282. package/src/modules/agent.ts +319 -0
  283. package/src/modules/attestation.ts +168 -0
  284. package/src/modules/base.ts +158 -0
  285. package/src/modules/escrow.ts +308 -0
  286. package/src/modules/feedback.ts +186 -0
  287. package/src/modules/index.ts +24 -0
  288. package/src/modules/indexing.ts +444 -0
  289. package/src/modules/ledger.ts +262 -0
  290. package/src/modules/tools.ts +411 -0
  291. package/src/modules/vault.ts +533 -0
  292. package/src/pda/index.ts +512 -0
  293. package/src/plugin/index.ts +1202 -0
  294. package/src/plugin/protocols.ts +404 -0
  295. package/src/plugin/schemas.ts +909 -0
  296. package/src/postgres/adapter.ts +904 -0
  297. package/src/postgres/index.ts +59 -0
  298. package/src/postgres/schema.sql +683 -0
  299. package/src/postgres/serializers.ts +485 -0
  300. package/src/postgres/sync.ts +254 -0
  301. package/src/postgres/types.ts +245 -0
  302. package/src/registries/builder.ts +607 -0
  303. package/src/registries/discovery.ts +572 -0
  304. package/src/registries/index.ts +77 -0
  305. package/src/registries/session.ts +613 -0
  306. package/src/registries/x402.ts +906 -0
  307. package/src/types/accounts.ts +618 -0
  308. package/src/types/common.ts +187 -0
  309. package/src/types/enums.ts +214 -0
  310. package/src/types/index.ts +92 -0
  311. package/src/types/instructions.ts +413 -0
  312. package/src/utils/hash.ts +57 -0
  313. package/src/utils/index.ts +19 -0
  314. package/src/utils/serialization.ts +98 -0
  315. package/src/utils/validation.ts +36 -0
@@ -0,0 +1,429 @@
1
+ /**
2
+ * @module registries/session
3
+ * @description Unified session lifecycle manager.
4
+ *
5
+ * Wraps the vault + ledger modules into a single cohesive API
6
+ * that manages the full memory session lifecycle:
7
+ * 1. Ensure vault exists (create if needed)
8
+ * 2. Open a named session
9
+ * 3. Initialize a ledger for the session
10
+ * 4. Write data (ring buffer + TX log)
11
+ * 5. Read latest entries from ring buffer
12
+ * 6. Seal the ring buffer into permanent archive pages
13
+ * 7. Close ledger + session when done
14
+ *
15
+ * This is the RECOMMENDED way to manage agent memory.
16
+ *
17
+ * @category Registries
18
+ * @since v0.1.0
19
+ *
20
+ * @example
21
+ * ```ts
22
+ * const session = client.session;
23
+ *
24
+ * // Start a new conversation session
25
+ * const ctx = await session.start("conversation-123");
26
+ *
27
+ * // Write messages
28
+ * await session.write(ctx, "Hello from the agent");
29
+ * await session.write(ctx, "Processing your request...");
30
+ *
31
+ * // Read latest messages from ring buffer
32
+ * const messages = await session.readLatest(ctx);
33
+ *
34
+ * // Seal into permanent archive
35
+ * await session.seal(ctx);
36
+ *
37
+ * // Close when done
38
+ * await session.close(ctx);
39
+ * ```
40
+ */
41
+ import { SystemProgram, } from "@solana/web3.js";
42
+ import { deriveAgent, deriveVault, deriveSession, deriveLedger, deriveLedgerPage, deriveGlobalRegistry, } from "../pda";
43
+ import { sha256, hashToArray } from "../utils";
44
+ // ═══════════════════════════════════════════════════════════════════
45
+ // Session Manager
46
+ // ═══════════════════════════════════════════════════════════════════
47
+ /**
48
+ * @name SessionManager
49
+ * @description Unified session lifecycle manager for agent memory.
50
+ *
51
+ * Wraps vault + ledger modules into a single API that manages
52
+ * the full memory session lifecycle: create vault, open session,
53
+ * write data, read ring buffer, seal archives, and close sessions.
54
+ *
55
+ * @category Registries
56
+ * @since v0.1.0
57
+ *
58
+ * @example
59
+ * ```ts
60
+ * const session = client.session;
61
+ * const ctx = await session.start("conversation-123");
62
+ * await session.write(ctx, "Hello from the agent");
63
+ * const entries = await session.readLatest(ctx);
64
+ * await session.seal(ctx);
65
+ * await session.close(ctx);
66
+ * ```
67
+ */
68
+ export class SessionManager {
69
+ program;
70
+ wallet;
71
+ constructor(program) {
72
+ this.program = program;
73
+ this.wallet = program.provider.wallet.publicKey;
74
+ }
75
+ // ── Context Derivation ───────────────────────────────
76
+ /**
77
+ * @name deriveContext
78
+ * @description Derive all PDAs for a session without creating anything.
79
+ * Pure computation — no network calls.
80
+ *
81
+ * @param sessionId - Human-readable session identifier (hashed for PDA derivation).
82
+ * @returns A {@link SessionContext} with all resolved PDAs.
83
+ * @since v0.1.0
84
+ */
85
+ deriveContext(sessionId) {
86
+ const sessionHash = sha256(sessionId);
87
+ const [agentPda] = deriveAgent(this.wallet);
88
+ const [vaultPda] = deriveVault(agentPda);
89
+ const [sessionPda] = deriveSession(vaultPda, sessionHash);
90
+ const [ledgerPda] = deriveLedger(sessionPda);
91
+ return {
92
+ sessionId,
93
+ sessionHash,
94
+ sessionHashArray: hashToArray(sessionHash),
95
+ agentPda,
96
+ vaultPda,
97
+ sessionPda,
98
+ ledgerPda,
99
+ wallet: this.wallet,
100
+ };
101
+ }
102
+ // ── Full Lifecycle ───────────────────────────────────
103
+ /**
104
+ * @name start
105
+ * @description Start a new session: ensures vault exists, opens session,
106
+ * and initializes a ledger. Idempotent — skips any step
107
+ * that’s already done.
108
+ *
109
+ * @param sessionId - Human-readable session name (hashed for PDA).
110
+ * @param vaultNonce - Optional 32-byte nonce for vault init (only used if vault doesn’t exist).
111
+ * @returns A {@link SessionContext} with all resolved PDAs.
112
+ * @since v0.1.0
113
+ */
114
+ async start(sessionId, vaultNonce) {
115
+ const ctx = this.deriveContext(sessionId);
116
+ // Step 1: Ensure vault exists
117
+ const vaultExists = await this.accountExists(ctx.vaultPda);
118
+ if (!vaultExists) {
119
+ const nonce = vaultNonce ?? hashToArray(sha256(`vault-nonce-${Date.now()}`));
120
+ const [globalPda] = deriveGlobalRegistry();
121
+ await this.methods
122
+ .initVault(nonce)
123
+ .accounts({
124
+ wallet: this.wallet,
125
+ agent: ctx.agentPda,
126
+ vault: ctx.vaultPda,
127
+ globalRegistry: globalPda,
128
+ systemProgram: SystemProgram.programId,
129
+ })
130
+ .rpc();
131
+ }
132
+ // Step 2: Open session
133
+ const sessionExists = await this.accountExists(ctx.sessionPda);
134
+ if (!sessionExists) {
135
+ await this.methods
136
+ .openSession(ctx.sessionHashArray)
137
+ .accounts({
138
+ wallet: this.wallet,
139
+ vault: ctx.vaultPda,
140
+ session: ctx.sessionPda,
141
+ systemProgram: SystemProgram.programId,
142
+ })
143
+ .rpc();
144
+ }
145
+ // Step 3: Initialize ledger
146
+ const ledgerExists = await this.accountExists(ctx.ledgerPda);
147
+ if (!ledgerExists) {
148
+ await this.methods
149
+ .initLedger()
150
+ .accounts({
151
+ wallet: this.wallet,
152
+ session: ctx.sessionPda,
153
+ ledger: ctx.ledgerPda,
154
+ systemProgram: SystemProgram.programId,
155
+ })
156
+ .rpc();
157
+ }
158
+ return ctx;
159
+ }
160
+ /**
161
+ * @name write
162
+ * @description Write data to a session (ring buffer + permanent TX log).
163
+ * Cost: TX fee only (~0.000005 SOL per write).
164
+ *
165
+ * @param ctx - Session context from {@link SessionManager.start} or {@link SessionManager.deriveContext}.
166
+ * @param data - UTF-8 string or raw bytes to write.
167
+ * @returns A {@link WriteResult} with the transaction signature, content hash, and data size.
168
+ * @since v0.1.0
169
+ */
170
+ async write(ctx, data) {
171
+ const dataBuffer = typeof data === "string" ? Buffer.from(data, "utf-8") : Buffer.from(data);
172
+ const contentHash = hashToArray(sha256(dataBuffer));
173
+ const txSignature = await this.methods
174
+ .writeLedger(dataBuffer, contentHash)
175
+ .accounts({
176
+ wallet: this.wallet,
177
+ session: ctx.sessionPda,
178
+ ledger: ctx.ledgerPda,
179
+ })
180
+ .rpc();
181
+ return {
182
+ txSignature,
183
+ contentHash,
184
+ dataSize: dataBuffer.length,
185
+ };
186
+ }
187
+ /**
188
+ * @name readLatest
189
+ * @description Read the latest entries from the ring buffer.
190
+ * FREE — uses `getAccountInfo()` on any RPC (no archival needed).
191
+ *
192
+ * @param ctx - Session context.
193
+ * @returns An array of {@link RingBufferEntry} from the current ring buffer.
194
+ * @since v0.1.0
195
+ */
196
+ async readLatest(ctx) {
197
+ const ledger = await this.fetchNullable("memoryLedger", ctx.ledgerPda);
198
+ if (!ledger)
199
+ return [];
200
+ return this.decodeRingBuffer(ledger.ring);
201
+ }
202
+ /**
203
+ * @name seal
204
+ * @description Seal the ring buffer into a permanent LedgerPage.
205
+ * Creates a write-once, never-delete archive (~0.031 SOL per page).
206
+ *
207
+ * @param ctx - Session context.
208
+ * @returns A {@link SealResult} with the transaction signature and page index.
209
+ * @since v0.1.0
210
+ */
211
+ async seal(ctx) {
212
+ const ledger = await this.fetch("memoryLedger", ctx.ledgerPda);
213
+ const pageIndex = ledger.numPages;
214
+ const [pagePda] = deriveLedgerPage(ctx.ledgerPda, pageIndex);
215
+ const txSignature = await this.methods
216
+ .sealLedger()
217
+ .accounts({
218
+ wallet: this.wallet,
219
+ session: ctx.sessionPda,
220
+ ledger: ctx.ledgerPda,
221
+ page: pagePda,
222
+ systemProgram: SystemProgram.programId,
223
+ })
224
+ .rpc();
225
+ return { txSignature, pageIndex };
226
+ }
227
+ /**
228
+ * @name closeLedger
229
+ * @description Close the ledger and reclaim ~0.032 SOL rent.
230
+ *
231
+ * @param ctx - Session context.
232
+ * @returns The transaction signature.
233
+ * @since v0.1.0
234
+ */
235
+ async closeLedger(ctx) {
236
+ return this.methods
237
+ .closeLedger()
238
+ .accounts({
239
+ wallet: this.wallet,
240
+ session: ctx.sessionPda,
241
+ ledger: ctx.ledgerPda,
242
+ })
243
+ .rpc();
244
+ }
245
+ /**
246
+ * @name closeSession
247
+ * @description Close the session (no more writes allowed).
248
+ *
249
+ * @param ctx - Session context.
250
+ * @returns The transaction signature.
251
+ * @since v0.1.0
252
+ */
253
+ async closeSession(ctx) {
254
+ return this.methods
255
+ .closeSession()
256
+ .accounts({
257
+ wallet: this.wallet,
258
+ vault: ctx.vaultPda,
259
+ session: ctx.sessionPda,
260
+ })
261
+ .rpc();
262
+ }
263
+ /**
264
+ * @name close
265
+ * @description Full session teardown: close ledger → close session.
266
+ * Reclaims all rent. Idempotent — skips steps already done.
267
+ *
268
+ * @param ctx - Session context.
269
+ * @returns Resolves when the session is fully closed.
270
+ * @since v0.1.0
271
+ */
272
+ async close(ctx) {
273
+ const ledgerExists = await this.accountExists(ctx.ledgerPda);
274
+ if (ledgerExists) {
275
+ await this.closeLedger(ctx);
276
+ }
277
+ const sessionData = await this.fetchNullable("sessionLedger", ctx.sessionPda);
278
+ if (sessionData && !sessionData.isClosed) {
279
+ await this.closeSession(ctx);
280
+ }
281
+ }
282
+ // ── Status & Reading ─────────────────────────────────
283
+ /**
284
+ * @name getStatus
285
+ * @description Get the full status of a session.
286
+ * Returns vault/session/ledger existence, closure state, and metrics.
287
+ *
288
+ * @param ctx - Session context.
289
+ * @returns A {@link SessionStatus} with all session state information.
290
+ * @since v0.1.0
291
+ */
292
+ async getStatus(ctx) {
293
+ const [vaultExists, sessionData, ledgerData] = await Promise.all([
294
+ this.accountExists(ctx.vaultPda),
295
+ this.fetchNullable("sessionLedger", ctx.sessionPda),
296
+ this.fetchNullable("memoryLedger", ctx.ledgerPda),
297
+ ]);
298
+ return {
299
+ vaultExists,
300
+ sessionExists: sessionData !== null,
301
+ ledgerExists: ledgerData !== null,
302
+ isClosed: sessionData?.isClosed ?? false,
303
+ totalEntries: ledgerData?.numEntries ?? 0,
304
+ totalDataSize: ledgerData?.totalDataSize?.toString() ?? "0",
305
+ numPages: ledgerData?.numPages ?? 0,
306
+ merkleRoot: ledgerData
307
+ ? Buffer.from(ledgerData.merkleRoot).toString("hex")
308
+ : "0".repeat(64),
309
+ };
310
+ }
311
+ /**
312
+ * @name readPage
313
+ * @description Read a sealed archive page by index.
314
+ *
315
+ * @param ctx - Session context.
316
+ * @param pageIndex - Zero-based index of the sealed page.
317
+ * @returns An array of {@link RingBufferEntry} from the sealed page.
318
+ * @since v0.1.0
319
+ */
320
+ async readPage(ctx, pageIndex) {
321
+ const [pagePda] = deriveLedgerPage(ctx.ledgerPda, pageIndex);
322
+ const page = await this.fetch("ledgerPage", pagePda);
323
+ return this.decodeRingBuffer(page.data);
324
+ }
325
+ /**
326
+ * @name readAll
327
+ * @description Read ALL data: ring buffer (latest) + all sealed pages (history).
328
+ * Returns entries in chronological order (oldest first).
329
+ *
330
+ * @param ctx - Session context.
331
+ * @returns An array of all {@link RingBufferEntry} in chronological order.
332
+ * @since v0.1.0
333
+ */
334
+ async readAll(ctx) {
335
+ const ledger = await this.fetchNullable("memoryLedger", ctx.ledgerPda);
336
+ if (!ledger)
337
+ return [];
338
+ const allEntries = [];
339
+ // Read all sealed pages (oldest first)
340
+ for (let i = 0; i < ledger.numPages; i++) {
341
+ const pageEntries = await this.readPage(ctx, i);
342
+ allEntries.push(...pageEntries);
343
+ }
344
+ // Append current ring buffer (latest)
345
+ const ringEntries = this.decodeRingBuffer(ledger.ring);
346
+ allEntries.push(...ringEntries);
347
+ return allEntries;
348
+ }
349
+ // ── Internals ────────────────────────────────────────
350
+ /**
351
+ * @name decodeRingBuffer
352
+ * @description Decode a raw ring buffer byte array into structured entries.
353
+ * Parses length-prefixed (u16 LE) entries from the byte stream.
354
+ * @param ring - Raw ring buffer bytes.
355
+ * @returns An array of decoded {@link RingBufferEntry}.
356
+ * @private
357
+ */
358
+ decodeRingBuffer(ring) {
359
+ const buf = Buffer.from(ring);
360
+ const entries = [];
361
+ let offset = 0;
362
+ while (offset + 2 <= buf.length) {
363
+ const len = buf.readUInt16LE(offset);
364
+ if (len === 0)
365
+ break;
366
+ offset += 2;
367
+ if (offset + len > buf.length)
368
+ break;
369
+ const data = new Uint8Array(buf.subarray(offset, offset + len));
370
+ entries.push({
371
+ data,
372
+ text: Buffer.from(data).toString("utf-8"),
373
+ size: len,
374
+ });
375
+ offset += len;
376
+ }
377
+ return entries;
378
+ }
379
+ /**
380
+ * @name accountExists
381
+ * @description Check if an on-chain account exists at the given PDA.
382
+ * @param pda - Account public key to check.
383
+ * @returns `true` if the account exists, `false` otherwise.
384
+ * @private
385
+ */
386
+ async accountExists(pda) {
387
+ const info = await this.program.provider.connection.getAccountInfo(pda);
388
+ return info !== null;
389
+ }
390
+ /**
391
+ * @name methods
392
+ * @description Accessor for the Anchor program methods namespace.
393
+ * @returns The program methods object for building RPC calls.
394
+ * @private
395
+ */
396
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
397
+ get methods() {
398
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-return
399
+ return this.program.methods;
400
+ }
401
+ /**
402
+ * @name fetch
403
+ * @description Fetch an on-chain account by name and PDA. Throws if not found.
404
+ * @param name - Anchor account discriminator name.
405
+ * @param pda - Account public key to fetch.
406
+ * @returns The deserialized account data.
407
+ * @throws If the account does not exist.
408
+ * @private
409
+ */
410
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
411
+ async fetch(name, pda) {
412
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-explicit-any
413
+ return this.program.account[name].fetch(pda);
414
+ }
415
+ /**
416
+ * @name fetchNullable
417
+ * @description Fetch an on-chain account by name and PDA. Returns `null` if not found.
418
+ * @param name - Anchor account discriminator name.
419
+ * @param pda - Account public key to fetch.
420
+ * @returns The deserialized account data, or `null` if the account does not exist.
421
+ * @private
422
+ */
423
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
424
+ async fetchNullable(name, pda) {
425
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-explicit-any
426
+ return this.program.account[name].fetchNullable(pda);
427
+ }
428
+ }
429
+ //# sourceMappingURL=session.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/registries/session.ts"],"names":[],"mappings":"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"}