@aztec/stdlib 0.0.1-commit.1142ef1 → 0.0.1-commit.11bf3dd6e

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 (919) hide show
  1. package/dest/abi/abi.d.ts +138 -1
  2. package/dest/abi/abi.d.ts.map +1 -1
  3. package/dest/abi/abi.js +10 -2
  4. package/dest/abi/authorization_selector.d.ts +3 -6
  5. package/dest/abi/authorization_selector.d.ts.map +1 -1
  6. package/dest/abi/buffer.d.ts +14 -4
  7. package/dest/abi/buffer.d.ts.map +1 -1
  8. package/dest/abi/buffer.js +25 -4
  9. package/dest/abi/decoder.d.ts +6 -45
  10. package/dest/abi/decoder.d.ts.map +1 -1
  11. package/dest/abi/decoder.js +17 -70
  12. package/dest/abi/encoder.d.ts +1 -1
  13. package/dest/abi/encoder.d.ts.map +1 -1
  14. package/dest/abi/encoder.js +64 -7
  15. package/dest/abi/event_metadata_definition.d.ts +3 -1
  16. package/dest/abi/event_metadata_definition.d.ts.map +1 -1
  17. package/dest/abi/event_metadata_definition.js +1 -1
  18. package/dest/abi/event_selector.d.ts +3 -6
  19. package/dest/abi/event_selector.d.ts.map +1 -1
  20. package/dest/abi/function_call.d.ts +47 -9
  21. package/dest/abi/function_call.d.ts.map +1 -1
  22. package/dest/abi/function_call.js +20 -3
  23. package/dest/abi/function_selector.d.ts +3 -6
  24. package/dest/abi/function_selector.d.ts.map +1 -1
  25. package/dest/abi/function_selector.js +2 -4
  26. package/dest/abi/function_signature_decoder.d.ts +43 -0
  27. package/dest/abi/function_signature_decoder.d.ts.map +1 -0
  28. package/dest/abi/function_signature_decoder.js +66 -0
  29. package/dest/abi/index.d.ts +2 -1
  30. package/dest/abi/index.d.ts.map +1 -1
  31. package/dest/abi/index.js +1 -0
  32. package/dest/abi/note_selector.d.ts +3 -6
  33. package/dest/abi/note_selector.d.ts.map +1 -1
  34. package/dest/abi/note_selector.js +1 -3
  35. package/dest/abi/selector.d.ts +2 -2
  36. package/dest/abi/selector.d.ts.map +1 -1
  37. package/dest/abi/selector.js +1 -1
  38. package/dest/abi/utils.d.ts +20 -1
  39. package/dest/abi/utils.d.ts.map +1 -1
  40. package/dest/abi/utils.js +22 -0
  41. package/dest/auth_witness/auth_witness.d.ts +2 -1
  42. package/dest/auth_witness/auth_witness.d.ts.map +1 -1
  43. package/dest/auth_witness/auth_witness.js +3 -3
  44. package/dest/avm/avm.d.ts +362 -362
  45. package/dest/avm/avm_accumulated_data.d.ts +30 -3
  46. package/dest/avm/avm_accumulated_data.d.ts.map +1 -1
  47. package/dest/avm/avm_circuit_public_inputs.d.ts +9 -9
  48. package/dest/avm/avm_proving_request.d.ts +465 -465
  49. package/dest/avm/contract_storage_read.d.ts +13 -1
  50. package/dest/avm/contract_storage_read.d.ts.map +1 -1
  51. package/dest/avm/contract_storage_update_request.d.ts +13 -1
  52. package/dest/avm/contract_storage_update_request.d.ts.map +1 -1
  53. package/dest/avm/public_call_stack_item_compressed.d.ts +3 -1
  54. package/dest/avm/public_call_stack_item_compressed.d.ts.map +1 -1
  55. package/dest/avm/public_data_read.d.ts +10 -1
  56. package/dest/avm/public_data_read.d.ts.map +1 -1
  57. package/dest/avm/public_data_update_request.d.ts +10 -1
  58. package/dest/avm/public_data_update_request.d.ts.map +1 -1
  59. package/dest/avm/public_data_write.d.ts +7 -1
  60. package/dest/avm/public_data_write.d.ts.map +1 -1
  61. package/dest/avm/public_inner_call_request.d.ts +4 -1
  62. package/dest/avm/public_inner_call_request.d.ts.map +1 -1
  63. package/dest/avm/revert_code.d.ts +12 -7
  64. package/dest/avm/revert_code.d.ts.map +1 -1
  65. package/dest/avm/revert_code.js +16 -21
  66. package/dest/aztec-address/index.d.ts +3 -6
  67. package/dest/aztec-address/index.d.ts.map +1 -1
  68. package/dest/aztec-address/index.js +2 -4
  69. package/dest/block/block_data.d.ts +52 -0
  70. package/dest/block/block_data.d.ts.map +1 -0
  71. package/dest/block/block_data.js +12 -0
  72. package/dest/block/block_hash.d.ts +20 -15
  73. package/dest/block/block_hash.d.ts.map +1 -1
  74. package/dest/block/block_hash.js +23 -20
  75. package/dest/block/block_parameter.d.ts +4 -3
  76. package/dest/block/block_parameter.d.ts.map +1 -1
  77. package/dest/block/block_parameter.js +2 -0
  78. package/dest/block/body.d.ts +1 -1
  79. package/dest/block/body.d.ts.map +1 -1
  80. package/dest/block/body.js +2 -1
  81. package/dest/block/checkpointed_l2_block.d.ts +20 -137
  82. package/dest/block/checkpointed_l2_block.d.ts.map +1 -1
  83. package/dest/block/checkpointed_l2_block.js +7 -45
  84. package/dest/block/in_block.d.ts +9 -9
  85. package/dest/block/in_block.d.ts.map +1 -1
  86. package/dest/block/in_block.js +5 -5
  87. package/dest/block/index.d.ts +2 -3
  88. package/dest/block/index.d.ts.map +1 -1
  89. package/dest/block/index.js +1 -2
  90. package/dest/block/l2_block.d.ts +64 -59
  91. package/dest/block/l2_block.d.ts.map +1 -1
  92. package/dest/block/l2_block.js +73 -109
  93. package/dest/block/l2_block_info.d.ts +6 -5
  94. package/dest/block/l2_block_info.d.ts.map +1 -1
  95. package/dest/block/l2_block_info.js +6 -5
  96. package/dest/block/l2_block_source.d.ts +174 -44
  97. package/dest/block/l2_block_source.d.ts.map +1 -1
  98. package/dest/block/l2_block_source.js +3 -1
  99. package/dest/block/l2_block_stream/interfaces.d.ts +14 -8
  100. package/dest/block/l2_block_stream/interfaces.d.ts.map +1 -1
  101. package/dest/block/l2_block_stream/l2_block_stream.d.ts +6 -3
  102. package/dest/block/l2_block_stream/l2_block_stream.d.ts.map +1 -1
  103. package/dest/block/l2_block_stream/l2_block_stream.js +47 -34
  104. package/dest/block/l2_block_stream/l2_tips_store_base.d.ts +3 -3
  105. package/dest/block/l2_block_stream/l2_tips_store_base.d.ts.map +1 -1
  106. package/dest/block/l2_block_stream/l2_tips_store_base.js +18 -5
  107. package/dest/block/test/l2_tips_store_test_suite.d.ts +1 -1
  108. package/dest/block/test/l2_tips_store_test_suite.d.ts.map +1 -1
  109. package/dest/block/test/l2_tips_store_test_suite.js +6 -10
  110. package/dest/block/validate_block_result.d.ts +1 -1
  111. package/dest/block/validate_block_result.d.ts.map +1 -1
  112. package/dest/block/validate_block_result.js +5 -4
  113. package/dest/checkpoint/checkpoint.d.ts +50 -19
  114. package/dest/checkpoint/checkpoint.d.ts.map +1 -1
  115. package/dest/checkpoint/checkpoint.js +53 -17
  116. package/dest/checkpoint/checkpoint_data.d.ts +186 -0
  117. package/dest/checkpoint/checkpoint_data.d.ts.map +1 -0
  118. package/dest/checkpoint/checkpoint_data.js +36 -0
  119. package/dest/checkpoint/index.d.ts +3 -1
  120. package/dest/checkpoint/index.d.ts.map +1 -1
  121. package/dest/checkpoint/index.js +2 -0
  122. package/dest/checkpoint/published_checkpoint.d.ts +33 -16
  123. package/dest/checkpoint/published_checkpoint.d.ts.map +1 -1
  124. package/dest/checkpoint/published_checkpoint.js +5 -5
  125. package/dest/checkpoint/validate.d.ts +36 -0
  126. package/dest/checkpoint/validate.d.ts.map +1 -0
  127. package/dest/checkpoint/validate.js +120 -0
  128. package/dest/config/chain-config.d.ts +1 -1
  129. package/dest/config/chain-config.d.ts.map +1 -1
  130. package/dest/config/chain-config.js +7 -1
  131. package/dest/config/index.d.ts +3 -1
  132. package/dest/config/index.d.ts.map +1 -1
  133. package/dest/config/index.js +2 -0
  134. package/dest/config/node-rpc-config.js +1 -1
  135. package/dest/config/pipelining-config.d.ts +19 -0
  136. package/dest/config/pipelining-config.d.ts.map +1 -0
  137. package/dest/config/pipelining-config.js +18 -0
  138. package/dest/config/sequencer-config.d.ts +12 -0
  139. package/dest/config/sequencer-config.d.ts.map +1 -0
  140. package/dest/config/sequencer-config.js +31 -0
  141. package/dest/contract/complete_address.d.ts +4 -1
  142. package/dest/contract/complete_address.d.ts.map +1 -1
  143. package/dest/contract/contract_address.d.ts +3 -3
  144. package/dest/contract/contract_address.js +7 -7
  145. package/dest/contract/contract_class.d.ts +2 -3
  146. package/dest/contract/contract_class.d.ts.map +1 -1
  147. package/dest/contract/contract_class_id.d.ts +3 -3
  148. package/dest/contract/contract_class_id.d.ts.map +1 -1
  149. package/dest/contract/contract_class_id.js +7 -6
  150. package/dest/contract/contract_deployment_data.d.ts +5 -5
  151. package/dest/contract/index.d.ts +1 -5
  152. package/dest/contract/index.d.ts.map +1 -1
  153. package/dest/contract/index.js +0 -4
  154. package/dest/contract/interfaces/contract_class.d.ts +3 -156
  155. package/dest/contract/interfaces/contract_class.d.ts.map +1 -1
  156. package/dest/contract/interfaces/contract_class.js +1 -28
  157. package/dest/contract/interfaces/contract_instance.d.ts +16 -16
  158. package/dest/contract/interfaces/node-info.d.ts +3 -1
  159. package/dest/contract/interfaces/node-info.d.ts.map +1 -1
  160. package/dest/contract/interfaces/node-info.js +2 -1
  161. package/dest/contract/private_function.d.ts +1 -1
  162. package/dest/contract/private_function.d.ts.map +1 -1
  163. package/dest/contract/private_function.js +3 -4
  164. package/dest/database-version/database_version.d.ts +58 -0
  165. package/dest/database-version/database_version.d.ts.map +1 -0
  166. package/dest/database-version/database_version.js +69 -0
  167. package/dest/database-version/version_manager.d.ts +3 -49
  168. package/dest/database-version/version_manager.d.ts.map +1 -1
  169. package/dest/database-version/version_manager.js +1 -66
  170. package/dest/delayed_public_mutable/delayed_public_mutable_values.d.ts +2 -2
  171. package/dest/delayed_public_mutable/delayed_public_mutable_values.d.ts.map +1 -1
  172. package/dest/delayed_public_mutable/delayed_public_mutable_values.js +7 -10
  173. package/dest/deserialization/index.d.ts +11 -0
  174. package/dest/deserialization/index.d.ts.map +1 -0
  175. package/dest/deserialization/index.js +10 -0
  176. package/dest/epoch-helpers/index.d.ts +17 -1
  177. package/dest/epoch-helpers/index.d.ts.map +1 -1
  178. package/dest/epoch-helpers/index.js +23 -3
  179. package/dest/errors/proving_error.d.ts +2 -2
  180. package/dest/errors/proving_error.d.ts.map +1 -1
  181. package/dest/file-store/factory.d.ts +4 -3
  182. package/dest/file-store/factory.d.ts.map +1 -1
  183. package/dest/file-store/factory.js +2 -2
  184. package/dest/file-store/http.d.ts +9 -2
  185. package/dest/file-store/http.d.ts.map +1 -1
  186. package/dest/file-store/http.js +20 -9
  187. package/dest/file-store/index.d.ts +2 -1
  188. package/dest/file-store/index.d.ts.map +1 -1
  189. package/dest/file-store/local.d.ts +3 -3
  190. package/dest/file-store/local.d.ts.map +1 -1
  191. package/dest/file-store/local.js +13 -4
  192. package/dest/file-store/s3.d.ts +1 -1
  193. package/dest/file-store/s3.d.ts.map +1 -1
  194. package/dest/file-store/s3.js +11 -3
  195. package/dest/gas/fee_math.d.ts +49 -0
  196. package/dest/gas/fee_math.d.ts.map +1 -0
  197. package/dest/gas/fee_math.js +80 -0
  198. package/dest/gas/gas_fees.d.ts +1 -1
  199. package/dest/gas/gas_fees.d.ts.map +1 -1
  200. package/dest/gas/gas_fees.js +13 -1
  201. package/dest/gas/gas_settings.d.ts +40 -3
  202. package/dest/gas/gas_settings.d.ts.map +1 -1
  203. package/dest/gas/gas_settings.js +50 -6
  204. package/dest/gas/index.d.ts +2 -1
  205. package/dest/gas/index.d.ts.map +1 -1
  206. package/dest/gas/index.js +1 -0
  207. package/dest/ha-signing/config.d.ts +136 -0
  208. package/dest/ha-signing/config.d.ts.map +1 -0
  209. package/dest/ha-signing/config.js +97 -0
  210. package/dest/ha-signing/index.d.ts +4 -0
  211. package/dest/ha-signing/index.d.ts.map +1 -0
  212. package/dest/ha-signing/index.js +3 -0
  213. package/dest/ha-signing/local_config.d.ts +63 -0
  214. package/dest/ha-signing/local_config.d.ts.map +1 -0
  215. package/dest/ha-signing/local_config.js +24 -0
  216. package/dest/ha-signing/types.d.ts +90 -0
  217. package/dest/ha-signing/types.d.ts.map +1 -0
  218. package/dest/ha-signing/types.js +39 -0
  219. package/dest/hash/hash.d.ts +20 -1
  220. package/dest/hash/hash.d.ts.map +1 -1
  221. package/dest/hash/hash.js +45 -10
  222. package/dest/hash/map_slot.d.ts +1 -1
  223. package/dest/hash/map_slot.d.ts.map +1 -1
  224. package/dest/hash/map_slot.js +4 -3
  225. package/dest/interfaces/allowed_element.d.ts +26 -20
  226. package/dest/interfaces/allowed_element.d.ts.map +1 -1
  227. package/dest/interfaces/allowed_element.js +8 -8
  228. package/dest/interfaces/api_limit.d.ts +2 -1
  229. package/dest/interfaces/api_limit.d.ts.map +1 -1
  230. package/dest/interfaces/api_limit.js +1 -0
  231. package/dest/interfaces/archiver.d.ts +1 -1
  232. package/dest/interfaces/archiver.d.ts.map +1 -1
  233. package/dest/interfaces/archiver.js +28 -17
  234. package/dest/interfaces/aztec-node-admin.d.ts +173 -64
  235. package/dest/interfaces/aztec-node-admin.d.ts.map +1 -1
  236. package/dest/interfaces/aztec-node-admin.js +15 -7
  237. package/dest/interfaces/aztec-node-debug.d.ts +21 -0
  238. package/dest/interfaces/aztec-node-debug.d.ts.map +1 -0
  239. package/dest/interfaces/aztec-node-debug.js +18 -0
  240. package/dest/interfaces/aztec-node.d.ts +85 -73
  241. package/dest/interfaces/aztec-node.d.ts.map +1 -1
  242. package/dest/interfaces/aztec-node.js +17 -18
  243. package/dest/interfaces/block-builder.d.ts +53 -18
  244. package/dest/interfaces/block-builder.d.ts.map +1 -1
  245. package/dest/interfaces/block-builder.js +16 -2
  246. package/dest/interfaces/client.d.ts +2 -1
  247. package/dest/interfaces/client.d.ts.map +1 -1
  248. package/dest/interfaces/client.js +1 -0
  249. package/dest/interfaces/configs.d.ts +81 -36
  250. package/dest/interfaces/configs.d.ts.map +1 -1
  251. package/dest/interfaces/configs.js +10 -3
  252. package/dest/interfaces/get_logs_response.d.ts +16 -9
  253. package/dest/interfaces/get_logs_response.d.ts.map +1 -1
  254. package/dest/interfaces/l2_logs_source.d.ts +16 -5
  255. package/dest/interfaces/l2_logs_source.d.ts.map +1 -1
  256. package/dest/interfaces/merkle_tree_operations.d.ts +13 -22
  257. package/dest/interfaces/merkle_tree_operations.d.ts.map +1 -1
  258. package/dest/interfaces/p2p.d.ts +4 -9
  259. package/dest/interfaces/p2p.d.ts.map +1 -1
  260. package/dest/interfaces/prover-broker.d.ts +16 -1
  261. package/dest/interfaces/prover-broker.d.ts.map +1 -1
  262. package/dest/interfaces/prover-broker.js +4 -1
  263. package/dest/interfaces/prover-client.d.ts +20 -1
  264. package/dest/interfaces/prover-client.d.ts.map +1 -1
  265. package/dest/interfaces/prover-client.js +18 -4
  266. package/dest/interfaces/proving-job.d.ts +50 -50
  267. package/dest/interfaces/slasher.d.ts +9 -10
  268. package/dest/interfaces/slasher.d.ts.map +1 -1
  269. package/dest/interfaces/slasher.js +2 -2
  270. package/dest/interfaces/tx_provider.d.ts +3 -3
  271. package/dest/interfaces/tx_provider.d.ts.map +1 -1
  272. package/dest/interfaces/validator.d.ts +208 -55
  273. package/dest/interfaces/validator.d.ts.map +1 -1
  274. package/dest/interfaces/validator.js +11 -5
  275. package/dest/interfaces/world_state.d.ts +5 -4
  276. package/dest/interfaces/world_state.d.ts.map +1 -1
  277. package/dest/kernel/hints/build_note_hash_read_request_hints.d.ts +3 -3
  278. package/dest/kernel/hints/build_note_hash_read_request_hints.d.ts.map +1 -1
  279. package/dest/kernel/hints/build_note_hash_read_request_hints.js +29 -16
  280. package/dest/kernel/hints/build_nullifier_read_request_hints.d.ts +4 -4
  281. package/dest/kernel/hints/build_nullifier_read_request_hints.d.ts.map +1 -1
  282. package/dest/kernel/hints/build_nullifier_read_request_hints.js +28 -17
  283. package/dest/kernel/hints/build_transient_data_hints.d.ts +5 -2
  284. package/dest/kernel/hints/build_transient_data_hints.d.ts.map +1 -1
  285. package/dest/kernel/hints/build_transient_data_hints.js +9 -3
  286. package/dest/kernel/hints/index.d.ts +2 -2
  287. package/dest/kernel/hints/index.js +2 -2
  288. package/dest/kernel/hints/key_validation_hint.d.ts +2 -1
  289. package/dest/kernel/hints/key_validation_hint.d.ts.map +1 -1
  290. package/dest/kernel/hints/key_validation_request.d.ts +2 -1
  291. package/dest/kernel/hints/key_validation_request.d.ts.map +1 -1
  292. package/dest/kernel/hints/key_validation_request_and_separator.d.ts +24 -0
  293. package/dest/kernel/hints/key_validation_request_and_separator.d.ts.map +1 -0
  294. package/dest/kernel/hints/{key_validation_request_and_generator.js → key_validation_request_and_separator.js} +12 -15
  295. package/dest/kernel/hints/private_kernel_reset_hints.d.ts +13 -1
  296. package/dest/kernel/hints/private_kernel_reset_hints.d.ts.map +1 -1
  297. package/dest/kernel/hints/read_request.d.ts +7 -1
  298. package/dest/kernel/hints/read_request.d.ts.map +1 -1
  299. package/dest/kernel/hints/read_request_hints.d.ts +7 -1
  300. package/dest/kernel/hints/read_request_hints.d.ts.map +1 -1
  301. package/dest/kernel/hints/{scoped_key_validation_request_and_generator.d.ts → scoped_key_validation_request_and_separator.d.ts} +8 -8
  302. package/dest/kernel/hints/{scoped_key_validation_request_and_generator.d.ts.map → scoped_key_validation_request_and_separator.d.ts.map} +1 -1
  303. package/dest/kernel/hints/{scoped_key_validation_request_and_generator.js → scoped_key_validation_request_and_separator.js} +6 -6
  304. package/dest/kernel/private_accumulated_data.d.ts +23 -1
  305. package/dest/kernel/private_accumulated_data.d.ts.map +1 -1
  306. package/dest/kernel/private_call_data.d.ts +25 -1
  307. package/dest/kernel/private_call_data.d.ts.map +1 -1
  308. package/dest/kernel/private_call_request.d.ts +16 -1
  309. package/dest/kernel/private_call_request.d.ts.map +1 -1
  310. package/dest/kernel/private_circuit_public_inputs.d.ts +81 -8
  311. package/dest/kernel/private_circuit_public_inputs.d.ts.map +1 -1
  312. package/dest/kernel/private_circuit_public_inputs.js +16 -16
  313. package/dest/kernel/private_kernel_circuit_public_inputs.d.ts +33 -3
  314. package/dest/kernel/private_kernel_circuit_public_inputs.d.ts.map +1 -1
  315. package/dest/kernel/private_kernel_circuit_public_inputs.js +4 -4
  316. package/dest/kernel/private_kernel_data.d.ts +7 -1
  317. package/dest/kernel/private_kernel_data.d.ts.map +1 -1
  318. package/dest/kernel/private_kernel_init_circuit_private_inputs.d.ts +22 -1
  319. package/dest/kernel/private_kernel_init_circuit_private_inputs.d.ts.map +1 -1
  320. package/dest/kernel/private_kernel_inner_circuit_private_inputs.d.ts +7 -1
  321. package/dest/kernel/private_kernel_inner_circuit_private_inputs.d.ts.map +1 -1
  322. package/dest/kernel/private_kernel_reset_circuit_private_inputs.d.ts +4 -1
  323. package/dest/kernel/private_kernel_reset_circuit_private_inputs.d.ts.map +1 -1
  324. package/dest/kernel/private_kernel_tail_circuit_private_inputs.d.ts +12 -3
  325. package/dest/kernel/private_kernel_tail_circuit_private_inputs.d.ts.map +1 -1
  326. package/dest/kernel/private_kernel_tail_circuit_private_inputs.js +4 -4
  327. package/dest/kernel/private_kernel_tail_circuit_public_inputs.d.ts +26 -3
  328. package/dest/kernel/private_kernel_tail_circuit_public_inputs.d.ts.map +1 -1
  329. package/dest/kernel/private_kernel_tail_circuit_public_inputs.js +11 -7
  330. package/dest/kernel/private_to_avm_accumulated_data.d.ts +2 -2
  331. package/dest/kernel/private_to_public_kernel_circuit_public_inputs.d.ts +3 -3
  332. package/dest/kernel/private_to_public_kernel_circuit_public_inputs.d.ts.map +1 -1
  333. package/dest/kernel/private_to_public_kernel_circuit_public_inputs.js +7 -7
  334. package/dest/kernel/private_to_rollup_accumulated_data.d.ts +17 -1
  335. package/dest/kernel/private_to_rollup_accumulated_data.d.ts.map +1 -1
  336. package/dest/kernel/private_to_rollup_kernel_circuit_public_inputs.d.ts +18 -3
  337. package/dest/kernel/private_to_rollup_kernel_circuit_public_inputs.d.ts.map +1 -1
  338. package/dest/kernel/private_to_rollup_kernel_circuit_public_inputs.js +7 -7
  339. package/dest/kernel/private_validation_requests.d.ts +13 -4
  340. package/dest/kernel/private_validation_requests.d.ts.map +1 -1
  341. package/dest/kernel/private_validation_requests.js +9 -9
  342. package/dest/kernel/public_call_request.d.ts +22 -1
  343. package/dest/kernel/public_call_request.d.ts.map +1 -1
  344. package/dest/kernel/utils/optional_number.d.ts +7 -1
  345. package/dest/kernel/utils/optional_number.d.ts.map +1 -1
  346. package/dest/keys/derivation.d.ts +3 -3
  347. package/dest/keys/derivation.js +15 -15
  348. package/dest/keys/key_types.d.ts +3 -3
  349. package/dest/keys/key_types.d.ts.map +1 -1
  350. package/dest/keys/public_keys.d.ts +5 -1
  351. package/dest/keys/public_keys.d.ts.map +1 -1
  352. package/dest/keys/public_keys.js +2 -2
  353. package/dest/keys/utils.d.ts +1 -1
  354. package/dest/keys/utils.d.ts.map +1 -1
  355. package/dest/keys/utils.js +8 -4
  356. package/dest/kv-store/config.d.ts +17 -0
  357. package/dest/kv-store/config.d.ts.map +1 -0
  358. package/dest/kv-store/config.js +26 -0
  359. package/dest/kv-store/index.d.ts +2 -0
  360. package/dest/kv-store/index.d.ts.map +1 -0
  361. package/dest/kv-store/index.js +1 -0
  362. package/dest/l1-contracts/index.d.ts +2 -2
  363. package/dest/l1-contracts/index.d.ts.map +1 -1
  364. package/dest/l1-contracts/index.js +1 -1
  365. package/dest/logs/debug_log_store.d.ts +30 -0
  366. package/dest/logs/debug_log_store.d.ts.map +1 -0
  367. package/dest/logs/debug_log_store.js +30 -0
  368. package/dest/logs/extended_contract_class_log.d.ts +3 -1
  369. package/dest/logs/extended_contract_class_log.d.ts.map +1 -1
  370. package/dest/logs/extended_directional_app_tagging_secret.d.ts +47 -0
  371. package/dest/logs/extended_directional_app_tagging_secret.d.ts.map +1 -0
  372. package/dest/logs/{directional_app_tagging_secret.js → extended_directional_app_tagging_secret.js} +35 -20
  373. package/dest/logs/extended_public_log.d.ts +17 -9
  374. package/dest/logs/extended_public_log.d.ts.map +1 -1
  375. package/dest/logs/index.d.ts +4 -2
  376. package/dest/logs/index.d.ts.map +1 -1
  377. package/dest/logs/index.js +3 -1
  378. package/dest/logs/log_filter.d.ts +4 -1
  379. package/dest/logs/log_filter.d.ts.map +1 -1
  380. package/dest/logs/log_filter.js +2 -1
  381. package/dest/logs/log_id.d.ts +21 -14
  382. package/dest/logs/log_id.d.ts.map +1 -1
  383. package/dest/logs/log_id.js +19 -17
  384. package/dest/logs/message_context.d.ts +4 -7
  385. package/dest/logs/message_context.d.ts.map +1 -1
  386. package/dest/logs/message_context.js +23 -9
  387. package/dest/logs/pending_tagged_log.d.ts +2 -3
  388. package/dest/logs/pending_tagged_log.d.ts.map +1 -1
  389. package/dest/logs/pending_tagged_log.js +2 -2
  390. package/dest/logs/pre_tag.d.ts +16 -11
  391. package/dest/logs/pre_tag.d.ts.map +1 -1
  392. package/dest/logs/pre_tag.js +2 -2
  393. package/dest/logs/private_log.d.ts +2 -2
  394. package/dest/logs/private_log.d.ts.map +1 -1
  395. package/dest/logs/public_log.d.ts +4 -3
  396. package/dest/logs/public_log.d.ts.map +1 -1
  397. package/dest/logs/public_log.js +2 -1
  398. package/dest/logs/shared_secret_derivation.d.ts +11 -10
  399. package/dest/logs/shared_secret_derivation.d.ts.map +1 -1
  400. package/dest/logs/shared_secret_derivation.js +15 -9
  401. package/dest/logs/siloed_tag.d.ts +12 -9
  402. package/dest/logs/siloed_tag.d.ts.map +1 -1
  403. package/dest/logs/siloed_tag.js +16 -6
  404. package/dest/logs/tag.d.ts +5 -6
  405. package/dest/logs/tag.d.ts.map +1 -1
  406. package/dest/logs/tag.js +5 -1
  407. package/dest/logs/tagging_index_range.d.ts +40 -0
  408. package/dest/logs/tagging_index_range.d.ts.map +1 -0
  409. package/dest/logs/tagging_index_range.js +8 -0
  410. package/dest/logs/tx_scoped_l2_log.d.ts +3 -1
  411. package/dest/logs/tx_scoped_l2_log.d.ts.map +1 -1
  412. package/dest/logs/tx_scoped_l2_log.js +7 -0
  413. package/dest/messaging/inbox_leaf.d.ts +3 -1
  414. package/dest/messaging/inbox_leaf.d.ts.map +1 -1
  415. package/dest/messaging/l1_actor.d.ts +7 -1
  416. package/dest/messaging/l1_actor.d.ts.map +1 -1
  417. package/dest/messaging/l1_to_l2_message.d.ts +8 -2
  418. package/dest/messaging/l1_to_l2_message.d.ts.map +1 -1
  419. package/dest/messaging/l1_to_l2_message.js +11 -13
  420. package/dest/messaging/l1_to_l2_message_source.d.ts +4 -2
  421. package/dest/messaging/l1_to_l2_message_source.d.ts.map +1 -1
  422. package/dest/messaging/l2_actor.d.ts +7 -1
  423. package/dest/messaging/l2_actor.d.ts.map +1 -1
  424. package/dest/messaging/l2_to_l1_membership.d.ts +34 -8
  425. package/dest/messaging/l2_to_l1_membership.d.ts.map +1 -1
  426. package/dest/messaging/l2_to_l1_membership.js +77 -32
  427. package/dest/messaging/out_hash.d.ts +41 -4
  428. package/dest/messaging/out_hash.d.ts.map +1 -1
  429. package/dest/messaging/out_hash.js +52 -26
  430. package/dest/noir/index.d.ts +3 -3
  431. package/dest/noir/index.d.ts.map +1 -1
  432. package/dest/note/index.d.ts +1 -2
  433. package/dest/note/index.d.ts.map +1 -1
  434. package/dest/note/index.js +0 -1
  435. package/dest/note/note_dao.d.ts +36 -5
  436. package/dest/note/note_dao.d.ts.map +1 -1
  437. package/dest/note/note_dao.js +14 -14
  438. package/dest/p2p/attestation_utils.d.ts +11 -1
  439. package/dest/p2p/attestation_utils.d.ts.map +1 -1
  440. package/dest/p2p/attestation_utils.js +45 -0
  441. package/dest/p2p/block_proposal.d.ts +26 -13
  442. package/dest/p2p/block_proposal.d.ts.map +1 -1
  443. package/dest/p2p/block_proposal.js +29 -18
  444. package/dest/p2p/checkpoint_attestation.d.ts +9 -6
  445. package/dest/p2p/checkpoint_attestation.d.ts.map +1 -1
  446. package/dest/p2p/checkpoint_attestation.js +3 -8
  447. package/dest/p2p/checkpoint_proposal.d.ts +38 -20
  448. package/dest/p2p/checkpoint_proposal.d.ts.map +1 -1
  449. package/dest/p2p/checkpoint_proposal.js +46 -49
  450. package/dest/p2p/client_type.d.ts +2 -5
  451. package/dest/p2p/client_type.d.ts.map +1 -1
  452. package/dest/p2p/client_type.js +0 -7
  453. package/dest/p2p/consensus_payload.d.ts +15 -5
  454. package/dest/p2p/consensus_payload.d.ts.map +1 -1
  455. package/dest/p2p/consensus_payload.js +22 -18
  456. package/dest/p2p/constants.d.ts +5 -0
  457. package/dest/p2p/constants.d.ts.map +1 -0
  458. package/dest/p2p/constants.js +3 -0
  459. package/dest/p2p/gossipable.d.ts +4 -4
  460. package/dest/p2p/gossipable.d.ts.map +1 -1
  461. package/dest/p2p/index.d.ts +2 -2
  462. package/dest/p2p/index.d.ts.map +1 -1
  463. package/dest/p2p/index.js +1 -1
  464. package/dest/p2p/message_validator.d.ts +18 -3
  465. package/dest/p2p/message_validator.d.ts.map +1 -1
  466. package/dest/p2p/message_validator.js +2 -1
  467. package/dest/p2p/peer_error.d.ts +3 -1
  468. package/dest/p2p/peer_error.d.ts.map +1 -1
  469. package/dest/p2p/peer_error.js +5 -0
  470. package/dest/p2p/signed_txs.d.ts +3 -1
  471. package/dest/p2p/signed_txs.d.ts.map +1 -1
  472. package/dest/p2p/signed_txs.js +6 -1
  473. package/dest/p2p/topic_type.d.ts +3 -4
  474. package/dest/p2p/topic_type.d.ts.map +1 -1
  475. package/dest/p2p/topic_type.js +7 -23
  476. package/dest/parity/parity_base_private_inputs.d.ts +3 -1
  477. package/dest/parity/parity_base_private_inputs.d.ts.map +1 -1
  478. package/dest/parity/parity_public_inputs.d.ts +4 -1
  479. package/dest/parity/parity_public_inputs.d.ts.map +1 -1
  480. package/dest/parity/parity_root_private_inputs.d.ts +2 -1
  481. package/dest/parity/parity_root_private_inputs.d.ts.map +1 -1
  482. package/dest/proofs/chonk_proof.d.ts +46 -2
  483. package/dest/proofs/chonk_proof.d.ts.map +1 -1
  484. package/dest/proofs/chonk_proof.js +94 -14
  485. package/dest/proofs/proof.d.ts +4 -1
  486. package/dest/proofs/proof.d.ts.map +1 -1
  487. package/dest/proofs/recursive_proof.d.ts +10 -1
  488. package/dest/proofs/recursive_proof.d.ts.map +1 -1
  489. package/dest/rollup/base_rollup_hints.d.ts +34 -1
  490. package/dest/rollup/base_rollup_hints.d.ts.map +1 -1
  491. package/dest/rollup/block_constant_data.d.ts +12 -1
  492. package/dest/rollup/block_constant_data.d.ts.map +1 -1
  493. package/dest/rollup/block_headers_hash.js +1 -1
  494. package/dest/rollup/block_merge_rollup_private_inputs.d.ts +4 -1
  495. package/dest/rollup/block_merge_rollup_private_inputs.d.ts.map +1 -1
  496. package/dest/rollup/block_rollup_public_inputs.d.ts +44 -3
  497. package/dest/rollup/block_rollup_public_inputs.d.ts.map +1 -1
  498. package/dest/rollup/block_rollup_public_inputs.js +2 -2
  499. package/dest/rollup/block_root_rollup_private_inputs.d.ts +64 -1
  500. package/dest/rollup/block_root_rollup_private_inputs.d.ts.map +1 -1
  501. package/dest/rollup/checkpoint_constant_data.d.ts +10 -1
  502. package/dest/rollup/checkpoint_constant_data.d.ts.map +1 -1
  503. package/dest/rollup/checkpoint_header.d.ts +31 -4
  504. package/dest/rollup/checkpoint_header.d.ts.map +1 -1
  505. package/dest/rollup/checkpoint_header.js +23 -7
  506. package/dest/rollup/checkpoint_merge_rollup_private_inputs.d.ts +4 -1
  507. package/dest/rollup/checkpoint_merge_rollup_private_inputs.d.ts.map +1 -1
  508. package/dest/rollup/checkpoint_rollup_public_inputs.d.ts +45 -10
  509. package/dest/rollup/checkpoint_rollup_public_inputs.d.ts.map +1 -1
  510. package/dest/rollup/checkpoint_rollup_public_inputs.js +11 -7
  511. package/dest/rollup/checkpoint_root_rollup_private_inputs.d.ts +44 -3
  512. package/dest/rollup/checkpoint_root_rollup_private_inputs.d.ts.map +1 -1
  513. package/dest/rollup/checkpoint_root_rollup_private_inputs.js +13 -2
  514. package/dest/rollup/epoch_constant_data.d.ts +16 -1
  515. package/dest/rollup/epoch_constant_data.d.ts.map +1 -1
  516. package/dest/rollup/root_rollup_private_inputs.d.ts +6 -1
  517. package/dest/rollup/root_rollup_private_inputs.d.ts.map +1 -1
  518. package/dest/rollup/root_rollup_public_inputs.d.ts +17 -7
  519. package/dest/rollup/root_rollup_public_inputs.d.ts.map +1 -1
  520. package/dest/rollup/root_rollup_public_inputs.js +7 -4
  521. package/dest/rollup/tree_snapshot_diff_hints.d.ts +24 -1
  522. package/dest/rollup/tree_snapshot_diff_hints.d.ts.map +1 -1
  523. package/dest/rollup/tx_merge_rollup_private_inputs.d.ts +4 -1
  524. package/dest/rollup/tx_merge_rollup_private_inputs.d.ts.map +1 -1
  525. package/dest/rollup/tx_rollup_public_inputs.d.ts +29 -1
  526. package/dest/rollup/tx_rollup_public_inputs.d.ts.map +1 -1
  527. package/dest/schemas/schemas.d.ts +1 -1
  528. package/dest/slashing/helpers.d.ts +2 -2
  529. package/dest/slashing/helpers.d.ts.map +1 -1
  530. package/dest/slashing/helpers.js +6 -0
  531. package/dest/slashing/index.d.ts +2 -3
  532. package/dest/slashing/index.d.ts.map +1 -1
  533. package/dest/slashing/index.js +1 -2
  534. package/dest/slashing/serialization.d.ts +2 -6
  535. package/dest/slashing/serialization.d.ts.map +1 -1
  536. package/dest/slashing/serialization.js +0 -60
  537. package/dest/slashing/types.d.ts +10 -92
  538. package/dest/slashing/types.d.ts.map +1 -1
  539. package/dest/slashing/types.js +13 -15
  540. package/dest/slashing/{tally.d.ts → votes.d.ts} +8 -2
  541. package/dest/slashing/votes.d.ts.map +1 -0
  542. package/dest/slashing/{tally.js → votes.js} +35 -3
  543. package/dest/stats/stats.d.ts +1 -3
  544. package/dest/stats/stats.d.ts.map +1 -1
  545. package/dest/tests/factories.d.ts +5 -7
  546. package/dest/tests/factories.d.ts.map +1 -1
  547. package/dest/tests/factories.js +37 -55
  548. package/dest/tests/jest.js +1 -1
  549. package/dest/tests/mocks.d.ts +26 -15
  550. package/dest/tests/mocks.d.ts.map +1 -1
  551. package/dest/tests/mocks.js +85 -62
  552. package/dest/timetable/index.d.ts +87 -0
  553. package/dest/timetable/index.d.ts.map +1 -0
  554. package/dest/timetable/index.js +229 -0
  555. package/dest/trees/append_only_tree_snapshot.d.ts +13 -1
  556. package/dest/trees/append_only_tree_snapshot.d.ts.map +1 -1
  557. package/dest/trees/nullifier_leaf.d.ts +13 -1
  558. package/dest/trees/nullifier_leaf.d.ts.map +1 -1
  559. package/dest/trees/nullifier_membership_witness.d.ts +10 -1
  560. package/dest/trees/nullifier_membership_witness.d.ts.map +1 -1
  561. package/dest/trees/public_data_leaf.d.ts +17 -1
  562. package/dest/trees/public_data_leaf.d.ts.map +1 -1
  563. package/dest/trees/public_data_leaf.js +7 -6
  564. package/dest/trees/public_data_witness.d.ts +11 -1
  565. package/dest/trees/public_data_witness.d.ts.map +1 -1
  566. package/dest/tx/block_header.d.ts +16 -2
  567. package/dest/tx/block_header.d.ts.map +1 -1
  568. package/dest/tx/block_header.js +10 -2
  569. package/dest/tx/call_context.d.ts +13 -1
  570. package/dest/tx/call_context.d.ts.map +1 -1
  571. package/dest/tx/capsule.d.ts +9 -2
  572. package/dest/tx/capsule.d.ts.map +1 -1
  573. package/dest/tx/capsule.js +9 -3
  574. package/dest/tx/execution_payload.d.ts +9 -1
  575. package/dest/tx/execution_payload.d.ts.map +1 -1
  576. package/dest/tx/fee_provider.d.ts +10 -0
  577. package/dest/tx/fee_provider.d.ts.map +1 -0
  578. package/dest/tx/fee_provider.js +1 -0
  579. package/dest/tx/function_data.d.ts +4 -2
  580. package/dest/tx/function_data.d.ts.map +1 -1
  581. package/dest/tx/global_variable_builder.d.ts +3 -4
  582. package/dest/tx/global_variable_builder.d.ts.map +1 -1
  583. package/dest/tx/global_variables.d.ts +12 -4
  584. package/dest/tx/global_variables.d.ts.map +1 -1
  585. package/dest/tx/hashed_values.d.ts +7 -1
  586. package/dest/tx/hashed_values.d.ts.map +1 -1
  587. package/dest/tx/in_tx.d.ts +4 -4
  588. package/dest/tx/index.d.ts +2 -1
  589. package/dest/tx/index.d.ts.map +1 -1
  590. package/dest/tx/index.js +1 -0
  591. package/dest/tx/indexed_tx_effect.d.ts +5 -5
  592. package/dest/tx/indexed_tx_effect.d.ts.map +1 -1
  593. package/dest/tx/indexed_tx_effect.js +2 -2
  594. package/dest/tx/partial_state_reference.d.ts +4 -1
  595. package/dest/tx/partial_state_reference.d.ts.map +1 -1
  596. package/dest/tx/private_execution_result.d.ts +27 -6
  597. package/dest/tx/private_execution_result.d.ts.map +1 -1
  598. package/dest/tx/private_execution_result.js +7 -7
  599. package/dest/tx/private_tx_constant_data.d.ts +16 -1
  600. package/dest/tx/private_tx_constant_data.d.ts.map +1 -1
  601. package/dest/tx/profiling.d.ts +165 -30
  602. package/dest/tx/profiling.d.ts.map +1 -1
  603. package/dest/tx/profiling.js +59 -12
  604. package/dest/tx/protocol_contracts.d.ts +2 -2
  605. package/dest/tx/protocol_contracts.d.ts.map +1 -1
  606. package/dest/tx/protocol_contracts.js +2 -2
  607. package/dest/tx/public_call_request_with_calldata.d.ts +7 -1
  608. package/dest/tx/public_call_request_with_calldata.d.ts.map +1 -1
  609. package/dest/tx/public_simulation_output.d.ts +4 -2
  610. package/dest/tx/public_simulation_output.d.ts.map +1 -1
  611. package/dest/tx/public_simulation_output.js +7 -3
  612. package/dest/tx/simulated_tx.d.ts +116 -5
  613. package/dest/tx/simulated_tx.d.ts.map +1 -1
  614. package/dest/tx/simulated_tx.js +7 -4
  615. package/dest/tx/state_reference.d.ts +3 -1
  616. package/dest/tx/state_reference.d.ts.map +1 -1
  617. package/dest/tx/tx.d.ts +31 -7
  618. package/dest/tx/tx.d.ts.map +1 -1
  619. package/dest/tx/tx.js +24 -9
  620. package/dest/tx/tx_context.d.ts +2 -1
  621. package/dest/tx/tx_context.d.ts.map +1 -1
  622. package/dest/tx/tx_effect.d.ts +32 -6
  623. package/dest/tx/tx_effect.d.ts.map +1 -1
  624. package/dest/tx/tx_effect.js +0 -7
  625. package/dest/tx/tx_execution_request.d.ts +30 -1
  626. package/dest/tx/tx_execution_request.d.ts.map +1 -1
  627. package/dest/tx/tx_hash.d.ts +2 -1
  628. package/dest/tx/tx_hash.d.ts.map +1 -1
  629. package/dest/tx/tx_receipt.d.ts +75 -18
  630. package/dest/tx/tx_receipt.d.ts.map +1 -1
  631. package/dest/tx/tx_receipt.js +64 -29
  632. package/dest/tx/tx_request.d.ts +6 -1
  633. package/dest/tx/tx_request.d.ts.map +1 -1
  634. package/dest/tx/tx_request.js +2 -2
  635. package/dest/tx/validator/empty_validator.d.ts +2 -2
  636. package/dest/tx/validator/empty_validator.d.ts.map +1 -1
  637. package/dest/tx/validator/error_texts.d.ts +11 -2
  638. package/dest/tx/validator/error_texts.d.ts.map +1 -1
  639. package/dest/tx/validator/error_texts.js +13 -1
  640. package/dest/tx/validator/tx_validator.d.ts +2 -2
  641. package/dest/tx/validator/tx_validator.d.ts.map +1 -1
  642. package/dest/types/shared.d.ts +4 -1
  643. package/dest/types/shared.d.ts.map +1 -1
  644. package/dest/update-checker/index.d.ts +3 -2
  645. package/dest/update-checker/index.d.ts.map +1 -1
  646. package/dest/update-checker/index.js +2 -1
  647. package/dest/update-checker/package_version.d.ts +3 -0
  648. package/dest/update-checker/package_version.d.ts.map +1 -0
  649. package/dest/update-checker/package_version.js +24 -0
  650. package/dest/update-checker/version_checker.d.ts +25 -0
  651. package/dest/update-checker/version_checker.d.ts.map +1 -0
  652. package/dest/update-checker/version_checker.js +50 -0
  653. package/dest/validators/errors.d.ts +6 -1
  654. package/dest/validators/errors.d.ts.map +1 -1
  655. package/dest/validators/errors.js +7 -0
  656. package/dest/validators/schemas.d.ts +38 -38
  657. package/dest/validators/schemas.d.ts.map +1 -1
  658. package/dest/validators/schemas.js +4 -3
  659. package/dest/validators/types.d.ts +3 -3
  660. package/dest/validators/types.d.ts.map +1 -1
  661. package/dest/versioning/versioning.d.ts +4 -2
  662. package/dest/versioning/versioning.d.ts.map +1 -1
  663. package/dest/versioning/versioning.js +4 -1
  664. package/dest/vks/verification_key.d.ts +22 -1
  665. package/dest/vks/verification_key.d.ts.map +1 -1
  666. package/dest/vks/vk_data.d.ts +7 -1
  667. package/dest/vks/vk_data.d.ts.map +1 -1
  668. package/dest/world-state/genesis_data.d.ts +11 -0
  669. package/dest/world-state/genesis_data.d.ts.map +1 -0
  670. package/dest/world-state/genesis_data.js +4 -0
  671. package/dest/world-state/index.d.ts +2 -1
  672. package/dest/world-state/index.d.ts.map +1 -1
  673. package/dest/world-state/index.js +1 -0
  674. package/dest/zkpassport/index.d.ts +3 -4
  675. package/dest/zkpassport/index.d.ts.map +1 -1
  676. package/dest/zkpassport/index.js +9 -9
  677. package/package.json +29 -14
  678. package/src/abi/abi.ts +25 -2
  679. package/src/abi/authorization_selector.ts +2 -8
  680. package/src/abi/buffer.ts +25 -4
  681. package/src/abi/decoder.ts +36 -82
  682. package/src/abi/encoder.ts +85 -6
  683. package/src/abi/event_metadata_definition.ts +2 -0
  684. package/src/abi/event_selector.ts +2 -8
  685. package/src/abi/function_call.ts +25 -3
  686. package/src/abi/function_selector.ts +4 -13
  687. package/src/abi/function_signature_decoder.ts +77 -0
  688. package/src/abi/index.ts +1 -0
  689. package/src/abi/note_selector.ts +3 -12
  690. package/src/abi/selector.ts +1 -1
  691. package/src/abi/utils.ts +42 -0
  692. package/src/auth_witness/auth_witness.ts +3 -3
  693. package/src/avm/revert_code.ts +26 -25
  694. package/src/aztec-address/index.ts +4 -10
  695. package/src/block/block_data.ts +25 -0
  696. package/src/block/block_hash.ts +32 -24
  697. package/src/block/block_parameter.ts +4 -2
  698. package/src/block/body.ts +2 -1
  699. package/src/block/checkpointed_l2_block.ts +8 -58
  700. package/src/block/in_block.ts +6 -6
  701. package/src/block/index.ts +1 -2
  702. package/src/block/l2_block.ts +112 -148
  703. package/src/block/l2_block_info.ts +8 -6
  704. package/src/block/l2_block_source.ts +115 -47
  705. package/src/block/l2_block_stream/interfaces.ts +14 -7
  706. package/src/block/l2_block_stream/l2_block_stream.ts +66 -37
  707. package/src/block/l2_block_stream/l2_tips_store_base.ts +27 -15
  708. package/src/block/test/l2_tips_store_test_suite.ts +13 -11
  709. package/src/block/validate_block_result.ts +5 -4
  710. package/src/checkpoint/checkpoint.ts +82 -23
  711. package/src/checkpoint/checkpoint_data.ts +87 -0
  712. package/src/checkpoint/index.ts +2 -0
  713. package/src/checkpoint/published_checkpoint.ts +7 -4
  714. package/src/checkpoint/validate.ts +230 -0
  715. package/src/config/chain-config.ts +7 -1
  716. package/src/config/index.ts +2 -0
  717. package/src/config/node-rpc-config.ts +1 -1
  718. package/src/config/pipelining-config.ts +31 -0
  719. package/src/config/sequencer-config.ts +47 -0
  720. package/src/contract/contract_address.ts +7 -7
  721. package/src/contract/contract_class.ts +3 -3
  722. package/src/contract/contract_class_id.ts +7 -6
  723. package/src/contract/index.ts +0 -4
  724. package/src/contract/interfaces/contract_class.ts +2 -82
  725. package/src/contract/interfaces/node-info.ts +3 -0
  726. package/src/contract/private_function.ts +3 -4
  727. package/src/database-version/database_version.ts +87 -0
  728. package/src/database-version/version_manager.ts +1 -77
  729. package/src/delayed_public_mutable/delayed_public_mutable_values.ts +9 -10
  730. package/src/deserialization/index.ts +21 -0
  731. package/src/epoch-helpers/index.ts +40 -1
  732. package/src/file-store/factory.ts +13 -4
  733. package/src/file-store/http.ts +29 -10
  734. package/src/file-store/index.ts +1 -0
  735. package/src/file-store/local.ts +15 -5
  736. package/src/file-store/s3.ts +12 -3
  737. package/src/gas/README.md +154 -0
  738. package/src/gas/fee_math.ts +120 -0
  739. package/src/gas/gas_fees.ts +15 -1
  740. package/src/gas/gas_settings.ts +65 -12
  741. package/src/gas/index.ts +1 -0
  742. package/src/ha-signing/config.ts +156 -0
  743. package/src/ha-signing/index.ts +29 -0
  744. package/src/ha-signing/local_config.ts +46 -0
  745. package/src/ha-signing/types.ts +126 -0
  746. package/src/hash/hash.ts +48 -10
  747. package/src/hash/map_slot.ts +3 -2
  748. package/src/interfaces/allowed_element.ts +29 -9
  749. package/src/interfaces/api_limit.ts +1 -0
  750. package/src/interfaces/archiver.ts +28 -26
  751. package/src/interfaces/aztec-node-admin.ts +31 -9
  752. package/src/interfaces/aztec-node-debug.ts +40 -0
  753. package/src/interfaces/aztec-node.ts +120 -135
  754. package/src/interfaces/block-builder.ts +93 -29
  755. package/src/interfaces/client.ts +1 -0
  756. package/src/interfaces/configs.ts +37 -11
  757. package/src/interfaces/l2_logs_source.ts +20 -4
  758. package/src/interfaces/merkle_tree_operations.ts +12 -21
  759. package/src/interfaces/p2p.ts +3 -14
  760. package/src/interfaces/prover-broker.ts +22 -0
  761. package/src/interfaces/prover-client.ts +32 -5
  762. package/src/interfaces/slasher.ts +4 -6
  763. package/src/interfaces/tx_provider.ts +2 -2
  764. package/src/interfaces/validator.ts +71 -38
  765. package/src/interfaces/world_state.ts +4 -3
  766. package/src/kernel/hints/build_note_hash_read_request_hints.ts +31 -24
  767. package/src/kernel/hints/build_nullifier_read_request_hints.ts +32 -32
  768. package/src/kernel/hints/build_transient_data_hints.ts +17 -2
  769. package/src/kernel/hints/index.ts +2 -2
  770. package/src/kernel/hints/{key_validation_request_and_generator.ts → key_validation_request_and_separator.ts} +12 -15
  771. package/src/kernel/hints/{scoped_key_validation_request_and_generator.ts → scoped_key_validation_request_and_separator.ts} +10 -10
  772. package/src/kernel/private_circuit_public_inputs.ts +14 -14
  773. package/src/kernel/private_kernel_circuit_public_inputs.ts +2 -2
  774. package/src/kernel/private_kernel_tail_circuit_private_inputs.ts +2 -2
  775. package/src/kernel/private_kernel_tail_circuit_public_inputs.ts +14 -5
  776. package/src/kernel/private_to_public_kernel_circuit_public_inputs.ts +5 -5
  777. package/src/kernel/private_to_rollup_kernel_circuit_public_inputs.ts +5 -5
  778. package/src/kernel/private_validation_requests.ts +8 -8
  779. package/src/keys/derivation.ts +15 -15
  780. package/src/keys/key_types.ts +6 -2
  781. package/src/keys/public_keys.ts +2 -2
  782. package/src/keys/utils.ts +8 -4
  783. package/src/kv-store/config.ts +36 -0
  784. package/src/kv-store/index.ts +1 -0
  785. package/src/l1-contracts/index.ts +1 -1
  786. package/src/logs/debug_log_store.ts +54 -0
  787. package/src/logs/{directional_app_tagging_secret.ts → extended_directional_app_tagging_secret.ts} +41 -22
  788. package/src/logs/index.ts +3 -1
  789. package/src/logs/log_filter.ts +5 -0
  790. package/src/logs/log_id.ts +21 -18
  791. package/src/logs/message_context.ts +17 -7
  792. package/src/logs/pending_tagged_log.ts +1 -3
  793. package/src/logs/pre_tag.ts +5 -5
  794. package/src/logs/public_log.ts +4 -2
  795. package/src/logs/shared_secret_derivation.ts +21 -10
  796. package/src/logs/siloed_tag.ts +23 -13
  797. package/src/logs/tag.ts +9 -9
  798. package/src/logs/tagging_index_range.ts +24 -0
  799. package/src/logs/tx_scoped_l2_log.ts +16 -0
  800. package/src/messaging/l1_to_l2_message.ts +12 -9
  801. package/src/messaging/l1_to_l2_message_source.ts +3 -1
  802. package/src/messaging/l2_to_l1_membership.ts +106 -39
  803. package/src/messaging/out_hash.ts +60 -29
  804. package/src/noir/index.ts +2 -2
  805. package/src/note/index.ts +0 -1
  806. package/src/note/note_dao.ts +17 -15
  807. package/src/p2p/attestation_utils.ts +56 -0
  808. package/src/p2p/block_proposal.ts +48 -23
  809. package/src/p2p/checkpoint_attestation.ts +11 -10
  810. package/src/p2p/checkpoint_proposal.ts +88 -67
  811. package/src/p2p/client_type.ts +0 -6
  812. package/src/p2p/consensus_payload.ts +25 -17
  813. package/src/p2p/constants.ts +6 -0
  814. package/src/p2p/gossipable.ts +4 -4
  815. package/src/p2p/index.ts +1 -1
  816. package/src/p2p/message_validator.ts +14 -2
  817. package/src/p2p/peer_error.ts +7 -0
  818. package/src/p2p/signed_txs.ts +6 -1
  819. package/src/p2p/topic_type.ts +8 -15
  820. package/src/proofs/chonk_proof.ts +100 -10
  821. package/src/rollup/block_headers_hash.ts +1 -1
  822. package/src/rollup/block_rollup_public_inputs.ts +2 -2
  823. package/src/rollup/checkpoint_header.ts +22 -2
  824. package/src/rollup/checkpoint_rollup_public_inputs.ts +16 -10
  825. package/src/rollup/checkpoint_root_rollup_private_inputs.ts +14 -1
  826. package/src/rollup/root_rollup_public_inputs.ts +11 -8
  827. package/src/slashing/helpers.ts +8 -0
  828. package/src/slashing/index.ts +1 -2
  829. package/src/slashing/serialization.ts +1 -81
  830. package/src/slashing/types.ts +17 -35
  831. package/src/slashing/{tally.ts → votes.ts} +41 -2
  832. package/src/stats/stats.ts +0 -2
  833. package/src/tests/factories.ts +37 -77
  834. package/src/tests/jest.ts +1 -1
  835. package/src/tests/mocks.ts +117 -67
  836. package/src/timetable/index.ts +346 -0
  837. package/src/trees/public_data_leaf.ts +11 -5
  838. package/src/tx/block_header.ts +18 -4
  839. package/src/tx/capsule.ts +10 -2
  840. package/src/tx/fee_provider.ts +10 -0
  841. package/src/tx/global_variable_builder.ts +2 -3
  842. package/src/tx/global_variables.ts +3 -3
  843. package/src/tx/index.ts +1 -0
  844. package/src/tx/indexed_tx_effect.ts +2 -2
  845. package/src/tx/private_execution_result.ts +6 -6
  846. package/src/tx/profiling.ts +60 -9
  847. package/src/tx/protocol_contracts.ts +2 -2
  848. package/src/tx/public_simulation_output.ts +4 -0
  849. package/src/tx/simulated_tx.ts +14 -3
  850. package/src/tx/tx.ts +30 -22
  851. package/src/tx/tx_effect.ts +0 -9
  852. package/src/tx/tx_receipt.ts +98 -29
  853. package/src/tx/tx_request.ts +2 -2
  854. package/src/tx/validator/empty_validator.ts +1 -1
  855. package/src/tx/validator/error_texts.ts +16 -1
  856. package/src/tx/validator/tx_validator.ts +1 -1
  857. package/src/update-checker/index.ts +2 -1
  858. package/src/update-checker/package_version.ts +30 -0
  859. package/src/update-checker/version_checker.ts +65 -0
  860. package/src/validators/errors.ts +9 -0
  861. package/src/validators/schemas.ts +8 -1
  862. package/src/validators/types.ts +5 -4
  863. package/src/versioning/versioning.ts +4 -1
  864. package/src/world-state/genesis_data.ts +15 -0
  865. package/src/world-state/index.ts +1 -0
  866. package/src/zkpassport/index.ts +11 -12
  867. package/dest/block/l2_block_code_to_purge.d.ts +0 -11
  868. package/dest/block/l2_block_code_to_purge.d.ts.map +0 -1
  869. package/dest/block/l2_block_code_to_purge.js +0 -55
  870. package/dest/block/l2_block_header.d.ts +0 -94
  871. package/dest/block/l2_block_header.d.ts.map +0 -1
  872. package/dest/block/l2_block_header.js +0 -160
  873. package/dest/block/l2_block_new.d.ts +0 -134
  874. package/dest/block/l2_block_new.d.ts.map +0 -1
  875. package/dest/block/l2_block_new.js +0 -155
  876. package/dest/contract/contract_class_metadata.d.ts +0 -8
  877. package/dest/contract/contract_class_metadata.d.ts.map +0 -1
  878. package/dest/contract/contract_class_metadata.js +0 -1
  879. package/dest/contract/contract_metadata.d.ts +0 -7
  880. package/dest/contract/contract_metadata.d.ts.map +0 -1
  881. package/dest/contract/contract_metadata.js +0 -1
  882. package/dest/contract/private_function_membership_proof.d.ts +0 -32
  883. package/dest/contract/private_function_membership_proof.d.ts.map +0 -1
  884. package/dest/contract/private_function_membership_proof.js +0 -124
  885. package/dest/contract/utility_function_membership_proof.d.ts +0 -27
  886. package/dest/contract/utility_function_membership_proof.d.ts.map +0 -1
  887. package/dest/contract/utility_function_membership_proof.js +0 -87
  888. package/dest/database-version/index.d.ts +0 -2
  889. package/dest/database-version/index.d.ts.map +0 -1
  890. package/dest/database-version/index.js +0 -1
  891. package/dest/kernel/hints/key_validation_request_and_generator.d.ts +0 -25
  892. package/dest/kernel/hints/key_validation_request_and_generator.d.ts.map +0 -1
  893. package/dest/l1-contracts/slash_factory.d.ts +0 -45
  894. package/dest/l1-contracts/slash_factory.d.ts.map +0 -1
  895. package/dest/l1-contracts/slash_factory.js +0 -157
  896. package/dest/logs/directional_app_tagging_secret.d.ts +0 -40
  897. package/dest/logs/directional_app_tagging_secret.d.ts.map +0 -1
  898. package/dest/note/notes_filter.d.ts +0 -27
  899. package/dest/note/notes_filter.d.ts.map +0 -1
  900. package/dest/note/notes_filter.js +0 -11
  901. package/dest/slashing/empire.d.ts +0 -31
  902. package/dest/slashing/empire.d.ts.map +0 -1
  903. package/dest/slashing/empire.js +0 -85
  904. package/dest/slashing/tally.d.ts.map +0 -1
  905. package/dest/update-checker/update-checker.d.ts +0 -49
  906. package/dest/update-checker/update-checker.d.ts.map +0 -1
  907. package/dest/update-checker/update-checker.js +0 -130
  908. package/src/block/l2_block_code_to_purge.ts +0 -80
  909. package/src/block/l2_block_header.ts +0 -255
  910. package/src/block/l2_block_new.ts +0 -211
  911. package/src/contract/contract_class_metadata.ts +0 -8
  912. package/src/contract/contract_metadata.ts +0 -7
  913. package/src/contract/private_function_membership_proof.ts +0 -167
  914. package/src/contract/utility_function_membership_proof.ts +0 -118
  915. package/src/database-version/index.ts +0 -1
  916. package/src/l1-contracts/slash_factory.ts +0 -179
  917. package/src/note/notes_filter.ts +0 -38
  918. package/src/slashing/empire.ts +0 -102
  919. package/src/update-checker/update-checker.ts +0 -166
