@oobe-protocol-labs/synapse-sap-sdk 0.14.0 → 0.15.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 (651) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +986 -0
  3. package/dist/cjs/client.js +30 -13
  4. package/dist/cjs/client.js.map +1 -1
  5. package/dist/cjs/constants/addresses.js +143 -0
  6. package/dist/cjs/constants/addresses.js.map +1 -0
  7. package/dist/cjs/constants/index.js +64 -0
  8. package/dist/cjs/constants/index.js.map +1 -0
  9. package/dist/cjs/constants/limits.js +161 -0
  10. package/dist/cjs/constants/limits.js.map +1 -0
  11. package/dist/cjs/constants/network.js +81 -0
  12. package/dist/cjs/constants/network.js.map +1 -0
  13. package/dist/cjs/constants/payments.js +137 -0
  14. package/dist/cjs/constants/payments.js.map +1 -0
  15. package/dist/cjs/constants/programs.js +78 -0
  16. package/dist/cjs/constants/programs.js.map +1 -0
  17. package/dist/cjs/constants/seeds.js +76 -0
  18. package/dist/cjs/constants/seeds.js.map +1 -0
  19. package/dist/cjs/constants.js +39 -32
  20. package/dist/cjs/constants.js.map +1 -1
  21. package/dist/cjs/core/client.js +546 -0
  22. package/dist/cjs/core/client.js.map +1 -0
  23. package/dist/cjs/core/connection.js +350 -0
  24. package/dist/cjs/core/connection.js.map +1 -0
  25. package/dist/cjs/core/index.js +25 -0
  26. package/dist/cjs/core/index.js.map +1 -0
  27. package/dist/cjs/errors/index.js +334 -0
  28. package/dist/cjs/errors/index.js.map +1 -0
  29. package/dist/cjs/errors.js +15 -5
  30. package/dist/cjs/errors.js.map +1 -1
  31. package/dist/cjs/events/geyser.js +295 -0
  32. package/dist/cjs/events/geyser.js.map +1 -0
  33. package/dist/cjs/events/index.js +32 -26
  34. package/dist/cjs/events/index.js.map +1 -1
  35. package/dist/cjs/idl/index.js +63 -0
  36. package/dist/cjs/idl/index.js.map +1 -0
  37. package/dist/cjs/idl/synapse_agent_sap.json +14595 -0
  38. package/dist/cjs/instructions/agent.js +1 -0
  39. package/dist/cjs/instructions/agent.js.map +1 -1
  40. package/dist/cjs/instructions/attestation.js +1 -0
  41. package/dist/cjs/instructions/attestation.js.map +1 -1
  42. package/dist/cjs/instructions/digest.js +1 -0
  43. package/dist/cjs/instructions/digest.js.map +1 -1
  44. package/dist/cjs/instructions/dispute.js +1 -0
  45. package/dist/cjs/instructions/dispute.js.map +1 -1
  46. package/dist/cjs/instructions/escrow.js +1 -0
  47. package/dist/cjs/instructions/escrow.js.map +1 -1
  48. package/dist/cjs/instructions/global.js +1 -0
  49. package/dist/cjs/instructions/global.js.map +1 -1
  50. package/dist/cjs/instructions/indexing.js +1 -0
  51. package/dist/cjs/instructions/indexing.js.map +1 -1
  52. package/dist/cjs/instructions/misc.js +1 -0
  53. package/dist/cjs/instructions/misc.js.map +1 -1
  54. package/dist/cjs/instructions/session.js +1 -0
  55. package/dist/cjs/instructions/session.js.map +1 -1
  56. package/dist/cjs/instructions/staking.js +1 -0
  57. package/dist/cjs/instructions/staking.js.map +1 -1
  58. package/dist/cjs/instructions/subscription.js +1 -0
  59. package/dist/cjs/instructions/subscription.js.map +1 -1
  60. package/dist/cjs/instructions/tools.js +1 -0
  61. package/dist/cjs/instructions/tools.js.map +1 -1
  62. package/dist/cjs/instructions/vault.js +1 -0
  63. package/dist/cjs/instructions/vault.js.map +1 -1
  64. package/dist/cjs/modules/agent.js +272 -0
  65. package/dist/cjs/modules/agent.js.map +1 -0
  66. package/dist/cjs/modules/attestation.js +147 -0
  67. package/dist/cjs/modules/attestation.js.map +1 -0
  68. package/dist/cjs/modules/base.js +189 -0
  69. package/dist/cjs/modules/base.js.map +1 -0
  70. package/dist/cjs/modules/escrow-v2.js +607 -0
  71. package/dist/cjs/modules/escrow-v2.js.map +1 -0
  72. package/dist/cjs/modules/escrow.js +336 -0
  73. package/dist/cjs/modules/escrow.js.map +1 -0
  74. package/dist/cjs/modules/feedback.js +166 -0
  75. package/dist/cjs/modules/feedback.js.map +1 -0
  76. package/dist/cjs/modules/index.js +43 -0
  77. package/dist/cjs/modules/index.js.map +1 -0
  78. package/dist/cjs/modules/indexing.js +375 -0
  79. package/dist/cjs/modules/indexing.js.map +1 -0
  80. package/dist/cjs/modules/ledger.js +234 -0
  81. package/dist/cjs/modules/ledger.js.map +1 -0
  82. package/dist/cjs/modules/receipt.js +148 -0
  83. package/dist/cjs/modules/receipt.js.map +1 -0
  84. package/dist/cjs/modules/staking.js +159 -0
  85. package/dist/cjs/modules/staking.js.map +1 -0
  86. package/dist/cjs/modules/subscription.js +96 -0
  87. package/dist/cjs/modules/subscription.js.map +1 -0
  88. package/dist/cjs/modules/tools.js +345 -0
  89. package/dist/cjs/modules/tools.js.map +1 -0
  90. package/dist/cjs/modules/vault.js +427 -0
  91. package/dist/cjs/modules/vault.js.map +1 -0
  92. package/dist/cjs/parser/client.js +146 -0
  93. package/dist/cjs/parser/client.js.map +1 -0
  94. package/dist/cjs/parser/complete.js +177 -0
  95. package/dist/cjs/parser/complete.js.map +1 -0
  96. package/dist/cjs/parser/index.js +57 -0
  97. package/dist/cjs/parser/index.js.map +1 -0
  98. package/dist/cjs/parser/inner.js +185 -0
  99. package/dist/cjs/parser/inner.js.map +1 -0
  100. package/dist/cjs/parser/instructions.js +114 -0
  101. package/dist/cjs/parser/instructions.js.map +1 -0
  102. package/dist/cjs/parser/transaction.js +153 -0
  103. package/dist/cjs/parser/transaction.js.map +1 -0
  104. package/dist/cjs/parser/types.js +14 -0
  105. package/dist/cjs/parser/types.js.map +1 -0
  106. package/dist/cjs/pda/index.js +672 -0
  107. package/dist/cjs/pda/index.js.map +1 -0
  108. package/dist/cjs/plugin/index.js +952 -0
  109. package/dist/cjs/plugin/index.js.map +1 -0
  110. package/dist/cjs/plugin/protocols.js +282 -0
  111. package/dist/cjs/plugin/protocols.js.map +1 -0
  112. package/dist/cjs/plugin/schemas.js +863 -0
  113. package/dist/cjs/plugin/schemas.js.map +1 -0
  114. package/dist/cjs/postgres/adapter.js +715 -0
  115. package/dist/cjs/postgres/adapter.js.map +1 -0
  116. package/dist/cjs/postgres/index.js +50 -0
  117. package/dist/cjs/postgres/index.js.map +1 -0
  118. package/dist/cjs/postgres/serializers.js +381 -0
  119. package/dist/cjs/postgres/serializers.js.map +1 -0
  120. package/dist/cjs/postgres/sync.js +289 -0
  121. package/dist/cjs/postgres/sync.js.map +1 -0
  122. package/dist/cjs/postgres/types.js +44 -0
  123. package/dist/cjs/postgres/types.js.map +1 -0
  124. package/dist/cjs/registries/builder.js +414 -0
  125. package/dist/cjs/registries/builder.js.map +1 -0
  126. package/dist/cjs/registries/discovery.js +362 -0
  127. package/dist/cjs/registries/discovery.js.map +1 -0
  128. package/dist/cjs/registries/fairscale.js +639 -0
  129. package/dist/cjs/registries/fairscale.js.map +1 -0
  130. package/dist/cjs/registries/index.js +58 -0
  131. package/dist/cjs/registries/index.js.map +1 -0
  132. package/dist/cjs/registries/metaplex-bridge.js +743 -0
  133. package/dist/cjs/registries/metaplex-bridge.js.map +1 -0
  134. package/dist/cjs/registries/session.js +433 -0
  135. package/dist/cjs/registries/session.js.map +1 -0
  136. package/dist/cjs/registries/x402.js +668 -0
  137. package/dist/cjs/registries/x402.js.map +1 -0
  138. package/dist/cjs/types/accounts.js +13 -0
  139. package/dist/cjs/types/accounts.js.map +1 -0
  140. package/dist/cjs/types/common.js +13 -0
  141. package/dist/cjs/types/common.js.map +1 -0
  142. package/dist/cjs/types/endpoint.js +15 -0
  143. package/dist/cjs/types/endpoint.js.map +1 -0
  144. package/dist/cjs/types/enums.js +269 -0
  145. package/dist/cjs/types/enums.js.map +1 -0
  146. package/dist/cjs/types/index.js +41 -0
  147. package/dist/cjs/types/index.js.map +1 -0
  148. package/dist/cjs/types/instructions.js +92 -0
  149. package/dist/cjs/types/instructions.js.map +1 -0
  150. package/dist/cjs/types.js +4 -1
  151. package/dist/cjs/types.js.map +1 -1
  152. package/dist/cjs/utils/anchor-errors.js +453 -0
  153. package/dist/cjs/utils/anchor-errors.js.map +1 -0
  154. package/dist/cjs/utils/endpoint-validator.js +232 -0
  155. package/dist/cjs/utils/endpoint-validator.js.map +1 -0
  156. package/dist/cjs/utils/escrow-validation.js +219 -0
  157. package/dist/cjs/utils/escrow-validation.js.map +1 -0
  158. package/dist/cjs/utils/hash.js +109 -0
  159. package/dist/cjs/utils/hash.js.map +1 -0
  160. package/dist/cjs/utils/index.js +10 -4
  161. package/dist/cjs/utils/index.js.map +1 -1
  162. package/dist/cjs/utils/merchant-validator.js +246 -0
  163. package/dist/cjs/utils/merchant-validator.js.map +1 -0
  164. package/dist/cjs/utils/network-normalizer.js +236 -0
  165. package/dist/cjs/utils/network-normalizer.js.map +1 -0
  166. package/dist/cjs/utils/priority-fee.js +215 -0
  167. package/dist/cjs/utils/priority-fee.js.map +1 -0
  168. package/dist/cjs/utils/rpc-strategy.js +239 -0
  169. package/dist/cjs/utils/rpc-strategy.js.map +1 -0
  170. package/dist/cjs/utils/schemas.js +331 -0
  171. package/dist/cjs/utils/schemas.js.map +1 -0
  172. package/dist/cjs/utils/serialization.js +105 -0
  173. package/dist/cjs/utils/serialization.js.map +1 -0
  174. package/dist/cjs/utils/validate.js +1 -1
  175. package/dist/cjs/utils/validate.js.map +1 -1
  176. package/dist/cjs/utils/validation.js +36 -0
  177. package/dist/cjs/utils/validation.js.map +1 -0
  178. package/dist/cjs/utils/volume-curve.js +117 -0
  179. package/dist/cjs/utils/volume-curve.js.map +1 -0
  180. package/dist/cjs/utils/x402-direct.js +231 -0
  181. package/dist/cjs/utils/x402-direct.js.map +1 -0
  182. package/dist/esm/client.js +30 -13
  183. package/dist/esm/client.js.map +1 -1
  184. package/dist/esm/constants/addresses.d.ts +117 -0
  185. package/dist/esm/constants/addresses.d.ts.map +1 -0
  186. package/dist/esm/constants/addresses.js +140 -0
  187. package/dist/esm/constants/addresses.js.map +1 -0
  188. package/dist/esm/constants/index.d.ts +31 -0
  189. package/dist/esm/constants/index.d.ts.map +1 -0
  190. package/dist/esm/constants/index.js +35 -0
  191. package/dist/esm/constants/index.js.map +1 -0
  192. package/dist/esm/constants/limits.d.ts +149 -0
  193. package/dist/esm/constants/limits.d.ts.map +1 -0
  194. package/dist/esm/constants/limits.js +158 -0
  195. package/dist/esm/constants/limits.js.map +1 -0
  196. package/dist/esm/constants/network.d.ts +81 -0
  197. package/dist/esm/constants/network.d.ts.map +1 -0
  198. package/dist/esm/constants/network.js +78 -0
  199. package/dist/esm/constants/network.js.map +1 -0
  200. package/dist/esm/constants/payments.d.ts +121 -0
  201. package/dist/esm/constants/payments.d.ts.map +1 -0
  202. package/dist/esm/constants/payments.js +131 -0
  203. package/dist/esm/constants/payments.js.map +1 -0
  204. package/dist/esm/constants/programs.d.ts +69 -0
  205. package/dist/esm/constants/programs.d.ts.map +1 -0
  206. package/dist/esm/constants/programs.js +75 -0
  207. package/dist/esm/constants/programs.js.map +1 -0
  208. package/dist/esm/constants/seeds.d.ts +80 -0
  209. package/dist/esm/constants/seeds.d.ts.map +1 -0
  210. package/dist/esm/constants/seeds.js +73 -0
  211. package/dist/esm/constants/seeds.js.map +1 -0
  212. package/dist/esm/constants.d.ts +14 -27
  213. package/dist/esm/constants.d.ts.map +1 -1
  214. package/dist/esm/constants.js +16 -31
  215. package/dist/esm/constants.js.map +1 -1
  216. package/dist/esm/core/client.d.ts +452 -0
  217. package/dist/esm/core/client.d.ts.map +1 -0
  218. package/dist/esm/core/client.js +539 -0
  219. package/dist/esm/core/client.js.map +1 -0
  220. package/dist/esm/core/connection.d.ts +305 -0
  221. package/dist/esm/core/connection.d.ts.map +1 -0
  222. package/dist/esm/core/connection.js +345 -0
  223. package/dist/esm/core/connection.js.map +1 -0
  224. package/dist/esm/core/index.d.ts +20 -0
  225. package/dist/esm/core/index.d.ts.map +1 -0
  226. package/dist/esm/core/index.js +19 -0
  227. package/dist/esm/core/index.js.map +1 -0
  228. package/dist/esm/errors/index.d.ts +276 -0
  229. package/dist/esm/errors/index.d.ts.map +1 -0
  230. package/dist/esm/errors/index.js +325 -0
  231. package/dist/esm/errors/index.js.map +1 -0
  232. package/dist/esm/errors.d.ts +8 -0
  233. package/dist/esm/errors.d.ts.map +1 -1
  234. package/dist/esm/errors.js +8 -0
  235. package/dist/esm/errors.js.map +1 -1
  236. package/dist/esm/events/geyser.d.ts +150 -0
  237. package/dist/esm/events/geyser.d.ts.map +1 -0
  238. package/dist/esm/events/geyser.js +258 -0
  239. package/dist/esm/events/geyser.js.map +1 -0
  240. package/dist/esm/events/index.d.ts +11 -7
  241. package/dist/esm/events/index.d.ts.map +1 -1
  242. package/dist/esm/events/index.js +30 -26
  243. package/dist/esm/events/index.js.map +1 -1
  244. package/dist/esm/idl/index.d.ts +70 -0
  245. package/dist/esm/idl/index.d.ts.map +1 -0
  246. package/dist/esm/idl/index.js +57 -0
  247. package/dist/esm/idl/index.js.map +1 -0
  248. package/dist/esm/idl/synapse_agent_sap.json +14595 -0
  249. package/dist/esm/instructions/agent.js +1 -0
  250. package/dist/esm/instructions/agent.js.map +1 -1
  251. package/dist/esm/instructions/attestation.js +1 -0
  252. package/dist/esm/instructions/attestation.js.map +1 -1
  253. package/dist/esm/instructions/digest.js +1 -0
  254. package/dist/esm/instructions/digest.js.map +1 -1
  255. package/dist/esm/instructions/dispute.js +1 -0
  256. package/dist/esm/instructions/dispute.js.map +1 -1
  257. package/dist/esm/instructions/escrow.js +1 -0
  258. package/dist/esm/instructions/escrow.js.map +1 -1
  259. package/dist/esm/instructions/global.js +1 -0
  260. package/dist/esm/instructions/global.js.map +1 -1
  261. package/dist/esm/instructions/indexing.js +1 -0
  262. package/dist/esm/instructions/indexing.js.map +1 -1
  263. package/dist/esm/instructions/misc.js +1 -0
  264. package/dist/esm/instructions/misc.js.map +1 -1
  265. package/dist/esm/instructions/session.js +1 -0
  266. package/dist/esm/instructions/session.js.map +1 -1
  267. package/dist/esm/instructions/staking.js +1 -0
  268. package/dist/esm/instructions/staking.js.map +1 -1
  269. package/dist/esm/instructions/subscription.js +1 -0
  270. package/dist/esm/instructions/subscription.js.map +1 -1
  271. package/dist/esm/instructions/tools.js +1 -0
  272. package/dist/esm/instructions/tools.js.map +1 -1
  273. package/dist/esm/instructions/vault.js +1 -0
  274. package/dist/esm/instructions/vault.js.map +1 -1
  275. package/dist/esm/modules/agent.d.ts +166 -0
  276. package/dist/esm/modules/agent.d.ts.map +1 -0
  277. package/dist/esm/modules/agent.js +268 -0
  278. package/dist/esm/modules/agent.js.map +1 -0
  279. package/dist/esm/modules/attestation.d.ts +96 -0
  280. package/dist/esm/modules/attestation.d.ts.map +1 -0
  281. package/dist/esm/modules/attestation.js +143 -0
  282. package/dist/esm/modules/attestation.js.map +1 -0
  283. package/dist/esm/modules/base.d.ts +161 -0
  284. package/dist/esm/modules/base.d.ts.map +1 -0
  285. package/dist/esm/modules/base.js +185 -0
  286. package/dist/esm/modules/base.js.map +1 -0
  287. package/dist/esm/modules/escrow-v2.d.ts +169 -0
  288. package/dist/esm/modules/escrow-v2.d.ts.map +1 -0
  289. package/dist/esm/modules/escrow-v2.js +603 -0
  290. package/dist/esm/modules/escrow-v2.js.map +1 -0
  291. package/dist/esm/modules/escrow.d.ts +168 -0
  292. package/dist/esm/modules/escrow.d.ts.map +1 -0
  293. package/dist/esm/modules/escrow.js +332 -0
  294. package/dist/esm/modules/escrow.js.map +1 -0
  295. package/dist/esm/modules/feedback.d.ts +105 -0
  296. package/dist/esm/modules/feedback.d.ts.map +1 -0
  297. package/dist/esm/modules/feedback.js +162 -0
  298. package/dist/esm/modules/feedback.js.map +1 -0
  299. package/dist/esm/modules/index.d.ts +28 -0
  300. package/dist/esm/modules/index.d.ts.map +1 -0
  301. package/dist/esm/modules/index.js +27 -0
  302. package/dist/esm/modules/index.js.map +1 -0
  303. package/dist/esm/modules/indexing.d.ts +200 -0
  304. package/dist/esm/modules/indexing.d.ts.map +1 -0
  305. package/dist/esm/modules/indexing.js +371 -0
  306. package/dist/esm/modules/indexing.js.map +1 -0
  307. package/dist/esm/modules/ledger.d.ts +150 -0
  308. package/dist/esm/modules/ledger.d.ts.map +1 -0
  309. package/dist/esm/modules/ledger.js +230 -0
  310. package/dist/esm/modules/ledger.js.map +1 -0
  311. package/dist/esm/modules/receipt.d.ts +77 -0
  312. package/dist/esm/modules/receipt.d.ts.map +1 -0
  313. package/dist/esm/modules/receipt.js +144 -0
  314. package/dist/esm/modules/receipt.js.map +1 -0
  315. package/dist/esm/modules/staking.d.ts +51 -0
  316. package/dist/esm/modules/staking.d.ts.map +1 -0
  317. package/dist/esm/modules/staking.js +155 -0
  318. package/dist/esm/modules/staking.js.map +1 -0
  319. package/dist/esm/modules/subscription.d.ts +33 -0
  320. package/dist/esm/modules/subscription.d.ts.map +1 -0
  321. package/dist/esm/modules/subscription.js +92 -0
  322. package/dist/esm/modules/subscription.js.map +1 -0
  323. package/dist/esm/modules/tools.d.ts +182 -0
  324. package/dist/esm/modules/tools.d.ts.map +1 -0
  325. package/dist/esm/modules/tools.js +341 -0
  326. package/dist/esm/modules/tools.js.map +1 -0
  327. package/dist/esm/modules/vault.d.ts +240 -0
  328. package/dist/esm/modules/vault.d.ts.map +1 -0
  329. package/dist/esm/modules/vault.js +423 -0
  330. package/dist/esm/modules/vault.js.map +1 -0
  331. package/dist/esm/parser/client.d.ts +123 -0
  332. package/dist/esm/parser/client.d.ts.map +1 -0
  333. package/dist/esm/parser/client.js +142 -0
  334. package/dist/esm/parser/client.js.map +1 -0
  335. package/dist/esm/parser/complete.d.ts +90 -0
  336. package/dist/esm/parser/complete.d.ts.map +1 -0
  337. package/dist/esm/parser/complete.js +173 -0
  338. package/dist/esm/parser/complete.js.map +1 -0
  339. package/dist/esm/parser/index.d.ts +40 -0
  340. package/dist/esm/parser/index.d.ts.map +1 -0
  341. package/dist/esm/parser/index.js +43 -0
  342. package/dist/esm/parser/index.js.map +1 -0
  343. package/dist/esm/parser/inner.d.ts +114 -0
  344. package/dist/esm/parser/inner.d.ts.map +1 -0
  345. package/dist/esm/parser/inner.js +180 -0
  346. package/dist/esm/parser/inner.js.map +1 -0
  347. package/dist/esm/parser/instructions.d.ts +76 -0
  348. package/dist/esm/parser/instructions.d.ts.map +1 -0
  349. package/dist/esm/parser/instructions.js +109 -0
  350. package/dist/esm/parser/instructions.js.map +1 -0
  351. package/dist/esm/parser/transaction.d.ts +77 -0
  352. package/dist/esm/parser/transaction.d.ts.map +1 -0
  353. package/dist/esm/parser/transaction.js +149 -0
  354. package/dist/esm/parser/transaction.js.map +1 -0
  355. package/dist/esm/parser/types.d.ts +154 -0
  356. package/dist/esm/parser/types.d.ts.map +1 -0
  357. package/dist/esm/parser/types.js +13 -0
  358. package/dist/esm/parser/types.js.map +1 -0
  359. package/dist/esm/pda/index.d.ts +510 -0
  360. package/dist/esm/pda/index.d.ts.map +1 -0
  361. package/dist/esm/pda/index.js +638 -0
  362. package/dist/esm/pda/index.js.map +1 -0
  363. package/dist/esm/plugin/index.d.ts +171 -0
  364. package/dist/esm/plugin/index.d.ts.map +1 -0
  365. package/dist/esm/plugin/index.js +945 -0
  366. package/dist/esm/plugin/index.js.map +1 -0
  367. package/dist/esm/plugin/protocols.d.ts +152 -0
  368. package/dist/esm/plugin/protocols.d.ts.map +1 -0
  369. package/dist/esm/plugin/protocols.js +279 -0
  370. package/dist/esm/plugin/protocols.js.map +1 -0
  371. package/dist/esm/plugin/schemas.d.ts +829 -0
  372. package/dist/esm/plugin/schemas.d.ts.map +1 -0
  373. package/dist/esm/plugin/schemas.js +860 -0
  374. package/dist/esm/plugin/schemas.js.map +1 -0
  375. package/dist/esm/postgres/adapter.d.ts +355 -0
  376. package/dist/esm/postgres/adapter.d.ts.map +1 -0
  377. package/dist/esm/postgres/adapter.js +678 -0
  378. package/dist/esm/postgres/adapter.js.map +1 -0
  379. package/dist/esm/postgres/index.d.ts +24 -0
  380. package/dist/esm/postgres/index.d.ts.map +1 -0
  381. package/dist/esm/postgres/index.js +27 -0
  382. package/dist/esm/postgres/index.js.map +1 -0
  383. package/dist/esm/postgres/serializers.d.ts +30 -0
  384. package/dist/esm/postgres/serializers.d.ts.map +1 -0
  385. package/dist/esm/postgres/serializers.js +362 -0
  386. package/dist/esm/postgres/serializers.js.map +1 -0
  387. package/dist/esm/postgres/sync.d.ts +156 -0
  388. package/dist/esm/postgres/sync.d.ts.map +1 -0
  389. package/dist/esm/postgres/sync.js +285 -0
  390. package/dist/esm/postgres/sync.js.map +1 -0
  391. package/dist/esm/postgres/types.d.ts +167 -0
  392. package/dist/esm/postgres/types.d.ts.map +1 -0
  393. package/dist/esm/postgres/types.js +41 -0
  394. package/dist/esm/postgres/types.js.map +1 -0
  395. package/dist/esm/registries/builder.d.ts +340 -0
  396. package/dist/esm/registries/builder.d.ts.map +1 -0
  397. package/dist/esm/registries/builder.js +410 -0
  398. package/dist/esm/registries/builder.js.map +1 -0
  399. package/dist/esm/registries/discovery.d.ts +333 -0
  400. package/dist/esm/registries/discovery.d.ts.map +1 -0
  401. package/dist/esm/registries/discovery.js +358 -0
  402. package/dist/esm/registries/discovery.js.map +1 -0
  403. package/dist/esm/registries/fairscale.d.ts +680 -0
  404. package/dist/esm/registries/fairscale.d.ts.map +1 -0
  405. package/dist/esm/registries/fairscale.js +633 -0
  406. package/dist/esm/registries/fairscale.js.map +1 -0
  407. package/dist/esm/registries/index.d.ts +52 -0
  408. package/dist/esm/registries/index.d.ts.map +1 -0
  409. package/dist/esm/registries/index.js +46 -0
  410. package/dist/esm/registries/index.js.map +1 -0
  411. package/dist/esm/registries/metaplex-bridge.d.ts +489 -0
  412. package/dist/esm/registries/metaplex-bridge.d.ts.map +1 -0
  413. package/dist/esm/registries/metaplex-bridge.js +706 -0
  414. package/dist/esm/registries/metaplex-bridge.js.map +1 -0
  415. package/dist/esm/registries/session.d.ts +323 -0
  416. package/dist/esm/registries/session.d.ts.map +1 -0
  417. package/dist/esm/registries/session.js +429 -0
  418. package/dist/esm/registries/session.js.map +1 -0
  419. package/dist/esm/registries/x402.d.ts +530 -0
  420. package/dist/esm/registries/x402.d.ts.map +1 -0
  421. package/dist/esm/registries/x402.js +664 -0
  422. package/dist/esm/registries/x402.js.map +1 -0
  423. package/dist/esm/types/accounts.d.ts +765 -0
  424. package/dist/esm/types/accounts.d.ts.map +1 -0
  425. package/dist/esm/types/accounts.js +12 -0
  426. package/dist/esm/types/accounts.js.map +1 -0
  427. package/dist/esm/types/common.d.ts +166 -0
  428. package/dist/esm/types/common.d.ts.map +1 -0
  429. package/dist/esm/types/common.js +12 -0
  430. package/dist/esm/types/common.js.map +1 -0
  431. package/dist/esm/types/endpoint.d.ts +161 -0
  432. package/dist/esm/types/endpoint.d.ts.map +1 -0
  433. package/dist/esm/types/endpoint.js +14 -0
  434. package/dist/esm/types/endpoint.js.map +1 -0
  435. package/dist/esm/types/enums.d.ts +353 -0
  436. package/dist/esm/types/enums.d.ts.map +1 -0
  437. package/dist/esm/types/enums.js +266 -0
  438. package/dist/esm/types/enums.js.map +1 -0
  439. package/dist/esm/types/index.d.ts +29 -0
  440. package/dist/esm/types/index.d.ts.map +1 -0
  441. package/dist/esm/types/index.js +25 -0
  442. package/dist/esm/types/index.js.map +1 -0
  443. package/dist/esm/types/instructions.d.ts +400 -0
  444. package/dist/esm/types/instructions.d.ts.map +1 -0
  445. package/dist/esm/types/instructions.js +89 -0
  446. package/dist/esm/types/instructions.js.map +1 -0
  447. package/dist/esm/types.d.ts +28 -0
  448. package/dist/esm/types.d.ts.map +1 -1
  449. package/dist/esm/types.js +1 -0
  450. package/dist/esm/types.js.map +1 -1
  451. package/dist/esm/utils/anchor-errors.d.ts +61 -0
  452. package/dist/esm/utils/anchor-errors.d.ts.map +1 -0
  453. package/dist/esm/utils/anchor-errors.js +447 -0
  454. package/dist/esm/utils/anchor-errors.js.map +1 -0
  455. package/dist/esm/utils/endpoint-validator.d.ts +110 -0
  456. package/dist/esm/utils/endpoint-validator.d.ts.map +1 -0
  457. package/dist/esm/utils/endpoint-validator.js +226 -0
  458. package/dist/esm/utils/endpoint-validator.js.map +1 -0
  459. package/dist/esm/utils/escrow-validation.d.ts +145 -0
  460. package/dist/esm/utils/escrow-validation.d.ts.map +1 -0
  461. package/dist/esm/utils/escrow-validation.js +212 -0
  462. package/dist/esm/utils/escrow-validation.js.map +1 -0
  463. package/dist/esm/utils/hash.d.ts +75 -0
  464. package/dist/esm/utils/hash.d.ts.map +1 -0
  465. package/dist/esm/utils/hash.js +103 -0
  466. package/dist/esm/utils/hash.js.map +1 -0
  467. package/dist/esm/utils/index.d.ts +3 -1
  468. package/dist/esm/utils/index.d.ts.map +1 -1
  469. package/dist/esm/utils/index.js +6 -3
  470. package/dist/esm/utils/index.js.map +1 -1
  471. package/dist/esm/utils/merchant-validator.d.ts +176 -0
  472. package/dist/esm/utils/merchant-validator.d.ts.map +1 -0
  473. package/dist/esm/utils/merchant-validator.js +241 -0
  474. package/dist/esm/utils/merchant-validator.js.map +1 -0
  475. package/dist/esm/utils/network-normalizer.d.ts +120 -0
  476. package/dist/esm/utils/network-normalizer.d.ts.map +1 -0
  477. package/dist/esm/utils/network-normalizer.js +229 -0
  478. package/dist/esm/utils/network-normalizer.js.map +1 -0
  479. package/dist/esm/utils/priority-fee.d.ts +205 -0
  480. package/dist/esm/utils/priority-fee.d.ts.map +1 -0
  481. package/dist/esm/utils/priority-fee.js +209 -0
  482. package/dist/esm/utils/priority-fee.js.map +1 -0
  483. package/dist/esm/utils/rpc-strategy.d.ts +172 -0
  484. package/dist/esm/utils/rpc-strategy.d.ts.map +1 -0
  485. package/dist/esm/utils/rpc-strategy.js +231 -0
  486. package/dist/esm/utils/rpc-strategy.js.map +1 -0
  487. package/dist/esm/utils/schemas.d.ts +351 -0
  488. package/dist/esm/utils/schemas.d.ts.map +1 -0
  489. package/dist/esm/utils/schemas.js +320 -0
  490. package/dist/esm/utils/schemas.js.map +1 -0
  491. package/dist/esm/utils/serialization.d.ts +69 -0
  492. package/dist/esm/utils/serialization.d.ts.map +1 -0
  493. package/dist/esm/utils/serialization.js +98 -0
  494. package/dist/esm/utils/serialization.js.map +1 -0
  495. package/dist/esm/utils/validate.js +1 -1
  496. package/dist/esm/utils/validate.js.map +1 -1
  497. package/dist/esm/utils/validation.d.ts +29 -0
  498. package/dist/esm/utils/validation.d.ts.map +1 -0
  499. package/dist/esm/utils/validation.js +33 -0
  500. package/dist/esm/utils/validation.js.map +1 -0
  501. package/dist/esm/utils/volume-curve.d.ts +60 -0
  502. package/dist/esm/utils/volume-curve.d.ts.map +1 -0
  503. package/dist/esm/utils/volume-curve.js +114 -0
  504. package/dist/esm/utils/volume-curve.js.map +1 -0
  505. package/dist/esm/utils/x402-direct.d.ts +114 -0
  506. package/dist/esm/utils/x402-direct.d.ts.map +1 -0
  507. package/dist/esm/utils/x402-direct.js +228 -0
  508. package/dist/esm/utils/x402-direct.js.map +1 -0
  509. package/dist/types/constants/addresses.d.ts +117 -0
  510. package/dist/types/constants/addresses.d.ts.map +1 -0
  511. package/dist/types/constants/index.d.ts +31 -0
  512. package/dist/types/constants/index.d.ts.map +1 -0
  513. package/dist/types/constants/limits.d.ts +149 -0
  514. package/dist/types/constants/limits.d.ts.map +1 -0
  515. package/dist/types/constants/network.d.ts +81 -0
  516. package/dist/types/constants/network.d.ts.map +1 -0
  517. package/dist/types/constants/payments.d.ts +121 -0
  518. package/dist/types/constants/payments.d.ts.map +1 -0
  519. package/dist/types/constants/programs.d.ts +69 -0
  520. package/dist/types/constants/programs.d.ts.map +1 -0
  521. package/dist/types/constants/seeds.d.ts +82 -0
  522. package/dist/types/constants/seeds.d.ts.map +1 -0
  523. package/dist/types/core/client.d.ts +467 -0
  524. package/dist/types/core/client.d.ts.map +1 -0
  525. package/dist/types/core/connection.d.ts +305 -0
  526. package/dist/types/core/connection.d.ts.map +1 -0
  527. package/dist/types/core/index.d.ts +20 -0
  528. package/dist/types/core/index.d.ts.map +1 -0
  529. package/dist/types/errors/index.d.ts +335 -0
  530. package/dist/types/errors/index.d.ts.map +1 -0
  531. package/dist/types/events/geyser.d.ts +150 -0
  532. package/dist/types/events/geyser.d.ts.map +1 -0
  533. package/dist/types/events/index.d.ts +248 -0
  534. package/dist/types/events/index.d.ts.map +1 -0
  535. package/dist/types/idl/index.d.ts +70 -0
  536. package/dist/types/idl/index.d.ts.map +1 -0
  537. package/dist/types/index.d.ts +86 -0
  538. package/dist/types/index.d.ts.map +1 -0
  539. package/dist/types/modules/agent.d.ts +156 -0
  540. package/dist/types/modules/agent.d.ts.map +1 -0
  541. package/dist/types/modules/attestation.d.ts +96 -0
  542. package/dist/types/modules/attestation.d.ts.map +1 -0
  543. package/dist/types/modules/base.d.ts +215 -0
  544. package/dist/types/modules/base.d.ts.map +1 -0
  545. package/dist/types/modules/escrow-v2.d.ts +285 -0
  546. package/dist/types/modules/escrow-v2.d.ts.map +1 -0
  547. package/dist/types/modules/feedback.d.ts +105 -0
  548. package/dist/types/modules/feedback.d.ts.map +1 -0
  549. package/dist/types/modules/index.d.ts +27 -0
  550. package/dist/types/modules/index.d.ts.map +1 -0
  551. package/dist/types/modules/indexing.d.ts +200 -0
  552. package/dist/types/modules/indexing.d.ts.map +1 -0
  553. package/dist/types/modules/ledger.d.ts +150 -0
  554. package/dist/types/modules/ledger.d.ts.map +1 -0
  555. package/dist/types/modules/receipt.d.ts +91 -0
  556. package/dist/types/modules/receipt.d.ts.map +1 -0
  557. package/dist/types/modules/staking.d.ts +51 -0
  558. package/dist/types/modules/staking.d.ts.map +1 -0
  559. package/dist/types/modules/subscription.d.ts +33 -0
  560. package/dist/types/modules/subscription.d.ts.map +1 -0
  561. package/dist/types/modules/tools.d.ts +172 -0
  562. package/dist/types/modules/tools.d.ts.map +1 -0
  563. package/dist/types/modules/vault.d.ts +240 -0
  564. package/dist/types/modules/vault.d.ts.map +1 -0
  565. package/dist/types/parser/client.d.ts +123 -0
  566. package/dist/types/parser/client.d.ts.map +1 -0
  567. package/dist/types/parser/complete.d.ts +90 -0
  568. package/dist/types/parser/complete.d.ts.map +1 -0
  569. package/dist/types/parser/index.d.ts +40 -0
  570. package/dist/types/parser/index.d.ts.map +1 -0
  571. package/dist/types/parser/inner.d.ts +114 -0
  572. package/dist/types/parser/inner.d.ts.map +1 -0
  573. package/dist/types/parser/instructions.d.ts +76 -0
  574. package/dist/types/parser/instructions.d.ts.map +1 -0
  575. package/dist/types/parser/transaction.d.ts +77 -0
  576. package/dist/types/parser/transaction.d.ts.map +1 -0
  577. package/dist/types/parser/types.d.ts +154 -0
  578. package/dist/types/parser/types.d.ts.map +1 -0
  579. package/dist/types/pda/index.d.ts +527 -0
  580. package/dist/types/pda/index.d.ts.map +1 -0
  581. package/dist/types/plugin/index.d.ts +171 -0
  582. package/dist/types/plugin/index.d.ts.map +1 -0
  583. package/dist/types/plugin/protocols.d.ts +152 -0
  584. package/dist/types/plugin/protocols.d.ts.map +1 -0
  585. package/dist/types/plugin/schemas.d.ts +829 -0
  586. package/dist/types/plugin/schemas.d.ts.map +1 -0
  587. package/dist/types/postgres/adapter.d.ts +355 -0
  588. package/dist/types/postgres/adapter.d.ts.map +1 -0
  589. package/dist/types/postgres/index.d.ts +24 -0
  590. package/dist/types/postgres/index.d.ts.map +1 -0
  591. package/dist/types/postgres/serializers.d.ts +30 -0
  592. package/dist/types/postgres/serializers.d.ts.map +1 -0
  593. package/dist/types/postgres/sync.d.ts +156 -0
  594. package/dist/types/postgres/sync.d.ts.map +1 -0
  595. package/dist/types/postgres/types.d.ts +167 -0
  596. package/dist/types/postgres/types.d.ts.map +1 -0
  597. package/dist/types/registries/builder.d.ts +333 -0
  598. package/dist/types/registries/builder.d.ts.map +1 -0
  599. package/dist/types/registries/discovery.d.ts +333 -0
  600. package/dist/types/registries/discovery.d.ts.map +1 -0
  601. package/dist/types/registries/fairscale.d.ts +680 -0
  602. package/dist/types/registries/fairscale.d.ts.map +1 -0
  603. package/dist/types/registries/index.d.ts +52 -0
  604. package/dist/types/registries/index.d.ts.map +1 -0
  605. package/dist/types/registries/metaplex-bridge.d.ts +488 -0
  606. package/dist/types/registries/metaplex-bridge.d.ts.map +1 -0
  607. package/dist/types/registries/session.d.ts +317 -0
  608. package/dist/types/registries/session.d.ts.map +1 -0
  609. package/dist/types/registries/x402.d.ts +523 -0
  610. package/dist/types/registries/x402.d.ts.map +1 -0
  611. package/dist/types/types/accounts.d.ts +817 -0
  612. package/dist/types/types/accounts.d.ts.map +1 -0
  613. package/dist/types/types/common.d.ts +166 -0
  614. package/dist/types/types/common.d.ts.map +1 -0
  615. package/dist/types/types/endpoint.d.ts +161 -0
  616. package/dist/types/types/endpoint.d.ts.map +1 -0
  617. package/dist/types/types/enums.d.ts +353 -0
  618. package/dist/types/types/enums.d.ts.map +1 -0
  619. package/dist/types/types/index.d.ts +29 -0
  620. package/dist/types/types/index.d.ts.map +1 -0
  621. package/dist/types/types/instructions.d.ts +400 -0
  622. package/dist/types/types/instructions.d.ts.map +1 -0
  623. package/dist/types/utils/anchor-errors.d.ts +61 -0
  624. package/dist/types/utils/anchor-errors.d.ts.map +1 -0
  625. package/dist/types/utils/endpoint-validator.d.ts +110 -0
  626. package/dist/types/utils/endpoint-validator.d.ts.map +1 -0
  627. package/dist/types/utils/escrow-validation.d.ts +145 -0
  628. package/dist/types/utils/escrow-validation.d.ts.map +1 -0
  629. package/dist/types/utils/hash.d.ts +75 -0
  630. package/dist/types/utils/hash.d.ts.map +1 -0
  631. package/dist/types/utils/index.d.ts +36 -0
  632. package/dist/types/utils/index.d.ts.map +1 -0
  633. package/dist/types/utils/merchant-validator.d.ts +176 -0
  634. package/dist/types/utils/merchant-validator.d.ts.map +1 -0
  635. package/dist/types/utils/network-normalizer.d.ts +120 -0
  636. package/dist/types/utils/network-normalizer.d.ts.map +1 -0
  637. package/dist/types/utils/priority-fee.d.ts +205 -0
  638. package/dist/types/utils/priority-fee.d.ts.map +1 -0
  639. package/dist/types/utils/rpc-strategy.d.ts +179 -0
  640. package/dist/types/utils/rpc-strategy.d.ts.map +1 -0
  641. package/dist/types/utils/schemas.d.ts +351 -0
  642. package/dist/types/utils/schemas.d.ts.map +1 -0
  643. package/dist/types/utils/serialization.d.ts +69 -0
  644. package/dist/types/utils/serialization.d.ts.map +1 -0
  645. package/dist/types/utils/validation.d.ts +29 -0
  646. package/dist/types/utils/validation.d.ts.map +1 -0
  647. package/dist/types/utils/volume-curve.d.ts +60 -0
  648. package/dist/types/utils/volume-curve.d.ts.map +1 -0
  649. package/dist/types/utils/x402-direct.d.ts +114 -0
  650. package/dist/types/utils/x402-direct.d.ts.map +1 -0
  651. package/package.json +2 -2
