@aztec/prover-client 5.0.0-private.20260319 → 5.0.0-rc.2

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 (87) hide show
  1. package/dest/config.d.ts +1 -1
  2. package/dest/config.d.ts.map +1 -1
  3. package/dest/config.js +16 -2
  4. package/dest/light/lightweight_checkpoint_builder.d.ts +1 -1
  5. package/dest/light/lightweight_checkpoint_builder.d.ts.map +1 -1
  6. package/dest/light/lightweight_checkpoint_builder.js +15 -5
  7. package/dest/mocks/test_context.d.ts +11 -11
  8. package/dest/mocks/test_context.d.ts.map +1 -1
  9. package/dest/mocks/test_context.js +25 -28
  10. package/dest/orchestrator/block-building-helpers.d.ts +1 -1
  11. package/dest/orchestrator/checkpoint-proving-state.d.ts +20 -36
  12. package/dest/orchestrator/checkpoint-proving-state.d.ts.map +1 -1
  13. package/dest/orchestrator/checkpoint-proving-state.js +22 -120
  14. package/dest/orchestrator/checkpoint-sub-tree-orchestrator.d.ts +161 -0
  15. package/dest/orchestrator/checkpoint-sub-tree-orchestrator.d.ts.map +1 -0
  16. package/dest/orchestrator/{orchestrator.js → checkpoint-sub-tree-orchestrator.js} +267 -451
  17. package/dest/orchestrator/chonk-cache.d.ts +39 -0
  18. package/dest/orchestrator/chonk-cache.d.ts.map +1 -0
  19. package/dest/orchestrator/chonk-cache.js +80 -0
  20. package/dest/orchestrator/index.d.ts +4 -2
  21. package/dest/orchestrator/index.d.ts.map +1 -1
  22. package/dest/orchestrator/index.js +3 -1
  23. package/dest/orchestrator/proving-scheduler.d.ts +81 -0
  24. package/dest/orchestrator/proving-scheduler.d.ts.map +1 -0
  25. package/dest/orchestrator/proving-scheduler.js +120 -0
  26. package/dest/orchestrator/top-tree-orchestrator.d.ts +88 -0
  27. package/dest/orchestrator/top-tree-orchestrator.d.ts.map +1 -0
  28. package/dest/orchestrator/top-tree-orchestrator.js +232 -0
  29. package/dest/orchestrator/top-tree-proving-state.d.ts +61 -0
  30. package/dest/orchestrator/top-tree-proving-state.d.ts.map +1 -0
  31. package/dest/orchestrator/top-tree-proving-state.js +185 -0
  32. package/dest/prover-client/prover-client.d.ts +61 -4
  33. package/dest/prover-client/prover-client.d.ts.map +1 -1
  34. package/dest/prover-client/prover-client.js +54 -7
  35. package/dest/proving_broker/broker_prover_facade.d.ts +1 -1
  36. package/dest/proving_broker/broker_prover_facade.d.ts.map +1 -1
  37. package/dest/proving_broker/broker_prover_facade.js +10 -16
  38. package/dest/proving_broker/config.d.ts +8 -72
  39. package/dest/proving_broker/config.d.ts.map +1 -1
  40. package/dest/proving_broker/config.js +2 -2
  41. package/dest/proving_broker/index.d.ts +2 -1
  42. package/dest/proving_broker/index.d.ts.map +1 -1
  43. package/dest/proving_broker/index.js +1 -0
  44. package/dest/proving_broker/proving_broker.d.ts +2 -2
  45. package/dest/proving_broker/proving_broker.d.ts.map +1 -1
  46. package/dest/proving_broker/proving_broker.js +32 -7
  47. package/dest/proving_broker/proving_broker_database/persisted.js +2 -2
  48. package/dest/proving_broker/rpc.d.ts +3 -1
  49. package/dest/proving_broker/rpc.d.ts.map +1 -1
  50. package/dest/proving_broker/rpc.js +80 -24
  51. package/dest/test/epoch_settlement.d.ts +36 -0
  52. package/dest/test/epoch_settlement.d.ts.map +1 -0
  53. package/dest/test/epoch_settlement.js +52 -0
  54. package/dest/test/index.d.ts +2 -0
  55. package/dest/test/index.d.ts.map +1 -0
  56. package/dest/test/index.js +1 -0
  57. package/dest/test/mock_prover.d.ts +3 -3
  58. package/package.json +19 -18
  59. package/src/config.ts +18 -2
  60. package/src/light/lightweight_checkpoint_builder.ts +16 -6
  61. package/src/mocks/test_context.ts +24 -41
  62. package/src/orchestrator/checkpoint-proving-state.ts +21 -162
  63. package/src/orchestrator/{orchestrator.ts → checkpoint-sub-tree-orchestrator.ts} +415 -661
  64. package/src/orchestrator/chonk-cache.ts +99 -0
  65. package/src/orchestrator/index.ts +8 -1
  66. package/src/orchestrator/proving-scheduler.ts +160 -0
  67. package/src/orchestrator/top-tree-orchestrator.ts +384 -0
  68. package/src/orchestrator/top-tree-proving-state.ts +219 -0
  69. package/src/prover-client/prover-client.ts +128 -18
  70. package/src/proving_broker/broker_prover_facade.ts +8 -16
  71. package/src/proving_broker/config.ts +2 -1
  72. package/src/proving_broker/index.ts +1 -0
  73. package/src/proving_broker/proving_broker.ts +27 -5
  74. package/src/proving_broker/proving_broker_database/persisted.ts +2 -2
  75. package/src/proving_broker/rpc.ts +36 -24
  76. package/src/test/epoch_settlement.ts +82 -0
  77. package/src/test/index.ts +1 -0
  78. package/dest/orchestrator/epoch-proving-state.d.ts +0 -75
  79. package/dest/orchestrator/epoch-proving-state.d.ts.map +0 -1
  80. package/dest/orchestrator/epoch-proving-state.js +0 -269
  81. package/dest/orchestrator/orchestrator.d.ts +0 -130
  82. package/dest/orchestrator/orchestrator.d.ts.map +0 -1
  83. package/dest/prover-client/server-epoch-prover.d.ts +0 -32
  84. package/dest/prover-client/server-epoch-prover.d.ts.map +0 -1
  85. package/dest/prover-client/server-epoch-prover.js +0 -40
  86. package/src/orchestrator/epoch-proving-state.ts +0 -380
  87. package/src/prover-client/server-epoch-prover.ts +0 -69
