@aztec/stdlib 0.0.1-commit.f504929 → 0.0.1-commit.f5d02921e

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 (305) 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/buffer.d.ts +14 -4
  5. package/dest/abi/buffer.d.ts.map +1 -1
  6. package/dest/abi/buffer.js +25 -4
  7. package/dest/abi/decoder.d.ts +5 -44
  8. package/dest/abi/decoder.d.ts.map +1 -1
  9. package/dest/abi/decoder.js +12 -67
  10. package/dest/abi/function_selector.js +1 -1
  11. package/dest/abi/function_signature_decoder.d.ts +43 -0
  12. package/dest/abi/function_signature_decoder.d.ts.map +1 -0
  13. package/dest/abi/function_signature_decoder.js +66 -0
  14. package/dest/abi/index.d.ts +2 -1
  15. package/dest/abi/index.d.ts.map +1 -1
  16. package/dest/abi/index.js +1 -0
  17. package/dest/avm/avm.d.ts +300 -300
  18. package/dest/block/l2_block.d.ts +9 -1
  19. package/dest/block/l2_block.d.ts.map +1 -1
  20. package/dest/block/l2_block.js +12 -2
  21. package/dest/block/l2_block_source.d.ts +95 -10
  22. package/dest/block/l2_block_source.d.ts.map +1 -1
  23. package/dest/block/l2_block_source.js +1 -0
  24. package/dest/block/l2_block_stream/l2_tips_store_base.d.ts +1 -1
  25. package/dest/block/l2_block_stream/l2_tips_store_base.d.ts.map +1 -1
  26. package/dest/block/l2_block_stream/l2_tips_store_base.js +17 -4
  27. package/dest/block/test/l2_tips_store_test_suite.d.ts +1 -1
  28. package/dest/block/test/l2_tips_store_test_suite.d.ts.map +1 -1
  29. package/dest/block/test/l2_tips_store_test_suite.js +3 -2
  30. package/dest/checkpoint/checkpoint.d.ts +8 -1
  31. package/dest/checkpoint/checkpoint.d.ts.map +1 -1
  32. package/dest/checkpoint/checkpoint.js +18 -5
  33. package/dest/checkpoint/checkpoint_data.d.ts +71 -5
  34. package/dest/checkpoint/checkpoint_data.d.ts.map +1 -1
  35. package/dest/checkpoint/checkpoint_data.js +10 -0
  36. package/dest/checkpoint/index.d.ts +2 -1
  37. package/dest/checkpoint/index.d.ts.map +1 -1
  38. package/dest/checkpoint/index.js +1 -0
  39. package/dest/checkpoint/validate.d.ts +36 -0
  40. package/dest/checkpoint/validate.d.ts.map +1 -0
  41. package/dest/checkpoint/validate.js +120 -0
  42. package/dest/config/index.d.ts +2 -1
  43. package/dest/config/index.d.ts.map +1 -1
  44. package/dest/config/index.js +1 -0
  45. package/dest/config/pipelining-config.d.ts +19 -0
  46. package/dest/config/pipelining-config.d.ts.map +1 -0
  47. package/dest/config/pipelining-config.js +18 -0
  48. package/dest/config/sequencer-config.d.ts +2 -2
  49. package/dest/config/sequencer-config.d.ts.map +1 -1
  50. package/dest/config/sequencer-config.js +1 -2
  51. package/dest/contract/contract_address.d.ts +3 -3
  52. package/dest/contract/contract_address.js +3 -3
  53. package/dest/contract/contract_class_id.d.ts +2 -2
  54. package/dest/contract/contract_class_id.js +2 -2
  55. package/dest/contract/index.d.ts +1 -3
  56. package/dest/contract/index.d.ts.map +1 -1
  57. package/dest/contract/index.js +0 -2
  58. package/dest/contract/interfaces/contract_class.d.ts +3 -156
  59. package/dest/contract/interfaces/contract_class.d.ts.map +1 -1
  60. package/dest/contract/interfaces/contract_class.js +1 -28
  61. package/dest/epoch-helpers/index.d.ts +11 -1
  62. package/dest/epoch-helpers/index.d.ts.map +1 -1
  63. package/dest/epoch-helpers/index.js +16 -2
  64. package/dest/file-store/factory.d.ts +4 -3
  65. package/dest/file-store/factory.d.ts.map +1 -1
  66. package/dest/file-store/factory.js +2 -2
  67. package/dest/file-store/http.d.ts +9 -2
  68. package/dest/file-store/http.d.ts.map +1 -1
  69. package/dest/file-store/http.js +20 -9
  70. package/dest/file-store/index.d.ts +2 -1
  71. package/dest/file-store/index.d.ts.map +1 -1
  72. package/dest/ha-signing/config.d.ts +49 -14
  73. package/dest/ha-signing/config.d.ts.map +1 -1
  74. package/dest/ha-signing/config.js +20 -15
  75. package/dest/ha-signing/index.d.ts +3 -2
  76. package/dest/ha-signing/index.d.ts.map +1 -1
  77. package/dest/ha-signing/index.js +2 -1
  78. package/dest/ha-signing/local_config.d.ts +63 -0
  79. package/dest/ha-signing/local_config.d.ts.map +1 -0
  80. package/dest/ha-signing/local_config.js +24 -0
  81. package/dest/hash/hash.d.ts +19 -1
  82. package/dest/hash/hash.d.ts.map +1 -1
  83. package/dest/hash/hash.js +29 -0
  84. package/dest/interfaces/allowed_element.d.ts +25 -1
  85. package/dest/interfaces/allowed_element.d.ts.map +1 -1
  86. package/dest/interfaces/allowed_element.js +8 -2
  87. package/dest/interfaces/archiver.d.ts +1 -1
  88. package/dest/interfaces/archiver.d.ts.map +1 -1
  89. package/dest/interfaces/archiver.js +6 -3
  90. package/dest/interfaces/aztec-node-admin.d.ts +70 -13
  91. package/dest/interfaces/aztec-node-admin.d.ts.map +1 -1
  92. package/dest/interfaces/aztec-node.d.ts +12 -6
  93. package/dest/interfaces/aztec-node.d.ts.map +1 -1
  94. package/dest/interfaces/aztec-node.js +5 -2
  95. package/dest/interfaces/block-builder.d.ts +38 -11
  96. package/dest/interfaces/block-builder.d.ts.map +1 -1
  97. package/dest/interfaces/block-builder.js +12 -5
  98. package/dest/interfaces/configs.d.ts +47 -7
  99. package/dest/interfaces/configs.d.ts.map +1 -1
  100. package/dest/interfaces/configs.js +3 -1
  101. package/dest/interfaces/l2_logs_source.d.ts +5 -3
  102. package/dest/interfaces/l2_logs_source.d.ts.map +1 -1
  103. package/dest/interfaces/merkle_tree_operations.d.ts +9 -19
  104. package/dest/interfaces/merkle_tree_operations.d.ts.map +1 -1
  105. package/dest/interfaces/prover-client.d.ts +6 -1
  106. package/dest/interfaces/prover-client.d.ts.map +1 -1
  107. package/dest/interfaces/prover-client.js +7 -1
  108. package/dest/interfaces/proving-job.d.ts +200 -200
  109. package/dest/interfaces/validator.d.ts +101 -30
  110. package/dest/interfaces/validator.d.ts.map +1 -1
  111. package/dest/interfaces/validator.js +7 -5
  112. package/dest/interfaces/world_state.d.ts +5 -4
  113. package/dest/interfaces/world_state.d.ts.map +1 -1
  114. package/dest/kernel/private_kernel_tail_circuit_public_inputs.d.ts +2 -1
  115. package/dest/kernel/private_kernel_tail_circuit_public_inputs.d.ts.map +1 -1
  116. package/dest/kernel/private_kernel_tail_circuit_public_inputs.js +4 -0
  117. package/dest/kv-store/config.d.ts +17 -0
  118. package/dest/kv-store/config.d.ts.map +1 -0
  119. package/dest/kv-store/config.js +26 -0
  120. package/dest/kv-store/index.d.ts +2 -0
  121. package/dest/kv-store/index.d.ts.map +1 -0
  122. package/dest/kv-store/index.js +1 -0
  123. package/dest/logs/index.d.ts +2 -1
  124. package/dest/logs/index.d.ts.map +1 -1
  125. package/dest/logs/index.js +1 -0
  126. package/dest/logs/log_filter.d.ts +4 -1
  127. package/dest/logs/log_filter.d.ts.map +1 -1
  128. package/dest/logs/log_filter.js +2 -1
  129. package/dest/logs/message_context.d.ts +4 -7
  130. package/dest/logs/message_context.d.ts.map +1 -1
  131. package/dest/logs/message_context.js +23 -9
  132. package/dest/logs/pending_tagged_log.d.ts +2 -3
  133. package/dest/logs/pending_tagged_log.d.ts.map +1 -1
  134. package/dest/logs/pending_tagged_log.js +2 -2
  135. package/dest/logs/shared_secret_derivation.d.ts +11 -10
  136. package/dest/logs/shared_secret_derivation.d.ts.map +1 -1
  137. package/dest/logs/shared_secret_derivation.js +15 -9
  138. package/dest/logs/siloed_tag.d.ts +4 -1
  139. package/dest/logs/siloed_tag.d.ts.map +1 -1
  140. package/dest/logs/siloed_tag.js +7 -3
  141. package/dest/logs/tagging_index_range.d.ts +40 -0
  142. package/dest/logs/tagging_index_range.d.ts.map +1 -0
  143. package/dest/logs/tagging_index_range.js +8 -0
  144. package/dest/logs/tx_scoped_l2_log.d.ts +3 -1
  145. package/dest/logs/tx_scoped_l2_log.d.ts.map +1 -1
  146. package/dest/logs/tx_scoped_l2_log.js +7 -0
  147. package/dest/messaging/l1_to_l2_message.d.ts +3 -2
  148. package/dest/messaging/l1_to_l2_message.d.ts.map +1 -1
  149. package/dest/messaging/l1_to_l2_message.js +11 -13
  150. package/dest/messaging/l1_to_l2_message_source.d.ts +4 -2
  151. package/dest/messaging/l1_to_l2_message_source.d.ts.map +1 -1
  152. package/dest/messaging/l2_to_l1_membership.d.ts +32 -6
  153. package/dest/messaging/l2_to_l1_membership.d.ts.map +1 -1
  154. package/dest/messaging/l2_to_l1_membership.js +69 -26
  155. package/dest/noir/index.d.ts +3 -3
  156. package/dest/noir/index.d.ts.map +1 -1
  157. package/dest/note/note_dao.d.ts +1 -1
  158. package/dest/note/note_dao.d.ts.map +1 -1
  159. package/dest/note/note_dao.js +1 -4
  160. package/dest/p2p/checkpoint_proposal.d.ts +1 -6
  161. package/dest/p2p/checkpoint_proposal.d.ts.map +1 -1
  162. package/dest/p2p/checkpoint_proposal.js +13 -23
  163. package/dest/p2p/peer_error.d.ts +3 -1
  164. package/dest/p2p/peer_error.d.ts.map +1 -1
  165. package/dest/p2p/peer_error.js +5 -0
  166. package/dest/proofs/chonk_proof.d.ts +46 -2
  167. package/dest/proofs/chonk_proof.d.ts.map +1 -1
  168. package/dest/proofs/chonk_proof.js +85 -10
  169. package/dest/slashing/tally.d.ts +5 -6
  170. package/dest/slashing/tally.d.ts.map +1 -1
  171. package/dest/slashing/tally.js +19 -10
  172. package/dest/tests/factories.d.ts +2 -4
  173. package/dest/tests/factories.d.ts.map +1 -1
  174. package/dest/tests/factories.js +10 -27
  175. package/dest/tests/mocks.d.ts +4 -2
  176. package/dest/tests/mocks.d.ts.map +1 -1
  177. package/dest/tests/mocks.js +13 -8
  178. package/dest/tx/block_header.d.ts +3 -1
  179. package/dest/tx/block_header.d.ts.map +1 -1
  180. package/dest/tx/block_header.js +4 -0
  181. package/dest/tx/capsule.d.ts +6 -2
  182. package/dest/tx/capsule.d.ts.map +1 -1
  183. package/dest/tx/capsule.js +9 -3
  184. package/dest/tx/global_variable_builder.d.ts +14 -2
  185. package/dest/tx/global_variable_builder.d.ts.map +1 -1
  186. package/dest/tx/private_execution_result.d.ts +6 -6
  187. package/dest/tx/private_execution_result.d.ts.map +1 -1
  188. package/dest/tx/private_execution_result.js +6 -6
  189. package/dest/tx/profiling.d.ts +14 -2
  190. package/dest/tx/profiling.d.ts.map +1 -1
  191. package/dest/tx/profiling.js +13 -3
  192. package/dest/tx/simulated_tx.d.ts +109 -1
  193. package/dest/tx/simulated_tx.d.ts.map +1 -1
  194. package/dest/tx/tx.d.ts +6 -5
  195. package/dest/tx/tx.d.ts.map +1 -1
  196. package/dest/tx/tx.js +18 -6
  197. package/dest/tx/tx_receipt.d.ts +7 -2
  198. package/dest/tx/tx_receipt.d.ts.map +1 -1
  199. package/dest/tx/tx_receipt.js +6 -3
  200. package/dest/tx/validator/error_texts.d.ts +8 -1
  201. package/dest/tx/validator/error_texts.d.ts.map +1 -1
  202. package/dest/tx/validator/error_texts.js +9 -0
  203. package/dest/update-checker/index.d.ts +3 -2
  204. package/dest/update-checker/index.d.ts.map +1 -1
  205. package/dest/update-checker/index.js +2 -1
  206. package/dest/update-checker/package_version.d.ts +3 -0
  207. package/dest/update-checker/package_version.d.ts.map +1 -0
  208. package/dest/update-checker/package_version.js +24 -0
  209. package/dest/update-checker/version_checker.d.ts +25 -0
  210. package/dest/update-checker/version_checker.d.ts.map +1 -0
  211. package/dest/update-checker/version_checker.js +50 -0
  212. package/dest/validators/errors.d.ts +6 -1
  213. package/dest/validators/errors.d.ts.map +1 -1
  214. package/dest/validators/errors.js +7 -0
  215. package/dest/versioning/versioning.d.ts +4 -2
  216. package/dest/versioning/versioning.d.ts.map +1 -1
  217. package/dest/versioning/versioning.js +4 -1
  218. package/package.json +10 -9
  219. package/src/abi/abi.ts +25 -2
  220. package/src/abi/buffer.ts +25 -4
  221. package/src/abi/decoder.ts +23 -78
  222. package/src/abi/function_selector.ts +1 -1
  223. package/src/abi/function_signature_decoder.ts +77 -0
  224. package/src/abi/index.ts +1 -0
  225. package/src/block/l2_block.ts +13 -1
  226. package/src/block/l2_block_source.ts +26 -9
  227. package/src/block/l2_block_stream/l2_tips_store_base.ts +24 -12
  228. package/src/block/test/l2_tips_store_test_suite.ts +8 -1
  229. package/src/checkpoint/checkpoint.ts +23 -4
  230. package/src/checkpoint/checkpoint_data.ts +40 -4
  231. package/src/checkpoint/index.ts +1 -0
  232. package/src/checkpoint/validate.ts +230 -0
  233. package/src/config/index.ts +1 -0
  234. package/src/config/pipelining-config.ts +31 -0
  235. package/src/config/sequencer-config.ts +2 -2
  236. package/src/contract/contract_address.ts +3 -3
  237. package/src/contract/contract_class_id.ts +2 -2
  238. package/src/contract/index.ts +0 -2
  239. package/src/contract/interfaces/contract_class.ts +2 -82
  240. package/src/epoch-helpers/index.ts +27 -0
  241. package/src/file-store/factory.ts +13 -4
  242. package/src/file-store/http.ts +29 -10
  243. package/src/file-store/index.ts +1 -0
  244. package/src/gas/README.md +123 -0
  245. package/src/ha-signing/config.ts +45 -38
  246. package/src/ha-signing/index.ts +9 -0
  247. package/src/ha-signing/local_config.ts +46 -0
  248. package/src/hash/hash.ts +34 -0
  249. package/src/interfaces/allowed_element.ts +28 -4
  250. package/src/interfaces/archiver.ts +6 -3
  251. package/src/interfaces/aztec-node.ts +24 -5
  252. package/src/interfaces/block-builder.ts +56 -13
  253. package/src/interfaces/configs.ts +15 -4
  254. package/src/interfaces/l2_logs_source.ts +4 -1
  255. package/src/interfaces/merkle_tree_operations.ts +8 -18
  256. package/src/interfaces/prover-client.ts +8 -0
  257. package/src/interfaces/validator.ts +46 -29
  258. package/src/interfaces/world_state.ts +4 -3
  259. package/src/kernel/private_kernel_tail_circuit_public_inputs.ts +9 -0
  260. package/src/kv-store/config.ts +36 -0
  261. package/src/kv-store/index.ts +1 -0
  262. package/src/logs/index.ts +1 -0
  263. package/src/logs/log_filter.ts +5 -0
  264. package/src/logs/message_context.ts +17 -7
  265. package/src/logs/pending_tagged_log.ts +1 -3
  266. package/src/logs/shared_secret_derivation.ts +21 -10
  267. package/src/logs/siloed_tag.ts +7 -2
  268. package/src/logs/tagging_index_range.ts +24 -0
  269. package/src/logs/tx_scoped_l2_log.ts +16 -0
  270. package/src/messaging/l1_to_l2_message.ts +12 -9
  271. package/src/messaging/l1_to_l2_message_source.ts +3 -1
  272. package/src/messaging/l2_to_l1_membership.ts +98 -33
  273. package/src/noir/index.ts +2 -2
  274. package/src/note/note_dao.ts +1 -4
  275. package/src/p2p/checkpoint_proposal.ts +23 -37
  276. package/src/p2p/peer_error.ts +7 -0
  277. package/src/proofs/chonk_proof.ts +91 -5
  278. package/src/slashing/tally.ts +22 -4
  279. package/src/tests/factories.ts +4 -33
  280. package/src/tests/mocks.ts +18 -7
  281. package/src/tx/block_header.ts +6 -0
  282. package/src/tx/capsule.ts +10 -2
  283. package/src/tx/global_variable_builder.ts +15 -0
  284. package/src/tx/private_execution_result.ts +5 -5
  285. package/src/tx/profiling.ts +11 -2
  286. package/src/tx/tx.ts +20 -11
  287. package/src/tx/tx_receipt.ts +7 -2
  288. package/src/tx/validator/error_texts.ts +11 -0
  289. package/src/update-checker/index.ts +2 -1
  290. package/src/update-checker/package_version.ts +30 -0
  291. package/src/update-checker/version_checker.ts +65 -0
  292. package/src/validators/errors.ts +9 -0
  293. package/src/versioning/versioning.ts +4 -1
  294. package/dest/contract/private_function_membership_proof.d.ts +0 -32
  295. package/dest/contract/private_function_membership_proof.d.ts.map +0 -1
  296. package/dest/contract/private_function_membership_proof.js +0 -124
  297. package/dest/contract/utility_function_membership_proof.d.ts +0 -27
  298. package/dest/contract/utility_function_membership_proof.d.ts.map +0 -1
  299. package/dest/contract/utility_function_membership_proof.js +0 -87
  300. package/dest/update-checker/update-checker.d.ts +0 -49
  301. package/dest/update-checker/update-checker.d.ts.map +0 -1
  302. package/dest/update-checker/update-checker.js +0 -130
  303. package/src/contract/private_function_membership_proof.ts +0 -167
  304. package/src/contract/utility_function_membership_proof.ts +0 -118
  305. package/src/update-checker/update-checker.ts +0 -166