@@ -1,6 +1,6 @@
1
- import { FIXED_DA_GAS, FIXED_L2_GAS, MAX_ENQUEUED_CALLS_PER_TX, MAX_INCLUDE_BY_TIMESTAMP_DURATION, MAX_NULLIFIERS_PER_TX, MAX_TOTAL_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX } from '@aztec/constants';
1
+ import { MAX_ENQUEUED_CALLS_PER_TX, MAX_NULLIFIERS_PER_TX, MAX_TOTAL_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, MAX_TX_LIFETIME, PRIVATE_TX_L2_GAS_OVERHEAD, PUBLIC_TX_L2_GAS_OVERHEAD, TX_DA_GAS_OVERHEAD } from '@aztec/constants';
2
2
  import { makeTuple } from '@aztec/foundation/array';
3
- import { BlockNumber, SlotNumber } from '@aztec/foundation/branded-types';
3
+ import { BlockNumber, CheckpointNumber, IndexWithinCheckpoint, SlotNumber } from '@aztec/foundation/branded-types';
4
4
  import { Buffer32 } from '@aztec/foundation/buffer';
5
5
  import { padArrayEnd, times } from '@aztec/foundation/collection';
6
6
  import { randomBytes } from '@aztec/foundation/crypto/random';
@@ -12,8 +12,7 @@ import { AvmCircuitPublicInputs } from '../avm/avm_circuit_public_inputs.js';
12
12
  import { PublicDataWrite } from '../avm/public_data_write.js';
