@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
@@ -0,0 +1,219 @@
1
+ import type { BatchedBlob, BatchedBlobAccumulator, FinalBlobBatchingChallenges } from '@aztec/blob-lib';
2
+ import type { NESTED_RECURSIVE_PROOF_LENGTH, NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH } from '@aztec/constants';
3
+ import { EpochNumber } from '@aztec/foundation/branded-types';
4
+ import { type TreeNodeLocation, UnbalancedTreeStore } from '@aztec/foundation/trees';
5
+ import type { PublicInputsAndRecursiveProof } from '@aztec/stdlib/interfaces/server';
6
+ import type { Proof } from '@aztec/stdlib/proofs';
7
+ import {
8
+ CheckpointMergeRollupPrivateInputs,
9
+ CheckpointPaddingRollupPrivateInputs,
10
+ CheckpointRollupPublicInputs,
11
+ RootRollupPrivateInputs,
12
+ type RootRollupPublicInputs,
13
+ } from '@aztec/stdlib/rollup';
14
+
15
+ import { toProofData } from './block-building-helpers.js';
16
+ import type { ProofState } from './block-proving-state.js';
17
+
18
+ enum TOP_TREE_LIFECYCLE {
19
+ CREATED,
20
+ RESOLVED,
21
+ REJECTED,
22
+ }
23
+
24
+ /**
25
+ * Lean top-tree-only state. Owns the merge tree of checkpoint root proofs, the
26
+ * single-checkpoint padding proof slot, the final root rollup proof, and the blob
27
+ * accumulator endpoints needed to finalise the epoch's batched blob proof.
28
+ *
29
+ * Constructed with `totalNumCheckpoints` and `finalBlobBatchingChallenges` upfront —
30
+ * by the time the top tree starts, all checkpoints are known and the challenges are
31
+ * derivable from their blob fields.
32
+ */
33
+ export class TopTreeProvingState {
34
+ private checkpointProofs: UnbalancedTreeStore<
35
+ ProofState<CheckpointRollupPublicInputs, typeof NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH>
36
+ >;
37
+ private checkpointPaddingProof:
38
+ | ProofState<CheckpointRollupPublicInputs, typeof NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH>
39
+ | undefined;
40
+ private rootRollupProof: ProofState<RootRollupPublicInputs, typeof NESTED_RECURSIVE_PROOF_LENGTH> | undefined;
41
+ private endBlobAccumulator: BatchedBlobAccumulator | undefined;
42
+ private finalBatchedBlob: BatchedBlob | undefined;
43
+ private lifecycle = TOP_TREE_LIFECYCLE.CREATED;
44
+ constructor(
45
+ public readonly epochNumber: EpochNumber,
46
+ public readonly totalNumCheckpoints: number,
47
+ public readonly finalBlobBatchingChallenges: FinalBlobBatchingChallenges,
48
+ public readonly startBlobAccumulator: BatchedBlobAccumulator,
49
+ private readonly completionCallback: () => void,
50
+ private readonly rejectionCallback: (reason: string) => void,
51
+ ) {
52
+ if (totalNumCheckpoints < 1) {
53
+ throw new Error(`TopTreeProvingState requires at least one checkpoint; got ${totalNumCheckpoints}.`);
54
+ }
55
+ this.checkpointProofs = new UnbalancedTreeStore(totalNumCheckpoints);
56
+ }
57
+
58
+ // --- checkpoint root rollup ---
59
+
60
+ public setCheckpointRootRollupProof(
61
+ checkpointIndex: number,
62
+ provingOutput: PublicInputsAndRecursiveProof<
63
+ CheckpointRollupPublicInputs,
64
+ typeof NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH
65
+ >,
66
+ ): TreeNodeLocation {
67
+ return this.checkpointProofs.setLeaf(checkpointIndex, { provingOutput });
68
+ }
69
+
70
+ // --- checkpoint merge rollup ---
71
+
72
+ public tryStartProvingCheckpointMerge(location: TreeNodeLocation) {
73
+ if (this.checkpointProofs.getNode(location)?.isProving) {
74
+ return false;
75
+ }
76
+ this.checkpointProofs.setNode(location, { isProving: true });
77
+ return true;
78
+ }
79
+
80
+ public setCheckpointMergeRollupProof(
81
+ location: TreeNodeLocation,
82
+ provingOutput: PublicInputsAndRecursiveProof<
83
+ CheckpointRollupPublicInputs,
84
+ typeof NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH
85
+ >,
86
+ ) {
87
+ this.checkpointProofs.setNode(location, { provingOutput });
88
+ }
89
+
90
+ public isReadyForCheckpointMerge(location: TreeNodeLocation) {
91
+ return !!this.checkpointProofs.getSibling(location)?.provingOutput;
92
+ }
93
+
94
+ public getParentLocation(location: TreeNodeLocation) {
95
+ return this.checkpointProofs.getParentLocation(location);
96
+ }
97
+
98
+ public getCheckpointMergeRollupInputs(mergeLocation: TreeNodeLocation) {
99
+ const [left, right] = this.checkpointProofs.getChildren(mergeLocation).map(c => c?.provingOutput);
100
+ if (!left || !right) {
101
+ throw new Error('At least one child is not ready for the checkpoint merge rollup.');
102
+ }
103
+ return new CheckpointMergeRollupPrivateInputs([toProofData(left), toProofData(right)]);
104
+ }
105
+
106
+ // --- padding (single-checkpoint case) ---
107
+
108
+ public tryStartProvingPaddingCheckpoint() {
109
+ if (this.checkpointPaddingProof?.isProving) {
110
+ return false;
111
+ }
112
+ this.checkpointPaddingProof = { isProving: true };
113
+ return true;
114
+ }
115
+
116
+ public setCheckpointPaddingProof(
117
+ provingOutput: PublicInputsAndRecursiveProof<
118
+ CheckpointRollupPublicInputs,
119
+ typeof NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH
120
+ >,
121
+ ) {
122
+ this.checkpointPaddingProof = { provingOutput };
123
+ }
124
+
125
+ public getPaddingCheckpointInputs() {
126
+ return new CheckpointPaddingRollupPrivateInputs();
127
+ }
128
+
129
+ // --- root rollup ---
130
+
131
+ public tryStartProvingRootRollup() {
132
+ if (this.rootRollupProof?.isProving) {
133
+ return false;
134
+ }
135
+ this.rootRollupProof = { isProving: true };
136
+ return true;
137
+ }
138
+
139
+ public setRootRollupProof(provingOutput: PublicInputsAndRecursiveProof<RootRollupPublicInputs>) {
140
+ this.rootRollupProof = { provingOutput };
141
+ }
142
+
143
+ public isReadyForRootRollup() {
144
+ const childProofs = this.#getChildProofsForRoot();
145
+ return childProofs.every(p => !!p);
146
+ }
147
+
148
+ public getRootRollupInputs() {
149
+ const [left, right] = this.#getChildProofsForRoot();
150
+ if (!left || !right) {
151
+ throw new Error('At least one child is not ready for the root rollup.');
152
+ }
153
+ return RootRollupPrivateInputs.from({
154
+ previousRollups: [toProofData(left), toProofData(right)],
155
+ });
156
+ }
157
+
158
+ // --- blob accumulator finalisation ---
159
+
160
+ /**
161
+ * Sets the end-of-epoch blob accumulator, computed by the top-tree orchestrator
162
+ * from the surviving checkpoints' blob fields. Required before `finalizeBatchedBlob`.
163
+ */
164
+ public setEndBlobAccumulator(accumulator: BatchedBlobAccumulator) {
165
+ this.endBlobAccumulator = accumulator;
166
+ }
167
+
168
+ public async finalizeBatchedBlob() {
169
+ if (!this.endBlobAccumulator) {
170
+ throw new Error('End blob accumulator not set; call setEndBlobAccumulator before finalize.');
171
+ }
172
+ this.finalBatchedBlob = await this.endBlobAccumulator.finalize(true /* verifyProof */);
173
+ }
174
+
175
+ public getEpochProofResult(): { proof: Proof; publicInputs: RootRollupPublicInputs; batchedBlobInputs: BatchedBlob } {
176
+ const provingOutput = this.rootRollupProof?.provingOutput;
177
+ if (!provingOutput || !this.finalBatchedBlob) {
178
+ throw new Error('Top-tree proof not ready; root rollup or batched blob missing.');
179
+ }
180
+ return {
181
+ proof: provingOutput.proof.binaryProof,
182
+ publicInputs: provingOutput.inputs,
183
+ batchedBlobInputs: this.finalBatchedBlob,
184
+ };
185
+ }
186
+
187
+ // --- lifecycle ---
188
+
189
+ public verifyState() {
190
+ return this.lifecycle === TOP_TREE_LIFECYCLE.CREATED;
191
+ }
192
+
193
+ public resolve() {
194
+ if (!this.verifyState()) {
195
+ return;
196
+ }
197
+ this.lifecycle = TOP_TREE_LIFECYCLE.RESOLVED;
198
+ this.completionCallback();
199
+ }
200
+
201
+ public reject(reason: string) {
202
+ if (!this.verifyState()) {
203
+ return;
204
+ }
205
+ this.lifecycle = TOP_TREE_LIFECYCLE.REJECTED;
206
+ this.rejectionCallback(reason);
207
+ }
208
+
209
+ public cancel() {
210
+ this.reject('Top-tree proving cancelled');
211
+ }
212
+
213
+ #getChildProofsForRoot() {
214
+ const rootLocation = { level: 0, index: 0 };
215
+ return this.totalNumCheckpoints === 1
216
+ ? [this.checkpointProofs.getNode(rootLocation)?.provingOutput, this.checkpointPaddingProof?.provingOutput]
217
+ : this.checkpointProofs.getChildren(rootLocation).map(c => c?.provingOutput);
218
+ }
219
+ }
@@ -1,11 +1,13 @@
1
1
  import { type ACVMConfig, type BBConfig, BBNativeRollupProver, TestCircuitProver } from '@aztec/bb-prover';