@@ -13,6 +13,8 @@ export interface SequencerConfig {
13
13
  sequencerPollingIntervalMS?: number;
14
14
  /** The maximum number of txs to include in a block. */
15
15
  maxTxsPerBlock?: number;
16
+ /** The maximum number of txs across all blocks in a checkpoint. */
17
+ maxTxsPerCheckpoint?: number;
16
18
  /** The minimum number of txs to include in a block. */
17
19
  minTxsPerBlock?: number;
18
20
  /** The minimum number of valid txs (after execution) to include in a block. If not set, falls back to minTxsPerBlock. */
@@ -23,6 +25,10 @@ export interface SequencerConfig {
23
25
  maxL2BlockGas?: number;
24
26
  /** The maximum DA block gas. */
25
27
  maxDABlockGas?: number;
28
+ /** Per-block gas budget multiplier for both L2 and DA gas. Budget = (checkpointLimit / maxBlocks) * multiplier. */
29
+ perBlockAllocationMultiplier?: number;
30
+ /** Redistribute remaining checkpoint budget evenly across remaining blocks instead of allowing a single block to consume the entire remaining budget. */
31
+ redistributeCheckpointBudget?: boolean;
26
32
  /** Recipient of block reward. */
27
33
  coinbase?: EthAddress;
28
34
  /** Address to receive fees. */
@@ -33,8 +39,6 @@ export interface SequencerConfig {
33
39
  acvmBinaryPath?: string;
34
40
  /** Additional entries to extend the default setup allow list. */
35
41
  txPublicSetupAllowListExtend?: AllowedElement[];
36
- /** Max block size */
37
- maxBlockSizeInBytes?: number;
38
42
  /** Payload address to vote for */
39
43
  governanceProposerPayload?: EthAddress;
40
44
  /** Whether to enforce the time table when building blocks */
@@ -85,17 +89,19 @@ export const SequencerConfigSchema = zodFor<SequencerConfig>()(
85
89
  z.object({
86
90
  sequencerPollingIntervalMS: z.number().optional(),
87
91
  maxTxsPerBlock: z.number().optional(),
92
+ maxTxsPerCheckpoint: z.number().optional(),
88
93
  minValidTxsPerBlock: z.number().optional(),
89
94
  minTxsPerBlock: z.number().optional(),
90
95
  maxL2BlockGas: z.number().optional(),
91
96
  publishTxsWithProposals: z.boolean().optional(),
92
97
  maxDABlockGas: z.number().optional(),
98
+ perBlockAllocationMultiplier: z.number().optional(),
99
+ redistributeCheckpointBudget: z.boolean().optional(),
93
100
  coinbase: schemas.EthAddress.optional(),
94
101
  feeRecipient: schemas.AztecAddress.optional(),
95
102
  acvmWorkingDirectory: z.string().optional(),
96
103
  acvmBinaryPath: z.string().optional(),
97
104
  txPublicSetupAllowListExtend: z.array(AllowedElementSchema).optional(),
98
- maxBlockSizeInBytes: z.number().optional(),
99
105
  governanceProposerPayload: schemas.EthAddress.optional(),
100
106
  l1PublishingTime: z.number().optional(),
101
107
  enforceTimeTable: z.boolean().optional(),
@@ -134,7 +140,12 @@ type SequencerConfigOptionalKeys =
134
140
  | 'l1PublishingTime'
135
141
  | 'txPublicSetupAllowListExtend'
136
142
  | 'minValidTxsPerBlock'
137
- | 'minBlocksForCheckpoint';
143
+ | 'minBlocksForCheckpoint'
144
+ | 'maxTxsPerBlock'
145
+ | 'maxTxsPerCheckpoint'
146
+ | 'maxL2BlockGas'
147
+ | 'maxDABlockGas'
148
+ | 'redistributeCheckpointBudget';
138
149
 
139
150
  export type ResolvedSequencerConfig = Prettify<
140
151
  Required<Omit<SequencerConfig, SequencerConfigOptionalKeys>> & Pick<SequencerConfig, SequencerConfigOptionalKeys>
@@ -16,10 +16,11 @@ export interface L2LogsSource {
16
16
  * array implies no logs match that tag.
17
17
  * @param tags - The tags to search for.
18
18
  * @param page - The page number (0-indexed) for pagination.
19
+ * @param upToBlockNumber - If set, only return logs from blocks up to and including this block number.
19
20
  * @returns An array of log arrays, one per tag. Returns at most 10 logs per tag per page. If 10 logs are returned
20
21
  * for a tag, the caller should fetch the next page to check for more logs.
21
22
  */
22
- getPrivateLogsByTags(tags: SiloedTag[], page?: number): Promise<TxScopedL2Log[][]>;
23
+ getPrivateLogsByTags(tags: SiloedTag[], page?: number, upToBlockNumber?: BlockNumber): Promise<TxScopedL2Log[][]>;
23
24
 
24
25
  /**
25
26
  * Gets public logs that match any of the `tags` from the specified contract. For each tag, an array of matching
@@ -27,6 +28,7 @@ export interface L2LogsSource {
27
28
  * @param contractAddress - The contract address to search logs for.
28
29
  * @param tags - The tags to search for.
29
30
  * @param page - The page number (0-indexed) for pagination.
31
+ * @param upToBlockNumber - If set, only return logs from blocks up to and including this block number.
30
32
  * @returns An array of log arrays, one per tag. Returns at most 10 logs per tag per page. If 10 logs are returned
31
33
  * for a tag, the caller should fetch the next page to check for more logs.
32
34
  */
@@ -34,6 +36,7 @@ export interface L2LogsSource {
34
36
  contractAddress: AztecAddress,
35
37
  tags: Tag[],
36
38
  page?: number,
39
+ upToBlockNumber?: BlockNumber,
37
40
  ): Promise<TxScopedL2Log[][]>;
38
41
 
39
42
  /**
@@ -225,30 +225,20 @@ export interface MerkleTreeReadOperations {
225
225
  }
226
226
 
227
227
  export interface MerkleTreeCheckpointOperations {
228
- /**
229
- * Checkpoints the current fork state
230
- */
231
- createCheckpoint(): Promise<void>;
228
+ /** Checkpoints the current fork state. Returns the depth of the new checkpoint. */
229
+ createCheckpoint(): Promise<number>;
232
230
 
233
- /**
234
- * Commits the current checkpoint
235
- */
231
+ /** Commits the current checkpoint. */
236
232
  commitCheckpoint(): Promise<void>;
237
233
 
238
- /**
239
- * Reverts the current checkpoint
240
- */
234
+ /** Reverts the current checkpoint. */
241
235
  revertCheckpoint(): Promise<void>;
242
236
 
243
- /**
244
- * Commits all checkpoints
245
- */
246
- commitAllCheckpoints(): Promise<void>;
237
+ /** Commits all checkpoints above the given depth, leaving checkpoint depth at the given value. */
238
+ commitAllCheckpointsTo(depth: number): Promise<void>;
247
239
 
248
- /**
249
- * Reverts all checkpoints
250
- */
251
- revertAllCheckpoints(): Promise<void>;
240
+ /** Reverts all checkpoints above the given depth, leaving checkpoint depth at the given value. */
241
+ revertAllCheckpointsTo(depth: number): Promise<void>;
252
242
  }
253
243
 
254
244
  export interface MerkleTreeWriteOperations
@@ -23,6 +23,8 @@ export type ActualProverConfig = {
23
23
  * When true, jobs are explicitly cancelled with the broker, which prevents reuse.
24
24
  */
25
25
  cancelJobsOnStop: boolean;
26
+ /** Max concurrent jobs the orchestrator serializes and enqueues to the broker. */
27
+ enqueueConcurrency: number;
26
28
  };
27
29
 
28
30
  /**
@@ -53,6 +55,7 @@ export const ProverConfigSchema = zodFor<ProverConfig>()(
53
55
  proofStore: z.string().optional(),
54
56
  failedProofStore: z.string().optional(),
55
57
  cancelJobsOnStop: z.boolean(),
58
+ enqueueConcurrency: z.number(),
56
59
  }),
57
60
  );
58
61
 
@@ -107,6 +110,11 @@ export const proverConfigMappings: ConfigMappingsType<ProverConfig> = {
107
110
  'When true, jobs are explicitly cancelled with the broker, which prevents reuse.',
108
111
  ...booleanConfigHelper(false),
109
112
  },
113
+ enqueueConcurrency: {
114
+ env: 'PROVER_ENQUEUE_CONCURRENCY',
115
+ description: 'Max concurrent jobs the orchestrator serializes and enqueues to the broker.',
116
+ ...numberConfigHelper(50),
117
+ },
110
118
  };
111
119
 
112
120
  function parseProverId(str?: string) {
@@ -20,49 +20,64 @@ import type { PeerId } from '@libp2p/interface';
20
20
  import { z } from 'zod';
21
21
 
22
22
  import type { CommitteeAttestationsAndSigners } from '../block/index.js';
23
- import { type ValidatorHASignerConfig, ValidatorHASignerConfigSchema } from '../ha-signing/index.js';
23
+ import {
24
+ type LocalSignerConfig,
25
+ LocalSignerConfigSchema,
26
+ type ValidatorHASignerConfig,
27
+ ValidatorHASignerConfigSchema,
28
+ } from '../ha-signing/index.js';
24
29
  import { AllowedElementSchema } from './allowed_element.js';
25
30
 
26
31
  /**
27
32
  * Validator client configuration
28
33
  */
29
- export type ValidatorClientConfig = ValidatorHASignerConfig & {
30
- /** The private keys of the validators participating in attestation duties */
31
- validatorPrivateKeys?: SecretValue<`0x${string}`[]>;
34
+ export type ValidatorClientConfig = ValidatorHASignerConfig &
35
+ LocalSignerConfig & {
36
+ /** The private keys of the validators participating in attestation duties */
37
+ validatorPrivateKeys?: SecretValue<`0x${string}`[]>;
32
38
 
33
- /** The addresses of the validators to use with remote signers */
34
- validatorAddresses?: EthAddress[];
39
+ /** The addresses of the validators to use with remote signers */
40
+ validatorAddresses?: EthAddress[];
35
41
 
36
- /** Do not run the validator */
37
- disableValidator: boolean;
42
+ /** Do not run the validator */
43
+ disableValidator: boolean;
38
44
 
39
- /** Temporarily disable these specific validator addresses */
40
- disabledValidators: EthAddress[];
45
+ /** Temporarily disable these specific validator addresses */
46
+ disabledValidators: EthAddress[];
41
47
 
42
- /** Interval between polling for new attestations from peers */
43
- attestationPollingIntervalMs: number;
48
+ /** Interval between polling for new attestations from peers */
49
+ attestationPollingIntervalMs: number;
44
50
 
45
- /** Whether to re-execute transactions in a block proposal before attesting */
46
- validatorReexecute: boolean;
51
+ /** Whether to always reexecute block proposals, even for non-validator nodes or when out of the current committee */
52
+ alwaysReexecuteBlockProposals?: boolean;
47
53
 
48
- /** Whether to always reexecute block proposals, even for non-validator nodes or when out of the currnet committee */
49
- alwaysReexecuteBlockProposals?: boolean;
54
+ /** Whether to run in fisherman mode: validates all proposals and attestations but does not broadcast attestations or participate in consensus */
55
+ fishermanMode?: boolean;
50
56
 
51
- /** Whether to run in fisherman mode: validates all proposals and attestations but does not broadcast attestations or participate in consensus */
52
- fishermanMode?: boolean;
57
+ /** Skip checkpoint proposal validation and always attest (default: false) */
58
+ skipCheckpointProposalValidation?: boolean;
53
59
 
54
- /** Skip checkpoint proposal validation and always attest (default: false) */
55
- skipCheckpointProposalValidation?: boolean;
60
+ /** Skip pushing re-executed blocks to archiver (default: false) */
61
+ skipPushProposedBlocksToArchiver?: boolean;
56
62
 
57
- /** Skip pushing re-executed blocks to archiver (default: false) */
58
- skipPushProposedBlocksToArchiver?: boolean;
63
+ /** Agree to attest to equivocated checkpoint proposals (for testing purposes only) */
64
+ attestToEquivocatedProposals?: boolean;
59
65
 
60
- /** Agree to attest to equivocated checkpoint proposals (for testing purposes only) */
61
- attestToEquivocatedProposals?: boolean;
62
- };
66
+ /** Maximum L2 gas per block for validation. Proposals exceeding this limit are rejected. */
67
+ validateMaxL2BlockGas?: number;
68
+
69
+ /** Maximum DA gas per block for validation. Proposals exceeding this limit are rejected. */
70
+ validateMaxDABlockGas?: number;
71
+
72
+ /** Maximum transactions per block for validation. Proposals exceeding this limit are rejected. */
73
+ validateMaxTxsPerBlock?: number;
74
+
75
+ /** Maximum transactions per checkpoint for validation. Proposals exceeding this limit are rejected. */
76
+ validateMaxTxsPerCheckpoint?: number;
77
+ };
63
78
 
64
79
  export type ValidatorClientFullConfig = ValidatorClientConfig &
65
- Pick<SequencerConfig, 'txPublicSetupAllowListExtend' | 'broadcastInvalidBlockProposal' | 'maxTxsPerBlock'> &
80
+ Pick<SequencerConfig, 'txPublicSetupAllowListExtend' | 'broadcastInvalidBlockProposal'> &
66
81
  Pick<
67
82
  SlasherConfig,
68
83
  'slashBroadcastedInvalidBlockPenalty' | 'slashDuplicateProposalPenalty' | 'slashDuplicateAttestationPenalty'
@@ -75,17 +90,20 @@ export type ValidatorClientFullConfig = ValidatorClientConfig &
75
90
  };
76
91
 
77
92
  export const ValidatorClientConfigSchema = zodFor<Omit<ValidatorClientConfig, 'validatorPrivateKeys'>>()(
78
- ValidatorHASignerConfigSchema.extend({
93
+ ValidatorHASignerConfigSchema.merge(LocalSignerConfigSchema).extend({
79
94
  validatorAddresses: z.array(schemas.EthAddress).optional(),
80
95
  disableValidator: z.boolean(),
81
96
  disabledValidators: z.array(schemas.EthAddress),
82
97
  attestationPollingIntervalMs: z.number().min(0),
83
- validatorReexecute: z.boolean(),
84
98
  alwaysReexecuteBlockProposals: z.boolean().optional(),
85
99
  fishermanMode: z.boolean().optional(),
86
100
  skipCheckpointProposalValidation: z.boolean().optional(),
87
101
  skipPushProposedBlocksToArchiver: z.boolean().optional(),
88
102
  attestToEquivocatedProposals: z.boolean().optional(),
103
+ validateMaxL2BlockGas: z.number().optional(),
104
+ validateMaxDABlockGas: z.number().optional(),
105
+ validateMaxTxsPerBlock: z.number().optional(),
106
+ validateMaxTxsPerCheckpoint: z.number().optional(),
89
107
  }),
90
108
  );
91
109
 
@@ -93,7 +111,6 @@ export const ValidatorClientFullConfigSchema = zodFor<Omit<ValidatorClientFullCo
93
111
  ValidatorClientConfigSchema.extend({
94
112
  txPublicSetupAllowListExtend: z.array(AllowedElementSchema).optional(),
95
113
  broadcastInvalidBlockProposal: z.boolean().optional(),
96
- maxTxsPerBlock: z.number().optional(),
97
114
  slashBroadcastedInvalidBlockPenalty: schemas.BigInt,
98
115
  slashDuplicateProposalPenalty: schemas.BigInt,
99
116
  slashDuplicateAttestationPenalty: schemas.BigInt,
@@ -3,6 +3,7 @@ import type { PromiseWithResolvers } from '@aztec/foundation/promise';
3
3
 
4
4
  import { z } from 'zod';
5
5
 
6
+ import type { BlockHash } from '../block/block_hash.js';
6
7
  import type { SnapshotDataKeys } from '../snapshots/types.js';
7
8
  import type { MerkleTreeReadOperations, MerkleTreeWriteOperations } from './merkle_tree_operations.js';
8
9
 
@@ -80,12 +81,12 @@ export interface WorldStateSynchronizer extends ReadonlyWorldStateAccess, ForkMe
80
81
  resumeSync(): void;
81
82
 
82
83
  /**
83
- * Forces an immediate sync to an optionally provided minimum block number
84
+ * Forces an immediate sync to an optionally provided minimum block number.
84
85
  * @param targetBlockNumber - The target block number that we must sync to. Will download unproven blocks if needed to reach it.
85
- * @param skipThrowIfTargetNotReached - Whether to skip throwing if the target block number is not reached.
86
+ * @param blockHash - If provided, verifies the block at targetBlockNumber matches this hash. On mismatch, triggers a resync (reorg detection).
86
87
  * @returns A promise that resolves with the block number the world state was synced to
87
88
  */
88
- syncImmediate(minBlockNumber?: BlockNumber, skipThrowIfTargetNotReached?: boolean): Promise<BlockNumber>;
89
+ syncImmediate(minBlockNumber?: BlockNumber, blockHash?: BlockHash): Promise<BlockNumber>;
89
90
 
90
91
  /** Deletes the db */
91
92
  clear(): Promise<void>;
@@ -234,6 +234,15 @@ export class PrivateKernelTailCircuitPublicInputs {
234
234
  return noteHashes.filter(n => !n.isZero());
235
235
  }
236
236
 
237
+ getNonEmptyL2ToL1Msgs() {
238
+ const l2ToL1Msgs = this.forPublic
239
+ ? this.forPublic.nonRevertibleAccumulatedData.l2ToL1Msgs.concat(
240
+ this.forPublic.revertibleAccumulatedData.l2ToL1Msgs,
241
+ )
242
+ : this.forRollup!.end.l2ToL1Msgs;
243
+ return l2ToL1Msgs.filter(m => !m.isEmpty());
244
+ }
245
+
237
246
  getNonEmptyNullifiers() {
238
247
  const nullifiers = this.forPublic
239
248
  ? this.forPublic.nonRevertibleAccumulatedData.nullifiers.concat(
@@ -0,0 +1,36 @@
1
+ import { l1ContractAddressesMapping } from '@aztec/ethereum/l1-contract-addresses';
2
+ import { type ConfigMappingsType, getConfigFromMappings, numberConfigHelper } from '@aztec/foundation/config';
3
+ import type { EthAddress } from '@aztec/foundation/eth-address';
4
+
5
+ export type DataStoreConfig = {
6
+ dataDirectory?: string;
7
+ dataStoreMapSizeKb: number;
8
+ l1Contracts?: { rollupAddress: EthAddress };
9
+ };
10
+
11
+ export const dataConfigMappings: ConfigMappingsType<DataStoreConfig> = {
12
+ dataDirectory: {
13
+ env: 'DATA_DIRECTORY',
14
+ description: 'Optional dir to store data. If omitted will store in memory.',
15
+ },
16
+ dataStoreMapSizeKb: {
17
+ env: 'DATA_STORE_MAP_SIZE_KB',
18
+ description: 'The maximum possible size of a data store DB in KB. Can be overridden by component-specific options.',
19
+ ...numberConfigHelper(128 * 1_024 * 1_024), // Defaulted to 128 GB
20
+ },
21
+ l1Contracts: {
22
+ description: 'The deployed L1 contract addresses',
23
+ nested: {
24
+ rollupAddress: l1ContractAddressesMapping.rollupAddress,
25
+ },
26
+ },
27
+ };
28
+
29
+ /**
30
+ * Returns the archiver configuration from the environment variables.
31
+ * Note: If an environment variable is not set, the default value is used.
32
+ * @returns The archiver configuration.
33
+ */
34
+ export function getDataConfigFromEnv(): DataStoreConfig {
35
+ return getConfigFromMappings<DataStoreConfig>(dataConfigMappings);
36
+ }
@@ -0,0 +1 @@
1
+ export * from './config.js';
package/src/logs/index.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  export * from './extended_directional_app_tagging_secret.js';
2
2
  export * from './pre_tag.js';
3
+ export * from './tagging_index_range.js';
3
4
  export * from './contract_class_log.js';
4
5
  export * from './public_log.js';
5
6
  export * from './private_log.js';
@@ -1,3 +1,5 @@
1
+ import type { Fr } from '@aztec/foundation/curves/bn254';
2
+
1
3
  import { z } from 'zod';
2
4
 
3
5
  import type { AztecAddress } from '../aztec-address/index.js';
@@ -20,6 +22,8 @@ export type LogFilter = {
20
22
  afterLog?: LogId;
21
23
  /** The contract address to filter logs by. */
22
24
  contractAddress?: AztecAddress;
25
+ /** The tag (first field of the log) to filter logs by. */
26
+ tag?: Fr;
23
27
  };
24
28
 
25
29
  export const LogFilterSchema: ZodFor<LogFilter> = z.object({
@@ -28,4 +32,5 @@ export const LogFilterSchema: ZodFor<LogFilter> = z.object({
28
32
  toBlock: schemas.Integer.optional(),
29
33
  afterLog: LogId.schema.optional(),
30
34
  contractAddress: schemas.AztecAddress.optional(),
35
+ tag: schemas.Fr.optional(),
31
36
  });
@@ -1,8 +1,7 @@
1
1
  import { MAX_NOTE_HASHES_PER_TX } from '@aztec/constants';
2
+ import { range } from '@aztec/foundation/array';
2
3
  import { Fr } from '@aztec/foundation/curves/bn254';
3
4
 
4
- import type { AztecAddress } from '../aztec-address/index.js';
5
- import type { TxEffect } from '../tx/tx_effect.js';
6
5
  import type { TxHash } from '../tx/tx_hash.js';
7
6
 
8
7
  /**
@@ -19,7 +18,6 @@ export class MessageContext {
19
18
  public txHash: TxHash,
20
19
  public uniqueNoteHashesInTx: Fr[],
21
20
  public firstNullifierInTx: Fr,
22
- public recipient: AztecAddress,
23
21
  ) {}
24
22
 
25
23
  toFields(): Fr[] {
@@ -27,7 +25,6 @@ export class MessageContext {
27
25
  this.txHash.hash,
28
26
  ...serializeBoundedVec(this.uniqueNoteHashesInTx, MAX_NOTE_HASHES_PER_TX),
29
27
  this.firstNullifierInTx,
30
- this.recipient.toField(),
31
28
  ];
32
29
  }
33
30
 
@@ -37,13 +34,22 @@ export class MessageContext {
37
34
  tx_hash: this.txHash.hash,
38
35
  unique_note_hashes_in_tx: this.uniqueNoteHashesInTx,
39
36
  first_nullifier_in_tx: this.firstNullifierInTx,
40
- recipient: this.recipient,
41
37
  };
42
38
  /* eslint-enable camelcase */
43
39
  }
44
40
 
45
- static fromTxEffectAndRecipient(txEffect: TxEffect, recipient: AztecAddress): MessageContext {
46
- return new MessageContext(txEffect.txHash, txEffect.noteHashes, txEffect.nullifiers[0], recipient);
41
+ static toEmptyFields(): Fr[] {
42
+ const serializationLen =
43
+ 1 /* txHash */ + MAX_NOTE_HASHES_PER_TX + 1 /* uniqueNoteHashesInTx BVec */ + 1; /* firstNullifierInTx */
44
+ return range(serializationLen).map(_ => Fr.zero());
45
+ }
46
+
47
+ static toSerializedOption(response: MessageContext | null): Fr[] {
48
+ if (response) {
49
+ return [new Fr(1), ...response.toFields()];
50
+ } else {
51
+ return [new Fr(0), ...MessageContext.toEmptyFields()];
52
+ }
47
53
  }
48
54
  }
49
55
 
@@ -55,6 +61,10 @@ export class MessageContext {
55
61
  * @dev Copied over from pending_tagged_log.ts.
56
62
  */
57
63
  function serializeBoundedVec(values: Fr[], maxLength: number): Fr[] {
64
+ if (values.length > maxLength) {
65
+ throw new Error(`Attempted to serialize ${values} values into a BoundedVec with max length ${maxLength}`);
66
+ }
67
+
58
68
  const lengthDiff = maxLength - values.length;
59
69
  const zeroPaddingArray = Array(lengthDiff).fill(Fr.ZERO);
60
70
  const storage = values.concat(zeroPaddingArray);
@@ -1,7 +1,6 @@
1
1
  import { PRIVATE_LOG_SIZE_IN_FIELDS } from '@aztec/constants';
2
2
  import { Fr } from '@aztec/foundation/curves/bn254';
3
3
 
4
- import type { AztecAddress } from '../aztec-address/index.js';
5
4
  import type { TxHash } from '../tx/tx_hash.js';
6
5
  import { MessageContext } from './message_context.js';
7
6
 
@@ -17,9 +16,8 @@ export class PendingTaggedLog {
17
16
  txHash: TxHash,
18
17
  uniqueNoteHashesInTx: Fr[],
19
18
  firstNullifierInTx: Fr,
20
- recipient: AztecAddress,
21
19
  ) {
22
- this.context = new MessageContext(txHash, uniqueNoteHashesInTx, firstNullifierInTx, recipient);
20
+ this.context = new MessageContext(txHash, uniqueNoteHashesInTx, firstNullifierInTx);
23
21
  }
24
22
 
25
23
  toFields(): Fr[] {
@@ -1,26 +1,37 @@
1
+ import { DomainSeparator } from '@aztec/constants';
1
2
  import { Grumpkin } from '@aztec/foundation/crypto/grumpkin';
2
- import type { GrumpkinScalar, Point } from '@aztec/foundation/curves/grumpkin';
3
+ import { poseidon2HashWithSeparator } from '@aztec/foundation/crypto/poseidon';
4
+ import type { Fr } from '@aztec/foundation/curves/bn254';
5
+ import type { GrumpkinScalar } from '@aztec/foundation/curves/grumpkin';
3
6
 
7
+ import type { AztecAddress } from '../aztec-address/index.js';
4
8
  import type { PublicKey } from '../keys/public_key.js';
5
9
 
6
10
  /**
7
- * Derive an Elliptic Curve Diffie-Hellman (ECDH) Shared Secret.
8
- * The function takes in an ECDH public key, a private key, and a Grumpkin instance to compute
9
- * the shared secret.
11
+ * Derives an app-siloed ECDH shared secret.
12
+ *
13
+ * Computes the raw ECDH shared secret `S = secretKey * publicKey`, then app-silos it:
14
+ * `s_app = h(DOM_SEP__APP_SILOED_ECDH_SHARED_SECRET, S.x, S.y, contractAddress)`
10
15
  *
11
16
  * @param secretKey - The secret key used to derive shared secret.
12
17
  * @param publicKey - The public key used to derive shared secret.
13
- * @returns A derived shared secret.
18
+ * @param contractAddress - The address of the calling contract, used for app-siloing.
19
+ * @returns The app-siloed shared secret as a Field.
14
20
  * @throws If the publicKey is zero.
15
- *
16
- * TODO(#12656): This function is kept around because of the utilityGetSharedSecret oracle. Nuke this once returning
17
- * the app-siloed secret.
18
21
  */
19
- export function deriveEcdhSharedSecret(secretKey: GrumpkinScalar, publicKey: PublicKey): Promise<Point> {
22
+ export async function deriveAppSiloedSharedSecret(
23
+ secretKey: GrumpkinScalar,
24
+ publicKey: PublicKey,
25
+ contractAddress: AztecAddress,
26
+ ): Promise<Fr> {
20
27
  if (publicKey.isZero()) {
21
28
  throw new Error(
22
29
  `Attempting to derive a shared secret with a zero public key. You have probably passed a zero public key in your Noir code somewhere thinking that the note won't be broadcast... but it was.`,
23
30
  );
24
31
  }
25
- return Grumpkin.mul(publicKey, secretKey);
32
+ const rawSharedSecret = await Grumpkin.mul(publicKey, secretKey);
33
+ return poseidon2HashWithSeparator(
34
+ [rawSharedSecret.x, rawSharedSecret.y, contractAddress],
35
+ DomainSeparator.APP_SILOED_ECDH_SHARED_SECRET,
36
+ );
26
37
  }
@@ -1,8 +1,9 @@
1
+ import { DomainSeparator } from '@aztec/constants';
1
2
  import type { Fr } from '@aztec/foundation/curves/bn254';
2
3
  import type { ZodFor } from '@aztec/foundation/schemas';
3
4
 
4
5
  import type { AztecAddress } from '../aztec-address/index.js';
5
- import { computeSiloedPrivateLogFirstField } from '../hash/hash.js';
6
+ import { computeLogTag, computeSiloedPrivateLogFirstField } from '../hash/hash.js';
6
7
  import { schemas } from '../schemas/schemas.js';
7
8
  import type { PreTag } from './pre_tag.js';
8
9
  import { Tag } from './tag.js';
@@ -24,9 +25,13 @@ export class SiloedTag {
24
25
 
25
26
  static async compute(preTag: PreTag): Promise<SiloedTag> {
26
27
  const tag = await Tag.compute(preTag);
27
- return SiloedTag.computeFromTagAndApp(tag, preTag.extendedSecret.app);
28
+ const logTag = await computeLogTag(tag.value, DomainSeparator.UNCONSTRAINED_MSG_LOG_TAG);
29
+ return SiloedTag.computeFromTagAndApp(new Tag(logTag), preTag.extendedSecret.app);
28
30
  }
29
31
 
32
+ /**
33
+ * Unlike `compute`, this expects a tag whose value is already domain-separated.
34
+ */
30
35
  static async computeFromTagAndApp(tag: Tag, app: AztecAddress): Promise<SiloedTag> {
31
36
  const siloedTag = await computeSiloedPrivateLogFirstField(app, tag.value);
32
37
  return new SiloedTag(siloedTag);
@@ -0,0 +1,24 @@
1
+ import { schemas } from '@aztec/foundation/schemas';
2
+
3
+ import { z } from 'zod';
4
+
5
+ import {
6
+ type ExtendedDirectionalAppTaggingSecret,
7
+ ExtendedDirectionalAppTaggingSecretSchema,
8
+ } from './extended_directional_app_tagging_secret.js';
9
+
10
+ /**
11
+ * Represents a range of tagging indexes for a given extended directional app tagging secret. Used to track the lowest
12
+ * and highest indexes used in a transaction for a given (sender, recipient, app/contract) tuple.
13
+ */
14
+ export type TaggingIndexRange = {
15
+ extendedSecret: ExtendedDirectionalAppTaggingSecret;
16
+ lowestIndex: number;
17
+ highestIndex: number;
18
+ };
19
+
20
+ export const TaggingIndexRangeSchema = z.object({
21
+ extendedSecret: ExtendedDirectionalAppTaggingSecretSchema,
22
+ lowestIndex: schemas.Integer,
23
+ highestIndex: schemas.Integer,
24
+ });
@@ -1,4 +1,5 @@
1
1
  import { BlockNumber, BlockNumberSchema } from '@aztec/foundation/branded-types';
2
+ import { times } from '@aztec/foundation/collection';
2
3
  import { Fr } from '@aztec/foundation/curves/bn254';
3
4
  import { schemas as foundationSchemas } from '@aztec/foundation/schemas';
4
5
  import {
@@ -83,6 +84,21 @@ export class TxScopedL2Log {
83
84
  return new TxScopedL2Log(txHash, blockNumber, blockTimestamp, logData, noteHashes, firstNullifier);
84
85
  }
85
86
 
87
+ static getBlockNumberFromBuffer(buffer: Buffer) {
88
+ return BlockNumber(buffer.readUint32BE(Fr.SIZE_IN_BYTES));
89
+ }
90
+
91
+ static random() {
92
+ return new TxScopedL2Log(
93
+ TxHash.fromField(Fr.random()),
94
+ BlockNumber(Math.floor(Math.random() * 100000) + 1),
95
+ BigInt(Math.floor(Date.now() / 1000)),
96
+ times(3, Fr.random),
97
+ times(3, Fr.random),
98
+ Fr.random(),
99
+ );
100
+ }
101
+
86
102
  equals(other: TxScopedL2Log) {
87
103
  return (
88
104
  this.txHash.equals(other.txHash) &&
@@ -6,6 +6,7 @@ import { bufferToHex } from '@aztec/foundation/string';
6
6
  import { SiblingPath } from '@aztec/foundation/trees';
7
7
 
8
8
  import type { AztecAddress } from '../aztec-address/index.js';
9
+ import type { BlockParameter } from '../block/block_parameter.js';
9
10
  import { computeL1ToL2MessageNullifier } from '../hash/hash.js';
10
11
  import type { AztecNode } from '../interfaces/aztec-node.js';
11
12
  import { MerkleTreeId } from '../trees/merkle_tree_id.js';
@@ -79,20 +80,22 @@ export async function getNonNullifiedL1ToL2MessageWitness(
79
80
  contractAddress: AztecAddress,
80
81
  messageHash: Fr,
81
82
  secret: Fr,
83
+ referenceBlock: BlockParameter = 'latest',
82
84
  ): Promise<[bigint, SiblingPath<typeof L1_TO_L2_MSG_TREE_HEIGHT>]> {
83
- const response = await node.getL1ToL2MessageMembershipWitness('latest', messageHash);
84
- if (!response) {
85
- throw new Error(`No L1 to L2 message found for message hash ${messageHash.toString()}`);
86
- }
85
+ const messageNullifier = await computeL1ToL2MessageNullifier(contractAddress, messageHash, secret);
87
86
 
88
- const [messageIndex, siblingPath] = response;
87
+ const [l1ToL2Response, nullifierResponse] = await Promise.all([
88
+ node.getL1ToL2MessageMembershipWitness(referenceBlock, messageHash),
89
+ node.findLeavesIndexes(referenceBlock, MerkleTreeId.NULLIFIER_TREE, [messageNullifier]),
90
+ ]);
89
91
 
90
- const messageNullifier = await computeL1ToL2MessageNullifier(contractAddress, messageHash, secret);
92
+ if (!l1ToL2Response) {
93
+ throw new Error(`No L1 to L2 message found for message hash ${messageHash.toString()}`);
94
+ }
91
95
 
92
- const [nullifierIndex] = await node.findLeavesIndexes('latest', MerkleTreeId.NULLIFIER_TREE, [messageNullifier]);
93
- if (nullifierIndex !== undefined) {
96
+ if (nullifierResponse[0] !== undefined) {
94
97
  throw new Error(`No non-nullified L1 to L2 message found for message hash ${messageHash.toString()}`);
95
98
  }
96
99
 
97
- return [messageIndex, siblingPath];
100
+ return l1ToL2Response;
98
101
  }