@@ -1,66 +1,30 @@
1
- import {
2
- BatchedBlobAccumulator,
3
- type FinalBlobBatchingChallenges,
4
- SpongeBlob,
5
- encodeCheckpointBlobDataFromBlocks,
6
- } from '@aztec/blob-lib';
1
+ import { SpongeBlob } from '@aztec/blob-lib';
7
2
  import {
8
3
  type ARCHIVE_HEIGHT,
9
- BLOBS_PER_CHECKPOINT,
10
- FIELDS_PER_BLOB,
11
4
  type L1_TO_L2_MSG_SUBTREE_ROOT_SIBLING_PATH_LENGTH,
12
5
  type NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH,
13
6
  NUM_MSGS_PER_BASE_PARITY,
14
- OUT_HASH_TREE_HEIGHT,
15
7
  } from '@aztec/constants';
16
8
  import { BlockNumber } from '@aztec/foundation/branded-types';
17
9
  import { padArrayEnd } from '@aztec/foundation/collection';
18
- import { BLS12Point } from '@aztec/foundation/curves/bls12';
19
10
  import { Fr } from '@aztec/foundation/curves/bn254';
20
11
  import type { Tuple } from '@aztec/foundation/serialize';
21
12
  import { type TreeNodeLocation, UnbalancedTreeStore } from '@aztec/foundation/trees';
22
13
  import type { PublicInputsAndRecursiveProof } from '@aztec/stdlib/interfaces/server';
23
- import { computeCheckpointOutHash } from '@aztec/stdlib/messaging';
24
14
  import { ParityBasePrivateInputs } from '@aztec/stdlib/parity';
25
- import {
26
- BlockMergeRollupPrivateInputs,
27
- BlockRollupPublicInputs,
28
- CheckpointConstantData,
29
- CheckpointRollupPublicInputs,
30
- CheckpointRootRollupHints,
31
- CheckpointRootRollupPrivateInputs,
32
- CheckpointRootSingleBlockRollupPrivateInputs,
33
- } from '@aztec/stdlib/rollup';
34
- import type { CircuitName } from '@aztec/stdlib/stats';
15
+ import { BlockMergeRollupPrivateInputs, BlockRollupPublicInputs, CheckpointConstantData } from '@aztec/stdlib/rollup';
35
16
  import type { AppendOnlyTreeSnapshot } from '@aztec/stdlib/trees';
36
17
  import type { BlockHeader } from '@aztec/stdlib/tx';
37
18
  import type { UInt64 } from '@aztec/stdlib/types';
38
19
 
39
- import { accumulateBlobs, buildBlobHints, toProofData } from './block-building-helpers.js';
20
+ import { toProofData } from './block-building-helpers.js';
40
21
  import { BlockProvingState, type ProofState } from './block-proving-state.js';
41
- import type { EpochProvingState } from './epoch-proving-state.js';
42
-
43
- type OutHashHint = {
44
- treeSnapshot: AppendOnlyTreeSnapshot;
45
- siblingPath: Tuple<Fr, typeof OUT_HASH_TREE_HEIGHT>;
46
- };
47
22
 
