@aztec/prover-client 3.0.3 → 4.0.0-devnet.1-patch.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (113) hide show
  1. package/dest/light/index.d.ts +2 -0
  2. package/dest/light/index.d.ts.map +1 -0
  3. package/dest/light/index.js +1 -0
  4. package/dest/light/lightweight_checkpoint_builder.d.ts +32 -14
  5. package/dest/light/lightweight_checkpoint_builder.d.ts.map +1 -1
  6. package/dest/light/lightweight_checkpoint_builder.js +115 -23
  7. package/dest/mocks/fixtures.d.ts +1 -1
  8. package/dest/mocks/fixtures.d.ts.map +1 -1
  9. package/dest/mocks/fixtures.js +2 -1
  10. package/dest/mocks/test_context.d.ts +4 -2
  11. package/dest/mocks/test_context.d.ts.map +1 -1
  12. package/dest/mocks/test_context.js +18 -4
  13. package/dest/orchestrator/block-building-helpers.d.ts +2 -2
  14. package/dest/orchestrator/block-building-helpers.js +2 -2
  15. package/dest/orchestrator/checkpoint-proving-state.d.ts +15 -2
  16. package/dest/orchestrator/checkpoint-proving-state.d.ts.map +1 -1
  17. package/dest/orchestrator/checkpoint-proving-state.js +34 -1
  18. package/dest/orchestrator/epoch-proving-state.d.ts +6 -5
  19. package/dest/orchestrator/epoch-proving-state.d.ts.map +1 -1
  20. package/dest/orchestrator/epoch-proving-state.js +37 -1
  21. package/dest/orchestrator/orchestrator.d.ts +19 -4
  22. package/dest/orchestrator/orchestrator.d.ts.map +1 -1
  23. package/dest/orchestrator/orchestrator.js +534 -133
  24. package/dest/orchestrator/orchestrator_metrics.d.ts +1 -3
  25. package/dest/orchestrator/orchestrator_metrics.d.ts.map +1 -1
  26. package/dest/orchestrator/orchestrator_metrics.js +2 -15
  27. package/dest/orchestrator/tx-proving-state.d.ts +5 -4
  28. package/dest/orchestrator/tx-proving-state.d.ts.map +1 -1
  29. package/dest/orchestrator/tx-proving-state.js +6 -6
  30. package/dest/prover-client/factory.d.ts +3 -3
  31. package/dest/prover-client/factory.d.ts.map +1 -1
  32. package/dest/prover-client/prover-client.d.ts +5 -5
  33. package/dest/prover-client/prover-client.d.ts.map +1 -1
  34. package/dest/prover-client/prover-client.js +15 -10
  35. package/dest/proving_broker/broker_prover_facade.d.ts +7 -5
  36. package/dest/proving_broker/broker_prover_facade.d.ts.map +1 -1
  37. package/dest/proving_broker/broker_prover_facade.js +5 -12
  38. package/dest/proving_broker/config.d.ts +13 -1
  39. package/dest/proving_broker/config.d.ts.map +1 -1
  40. package/dest/proving_broker/config.js +19 -2
  41. package/dest/proving_broker/proof_store/factory.d.ts +2 -5
  42. package/dest/proving_broker/proof_store/factory.d.ts.map +1 -1
  43. package/dest/proving_broker/proof_store/factory.js +7 -30
  44. package/dest/proving_broker/proof_store/file_store_proof_store.d.ts +18 -0
  45. package/dest/proving_broker/proof_store/file_store_proof_store.d.ts.map +1 -0
  46. package/dest/proving_broker/proof_store/file_store_proof_store.js +60 -0
  47. package/dest/proving_broker/proof_store/index.d.ts +2 -2
  48. package/dest/proving_broker/proof_store/index.d.ts.map +1 -1
  49. package/dest/proving_broker/proof_store/index.js +1 -1
  50. package/dest/proving_broker/proving_agent.d.ts +5 -9
  51. package/dest/proving_broker/proving_agent.d.ts.map +1 -1
  52. package/dest/proving_broker/proving_agent.js +4 -19
  53. package/dest/proving_broker/proving_broker.d.ts +7 -4
  54. package/dest/proving_broker/proving_broker.d.ts.map +1 -1
  55. package/dest/proving_broker/proving_broker.js +33 -11
  56. package/dest/proving_broker/proving_broker_database/persisted.d.ts +3 -2
  57. package/dest/proving_broker/proving_broker_database/persisted.d.ts.map +1 -1
  58. package/dest/proving_broker/proving_broker_database/persisted.js +389 -1
  59. package/dest/proving_broker/proving_broker_instrumentation.d.ts +1 -1
  60. package/dest/proving_broker/proving_broker_instrumentation.d.ts.map +1 -1
  61. package/dest/proving_broker/proving_broker_instrumentation.js +15 -35
  62. package/dest/proving_broker/proving_job_controller.d.ts +4 -3
  63. package/dest/proving_broker/proving_job_controller.d.ts.map +1 -1
  64. package/dest/proving_broker/proving_job_controller.js +7 -5
  65. package/dest/proving_broker/rpc.d.ts +4 -2
  66. package/dest/proving_broker/rpc.d.ts.map +1 -1
  67. package/dest/proving_broker/rpc.js +8 -0
  68. package/dest/test/mock_proof_store.d.ts +3 -3
  69. package/dest/test/mock_proof_store.d.ts.map +1 -1
  70. package/dest/test/mock_prover.d.ts +5 -5
  71. package/dest/test/mock_prover.d.ts.map +1 -1
  72. package/dest/test/mock_prover.js +4 -4
  73. package/package.json +17 -17
  74. package/src/light/index.ts +1 -0
  75. package/src/light/lightweight_checkpoint_builder.ts +176 -31
  76. package/src/mocks/fixtures.ts +2 -1
  77. package/src/mocks/test_context.ts +15 -2
  78. package/src/orchestrator/block-building-helpers.ts +2 -2
  79. package/src/orchestrator/checkpoint-proving-state.ts +47 -1
  80. package/src/orchestrator/epoch-proving-state.ts +58 -8
  81. package/src/orchestrator/orchestrator.ts +129 -113
  82. package/src/orchestrator/orchestrator_metrics.ts +2 -25
  83. package/src/orchestrator/tx-proving-state.ts +8 -11
  84. package/src/prover-client/factory.ts +6 -2
  85. package/src/prover-client/prover-client.ts +31 -23
  86. package/src/proving_broker/broker_prover_facade.ts +9 -16
  87. package/src/proving_broker/config.ts +22 -0
  88. package/src/proving_broker/proof_store/factory.ts +10 -32
  89. package/src/proving_broker/proof_store/file_store_proof_store.ts +78 -0
  90. package/src/proving_broker/proof_store/index.ts +1 -1
  91. package/src/proving_broker/proving_agent.ts +6 -19
  92. package/src/proving_broker/proving_broker.ts +34 -9
  93. package/src/proving_broker/proving_broker_database/persisted.ts +15 -1
  94. package/src/proving_broker/proving_broker_instrumentation.ts +14 -35
  95. package/src/proving_broker/proving_job_controller.ts +10 -5
  96. package/src/proving_broker/rpc.ts +14 -0
  97. package/src/test/mock_prover.ts +2 -14
  98. package/dest/block-factory/index.d.ts +0 -2
  99. package/dest/block-factory/index.d.ts.map +0 -1
  100. package/dest/block-factory/index.js +0 -1
  101. package/dest/block-factory/light.d.ts +0 -38
  102. package/dest/block-factory/light.d.ts.map +0 -1
  103. package/dest/block-factory/light.js +0 -108
  104. package/dest/proving_broker/proof_store/gcs_proof_store.d.ts +0 -14
  105. package/dest/proving_broker/proof_store/gcs_proof_store.d.ts.map +0 -1
  106. package/dest/proving_broker/proof_store/gcs_proof_store.js +0 -52
  107. package/dest/proving_broker/proving_agent_instrumentation.d.ts +0 -8
  108. package/dest/proving_broker/proving_agent_instrumentation.d.ts.map +0 -1
  109. package/dest/proving_broker/proving_agent_instrumentation.js +0 -16
  110. package/src/block-factory/index.ts +0 -1
  111. package/src/block-factory/light.ts +0 -137
  112. package/src/proving_broker/proof_store/gcs_proof_store.ts +0 -76
  113. package/src/proving_broker/proving_agent_instrumentation.ts +0 -21
