@veilo/sdk-core 0.4.0 → 0.6.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 (481) hide show
  1. package/LICENSE +15 -0
  2. package/README.md +449 -1243
  3. package/accounts.d.ts +2 -0
  4. package/accounts.js +3 -0
  5. package/cloak.d.ts +2 -0
  6. package/cloak.js +3 -0
  7. package/config.d.ts +2 -2
  8. package/config.js +2 -3
  9. package/dist/cjs/accounts/admin.d.ts +84 -0
  10. package/dist/cjs/accounts/admin.js +208 -0
  11. package/dist/cjs/accounts/errors.d.ts +6 -0
  12. package/dist/cjs/accounts/errors.js +98 -0
  13. package/dist/cjs/accounts/index.d.ts +4 -0
  14. package/dist/cjs/accounts/index.js +20 -0
  15. package/dist/cjs/accounts/pdas.d.ts +23 -0
  16. package/dist/cjs/accounts/pdas.js +44 -0
  17. package/dist/cjs/accounts/queries.d.ts +41 -0
  18. package/dist/cjs/accounts/queries.js +95 -0
  19. package/dist/cjs/client.d.ts +2 -407
  20. package/dist/cjs/client.js +6 -938
  21. package/dist/cjs/cloak/client.d.ts +28 -0
  22. package/dist/cjs/cloak/client.js +68 -0
  23. package/dist/cjs/cloak/errors.d.ts +13 -0
  24. package/dist/cjs/cloak/errors.js +25 -0
  25. package/dist/cjs/cloak/helpers.d.ts +6 -0
  26. package/dist/cjs/cloak/helpers.js +35 -0
  27. package/dist/cjs/cloak/index.d.ts +6 -0
  28. package/dist/cjs/cloak/index.js +24 -0
  29. package/dist/cjs/cloak/polling.d.ts +7 -0
  30. package/dist/cjs/cloak/polling.js +66 -0
  31. package/dist/cjs/cloak/transport.d.ts +15 -0
  32. package/dist/cjs/cloak/transport.js +119 -0
  33. package/dist/cjs/cloak/types.d.ts +188 -0
  34. package/dist/cjs/cloak/types.js +5 -0
  35. package/dist/cjs/cloak.d.ts +1 -0
  36. package/dist/cjs/cloak.js +18 -0
  37. package/dist/cjs/compactNote.d.ts +21 -0
  38. package/dist/cjs/compactNote.js +31 -7
  39. package/dist/cjs/events/index.d.ts +6 -0
  40. package/dist/cjs/events/index.js +22 -0
  41. package/dist/cjs/events/parsing.d.ts +25 -0
  42. package/dist/cjs/events/parsing.js +158 -0
  43. package/dist/cjs/events/position.d.ts +26 -0
  44. package/dist/cjs/events/position.js +53 -0
  45. package/dist/cjs/events/recovery.d.ts +87 -0
  46. package/dist/cjs/events/recovery.js +281 -0
  47. package/dist/cjs/events/scanning.d.ts +35 -0
  48. package/dist/cjs/events/scanning.js +98 -0
  49. package/dist/cjs/events/tree.d.ts +27 -0
  50. package/dist/cjs/events/tree.js +63 -0
  51. package/dist/cjs/events/types.d.ts +39 -0
  52. package/dist/cjs/events.d.ts +1 -77
  53. package/dist/cjs/events.js +6 -154
  54. package/dist/cjs/identity/encoding.d.ts +9 -0
  55. package/dist/cjs/identity/encoding.js +85 -0
  56. package/dist/cjs/identity/index.d.ts +4 -0
  57. package/dist/cjs/identity/index.js +20 -0
  58. package/dist/cjs/identity/noteKey.d.ts +33 -0
  59. package/dist/cjs/identity/noteKey.js +97 -0
  60. package/dist/cjs/identity/spending.d.ts +18 -0
  61. package/dist/cjs/identity/spending.js +46 -0
  62. package/dist/cjs/identity/viewKey.d.ts +38 -0
  63. package/dist/cjs/identity/viewKey.js +105 -0
  64. package/dist/cjs/idl/index.d.ts +18 -0
  65. package/dist/cjs/idl/index.js +24 -0
  66. package/dist/cjs/idl/privacy_pool.json +9907 -9907
  67. package/dist/cjs/idl/privacy_pool_legacy.js +3307 -0
  68. package/dist/cjs/idl/privacy_pool_legacy.json +2302 -0
  69. package/dist/cjs/idl/privacy_pool_legacy2.d.ts +5 -0
  70. package/dist/cjs/idl/privacy_pool_legacy2.js +3397 -0
  71. package/dist/cjs/idl/privacy_pool_legacy2.json +2376 -0
  72. package/dist/cjs/index.d.ts +9 -3
  73. package/dist/cjs/index.js +15 -2
  74. package/dist/cjs/notes/amount.d.ts +2 -0
  75. package/dist/cjs/notes/amount.js +21 -0
  76. package/dist/cjs/notes/encryption.d.ts +41 -0
  77. package/dist/cjs/notes/encryption.js +75 -0
  78. package/dist/cjs/notes/index.d.ts +8 -0
  79. package/dist/cjs/notes/index.js +24 -0
  80. package/dist/cjs/notes/mailbox.d.ts +70 -0
  81. package/dist/cjs/notes/mailbox.js +164 -0
  82. package/dist/cjs/notes/model.d.ts +91 -0
  83. package/dist/cjs/notes/model.js +109 -0
  84. package/dist/cjs/notes/nullifier.d.ts +27 -0
  85. package/dist/cjs/notes/nullifier.js +45 -0
  86. package/dist/cjs/notes/recovery.d.ts +20 -0
  87. package/dist/cjs/notes/recovery.js +48 -0
  88. package/dist/cjs/notes/selection.d.ts +77 -0
  89. package/dist/cjs/notes/selection.js +193 -0
  90. package/dist/cjs/notes/spent.d.ts +60 -0
  91. package/dist/cjs/notes/spent.js +101 -0
  92. package/dist/cjs/perps/constants.d.ts +16 -0
  93. package/dist/cjs/perps/constants.js +52 -0
  94. package/dist/cjs/perps/index.d.ts +5 -0
  95. package/dist/cjs/perps/index.js +21 -0
  96. package/dist/cjs/perps/keys.d.ts +16 -0
  97. package/dist/cjs/perps/keys.js +43 -0
  98. package/dist/cjs/perps/pdas.d.ts +29 -0
  99. package/dist/cjs/perps/pdas.js +55 -0
  100. package/dist/cjs/perps/relayer.d.ts +9 -0
  101. package/dist/cjs/perps/relayer.js +35 -0
  102. package/dist/cjs/perps/types.d.ts +126 -0
  103. package/dist/cjs/perps/types.js +2 -0
  104. package/dist/cjs/positions/index.d.ts +4 -0
  105. package/dist/cjs/positions/index.js +20 -0
  106. package/dist/cjs/positions/keys.d.ts +29 -0
  107. package/dist/cjs/positions/keys.js +71 -0
  108. package/dist/cjs/positions/pdas.d.ts +15 -0
  109. package/dist/cjs/positions/pdas.js +54 -0
  110. package/dist/cjs/positions/relayer.d.ts +4 -0
  111. package/dist/cjs/positions/relayer.js +15 -0
  112. package/dist/cjs/positions/types.d.ts +97 -0
  113. package/dist/cjs/positions/types.js +2 -0
  114. package/dist/cjs/predictions/client.d.ts +41 -0
  115. package/dist/cjs/predictions/client.js +147 -0
  116. package/dist/cjs/predictions/index.d.ts +5 -0
  117. package/dist/cjs/predictions/index.js +21 -0
  118. package/dist/cjs/predictions/keys.d.ts +14 -0
  119. package/dist/cjs/predictions/keys.js +40 -0
  120. package/dist/cjs/predictions/pdas.d.ts +6 -0
  121. package/dist/cjs/predictions/pdas.js +13 -0
  122. package/dist/cjs/predictions/relayer.d.ts +3 -0
  123. package/dist/cjs/predictions/relayer.js +11 -0
  124. package/dist/cjs/predictions/types.d.ts +178 -0
  125. package/dist/cjs/predictions/types.js +2 -0
  126. package/dist/cjs/program.d.ts +2 -0
  127. package/dist/cjs/program.js +8 -7
  128. package/dist/cjs/proof.d.ts +1 -183
  129. package/dist/cjs/proof.js +16 -290
  130. package/dist/cjs/proofs/encoding.d.ts +17 -0
  131. package/dist/cjs/proofs/encoding.js +72 -0
  132. package/dist/cjs/proofs/formatting.d.ts +6 -0
  133. package/dist/cjs/proofs/formatting.js +34 -0
  134. package/dist/cjs/proofs/index.d.ts +5 -0
  135. package/dist/cjs/proofs/index.js +21 -0
  136. package/dist/cjs/proofs/swap.d.ts +87 -0
  137. package/dist/cjs/proofs/swap.js +144 -0
  138. package/dist/cjs/proofs/transaction.d.ts +28 -0
  139. package/dist/cjs/proofs/transaction.js +110 -0
  140. package/dist/cjs/proofs/types.d.ts +70 -0
  141. package/dist/cjs/proofs/types.js +2 -0
  142. package/dist/cjs/prover.d.ts +30 -4
  143. package/dist/cjs/prover.js +118 -49
  144. package/dist/cjs/relayer/api.d.ts +31 -0
  145. package/dist/cjs/relayer/api.js +86 -0
  146. package/dist/cjs/relayer/client.d.ts +73 -0
  147. package/dist/cjs/relayer/client.js +206 -0
  148. package/dist/cjs/relayer/crypto.d.ts +5 -0
  149. package/dist/cjs/relayer/crypto.js +26 -0
  150. package/dist/cjs/relayer/encoding.d.ts +2 -0
  151. package/dist/cjs/relayer/encoding.js +23 -0
  152. package/dist/cjs/relayer/errors.d.ts +7 -0
  153. package/dist/cjs/relayer/errors.js +17 -0
  154. package/dist/cjs/relayer/index.d.ts +6 -0
  155. package/dist/cjs/relayer/index.js +19 -0
  156. package/dist/cjs/relayer/internal-config.d.ts +36 -0
  157. package/dist/cjs/relayer/internal-config.js +9 -0
  158. package/dist/cjs/relayer/internal.d.ts +6 -0
  159. package/dist/cjs/relayer/internal.js +14 -0
  160. package/dist/cjs/relayer/transport.d.ts +19 -0
  161. package/dist/cjs/relayer/transport.js +68 -0
  162. package/dist/{src/relayer.d.ts → cjs/relayer/types.d.ts} +53 -96
  163. package/dist/cjs/relayer/types.js +5 -0
  164. package/dist/cjs/relayer.d.ts +1 -318
  165. package/dist/cjs/relayer.js +15 -254
  166. package/dist/cjs/shield/alt.js +8 -8
  167. package/dist/cjs/shield/errors.js +2 -2
  168. package/dist/cjs/shield/finalize.js +2 -2
  169. package/dist/cjs/shield/ix.d.ts +1 -1
  170. package/dist/cjs/shield/owner.js +9 -11
  171. package/dist/cjs/shield/ports.js +3 -3
  172. package/dist/cjs/shield/preflight.js +3 -3
  173. package/dist/cjs/shield/shield.js +20 -19
  174. package/dist/cjs/shield/types.d.ts +1 -1
  175. package/dist/cjs/transactions/deposit.d.ts +94 -0
  176. package/dist/cjs/transactions/deposit.js +234 -0
  177. package/dist/cjs/transactions/index.d.ts +7 -0
  178. package/dist/cjs/transactions/index.js +26 -0
  179. package/dist/cjs/transactions/swap.d.ts +71 -0
  180. package/dist/cjs/transactions/swap.js +184 -0
  181. package/dist/cjs/transactions/transact.d.ts +34 -0
  182. package/dist/cjs/transactions/transact.js +146 -0
  183. package/dist/cjs/transactions/transfer.d.ts +51 -0
  184. package/dist/cjs/transactions/transfer.js +106 -0
  185. package/dist/cjs/transactions/withdraw.d.ts +52 -0
  186. package/dist/cjs/transactions/withdraw.js +104 -0
  187. package/dist/cjs/utxo.d.ts +1 -235
  188. package/dist/cjs/utxo.js +15 -404
  189. package/dist/esm/accounts/admin.d.ts +84 -0
  190. package/dist/esm/accounts/admin.js +165 -0
  191. package/dist/esm/accounts/errors.d.ts +6 -0
  192. package/dist/esm/accounts/errors.js +95 -0
  193. package/dist/esm/accounts/index.d.ts +4 -0
  194. package/dist/esm/accounts/index.js +4 -0
  195. package/dist/esm/accounts/pdas.d.ts +23 -0
  196. package/dist/esm/accounts/pdas.js +38 -0
  197. package/dist/esm/accounts/queries.d.ts +41 -0
  198. package/dist/esm/accounts/queries.js +88 -0
  199. package/dist/esm/client.d.ts +2 -407
  200. package/dist/esm/client.js +3 -891
  201. package/dist/esm/cloak/client.d.ts +28 -0
  202. package/dist/esm/cloak/client.js +64 -0
  203. package/dist/esm/cloak/errors.d.ts +13 -0
  204. package/dist/esm/cloak/errors.js +21 -0
  205. package/dist/esm/cloak/helpers.d.ts +6 -0
  206. package/dist/esm/cloak/helpers.js +31 -0
  207. package/dist/esm/cloak/index.d.ts +6 -0
  208. package/dist/esm/cloak/index.js +6 -0
  209. package/dist/esm/cloak/polling.d.ts +7 -0
  210. package/dist/esm/cloak/polling.js +63 -0
  211. package/dist/esm/cloak/transport.d.ts +15 -0
  212. package/dist/esm/cloak/transport.js +115 -0
  213. package/dist/esm/cloak/types.d.ts +188 -0
  214. package/dist/esm/cloak/types.js +4 -0
  215. package/dist/esm/cloak.d.ts +1 -0
  216. package/dist/esm/cloak.js +2 -0
  217. package/dist/esm/compactNote.d.ts +21 -0
  218. package/dist/esm/compactNote.js +24 -1
  219. package/dist/esm/events/index.d.ts +6 -0
  220. package/dist/esm/events/index.js +6 -0
  221. package/dist/esm/events/parsing.d.ts +25 -0
  222. package/dist/esm/events/parsing.js +120 -0
  223. package/dist/esm/events/position.d.ts +26 -0
  224. package/dist/esm/events/position.js +48 -0
  225. package/dist/esm/events/recovery.d.ts +87 -0
  226. package/dist/esm/events/recovery.js +237 -0
  227. package/dist/esm/events/scanning.d.ts +35 -0
  228. package/dist/esm/events/scanning.js +92 -0
  229. package/dist/esm/events/tree.d.ts +27 -0
  230. package/dist/esm/events/tree.js +58 -0
  231. package/dist/esm/events/types.d.ts +39 -0
  232. package/dist/esm/events/types.js +1 -0
  233. package/dist/esm/events.d.ts +1 -77
  234. package/dist/esm/events.js +3 -129
  235. package/dist/esm/identity/encoding.d.ts +9 -0
  236. package/dist/esm/identity/encoding.js +75 -0
  237. package/dist/esm/identity/index.d.ts +4 -0
  238. package/dist/esm/identity/index.js +4 -0
  239. package/dist/esm/identity/noteKey.d.ts +33 -0
  240. package/dist/esm/identity/noteKey.js +91 -0
  241. package/dist/esm/identity/spending.d.ts +18 -0
  242. package/dist/esm/identity/spending.js +35 -0
  243. package/dist/esm/identity/viewKey.d.ts +38 -0
  244. package/dist/esm/identity/viewKey.js +96 -0
  245. package/dist/esm/idl/index.d.ts +18 -0
  246. package/dist/esm/idl/index.js +18 -0
  247. package/dist/esm/idl/privacy_pool.json +9907 -9907
  248. package/dist/esm/idl/privacy_pool_legacy.d.ts +5 -0
  249. package/dist/esm/idl/privacy_pool_legacy.js +3305 -0
  250. package/dist/esm/idl/privacy_pool_legacy.json +2302 -0
  251. package/dist/esm/idl/privacy_pool_legacy2.d.ts +5 -0
  252. package/dist/esm/idl/privacy_pool_legacy2.js +3395 -0
  253. package/dist/esm/idl/privacy_pool_legacy2.json +2376 -0
  254. package/dist/esm/index.d.ts +9 -3
  255. package/dist/esm/index.js +10 -3
  256. package/dist/esm/notes/amount.d.ts +2 -0
  257. package/dist/esm/notes/amount.js +18 -0
  258. package/dist/esm/notes/encryption.d.ts +41 -0
  259. package/dist/esm/notes/encryption.js +67 -0
  260. package/dist/esm/notes/index.d.ts +8 -0
  261. package/dist/esm/notes/index.js +8 -0
  262. package/dist/esm/notes/mailbox.d.ts +70 -0
  263. package/dist/esm/notes/mailbox.js +154 -0
  264. package/dist/esm/notes/model.d.ts +91 -0
  265. package/dist/esm/notes/model.js +99 -0
  266. package/dist/esm/notes/nullifier.d.ts +27 -0
  267. package/dist/esm/notes/nullifier.js +40 -0
  268. package/dist/esm/notes/recovery.d.ts +20 -0
  269. package/dist/esm/notes/recovery.js +45 -0
  270. package/dist/esm/notes/selection.d.ts +77 -0
  271. package/dist/esm/notes/selection.js +188 -0
  272. package/dist/esm/notes/spent.d.ts +60 -0
  273. package/dist/esm/notes/spent.js +96 -0
  274. package/dist/esm/perps/constants.d.ts +16 -0
  275. package/dist/esm/perps/constants.js +48 -0
  276. package/dist/esm/perps/index.d.ts +5 -0
  277. package/dist/esm/perps/index.js +5 -0
  278. package/dist/esm/perps/keys.d.ts +16 -0
  279. package/dist/esm/perps/keys.js +35 -0
  280. package/dist/esm/perps/pdas.d.ts +29 -0
  281. package/dist/esm/perps/pdas.js +47 -0
  282. package/dist/esm/perps/relayer.d.ts +9 -0
  283. package/dist/esm/perps/relayer.js +25 -0
  284. package/dist/esm/perps/types.d.ts +126 -0
  285. package/dist/esm/perps/types.js +1 -0
  286. package/dist/esm/positions/index.d.ts +4 -0
  287. package/dist/esm/positions/index.js +4 -0
  288. package/dist/esm/positions/keys.d.ts +29 -0
  289. package/dist/esm/positions/keys.js +65 -0
  290. package/dist/esm/positions/pdas.d.ts +15 -0
  291. package/dist/esm/positions/pdas.js +44 -0
  292. package/dist/esm/positions/relayer.d.ts +4 -0
  293. package/dist/esm/positions/relayer.js +10 -0
  294. package/dist/esm/positions/types.d.ts +97 -0
  295. package/dist/esm/positions/types.js +1 -0
  296. package/dist/esm/predictions/client.d.ts +41 -0
  297. package/dist/esm/predictions/client.js +141 -0
  298. package/dist/esm/predictions/index.d.ts +5 -0
  299. package/dist/esm/predictions/index.js +5 -0
  300. package/dist/esm/predictions/keys.d.ts +14 -0
  301. package/dist/esm/predictions/keys.js +33 -0
  302. package/dist/esm/predictions/pdas.d.ts +6 -0
  303. package/dist/esm/predictions/pdas.js +10 -0
  304. package/dist/esm/predictions/relayer.d.ts +3 -0
  305. package/dist/esm/predictions/relayer.js +7 -0
  306. package/dist/esm/predictions/types.d.ts +178 -0
  307. package/dist/esm/predictions/types.js +1 -0
  308. package/dist/esm/program.d.ts +2 -0
  309. package/dist/esm/program.js +4 -3
  310. package/dist/esm/proof.d.ts +1 -183
  311. package/dist/esm/proof.js +2 -281
  312. package/dist/esm/proofs/encoding.d.ts +17 -0
  313. package/dist/esm/proofs/encoding.js +68 -0
  314. package/dist/esm/proofs/formatting.d.ts +6 -0
  315. package/dist/esm/proofs/formatting.js +31 -0
  316. package/dist/esm/proofs/index.d.ts +5 -0
  317. package/dist/esm/proofs/index.js +5 -0
  318. package/dist/esm/proofs/swap.d.ts +87 -0
  319. package/dist/esm/proofs/swap.js +138 -0
  320. package/dist/esm/proofs/transaction.d.ts +28 -0
  321. package/dist/esm/proofs/transaction.js +105 -0
  322. package/dist/esm/proofs/types.d.ts +70 -0
  323. package/dist/esm/proofs/types.js +1 -0
  324. package/dist/esm/prover.d.ts +30 -4
  325. package/dist/esm/prover.js +115 -15
  326. package/dist/esm/relayer/api.d.ts +31 -0
  327. package/dist/esm/relayer/api.js +55 -0
  328. package/dist/esm/relayer/client.d.ts +73 -0
  329. package/dist/esm/relayer/client.js +199 -0
  330. package/dist/esm/relayer/crypto.d.ts +5 -0
  331. package/dist/esm/relayer/crypto.js +20 -0
  332. package/dist/esm/relayer/encoding.d.ts +2 -0
  333. package/dist/esm/relayer/encoding.js +19 -0
  334. package/dist/esm/relayer/errors.d.ts +7 -0
  335. package/dist/esm/relayer/errors.js +13 -0
  336. package/dist/esm/relayer/index.d.ts +6 -0
  337. package/dist/esm/relayer/index.js +3 -0
  338. package/dist/esm/relayer/internal-config.d.ts +36 -0
  339. package/dist/esm/relayer/internal-config.js +6 -0
  340. package/dist/esm/relayer/internal.d.ts +6 -0
  341. package/dist/esm/relayer/internal.js +10 -0
  342. package/dist/esm/relayer/transport.d.ts +19 -0
  343. package/dist/esm/relayer/transport.js +64 -0
  344. package/dist/esm/relayer/types.d.ts +275 -0
  345. package/dist/esm/relayer/types.js +4 -0
  346. package/dist/esm/relayer.d.ts +1 -318
  347. package/dist/esm/relayer.js +2 -249
  348. package/dist/esm/shield/alt.js +1 -1
  349. package/dist/esm/shield/errors.js +1 -1
  350. package/dist/esm/shield/finalize.js +1 -1
  351. package/dist/esm/shield/ix.d.ts +1 -1
  352. package/dist/esm/shield/owner.js +3 -5
  353. package/dist/esm/shield/ports.js +1 -1
  354. package/dist/esm/shield/preflight.js +1 -1
  355. package/dist/esm/shield/shield.js +4 -3
  356. package/dist/esm/shield/types.d.ts +1 -1
  357. package/dist/esm/transactions/deposit.d.ts +94 -0
  358. package/dist/esm/transactions/deposit.js +198 -0
  359. package/dist/esm/transactions/index.d.ts +7 -0
  360. package/dist/esm/transactions/index.js +7 -0
  361. package/dist/esm/transactions/swap.d.ts +71 -0
  362. package/dist/esm/transactions/swap.js +144 -0
  363. package/dist/esm/transactions/transact.d.ts +34 -0
  364. package/dist/esm/transactions/transact.js +110 -0
  365. package/dist/esm/transactions/transfer.d.ts +51 -0
  366. package/dist/esm/transactions/transfer.js +103 -0
  367. package/dist/esm/transactions/withdraw.d.ts +52 -0
  368. package/dist/esm/transactions/withdraw.js +101 -0
  369. package/dist/esm/utxo.d.ts +1 -235
  370. package/dist/esm/utxo.js +2 -382
  371. package/identity.d.ts +2 -0
  372. package/identity.js +3 -0
  373. package/idl.d.ts +2 -0
  374. package/idl.js +3 -0
  375. package/notes.d.ts +2 -0
  376. package/notes.js +3 -0
  377. package/package.json +131 -11
  378. package/perps.d.ts +2 -0
  379. package/perps.js +3 -0
  380. package/poseidon.d.ts +2 -2
  381. package/poseidon.js +2 -3
  382. package/positions.d.ts +2 -0
  383. package/positions.js +3 -0
  384. package/predictions.d.ts +2 -0
  385. package/predictions.js +3 -0
  386. package/proof.d.ts +2 -2
  387. package/proof.js +2 -3
  388. package/prover.d.ts +2 -2
  389. package/prover.js +2 -3
  390. package/relayer.d.ts +2 -0
  391. package/relayer.js +3 -0
  392. package/shield.d.ts +2 -2
  393. package/shield.js +2 -3
  394. package/transactions.d.ts +2 -0
  395. package/transactions.js +3 -0
  396. package/SHIELD_INTEGRATION.md +0 -143
  397. package/dist/src/client.d.ts +0 -407
  398. package/dist/src/client.js +0 -951
  399. package/dist/src/compactNote.d.ts +0 -107
  400. package/dist/src/compactNote.js +0 -167
  401. package/dist/src/config.d.ts +0 -82
  402. package/dist/src/config.js +0 -57
  403. package/dist/src/events.d.ts +0 -77
  404. package/dist/src/events.js +0 -167
  405. package/dist/src/idl/privacy_pool.js +0 -15218
  406. package/dist/src/index.d.ts +0 -16
  407. package/dist/src/index.js +0 -67
  408. package/dist/src/merkle.d.ts +0 -77
  409. package/dist/src/merkle.js +0 -156
  410. package/dist/src/poseidon.d.ts +0 -29
  411. package/dist/src/poseidon.js +0 -100
  412. package/dist/src/program.d.ts +0 -37
  413. package/dist/src/program.js +0 -61
  414. package/dist/src/proof.d.ts +0 -183
  415. package/dist/src/proof.js +0 -292
  416. package/dist/src/prover.d.ts +0 -54
  417. package/dist/src/prover.js +0 -112
  418. package/dist/src/random.d.ts +0 -16
  419. package/dist/src/random.js +0 -28
  420. package/dist/src/relayer.js +0 -257
  421. package/dist/src/retry.d.ts +0 -32
  422. package/dist/src/retry.js +0 -75
  423. package/dist/src/shield/alt.d.ts +0 -87
  424. package/dist/src/shield/alt.js +0 -194
  425. package/dist/src/shield/computeBudget.d.ts +0 -61
  426. package/dist/src/shield/computeBudget.js +0 -64
  427. package/dist/src/shield/errors.d.ts +0 -58
  428. package/dist/src/shield/errors.js +0 -121
  429. package/dist/src/shield/finalize.d.ts +0 -45
  430. package/dist/src/shield/finalize.js +0 -119
  431. package/dist/src/shield/index.d.ts +0 -35
  432. package/dist/src/shield/index.js +0 -68
  433. package/dist/src/shield/ix.d.ts +0 -54
  434. package/dist/src/shield/ix.js +0 -119
  435. package/dist/src/shield/owner.d.ts +0 -36
  436. package/dist/src/shield/owner.js +0 -126
  437. package/dist/src/shield/ports.d.ts +0 -43
  438. package/dist/src/shield/ports.js +0 -153
  439. package/dist/src/shield/preflight.d.ts +0 -30
  440. package/dist/src/shield/preflight.js +0 -154
  441. package/dist/src/shield/shield.d.ts +0 -68
  442. package/dist/src/shield/shield.js +0 -499
  443. package/dist/src/shield/types.d.ts +0 -202
  444. package/dist/src/utxo.d.ts +0 -235
  445. package/dist/src/utxo.js +0 -407
  446. package/dist/tests/compact-note.test.d.ts +0 -1
  447. package/dist/tests/compact-note.test.js +0 -173
  448. package/dist/tests/config.test.d.ts +0 -1
  449. package/dist/tests/config.test.js +0 -102
  450. package/dist/tests/edge-cases.test.d.ts +0 -1
  451. package/dist/tests/edge-cases.test.js +0 -220
  452. package/dist/tests/encryption.test.d.ts +0 -1
  453. package/dist/tests/encryption.test.js +0 -215
  454. package/dist/tests/events.test.d.ts +0 -1
  455. package/dist/tests/events.test.js +0 -78
  456. package/dist/tests/multi-tree.test.d.ts +0 -1
  457. package/dist/tests/multi-tree.test.js +0 -405
  458. package/dist/tests/pda.test.d.ts +0 -1
  459. package/dist/tests/pda.test.js +0 -229
  460. package/dist/tests/poseidon-builder-parity.test.d.ts +0 -1
  461. package/dist/tests/poseidon-builder-parity.test.js +0 -72
  462. package/dist/tests/poseidon.test.d.ts +0 -1
  463. package/dist/tests/poseidon.test.js +0 -142
  464. package/dist/tests/proof.test.d.ts +0 -1
  465. package/dist/tests/proof.test.js +0 -296
  466. package/dist/tests/relayer.test.d.ts +0 -1
  467. package/dist/tests/relayer.test.js +0 -271
  468. package/dist/tests/sdk.integration.test.d.ts +0 -1
  469. package/dist/tests/sdk.integration.test.js +0 -330
  470. package/dist/tests/shield-owner.test.d.ts +0 -1
  471. package/dist/tests/shield-owner.test.js +0 -89
  472. package/dist/tests/shield-preflight.test.d.ts +0 -1
  473. package/dist/tests/shield-preflight.test.js +0 -87
  474. package/dist/tests/shield-realproof.test.d.ts +0 -1
  475. package/dist/tests/shield-realproof.test.js +0 -272
  476. package/dist/tests/shield.test.d.ts +0 -1
  477. package/dist/tests/shield.test.js +0 -403
  478. package/dist/tests/utxo.test.d.ts +0 -1
  479. package/dist/tests/utxo.test.js +0 -140
  480. /package/dist/{src/shield → cjs/events}/types.js +0 -0
  481. /package/dist/{src/idl/privacy_pool.d.ts → cjs/idl/privacy_pool_legacy.d.ts} +0 -0