48
23
  export class CheckpointProvingState {
49
24
  private blockProofs: UnbalancedTreeStore<
50
25
  ProofState<BlockRollupPublicInputs, typeof NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH>
51
26
  >;
52
- private checkpointRootProof:
53
- | ProofState<CheckpointRollupPublicInputs, typeof NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH>
54
- | undefined;
55
27
  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;
61
- private startBlobAccumulator: BatchedBlobAccumulator | undefined;
62
- private endBlobAccumulator: BatchedBlobAccumulator | undefined;
63
- private blobFields: Fr[] | undefined;
64
28
  private error: string | undefined;
65
29
  public readonly firstBlockNumber: BlockNumber;
66
30
 
@@ -68,7 +32,6 @@ export class CheckpointProvingState {
68
32
  public readonly index: number,
69
33
  public readonly constants: CheckpointConstantData,
70
34
  public readonly totalNumBlocks: number,
71
- private readonly finalBlobBatchingChallenges: FinalBlobBatchingChallenges,
72
35
  private readonly headerOfLastBlockInPreviousCheckpoint: BlockHeader,
73
36
  private readonly lastArchiveSiblingPath: Tuple<Fr, typeof ARCHIVE_HEIGHT>,
74
37
  private readonly l1ToL2Messages: Fr[],
@@ -84,17 +47,16 @@ export class CheckpointProvingState {
84
47
  Fr,
85
48
  typeof L1_TO_L2_MSG_SUBTREE_ROOT_SIBLING_PATH_LENGTH
86
49
  >,
87
- public parentEpoch: EpochProvingState,
88
- private onBlobAccumulatorSet: (checkpoint: CheckpointProvingState) => Promise<void>,
50
+ public readonly epochNumber: number,
51
+ /** Owner's liveness check. `verifyState()` returns false once this returns false. */
52
+ private readonly isAlive: () => boolean,
53
+ /** Owner's failure callback. Invoked from `reject` to surface the error upward. */
54
+ private readonly onReject: (reason: string) => void,
89
55
  ) {
90
56
  this.blockProofs = new UnbalancedTreeStore(totalNumBlocks);
91
57
  this.firstBlockNumber = BlockNumber(headerOfLastBlockInPreviousCheckpoint.globalVariables.blockNumber + 1);
92
58
  }
93
59
 
94
- public get epochNumber(): number {
95
- return this.parentEpoch.epochNumber;
96
- }
97
-
98
60
  public startNewBlock(
99
61
  blockNumber: BlockNumber,
100
62
  timestamp: UInt64,
@@ -176,25 +138,6 @@ export class CheckpointProvingState {
176
138
  this.blockProofs.setNode(location, { provingOutput });
177
139
  }
178
140
 
179
- public tryStartProvingCheckpointRoot() {
180
- if (this.checkpointRootProof?.isProving) {
181
- return false;
182
- } else {
183
- this.checkpointRootProof = { isProving: true };
184
- return true;
185
- }
186
- }
187
-
188
- public setCheckpointRootRollupProof(
189
- provingOutput: PublicInputsAndRecursiveProof<
190
- CheckpointRollupPublicInputs,
191
- typeof NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH
192
- >,
193
- ): TreeNodeLocation {
194
- this.checkpointRootProof = { provingOutput };
195
- return this.parentEpoch.setCheckpointRootRollupProof(this.index, provingOutput);
196
- }
197
-
198
141
  public getBaseParityInputs(baseParityIndex: number) {
199
142
  const messages = padArrayEnd(
200
143
  this.l1ToL2Messages.slice(
@@ -204,54 +147,7 @@ export class CheckpointProvingState {
204
147
  Fr.ZERO,
205
148
  NUM_MSGS_PER_BASE_PARITY,
206
149
  );
207
- return new ParityBasePrivateInputs(messages, this.constants.vkTreeRoot);
208
- }
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
-
239
- public async accumulateBlobs(startBlobAccumulator: BatchedBlobAccumulator) {
240
- if (this.isAcceptingBlocks() || this.blocks.some(b => !b?.hasEndState())) {
241
- return;
242
- }
243
-
244
- this.blobFields = encodeCheckpointBlobDataFromBlocks(this.blocks.map(b => b!.getBlockBlobData()));
245
- this.endBlobAccumulator = await accumulateBlobs(this.blobFields!, startBlobAccumulator);
246
- this.startBlobAccumulator = startBlobAccumulator;
247
-
248
- await this.onBlobAccumulatorSet(this);
249
-
250
- return this.endBlobAccumulator;
251
- }
252
-
253
- public getEndBlobAccumulator() {
254
- return this.endBlobAccumulator;
150
+ return new ParityBasePrivateInputs(messages, this.constants.vkTreeRoot, this.constants.proverId);
255
151
  }
256
152
 
257
153
  public getParentLocation(location: TreeNodeLocation) {
@@ -267,47 +163,6 @@ export class CheckpointProvingState {
267
163
  return new BlockMergeRollupPrivateInputs([toProofData(left), toProofData(right)]);
268
164
  }
269
165
 
270
- public getCheckpointRootRollupType(): CircuitName {
271
- return this.totalNumBlocks === 1 ? 'rollup-checkpoint-root-single-block' : 'rollup-checkpoint-root';
272
- }
273
-
274
- public async getCheckpointRootRollupInputs() {
275
- const proofs = this.#getChildProofsForRoot();
276
- const nonEmptyProofs = proofs.filter(p => !!p);
277
- if (proofs.length !== nonEmptyProofs.length) {
278
- throw new Error('At least one child is not ready for the checkpoint root rollup.');
279
- }
280
- if (!this.previousOutHashHint) {
281
- throw new Error('Out hash hint is not set.');
282
- }
283
- if (!this.startBlobAccumulator) {
284
- throw new Error('Start blob accumulator is not set.');
285
- }
286
-
287
- // `blobFields` must've been set if `startBlobAccumulator` is set (in `accumulateBlobs`).
288
- const blobFields = this.blobFields!;
289
-
290
- const { blobCommitments, blobsHash } = await buildBlobHints(blobFields);
291
-
292
- const hints = CheckpointRootRollupHints.from({
293
- previousBlockHeader: this.headerOfLastBlockInPreviousCheckpoint,
294
- previousArchiveSiblingPath: this.lastArchiveSiblingPath,
295
- previousOutHash: this.previousOutHashHint.treeSnapshot,
296
- newOutHashSiblingPath: this.previousOutHashHint.siblingPath,
297
- startBlobAccumulator: this.startBlobAccumulator.toBlobAccumulator(),
298
- finalBlobChallenges: this.finalBlobBatchingChallenges,
299
- blobFields: padArrayEnd(blobFields, Fr.ZERO, FIELDS_PER_BLOB * BLOBS_PER_CHECKPOINT),
300
- blobCommitments: padArrayEnd(blobCommitments, BLS12Point.ZERO, BLOBS_PER_CHECKPOINT),
301
- blobsHash,
302
- });
303
-
304
- const [left, right] = nonEmptyProofs.map(p => toProofData(p));
305
-
306
- return !right
307
- ? new CheckpointRootSingleBlockRollupPrivateInputs(left, hints)
308
- : new CheckpointRootRollupPrivateInputs([left, right], hints);
309
- }
310
-
311
166
  public getBlockProvingStateByBlockNumber(blockNumber: BlockNumber) {
312
167
  const index = Number(blockNumber) - Number(this.firstBlockNumber);
313
168
  return this.blocks[index];
@@ -317,13 +172,8 @@ export class CheckpointProvingState {
317
172
  return !!this.blockProofs.getSibling(location)?.provingOutput;
318
173
  }
319
174
 
320
- public isReadyForCheckpointRoot() {
321
- const allChildProofsReady = this.#getChildProofsForRoot().every(p => !!p);
322
- return allChildProofsReady && !!this.previousOutHashHint && !!this.startBlobAccumulator;
323
- }
324
-
325
175
  public verifyState() {
326
- return this.parentEpoch.verifyState();
176
+ return this.isAlive();
327
177
  }
328
178
 
329
179
  public getError() {
@@ -337,13 +187,22 @@ export class CheckpointProvingState {
337
187
 
338
188
  public reject(reason: string) {
339
189
  this.error = reason;
340
- this.parentEpoch.reject(reason);
190
+ this.onReject(reason);
341
191
  }
342
192
 
343
- #getChildProofsForRoot() {
193
+ /**
194
+ * Returns the block-level proof outputs that feed into the checkpoint root rollup.
195
+ * Used by `CheckpointSubTreeOrchestrator` to surface its sub-tree result.
196
+ */
197
+ public getSubTreeOutputProofs() {
344
198
  const rootLocation = { level: 0, index: 0 };
345
199
  return this.totalNumBlocks === 1
346
200
  ? [this.blockProofs.getNode(rootLocation)?.provingOutput] // If there's only 1 block, its proof will be stored at the root.
347
201
  : this.blockProofs.getChildren(rootLocation).map(c => c?.provingOutput);
348
202
  }
203
+
204
+ /** Sibling path of the archive tree captured before any block in this checkpoint landed. */
205
+ public getLastArchiveSiblingPath() {
206
+ return this.lastArchiveSiblingPath;
207
+ }
349
208
  }