13
13
  import { RevertCode } from '../avm/revert_code.js';
14
14
  import { AztecAddress } from '../aztec-address/index.js';
15
- import { CommitteeAttestation, L2BlockNew, PublishedL2Block } from '../block/index.js';
16
- import { L2Block } from '../block/l2_block.js';
15
+ import { CheckpointedL2Block, CommitteeAttestation, L2Block } from '../block/index.js';
17
16
  import { Checkpoint } from '../checkpoint/checkpoint.js';
18
17
  import { L1PublishedData } from '../checkpoint/published_checkpoint.js';
19
18
  import { computeContractAddressFromInstance } from '../contract/contract_address.js';
@@ -37,21 +36,24 @@ import { ConsensusPayload } from '../p2p/consensus_payload.js';
37
36
  import { SignatureDomainSeparator, getHashedSignaturePayloadEthSignedMessage } from '../p2p/signature_utils.js';
38
37
  import { ChonkProof } from '../proofs/chonk_proof.js';
39
38
  import { ProvingRequestType } from '../proofs/proving_request_type.js';
39
+ import { CheckpointHeader } from '../rollup/checkpoint_header.js';
40
40
  import { AppendOnlyTreeSnapshot } from '../trees/append_only_tree_snapshot.js';
41
- import { GlobalVariables, HashedValues, PrivateCallExecutionResult, PrivateExecutionResult, Tx, TxConstantData, makeProcessedTxFromPrivateOnlyTx, makeProcessedTxFromTxWithPublicCalls } from '../tx/index.js';
41
+ import { BlockHeader, GlobalVariables, HashedValues, PrivateCallExecutionResult, PrivateExecutionResult, Tx, TxConstantData, makeProcessedTxFromPrivateOnlyTx, makeProcessedTxFromTxWithPublicCalls } from '../tx/index.js';
42
42
  import { NestedProcessReturnValues, PublicSimulationOutput } from '../tx/public_simulation_output.js';