@@ -0,0 +1,638 @@
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
+ * Encode an unsigned 64-bit integer as a little-endian `Buffer`.
64
+ *
65
+ * @name u64le
66
+ * @description Produces an 8-byte LE buffer for u64 PDA seed segments (e.g., escrow nonce, sub_id).
67
+ * @param n - The number or bigint to encode.
68
+ * @returns {Buffer} 8-byte little-endian buffer.
69
+ * @category PDA
70
+ * @since v0.5.0
71
+ */
72
+ const u64le = (n) => {
73
+ const buf = Buffer.alloc(8);
74
+ buf.writeBigUInt64LE(BigInt(n), 0);
75
+ return buf;
76
+ };
77
+ // ═════════════════════════════════════════════
78
+ // Core PDAs
79
+ // ═════════════════════════════════════════════
80
+ /**
81
+ * Derive the **GlobalRegistry** PDA.
82
+ *
83
+ * Seeds: `["sap_global"]`
84
+ *
85
+ * @name deriveGlobalRegistry
86
+ * @description Returns the singleton global registry address used by the SAP program.
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 GlobalRegistry account type
92
+ */
93
+ export const deriveGlobalRegistry = (programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.GLOBAL)], programId);
94
+ /**
95
+ * Derive the **AgentAccount** PDA for a given wallet.
96
+ *
97
+ * Seeds: `["sap_agent", wallet]`
98
+ *
99
+ * @name deriveAgent
100
+ * @description Computes the unique agent PDA owned by `wallet`.
101
+ * @param wallet - The agent owner’s wallet `PublicKey`.
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 AgentAccount
107
+ */
108
+ export const deriveAgent = (wallet, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.AGENT), wallet.toBuffer()], programId);
109
+ /**
110
+ * Derive the **AgentStats** PDA for a given agent.
111
+ *
112
+ * Seeds: `["sap_stats", agent_pda]`
113
+ *
114
+ * @name deriveAgentStats
115
+ * @description Computes the stats account PDA associated with an agent.
116
+ * @param agentPda - The agent’s on-chain PDA.
117
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
118
+ * @returns {PdaResult} `[pda, bump]` tuple.
119
+ * @category PDA
120
+ * @since v0.1.0
121
+ * @see AgentStats
122
+ */
123
+ export const deriveAgentStats = (agentPda, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.STATS), agentPda.toBuffer()], programId);
124
+ // ═════════════════════════════════════════════
125
+ // Feedback
126
+ // ═════════════════════════════════════════════
127
+ /**
128
+ * Derive the **Feedback** PDA for a reviewer on a specific agent.
129
+ *
130
+ * Seeds: `["sap_feedback", agent_pda, reviewer_wallet]`
131
+ *
132
+ * @name deriveFeedback
133
+ * @description Computes the feedback account PDA scoped to a reviewer–agent pair.
134
+ * @param agentPda - The target agent’s PDA.
135
+ * @param reviewer - The reviewer’s wallet `PublicKey`.
136
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
137
+ * @returns {PdaResult} `[pda, bump]` tuple.
138
+ * @category PDA
139
+ * @since v0.1.0
140
+ * @see FeedbackAccount
141
+ */
142
+ export const deriveFeedback = (agentPda, reviewer, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.FEEDBACK), agentPda.toBuffer(), reviewer.toBuffer()], programId);
143
+ // ═════════════════════════════════════════════
144
+ // Indexing
145
+ // ═════════════════════════════════════════════
146
+ /**
147
+ * Derive the **CapabilityIndex** PDA for a hashed capability string.
148
+ *
149
+ * Seeds: `["sap_cap_idx", capability_hash]`
150
+ *
151
+ * @name deriveCapabilityIndex
152
+ * @description Computes the capability index PDA used to look up agents by capability.
153
+ * @param capabilityHash - SHA-256 hash of the capability 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 CapabilityIndex
159
+ */
160
+ export const deriveCapabilityIndex = (capabilityHash, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.CAPABILITY_INDEX), Buffer.from(capabilityHash)], programId);
161
+ /**
162
+ * Derive the **ProtocolIndex** PDA for a hashed protocol string.
163
+ *
164
+ * Seeds: `["sap_proto_idx", protocol_hash]`
165
+ *
166
+ * @name deriveProtocolIndex
167
+ * @description Computes the protocol index PDA used to look up agents by protocol.
168
+ * @param protocolHash - SHA-256 hash of the protocol string (32 bytes).
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 ProtocolIndex
174
+ */
175
+ export const deriveProtocolIndex = (protocolHash, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.PROTOCOL_INDEX), Buffer.from(protocolHash)], programId);
176
+ /**
177
+ * Derive the **ToolCategoryIndex** PDA for a tool category discriminant.
178
+ *
179
+ * Seeds: `["sap_tool_cat", category_u8]`
180
+ *
181
+ * @name deriveToolCategoryIndex
182
+ * @description Computes the tool category index PDA used to look up tools by category.
183
+ * @param category - The `u8` category discriminant (see {@link TOOL_CATEGORY_VALUES}).
184
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
185
+ * @returns {PdaResult} `[pda, bump]` tuple.
186
+ * @category PDA
187
+ * @since v0.1.0
188
+ * @see ToolCategoryIndex
189
+ */
190
+ export const deriveToolCategoryIndex = (category, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.TOOL_CATEGORY), Buffer.from([category])], programId);
191
+ // ═════════════════════════════════════════════
192
+ // Memory Vault
193
+ // ═════════════════════════════════════════════
194
+ /**
195
+ * Derive the **MemoryVault** PDA for a given agent.
196
+ *
197
+ * Seeds: `["sap_vault", agent_pda]`
198
+ *
199
+ * @name deriveVault
200
+ * @description Computes the memory vault PDA owned by the specified agent.
201
+ * @param agentPda - The agent’s on-chain PDA.
202
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
203
+ * @returns {PdaResult} `[pda, bump]` tuple.
204
+ * @category PDA
205
+ * @since v0.1.0
206
+ * @see MemoryVault
207
+ */
208
+ export const deriveVault = (agentPda, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.VAULT), agentPda.toBuffer()], programId);
209
+ /**
210
+ * Derive the **Session** PDA for a vault and session hash.
211
+ *
212
+ * Seeds: `["sap_session", vault_pda, session_hash]`
213
+ *
214
+ * @name deriveSession
215
+ * @description Computes the session PDA scoped to a vault and unique session identifier.
216
+ * @param vaultPda - The parent vault’s PDA.
217
+ * @param sessionHash - SHA-256 hash identifying the session (32 bytes).
218
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
219
+ * @returns {PdaResult} `[pda, bump]` tuple.
220
+ * @category PDA
221
+ * @since v0.1.0
222
+ * @see SessionAccount
223
+ */
224
+ export const deriveSession = (vaultPda, sessionHash, programId = SAP_PROGRAM_ID) => findPda([
225
+ toSeedBuf(SEEDS.SESSION),
226
+ vaultPda.toBuffer(),
227
+ Buffer.from(sessionHash),
228
+ ], programId);
229
+ /**
230
+ * Derive the **EpochPage** PDA for a session at a given epoch index.
231
+ *
232
+ * Seeds: `["sap_epoch", session_pda, epoch_index_u32_le]`
233
+ *
234
+ * @name deriveEpochPage
235
+ * @description Computes the epoch page PDA for paginated memory inscriptions.
236
+ * @param sessionPda - The parent session’s PDA.
237
+ * @param epochIndex - Zero-based epoch page index.
238
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
239
+ * @returns {PdaResult} `[pda, bump]` tuple.
240
+ * @category PDA
241
+ * @since v0.1.0
242
+ * @see EpochPage
243
+ */
244
+ export const deriveEpochPage = (sessionPda, epochIndex, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.EPOCH), sessionPda.toBuffer(), u32le(epochIndex)], programId);
245
+ /**
246
+ * Derive the **VaultDelegate** PDA for a delegate on a vault.
247
+ *
248
+ * Seeds: `["sap_delegate", vault_pda, delegate_pubkey]`
249
+ *
250
+ * @name deriveVaultDelegate
251
+ * @description Computes the delegate authorization PDA granting a wallet write access to a vault.
252
+ * @param vaultPda - The parent vault’s PDA.
253
+ * @param delegate - The delegate’s wallet `PublicKey`.
254
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
255
+ * @returns {PdaResult} `[pda, bump]` tuple.
256
+ * @category PDA
257
+ * @since v0.1.0
258
+ * @see VaultDelegate
259
+ */
260
+ export const deriveVaultDelegate = (vaultPda, delegate, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.DELEGATE), vaultPda.toBuffer(), delegate.toBuffer()], programId);
261
+ /**
262
+ * Derive the **Checkpoint** PDA for a session at a given checkpoint index.
263
+ *
264
+ * Seeds: `["sap_checkpoint", session_pda, checkpoint_index_u32_le]`
265
+ *
266
+ * @name deriveCheckpoint
267
+ * @description Computes the checkpoint PDA storing a Merkle snapshot of session state.
268
+ * @param sessionPda - The parent session’s PDA.
269
+ * @param checkpointIndex - Zero-based checkpoint index.
270
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
271
+ * @returns {PdaResult} `[pda, bump]` tuple.
272
+ * @category PDA
273
+ * @since v0.1.0
274
+ * @see Checkpoint
275
+ */
276
+ export const deriveCheckpoint = (sessionPda, checkpointIndex, programId = SAP_PROGRAM_ID) => findPda([
277
+ toSeedBuf(SEEDS.CHECKPOINT),
278
+ sessionPda.toBuffer(),
279
+ u32le(checkpointIndex),
280
+ ], programId);
281
+ // ═════════════════════════════════════════════
282
+ // Tools
283
+ // ═════════════════════════════════════════════
284
+ /**
285
+ * Derive the **Tool** PDA for an agent and tool name hash.
286
+ *
287
+ * Seeds: `["sap_tool", agent_pda, tool_name_hash]`
288
+ *
289
+ * @name deriveTool
290
+ * @description Computes the tool registration PDA scoped to an agent and tool identifier.
291
+ * @param agentPda - The owning agent’s PDA.
292
+ * @param toolNameHash - SHA-256 hash of the tool name (32 bytes).
293
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
294
+ * @returns {PdaResult} `[pda, bump]` tuple.
295
+ * @category PDA
296
+ * @since v0.1.0
297
+ * @see ToolAccount
298
+ */
299
+ export const deriveTool = (agentPda, toolNameHash, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.TOOL), agentPda.toBuffer(), Buffer.from(toolNameHash)], programId);
300
+ // ═════════════════════════════════════════════
301
+ // Escrow
302
+ // ═════════════════════════════════════════════
303
+ /**
304
+ * Derive the **Escrow** PDA for an agent–depositor pair.
305
+ *
306
+ * Seeds: `["sap_escrow", agent_pda, depositor_wallet]`
307
+ *
308
+ * @name deriveEscrow
309
+ * @description Computes the escrow PDA holding deposited funds for service payments.
310
+ * @param agentPda - The service-providing agent’s PDA.
311
+ * @param depositor - The depositor’s wallet `PublicKey`.
312
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
313
+ * @returns {PdaResult} `[pda, bump]` tuple.
314
+ * @category PDA
315
+ * @since v0.1.0
316
+ * @deprecated Since v0.7.0 — Use {@link deriveEscrowV2} for V2 escrows with nonce support.
317
+ * @see EscrowAccount
318
+ */
319
+ export const deriveEscrow = (agentPda, depositor, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.ESCROW), agentPda.toBuffer(), depositor.toBuffer()], programId);
320
+ // ═════════════════════════════════════════════
321
+ // Attestation
322
+ // ═════════════════════════════════════════════
323
+ /**
324
+ * Derive the **Attestation** PDA for an attester on a specific agent.
325
+ *
326
+ * Seeds: `["sap_attest", agent_pda, attester_wallet]`
327
+ *
328
+ * @name deriveAttestation
329
+ * @description Computes the attestation PDA recording a third-party’s trust assertion.
330
+ * @param agentPda - The attested agent’s PDA.
331
+ * @param attester - The attester’s wallet `PublicKey`.
332
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
333
+ * @returns {PdaResult} `[pda, bump]` tuple.
334
+ * @category PDA
335
+ * @since v0.1.0
336
+ * @see AttestationAccount
337
+ */
338
+ export const deriveAttestation = (agentPda, attester, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.ATTESTATION), agentPda.toBuffer(), attester.toBuffer()], programId);
339
+ // ═════════════════════════════════════════════
340
+ // Memory Ledger
341
+ // ═════════════════════════════════════════════
342
+ /**
343
+ * Derive the **MemoryLedger** PDA for a session.
344
+ *
345
+ * Seeds: `["sap_ledger", session_pda]`
346
+ *
347
+ * @name deriveLedger
348
+ * @description Computes the ledger PDA that tracks append-only entries for a session.
349
+ * @param sessionPda - The parent session’s PDA.
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 MemoryLedger
355
+ */
356
+ export const deriveLedger = (sessionPda, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.LEDGER), sessionPda.toBuffer()], programId);
357
+ /**
358
+ * Derive the **LedgerPage** PDA for a ledger at a given page index.
359
+ *
360
+ * Seeds: `["sap_page", ledger_pda, page_index_u32_le]`
361
+ *
362
+ * @name deriveLedgerPage
363
+ * @description Computes the ledger page PDA for paginated ledger data storage.
364
+ * @param ledgerPda - The parent ledger’s PDA.
365
+ * @param pageIndex - Zero-based page index.
366
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
367
+ * @returns {PdaResult} `[pda, bump]` tuple.
368
+ * @category PDA
369
+ * @since v0.1.0
370
+ * @see LedgerPage
371
+ */
372
+ export const deriveLedgerPage = (ledgerPda, pageIndex, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.LEDGER_PAGE), ledgerPda.toBuffer(), u32le(pageIndex)], programId);
373
+ // ═════════════════════════════════════════════
374
+ // Memory Buffer (legacy)
375
+ // ═════════════════════════════════════════════
376
+ /**
377
+ * Derive the **MemoryBuffer** PDA for a session at a given page index.
378
+ *
379
+ * Seeds: `["sap_buffer", session_pda, page_index_u32_le]`
380
+ *
381
+ * @name deriveBuffer
382
+ * @description Computes the buffer page PDA for chunked memory writes within a session.
383
+ * @param sessionPda - The parent session's PDA.
384
+ * @param pageIndex - Zero-based page index.
385
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
386
+ * @returns {PdaResult} `[pda, bump]` tuple.
387
+ * @category PDA
388
+ * @since v0.3.1
389
+ * @see MemoryBuffer
390
+ */
391
+ export const deriveBuffer = (sessionPda, pageIndex, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.BUFFER), sessionPda.toBuffer(), u32le(pageIndex)], programId);
392
+ // ═════════════════════════════════════════════
393
+ // Session Digest
394
+ // ═════════════════════════════════════════════
395
+ /**
396
+ * Derive the **SessionDigest** PDA for a session.
397
+ *
398
+ * Seeds: `["sap_digest", session_pda]`
399
+ *
400
+ * @name deriveDigest
401
+ * @description Computes the digest PDA that stores a compact hash summary of a session.
402
+ * @param sessionPda - The parent session's PDA.
403
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
404
+ * @returns {PdaResult} `[pda, bump]` tuple.
405
+ * @category PDA
406
+ * @since v0.3.1
407
+ * @see SessionDigest
408
+ */
409
+ export const deriveDigest = (sessionPda, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.DIGEST), sessionPda.toBuffer()], programId);
410
+ // ═════════════════════════════════════════════
411
+ // Plugin
412
+ // ═════════════════════════════════════════════
413
+ /**
414
+ * Derive the **PluginConfig** PDA for an agent and plugin type.
415
+ *
416
+ * Seeds: `["sap_plugin", agent_pda, plugin_type_u8]`
417
+ *
418
+ * @name derivePlugin
419
+ * @description Computes the plugin configuration PDA scoped to an agent and plugin type.
420
+ * @param agentPda - The owning agent's PDA.
421
+ * @param pluginType - The `u8` plugin type discriminant.
422
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
423
+ * @returns {PdaResult} `[pda, bump]` tuple.
424
+ * @category PDA
425
+ * @since v0.3.1
426
+ * @see PluginConfig
427
+ */
428
+ export const derivePlugin = (agentPda, pluginType, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.PLUGIN), agentPda.toBuffer(), Buffer.from([pluginType])], programId);
429
+ // ═════════════════════════════════════════════
430
+ // Legacy Memory (entry + chunk)
431
+ // ═════════════════════════════════════════════
432
+ /**
433
+ * Derive the **MemoryEntry** PDA for an agent and entry hash.
434
+ *
435
+ * Seeds: `["sap_memory", agent_pda, entry_hash]`
436
+ *
437
+ * @name deriveMemoryEntry
438
+ * @description Computes the memory entry PDA for legacy key-value memory storage.
439
+ * @param agentPda - The owning agent's PDA.
440
+ * @param entryHash - SHA-256 hash of the entry key (32 bytes).
441
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
442
+ * @returns {PdaResult} `[pda, bump]` tuple.
443
+ * @category PDA
444
+ * @since v0.3.1
445
+ * @see MemoryEntry
446
+ */
447
+ export const deriveMemoryEntry = (agentPda, entryHash, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.MEMORY), agentPda.toBuffer(), Buffer.from(entryHash)], programId);
448
+ /**
449
+ * Derive the **MemoryChunk** PDA for a memory entry at a given chunk index.
450
+ *
451
+ * Seeds: `["sap_mem_chunk", memory_entry_pda, chunk_index_u8]`
452
+ *
453
+ * @name deriveMemoryChunk
454
+ * @description Computes the chunk PDA for fragmented memory entry data.
455
+ * @param memoryEntryPda - The parent memory entry's PDA.
456
+ * @param chunkIndex - Zero-based chunk index (0–255).
457
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
458
+ * @returns {PdaResult} `[pda, bump]` tuple.
459
+ * @category PDA
460
+ * @since v0.3.1
461
+ * @see MemoryChunk
462
+ */
463
+ export const deriveMemoryChunk = (memoryEntryPda, chunkIndex, programId = SAP_PROGRAM_ID) => findPda([
464
+ toSeedBuf(SEEDS.MEMORY_CHUNK),
465
+ memoryEntryPda.toBuffer(),
466
+ Buffer.from([chunkIndex]),
467
+ ], programId);
468
+ // ═════════════════════════════════════════════
469
+ // Escrow V2
470
+ // ═════════════════════════════════════════════
471
+ /**
472
+ * Derive the **EscrowAccountV2** PDA.
473
+ *
474
+ * Seeds: `["sap_escrow_v2", agent_pda, depositor_wallet, nonce_u64_le]`
475
+ *
476
+ * @name deriveEscrowV2
477
+ * @description Computes the V2 escrow PDA supporting nonce-based multi-escrow.
478
+ * @param agentPda - The agent's PDA.
479
+ * @param depositor - The depositor's wallet.
480
+ * @param nonce - Escrow nonce (u64) allowing multiple escrows per pair.
481
+ * @param programId - Override program ID.
482
+ * @returns {PdaResult} `[pda, bump]` tuple.
483
+ * @category PDA
484
+ * @since v0.5.0
485
+ */
486
+ export const deriveEscrowV2 = (agentPda, depositor, nonce = 0, programId = SAP_PROGRAM_ID) => findPda([
487
+ toSeedBuf(SEEDS.ESCROW_V2),
488
+ agentPda.toBuffer(),
489
+ depositor.toBuffer(),
490
+ u64le(nonce),
491
+ ], programId);
492
+ /**
493
+ * Derive the **PendingSettlement** PDA.
494
+ *
495
+ * Seeds: `["sap_pending", escrow_v2_pda, settlement_index_u64_le]`
496
+ *
497
+ * @name derivePendingSettlement
498
+ * @param escrowV2Pda - The parent V2 escrow PDA.
499
+ * @param settlementIndex - The monotonic settlement index (u64).
500
+ * @param programId - Override program ID.
501
+ * @returns {PdaResult} `[pda, bump]` tuple.
502
+ * @category PDA
503
+ * @since v0.5.0
504
+ */
505
+ export const derivePendingSettlement = (escrowV2Pda, settlementIndex, programId = SAP_PROGRAM_ID) => findPda([
506
+ toSeedBuf(SEEDS.PENDING),
507
+ escrowV2Pda.toBuffer(),
508
+ u64le(settlementIndex),
509
+ ], programId);
510
+ /**
511
+ * Derive the **DisputeRecord** PDA.
512
+ *
513
+ * Seeds: `["sap_dispute", pending_settlement_pda]`
514
+ *
515
+ * @name deriveDispute
516
+ * @param pendingSettlementPda - The parent pending settlement PDA.
517
+ * @param programId - Override program ID.
518
+ * @returns {PdaResult} `[pda, bump]` tuple.
519
+ * @category PDA
520
+ * @since v0.5.0
521
+ */
522
+ export const deriveDispute = (pendingSettlementPda, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.DISPUTE), pendingSettlementPda.toBuffer()], programId);
523
+ /**
524
+ * Derive the **AgentStake** PDA.
525
+ *
526
+ * Seeds: `["sap_stake", agent_pda]`
527
+ *
528
+ * @name deriveStake
529
+ * @param agentPda - The agent's PDA.
530
+ * @param programId - Override program ID.
531
+ * @returns {PdaResult} `[pda, bump]` tuple.
532
+ * @category PDA
533
+ * @since v0.5.0
534
+ */
535
+ export const deriveStake = (agentPda, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.STAKE), agentPda.toBuffer()], programId);
536
+ /**
537
+ * Derive the **Subscription** PDA.
538
+ *
539
+ * Seeds: `["sap_sub", agent_pda, subscriber_wallet, sub_id_u64_le]`
540
+ *
541
+ * @name deriveSubscription
542
+ * @param agentPda - The agent's PDA.
543
+ * @param subscriber - The subscriber's wallet.
544
+ * @param subId - Subscription ID (u64).
545
+ * @param programId - Override program ID.
546
+ * @returns {PdaResult} `[pda, bump]` tuple.
547
+ * @category PDA
548
+ * @since v0.5.0
549
+ */
550
+ export const deriveSubscription = (agentPda, subscriber, subId = 0, programId = SAP_PROGRAM_ID) => findPda([
551
+ toSeedBuf(SEEDS.SUBSCRIPTION),
552
+ agentPda.toBuffer(),
553
+ subscriber.toBuffer(),
554
+ u64le(subId),
555
+ ], programId);
556
+ /**
557
+ * Derive the **CounterShard** PDA.
558
+ *
559
+ * Seeds: `["sap_shard", shard_index_u8]`
560
+ *
561
+ * @name deriveShard
562
+ * @param shardIndex - The shard index (0–7).
563
+ * @param programId - Override program ID.
564
+ * @returns {PdaResult} `[pda, bump]` tuple.
565
+ * @category PDA
566
+ * @since v0.5.0
567
+ */
568
+ export const deriveShard = (shardIndex, programId = SAP_PROGRAM_ID) => findPda([toSeedBuf(SEEDS.SHARD), Buffer.from([shardIndex])], programId);
569
+ /**
570
+ * Derive the **IndexPage** PDA.
571
+ *
572
+ * Seeds: `["sap_idx_page", parent_index_pda, page_index_u8]`
573
+ *
574
+ * @name deriveIndexPage
575
+ * @param parentIndexPda - The parent index PDA (CapabilityIndex, ProtocolIndex, etc.).
576
+ * @param pageIndex - The page index (0–255).
577
+ * @param programId - Override program ID.
578
+ * @returns {PdaResult} `[pda, bump]` tuple.
579
+ * @category PDA
580
+ * @since v0.5.0
581
+ */
582
+ export const deriveIndexPage = (parentIndexPda, pageIndex, programId = SAP_PROGRAM_ID) => findPda([
583
+ toSeedBuf(SEEDS.INDEX_PAGE),
584
+ parentIndexPda.toBuffer(),
585
+ Buffer.from([pageIndex]),
586
+ ], programId);
587
+ // ═════════════════════════════════════════════
588
+ // Receipt Batch (v0.7)
589
+ // ═════════════════════════════════════════════
590
+ /**
591
+ * Derive the **ReceiptBatch** PDA.
592
+ *
593
+ * Seeds: `["sap_receipt", escrow_v2_pda, batch_index_u32_le]`
594
+ *
595
+ * @name deriveReceiptBatch
596
+ * @description Computes the receipt batch PDA storing a merkle root of call receipts.
597
+ * @param escrowV2Pda - The parent V2 escrow PDA.
598
+ * @param batchIndex - Zero-based batch index (u32).
599
+ * @param programId - Override program ID.
600
+ * @returns {PdaResult} `[pda, bump]` tuple.
601
+ * @category PDA
602
+ * @since v0.7.0
603
+ */
604
+ export const deriveReceiptBatch = (escrowV2Pda, batchIndex, programId = SAP_PROGRAM_ID) => findPda([
605
+ toSeedBuf(SEEDS.RECEIPT),
606
+ escrowV2Pda.toBuffer(),
607
+ u32le(batchIndex),
608
+ ], programId);
609
+ /**
610
+ * Derive the **SettlementReceipt** PDA (v0.10.0 anti-replay).
611
+ *
612
+ * Seeds: `["sap_recv", escrow_pda, service_hash_or_batch_root]`
613
+ *
614
+ * Created via `init` on every `settle_calls`, `settle_batch`, and
615
+ * `settle_calls_v2`. The PDA's existence after the first call blocks
616
+ * any future replay of the same `service_hash` (or `batch_root`)
617
+ * against the same escrow.
618
+ *
619
+ * @name deriveSettlementReceipt
620
+ * @description Compute the receipt PDA that gates settlement replay.
621
+ * @param escrowPda - Parent escrow PDA (V1 `EscrowAccount` or V2 `EscrowAccountV2`).
622
+ * @param receiptKey - 32-byte `service_hash` (single settle / V2 settle)
623
+ * or `batch_root = sha256(s_0 || ... || s_{N-1})` (settle_batch).
624
+ * @param programId - Override program ID.
625
+ * @returns {PdaResult} `[pda, bump]` tuple.
626
+ * @category PDA
627
+ * @since v0.10.0
628
+ */
629
+ export const deriveSettlementReceipt = (escrowPda, receiptKey, programId = SAP_PROGRAM_ID) => {
630
+ const buf = Buffer.isBuffer(receiptKey)
631
+ ? receiptKey
632
+ : Buffer.from(receiptKey);
633
+ if (buf.length !== 32) {
634
+ throw new Error(`deriveSettlementReceipt: receiptKey must be 32 bytes, got ${buf.length}`);
635
+ }
636
+ return findPda([toSeedBuf(SEEDS.SETTLEMENT_RECEIPT), escrowPda.toBuffer(), buf], programId);
637
+ };
638
+ //# 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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"}