@@ -0,0 +1,87 @@
1
+ import { PublicKey } from "@solana/web3.js";
2
+ import type { InputUTXO, SerializedUTXO } from "../notes/model.js";
3
+ import type { ExtData, RawProof } from "./types.js";
4
+ /**
5
+ * Swap circuit inputs. Matches the signal shape declared by swap.circom's
6
+ * main component (see zk-circuits/swap.circom lines 208-238). Unlike the
7
+ * transaction circuit, the swap circuit distinguishes a "change" output
8
+ * (same mint as source) from a "dest" output (dest mint) and takes a
9
+ * swap-specific params hash and swapAmount alongside the usual inputs.
10
+ */
11
+ export type SwapCircuitInputs = {
12
+ sourceRoot: Uint8Array;
13
+ swapParamsHash: Uint8Array;
14
+ extDataHash: Uint8Array;
15
+ sourceMint: PublicKey;
16
+ destMint: PublicKey;
17
+ inputNullifiers: [Uint8Array, Uint8Array];
18
+ changeCommitment: Uint8Array;
19
+ destCommitment: Uint8Array;
20
+ swapAmount: bigint;
21
+ inAmount: [bigint, bigint];
22
+ inPubkey: [bigint, bigint];
23
+ inBlinding: [bigint, bigint];
24
+ inPathIndex: [number, number];
25
+ inPathElements: [bigint[], bigint[]];
26
+ inPrivateKey: [bigint, bigint];
27
+ changeAmount: bigint;
28
+ changePubkey: bigint;
29
+ changeBlinding: bigint;
30
+ destAmount: bigint;
31
+ destPubkey: bigint;
32
+ destBlinding: bigint;
33
+ minAmountOut: bigint;
34
+ deadline: bigint;
35
+ };
36
+ /** Proof builder accepted by SDK-side private swap flows. */
37
+ export type SwapProofBuilder = (inputs: SwapCircuitInputs) => Promise<RawProof>;
38
+ /**
39
+ * Prepare the exact witness/public inputs used by the relayer's swap circuit.
40
+ * Output 0 must be source-mint change and output 1 the destination-mint note.
41
+ */
42
+ export declare function prepareSwapInputs(params: {
43
+ inputUTXOs: [InputUTXO, InputUTXO];
44
+ changeUTXO: SerializedUTXO;
45
+ destUTXO: SerializedUTXO;
46
+ sourceRoot: Uint8Array;
47
+ sourceMint: PublicKey;
48
+ destMint: PublicKey;
49
+ swapAmount: bigint;
50
+ minAmountOut: bigint;
51
+ deadline: bigint;
52
+ extData: ExtData;
53
+ }): SwapCircuitInputs;
54
+ /**
55
+ * Convert SwapCircuitInputs into the shape expected by
56
+ * snarkjs.groth16.fullProve() for swap.circom. Every value is emitted as a
57
+ * decimal string (or string array) because snarkjs only accepts field
58
+ * elements as strings.
59
+ *
60
+ * Mirrors `generateSwapProof` in
61
+ * relayer-server/src/controllers/swap.helpers.ts so SDK-side swap proofs
62
+ * verify against the same circuit the relayer uses.
63
+ */
64
+ export declare function formatSwapInputsForSnarkjs(inputs: SwapCircuitInputs): Record<string, any>;
65
+ /**
66
+ * Compute the swap params hash that the swap circuit and on-chain program verify.
67
+ * Mirrors relayer-server/src/controllers/swap.helpers.ts `computeSwapParamsHash`.
68
+ *
69
+ * Circuit formula (swap.circom lines 293-307):
70
+ * mintPairHash = Poseidon(sourceMint, destMint)
71
+ * swapTermsHash = Poseidon(minAmountOut, deadline, destAmount)
72
+ * swapParamsHash = Poseidon(mintPairHash, swapTermsHash)
73
+ *
74
+ * @param sourceMint Source pool mint
75
+ * @param destMint Destination pool mint
76
+ * @param minAmountOut Minimum accepted output amount (slippage protected)
77
+ * @param deadline Positive Unix timestamp deadline (the program rejects 0)
78
+ * @param destAmount Actual amount committed to destination UTXO (≥ minAmountOut -
79
+ * relayerFee). If omitted, defaults to minAmountOut.
80
+ */
81
+ export declare function computeSwapParamsHash(sourceMint: PublicKey, destMint: PublicKey, minAmountOut: bigint, deadline: bigint, destAmount?: bigint): Uint8Array;
82
+ /**
83
+ * Compute the swap data hash committed on-chain for Jupiter instruction integrity.
84
+ * SHA-256 of the raw Jupiter swap instruction data bytes.
85
+ * Mirrors relayer-server/src/controllers/swap.helpers.ts `computeSwapDataHash`.
86
+ */
87
+ export declare function computeSwapDataHash(swapData: Uint8Array | Buffer): Uint8Array;
@@ -0,0 +1,144 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.prepareSwapInputs = prepareSwapInputs;
4
+ exports.formatSwapInputsForSnarkjs = formatSwapInputsForSnarkjs;
5
+ exports.computeSwapParamsHash = computeSwapParamsHash;
6
+ exports.computeSwapDataHash = computeSwapDataHash;
7
+ const sha256_1 = require("@noble/hashes/sha256");
8
+ const poseidon_js_1 = require("../poseidon.js");
9
+ const nullifier_js_1 = require("../notes/nullifier.js");
10
+ const transaction_js_1 = require("./transaction.js");
11
+ /**
12
+ * Prepare the exact witness/public inputs used by the relayer's swap circuit.
13
+ * Output 0 must be source-mint change and output 1 the destination-mint note.
14
+ */
15
+ function prepareSwapInputs(params) {
16
+ const { inputUTXOs, changeUTXO, destUTXO, sourceRoot, sourceMint, destMint, swapAmount, minAmountOut, deadline, extData, } = params;
17
+ const totalInput = inputUTXOs[0].amount + inputUTXOs[1].amount;
18
+ if (swapAmount <= 0n)
19
+ throw new Error("swapAmount must be positive");
20
+ if (deadline <= 0n) {
21
+ throw new Error("deadline must be a positive Unix timestamp");
22
+ }
23
+ if (totalInput !== swapAmount + changeUTXO.amount) {
24
+ throw new Error(`Swap balance mismatch: inputs=${totalInput}, swap=${swapAmount}, change=${changeUTXO.amount}`);
25
+ }
26
+ if (destUTXO.amount < minAmountOut) {
27
+ throw new Error("Destination note amount is below minAmountOut");
28
+ }
29
+ if (changeUTXO.mintAddress !== (0, poseidon_js_1.pubkeyToField)(sourceMint)) {
30
+ throw new Error("Change UTXO must use the source mint");
31
+ }
32
+ if (destUTXO.mintAddress !== (0, poseidon_js_1.pubkeyToField)(destMint)) {
33
+ throw new Error("Destination UTXO must use the destination mint");
34
+ }
35
+ return {
36
+ sourceRoot,
37
+ swapParamsHash: computeSwapParamsHash(sourceMint, destMint, minAmountOut, deadline, destUTXO.amount),
38
+ extDataHash: (0, transaction_js_1.computeExtDataHash)(extData),
39
+ sourceMint,
40
+ destMint,
41
+ inputNullifiers: [
42
+ (0, nullifier_js_1.deriveNullifier)(inputUTXOs[0], inputUTXOs[0].pathIndex, inputUTXOs[0].privateKey),
43
+ (0, nullifier_js_1.deriveNullifier)(inputUTXOs[1], inputUTXOs[1].pathIndex, inputUTXOs[1].privateKey),
44
+ ],
45
+ changeCommitment: changeUTXO.commitment,
46
+ destCommitment: destUTXO.commitment,
47
+ swapAmount,
48
+ inAmount: [inputUTXOs[0].amount, inputUTXOs[1].amount],
49
+ inPubkey: [inputUTXOs[0].pubkey, inputUTXOs[1].pubkey],
50
+ inBlinding: [inputUTXOs[0].blinding, inputUTXOs[1].blinding],
51
+ inPathIndex: [inputUTXOs[0].pathIndex, inputUTXOs[1].pathIndex],
52
+ inPathElements: [
53
+ inputUTXOs[0].pathElements.map((element) => (0, poseidon_js_1.bytesToBigIntBE)(element) % poseidon_js_1.BN254_FR_MODULUS),
54
+ inputUTXOs[1].pathElements.map((element) => (0, poseidon_js_1.bytesToBigIntBE)(element) % poseidon_js_1.BN254_FR_MODULUS),
55
+ ],
56
+ inPrivateKey: [inputUTXOs[0].privateKey, inputUTXOs[1].privateKey],
57
+ changeAmount: changeUTXO.amount,
58
+ changePubkey: changeUTXO.pubkey,
59
+ changeBlinding: changeUTXO.blinding,
60
+ destAmount: destUTXO.amount,
61
+ destPubkey: destUTXO.pubkey,
62
+ destBlinding: destUTXO.blinding,
63
+ minAmountOut,
64
+ deadline,
65
+ };
66
+ }
67
+ /**
68
+ * Convert SwapCircuitInputs into the shape expected by
69
+ * snarkjs.groth16.fullProve() for swap.circom. Every value is emitted as a
70
+ * decimal string (or string array) because snarkjs only accepts field
71
+ * elements as strings.
72
+ *
73
+ * Mirrors `generateSwapProof` in
74
+ * relayer-server/src/controllers/swap.helpers.ts so SDK-side swap proofs
75
+ * verify against the same circuit the relayer uses.
76
+ */
77
+ function formatSwapInputsForSnarkjs(inputs) {
78
+ return {
79
+ // Public inputs
80
+ sourceRoot: (0, poseidon_js_1.bytesToBigIntBE)(inputs.sourceRoot).toString(),
81
+ swapParamsHash: (0, poseidon_js_1.bytesToBigIntBE)(inputs.swapParamsHash).toString(),
82
+ extDataHash: (0, poseidon_js_1.bytesToBigIntBE)(inputs.extDataHash).toString(),
83
+ sourceMint: (0, poseidon_js_1.pubkeyToField)(inputs.sourceMint).toString(),
84
+ destMint: (0, poseidon_js_1.pubkeyToField)(inputs.destMint).toString(),
85
+ inputNullifier: inputs.inputNullifiers.map((n) => (0, poseidon_js_1.bytesToBigIntBE)(n).toString()),
86
+ changeCommitment: (0, poseidon_js_1.bytesToBigIntBE)(inputs.changeCommitment).toString(),
87
+ destCommitment: (0, poseidon_js_1.bytesToBigIntBE)(inputs.destCommitment).toString(),
88
+ swapAmount: inputs.swapAmount.toString(),
89
+ // Private inputs - Input UTXOs
90
+ inAmount: inputs.inAmount.map((a) => a.toString()),
91
+ inPubkey: inputs.inPubkey.map((p) => p.toString()),
92
+ inBlinding: inputs.inBlinding.map((b) => b.toString()),
93
+ inPathIndex: inputs.inPathIndex.map((i) => i.toString()),
94
+ inPathElements: inputs.inPathElements.map((path) => path.map((e) => e.toString())),
95
+ inPrivateKey: inputs.inPrivateKey.map((k) => k.toString()),
96
+ // Private inputs - Change UTXO
97
+ changeAmount: inputs.changeAmount.toString(),
98
+ changePubkey: inputs.changePubkey.toString(),
99
+ changeBlinding: inputs.changeBlinding.toString(),
100
+ // Private inputs - Destination UTXO
101
+ destAmount: inputs.destAmount.toString(),
102
+ destPubkey: inputs.destPubkey.toString(),
103
+ destBlinding: inputs.destBlinding.toString(),
104
+ // Swap params
105
+ minAmountOut: inputs.minAmountOut.toString(),
106
+ deadline: inputs.deadline.toString(),
107
+ };
108
+ }
109
+ // -----------------------------------------------------------------------------
110
+ // Swap Parameter Hashing
111
+ // -----------------------------------------------------------------------------
112
+ /**
113
+ * Compute the swap params hash that the swap circuit and on-chain program verify.
114
+ * Mirrors relayer-server/src/controllers/swap.helpers.ts `computeSwapParamsHash`.
115
+ *
116
+ * Circuit formula (swap.circom lines 293-307):
117
+ * mintPairHash = Poseidon(sourceMint, destMint)
118
+ * swapTermsHash = Poseidon(minAmountOut, deadline, destAmount)
119
+ * swapParamsHash = Poseidon(mintPairHash, swapTermsHash)
120
+ *
121
+ * @param sourceMint Source pool mint
122
+ * @param destMint Destination pool mint
123
+ * @param minAmountOut Minimum accepted output amount (slippage protected)
124
+ * @param deadline Positive Unix timestamp deadline (the program rejects 0)
125
+ * @param destAmount Actual amount committed to destination UTXO (≥ minAmountOut -
126
+ * relayerFee). If omitted, defaults to minAmountOut.
127
+ */
128
+ function computeSwapParamsHash(sourceMint, destMint, minAmountOut, deadline, destAmount) {
129
+ const srcField = (0, poseidon_js_1.pubkeyToField)(sourceMint);
130
+ const dstField = (0, poseidon_js_1.pubkeyToField)(destMint);
131
+ const mintPairHash = (0, poseidon_js_1.poseidon2)(srcField, dstField);
132
+ const dest = destAmount ?? minAmountOut;
133
+ const swapTermsHash = (0, poseidon_js_1.poseidon3)(minAmountOut, deadline, dest);
134
+ const paramsHash = (0, poseidon_js_1.poseidon2)(mintPairHash, swapTermsHash);
135
+ return (0, poseidon_js_1.bigIntToBytesBE)(paramsHash);
136
+ }
137
+ /**
138
+ * Compute the swap data hash committed on-chain for Jupiter instruction integrity.
139
+ * SHA-256 of the raw Jupiter swap instruction data bytes.
140
+ * Mirrors relayer-server/src/controllers/swap.helpers.ts `computeSwapDataHash`.
141
+ */
142
+ function computeSwapDataHash(swapData) {
143
+ return (0, sha256_1.sha256)(swapData instanceof Buffer ? new Uint8Array(swapData) : swapData);
144
+ }
@@ -0,0 +1,28 @@
1
+ import { PublicKey } from "@solana/web3.js";
2
+ import type { InputUTXO, SerializedUTXO } from "../notes/model.js";
3
+ import type { ExtData, TransactionCircuitInputs } from "./types.js";
4
+ /**
5
+ * Compute the external data hash.
6
+ * Matches on-chain computation:
7
+ * hash1 = Poseidon(recipient, relayer)
8
+ * hash2 = Poseidon(fee, refund)
9
+ * extDataHash = Poseidon(hash1, hash2, claimant)
10
+ */
11
+ export declare function computeExtDataHash(extData: ExtData): Uint8Array;
12
+ /**
13
+ * Convert i64 to field element (handles negative via modular arithmetic).
14
+ * For negative values, we add the field modulus to get the equivalent positive representation.
15
+ */
16
+ export declare function i64ToField(value: bigint): bigint;
17
+ /**
18
+ * Prepare transaction circuit inputs from high-level parameters.
19
+ * This converts the SDK types into the format expected by the circuit.
20
+ */
21
+ export declare function prepareTransactionInputs(params: {
22
+ inputUTXOs: [InputUTXO, InputUTXO];
23
+ outputUTXOs: [SerializedUTXO, SerializedUTXO];
24
+ root: Uint8Array;
25
+ publicAmount: bigint;
26
+ extData: ExtData;
27
+ mintAddress: PublicKey;
28
+ }): TransactionCircuitInputs;
@@ -0,0 +1,110 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.computeExtDataHash = computeExtDataHash;
4
+ exports.i64ToField = i64ToField;
5
+ exports.prepareTransactionInputs = prepareTransactionInputs;
6
+ const poseidon_js_1 = require("../poseidon.js");
7
+ const nullifier_js_1 = require("../notes/nullifier.js");
8
+ // -----------------------------------------------------------------------------
9
+ // ExtData Hash Computation
10
+ // -----------------------------------------------------------------------------
11
+ /**
12
+ * Compute the external data hash.
13
+ * Matches on-chain computation:
14
+ * hash1 = Poseidon(recipient, relayer)
15
+ * hash2 = Poseidon(fee, refund)
16
+ * extDataHash = Poseidon(hash1, hash2, claimant)
17
+ */
18
+ function computeExtDataHash(extData) {
19
+ const recipientField = (0, poseidon_js_1.pubkeyToField)(extData.recipient);
20
+ const relayerField = (0, poseidon_js_1.pubkeyToField)(extData.relayer);
21
+ const feeField = extData.fee % poseidon_js_1.BN254_FR_MODULUS;
22
+ const refundField = extData.refund % poseidon_js_1.BN254_FR_MODULUS;
23
+ const claimantField = (0, poseidon_js_1.pubkeyToField)(extData.claimant);
24
+ const hash1 = (0, poseidon_js_1.poseidon2)(recipientField, relayerField);
25
+ const hash2 = (0, poseidon_js_1.poseidon2)(feeField, refundField);
26
+ const finalHash = (0, poseidon_js_1.poseidon3)(hash1, hash2, claimantField);
27
+ return (0, poseidon_js_1.bigIntToBytesBE)(finalHash);
28
+ }
29
+ // -----------------------------------------------------------------------------
30
+ // Circuit Input Preparation
31
+ // -----------------------------------------------------------------------------
32
+ /**
33
+ * Convert i64 to field element (handles negative via modular arithmetic).
34
+ * For negative values, we add the field modulus to get the equivalent positive representation.
35
+ */
36
+ function i64ToField(value) {
37
+ if (value >= 0n) {
38
+ return value % poseidon_js_1.BN254_FR_MODULUS;
39
+ }
40
+ return (poseidon_js_1.BN254_FR_MODULUS + value) % poseidon_js_1.BN254_FR_MODULUS;
41
+ }
42
+ /**
43
+ * Prepare transaction circuit inputs from high-level parameters.
44
+ * This converts the SDK types into the format expected by the circuit.
45
+ */
46
+ function prepareTransactionInputs(params) {
47
+ const { inputUTXOs, outputUTXOs, root, publicAmount, extData, mintAddress } = params;
48
+ const extDataHash = computeExtDataHash(extData);
49
+ const mintField = (0, poseidon_js_1.pubkeyToField)(mintAddress);
50
+ // Prepare input UTXO data
51
+ const inAmount = [
52
+ inputUTXOs[0].amount,
53
+ inputUTXOs[1].amount,
54
+ ];
55
+ const inPubkey = [
56
+ inputUTXOs[0].pubkey,
57
+ inputUTXOs[1].pubkey,
58
+ ];
59
+ const inBlinding = [
60
+ inputUTXOs[0].blinding,
61
+ inputUTXOs[1].blinding,
62
+ ];
63
+ const inPathIndex = [
64
+ inputUTXOs[0].pathIndex,
65
+ inputUTXOs[1].pathIndex,
66
+ ];
67
+ const inPathElements = [
68
+ inputUTXOs[0].pathElements.map((e) => (0, poseidon_js_1.bytesToBigIntBE)(e) % poseidon_js_1.BN254_FR_MODULUS),
69
+ inputUTXOs[1].pathElements.map((e) => (0, poseidon_js_1.bytesToBigIntBE)(e) % poseidon_js_1.BN254_FR_MODULUS),
70
+ ];
71
+ const inPrivateKey = [
72
+ inputUTXOs[0].privateKey,
73
+ inputUTXOs[1].privateKey,
74
+ ];
75
+ // Prepare output UTXO data
76
+ const outAmount = [
77
+ outputUTXOs[0].amount,
78
+ outputUTXOs[1].amount,
79
+ ];
80
+ const outPubkey = [
81
+ outputUTXOs[0].pubkey,
82
+ outputUTXOs[1].pubkey,
83
+ ];
84
+ const outBlinding = [
85
+ outputUTXOs[0].blinding,
86
+ outputUTXOs[1].blinding,
87
+ ];
88
+ // Derive nullifiers for input UTXOs
89
+ const inputNullifiers = [
90
+ (0, nullifier_js_1.deriveNullifier)(inputUTXOs[0], inputUTXOs[0].pathIndex, inputUTXOs[0].privateKey),
91
+ (0, nullifier_js_1.deriveNullifier)(inputUTXOs[1], inputUTXOs[1].pathIndex, inputUTXOs[1].privateKey),
92
+ ];
93
+ return {
94
+ root,
95
+ publicAmount,
96
+ extDataHash,
97
+ mintAddress,
98
+ inputNullifiers,
99
+ outputCommitments: [outputUTXOs[0].commitment, outputUTXOs[1].commitment],
100
+ inAmount,
101
+ inPubkey,
102
+ inBlinding,
103
+ inPathIndex,
104
+ inPathElements,
105
+ inPrivateKey,
106
+ outAmount,
107
+ outPubkey,
108
+ outBlinding,
109
+ };
110
+ }
@@ -0,0 +1,70 @@
1
+ import { PublicKey } from "@solana/web3.js";
2
+ /**
3
+ * External data that gets hashed into ext_data_hash.
4
+ * These are public parameters that affect financial flows.
5
+ */
6
+ export type ExtData = {
7
+ /** Who receives withdrawal (for withdrawals) */
8
+ recipient: PublicKey;
9
+ /** Who submits tx and gets fee */
10
+ relayer: PublicKey;
11
+ /** Fee to relayer in lamports/token units */
12
+ fee: bigint;
13
+ /** Refund to user in lamports/token units (for gas compensation) */
14
+ refund: bigint;
15
+ /** Claimant key committed into the proof */
16
+ claimant: PublicKey;
17
+ };
18
+ /**
19
+ * Transaction circuit inputs (8 public inputs, many private inputs).
20
+ * This structure is used to prepare inputs for the snarkjs prover.
21
+ */
22
+ export type TransactionCircuitInputs = {
23
+ /** Merkle root of UTXO tree */
24
+ root: Uint8Array;
25
+ /** Net deposit/withdrawal amount (positive = deposit, negative = withdrawal) */
26
+ publicAmount: bigint;
27
+ /** Hash of external data (recipient, relayer, fee, refund) */
28
+ extDataHash: Uint8Array;
29
+ /** Token mint address */
30
+ mintAddress: PublicKey;
31
+ /** Nullifiers for the two input UTXOs */
32
+ inputNullifiers: [Uint8Array, Uint8Array];
33
+ /** Commitments for the two output UTXOs */
34
+ outputCommitments: [Uint8Array, Uint8Array];
35
+ inAmount: [bigint, bigint];
36
+ inPubkey: [bigint, bigint];
37
+ inBlinding: [bigint, bigint];
38
+ inPathIndex: [number, number];
39
+ inPathElements: [bigint[], bigint[]];
40
+ inPrivateKey: [bigint, bigint];
41
+ outAmount: [bigint, bigint];
42
+ outPubkey: [bigint, bigint];
43
+ outBlinding: [bigint, bigint];
44
+ };
45
+ /**
46
+ * Proof structure matching the on-chain TransactionProof struct.
47
+ * Total size: 256 bytes (64 + 128 + 64)
48
+ */
49
+ export type TransactionProofStruct = {
50
+ /** G1 point A (64 bytes) */
51
+ proofA: number[];
52
+ /** G2 point B (128 bytes) */
53
+ proofB: number[];
54
+ /** G1 point C (64 bytes) */
55
+ proofC: number[];
56
+ };
57
+ /**
58
+ * Shape of a Groth16 proof produced by snarkjs.
59
+ */
60
+ export type RawProof = {
61
+ pi_a: [string, string, string];
62
+ pi_b: [[string, string], [string, string], [string, string]];
63
+ pi_c: [string, string, string];
64
+ protocol: string;
65
+ curve: string;
66
+ };
67
+ /**
68
+ * Proof builder function type - takes circuit inputs and returns a raw snarkjs proof.
69
+ */
70
+ export type TransactionProofBuilder = (inputs: TransactionCircuitInputs) => Promise<RawProof>;
@@ -0,0 +1,2 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,9 +1,12 @@
1
- import { TransactionProofBuilder, RawProof } from "./proof.js";
1
+ import type { TransactionProofBuilder, RawProof } from "./proofs/types.js";
2
+ import { type SwapProofBuilder } from "./proofs/swap.js";
2
3
  /**
3
4
  * Circuit artifact paths required by snarkjs.
4
5
  *
5
- * These files are large (10-100 MB) and should NOT be bundled in npm.
6
- * Host them on GitHub Releases, IPFS, or a CDN and download at runtime.
6
+ * These files are large (10-100 MB) and are NOT bundled in the npm package —
7
+ * `files` ships `dist/` only. Optional: omit them and the prover resolves a
8
+ * local copy (see `resolveCircuitArtifacts`). Supply them explicitly whenever
9
+ * the defaults cannot apply, which includes every browser build.
7
10
  *
8
11
  * For Node.js: pass file system paths (e.g. "./circuits/transaction.wasm").
9
12
  * For browsers: pass Uint8Array buffers or URLs that fetch returns as ArrayBuffer.
@@ -14,6 +17,27 @@ export interface CircuitArtifacts {
14
17
  /** Path or buffer for the Groth16 proving key (.zkey) */
