@proto-kit/protocol 0.1.1-develop.191 → 0.1.1-develop.2024

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 (466) hide show
  1. package/dist/Constants.js +1 -0
  2. package/dist/Constants.js.map +1 -0
  3. package/dist/hashing/mina-prefixes.d.ts +10 -0
  4. package/dist/hashing/mina-prefixes.d.ts.map +1 -0
  5. package/dist/hashing/mina-prefixes.js +10 -0
  6. package/dist/hashing/mina-prefixes.js.map +1 -0
  7. package/dist/hashing/protokit-prefixes.d.ts +10 -0
  8. package/dist/hashing/protokit-prefixes.d.ts.map +1 -0
  9. package/dist/hashing/protokit-prefixes.js +24 -0
  10. package/dist/hashing/protokit-prefixes.js.map +1 -0
  11. package/dist/hooks/AccountStateHook.d.ts +56 -0
  12. package/dist/hooks/AccountStateHook.d.ts.map +1 -0
  13. package/dist/hooks/AccountStateHook.js +62 -0
  14. package/dist/hooks/AccountStateHook.js.map +1 -0
  15. package/dist/hooks/BlockHeightHook.d.ts +7 -0
  16. package/dist/hooks/BlockHeightHook.d.ts.map +1 -0
  17. package/dist/hooks/BlockHeightHook.js +16 -0
  18. package/dist/hooks/BlockHeightHook.js.map +1 -0
  19. package/dist/hooks/LastStateRootBlockHook.d.ts +7 -0
  20. package/dist/hooks/LastStateRootBlockHook.d.ts.map +1 -0
  21. package/dist/hooks/LastStateRootBlockHook.js +16 -0
  22. package/dist/hooks/LastStateRootBlockHook.js.map +1 -0
  23. package/dist/hooks/NoopBlockHook.d.ts +8 -0
  24. package/dist/hooks/NoopBlockHook.d.ts.map +1 -0
  25. package/dist/hooks/NoopBlockHook.js +10 -0
  26. package/dist/hooks/NoopBlockHook.js.map +1 -0
  27. package/dist/hooks/NoopSettlementHook.d.ts +6 -0
  28. package/dist/hooks/NoopSettlementHook.d.ts.map +1 -0
  29. package/dist/{prover/statetransition/StateTransitionWitnessProvider.js → hooks/NoopSettlementHook.js} +8 -7
  30. package/dist/hooks/NoopSettlementHook.js.map +1 -0
  31. package/dist/hooks/NoopTransactionHook.d.ts +6 -0
  32. package/dist/hooks/NoopTransactionHook.d.ts.map +1 -0
  33. package/dist/hooks/NoopTransactionHook.js +11 -0
  34. package/dist/hooks/NoopTransactionHook.js.map +1 -0
  35. package/dist/index.d.ts +59 -9
  36. package/dist/index.d.ts.map +1 -1
  37. package/dist/index.js +60 -9
  38. package/dist/index.js.map +1 -0
  39. package/dist/model/AppliedStateTransitionBatch.d.ts +114 -0
  40. package/dist/model/AppliedStateTransitionBatch.d.ts.map +1 -0
  41. package/dist/model/AppliedStateTransitionBatch.js +16 -0
  42. package/dist/model/AppliedStateTransitionBatch.js.map +1 -0
  43. package/dist/model/MethodPublicOutput.d.ts +83 -28
  44. package/dist/model/MethodPublicOutput.d.ts.map +1 -1
  45. package/dist/model/MethodPublicOutput.js +4 -1
  46. package/dist/model/MethodPublicOutput.js.map +1 -0
  47. package/dist/model/Option.d.ts +70 -46
  48. package/dist/model/Option.d.ts.map +1 -1
  49. package/dist/model/Option.js +62 -57
  50. package/dist/model/Option.js.map +1 -0
  51. package/dist/model/Path.d.ts +4 -3
  52. package/dist/model/Path.d.ts.map +1 -1
  53. package/dist/model/Path.js +6 -5
  54. package/dist/model/Path.js.map +1 -0
  55. package/dist/model/RuntimeLike.d.ts +11 -0
  56. package/dist/model/RuntimeLike.d.ts.map +1 -0
  57. package/dist/model/RuntimeLike.js +2 -0
  58. package/dist/model/RuntimeLike.js.map +1 -0
  59. package/dist/model/StateTransition.d.ts +58 -18
  60. package/dist/model/StateTransition.d.ts.map +1 -1
  61. package/dist/model/StateTransition.js +13 -4
  62. package/dist/model/StateTransition.js.map +1 -0
  63. package/dist/model/StateTransitionProvableBatch.d.ts +389 -16
  64. package/dist/model/StateTransitionProvableBatch.d.ts.map +1 -1
  65. package/dist/model/StateTransitionProvableBatch.js +87 -10
  66. package/dist/model/StateTransitionProvableBatch.js.map +1 -0
  67. package/dist/model/network/NetworkState.d.ts +105 -9
  68. package/dist/model/network/NetworkState.d.ts.map +1 -1
  69. package/dist/model/network/NetworkState.js +22 -2
  70. package/dist/model/network/NetworkState.js.map +1 -0
  71. package/dist/model/transaction/AuthorizedTransaction.d.ts +122 -0
  72. package/dist/model/transaction/AuthorizedTransaction.d.ts.map +1 -0
  73. package/dist/model/transaction/AuthorizedTransaction.js +39 -0
  74. package/dist/model/transaction/AuthorizedTransaction.js.map +1 -0
  75. package/dist/model/transaction/RuntimeTransaction.d.ts +94 -34
  76. package/dist/model/transaction/RuntimeTransaction.d.ts.map +1 -1
  77. package/dist/model/transaction/RuntimeTransaction.js +72 -11
  78. package/dist/model/transaction/RuntimeTransaction.js.map +1 -0
  79. package/dist/model/transaction/SignedTransaction.d.ts +110 -0
  80. package/dist/model/transaction/SignedTransaction.d.ts.map +1 -0
  81. package/dist/model/transaction/SignedTransaction.js +34 -0
  82. package/dist/model/transaction/SignedTransaction.js.map +1 -0
  83. package/dist/model/transaction/ValueOption.d.ts +187 -0
  84. package/dist/model/transaction/ValueOption.d.ts.map +1 -0
  85. package/dist/model/transaction/ValueOption.js +25 -0
  86. package/dist/model/transaction/ValueOption.js.map +1 -0
  87. package/dist/protocol/Protocol.d.ts +47 -21
  88. package/dist/protocol/Protocol.d.ts.map +1 -1
  89. package/dist/protocol/Protocol.js +127 -26
  90. package/dist/protocol/Protocol.js.map +1 -0
  91. package/dist/protocol/ProtocolEnvironment.d.ts +9 -0
  92. package/dist/protocol/ProtocolEnvironment.d.ts.map +1 -0
  93. package/dist/protocol/ProtocolEnvironment.js +2 -0
  94. package/dist/protocol/ProtocolEnvironment.js.map +1 -0
  95. package/dist/protocol/ProtocolModule.d.ts +7 -7
  96. package/dist/protocol/ProtocolModule.d.ts.map +1 -1
  97. package/dist/protocol/ProtocolModule.js +10 -7
  98. package/dist/protocol/ProtocolModule.js.map +1 -0
  99. package/dist/protocol/ProvableBlockHook.d.ts +29 -0
  100. package/dist/protocol/ProvableBlockHook.d.ts.map +1 -0
  101. package/dist/protocol/ProvableBlockHook.js +20 -0
  102. package/dist/protocol/ProvableBlockHook.js.map +1 -0
  103. package/dist/protocol/ProvableTransactionHook.d.ts +35 -0
  104. package/dist/protocol/ProvableTransactionHook.d.ts.map +1 -0
  105. package/dist/protocol/ProvableTransactionHook.js +28 -0
  106. package/dist/protocol/ProvableTransactionHook.js.map +1 -0
  107. package/dist/protocol/TransitioningProtocolModule.d.ts +10 -0
  108. package/dist/protocol/TransitioningProtocolModule.d.ts.map +1 -0
  109. package/dist/protocol/TransitioningProtocolModule.js +9 -0
  110. package/dist/protocol/TransitioningProtocolModule.js.map +1 -0
  111. package/dist/prover/accumulators/AppliedBatchHashList.d.ts +18 -0
  112. package/dist/prover/accumulators/AppliedBatchHashList.d.ts.map +1 -0
  113. package/dist/prover/accumulators/AppliedBatchHashList.js +25 -0
  114. package/dist/prover/accumulators/AppliedBatchHashList.js.map +1 -0
  115. package/dist/prover/accumulators/BlockHashList.d.ts +263 -0
  116. package/dist/prover/accumulators/BlockHashList.d.ts.map +1 -0
  117. package/dist/prover/accumulators/BlockHashList.js +97 -0
  118. package/dist/prover/accumulators/BlockHashList.js.map +1 -0
  119. package/dist/prover/accumulators/StateTransitionReductionList.d.ts +12 -0
  120. package/dist/prover/accumulators/StateTransitionReductionList.d.ts.map +1 -0
  121. package/dist/prover/accumulators/StateTransitionReductionList.js +64 -0
  122. package/dist/prover/accumulators/StateTransitionReductionList.js.map +1 -0
  123. package/dist/prover/accumulators/TransactionHashList.d.ts +6 -0
  124. package/dist/prover/accumulators/TransactionHashList.d.ts.map +1 -0
  125. package/dist/prover/accumulators/TransactionHashList.js +8 -0
  126. package/dist/prover/accumulators/TransactionHashList.js.map +1 -0
  127. package/dist/prover/accumulators/WitnessedRootHashList.d.ts +123 -0
  128. package/dist/prover/accumulators/WitnessedRootHashList.d.ts.map +1 -0
  129. package/dist/prover/accumulators/WitnessedRootHashList.js +51 -0
  130. package/dist/prover/accumulators/WitnessedRootHashList.js.map +1 -0
  131. package/dist/prover/block/BlockProvable.d.ts +565 -96
  132. package/dist/prover/block/BlockProvable.d.ts.map +1 -1
  133. package/dist/prover/block/BlockProvable.js +196 -12
  134. package/dist/prover/block/BlockProvable.js.map +1 -0
  135. package/dist/prover/block/BlockProver.d.ts +52 -37
  136. package/dist/prover/block/BlockProver.d.ts.map +1 -1
  137. package/dist/prover/block/BlockProver.js +327 -107
  138. package/dist/prover/block/BlockProver.js.map +1 -0
  139. package/dist/prover/block/accummulators/BlockHashMerkleTree.d.ts +106 -0
  140. package/dist/prover/block/accummulators/BlockHashMerkleTree.d.ts.map +1 -0
  141. package/dist/prover/block/accummulators/BlockHashMerkleTree.js +25 -0
  142. package/dist/prover/block/accummulators/BlockHashMerkleTree.js.map +1 -0
  143. package/dist/prover/block/accummulators/RuntimeVerificationKeyTree.d.ts +139 -0
  144. package/dist/prover/block/accummulators/RuntimeVerificationKeyTree.d.ts.map +1 -0
  145. package/dist/prover/block/accummulators/RuntimeVerificationKeyTree.js +21 -0
  146. package/dist/prover/block/accummulators/RuntimeVerificationKeyTree.js.map +1 -0
  147. package/dist/prover/block/services/RuntimeVerificationKeyRootService.d.ts +7 -0
  148. package/dist/prover/block/services/RuntimeVerificationKeyRootService.d.ts.map +1 -0
  149. package/dist/prover/{statetransition/StateTransitionWitnessProviderReference.js → block/services/RuntimeVerificationKeyRootService.js} +11 -8
  150. package/dist/prover/block/services/RuntimeVerificationKeyRootService.js.map +1 -0
  151. package/dist/prover/statetransition/StateTransitionProvable.d.ts +137 -48
  152. package/dist/prover/statetransition/StateTransitionProvable.d.ts.map +1 -1
  153. package/dist/prover/statetransition/StateTransitionProvable.js +10 -5
  154. package/dist/prover/statetransition/StateTransitionProvable.js.map +1 -0
  155. package/dist/prover/statetransition/StateTransitionProver.d.ts +29 -17
  156. package/dist/prover/statetransition/StateTransitionProver.d.ts.map +1 -1
  157. package/dist/prover/statetransition/StateTransitionProver.js +171 -73
  158. package/dist/prover/statetransition/StateTransitionProver.js.map +1 -0
  159. package/dist/prover/transaction/TransactionProvable.d.ts +626 -0
  160. package/dist/prover/transaction/TransactionProvable.d.ts.map +1 -0
  161. package/dist/prover/transaction/TransactionProvable.js +87 -0
  162. package/dist/prover/transaction/TransactionProvable.js.map +1 -0
  163. package/dist/prover/transaction/TransactionProver.d.ts +68 -0
  164. package/dist/prover/transaction/TransactionProver.d.ts.map +1 -0
  165. package/dist/prover/transaction/TransactionProver.js +301 -0
  166. package/dist/prover/transaction/TransactionProver.js.map +1 -0
  167. package/dist/prover/utils.d.ts +19 -0
  168. package/dist/prover/utils.d.ts.map +1 -0
  169. package/dist/prover/utils.js +67 -0
  170. package/dist/prover/utils.js.map +1 -0
  171. package/dist/settlement/ContractArgsRegistry.d.ts +13 -0
  172. package/dist/settlement/ContractArgsRegistry.d.ts.map +1 -0
  173. package/dist/settlement/ContractArgsRegistry.js +53 -0
  174. package/dist/settlement/ContractArgsRegistry.js.map +1 -0
  175. package/dist/settlement/ContractModule.d.ts +16 -0
  176. package/dist/settlement/ContractModule.d.ts.map +1 -0
  177. package/dist/settlement/ContractModule.js +12 -0
  178. package/dist/settlement/ContractModule.js.map +1 -0
  179. package/dist/settlement/SettlementContractModule.d.ts +47 -0
  180. package/dist/settlement/SettlementContractModule.d.ts.map +1 -0
  181. package/dist/settlement/SettlementContractModule.js +81 -0
  182. package/dist/settlement/SettlementContractModule.js.map +1 -0
  183. package/dist/settlement/contracts/BridgeContract.d.ts +119 -0
  184. package/dist/settlement/contracts/BridgeContract.d.ts.map +1 -0
  185. package/dist/settlement/contracts/BridgeContract.js +269 -0
  186. package/dist/settlement/contracts/BridgeContract.js.map +1 -0
  187. package/dist/settlement/contracts/BridgeContractProtocolModule.d.ts +18 -0
  188. package/dist/settlement/contracts/BridgeContractProtocolModule.d.ts.map +1 -0
  189. package/dist/settlement/contracts/BridgeContractProtocolModule.js +42 -0
  190. package/dist/settlement/contracts/BridgeContractProtocolModule.js.map +1 -0
  191. package/dist/settlement/contracts/BridgingSettlementContractModule.d.ts +21 -0
  192. package/dist/settlement/contracts/BridgingSettlementContractModule.d.ts.map +1 -0
  193. package/dist/settlement/contracts/BridgingSettlementContractModule.js +81 -0
  194. package/dist/settlement/contracts/BridgingSettlementContractModule.js.map +1 -0
  195. package/dist/settlement/contracts/DispatchContractProtocolModule.d.ts +23 -0
  196. package/dist/settlement/contracts/DispatchContractProtocolModule.d.ts.map +1 -0
  197. package/dist/settlement/contracts/DispatchContractProtocolModule.js +55 -0
  198. package/dist/settlement/contracts/DispatchContractProtocolModule.js.map +1 -0
  199. package/dist/settlement/contracts/DispatchSmartContract.d.ts +50 -0
  200. package/dist/settlement/contracts/DispatchSmartContract.d.ts.map +1 -0
  201. package/dist/settlement/contracts/DispatchSmartContract.js +234 -0
  202. package/dist/settlement/contracts/DispatchSmartContract.js.map +1 -0
  203. package/dist/settlement/contracts/SettlementContractProtocolModule.d.ts +21 -0
  204. package/dist/settlement/contracts/SettlementContractProtocolModule.d.ts.map +1 -0
  205. package/dist/settlement/contracts/SettlementContractProtocolModule.js +84 -0
  206. package/dist/settlement/contracts/SettlementContractProtocolModule.js.map +1 -0
  207. package/dist/settlement/contracts/SettlementSmartContract.d.ts +123 -0
  208. package/dist/settlement/contracts/SettlementSmartContract.d.ts.map +1 -0
  209. package/dist/settlement/contracts/SettlementSmartContract.js +310 -0
  210. package/dist/settlement/contracts/SettlementSmartContract.js.map +1 -0
  211. package/dist/settlement/contracts/SettlementSmartContractModule.d.ts +20 -0
  212. package/dist/settlement/contracts/SettlementSmartContractModule.d.ts.map +1 -0
  213. package/dist/settlement/contracts/SettlementSmartContractModule.js +56 -0
  214. package/dist/settlement/contracts/SettlementSmartContractModule.js.map +1 -0
  215. package/dist/settlement/contracts/TokenBridgeTree.d.ts +228 -0
  216. package/dist/settlement/contracts/TokenBridgeTree.d.ts.map +1 -0
  217. package/dist/settlement/contracts/TokenBridgeTree.js +60 -0
  218. package/dist/settlement/contracts/TokenBridgeTree.js.map +1 -0
  219. package/dist/settlement/contracts/authorizations/ContractAuthorization.d.ts +10 -0
  220. package/dist/settlement/contracts/authorizations/ContractAuthorization.d.ts.map +1 -0
  221. package/dist/settlement/contracts/authorizations/ContractAuthorization.js +2 -0
  222. package/dist/settlement/contracts/authorizations/ContractAuthorization.js.map +1 -0
  223. package/dist/settlement/contracts/authorizations/TokenBridgeDeploymentAuth.d.ts +85 -0
  224. package/dist/settlement/contracts/authorizations/TokenBridgeDeploymentAuth.d.ts.map +1 -0
  225. package/dist/settlement/contracts/authorizations/TokenBridgeDeploymentAuth.js +11 -0
  226. package/dist/settlement/contracts/authorizations/TokenBridgeDeploymentAuth.js.map +1 -0
  227. package/dist/settlement/contracts/authorizations/UpdateMessagesHashAuth.d.ts +79 -0
  228. package/dist/settlement/contracts/authorizations/UpdateMessagesHashAuth.d.ts.map +1 -0
  229. package/dist/settlement/contracts/authorizations/UpdateMessagesHashAuth.js +11 -0
  230. package/dist/settlement/contracts/authorizations/UpdateMessagesHashAuth.js.map +1 -0
  231. package/dist/settlement/contracts/settlement/BridgingSettlementContract.d.ts +107 -0
  232. package/dist/settlement/contracts/settlement/BridgingSettlementContract.d.ts.map +1 -0
  233. package/dist/settlement/contracts/settlement/BridgingSettlementContract.js +188 -0
  234. package/dist/settlement/contracts/settlement/BridgingSettlementContract.js.map +1 -0
  235. package/dist/settlement/contracts/settlement/SettlementBase.d.ts +41 -0
  236. package/dist/settlement/contracts/settlement/SettlementBase.d.ts.map +1 -0
  237. package/dist/settlement/contracts/settlement/SettlementBase.js +105 -0
  238. package/dist/settlement/contracts/settlement/SettlementBase.js.map +1 -0
  239. package/dist/settlement/contracts/settlement/SettlementContract.d.ts +15 -0
  240. package/dist/settlement/contracts/settlement/SettlementContract.d.ts.map +1 -0
  241. package/dist/settlement/contracts/settlement/SettlementContract.js +72 -0
  242. package/dist/settlement/contracts/settlement/SettlementContract.js.map +1 -0
  243. package/dist/settlement/messages/Deposit.d.ts +77 -0
  244. package/dist/settlement/messages/Deposit.d.ts.map +1 -0
  245. package/dist/settlement/messages/Deposit.js +8 -0
  246. package/dist/settlement/messages/Deposit.js.map +1 -0
  247. package/dist/settlement/messages/OutgoingMessage.d.ts +67 -0
  248. package/dist/settlement/messages/OutgoingMessage.d.ts.map +1 -0
  249. package/dist/settlement/messages/OutgoingMessage.js +7 -0
  250. package/dist/settlement/messages/OutgoingMessage.js.map +1 -0
  251. package/dist/settlement/messages/OutgoingMessageArgument.d.ts +494 -0
  252. package/dist/settlement/messages/OutgoingMessageArgument.d.ts.map +1 -0
  253. package/dist/settlement/messages/OutgoingMessageArgument.js +40 -0
  254. package/dist/settlement/messages/OutgoingMessageArgument.js.map +1 -0
  255. package/dist/settlement/messages/Withdrawal.d.ts +2 -0
  256. package/dist/settlement/messages/Withdrawal.d.ts.map +1 -0
  257. package/dist/settlement/messages/Withdrawal.js +3 -0
  258. package/dist/settlement/messages/Withdrawal.js.map +1 -0
  259. package/dist/settlement/modularity/OutgoingMessageProcessor.d.ts +25 -0
  260. package/dist/settlement/modularity/OutgoingMessageProcessor.d.ts.map +1 -0
  261. package/dist/settlement/modularity/OutgoingMessageProcessor.js +30 -0
  262. package/dist/settlement/modularity/OutgoingMessageProcessor.js.map +1 -0
  263. package/dist/settlement/modularity/ProvableSettlementHook.d.ts +26 -0
  264. package/dist/settlement/modularity/ProvableSettlementHook.d.ts.map +1 -0
  265. package/dist/settlement/modularity/ProvableSettlementHook.js +4 -0
  266. package/dist/settlement/modularity/ProvableSettlementHook.js.map +1 -0
  267. package/dist/settlement/modularity/types.d.ts +9 -0
  268. package/dist/settlement/modularity/types.d.ts.map +1 -0
  269. package/dist/settlement/modularity/types.js +2 -0
  270. package/dist/settlement/modularity/types.js.map +1 -0
  271. package/dist/settlement/modules/NetworkStateSettlementModule.d.ts +11 -0
  272. package/dist/settlement/modules/NetworkStateSettlementModule.d.ts.map +1 -0
  273. package/dist/settlement/modules/NetworkStateSettlementModule.js +15 -0
  274. package/dist/settlement/modules/NetworkStateSettlementModule.js.map +1 -0
  275. package/dist/state/SimpleAsyncStateService.d.ts +6 -0
  276. package/dist/state/SimpleAsyncStateService.d.ts.map +1 -0
  277. package/dist/state/SimpleAsyncStateService.js +2 -0
  278. package/dist/state/SimpleAsyncStateService.js.map +1 -0
  279. package/dist/state/State.d.ts +68 -0
  280. package/dist/state/State.d.ts.map +1 -0
  281. package/dist/state/State.js +141 -0
  282. package/dist/state/State.js.map +1 -0
  283. package/dist/state/StateMap.d.ts +37 -0
  284. package/dist/state/StateMap.d.ts.map +1 -0
  285. package/dist/state/StateMap.js +56 -0
  286. package/dist/state/StateMap.js.map +1 -0
  287. package/dist/state/StateService.d.ts +6 -0
  288. package/dist/state/StateService.d.ts.map +1 -0
  289. package/dist/state/StateService.js +2 -0
  290. package/dist/state/StateService.js.map +1 -0
  291. package/dist/state/StateServiceProvider.d.ts +8 -0
  292. package/dist/state/StateServiceProvider.d.ts.map +1 -0
  293. package/dist/state/StateServiceProvider.js +37 -0
  294. package/dist/state/StateServiceProvider.js.map +1 -0
  295. package/dist/state/WitnessBlockContext.d.ts +5 -0
  296. package/dist/state/WitnessBlockContext.d.ts.map +1 -0
  297. package/dist/state/WitnessBlockContext.js +42 -0
  298. package/dist/state/WitnessBlockContext.js.map +1 -0
  299. package/dist/state/assert/assert.d.ts +12 -0
  300. package/dist/state/assert/assert.d.ts.map +1 -0
  301. package/dist/state/assert/assert.js +33 -0
  302. package/dist/state/assert/assert.js.map +1 -0
  303. package/dist/state/context/RuntimeMethodExecutionContext.d.ts +193 -0
  304. package/dist/state/context/RuntimeMethodExecutionContext.d.ts.map +1 -0
  305. package/dist/state/context/RuntimeMethodExecutionContext.js +138 -0
  306. package/dist/state/context/RuntimeMethodExecutionContext.js.map +1 -0
  307. package/dist/state/context/TransitionMethodExecutionContext.d.ts +23 -0
  308. package/dist/state/context/TransitionMethodExecutionContext.d.ts.map +1 -0
  309. package/dist/state/context/TransitionMethodExecutionContext.js +6 -0
  310. package/dist/state/context/TransitionMethodExecutionContext.js.map +1 -0
  311. package/dist/state/protocol/ProtocolState.d.ts +13 -0
  312. package/dist/state/protocol/ProtocolState.d.ts.map +1 -0
  313. package/dist/state/protocol/ProtocolState.js +58 -0
  314. package/dist/state/protocol/ProtocolState.js.map +1 -0
  315. package/dist/utils/FieldOptions.d.ts +62 -0
  316. package/dist/utils/FieldOptions.d.ts.map +1 -0
  317. package/dist/utils/FieldOptions.js +13 -0
  318. package/dist/utils/FieldOptions.js.map +1 -0
  319. package/dist/utils/MinaPrefixedProvableHashList.d.ts +20 -0
  320. package/dist/utils/MinaPrefixedProvableHashList.d.ts.map +1 -0
  321. package/dist/utils/MinaPrefixedProvableHashList.js +49 -0
  322. package/dist/utils/MinaPrefixedProvableHashList.js.map +1 -0
  323. package/dist/utils/PrefixedProvableHashList.d.ts +3 -2
  324. package/dist/utils/PrefixedProvableHashList.d.ts.map +1 -1
  325. package/dist/utils/PrefixedProvableHashList.js +5 -1
  326. package/dist/utils/PrefixedProvableHashList.js.map +1 -0
  327. package/dist/utils/ProvableHashList.d.ts +27 -4
  328. package/dist/utils/ProvableHashList.d.ts.map +1 -1
  329. package/dist/utils/ProvableHashList.js +51 -3
  330. package/dist/utils/ProvableHashList.js.map +1 -0
  331. package/dist/utils/ProvableReductionHashList.d.ts +18 -0
  332. package/dist/utils/ProvableReductionHashList.d.ts.map +1 -0
  333. package/dist/utils/ProvableReductionHashList.js +54 -0
  334. package/dist/utils/ProvableReductionHashList.js.map +1 -0
  335. package/dist/utils/StateTransitionReductionList.d.ts +11 -0
  336. package/dist/utils/StateTransitionReductionList.d.ts.map +1 -0
  337. package/dist/utils/StateTransitionReductionList.js +61 -0
  338. package/dist/utils/StateTransitionReductionList.js.map +1 -0
  339. package/dist/utils/utils.d.ts +11 -5
  340. package/dist/utils/utils.d.ts.map +1 -1
  341. package/dist/utils/utils.js +13 -13
  342. package/dist/utils/utils.js.map +1 -0
  343. package/jest.config.cjs +12 -1
  344. package/package.json +11 -9
  345. package/src/hashing/mina-prefixes.ts +10 -0
  346. package/src/hashing/protokit-prefixes.ts +37 -0
  347. package/src/hooks/AccountStateHook.ts +80 -0
  348. package/src/hooks/BlockHeightHook.ts +17 -0
  349. package/src/hooks/LastStateRootBlockHook.ts +25 -0
  350. package/src/hooks/NoopBlockHook.ts +24 -0
  351. package/src/hooks/NoopSettlementHook.ts +20 -0
  352. package/src/hooks/NoopTransactionHook.ts +13 -0
  353. package/src/index.ts +59 -9
  354. package/src/model/AppliedStateTransitionBatch.ts +16 -0
  355. package/src/model/MethodPublicOutput.ts +3 -1
  356. package/src/model/Option.ts +99 -73
  357. package/src/model/Path.ts +9 -5
  358. package/src/model/RuntimeLike.ts +12 -0
  359. package/src/model/StateTransition.ts +19 -5
  360. package/src/model/StateTransitionProvableBatch.ts +114 -12
  361. package/src/model/Transaction.ts +3 -1
  362. package/src/model/network/NetworkState.ts +22 -2
  363. package/src/model/transaction/AuthorizedTransaction.ts +50 -0
  364. package/src/model/transaction/RuntimeTransaction.ts +86 -15
  365. package/src/model/transaction/ValueOption.ts +28 -0
  366. package/src/protocol/Protocol.ts +201 -69
  367. package/src/protocol/ProtocolEnvironment.ts +10 -0
  368. package/src/protocol/ProtocolModule.ts +16 -15
  369. package/src/protocol/ProvableBlockHook.ts +67 -0
  370. package/src/protocol/ProvableTransactionHook.ts +96 -0
  371. package/src/protocol/TransitioningProtocolModule.ts +12 -0
  372. package/src/prover/accumulators/AppliedBatchHashList.ts +32 -0
  373. package/src/prover/accumulators/BlockHashList.ts +117 -0
  374. package/src/prover/accumulators/StateTransitionReductionList.ts +92 -0
  375. package/src/prover/accumulators/TransactionHashList.ts +9 -0
  376. package/src/prover/accumulators/WitnessedRootHashList.ts +62 -0
  377. package/src/prover/block/BlockProvable.ts +360 -28
  378. package/src/prover/block/BlockProver.ts +721 -186
  379. package/src/prover/block/accummulators/BlockHashMerkleTree.ts +24 -0
  380. package/src/prover/block/accummulators/RuntimeVerificationKeyTree.ts +24 -0
  381. package/src/prover/block/services/RuntimeVerificationKeyRootService.ts +20 -0
  382. package/src/prover/statetransition/StateTransitionProvable.ts +26 -19
  383. package/src/prover/statetransition/StateTransitionProver.ts +337 -126
  384. package/src/prover/transaction/TransactionProvable.ts +183 -0
  385. package/src/prover/transaction/TransactionProver.ts +561 -0
  386. package/src/prover/utils.ts +108 -0
  387. package/src/settlement/ContractArgsRegistry.ts +60 -0
  388. package/src/settlement/ContractModule.ts +31 -0
  389. package/src/settlement/SettlementContractModule.ts +150 -0
  390. package/src/settlement/contracts/BridgeContract.ts +385 -0
  391. package/src/settlement/contracts/BridgeContractProtocolModule.ts +49 -0
  392. package/src/settlement/contracts/BridgingSettlementContractModule.ts +116 -0
  393. package/src/settlement/contracts/DispatchContractProtocolModule.ts +77 -0
  394. package/src/settlement/contracts/DispatchSmartContract.ts +359 -0
  395. package/src/settlement/contracts/SettlementSmartContractModule.ts +79 -0
  396. package/src/settlement/contracts/TokenBridgeTree.ts +73 -0
  397. package/src/settlement/contracts/authorizations/ContractAuthorization.ts +11 -0
  398. package/src/settlement/contracts/authorizations/TokenBridgeDeploymentAuth.ts +16 -0
  399. package/src/settlement/contracts/authorizations/UpdateMessagesHashAuth.ts +16 -0
  400. package/src/settlement/contracts/settlement/BridgingSettlementContract.ts +283 -0
  401. package/src/settlement/contracts/settlement/SettlementBase.ts +249 -0
  402. package/src/settlement/contracts/settlement/SettlementContract.ts +75 -0
  403. package/src/settlement/messages/Deposit.ts +7 -0
  404. package/src/settlement/messages/OutgoingMessage.ts +17 -0
  405. package/src/settlement/messages/OutgoingMessageArgument.ts +53 -0
  406. package/src/settlement/modularity/OutgoingMessageProcessor.ts +65 -0
  407. package/src/settlement/modularity/ProvableSettlementHook.ts +36 -0
  408. package/src/settlement/modularity/types.ts +23 -0
  409. package/src/settlement/modules/NetworkStateSettlementModule.ts +42 -0
  410. package/src/state/State.ts +190 -0
  411. package/src/state/StateMap.ts +73 -0
  412. package/src/state/StateService.ts +6 -0
  413. package/src/state/StateServiceProvider.ts +37 -0
  414. package/src/state/WitnessBlockContext.ts +50 -0
  415. package/src/state/assert/assert.ts +38 -0
  416. package/src/state/context/RuntimeMethodExecutionContext.ts +181 -0
  417. package/src/state/context/TransitionMethodExecutionContext.ts +26 -0
  418. package/src/state/protocol/ProtocolState.ts +98 -0
  419. package/src/utils/FieldOptions.ts +13 -0
  420. package/src/utils/MinaPrefixedProvableHashList.ts +70 -0
  421. package/src/utils/PrefixedProvableHashList.ts +6 -2
  422. package/src/utils/ProvableHashList.ts +109 -4
  423. package/src/utils/ProvableReductionHashList.ts +77 -0
  424. package/src/utils/utils.ts +21 -16
  425. package/test/BlockProver.test.ts +161 -74
  426. package/test/Protocol.test.ts +20 -10
  427. package/test/State.test.ts +45 -0
  428. package/test/StateTransition.test.ts +57 -65
  429. package/test/TestingProtocol.ts +36 -0
  430. package/test/compiling/types.ts +28 -0
  431. package/test/model/Option.test.ts +72 -0
  432. package/test/model/StateTransitionProvableBatch.test.ts +137 -0
  433. package/test/modularity/types.ts +35 -0
  434. package/test/prover/block/BlockProver.test.ts +18 -0
  435. package/test/prover/statetransition/StateTransitionProver.test.ts +261 -0
  436. package/test/state/assert/assert.test.ts +56 -0
  437. package/test/tsconfig.json +7 -0
  438. package/test/utils/ProvableHashList.test.ts +44 -0
  439. package/test/utils/ProvableReductionHashList.test.ts +117 -0
  440. package/test/utils.test.ts +0 -3
  441. package/LICENSE.md +0 -201
  442. package/dist/model/transaction/ProtocolTransaction.d.ts +0 -70
  443. package/dist/model/transaction/ProtocolTransaction.d.ts.map +0 -1
  444. package/dist/model/transaction/ProtocolTransaction.js +0 -18
  445. package/dist/prover/statetransition/StateTransitionWitnessProvider.d.ts +0 -16
  446. package/dist/prover/statetransition/StateTransitionWitnessProvider.d.ts.map +0 -1
  447. package/dist/prover/statetransition/StateTransitionWitnessProviderReference.d.ts +0 -7
  448. package/dist/prover/statetransition/StateTransitionWitnessProviderReference.d.ts.map +0 -1
  449. package/dist/utils/merkletree/InMemoryMerkleTreeStorage.d.ts +0 -25
  450. package/dist/utils/merkletree/InMemoryMerkleTreeStorage.d.ts.map +0 -1
  451. package/dist/utils/merkletree/InMemoryMerkleTreeStorage.js +0 -77
  452. package/dist/utils/merkletree/MerkleTreeStore.d.ts +0 -11
  453. package/dist/utils/merkletree/MerkleTreeStore.d.ts.map +0 -1
  454. package/dist/utils/merkletree/MerkleTreeStore.js +0 -1
  455. package/dist/utils/merkletree/RollupMerkleTree.d.ts +0 -130
  456. package/dist/utils/merkletree/RollupMerkleTree.d.ts.map +0 -1
  457. package/dist/utils/merkletree/RollupMerkleTree.js +0 -244
  458. package/src/model/Option.test.ts +0 -21
  459. package/src/model/transaction/ProtocolTransaction.ts +0 -25
  460. package/src/prover/statetransition/StateTransitionWitnessProvider.ts +0 -24
  461. package/src/prover/statetransition/StateTransitionWitnessProviderReference.ts +0 -17
  462. package/src/utils/merkletree/InMemoryMerkleTreeStorage.ts +0 -106
  463. package/src/utils/merkletree/MerkleTreeStore.ts +0 -15
  464. package/src/utils/merkletree/RollupMerkleTree.ts +0 -255
  465. package/src/utils/merkletree/VirtualMerkleTreeStore.ts +0 -21
  466. package/tsconfig.test.json +0 -9