2
+ import type { EpochNumber } from '@aztec/foundation/branded-types';
2
3
  import { times } from '@aztec/foundation/collection';
4
+ import type { Fr } from '@aztec/foundation/curves/bn254';
3
5
  import type { EthAddress } from '@aztec/foundation/eth-address';
4
6
  import { type Logger, createLogger } from '@aztec/foundation/log';
7
+ import { SerialQueue } from '@aztec/foundation/queue';
5
8
  import { NativeACVMSimulator } from '@aztec/simulator/server';
6
9
  import {
7
10
  type ActualProverConfig,
8
- type EpochProver,
9
11
  type EpochProverManager,
10
12
  type ForkMerkleTreeOperations,
11
13
  type ProvingJobBroker,
@@ -15,19 +17,68 @@ import {
15
17
  type ServerCircuitProver,
16
18
  tryStop,
17
19
  } from '@aztec/stdlib/interfaces/server';
20
+ import type { CheckpointConstantData } from '@aztec/stdlib/rollup';
21
+ import type { BlockHeader } from '@aztec/stdlib/tx';
18
22
  import { type TelemetryClient, getTelemetryClient } from '@aztec/telemetry-client';
19
23
 
20
24
  import type { ProverClientConfig } from '../config.js';
21
- import { ProvingOrchestrator } from '../orchestrator/orchestrator.js';
25
+ import { CheckpointSubTreeOrchestrator } from '../orchestrator/checkpoint-sub-tree-orchestrator.js';
26
+ import type { ChonkCache } from '../orchestrator/chonk-cache.js';
27
+ import { TopTreeOrchestrator } from '../orchestrator/top-tree-orchestrator.js';
22
28
  import { BrokerCircuitProverFacade } from '../proving_broker/broker_prover_facade.js';
23
29
  import { InlineProofStore, type ProofStore, createProofStore } from '../proving_broker/proof_store/index.js';
24
30
  import { ProvingAgent } from '../proving_broker/proving_agent.js';
25
- import { ServerEpochProver } from './server-epoch-prover.js';
31
+
32
+ /**
33
+ * The factory surface that `EpochProvingJob` (in `prover-node`) depends on. Implemented
34
+ * by `ProverClient`. Defined here rather than in stdlib because the return types
35
+ * (`CheckpointSubTreeOrchestrator`, `TopTreeOrchestrator`) are concrete classes from
36
+ * this package.
37
+ *
38
+ * A single `BrokerCircuitProverFacade` is owned by `ProverClient` and shared across
39
+ * every orchestrator (every sub-tree and every top-tree across every concurrent epoch
40
+ * job). The broker delivers each completed-job notification exactly once (drained on
41
+ * the first `getCompletedJobs` poll), so multiple facades polling the same broker
42
+ * race and lose notifications
43
+ *
44
+ * The facade's job map cleans up entries on resolve/reject, and the prover-node
45
+ * keeps `ProverClient` alive for its whole lifetime
46
+ */
47
+ export interface EpochProverFactory {
48
+ getProverId(): EthAddress;
49
+ /**
50
+ * Constructs and starts a `CheckpointSubTreeOrchestrator` for a single checkpoint
51
+ * against the supplied shared `chonkCache`. The cache is owned by the prover-node
52
+ * and survives across epochs / sessions.
53
+ */
54
+ createCheckpointSubTreeOrchestrator(
55
+ chonkCache: ChonkCache,
56
+ epochNumber: EpochNumber,
57
+ checkpointConstants: CheckpointConstantData,
58
+ l1ToL2Messages: Fr[],
59
+ totalNumBlocks: number,
60
+ headerOfLastBlockInPreviousCheckpoint: BlockHeader,
61
+ ): Promise<CheckpointSubTreeOrchestrator>;
62
+ createTopTreeOrchestrator(): TopTreeOrchestrator;
63
+ }
26
64
 
27
65
  /** Manages proving of epochs by orchestrating the proving of individual blocks relying on a pool of prover agents. */
28
- export class ProverClient implements EpochProverManager {
66
+ export class ProverClient implements EpochProverManager, EpochProverFactory {
29
67
  private running = false;
30
68
  private agents: ProvingAgent[] = [];
69
+ /**
70
+ * The single broker facade shared by every orchestrator created from this client.
71
+ * Constructed lazily on `start()` and torn down on `stop()` — see the comment on
72
+ * `EpochProverFactory` for why a single shared facade is required.
73
+ */
74
+ private facade: BrokerCircuitProverFacade | undefined;
75
+ /**
76
+ * Single deferred-proving-job queue shared across every orchestrator (sub-trees and
77
+ * top-trees, across every concurrent epoch session). Throttles the total rate of job
78
+ * submission to the broker once, rather than once per orchestrator. Started lazily
79
+ * alongside the facade and cancelled on `stop()`.
80
+ */
81
+ private deferredJobQueue: SerialQueue | undefined;
31
82
 
32
83
  private constructor(
33
84
  private config: ProverClientConfig,
@@ -40,25 +91,76 @@ export class ProverClient implements EpochProverManager {
40
91
  private log: Logger = createLogger('prover-client:tx-prover'),
41
92
  ) {}
42
93
 
43
- public createEpochProver(): EpochProver {
44
- const bindings = this.log.getBindings();
45
- const facade = new BrokerCircuitProverFacade(
46
- this.orchestratorClient,
47
- this.proofStore,
48
- this.failedProofStore,
49
- undefined,
50
- bindings,
51
- );
52
- const orchestrator = new ProvingOrchestrator(
94
+ /**
95
+ * Lazy-init the shared facade. The broker delivers each completed-job notification
96
+ * exactly once (drained on the first `getCompletedJobs` poll), so we cannot start
97
+ * a shared facade alongside the per-call facades that `createEpochProver` builds —
98
+ * they would race for notifications and one side would silently drop them. Starting
99
+ * the shared facade only on first use of one of the new factory methods keeps the
100
+ * legacy `createEpochProver` path race-free.
101
+ */
102
+ private getFacade(): BrokerCircuitProverFacade {
103
+ if (!this.running) {
104
+ throw new Error('ProverClient is not running; call start() before constructing orchestrators.');
105
+ }
106
+ if (!this.facade) {
107
+ this.facade = new BrokerCircuitProverFacade(
108
+ this.orchestratorClient,
109
+ this.proofStore,
110
+ this.failedProofStore,
111
+ undefined,
112
+ this.log.getBindings(),
113
+ );
114
+ this.facade.start();
115
+ }
116
+ return this.facade;
117
+ }
118
+
119
+ /** Lazy-init the shared deferred-job queue, started with the configured enqueue concurrency. */
120
+ private getDeferredJobQueue(): SerialQueue {
121
+ if (!this.running) {
122
+ throw new Error('ProverClient is not running; call start() before constructing orchestrators.');
123
+ }
124
+ if (!this.deferredJobQueue) {
125
+ this.deferredJobQueue = new SerialQueue();
126
+ this.deferredJobQueue.start(this.config.enqueueConcurrency);
127
+ }
128
+ return this.deferredJobQueue;
129
+ }
130
+
131
+ public createCheckpointSubTreeOrchestrator(
132
+ chonkCache: ChonkCache,
133
+ epochNumber: EpochNumber,
134
+ checkpointConstants: CheckpointConstantData,
135
+ l1ToL2Messages: Fr[],
136
+ totalNumBlocks: number,
137
+ headerOfLastBlockInPreviousCheckpoint: BlockHeader,
138
+ ): Promise<CheckpointSubTreeOrchestrator> {
139
+ return CheckpointSubTreeOrchestrator.start(
53
140
  this.worldState,
54
- facade,
141
+ this.getFacade(),
55
142
  this.config.proverId,
143
+ chonkCache,
144
+ epochNumber,
56
145
  this.config.cancelJobsOnStop,
57
- this.config.enqueueConcurrency,
146
+ this.getDeferredJobQueue(),
147
+ checkpointConstants,
148
+ l1ToL2Messages,
149
+ totalNumBlocks,
150
+ headerOfLastBlockInPreviousCheckpoint,
58
151
  this.telemetry,
59
- bindings,
152
+ this.log.getBindings(),
153
+ );
154
+ }
155
+
156
+ public createTopTreeOrchestrator(): TopTreeOrchestrator {
157
+ return new TopTreeOrchestrator(
158
+ this.getFacade(),
159
+ this.config.proverId,
160
+ this.getDeferredJobQueue(),
161
+ this.telemetry,
162
+ this.log.getBindings(),
60
163
  );
61
- return new ServerEpochProver(facade, orchestrator);
62
164
  }
63
165
 
64
166
  public getProverId(): EthAddress {
@@ -100,6 +202,14 @@ export class ProverClient implements EpochProverManager {
100
202
  }
101
203
  this.running = false;
102
204
  await this.stopAgents();
205
+ if (this.deferredJobQueue) {
206
+ await this.deferredJobQueue.cancel();
207
+ this.deferredJobQueue = undefined;
208
+ }
209
+ if (this.facade) {
210
+ await tryStop(this.facade, this.log);
211
+ this.facade = undefined;
212
+ }
103
213
  await tryStop(this.orchestratorClient);
104
214
  }
105
215
 
@@ -4,7 +4,9 @@ import type {
4
4
  NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH,
5
5
  RECURSIVE_PROOF_LENGTH,
6
6
  } from '@aztec/constants';
7
+ import { asyncPool } from '@aztec/foundation/async-pool';
7
8
  import { EpochNumber } from '@aztec/foundation/branded-types';
9
+ import { chunk } from '@aztec/foundation/collection';
8
10
  import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
9
11
  import { type PromiseWithResolvers, RunningPromise, promiseWithResolvers } from '@aztec/foundation/promise';
10
12
  import { truncate } from '@aztec/foundation/string';
@@ -226,17 +228,11 @@ export class BrokerCircuitProverFacade implements ServerCircuitProver {
226
228
  // We collect all returned notifications and return them
227
229
  const allCompleted = new Set<ProvingJobId>();
228
230
  try {
229
- let numRequests = 0;
230
- while (ids.length > 0) {
231
- const slice = ids.splice(0, SNAPSHOT_SYNC_CHECK_MAX_REQUEST_SIZE);
232
- const completed = await this.broker.getCompletedJobs(slice);
231
+ const batches = ids.length > 0 ? chunk(ids, SNAPSHOT_SYNC_CHECK_MAX_REQUEST_SIZE) : [[]];
232
+ await asyncPool(1, batches, async batch => {
233
+ const completed = await this.broker.getCompletedJobs(batch);
233
234
  completed.forEach(id => allCompleted.add(id));
234
- ++numRequests;
235
- }
236
- if (numRequests === 0) {
237
- const final = await this.broker.getCompletedJobs([]);
238
- final.forEach(id => allCompleted.add(id));
239
- }
235
+ });
240
236
  } catch (err) {
241
237
  this.log.error(`Error thrown when requesting completed job notifications from the broker`, err);
242
238
  }
@@ -352,12 +348,8 @@ export class BrokerCircuitProverFacade implements ServerCircuitProver {
352
348
  .map(id => this.jobs.get(id)!)
353
349
  .filter(x => x !== undefined);
354
350
  const totalJobsToRetrieve = toBeRetrieved.length;
355
- let totalJobsRetrieved = 0;
356
- while (toBeRetrieved.length > 0) {
357
- const slice = toBeRetrieved.splice(0, MAX_CONCURRENT_JOB_SETTLED_REQUESTS);
358
- const results = await Promise.all(slice.map(job => processJob(job!)));
359
- totalJobsRetrieved += results.filter(x => x).length;
360
- }
351
+ const results = await asyncPool(MAX_CONCURRENT_JOB_SETTLED_REQUESTS, toBeRetrieved, job => processJob(job));
352
+ const totalJobsRetrieved = results.filter(x => x).length;
361
353
  if (totalJobsToRetrieve > 0) {
362
354
  this.log.verbose(
363
355
  `Successfully retrieved ${totalJobsRetrieved} of ${totalJobsToRetrieve} jobs that should be ready, total ready jobs is now: ${this.jobsToRetrieve.size}`,
@@ -4,6 +4,7 @@ import {
4
4
  booleanConfigHelper,
5
5
  getDefaultConfig,
6
6
  numberConfigHelper,
7
+ optionalNumberConfigHelper,
7
8
  } from '@aztec/foundation/config';
8
9
  import { pickConfigMappings } from '@aztec/foundation/config';
9
10
  import { type ChainConfig, chainConfigMappings } from '@aztec/stdlib/config';
@@ -73,7 +74,7 @@ export const proverBrokerConfigMappings: ConfigMappingsType<ProverBrokerConfig>
73
74
  },
74
75
  proverBrokerStoreMapSizeKb: {
75
76
  env: 'PROVER_BROKER_STORE_MAP_SIZE_KB',
76
- parseEnv: (val: string | undefined) => (val ? +val : undefined),
77
+ ...optionalNumberConfigHelper(),
77
78
  description: "The size of the prover broker's database. Will override the dataStoreMapSizeKb if set.",
78
79
  },
79
80
  proverBrokerDebugReplayEnabled: {
@@ -7,3 +7,4 @@ export * from './proving_broker_database/persisted.js';
7
7
  export * from './proof_store/index.js';
8
8
  export * from './factory.js';
9
9
  export * from './config.js';
10
+ export { BrokerCircuitProverFacade } from './broker_prover_facade.js';
@@ -319,14 +319,20 @@ export class ProvingBroker implements ProvingJobProducer, ProvingJobConsumer, Pr
319
319
  }
320
320
 
321
321
  private cleanUpProvingJobState(ids: ProvingJobId[]) {
322
+ const idsToClean = new Set(ids);
322
323
  for (const id of ids) {
323
324
  this.jobsCache.delete(id);
325
+ const deferred = this.promises.get(id);
326
+ if (deferred) {
327
+ deferred.resolve({ status: 'rejected', reason: 'Proving job cleaned up' });
328
+ }
324
329
  this.promises.delete(id);
325
330
  this.resultsCache.delete(id);
326
331
  this.inProgress.delete(id);
327
332
  this.retries.delete(id);
328
333
  this.enqueuedAt.delete(id);
329
334
  }
335
+ this.completedJobNotifications = this.completedJobNotifications.filter(id => !idsToClean.has(id));
330
336
  }
331
337
 
332
338
  #getProvingJobStatus(id: ProvingJobId): ProvingJobStatus {
@@ -594,21 +600,21 @@ export class ProvingBroker implements ProvingJobProducer, ProvingJobConsumer, Pr
594
600
  }
595
601
 
596
602
  private async cleanupPass() {
597
- this.cleanupStaleJobs();
598
603
  this.reEnqueueExpiredJobs();
599
604
  const oldestEpochToKeep = this.oldestEpochToKeep();
600
605
  if (oldestEpochToKeep > 0) {
606
+ this.cleanupJobsOlderThanEpoch(EpochNumber(oldestEpochToKeep));
601
607
  await this.database.deleteAllProvingJobsOlderThanEpoch(EpochNumber(oldestEpochToKeep));
602
608
  this.logger.trace(`Deleted all epochs older than ${oldestEpochToKeep}`);
603
609
  }
604
610
  }
605
611
 
606
- private cleanupStaleJobs() {
612
+ private cleanupJobsOlderThanEpoch(epochNumber: EpochNumber) {
607
613
  const jobIds = Array.from(this.jobsCache.keys());
608
614
  const jobsToClean: ProvingJobId[] = [];
609
615
  for (const id of jobIds) {
610
616
  const job = this.jobsCache.get(id)!;
611
- if (this.isJobStale(job)) {
617
+ if (job.epochNumber < epochNumber) {
612
618
  jobsToClean.push(id);
613
619
  }
614
620
  }
@@ -632,10 +638,26 @@ export class ProvingBroker implements ProvingJobProducer, ProvingJobConsumer, Pr
632
638
  const now = this.msTimeSource();
633
639
  const msSinceLastUpdate = now - metadata.lastUpdatedAt;
634
640
  if (msSinceLastUpdate >= this.jobTimeoutMs) {
635
- this.logger.warn(`Proving job id=${id} timed out. Adding it back to the queue.`, { provingJobId: id });
636
641
  this.inProgress.delete(id);
637
- this.enqueueJobInternal(item);
638
642
  this.instrumentation.incTimedOutJobs(item.type);
643
+
644
+ const retries = this.retries.get(id) ?? 0;
645
+ if (retries + 1 < this.maxRetries && !this.isJobStale(item)) {
646
+ this.logger.warn(`Proving job id=${id} timed out. Re-enqueueing (retry ${retries + 1}/${this.maxRetries}).`, {
647
+ provingJobId: id,
648
+ });
649
+ this.retries.set(id, retries + 1);
650
+ this.enqueueJobInternal(item);
651
+ } else {
652
+ this.logger.error(`Proving job id=${id} timed out after ${retries + 1} attempts. Marking as failed.`, {
653
+ provingJobId: id,
654
+ });
655
+ const result: ProvingJobSettledResult = { status: 'rejected', reason: 'Timed out' };
656
+ this.resultsCache.set(id, result);
657
+ this.promises.get(id)?.resolve(result);
658
+ this.completedJobNotifications.push(id);
659
+ this.instrumentation.incRejectedJobs(item.type);
660
+ }
639
661
  }
640
662
  }
641
663
  }
@@ -154,7 +154,7 @@ export class KVBrokerDatabase implements ProvingBrokerDatabase {
154
154
  const db = await openVersionedStoreAt(
155
155
  fullDirectory,
156
156
  SingleEpochDatabase.SCHEMA_VERSION,
157
- config.l1Contracts.rollupAddress,
157
+ config.rollupAddress,
158
158
  config.dataStoreMapSizeKb,
159
159
  );
160
160
  const epochDb = new SingleEpochDatabase(db);
@@ -222,7 +222,7 @@ export class KVBrokerDatabase implements ProvingBrokerDatabase {
222
222
  const db = await openVersionedStoreAt(
223
223
  newEpochDirectory,
224
224
  SingleEpochDatabase.SCHEMA_VERSION,
225
- this.config.l1Contracts.rollupAddress,
225
+ this.config.rollupAddress,
226
226
  this.config.dataStoreMapSizeKb,
227
227
  );
228
228
  epochDb = new SingleEpochDatabase(db);
@@ -18,6 +18,15 @@ import { makeTracedFetch } from '@aztec/telemetry-client';
18
18
 
19
19
  import { z } from 'zod';
20
20
 
21
+ /** Indefinite backoff for broker communication: 1, 1, 1, 2, 4, 4, 4, ... seconds. */
22
+ export function* proverBrokerBackoff() {
23
+ const v = [1, 1, 1, 2, 4];
24
+ let i = 0;
25
+ while (true) {
26
+ yield v[Math.min(i++, v.length - 1)];
27
+ }
28
+ }
29
+
21
30
  const ProvingJobFilterSchema = z.object({
22
31
  allowList: z.array(z.nativeEnum(ProvingRequestType)),
23
32
  });
@@ -28,26 +37,29 @@ const GetProvingJobResponse = z.object({
28
37
  });
29
38
 
30
39
  export const ProvingJobProducerSchema: ApiSchemaFor<ProvingJobProducer> = {
31
- enqueueProvingJob: z.function().args(ProvingJob).returns(ProvingJobStatus),
32
- getProvingJobStatus: z.function().args(ProvingJobId).returns(ProvingJobStatus),
33
- cancelProvingJob: z.function().args(ProvingJobId).returns(z.void()),
34
- getCompletedJobs: z.function().args(z.array(ProvingJobId)).returns(z.array(ProvingJobId)),
40
+ enqueueProvingJob: z.function({ input: z.tuple([ProvingJob]), output: ProvingJobStatus }),
41
+ getProvingJobStatus: z.function({ input: z.tuple([ProvingJobId]), output: ProvingJobStatus }),
42
+ cancelProvingJob: z.function({ input: z.tuple([ProvingJobId]), output: z.void() }),
43
+ getCompletedJobs: z.function({ input: z.tuple([z.array(ProvingJobId)]), output: z.array(ProvingJobId) }),
35
44
  };
36
45
 
37
46
  export const ProvingJobConsumerSchema: ApiSchemaFor<ProvingJobConsumer> = {
38
- getProvingJob: z.function().args(optional(ProvingJobFilterSchema)).returns(GetProvingJobResponse.optional()),
39
- reportProvingJobError: z
40
- .function()
41
- .args(ProvingJobId, z.string(), optional(z.boolean()), optional(ProvingJobFilterSchema))
42
- .returns(GetProvingJobResponse.optional()),
43
- reportProvingJobProgress: z
44
- .function()
45
- .args(ProvingJobId, z.number(), optional(ProvingJobFilterSchema))
46
- .returns(GetProvingJobResponse.optional()),
47
- reportProvingJobSuccess: z
48
- .function()
49
- .args(ProvingJobId, ProofUri, optional(ProvingJobFilterSchema))
50
- .returns(GetProvingJobResponse.optional()),
47
+ getProvingJob: z.function({
48
+ input: z.tuple([optional(ProvingJobFilterSchema)]),
49
+ output: GetProvingJobResponse.optional(),
50
+ }),
51
+ reportProvingJobError: z.function({
52
+ input: z.tuple([ProvingJobId, z.string(), optional(z.boolean()), optional(ProvingJobFilterSchema)]),
53
+ output: GetProvingJobResponse.optional(),
54
+ }),
55
+ reportProvingJobProgress: z.function({
56
+ input: z.tuple([ProvingJobId, z.number(), optional(ProvingJobFilterSchema)]),
57
+ output: GetProvingJobResponse.optional(),
58
+ }),
59
+ reportProvingJobSuccess: z.function({
60
+ input: z.tuple([ProvingJobId, ProofUri, optional(ProvingJobFilterSchema)]),
61
+ output: GetProvingJobResponse.optional(),
62
+ }),
51
63
  };
52
64
 
53
65
  export const ProvingJobBrokerSchema: ApiSchemaFor<ProvingJobBroker> = {
@@ -56,10 +68,10 @@ export const ProvingJobBrokerSchema: ApiSchemaFor<ProvingJobBroker> = {
56
68
  };
57
69
 
58
70
  export const ProvingJobBrokerDebugSchema: ApiSchemaFor<ProvingJobBrokerDebug> = {
59
- replayProvingJob: z
60
- .function()
61
- .args(ProvingJobId, z.nativeEnum(ProvingRequestType), EpochNumberSchema, ProofUri)
62
- .returns(ProvingJobStatus),
71
+ replayProvingJob: z.function({
72
+ input: z.tuple([ProvingJobId, z.nativeEnum(ProvingRequestType), EpochNumberSchema, ProofUri]),
73
+ output: ProvingJobStatus,
74
+ }),
63
75
  };
64
76
 
65
77
  export const ProvingJobBrokerSchemaWithDebug: ApiSchemaFor<ProvingJobBroker & ProvingJobBrokerDebug> = {
@@ -70,7 +82,7 @@ export const ProvingJobBrokerSchemaWithDebug: ApiSchemaFor<ProvingJobBroker & Pr
70
82
  export function createProvingJobBrokerClient(
71
83
  url: string,
72
84
  versions: Partial<ComponentsVersions>,
73
- fetch = makeTracedFetch([1, 2, 3], false),
85
+ fetch = makeTracedFetch(proverBrokerBackoff, false),
74
86
  ): ProvingJobBroker {
75
87
  return createSafeJsonRpcClient(url, ProvingJobBrokerSchema, {
76
88
  namespaceMethods: 'proverBroker',
@@ -82,7 +94,7 @@ export function createProvingJobBrokerClient(
82
94
  export function createProvingJobProducerClient(
83
95
  url: string,
84
96
  versions: Partial<ComponentsVersions>,
85
- fetch = makeTracedFetch([1, 2, 3], false),
97
+ fetch = makeTracedFetch(proverBrokerBackoff, false),
86
98
  ): ProvingJobProducer {
87
99
  return createSafeJsonRpcClient(url, ProvingJobProducerSchema, {
88
100
  namespaceMethods: 'provingJobProducer',
@@ -94,7 +106,7 @@ export function createProvingJobProducerClient(
94
106
  export function createProvingJobConsumerClient(
95
107
  url: string,
96
108
  versions: Partial<ComponentsVersions>,
97
- fetch = makeTracedFetch([1, 2, 3], false),
109
+ fetch = makeTracedFetch(proverBrokerBackoff, false),
98
110
  ): ProvingJobConsumer {
99
111
  return createSafeJsonRpcClient(url, ProvingJobConsumerSchema, {
100
112
  namespaceMethods: 'provingJobConsumer',