15
18
  zkeyPath: string | Uint8Array;
16
19
  }
20
+ /** The circuits this package can resolve artifacts for. */
21
+ export type CircuitName = "transaction" | "swap";
22
+ /**
23
+ * Resolve circuit artifacts from disk when the caller did not supply them.
24
+ *
25
+ * Search order, first hit wins:
26
+ *
27
+ * 1. $VEILO_CIRCUITS_DIR explicit override
28
+ * 2. <package>/circuits populated by `npm run copy:circuits`
29
+ * 3. <cwd>/circuits
30
+ * 4. <cwd>/node_modules/@veilo/sdk-core/circuits
31
+ *
32
+ * NODE ONLY, AND DELIBERATELY LAZY. `node:fs` is imported inside the call, not
33
+ * at module scope: this module is reachable from the package root export, and a
34
+ * top-level `node:fs` import throws at bundle time in browser builds with no
35
+ * Node polyfill — the same reason `random.ts` avoids `node:crypto`. Browsers
36
+ * must pass `CircuitArtifacts` explicitly; there is nothing to resolve there.
37
+ *
38
+ * @throws when no candidate directory holds both files, listing what it tried
39
+ */
40
+ export declare function resolveCircuitArtifacts(circuit: CircuitName): Promise<CircuitArtifacts>;
17
41
  /**
18
42
  * Create a proof builder function for the transaction circuit.
19
43
  *
@@ -40,7 +64,9 @@ export interface CircuitArtifacts {
40
64
  * const proof = await prover(circuitInputs);
41
65
  * ```
42
66
  */
43
- export declare function createTransactionProver(artifacts: CircuitArtifacts): TransactionProofBuilder;
67
+ export declare function createTransactionProver(artifacts?: CircuitArtifacts): TransactionProofBuilder;
68
+ /** Create a proof builder for the current `swap.circom` witness shape. */
69
+ export declare function createSwapProver(artifacts?: CircuitArtifacts): SwapProofBuilder;
44
70
  /**
45
71
  * Verify a Groth16 proof against public signals and a verification key.
46
72
  *