@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,357 @@
1
+ /**
2
+ * @module pda
3
+ * @description Deterministic PDA derivation for every SAP v2 account.
4
+ *
5
+ * Each function returns `[PublicKey, bump]` and is pure — no network
6
+ * calls. All results are memoizable by the caller.
7
+ *
8
+ * Seeds mirror the Rust `#[account(seeds = [...])]` definitions exactly.
9
+ *
10
+ * @category PDA
11
+ * @since v0.1.0
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * import { deriveAgent, deriveEscrow } from "@synapse-sap/sdk/pda";
16
+ *
17
+ * const [agentPda, bump] = deriveAgent(walletPublicKey);
18
+ * const [escrowPda] = deriveEscrow(agentPda, depositor);
19
+ * ```
20
+ */
21
+ import { PublicKey } from "@solana/web3.js";
22
+ import { SAP_PROGRAM_ID, SEEDS } from "../constants";
23
+ // ── Helpers ──────────────────────────────────────────────────────
24
+ /**
25
+ * Thin wrapper around `PublicKey.findProgramAddressSync`.
26
+ *
27
+ * @name findPda
28
+ * @description Derives a PDA from the given seed buffers and program ID.
29
+ * @param seeds - Array of seed `Buffer`s / `Uint8Array`s.
30
+ * @param programId - The program to derive against (defaults to {@link SAP_PROGRAM_ID}).
31
+ * @returns {PdaResult} The derived `[pda, bump]` tuple.
32
+ * @category PDA
33
+ * @since v0.1.0
34
+ */
35
+ const findPda = (seeds, programId = SAP_PROGRAM_ID) => PublicKey.findProgramAddressSync(seeds, programId);
36
+ /**
37
+ * Encode a seed string as a UTF-8 `Buffer`.
38
+ *
39
+ * @name toSeedBuf
40
+ * @description Converts a string seed prefix to a `Buffer` suitable for PDA derivation.
41
+ * @param s - The seed string to encode.
42
+ * @returns {Buffer} UTF-8 encoded buffer.
43
+ * @category PDA
44
+ * @since v0.1.0
45
+ */
46
+ const toSeedBuf = (s) => Buffer.from(s);
47
+ /**
48
+ * Encode an unsigned 32-bit integer as a little-endian `Buffer`.
49
+ *
50
+ * @name u32le
51
+ * @description Produces a 4-byte LE buffer for numeric PDA seed segments (e.g., epoch index, page index).
52
+ * @param n - The number to encode.
53
+ * @returns {Buffer} 4-byte little-endian buffer.
54
+ * @category PDA
55
+ * @since v0.1.0
56
+ */
57
+ const u32le = (n) => {
58
+ const buf = Buffer.alloc(4);
59
+ buf.writeUInt32LE(n, 0);
60
+ return buf;
61
+ };
62
+ // ═════════════════════════════════════════════
63
+ // Core PDAs
64
+ // ═════════════════════════════════════════════
65
+ /**
66
+ * Derive the **GlobalRegistry** PDA.
67
+ *
68
+ * Seeds: `["sap_global"]`
69
+ *
70
+ * @name deriveGlobalRegistry
71
+ * @description Returns the singleton global registry address used by the SAP program.
72
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
73
+ * @returns {PdaResult} `[pda, bump]` tuple.
74
+ * @category PDA
75
+ * @since v0.1.0
76
+ * @see GlobalRegistry account type
77
+ */
78
+ export const deriveGlobalRegistry = (programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.GLOBAL)], programId);
79
+ /**
80
+ * Derive the **AgentAccount** PDA for a given wallet.
81
+ *
82
+ * Seeds: `["sap_agent", wallet]`
83
+ *
84
+ * @name deriveAgent
85
+ * @description Computes the unique agent PDA owned by `wallet`.
86
+ * @param wallet - The agent owner’s wallet `PublicKey`.
87
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
88
+ * @returns {PdaResult} `[pda, bump]` tuple.
89
+ * @category PDA
90
+ * @since v0.1.0
91
+ * @see AgentAccount
92
+ */
93
+ export const deriveAgent = (wallet, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.AGENT), wallet.toBuffer()], programId);
94
+ /**
95
+ * Derive the **AgentStats** PDA for a given agent.
96
+ *
97
+ * Seeds: `["sap_stats", agent_pda]`
98
+ *
99
+ * @name deriveAgentStats
100
+ * @description Computes the stats account PDA associated with an agent.
101
+ * @param agentPda - The agent’s on-chain PDA.
102
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
103
+ * @returns {PdaResult} `[pda, bump]` tuple.
104
+ * @category PDA
105
+ * @since v0.1.0
106
+ * @see AgentStats
107
+ */
108
+ export const deriveAgentStats = (agentPda, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.STATS), agentPda.toBuffer()], programId);
109
+ // ═════════════════════════════════════════════
110
+ // Feedback
111
+ // ═════════════════════════════════════════════
112
+ /**
113
+ * Derive the **Feedback** PDA for a reviewer on a specific agent.
114
+ *
115
+ * Seeds: `["sap_feedback", agent_pda, reviewer_wallet]`
116
+ *
117
+ * @name deriveFeedback
118
+ * @description Computes the feedback account PDA scoped to a reviewer–agent pair.
119
+ * @param agentPda - The target agent’s PDA.
120
+ * @param reviewer - The reviewer’s wallet `PublicKey`.
121
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
122
+ * @returns {PdaResult} `[pda, bump]` tuple.
123
+ * @category PDA
124
+ * @since v0.1.0
125
+ * @see FeedbackAccount
126
+ */
127
+ export const deriveFeedback = (agentPda, reviewer, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.FEEDBACK), agentPda.toBuffer(), reviewer.toBuffer()], programId);
128
+ // ═════════════════════════════════════════════
129
+ // Indexing
130
+ // ═════════════════════════════════════════════
131
+ /**
132
+ * Derive the **CapabilityIndex** PDA for a hashed capability string.
133
+ *
134
+ * Seeds: `["sap_cap_idx", capability_hash]`
135
+ *
136
+ * @name deriveCapabilityIndex
137
+ * @description Computes the capability index PDA used to look up agents by capability.
138
+ * @param capabilityHash - SHA-256 hash of the capability string (32 bytes).
139
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
140
+ * @returns {PdaResult} `[pda, bump]` tuple.
141
+ * @category PDA
142
+ * @since v0.1.0
143
+ * @see CapabilityIndex
144
+ */
145
+ export const deriveCapabilityIndex = (capabilityHash, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.CAPABILITY_INDEX), Buffer.from(capabilityHash)], programId);
146
+ /**
147
+ * Derive the **ProtocolIndex** PDA for a hashed protocol string.
148
+ *
149
+ * Seeds: `["sap_proto_idx", protocol_hash]`
150
+ *
151
+ * @name deriveProtocolIndex
152
+ * @description Computes the protocol index PDA used to look up agents by protocol.
153
+ * @param protocolHash - SHA-256 hash of the protocol string (32 bytes).
154
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
155
+ * @returns {PdaResult} `[pda, bump]` tuple.
156
+ * @category PDA
157
+ * @since v0.1.0
158
+ * @see ProtocolIndex
159
+ */
160
+ export const deriveProtocolIndex = (protocolHash, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.PROTOCOL_INDEX), Buffer.from(protocolHash)], programId);
161
+ /**
162
+ * Derive the **ToolCategoryIndex** PDA for a tool category discriminant.
163
+ *
164
+ * Seeds: `["sap_tool_cat", category_u8]`
165
+ *
166
+ * @name deriveToolCategoryIndex
167
+ * @description Computes the tool category index PDA used to look up tools by category.
168
+ * @param category - The `u8` category discriminant (see {@link TOOL_CATEGORY_VALUES}).
169
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
170
+ * @returns {PdaResult} `[pda, bump]` tuple.
171
+ * @category PDA
172
+ * @since v0.1.0
173
+ * @see ToolCategoryIndex
174
+ */
175
+ export const deriveToolCategoryIndex = (category, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.TOOL_CATEGORY), Buffer.from([category])], programId);
176
+ // ═════════════════════════════════════════════
177
+ // Memory Vault
178
+ // ═════════════════════════════════════════════
179
+ /**
180
+ * Derive the **MemoryVault** PDA for a given agent.
181
+ *
182
+ * Seeds: `["sap_vault", agent_pda]`
183
+ *
184
+ * @name deriveVault
185
+ * @description Computes the memory vault PDA owned by the specified agent.
186
+ * @param agentPda - The agent’s on-chain PDA.
187
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
188
+ * @returns {PdaResult} `[pda, bump]` tuple.
189
+ * @category PDA
190
+ * @since v0.1.0
191
+ * @see MemoryVault
192
+ */
193
+ export const deriveVault = (agentPda, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.VAULT), agentPda.toBuffer()], programId);
194
+ /**
195
+ * Derive the **Session** PDA for a vault and session hash.
196
+ *
197
+ * Seeds: `["sap_session", vault_pda, session_hash]`
198
+ *
199
+ * @name deriveSession
200
+ * @description Computes the session PDA scoped to a vault and unique session identifier.
201
+ * @param vaultPda - The parent vault’s PDA.
202
+ * @param sessionHash - SHA-256 hash identifying the session (32 bytes).
203
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
204
+ * @returns {PdaResult} `[pda, bump]` tuple.
205
+ * @category PDA
206
+ * @since v0.1.0
207
+ * @see SessionAccount
208
+ */
209
+ export const deriveSession = (vaultPda, sessionHash, programId = SAP_PROGRAM_ID) => findPda([
210
+ toSeedBuf(SEEDS.SESSION),
211
+ vaultPda.toBuffer(),
212
+ Buffer.from(sessionHash),
213
+ ], programId);
214
+ /**
215
+ * Derive the **EpochPage** PDA for a session at a given epoch index.
216
+ *
217
+ * Seeds: `["sap_epoch", session_pda, epoch_index_u32_le]`
218
+ *
219
+ * @name deriveEpochPage
220
+ * @description Computes the epoch page PDA for paginated memory inscriptions.
221
+ * @param sessionPda - The parent session’s PDA.
222
+ * @param epochIndex - Zero-based epoch page index.
223
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
224
+ * @returns {PdaResult} `[pda, bump]` tuple.
225
+ * @category PDA
226
+ * @since v0.1.0
227
+ * @see EpochPage
228
+ */
229
+ export const deriveEpochPage = (sessionPda, epochIndex, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.EPOCH), sessionPda.toBuffer(), u32le(epochIndex)], programId);
230
+ /**
231
+ * Derive the **VaultDelegate** PDA for a delegate on a vault.
232
+ *
233
+ * Seeds: `["sap_delegate", vault_pda, delegate_pubkey]`
234
+ *
235
+ * @name deriveVaultDelegate
236
+ * @description Computes the delegate authorization PDA granting a wallet write access to a vault.
237
+ * @param vaultPda - The parent vault’s PDA.
238
+ * @param delegate - The delegate’s wallet `PublicKey`.
239
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
240
+ * @returns {PdaResult} `[pda, bump]` tuple.
241
+ * @category PDA
242
+ * @since v0.1.0
243
+ * @see VaultDelegate
244
+ */
245
+ export const deriveVaultDelegate = (vaultPda, delegate, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.DELEGATE), vaultPda.toBuffer(), delegate.toBuffer()], programId);
246
+ /**
247
+ * Derive the **Checkpoint** PDA for a session at a given checkpoint index.
248
+ *
249
+ * Seeds: `["sap_checkpoint", session_pda, checkpoint_index_u32_le]`
250
+ *
251
+ * @name deriveCheckpoint
252
+ * @description Computes the checkpoint PDA storing a Merkle snapshot of session state.
253
+ * @param sessionPda - The parent session’s PDA.
254
+ * @param checkpointIndex - Zero-based checkpoint index.
255
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
256
+ * @returns {PdaResult} `[pda, bump]` tuple.
257
+ * @category PDA
258
+ * @since v0.1.0
259
+ * @see Checkpoint
260
+ */
261
+ export const deriveCheckpoint = (sessionPda, checkpointIndex, programId = SAP_PROGRAM_ID) => findPda([
262
+ toSeedBuf(SEEDS.CHECKPOINT),
263
+ sessionPda.toBuffer(),
264
+ u32le(checkpointIndex),
265
+ ], programId);
266
+ // ═════════════════════════════════════════════
267
+ // Tools
268
+ // ═════════════════════════════════════════════
269
+ /**
270
+ * Derive the **Tool** PDA for an agent and tool name hash.
271
+ *
272
+ * Seeds: `["sap_tool", agent_pda, tool_name_hash]`
273
+ *
274
+ * @name deriveTool
275
+ * @description Computes the tool registration PDA scoped to an agent and tool identifier.
276
+ * @param agentPda - The owning agent’s PDA.
277
+ * @param toolNameHash - SHA-256 hash of the tool name (32 bytes).
278
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
279
+ * @returns {PdaResult} `[pda, bump]` tuple.
280
+ * @category PDA
281
+ * @since v0.1.0
282
+ * @see ToolAccount
283
+ */
284
+ export const deriveTool = (agentPda, toolNameHash, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.TOOL), agentPda.toBuffer(), Buffer.from(toolNameHash)], programId);
285
+ // ═════════════════════════════════════════════
286
+ // Escrow
287
+ // ═════════════════════════════════════════════
288
+ /**
289
+ * Derive the **Escrow** PDA for an agent–depositor pair.
290
+ *
291
+ * Seeds: `["sap_escrow", agent_pda, depositor_wallet]`
292
+ *
293
+ * @name deriveEscrow
294
+ * @description Computes the escrow PDA holding deposited funds for service payments.
295
+ * @param agentPda - The service-providing agent’s PDA.
296
+ * @param depositor - The depositor’s wallet `PublicKey`.
297
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
298
+ * @returns {PdaResult} `[pda, bump]` tuple.
299
+ * @category PDA
300
+ * @since v0.1.0
301
+ * @see EscrowAccount
302
+ */
303
+ export const deriveEscrow = (agentPda, depositor, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.ESCROW), agentPda.toBuffer(), depositor.toBuffer()], programId);
304
+ // ═════════════════════════════════════════════
305
+ // Attestation
306
+ // ═════════════════════════════════════════════
307
+ /**
308
+ * Derive the **Attestation** PDA for an attester on a specific agent.
309
+ *
310
+ * Seeds: `["sap_attest", agent_pda, attester_wallet]`
311
+ *
312
+ * @name deriveAttestation
313
+ * @description Computes the attestation PDA recording a third-party’s trust assertion.
314
+ * @param agentPda - The attested agent’s PDA.
315
+ * @param attester - The attester’s wallet `PublicKey`.
316
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
317
+ * @returns {PdaResult} `[pda, bump]` tuple.
318
+ * @category PDA
319
+ * @since v0.1.0
320
+ * @see AttestationAccount
321
+ */
322
+ export const deriveAttestation = (agentPda, attester, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.ATTESTATION), agentPda.toBuffer(), attester.toBuffer()], programId);
323
+ // ═════════════════════════════════════════════
324
+ // Memory Ledger
325
+ // ═════════════════════════════════════════════
326
+ /**
327
+ * Derive the **MemoryLedger** PDA for a session.
328
+ *
329
+ * Seeds: `["sap_ledger", session_pda]`
330
+ *
331
+ * @name deriveLedger
332
+ * @description Computes the ledger PDA that tracks append-only entries for a session.
333
+ * @param sessionPda - The parent session’s PDA.
334
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
335
+ * @returns {PdaResult} `[pda, bump]` tuple.
336
+ * @category PDA
337
+ * @since v0.1.0
338
+ * @see MemoryLedger
339
+ */
340
+ export const deriveLedger = (sessionPda, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.LEDGER), sessionPda.toBuffer()], programId);
341
+ /**
342
+ * Derive the **LedgerPage** PDA for a ledger at a given page index.
343
+ *
344
+ * Seeds: `["sap_page", ledger_pda, page_index_u32_le]`
345
+ *
346
+ * @name deriveLedgerPage
347
+ * @description Computes the ledger page PDA for paginated ledger data storage.
348
+ * @param ledgerPda - The parent ledger’s PDA.
349
+ * @param pageIndex - Zero-based page index.
350
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
351
+ * @returns {PdaResult} `[pda, bump]` tuple.
352
+ * @category PDA
353
+ * @since v0.1.0
354
+ * @see LedgerPage
355
+ */
356
+ export const deriveLedgerPage = (ledgerPda, pageIndex, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.LEDGER_PAGE), ledgerPda.toBuffer(), u32le(pageIndex)], programId);
357
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pda/index.ts"],"names":[],"mappings":"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"}