@@ -1,130 +0,0 @@
1
- import { Bool, Field } from "snarkyjs";
2
- import { MerkleTreeStore } from "./MerkleTreeStore";
3
- export { RollupMerkleTree, RollupMerkleWitness };
4
- export { maybeSwap };
5
- declare const RollupMerkleWitness_base: (new (value: {
6
- path: import("snarkyjs/dist/node/lib/field").Field[];
7
- isLeft: import("snarkyjs/dist/node/lib/bool").Bool[];
8
- }) => {
9
- path: import("snarkyjs/dist/node/lib/field").Field[];
10
- isLeft: import("snarkyjs/dist/node/lib/bool").Bool[];
11
- }) & {
12
- _isStruct: true;
13
- } & import("snarkyjs/dist/node/snarky").ProvablePure<{
14
- path: import("snarkyjs/dist/node/lib/field").Field[];
15
- isLeft: import("snarkyjs/dist/node/lib/bool").Bool[];
16
- }> & {
17
- toInput: (x: {
18
- path: import("snarkyjs/dist/node/lib/field").Field[];
19
- isLeft: import("snarkyjs/dist/node/lib/bool").Bool[];
20
- }) => {
21
- fields?: import("snarkyjs/dist/node/lib/field").Field[] | undefined;
22
- packed?: [import("snarkyjs/dist/node/lib/field").Field, number][] | undefined;
23
- };
24
- toJSON: (x: {
25
- path: import("snarkyjs/dist/node/lib/field").Field[];
26
- isLeft: import("snarkyjs/dist/node/lib/bool").Bool[];
27
- }) => {
28
- path: string[];
29
- isLeft: boolean[];
30
- };
31
- fromJSON: (x: {
32
- path: string[];
33
- isLeft: boolean[];
34
- }) => {
35
- path: import("snarkyjs/dist/node/lib/field").Field[];
36
- isLeft: import("snarkyjs/dist/node/lib/bool").Bool[];
37
- };
38
- };
39
- /**
40
- * The {@link BaseMerkleWitness} class defines a circuit-compatible base class
41
- * for [Merkle Witness'](https://computersciencewiki.org/index.php/Merkle_proof).
42
- */
43
- declare class RollupMerkleWitness extends RollupMerkleWitness_base {
44
- static height: number;
45
- height(): number;
46
- /**
47
- * Calculates a root depending on the leaf value.
48
- * @param leaf Value of the leaf node that belongs to this Witness.
49
- * @returns The calculated root.
50
- */
51
- calculateRoot(hash: Field): Field;
52
- /**
53
- * Calculates the index of the leaf node that belongs to this Witness.
54
- * @returns Index of the leaf.
55
- */
56
- calculateIndex(): Field;
57
- }
58
- /**
59
- * A [Merkle Tree](https://en.wikipedia.org/wiki/Merkle_tree) is a binary tree in
60
- * which every leaf is the cryptography hash of a piece of data,
61
- * and every node is the hash of the concatenation of its two child nodes.
62
- *
63
- * A Merkle Tree allows developers to easily and securely verify
64
- * the integrity of large amounts of data.
65
- *
66
- * Take a look at our [documentation](https://docs.minaprotocol.com/en/zkapps)
67
- * on how to use Merkle Trees in combination with zkApps and
68
- * zero knowledge programming!
69
- *
70
- * Levels are indexed from leaves (level 0) to root (level N - 1).
71
- */
72
- declare class RollupMerkleTree {
73
- static height: number;
74
- static get leafCount(): bigint;
75
- private readonly zeroes;
76
- readonly store: MerkleTreeStore;
77
- constructor(store: MerkleTreeStore);
78
- /**
79
- * Returns a node which lives at a given index and level.
80
- * @param level Level of the node.
81
- * @param index Index of the node.
82
- * @returns The data of the node.
83
- */
84
- getNode(level: number, index: bigint): Field;
85
- /**
86
- * Returns the root of the [Merkle Tree](https://en.wikipedia.org/wiki/Merkle_tree).
87
- * @returns The root of the Merkle Tree.
88
- */
89
- getRoot(): Field;
90
- private setNode;
91
- /**
92
- * TODO: if this is passed an index bigger than the max, it will set a couple
93
- * of out-of-bounds nodes but not affect the real Merkle root. OK?
94
- */
95
- /**
96
- * Sets the value of a leaf node at a given index to a given value.
97
- * @param index Position of the leaf node.
98
- * @param leaf New value.
99
- */
100
- setLeaf(index: bigint, leaf: Field): void;
101
- /**
102
- * Returns the witness (also known as
103
- * [Merkle Proof or Merkle Witness](https://computersciencewiki.org/index.php/Merkle_proof))
104
- * for the leaf at the given index.
105
- * @param index Position of the leaf node.
106
- * @returns The witness that belongs to the leaf.
107
- */
108
- getWitness(index: bigint): RollupMerkleWitness;
109
- /**
110
- * Fills all leaves of the tree.
111
- * @param leaves Values to fill the leaves with.
112
- */
113
- fill(leaves: Field[]): void;
114
- /**
115
- * Returns the amount of leaf nodes.
116
- * @returns Amount of leaf nodes.
117
- */
118
- get leafCount(): bigint;
119
- }
120
- export declare namespace MerkleTreeUtils {
121
- function normalizeKey(key: Field): Field;
122
- function checkMembership(witness: RollupMerkleWitness, root: Field, key: Field, value: Field): Bool;
123
- function computeRoot(witness: RollupMerkleWitness, value: Field): Field;
124
- }
125
- /**
126
- * More efficient version of `maybeSwapBad` which
127
- * reuses an intermediate variable
128
- */
129
- declare function maybeSwap(b: Bool, x: Field, y: Field): [Field, Field];
130
- //# sourceMappingURL=RollupMerkleTree.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"RollupMerkleTree.d.ts","sourceRoot":"","sources":["../../../src/utils/merkletree/RollupMerkleTree.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,KAAK,EAA8B,MAAM,UAAU,CAAC;AAInE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIpD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,CAAC;AAIjD,OAAO,EAAE,SAAS,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAErB;;;GAGG;AACH,cAAM,mBAAoB,SAAQ,wBAGhC;IACA,OAAc,MAAM,SAAO;IAEpB,MAAM,IAAI,MAAM;IAIvB;;;;OAIG;IACI,aAAa,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK;IAaxC;;;OAGG;IACI,cAAc,IAAI,KAAK;CAiB/B;AAED;;;;;;;;;;;;;GAaG;AACH,cAAM,gBAAgB;IACpB,OAAc,MAAM,SAAO;IAE3B,WAAkB,SAAS,IAAI,MAAM,CAEpC;IAED,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAElC,SAAgB,KAAK,EAAE,eAAe,CAAC;gBAEpB,KAAK,EAAE,eAAe;IAYzC;;;;;OAKG;IAEI,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK;IAInD;;;OAGG;IAEI,OAAO,IAAI,KAAK;IAMvB,OAAO,CAAC,OAAO;IAIf;;;OAGG;IAEH;;;;OAIG;IAEI,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK;IAgBzC;;;;;;OAMG;IAEI,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB;IAqBrD;;;OAGG;IAEI,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE;IAM3B;;;OAGG;IACH,IAAW,SAAS,IAAI,MAAM,CAE7B;CACF;AAGD,yBAAiB,eAAe,CAAC;IAC/B,SAAgB,YAAY,CAAC,GAAG,EAAE,KAAK,GAAG,KAAK,CAS9C;IAED,SAAgB,eAAe,CAC7B,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,KAAK,EACX,GAAG,EAAE,KAAK,EACV,KAAK,EAAE,KAAK,GACX,IAAI,CAKN;IAED,SAAgB,WAAW,CACzB,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,KAAK,GACX,KAAK,CAEP;CACF;AAED;;;GAGG;AACH,iBAAS,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAK9D"}
@@ -1,244 +0,0 @@
1
- var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
- var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
- if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
- else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
- return c > 3 && r && Object.defineProperty(target, key, r), r;
6
- };
7
- var __metadata = (this && this.__metadata) || function (k, v) {
8
- if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
- };
10
- /* eslint-disable id-length */
11
- /* eslint-disable line-comment-position */
12
- /* eslint-disable no-inline-comments */
13
- /* eslint-disable @typescript-eslint/no-magic-numbers */
14
- import { Bool, Field, Poseidon, Provable, Struct } from "snarkyjs";
15
- import { notInCircuit } from "../utils";
16
- // external API
17
- // eslint-disable-next-line @typescript-eslint/no-use-before-define
18
- export { RollupMerkleTree, RollupMerkleWitness };
19
- // internal API
20
- // eslint-disable-next-line @typescript-eslint/no-use-before-define
21
- export { maybeSwap };
22
- /**
23
- * The {@link BaseMerkleWitness} class defines a circuit-compatible base class
24
- * for [Merkle Witness'](https://computersciencewiki.org/index.php/Merkle_proof).
25
- */
26
- class RollupMerkleWitness extends Struct({
27
- path: Provable.Array(Field, 256 - 1),
28
- isLeft: Provable.Array(Bool, 256 - 1),
29
- }) {
30
- height() {
31
- return RollupMerkleWitness.height;
32
- }
33
- /**
34
- * Calculates a root depending on the leaf value.
35
- * @param leaf Value of the leaf node that belongs to this Witness.
36
- * @returns The calculated root.
37
- */
38
- calculateRoot(hash) {
39
- const n = this.height();
40
- for (let index = 1; index < n; ++index) {
41
- const isLeft = this.isLeft[index - 1];
42
- // eslint-disable-next-line @typescript-eslint/no-use-before-define
43
- const [left, right] = maybeSwap(isLeft, hash, this.path[index - 1]);
44
- hash = Poseidon.hash([left, right]);
45
- }
46
- return hash;
47
- }
48
- /**
49
- * Calculates the index of the leaf node that belongs to this Witness.
50
- * @returns Index of the leaf.
51
- */
52
- calculateIndex() {
53
- let powerOfTwo = Field(1);
54
- let index = Field(0);
55
- const n = this.height();
56
- // eslint-disable-next-line no-underscore-dangle
57
- for (let index_ = 1; index_ < n; ++index_) {
58
- index = Provable.if(this.isLeft[index_ - 1], index, index.add(powerOfTwo));
59
- powerOfTwo = powerOfTwo.mul(2);
60
- }
61
- return index;
62
- }
63
- }
64
- RollupMerkleWitness.height = 256;
65
- /**
66
- * A [Merkle Tree](https://en.wikipedia.org/wiki/Merkle_tree) is a binary tree in
67
- * which every leaf is the cryptography hash of a piece of data,
68
- * and every node is the hash of the concatenation of its two child nodes.
69
- *
70
- * A Merkle Tree allows developers to easily and securely verify
71
- * the integrity of large amounts of data.
72
- *
73
- * Take a look at our [documentation](https://docs.minaprotocol.com/en/zkapps)
74
- * on how to use Merkle Trees in combination with zkApps and
75
- * zero knowledge programming!
76
- *
77
- * Levels are indexed from leaves (level 0) to root (level N - 1).
78
- */
79
- class RollupMerkleTree {
80
- static get leafCount() {
81
- return 2n ** BigInt(RollupMerkleTree.height - 1);
82
- }
83
- constructor(store) {
84
- this.store = store;
85
- // eslint-disable-next-line @shopify/prefer-class-properties
86
- this.zeroes = [0n];
87
- for (let index = 1; index < RollupMerkleTree.height; index += 1) {
88
- const previousLevel = Field(this.zeroes[index - 1]);
89
- this.zeroes.push(Poseidon.hash([previousLevel, previousLevel]).toBigInt());
90
- }
91
- }
92
- /**
93
- * Returns a node which lives at a given index and level.
94
- * @param level Level of the node.
95
- * @param index Index of the node.
96
- * @returns The data of the node.
97
- */
98
- getNode(level, index) {
99
- return Field(this.store.getNode(index, level) ?? this.zeroes[level]);
100
- }
101
- /**
102
- * Returns the root of the [Merkle Tree](https://en.wikipedia.org/wiki/Merkle_tree).
103
- * @returns The root of the Merkle Tree.
104
- */
105
- getRoot() {
106
- return this.getNode(RollupMerkleTree.height - 1, 0n);
107
- }
108
- // eslint-disable-next-line no-warning-comments
109
- // TODO: this allows to set a node at an index larger than the size. OK?
110
- setNode(level, index, value) {
111
- this.store.setNode(index, level, value.toBigInt());
112
- }
113
- /**
114
- * TODO: if this is passed an index bigger than the max, it will set a couple
115
- * of out-of-bounds nodes but not affect the real Merkle root. OK?
116
- */
117
- /**
118
- * Sets the value of a leaf node at a given index to a given value.
119
- * @param index Position of the leaf node.
120
- * @param leaf New value.
121
- */
122
- setLeaf(index, leaf) {
123
- if (index >= this.leafCount) {
124
- index %= this.leafCount;
125
- }
126
- this.setNode(0, index, leaf);
127
- let currentIndex = index;
128
- for (let level = 1; level < RollupMerkleTree.height; level += 1) {
129
- currentIndex /= 2n;
130
- const left = this.getNode(level - 1, currentIndex * 2n);
131
- const right = this.getNode(level - 1, currentIndex * 2n + 1n);
132
- this.setNode(level, currentIndex, Poseidon.hash([left, right]));
133
- }
134
- }
135
- /**
136
- * Returns the witness (also known as
137
- * [Merkle Proof or Merkle Witness](https://computersciencewiki.org/index.php/Merkle_proof))
138
- * for the leaf at the given index.
139
- * @param index Position of the leaf node.
140
- * @returns The witness that belongs to the leaf.
141
- */
142
- getWitness(index) {
143
- if (index >= this.leafCount) {
144
- index %= this.leafCount;
145
- }
146
- const path = [];
147
- const isLefts = [];
148
- for (let level = 0; level < RollupMerkleTree.height - 1; level += 1) {
149
- const isLeft = index % 2n === 0n;
150
- const sibling = this.getNode(level, isLeft ? index + 1n : index - 1n);
151
- isLefts.push(Bool(isLeft));
152
- path.push(sibling);
153
- index /= 2n;
154
- }
155
- return new RollupMerkleWitness({
156
- isLeft: isLefts,
157
- path,
158
- });
159
- }
160
- // eslint-disable-next-line no-warning-comments, max-len
161
- // TODO: should this take an optional offset? should it fail if the array is too long?
162
- /**
163
- * Fills all leaves of the tree.
164
- * @param leaves Values to fill the leaves with.
165
- */
166
- fill(leaves) {
167
- leaves.forEach((value, index) => {
168
- this.setLeaf(BigInt(index), value);
169
- });
170
- }
171
- /**
172
- * Returns the amount of leaf nodes.
173
- * @returns Amount of leaf nodes.
174
- */
175
- get leafCount() {
176
- return RollupMerkleTree.leafCount;
177
- }
178
- }
179
- RollupMerkleTree.height = 256;
180
- __decorate([
181
- notInCircuit(),
182
- __metadata("design:type", Function),
183
- __metadata("design:paramtypes", [Number, BigInt]),
184
- __metadata("design:returntype", Field)
185
- ], RollupMerkleTree.prototype, "getNode", null);
186
- __decorate([
187
- notInCircuit(),
188
- __metadata("design:type", Function),
189
- __metadata("design:paramtypes", []),
190
- __metadata("design:returntype", Field)
191
- ], RollupMerkleTree.prototype, "getRoot", null);
192
- __decorate([
193
- notInCircuit(),
194
- __metadata("design:type", Function),
195
- __metadata("design:paramtypes", [BigInt, Field]),
196
- __metadata("design:returntype", void 0)
197
- ], RollupMerkleTree.prototype, "setLeaf", null);
198
- __decorate([
199
- notInCircuit(),
200
- __metadata("design:type", Function),
201
- __metadata("design:paramtypes", [BigInt]),
202
- __metadata("design:returntype", RollupMerkleWitness)
203
- ], RollupMerkleTree.prototype, "getWitness", null);
204
- __decorate([
205
- notInCircuit(),
206
- __metadata("design:type", Function),
207
- __metadata("design:paramtypes", [Array]),
208
- __metadata("design:returntype", void 0)
209
- ], RollupMerkleTree.prototype, "fill", null);
210
- // eslint-disable-next-line @typescript-eslint/no-namespace
211
- export var MerkleTreeUtils;
212
- (function (MerkleTreeUtils) {
213
- function normalizeKey(key) {
214
- // if(NJORD_MERKLE_TREE_HEIGHT < 256){
215
- // return fieldMod(key, Field(RollupMerkleTree.leafCount).toConstant())
216
- // eslint-disable-next-line max-len
217
- // // return modPower2(key, RollupMerkleTree.height - 1) //TODO Fix modPower2
218
- // }else{
219
- return key;
220
- // }
221
- }
222
- MerkleTreeUtils.normalizeKey = normalizeKey;
223
- function checkMembership(witness, root, key, value) {
224
- const root2 = witness.calculateRoot(value);
225
- const key2 = witness.calculateIndex();
226
- key.assertEquals(key2, "Keys of MerkleWitness does not match");
227
- return root.equals(root2);
228
- }
229
- MerkleTreeUtils.checkMembership = checkMembership;
230
- function computeRoot(witness, value) {
231
- return witness.calculateRoot(value);
232
- }
233
- MerkleTreeUtils.computeRoot = computeRoot;
234
- })(MerkleTreeUtils || (MerkleTreeUtils = {}));
235
- /**
236
- * More efficient version of `maybeSwapBad` which
237
- * reuses an intermediate variable
238
- */
239
- function maybeSwap(b, x, y) {
240
- const m = b.toField().mul(x.sub(y)); // b*(x - y)
241
- const x1 = y.add(m); // y + b*(x - y)
242
- const y2 = x.sub(m); // x - b*(x - y) = x + b*(y - x)
243
- return [x1, y2];
244
- }
@@ -1,21 +0,0 @@
1
- import { Bool, Field, Poseidon } from "snarkyjs";
2
-
3
- import { Option } from "./Option";
4
-
5
- describe("option", () => {
6
- it.each([
7
- [Bool(true), Field(0), Field, true],
8
- [Bool(false), Field(0), Field, false],
9
- ])(
10
- "should serialize to the correct tree value",
11
- (isSome, value, valueType, shouldHash) => {
12
- expect.assertions(1);
13
-
14
- const option = Option.from(isSome, value, valueType);
15
- // eslint-disable-next-line jest/no-conditional-in-test
16
- const treeValue = shouldHash ? Poseidon.hash(value.toFields()) : Field(0);
17
-
18
- expect(option.treeValue.toString()).toStrictEqual(treeValue.toString());
19
- }
20
- );
21
- });
@@ -1,25 +0,0 @@
1
- import { Bool, Field, PublicKey, Signature, Struct, UInt64 } from "snarkyjs";
2
-
3
- export class ProtocolTransaction extends Struct({
4
- methodId: Field,
5
- nonce: UInt64,
6
- sender: PublicKey,
7
- argsHash: Field,
8
- signature: Signature,
9
- }) {
10
- public static getSignatureData(args: {
11
- methodId: Field;
12
- nonce: UInt64;
13
- argsHash: Field;
14
- }): Field[] {
15
- return [args.methodId, ...args.nonce.toFields(), args.argsHash];
16
- }
17
-
18
- public getSignatureData(): Field[] {
19
- return ProtocolTransaction.getSignatureData(this);
20
- }
21
-
22
- public validateSignature(): Bool {
23
- return this.signature.verify(this.sender, this.getSignatureData());
24
- }
25
- }
@@ -1,24 +0,0 @@
1
- import type { Field } from "snarkyjs";
2
- import { injectable } from "tsyringe";
3
-
4
- import { RollupMerkleWitness } from "../../utils/merkletree/RollupMerkleTree.js";
5
-
6
- /**
7
- * Interface for providing merkle witnesses to the state-transition prover
8
- */
9
- export interface StateTransitionWitnessProvider {
10
- /**
11
- * Provides the merkle witness corresponding to the given key
12
- * @param key Merkle-tree key
13
- */
14
- getWitness: (key: Field) => RollupMerkleWitness;
15
- }
16
-
17
- @injectable()
18
- export class NoOpStateTransitionWitnessProvider
19
- implements StateTransitionWitnessProvider
20
- {
21
- public getWitness(): RollupMerkleWitness {
22
- return new RollupMerkleWitness({ path: [], isLeft: [] });
23
- }
24
- }
@@ -1,17 +0,0 @@
1
- import { injectable, Lifecycle, scoped } from "tsyringe";
2
-
3
- import { StateTransitionWitnessProvider } from "./StateTransitionWitnessProvider";
4
-
5
- @injectable()
6
- @scoped(Lifecycle.ContainerScoped)
7
- export class StateTransitionWitnessProviderReference {
8
- private witnessProvider?: StateTransitionWitnessProvider;
9
-
10
- public setWitnessProvider(provider: StateTransitionWitnessProvider) {
11
- this.witnessProvider = provider;
12
- }
13
-
14
- public getWitnessProvider(): StateTransitionWitnessProvider | undefined {
15
- return this.witnessProvider;
16
- }
17
- }
@@ -1,106 +0,0 @@
1
- /* eslint-disable @typescript-eslint/no-magic-numbers */
2
- import { log } from "@proto-kit/common";
3
-
4
- import { RollupMerkleTree } from "./RollupMerkleTree.js";
5
- import { AsyncMerkleTreeStore, MerkleTreeStore } from "./MerkleTreeStore";
6
-
7
- export class InMemoryMerkleTreeStorage implements MerkleTreeStore {
8
- protected readonly nodes: {
9
- [key: number]: {
10
- [key: string]: bigint;
11
- };
12
- } = {};
13
-
14
- public getNode(key: bigint, level: number): bigint | undefined {
15
- return this.nodes[level]?.[key.toString()];
16
- }
17
-
18
- public setNode(key: bigint, level: number, value: bigint): void {
19
- (this.nodes[level] ??= {})[key.toString()] = value;
20
- }
21
- }
22
-
23
- export class CachedMerkleTreeStore extends InMemoryMerkleTreeStorage {
24
- private writeCache: {
25
- [key: number]: {
26
- [key: string]: bigint;
27
- };
28
- } = {};
29
-
30
- public constructor(private readonly parent: AsyncMerkleTreeStore) {
31
- super();
32
- }
33
-
34
- public setNode(key: bigint, level: number, value: bigint) {
35
- super.setNode(key, level, value);
36
- (this.writeCache[level] ??= {})[key.toString()] = value;
37
- }
38
-
39
- public getWrittenNodes(): {
40
- [key: number]: {
41
- [key: string]: bigint;
42
- };
43
- } {
44
- return this.writeCache;
45
- }
46
-
47
- public resetWrittenNodes() {
48
- this.writeCache = {};
49
- }
50
-
51
- // eslint-disable-next-line sonarjs/cognitive-complexity
52
- public async preloadKey(index: bigint): Promise<void> {
53
- // Algo from RollupMerkleTree.getWitness()
54
- const { leafCount, height } = RollupMerkleTree;
55
-
56
- if (index >= leafCount) {
57
- index %= leafCount;
58
- }
59
-
60
- // eslint-disable-next-line no-warning-comments,max-len
61
- // TODO Not practical at the moment. Improve pattern when implementing DB storage
62
- for (let level = 0; level < height; level++) {
63
- const key = index;
64
-
65
- const isLeft = index % 2n === 0n;
66
- const siblingKey = isLeft ? index + 1n : index - 1n;
67
-
68
- // eslint-disable-next-line no-await-in-loop
69
- const value = await this.parent.getNode(key, level);
70
- // eslint-disable-next-line no-await-in-loop
71
- const sibling = await this.parent.getNode(siblingKey, level);
72
- if (level === 0) {
73
- log.debug(`Preloaded ${key} @ ${level} -> ${value ?? "-"}`);
74
- }
75
- if (value !== undefined) {
76
- this.setNode(key, level, value);
77
- }
78
- if (sibling !== undefined) {
79
- this.setNode(siblingKey, level, sibling);
80
- }
81
- index /= 2n;
82
- }
83
- }
84
-
85
- public async mergeIntoParent(): Promise<void> {
86
- // In case no state got set we can skip this step
87
- if (Object.keys(this.writeCache).length === 0) {
88
- return;
89
- }
90
-
91
- this.parent.openTransaction();
92
- const { height } = RollupMerkleTree;
93
- const nodes = this.getWrittenNodes();
94
-
95
- const promises = Array.from({ length: height }).flatMap((ignored, level) =>
96
- Object.entries(nodes[level]).map(async (entry) => {
97
- await this.parent.setNode(BigInt(entry[0]), level, entry[1]);
98
- })
99
- );
100
-
101
- await Promise.all(promises);
102
-
103
- this.parent.commit();
104
- this.resetWrittenNodes();
105
- }
106
- }
@@ -1,15 +0,0 @@
1
- export interface AsyncMerkleTreeStore {
2
- openTransaction: () => void;
3
-
4
- commit: () => void;
5
-
6
- setNode: (key: bigint, level: number, value: bigint) => Promise<void>;
7
-
8
- getNode: (key: bigint, level: number) => Promise<bigint | undefined>;
9
- }
10
-
11
- export interface MerkleTreeStore {
12
- setNode: (key: bigint, level: number, value: bigint) => void;
13
-
14
- getNode: (key: bigint, level: number) => bigint | undefined;
15
- }