43
43
  import { TxSimulationResult } from '../tx/simulated_tx.js';
44
44
  import { TxEffect } from '../tx/tx_effect.js';
45
45
  import { TxHash } from '../tx/tx_hash.js';
46
- import { makeAvmCircuitInputs, makeAztecAddress, makeBlockHeader, makeGas, makeGlobalVariables, makeL2BlockHeader, makePrivateToPublicAccumulatedData, makePrivateToRollupAccumulatedData, makeProtocolContracts, makePublicCallRequest, makePublicDataWrite } from './factories.js';
46
+ import { makeAvmCircuitInputs, makeAztecAddress, makeBlockHeader, makeCheckpointHeader, makeGas, makeGlobalVariables, makePrivateToPublicAccumulatedData, makePrivateToRollupAccumulatedData, makeProtocolContracts, makePublicCallRequest, makePublicDataWrite } from './factories.js';
47
47
  export const randomTxHash = ()=>TxHash.random();
48
- export const mockTx = async (seed = 1, { numberOfNonRevertiblePublicCallRequests = MAX_ENQUEUED_CALLS_PER_TX / 2, numberOfRevertiblePublicCallRequests = MAX_ENQUEUED_CALLS_PER_TX / 2, numberOfRevertibleNullifiers = 0, hasPublicTeardownCallRequest = false, publicCalldataSize = 2, feePayer, chonkProof = ChonkProof.random(), maxPriorityFeesPerGas, gasUsed = Gas.empty(), chainId = Fr.ZERO, version = Fr.ZERO, vkTreeRoot = Fr.ZERO, protocolContractsHash = Fr.ZERO } = {})=>{
48
+ export const mockTx = async (seed = 1, { numberOfNonRevertiblePublicCallRequests = MAX_ENQUEUED_CALLS_PER_TX / 2, numberOfRevertiblePublicCallRequests = MAX_ENQUEUED_CALLS_PER_TX / 2, numberOfRevertibleNullifiers = 0, hasPublicTeardownCallRequest = false, publicCalldataSize = 2, feePayer, chonkProof = ChonkProof.random(), gasLimits, maxFeesPerGas = new GasFees(10, 10), maxPriorityFeesPerGas, gasUsed = Gas.empty(), chainId = Fr.ZERO, version = Fr.ZERO, vkTreeRoot = Fr.ZERO, protocolContractsHash = Fr.ZERO, anchorBlockHeader = BlockHeader.empty() } = {})=>{
49
49
  const totalPublicCallRequests = numberOfNonRevertiblePublicCallRequests + numberOfRevertiblePublicCallRequests + (hasPublicTeardownCallRequest ? 1 : 0);
50
50
  const isForPublic = totalPublicCallRequests > 0;
51
51
  const data = PrivateKernelTailCircuitPublicInputs.empty();
52
52
  const firstNullifier = new Nullifier(new Fr(seed + 1), Fr.ZERO, 0);
53
- data.constants.txContext.gasSettings = GasSettings.default({
54
- maxFeesPerGas: new GasFees(10, 10),
53
+ data.constants.anchorBlockHeader = anchorBlockHeader;
54
+ data.constants.txContext.gasSettings = GasSettings.fallback({
55
+ gasLimits,
56
+ maxFeesPerGas,
55
57
  maxPriorityFeesPerGas
56
58
  });
57
59
  data.feePayer = feePayer ?? await AztecAddress.random();
@@ -60,8 +62,8 @@ export const mockTx = async (seed = 1, { numberOfNonRevertiblePublicCallRequests
60
62
  data.constants.txContext.version = version;
61
63
  data.constants.vkTreeRoot = vkTreeRoot;
62
64
  data.constants.protocolContractsHash = protocolContractsHash;
63
- // Set includeByTimestamp to the maximum allowed duration from the current time.
64
- data.includeByTimestamp = BigInt(Math.floor(Date.now() / 1000) + MAX_INCLUDE_BY_TIMESTAMP_DURATION);
65
+ // Set expirationTimestamp to the maximum allowed duration from the current time.
66
+ data.expirationTimestamp = BigInt(Math.floor(Date.now() / 1000) + MAX_TX_LIFETIME);
65
67
  const publicFunctionCalldata = [];
66
68
  if (!isForPublic) {
67
69
  data.forRollup.end.nullifiers[0] = firstNullifier.value;
@@ -99,13 +101,13 @@ export const mockTxForRollup = (seed = 1, opts = {})=>mockTx(seed, {
99
101
  numberOfNonRevertiblePublicCallRequests: 0,
100
102
  numberOfRevertiblePublicCallRequests: 0
101
103
  });
102
- /** Mock a processed tx for testing purposes. */ export async function mockProcessedTx({ seed = 1, anchorBlockHeader, db, chainId = Fr.ZERO, version = Fr.ZERO, gasSettings = GasSettings.default({
104
+ /** Mock a processed tx for testing purposes. */ export async function mockProcessedTx({ seed = 1, anchorBlockHeader, db, chainId = Fr.ZERO, version = Fr.ZERO, gasSettings = GasSettings.fallback({
103
105
  maxFeesPerGas: new GasFees(10, 10)
104
106
  }), vkTreeRoot = Fr.ZERO, protocolContracts = makeProtocolContracts(seed + 0x100), globalVariables = GlobalVariables.empty(), newL1ToL2Snapshot = AppendOnlyTreeSnapshot.empty(), feePayer, feePaymentPublicDataWrite, // The default gasUsed is the tx overhead.
105
- gasUsed = Gas.from({
106
- daGas: FIXED_DA_GAS,
107
- l2Gas: FIXED_L2_GAS
108
- }), privateOnly = false, avmAccumulatedData, ...mockTxOpts } = {}) {
107
+ privateOnly = false, gasUsed = Gas.from({
108
+ daGas: TX_DA_GAS_OVERHEAD,
109
+ l2Gas: privateOnly ? PRIVATE_TX_L2_GAS_OVERHEAD : PUBLIC_TX_L2_GAS_OVERHEAD
110
+ }), avmAccumulatedData, ...mockTxOpts } = {}) {
109
111
  seed *= 0x1000; // Avoid clashing with the previous mock values if seed only increases by 1.
110
112
  anchorBlockHeader ??= db?.getInitialHeader() ?? makeBlockHeader(seed);
111
113
  feePayer ??= makeAztecAddress(seed + 0x100);
@@ -212,20 +214,29 @@ export function mockL1ToL2Messages(numL1ToL2Messages) {
212
214
  length: numL1ToL2Messages
213
215
  }, ()=>Fr.random());
214
216
  }
215
- export async function mockCheckpointAndMessages(checkpointNumber, { startBlockNumber = BlockNumber(1), numBlocks = 1, numTxsPerBlock = 1, numL1ToL2Messages = 1, makeBlockOptions = ()=>({}), previousArchive, ...options } = {}) {
216
- const slotNumber = options.slotNumber ?? SlotNumber(checkpointNumber * 10);
217
+ export async function mockCheckpointAndMessages(checkpointNumber, { startBlockNumber = BlockNumber(1), numBlocks = 1, blocks, numTxsPerBlock = 1, numL1ToL2Messages = 1, makeBlockOptions = ()=>({}), previousArchive, maxEffects, ...options } = {}) {
218
+ const slotNumber = options.slotNumber ?? SlotNumber(Number(checkpointNumber) * 10);
219
+ const globals = GlobalVariables.random({
220
+ slotNumber,
221
+ ...options
222
+ });
217
223
  const blocksAndMessages = [];
218
224
  // Track the previous block's archive to ensure consecutive blocks have consistent archive roots.
219
225
  // The current block's header.lastArchive must equal the previous block's archive.
220
226
  let lastArchive = previousArchive;
221
- for(let i = 0; i < numBlocks; i++){
227
+ // Pass maxEffects via txOptions so it reaches TxEffect.random
228
+ const txOptions = maxEffects !== undefined ? {
229
+ maxEffects
230
+ } : {};
231
+ for(let i = 0; i < (blocks?.length ?? numBlocks); i++){
222
232
  const blockNumber = BlockNumber(startBlockNumber + i);
223
233
  const { block, messages } = {
224
- block: await L2BlockNew.random(blockNumber, {
234
+ block: blocks?.[i] ?? await L2Block.random(blockNumber, {
235
+ ...globals,
225
236
  checkpointNumber,
226
- indexWithinCheckpoint: i,
237
+ indexWithinCheckpoint: IndexWithinCheckpoint(i),
227
238
  txsPerBlock: numTxsPerBlock,
228
- slotNumber,
239
+ txOptions,
229
240
  ...options,
230
241
  ...makeBlockOptions(blockNumber),
231
242
  ...lastArchive ? {
@@ -243,17 +254,17 @@ export async function mockCheckpointAndMessages(checkpointNumber, { startBlockNu
243
254
  }
244
255
  const messages = blocksAndMessages[0].messages;
245
256
  const inHash = computeInHashFromL1ToL2Messages(messages);
257
+ const firstBlockLastArchive = blocksAndMessages[0].block.header.lastArchive;
246
258
  const checkpoint = await Checkpoint.random(checkpointNumber, {
247
259
  numBlocks: 0,
248
- slotNumber,
249
260
  inHash,
250
- ...options
261
+ ...options,
262
+ ...globals,
263
+ lastArchive: firstBlockLastArchive,
264
+ lastArchiveRoot: firstBlockLastArchive.root,
265
+ archive: lastArchive
251
266
  });
252
267
  checkpoint.blocks = blocksAndMessages.map(({ block })=>block);
253
- // Set the checkpoint's archive to match the last block's archive for proper chaining.
254
- // When the archiver reconstructs checkpoints from L1, it uses the checkpoint's archive root
255
- // from the L1 event to set the last block's archive. Without this, the archive chain breaks.
256
- checkpoint.archive = lastArchive;
257
268
  // Return lastArchive so callers can chain it across multiple checkpoints
258
269
  return {
259
270
  checkpoint,
@@ -291,16 +302,17 @@ export const randomDeployedContract = async ()=>{
291
302
  };
292
303
  // eslint-disable-next-line @typescript-eslint/no-unused-vars
293
304
  const makeAndSignConsensusPayload = (domainSeparator, options)=>{
294
- const header = options?.header ?? makeL2BlockHeader(1);
295
- const { signer = Secp256k1Signer.random(), archive = Fr.random() } = options ?? {};
305
+ const header = options?.header ?? makeCheckpointHeader(1);
306
+ const { signer = Secp256k1Signer.random(), archive = Fr.random(), feeAssetPriceModifier = 0n } = options ?? {};
296
307
  const payload = ConsensusPayload.fromFields({
297
- header: header.toCheckpointHeader(),
298
- archive
308
+ header,
309
+ archive,
310
+ feeAssetPriceModifier
299
311
  });
300
312
  const hash = getHashedSignaturePayloadEthSignedMessage(payload, domainSeparator);
301
313
  const signature = signer.sign(hash);
302
314
  return {
303
- blockNumber: header.globalVariables.blockNumber,
315
+ blockNumber: header.slotNumber,
304
316
  payload,
305
317
  signature
306
318
  };
@@ -310,9 +322,8 @@ export const makeAndSignCommitteeAttestationsAndSigners = (attestationsAndSigner
310
322
  return signer.sign(hash);
311
323
  };
312
324
  export const makeBlockProposal = (options)=>{
313
- const l2BlockHeader = options?.blockHeader ?? makeL2BlockHeader(1);
314
- const blockHeader = l2BlockHeader.toBlockHeader();
315
- const indexWithinCheckpoint = options?.indexWithinCheckpoint ?? 0;
325
+ const blockHeader = options?.blockHeader ?? makeBlockHeader(1);
326
+ const indexWithinCheckpoint = options?.indexWithinCheckpoint ?? IndexWithinCheckpoint(0);
316
327
  const inHash = options?.inHash ?? Fr.random();
317
328
  const archiveRoot = options?.archiveRoot ?? Fr.random();
318
329
  const txHashes = options?.txHashes ?? [
@@ -325,36 +336,33 @@ export const makeBlockProposal = (options)=>{
325
336
  ].map(()=>TxHash.random());
326
337
  const txs = options?.txs;
327
338
  const signer = options?.signer ?? Secp256k1Signer.random();
328
- return BlockProposal.createProposalFromSigner(blockHeader, indexWithinCheckpoint, inHash, archiveRoot, txHashes, txs, (payload)=>Promise.resolve(signer.signMessage(payload)));
339
+ return BlockProposal.createProposalFromSigner(blockHeader, CheckpointNumber(1), indexWithinCheckpoint, inHash, archiveRoot, txHashes, txs, (_payload, _context)=>Promise.resolve(signer.signMessage(_payload)));
329
340
  };
330
- export const makeCheckpointProposal = (options)=>{
331
- const l2BlockHeader = options?.lastBlock?.blockHeader ?? makeL2BlockHeader(1);
332
- const checkpointHeader = options?.checkpointHeader ?? l2BlockHeader.toCheckpointHeader();
341
+ export const makeCheckpointProposal = async (options)=>{
342
+ const checkpointHeader = options?.checkpointHeader ?? makeCheckpointHeader(1);
333
343
  const archiveRoot = options?.archiveRoot ?? Fr.random();
344
+ const feeAssetPriceModifier = options?.feeAssetPriceModifier ?? 0n;
334
345
  const signer = options?.signer ?? Secp256k1Signer.random();
335
- // Build lastBlock info if provided
336
- const lastBlockInfo = options?.lastBlock ? {
337
- blockHeader: l2BlockHeader.toBlockHeader(),
338
- indexWithinCheckpoint: options.lastBlock.indexWithinCheckpoint ?? 4,
339
- txHashes: options.lastBlock.txHashes ?? [
340
- 0,
341
- 1,
342
- 2,
343
- 3,
344
- 4,
345
- 5
346
- ].map(()=>TxHash.random()),
347
- txs: options.lastBlock.txs
348
- } : undefined;
349
- return CheckpointProposal.createProposalFromSigner(checkpointHeader, archiveRoot, lastBlockInfo, (payload)=>Promise.resolve(signer.signMessage(payload)));
346
+ // Build a signed block proposal if lastBlock options are provided
347
+ const lastBlockProposal = options?.lastBlock ? await makeBlockProposal({
348
+ blockHeader: options.lastBlock.blockHeader,
349
+ indexWithinCheckpoint: options.lastBlock.indexWithinCheckpoint ?? IndexWithinCheckpoint(4),
350
+ inHash: checkpointHeader.inHash,
351
+ archiveRoot,
352
+ txHashes: options.lastBlock.txHashes,
353
+ txs: options.lastBlock.txs,
354
+ signer
355
+ }) : undefined;
356
+ return CheckpointProposal.createProposalFromSigner(checkpointHeader, archiveRoot, CheckpointNumber(1), feeAssetPriceModifier, lastBlockProposal, (payload)=>Promise.resolve(signer.signMessage(payload)));
350
357
  };
351
358
  /**
352
359
  * Create a checkpoint attestation for testing
353
360
  */ export const makeCheckpointAttestation = (options = {})=>{
354
- const header = options.header ?? makeL2BlockHeader(1).toCheckpointHeader();
361
+ const header = options.header ?? makeCheckpointHeader(1);
355
362
  const archive = options.archive ?? Fr.random();
363
+ const feeAssetPriceModifier = options.feeAssetPriceModifier ?? 0n;
356
364
  const { signer, attesterSigner = signer, proposerSigner = signer } = options;
357
- const payload = new ConsensusPayload(header, archive);
365
+ const payload = new ConsensusPayload(header, archive, feeAssetPriceModifier);
358
366
  // Sign as attester
359
367
  const attestationHash = getHashedSignaturePayloadEthSignedMessage(payload, SignatureDomainSeparator.checkpointAttestation);
360
368
  const attestationSigner = attesterSigner ?? Secp256k1Signer.random();
@@ -362,7 +370,7 @@ export const makeCheckpointProposal = (options)=>{
362
370
  // Sign as proposer - use CheckpointProposal's payload format (serializeToBuffer)
363
371
  // This is different from ConsensusPayload's format (ABI encoding)
364
372
  const proposalSignerToUse = proposerSigner ?? Secp256k1Signer.random();
365
- const tempProposal = new CheckpointProposal(header, archive, Signature.empty());
373
+ const tempProposal = new CheckpointProposal(header, archive, feeAssetPriceModifier, Signature.empty());
366
374
  const proposalHash = getHashedSignaturePayloadEthSignedMessage(tempProposal, SignatureDomainSeparator.checkpointProposal);
367
375
  const proposerSignature = proposalSignerToUse.sign(proposalHash);
368
376
  return new CheckpointAttestation(payload, attestationSignature, proposerSignature);
@@ -370,7 +378,7 @@ export const makeCheckpointProposal = (options)=>{
370
378
  /**
371
379
  * Create a checkpoint attestation from a checkpoint proposal
372
380
  */ export const makeCheckpointAttestationFromProposal = (proposal, attesterSigner)=>{
373
- const payload = new ConsensusPayload(proposal.checkpointHeader, proposal.archive);
381
+ const payload = new ConsensusPayload(proposal.checkpointHeader, proposal.archive, proposal.feeAssetPriceModifier);
374
382
  // Sign as attester
375
383
  const attestationHash = getHashedSignaturePayloadEthSignedMessage(payload, SignatureDomainSeparator.checkpointAttestation);
376
384
  const attestationSigner = attesterSigner ?? Secp256k1Signer.random();
@@ -383,17 +391,26 @@ export const makeCheckpointProposal = (options)=>{
383
391
  */ export const makeCheckpointAttestationFromCheckpoint = (checkpoint, attesterSigner, proposerSigner)=>{
384
392
  const header = checkpoint.header;
385
393
  const archive = checkpoint.archive.root;
394
+ const feeAssetPriceModifier = checkpoint.feeAssetPriceModifier;
386
395
  return makeCheckpointAttestation({
387
396
  header,
388
397
  archive,
398
+ feeAssetPriceModifier,
389
399
  attesterSigner,
390
400
  proposerSigner
391
401
  });
392
402
  };
393
403
  /**
394
404
  * Create a checkpoint attestation from an L2Block
405
+ * Note: This is a compatibility function for tests. L2Block doesn't have a checkpoint header directly.
395
406
  */ export const makeCheckpointAttestationFromBlock = (block, attesterSigner, proposerSigner)=>{
396
- const header = block.header.toCheckpointHeader();
407
+ // For L2Block, we create a minimal checkpoint header for testing purposes
408
+ const header = CheckpointHeader.empty({
409
+ lastArchiveRoot: block.header.lastArchive.root,
410
+ slotNumber: block.slot,
411
+ timestamp: block.timestamp,
412
+ blockHeadersHash: Fr.ZERO
413
+ });
397
414
  const archive = block.archive.root;
398
415
  return makeCheckpointAttestation({
399
416
  header,
@@ -410,11 +427,17 @@ export async function randomPublishedL2Block(l2BlockNumber, opts = {}) {
410
427
  blockHash: Buffer32.random().toString()
411
428
  });
412
429
  const signers = opts.signers ?? times(3, ()=>Secp256k1Signer.random());
430
+ const checkpoint = await Checkpoint.random(CheckpointNumber.fromBlockNumber(BlockNumber(l2BlockNumber)), {
431
+ numBlocks: 0
432
+ });
433
+ checkpoint.blocks = [
434
+ block
435
+ ];
413
436
  const atts = signers.map((signer)=>makeCheckpointAttestation({
414
437
  signer,
415
438
  archive: block.archive.root,
416
- header: block.header.toCheckpointHeader()
439
+ header: checkpoint.header
417
440
  }));
418
441
  const attestations = atts.map((attestation, i)=>new CommitteeAttestation(signers[i].address, attestation.signature));
419
- return new PublishedL2Block(block, l1, attestations);
442
+ return new CheckpointedL2Block(CheckpointNumber.fromBlockNumber(BlockNumber(l2BlockNumber)), block, l1, attestations);
420
443
  }
@@ -0,0 +1,87 @@
1
+ /**
2
+ * Timetable constants used for sequencer timing calculations.
3
+ * These define the time budgets for various phases of block production.
4
+ *
5
+ * The sequencer slot is divided into phases:
6
+ * 1. Checkpoint initialization (sync + proposer check)
7
+ * 2. Block building (execution)
8
+ * 3. Checkpoint assembly
9
+ * 4. P2P propagation for proposal and attestations (round-trip)
10
+ * 5. L1 publishing
11
+ */
12
+ /** Time budget for checkpoint initialization (sync + proposer check) in seconds */
13
+ export declare const CHECKPOINT_INITIALIZATION_TIME = 1;
14
+ /** Time budget for assembling a checkpoint after building the last block in seconds */
15
+ export declare const CHECKPOINT_ASSEMBLE_TIME = 1;
16
+ /** Default one-way P2P propagation time for proposals and attestations in seconds */
17
+ export declare const DEFAULT_P2P_PROPAGATION_TIME = 2;
18
+ /** Default L1 publishing time (matches Ethereum slot duration on mainnet) in seconds */
19
+ export declare const DEFAULT_L1_PUBLISHING_TIME = 12;
20
+ /** Minimum execution time for building a block in seconds */
21
+ export declare const MIN_EXECUTION_TIME = 2;
22
+ export type CheckpointTimingConfig = {
23
+ aztecSlotDuration: number;
24
+ ethereumSlotDuration?: number;
25
+ blockDuration?: number;
26
+ checkpointAssembleTime?: number;
27
+ checkpointInitializationTime?: number;
28
+ l1PublishingTime?: number;
29
+ minExecutionTime?: number;
30
+ p2pPropagationTime?: number;
31
+ pipelining?: boolean;
32
+ };
33
+ export interface CheckpointTiming {
34
+ readonly aztecSlotDuration: number;
35
+ readonly blockDuration: number | undefined;
36
+ readonly checkpointAssembleTime: number;
37
+ readonly checkpointInitializationTime: number;
38
+ readonly l1PublishingTime: number;
39
+ readonly minExecutionTime: number;
40
+ readonly p2pPropagationTime: number;
41
+ readonly checkpointFinalizationTime: number;
42
+ readonly pipeliningAttestationGracePeriod: number;
43
+ readonly timeReservedAtEnd: number;
44
+ readonly minimumBuildSlotWork: number;
45
+ readonly initializeDeadline: number;
46
+ readonly checkpointAssemblyDeadline: number;
47
+ readonly checkpointAttestationStartDeadline: number;
48
+ readonly checkpointAttestationDeadline: number;
49
+ readonly checkpointPublishingDeadline: number;
50
+ calculateMaxBlocksPerSlot(): number;
51
+ }
52
+ export interface PipelinedCheckpointTiming extends CheckpointTiming {
53
+ readonly proposalWindowIntoTargetSlot: number;
54
+ readonly attestationWindowIntoTargetSlot: number;
55
+ }
56
+ /**
57
+ * Creates a checkpoint timing model for the requested scheduling mode.
58
+ *
59
+ * Most callers should use this factory and depend only on the shared
60
+ * `CheckpointTiming` interface. The returned implementation is selected from
61
+ * `opts.pipelining`.
62
+ */
63
+ export declare function createCheckpointTimingModel(opts: CheckpointTimingConfig): CheckpointTiming;
64
+ /**
65
+ * Creates a pipelined checkpoint timing model with target-slot window accessors.
66
+ *
67
+ * Use this when the caller specifically needs the pipelined-only timing surface,
68
+ * such as proposal or attestation acceptance windows into the target slot.
69
+ */
70
+ export declare function createPipelinedCheckpointTimingModel(opts: Omit<CheckpointTimingConfig, 'pipelining'>): PipelinedCheckpointTiming;
71
+ /**
72
+ * Calculates the maximum number of blocks that can be built in a slot.
73
+ * Used by both the sequencer timetable and p2p gossipsub scoring.
74
+ *
75
+ * @param aztecSlotDurationSec - Aztec slot duration in seconds
76
+ * @param blockDurationSec - Duration per block in seconds (undefined = single block mode)
77
+ * @param opts - Optional overrides for timing constants
78
+ * @returns Maximum number of blocks per slot
79
+ */
80
+ export declare function calculateMaxBlocksPerSlot(aztecSlotDurationSec: number, blockDurationSec: number | undefined, opts?: {
81
+ checkpointInitializationTime?: number;
82
+ checkpointAssembleTime?: number;
83
+ p2pPropagationTime?: number;
84
+ l1PublishingTime?: number;
85
+ pipelining?: boolean;
86
+ }): number;
87
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90aW1ldGFibGUvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7Ozs7R0FVRztBQUVILG1GQUFtRjtBQUNuRixlQUFPLE1BQU0sOEJBQThCLElBQUksQ0FBQztBQUVoRCx1RkFBdUY7QUFDdkYsZUFBTyxNQUFNLHdCQUF3QixJQUFJLENBQUM7QUFFMUMscUZBQXFGO0FBQ3JGLGVBQU8sTUFBTSw0QkFBNEIsSUFBSSxDQUFDO0FBRTlDLHdGQUF3RjtBQUN4RixlQUFPLE1BQU0sMEJBQTBCLEtBQUssQ0FBQztBQUU3Qyw2REFBNkQ7QUFDN0QsZUFBTyxNQUFNLGtCQUFrQixJQUFJLENBQUM7QUFFcEMsTUFBTSxNQUFNLHNCQUFzQixHQUFHO0lBQ25DLGlCQUFpQixFQUFFLE1BQU0sQ0FBQztJQUMxQixvQkFBb0IsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUM5QixhQUFhLENBQUMsRUFBRSxNQUFNLENBQUM7SUFDdkIsc0JBQXNCLENBQUMsRUFBRSxNQUFNLENBQUM7SUFDaEMsNEJBQTRCLENBQUMsRUFBRSxNQUFNLENBQUM7SUFDdEMsZ0JBQWdCLENBQUMsRUFBRSxNQUFNLENBQUM7SUFDMUIsZ0JBQWdCLENBQUMsRUFBRSxNQUFNLENBQUM7SUFDMUIsa0JBQWtCLENBQUMsRUFBRSxNQUFNLENBQUM7SUFDNUIsVUFBVSxDQUFDLEVBQUUsT0FBTyxDQUFDO0NBQ3RCLENBQUM7QUFFRixNQUFNLFdBQVcsZ0JBQWdCO0lBQy9CLFFBQVEsQ0FBQyxpQkFBaUIsRUFBRSxNQUFNLENBQUM7SUFDbkMsUUFBUSxDQUFDLGFBQWEsRUFBRSxNQUFNLEdBQUcsU0FBUyxDQUFDO0lBQzNDLFFBQVEsQ0FBQyxzQkFBc0IsRUFBRSxNQUFNLENBQUM7SUFDeEMsUUFBUSxDQUFDLDRCQUE0QixFQUFFLE1BQU0sQ0FBQztJQUM5QyxRQUFRLENBQUMsZ0JBQWdCLEVBQUUsTUFBTSxDQUFDO0lBQ2xDLFFBQVEsQ0FBQyxnQkFBZ0IsRUFBRSxNQUFNLENBQUM7SUFDbEMsUUFBUSxDQUFDLGtCQUFrQixFQUFFLE1BQU0sQ0FBQztJQUNwQyxRQUFRLENBQUMsMEJBQTBCLEVBQUUsTUFBTSxDQUFDO0lBQzVDLFFBQVEsQ0FBQyxnQ0FBZ0MsRUFBRSxNQUFNLENBQUM7SUFDbEQsUUFBUSxDQUFDLGlCQUFpQixFQUFFLE1BQU0sQ0FBQztJQUNuQyxRQUFRLENBQUMsb0JBQW9CLEVBQUUsTUFBTSxDQUFDO0lBQ3RDLFFBQVEsQ0FBQyxrQkFBa0IsRUFBRSxNQUFNLENBQUM7SUFDcEMsUUFBUSxDQUFDLDBCQUEwQixFQUFFLE1BQU0sQ0FBQztJQUM1QyxRQUFRLENBQUMsa0NBQWtDLEVBQUUsTUFBTSxDQUFDO0lBQ3BELFFBQVEsQ0FBQyw2QkFBNkIsRUFBRSxNQUFNLENBQUM7SUFDL0MsUUFBUSxDQUFDLDRCQUE0QixFQUFFLE1BQU0sQ0FBQztJQUU5Qyx5QkFBeUIsSUFBSSxNQUFNLENBQUM7Q0FDckM7QUFFRCxNQUFNLFdBQVcseUJBQTBCLFNBQVEsZ0JBQWdCO0lBQ2pFLFFBQVEsQ0FBQyw0QkFBNEIsRUFBRSxNQUFNLENBQUM7SUFDOUMsUUFBUSxDQUFDLCtCQUErQixFQUFFLE1BQU0sQ0FBQztDQUNsRDtBQThJRDs7Ozs7O0dBTUc7QUFDSCx3QkFBZ0IsMkJBQTJCLENBQUMsSUFBSSxFQUFFLHNCQUFzQixHQUFHLGdCQUFnQixDQVMxRjtBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLG9DQUFvQyxDQUNsRCxJQUFJLEVBQUUsSUFBSSxDQUFDLHNCQUFzQixFQUFFLFlBQVksQ0FBQyxHQUMvQyx5QkFBeUIsQ0FPM0I7QUFFRDs7Ozs7Ozs7R0FRRztBQUNILHdCQUFnQix5QkFBeUIsQ0FDdkMsb0JBQW9CLEVBQUUsTUFBTSxFQUM1QixnQkFBZ0IsRUFBRSxNQUFNLEdBQUcsU0FBUyxFQUNwQyxJQUFJLEdBQUU7SUFDSiw0QkFBNEIsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUN0QyxzQkFBc0IsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUNoQyxrQkFBa0IsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUM1QixnQkFBZ0IsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUMxQixVQUFVLENBQUMsRUFBRSxPQUFPLENBQUM7Q0FDakIsR0FDTCxNQUFNLENBVVIifQ==
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/timetable/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,mFAAmF;AACnF,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAEhD,uFAAuF;AACvF,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,qFAAqF;AACrF,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,wFAAwF;AACxF,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,MAAM,MAAM,sBAAsB,GAAG;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;IAC5C,QAAQ,CAAC,gCAAgC,EAAE,MAAM,CAAC;IAClD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;IAC5C,QAAQ,CAAC,kCAAkC,EAAE,MAAM,CAAC;IACpD,QAAQ,CAAC,6BAA6B,EAAE,MAAM,CAAC;IAC/C,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;IAE9C,yBAAyB,IAAI,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IACjE,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;IAC9C,QAAQ,CAAC,+BAA+B,EAAE,MAAM,CAAC;CAClD;AA8ID;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,sBAAsB,GAAG,gBAAgB,CAS1F;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,IAAI,EAAE,IAAI,CAAC,sBAAsB,EAAE,YAAY,CAAC,GAC/C,yBAAyB,CAO3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,oBAAoB,EAAE,MAAM,EAC5B,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,IAAI,GAAE;IACJ,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;CACjB,GACL,MAAM,CAUR"}
@@ -0,0 +1,229 @@
1
+ /**
2
+ * Timetable constants used for sequencer timing calculations.
3
+ * These define the time budgets for various phases of block production.
4
+ *
5
+ * The sequencer slot is divided into phases:
6
+ * 1. Checkpoint initialization (sync + proposer check)
7
+ * 2. Block building (execution)
8
+ * 3. Checkpoint assembly
9
+ * 4. P2P propagation for proposal and attestations (round-trip)
10
+ * 5. L1 publishing
11
+ */ /** Time budget for checkpoint initialization (sync + proposer check) in seconds */ export const CHECKPOINT_INITIALIZATION_TIME = 1;
12
+ /** Time budget for assembling a checkpoint after building the last block in seconds */ export const CHECKPOINT_ASSEMBLE_TIME = 1;
13
+ /** Default one-way P2P propagation time for proposals and attestations in seconds */ export const DEFAULT_P2P_PROPAGATION_TIME = 2;
14
+ /** Default L1 publishing time (matches Ethereum slot duration on mainnet) in seconds */ export const DEFAULT_L1_PUBLISHING_TIME = 12;
15
+ /** Minimum execution time for building a block in seconds */ export const MIN_EXECUTION_TIME = 2;
16
+ /**
17
+ * Shared base for checkpoint timing implementations.
18
+ *
19
+ * This class owns the common inputs and formulas used by both pipelined and
20
+ * non-pipelined scheduling. Variant-specific deadline math is delegated to the
21
+ * concrete subclasses below.
22
+ */ class BaseCheckpointTiming {
23
+ aztecSlotDuration;
24
+ blockDuration;
25
+ checkpointAssembleTime;
26
+ checkpointInitializationTime;
27
+ l1PublishingTime;
28
+ minExecutionTime;
29
+ p2pPropagationTime;
30
+ constructor(opts){
31
+ this.aztecSlotDuration = opts.aztecSlotDuration;
32
+ this.blockDuration = opts.blockDuration;
33
+ this.checkpointAssembleTime = opts.checkpointAssembleTime ?? CHECKPOINT_ASSEMBLE_TIME;
34
+ this.checkpointInitializationTime = opts.checkpointInitializationTime ?? CHECKPOINT_INITIALIZATION_TIME;
35
+ this.l1PublishingTime = opts.l1PublishingTime ?? DEFAULT_L1_PUBLISHING_TIME;
36
+ this.minExecutionTime = opts.minExecutionTime ?? MIN_EXECUTION_TIME;
37
+ this.p2pPropagationTime = opts.p2pPropagationTime ?? DEFAULT_P2P_PROPAGATION_TIME;
38
+ }
39
+ get checkpointFinalizationTime() {
40
+ // Allow enough time to
41
+ // - build the checkpoint
42
+ // - Round-trip over p2p
43
+ // - Publish to L1
44
+ return this.checkpointAssembleTime + this.p2pPropagationTime * 2 + this.l1PublishingTime;
45
+ }
46
+ get pipeliningAttestationGracePeriod() {
47
+ // Allow enough time to
48
+ // - build the block
49
+ // - pass it back over p2p
50
+ return (this.blockDuration ?? 0) + this.p2pPropagationTime;
51
+ }
52
+ get initializeDeadline() {
53
+ return this.aztecSlotDuration - this.minimumBuildSlotWork;
54
+ }
55
+ get checkpointAttestationStartDeadline() {
56
+ return this.checkpointAssemblyDeadline;
57
+ }
58
+ calculateMaxBlocksPerSlot() {
59
+ if (!this.blockDuration) {
60
+ return 1;
61
+ }
62
+ const timeAvailableForBlocks = this.aztecSlotDuration - this.checkpointInitializationTime - this.timeReservedAtEnd;
63
+ return Math.floor(timeAvailableForBlocks / this.blockDuration);
64
+ }
65
+ }
66
+ /**
67
+ * Checkpoint timing model for the non-pipelined sequencer flow.
68
+ *
69
+ * In this mode, checkpoint assembly, attestation collection, and L1 publishing
70
+ * must all complete within the current Aztec slot.
71
+ */ class StandardCheckpointTimingModel extends BaseCheckpointTiming {
72
+ get timeReservedAtEnd() {
73
+ return (this.blockDuration ?? 0) + this.checkpointFinalizationTime;
74
+ }
75
+ get minimumBuildSlotWork() {
76
+ return this.checkpointInitializationTime + this.minExecutionTime * 2 + this.checkpointFinalizationTime;
77
+ }
78
+ get checkpointAssemblyDeadline() {
79
+ return this.aztecSlotDuration - this.l1PublishingTime - 2 * this.p2pPropagationTime;
80
+ }
81
+ get checkpointAttestationDeadline() {
82
+ return this.aztecSlotDuration - this.l1PublishingTime;
83
+ }
84
+ get checkpointPublishingDeadline() {
85
+ return this.aztecSlotDuration - this.l1PublishingTime;
86
+ }
87
+ }
88
+ /**
89
+ * Checkpoint timing model for proposer pipelining.
90
+ *
91
+ * In this mode, the build work still starts in the current slot, but checkpoint
92
+ * assembly and attestation collection can extend into the target slot. The extra
93
+ * target-slot window getters are intended for consumers such as P2P validators
94
+ * that need to validate pipelined messages against wallclock time.
95
+ */ class PipelinedCheckpointTimingModel extends BaseCheckpointTiming {
96
+ get proposalWindowIntoTargetSlot() {
97
+ // Allow the p2p propagation time to receive a checkpoint proposal from leader
98
+ return this.p2pPropagationTime;
99
+ }
100
+ get attestationWindowIntoTargetSlot() {
101
+ return this.aztecSlotDuration - this.l1PublishingTime;
102
+ }
103
+ get timeReservedAtEnd() {
104
+ return this.checkpointAssembleTime + this.p2pPropagationTime;
105
+ }
106
+ get minimumBuildSlotWork() {
107
+ return this.checkpointInitializationTime + this.minExecutionTime * 2;
108
+ }
109
+ get checkpointAssemblyDeadline() {
110
+ // Allow enough time to
111
+ // - build all blocks
112
+ // - receive attestations
113
+ return this.aztecSlotDuration + this.pipeliningAttestationGracePeriod;
114
+ }
115
+ get checkpointAttestationDeadline() {
116
+ // Allowed to be into the next wallclock slot minus the allocated l1 publishing time
117
+ return this.aztecSlotDuration * 2 - this.l1PublishingTime;
118
+ }
119
+ get checkpointPublishingDeadline() {
120
+ // Allowed to be into the next wallclock slot minus the allocated l1 Publishing time
121
+ return this.aztecSlotDuration * 2 - this.l1PublishingTime;
122
+ }
123
+ }
124
+ /**
125
+ * Creates a checkpoint timing model for the requested scheduling mode.
126
+ *
127
+ * Most callers should use this factory and depend only on the shared
128
+ * `CheckpointTiming` interface. The returned implementation is selected from
129
+ * `opts.pipelining`.
130
+ */ export function createCheckpointTimingModel(opts) {
131
+ validateCheckpointTimingConfig(opts);
132
+ const normalizedOpts = normalizeCheckpointTimingConfig(opts);
133
+ const timing = normalizedOpts.pipelining ? new PipelinedCheckpointTimingModel(normalizedOpts) : new StandardCheckpointTimingModel(normalizedOpts);
134
+ validateCheckpointTimingModel(timing);
135
+ return timing;
136
+ }
137
+ /**
138
+ * Creates a pipelined checkpoint timing model with target-slot window accessors.
139
+ *
140
+ * Use this when the caller specifically needs the pipelined-only timing surface,
141
+ * such as proposal or attestation acceptance windows into the target slot.
142
+ */ export function createPipelinedCheckpointTimingModel(opts) {
143
+ validateCheckpointTimingConfig(opts);
144
+ const normalizedOpts = normalizeCheckpointTimingConfig(opts);
145
+ const timing = new PipelinedCheckpointTimingModel(normalizedOpts);
146
+ validateCheckpointTimingModel(timing);
147
+ return timing;
148
+ }
149
+ /**
150
+ * Calculates the maximum number of blocks that can be built in a slot.
151
+ * Used by both the sequencer timetable and p2p gossipsub scoring.
152
+ *
153
+ * @param aztecSlotDurationSec - Aztec slot duration in seconds
154
+ * @param blockDurationSec - Duration per block in seconds (undefined = single block mode)
155
+ * @param opts - Optional overrides for timing constants
156
+ * @returns Maximum number of blocks per slot
157
+ */ export function calculateMaxBlocksPerSlot(aztecSlotDurationSec, blockDurationSec, opts = {}) {
158
+ return createCheckpointTimingModel({
159
+ aztecSlotDuration: aztecSlotDurationSec,
160
+ blockDuration: blockDurationSec,
161
+ checkpointAssembleTime: opts.checkpointAssembleTime,
162
+ checkpointInitializationTime: opts.checkpointInitializationTime,
163
+ l1PublishingTime: opts.l1PublishingTime,
164
+ p2pPropagationTime: opts.p2pPropagationTime,
165
+ pipelining: opts.pipelining
166
+ }).calculateMaxBlocksPerSlot();
167
+ }
168
+ function assertNonNegative(name, value) {
169
+ if (value < 0) {
170
+ throw new Error(`${name} must be non-negative (got ${value})`);
171
+ }
172
+ }
173
+ function validateCheckpointTimingConfig(opts) {
174
+ if (opts.aztecSlotDuration <= 0) {
175
+ throw new Error(`aztecSlotDuration must be positive (got ${opts.aztecSlotDuration})`);
176
+ }
177
+ if (opts.ethereumSlotDuration !== undefined && opts.ethereumSlotDuration <= 0) {
178
+ throw new Error(`ethereumSlotDuration must be positive when provided (got ${opts.ethereumSlotDuration})`);
179
+ }
180
+ if (opts.blockDuration !== undefined && opts.blockDuration <= 0) {
181
+ throw new Error(`blockDuration must be positive when provided (got ${opts.blockDuration})`);
182
+ }
183
+ if (opts.minExecutionTime !== undefined && opts.minExecutionTime <= 0) {
184
+ throw new Error(`minExecutionTime must be positive when provided (got ${opts.minExecutionTime})`);
185
+ }
186
+ if (opts.checkpointAssembleTime !== undefined) {
187
+ assertNonNegative('checkpointAssembleTime', opts.checkpointAssembleTime);
188
+ }
189
+ if (opts.checkpointInitializationTime !== undefined) {
190
+ assertNonNegative('checkpointInitializationTime', opts.checkpointInitializationTime);
191
+ }
192
+ if (opts.l1PublishingTime !== undefined) {
193
+ assertNonNegative('l1PublishingTime', opts.l1PublishingTime);
194
+ }
195
+ if (opts.p2pPropagationTime !== undefined) {
196
+ assertNonNegative('p2pPropagationTime', opts.p2pPropagationTime);
197
+ }
198
+ }
199
+ function normalizeCheckpointTimingConfig(opts) {
200
+ let checkpointAssembleTime = opts.checkpointAssembleTime ?? CHECKPOINT_ASSEMBLE_TIME;
201
+ let checkpointInitializationTime = opts.checkpointInitializationTime ?? CHECKPOINT_INITIALIZATION_TIME;
202
+ let minExecutionTime = opts.minExecutionTime ?? MIN_EXECUTION_TIME;
203
+ let p2pPropagationTime = opts.p2pPropagationTime ?? DEFAULT_P2P_PROPAGATION_TIME;
204
+ if (opts.ethereumSlotDuration !== undefined && opts.ethereumSlotDuration < 8) {
205
+ p2pPropagationTime = 0;
206
+ checkpointAssembleTime = 0.5;
207
+ checkpointInitializationTime = 0.5;
208
+ minExecutionTime = 1;
209
+ }
210
+ if (opts.blockDuration !== undefined && minExecutionTime > opts.blockDuration) {
211
+ minExecutionTime = opts.blockDuration;
212
+ }
213
+ return {
214
+ ...opts,
215
+ checkpointAssembleTime,
216
+ checkpointInitializationTime,
217
+ minExecutionTime,
218
+ p2pPropagationTime
219
+ };
220
+ }
221
+ function validateCheckpointTimingModel(model) {
222
+ if (model.blockDuration === undefined) {
223
+ return;
224
+ }
225
+ const timeAvailableForBlocks = model.aztecSlotDuration - model.checkpointInitializationTime - model.timeReservedAtEnd;
226
+ if (timeAvailableForBlocks < model.blockDuration) {
227
+ throw new Error(`Invalid timing configuration: only ${timeAvailableForBlocks}s available for block building, which is less than one blockDuration (${model.blockDuration}s).`);
228
+ }
229
+ }
@@ -9,7 +9,19 @@ import type { UInt32 } from '../types/shared.js';
9
9
  * Used in circuits to verify that tree insertions are performed correctly.
10
10
  */
11
11
  export declare class AppendOnlyTreeSnapshot {
12
+ /**
13
+ * Root of the append only tree when taking the snapshot.
14
+ */
12
15
  root: Fr;
16
+ /**
17
+ * Index of the next available leaf in the append only tree.
18
+ *
19
+ * Note: We include the next available leaf index in the snapshot so that the snapshot can be used to verify that
20
+ * the insertion was performed at the correct place. If we only verified tree root then it could happen that
21
+ * some leaves would get overwritten and the tree root check would still pass.
22
+ * TLDR: We need to store the next available leaf index to ensure that the "append only" property was
23
+ * preserved when verifying state transitions.
24
+ */
13
25
  nextAvailableLeafIndex: UInt32;
14
26
  constructor(
15
27
  /**
@@ -61,4 +73,4 @@ export declare class AppendOnlyTreeSnapshot {
61
73
  equals(other: this): boolean;
62
74
  static random(): AppendOnlyTreeSnapshot;
63
75
  }
64
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwZW5kX29ubHlfdHJlZV9zbmFwc2hvdC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3RyZWVzL2FwcGVuZF9vbmx5X3RyZWVfc25hcHNob3QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBRXBELE9BQU8sRUFBRSxZQUFZLEVBQUUsV0FBVyxFQUFxQixNQUFNLDZCQUE2QixDQUFDO0FBRzNGLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxNQUFNLENBQUM7QUFDL0IsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUV4QixPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUVqRDs7OztHQUlHO0FBQ0gscUJBQWEsc0JBQXNCO0lBS3hCLElBQUksRUFBRSxFQUFFO0lBVVIsc0JBQXNCLEVBQUUsTUFBTTtJQWR2QztJQUNFOztPQUVHO0lBQ0ksSUFBSSxFQUFFLEVBQUU7SUFDZjs7Ozs7Ozs7T0FRRztJQUNJLHNCQUFzQixFQUFFLE1BQU0sRUFDbkM7SUFFSixNQUFNLEtBQUssTUFBTTs7Ozs7Ozs7Ozs7O09BT2hCO0lBRUQsT0FBTyxXQUVOO0lBRUQsUUFBUSw0QkFFUDtJQUVELFFBQVEsSUFBSSxFQUFFLEVBQUUsQ0FFZjtJQUVELFFBQVEsSUFBSSxNQUFNLENBRWpCO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLFlBQVksR0FBRyxzQkFBc0IsQ0FHdkU7SUFFRCxNQUFNLENBQUMsVUFBVSxDQUFDLEdBQUcsRUFBRSxNQUFNLEdBQUcsc0JBQXNCLENBRXJEO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFNLEVBQUUsRUFBRSxFQUFFLEdBQUcsV0FBVyxHQUFHLHNCQUFzQixDQUlwRTtJQUVELEtBQUssSUFBSSxDQUFDLEtBQUssTUFBTSxFQUFFLEVBQUUsTUFBTSxDQUFDLENBRS9CO0lBRUQsTUFBTSxDQUFDLEtBQUssMkJBRVg7SUFFRDs7Ozs7O09BTUc7SUFDSCxNQUFNLENBQUMsZUFBZSxDQUFDLEdBQUcsRUFBRSxHQUFHLEdBQUcsc0JBQXNCLENBRXZEO0lBRUQsT0FBTyxJQUFJLE9BQU8sQ0FFakI7SUFFRCxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUMsV0FJZjtJQUVNLE1BQU0sQ0FBQyxLQUFLLEVBQUUsSUFBSSxXQUV4QjtJQUVELE1BQU0sQ0FBQyxNQUFNLDJCQUVaO0NBQ0YifQ==
76
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwZW5kX29ubHlfdHJlZV9zbmFwc2hvdC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3RyZWVzL2FwcGVuZF9vbmx5X3RyZWVfc25hcHNob3QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBRXBELE9BQU8sRUFBRSxZQUFZLEVBQUUsV0FBVyxFQUFxQixNQUFNLDZCQUE2QixDQUFDO0FBRzNGLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxNQUFNLENBQUM7QUFDL0IsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUV4QixPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUVqRDs7OztHQUlHO0FBQ0gscUJBQWEsc0JBQXNCO0lBRS9COztPQUVHO0lBQ0ksSUFBSSxFQUFFLEVBQUU7SUFDZjs7Ozs7Ozs7T0FRRztJQUNJLHNCQUFzQixFQUFFLE1BQU07SUFkdkM7SUFDRTs7T0FFRztJQUNJLElBQUksRUFBRSxFQUFFO0lBQ2Y7Ozs7Ozs7O09BUUc7SUFDSSxzQkFBc0IsRUFBRSxNQUFNLEVBQ25DO0lBRUosTUFBTSxLQUFLLE1BQU07Ozs7Ozs7Ozs7OztPQU9oQjtJQUVELE9BQU8sV0FFTjtJQUVELFFBQVEsNEJBRVA7SUFFRCxRQUFRLElBQUksRUFBRSxFQUFFLENBRWY7SUFFRCxRQUFRLElBQUksTUFBTSxDQUVqQjtJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxZQUFZLEdBQUcsc0JBQXNCLENBR3ZFO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxHQUFHLHNCQUFzQixDQUVyRDtJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsTUFBTSxFQUFFLEVBQUUsRUFBRSxHQUFHLFdBQVcsR0FBRyxzQkFBc0IsQ0FJcEU7SUFFRCxLQUFLLElBQUksQ0FBQyxLQUFLLE1BQU0sRUFBRSxFQUFFLE1BQU0sQ0FBQyxDQUUvQjtJQUVELE1BQU0sQ0FBQyxLQUFLLDJCQUVYO0lBRUQ7Ozs7OztPQU1HO0lBQ0gsTUFBTSxDQUFDLGVBQWUsQ0FBQyxHQUFHLEVBQUUsR0FBRyxHQUFHLHNCQUFzQixDQUV2RDtJQUVELE9BQU8sSUFBSSxPQUFPLENBRWpCO0lBRUQsQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLFdBSWY7SUFFTSxNQUFNLENBQUMsS0FBSyxFQUFFLElBQUksV0FFeEI7SUFFRCxNQUFNLENBQUMsTUFBTSwyQkFFWjtDQUNGIn0=