@@ -11,6 +11,7 @@ import {
11
11
  type L1_TO_L2_MSG_SUBTREE_ROOT_SIBLING_PATH_LENGTH,
12
12
  type NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH,
13
13
  NUM_MSGS_PER_BASE_PARITY,
14
+ OUT_HASH_TREE_HEIGHT,
14
15
  } from '@aztec/constants';
15
16
  import { BlockNumber } from '@aztec/foundation/branded-types';
16
17
  import { padArrayEnd } from '@aztec/foundation/collection';
@@ -19,6 +20,7 @@ import { Fr } from '@aztec/foundation/curves/bn254';
19
20
  import type { Tuple } from '@aztec/foundation/serialize';
20
21
  import { type TreeNodeLocation, UnbalancedTreeStore } from '@aztec/foundation/trees';
21
22
  import type { PublicInputsAndRecursiveProof } from '@aztec/stdlib/interfaces/server';
23
+ import { computeCheckpointOutHash } from '@aztec/stdlib/messaging';
22
24
  import { ParityBasePrivateInputs } from '@aztec/stdlib/parity';
23
25
  import {
24
26
  BlockMergeRollupPrivateInputs,
@@ -38,6 +40,11 @@ import { accumulateBlobs, buildBlobHints, toProofData } from './block-building-h
38
40
  import { BlockProvingState, type ProofState } from './block-proving-state.js';
39
41
  import type { EpochProvingState } from './epoch-proving-state.js';
40
42
 
43
+ type OutHashHint = {
44
+ treeSnapshot: AppendOnlyTreeSnapshot;
45
+ siblingPath: Tuple<Fr, typeof OUT_HASH_TREE_HEIGHT>;
46
+ };
47
+
41
48
  export class CheckpointProvingState {
42
49
  private blockProofs: UnbalancedTreeStore<
43
50
  ProofState<BlockRollupPublicInputs, typeof NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH>
@@ -46,6 +53,11 @@ export class CheckpointProvingState {
46
53
  | ProofState<CheckpointRollupPublicInputs, typeof NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH>
47
54
  | undefined;
48
55
  private blocks: (BlockProvingState | undefined)[] = [];
56
+ private previousOutHashHint: OutHashHint | undefined;
57
+ private outHash: Fr | undefined;
58
+ // The snapshot and sibling path after the checkpoint's out hash is inserted.
59
+ // Stored here to be retrieved for the next checkpoint when it's added.
60
+ private newOutHashHint: OutHashHint | undefined;
49
61
  private startBlobAccumulator: BatchedBlobAccumulator | undefined;
50
62
  private endBlobAccumulator: BatchedBlobAccumulator | undefined;
51
63
  private blobFields: Fr[] | undefined;
@@ -195,6 +207,35 @@ export class CheckpointProvingState {
195
207
  return new ParityBasePrivateInputs(messages, this.constants.vkTreeRoot);
196
208
  }
197
209
 
210
+ public setOutHashHint(hint: OutHashHint) {
211
+ this.previousOutHashHint = hint;
212
+ }
213
+
214
+ public getOutHashHint() {
215
+ return this.previousOutHashHint;
216
+ }
217
+
218
+ public accumulateBlockOutHashes() {
219
+ if (this.isAcceptingBlocks() || this.blocks.some(b => !b?.hasEndState())) {
220
+ return;
221
+ }
222
+
223
+ if (!this.outHash) {
224
+ const messagesPerBlock = this.blocks.map(b => b!.getTxEffects().map(tx => tx.l2ToL1Msgs));
225
+ this.outHash = computeCheckpointOutHash(messagesPerBlock);
226
+ }
227
+
228
+ return this.outHash;
229
+ }
230
+
231
+ public setOutHashHintForNextCheckpoint(hint: OutHashHint) {
232
+ this.newOutHashHint = hint;
233
+ }
234
+
235
+ public getOutHashHintForNextCheckpoint() {
236
+ return this.newOutHashHint;
237
+ }
238
+
198
239
  public async accumulateBlobs(startBlobAccumulator: BatchedBlobAccumulator) {
199
240
  if (this.isAcceptingBlocks() || this.blocks.some(b => !b?.hasEndState())) {
200
241
  return;
@@ -236,6 +277,9 @@ export class CheckpointProvingState {
236
277
  if (proofs.length !== nonEmptyProofs.length) {
237
278
  throw new Error('At least one child is not ready for the checkpoint root rollup.');
238
279
  }
280
+ if (!this.previousOutHashHint) {
281
+ throw new Error('Out hash hint is not set.');
282
+ }
239
283
  if (!this.startBlobAccumulator) {
240
284
  throw new Error('Start blob accumulator is not set.');
241
285
  }
@@ -248,6 +292,8 @@ export class CheckpointProvingState {
248
292
  const hints = CheckpointRootRollupHints.from({
249
293
  previousBlockHeader: this.headerOfLastBlockInPreviousCheckpoint,
250
294
  previousArchiveSiblingPath: this.lastArchiveSiblingPath,
295
+ previousOutHash: this.previousOutHashHint.treeSnapshot,
296
+ newOutHashSiblingPath: this.previousOutHashHint.siblingPath,
251
297
  startBlobAccumulator: this.startBlobAccumulator.toBlobAccumulator(),
252
298
  finalBlobChallenges: this.finalBlobBatchingChallenges,
253
299
  blobFields: padArrayEnd(blobFields, Fr.ZERO, FIELDS_PER_BLOB * BLOBS_PER_CHECKPOINT),
@@ -273,7 +319,7 @@ export class CheckpointProvingState {
273
319
 
274
320
  public isReadyForCheckpointRoot() {
275
321
  const allChildProofsReady = this.#getChildProofsForRoot().every(p => !!p);
276
- return allChildProofsReady && !!this.startBlobAccumulator;
322
+ return allChildProofsReady && !!this.previousOutHashHint && !!this.startBlobAccumulator;
277
323
  }
278
324
 
279
325
  public verifyState() {
@@ -1,14 +1,20 @@
1
1
  import { BatchedBlob, BatchedBlobAccumulator, type FinalBlobBatchingChallenges } from '@aztec/blob-lib';
2
- import type {
3
- ARCHIVE_HEIGHT,
4
- L1_TO_L2_MSG_SUBTREE_ROOT_SIBLING_PATH_LENGTH,
5
- NESTED_RECURSIVE_PROOF_LENGTH,
6
- NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH,
2
+ import {
3
+ type ARCHIVE_HEIGHT,
4
+ type L1_TO_L2_MSG_SUBTREE_ROOT_SIBLING_PATH_LENGTH,
5
+ type NESTED_RECURSIVE_PROOF_LENGTH,
6
+ type NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH,
7
+ OUT_HASH_TREE_HEIGHT,
7
8
  } from '@aztec/constants';
8
9
  import { BlockNumber, EpochNumber } from '@aztec/foundation/branded-types';
9
- import type { Fr } from '@aztec/foundation/curves/bn254';
10
+ import { Fr } from '@aztec/foundation/curves/bn254';
10
11
  import type { Tuple } from '@aztec/foundation/serialize';
11
- import { type TreeNodeLocation, UnbalancedTreeStore } from '@aztec/foundation/trees';
12
+ import {
13
+ MerkleTreeCalculator,
14
+ type TreeNodeLocation,
15
+ UnbalancedTreeStore,
16
+ shaMerkleHash,
17
+ } from '@aztec/foundation/trees';
12
18
  import type { PublicInputsAndRecursiveProof } from '@aztec/stdlib/interfaces/server';
13
19
  import type { Proof } from '@aztec/stdlib/proofs';
14
20
  import {
@@ -20,7 +26,7 @@ import {
20
26
  RootRollupPrivateInputs,
21
27
  type RootRollupPublicInputs,
22
28
  } from '@aztec/stdlib/rollup';
23
- import type { AppendOnlyTreeSnapshot, MerkleTreeId } from '@aztec/stdlib/trees';
29
+ import { AppendOnlyTreeSnapshot, type MerkleTreeId } from '@aztec/stdlib/trees';
24
30
  import type { BlockHeader } from '@aztec/stdlib/tx';
25
31
 
26
32
  import { toProofData } from './block-building-helpers.js';
@@ -212,6 +218,50 @@ export class EpochProvingState {
212
218
  this.checkpointPaddingProof = { provingOutput };
213
219
  }
214
220
 
221
+ public async accumulateCheckpointOutHashes() {
222
+ const treeCalculator = await MerkleTreeCalculator.create(OUT_HASH_TREE_HEIGHT, undefined, (left, right) =>
223
+ Promise.resolve(shaMerkleHash(left, right)),
224
+ );
225
+
226
+ const computeOutHashHint = async (leaves: Fr[]) => {
227
+ const tree = await treeCalculator.computeTree(leaves.map(l => l.toBuffer()));
228
+ const nextAvailableLeafIndex = leaves.length;
229
+ return {
230
+ treeSnapshot: new AppendOnlyTreeSnapshot(Fr.fromBuffer(tree.root), nextAvailableLeafIndex),
231
+ siblingPath: tree.getSiblingPath(nextAvailableLeafIndex).map(Fr.fromBuffer) as Tuple<
232
+ Fr,
233
+ typeof OUT_HASH_TREE_HEIGHT
234
+ >,
235
+ };
236
+ };
237
+
238
+ let hint = this.checkpoints[0]?.getOutHashHint();
239
+ const outHashes = [];
240
+ for (let i = 0; i < this.totalNumCheckpoints; i++) {
241
+ const checkpoint = this.checkpoints[i];
242
+ if (!checkpoint) {
243
+ break;
244
+ }
245
+
246
+ // If hints are not set yet, it must be the first checkpoint. Compute the hints with an empty tree.
247
+ hint ??= await computeOutHashHint([]);
248
+ checkpoint.setOutHashHint(hint);
249
+
250
+ // Get the out hash for this checkpoint.
251
+ const outHash = checkpoint.accumulateBlockOutHashes();
252
+ if (!outHash) {
253
+ break;
254
+ }
255
+ outHashes.push(outHash);
256
+
257
+ // If this is NOT the last checkpoint, get or create the hint for the next checkpoint.
258
+ if (i !== this.totalNumCheckpoints - 1) {
259
+ hint = checkpoint.getOutHashHintForNextCheckpoint() ?? (await computeOutHashHint(outHashes));
260
+ checkpoint.setOutHashHintForNextCheckpoint(hint);
261
+ }
262
+ }
263
+ }
264
+
215
265
  public async setBlobAccumulators() {
216
266
  let previousAccumulator = this.startBlobAccumulator;
217
267
  // Accumulate blobs as far as we can for this epoch.