@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.
- package/dest/config.d.ts +1 -1
- package/dest/config.d.ts.map +1 -1
- package/dest/config.js +16 -2
- package/dest/light/lightweight_checkpoint_builder.d.ts +1 -1
- package/dest/light/lightweight_checkpoint_builder.d.ts.map +1 -1
- package/dest/light/lightweight_checkpoint_builder.js +15 -5
- package/dest/mocks/test_context.d.ts +11 -11
- package/dest/mocks/test_context.d.ts.map +1 -1
- package/dest/mocks/test_context.js +25 -28
- package/dest/orchestrator/block-building-helpers.d.ts +1 -1
- package/dest/orchestrator/checkpoint-proving-state.d.ts +20 -36
- package/dest/orchestrator/checkpoint-proving-state.d.ts.map +1 -1
- package/dest/orchestrator/checkpoint-proving-state.js +22 -120
- package/dest/orchestrator/checkpoint-sub-tree-orchestrator.d.ts +161 -0
- package/dest/orchestrator/checkpoint-sub-tree-orchestrator.d.ts.map +1 -0
- package/dest/orchestrator/{orchestrator.js → checkpoint-sub-tree-orchestrator.js} +267 -451
- package/dest/orchestrator/chonk-cache.d.ts +39 -0
- package/dest/orchestrator/chonk-cache.d.ts.map +1 -0
- package/dest/orchestrator/chonk-cache.js +80 -0
- package/dest/orchestrator/index.d.ts +4 -2
- package/dest/orchestrator/index.d.ts.map +1 -1
- package/dest/orchestrator/index.js +3 -1
- package/dest/orchestrator/proving-scheduler.d.ts +81 -0
- package/dest/orchestrator/proving-scheduler.d.ts.map +1 -0
- package/dest/orchestrator/proving-scheduler.js +120 -0
- package/dest/orchestrator/top-tree-orchestrator.d.ts +88 -0
- package/dest/orchestrator/top-tree-orchestrator.d.ts.map +1 -0
- package/dest/orchestrator/top-tree-orchestrator.js +232 -0
- package/dest/orchestrator/top-tree-proving-state.d.ts +61 -0
- package/dest/orchestrator/top-tree-proving-state.d.ts.map +1 -0
- package/dest/orchestrator/top-tree-proving-state.js +185 -0
- package/dest/prover-client/prover-client.d.ts +61 -4
- package/dest/prover-client/prover-client.d.ts.map +1 -1
- package/dest/prover-client/prover-client.js +54 -7
- package/dest/proving_broker/broker_prover_facade.d.ts +1 -1
- package/dest/proving_broker/broker_prover_facade.d.ts.map +1 -1
- package/dest/proving_broker/broker_prover_facade.js +10 -16
- package/dest/proving_broker/config.d.ts +8 -72
- package/dest/proving_broker/config.d.ts.map +1 -1
- package/dest/proving_broker/config.js +2 -2
- package/dest/proving_broker/index.d.ts +2 -1
- package/dest/proving_broker/index.d.ts.map +1 -1
- package/dest/proving_broker/index.js +1 -0
- package/dest/proving_broker/proving_broker.d.ts +2 -2
- package/dest/proving_broker/proving_broker.d.ts.map +1 -1
- package/dest/proving_broker/proving_broker.js +32 -7
- package/dest/proving_broker/proving_broker_database/persisted.js +2 -2
- package/dest/proving_broker/rpc.d.ts +3 -1
- package/dest/proving_broker/rpc.d.ts.map +1 -1
- package/dest/proving_broker/rpc.js +80 -24
- package/dest/test/epoch_settlement.d.ts +36 -0
- package/dest/test/epoch_settlement.d.ts.map +1 -0
- package/dest/test/epoch_settlement.js +52 -0
- package/dest/test/index.d.ts +2 -0
- package/dest/test/index.d.ts.map +1 -0
- package/dest/test/index.js +1 -0
- package/dest/test/mock_prover.d.ts +3 -3
- package/package.json +19 -18
- package/src/config.ts +18 -2
- package/src/light/lightweight_checkpoint_builder.ts +16 -6
- package/src/mocks/test_context.ts +24 -41
- package/src/orchestrator/checkpoint-proving-state.ts +21 -162
- package/src/orchestrator/{orchestrator.ts → checkpoint-sub-tree-orchestrator.ts} +415 -661
- package/src/orchestrator/chonk-cache.ts +99 -0
- package/src/orchestrator/index.ts +8 -1
- package/src/orchestrator/proving-scheduler.ts +160 -0
- package/src/orchestrator/top-tree-orchestrator.ts +384 -0
- package/src/orchestrator/top-tree-proving-state.ts +219 -0
- package/src/prover-client/prover-client.ts +128 -18
- package/src/proving_broker/broker_prover_facade.ts +8 -16
- package/src/proving_broker/config.ts +2 -1
- package/src/proving_broker/index.ts +1 -0
- package/src/proving_broker/proving_broker.ts +27 -5
- package/src/proving_broker/proving_broker_database/persisted.ts +2 -2
- package/src/proving_broker/rpc.ts +36 -24
- package/src/test/epoch_settlement.ts +82 -0
- package/src/test/index.ts +1 -0
- package/dest/orchestrator/epoch-proving-state.d.ts +0 -75
- package/dest/orchestrator/epoch-proving-state.d.ts.map +0 -1
- package/dest/orchestrator/epoch-proving-state.js +0 -269
- package/dest/orchestrator/orchestrator.d.ts +0 -130
- package/dest/orchestrator/orchestrator.d.ts.map +0 -1
- package/dest/prover-client/server-epoch-prover.d.ts +0 -32
- package/dest/prover-client/server-epoch-prover.d.ts.map +0 -1
- package/dest/prover-client/server-epoch-prover.js +0 -40
- package/src/orchestrator/epoch-proving-state.ts +0 -380
- 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 {
|
|
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
|
-
|
|
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
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
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
|
-
|
|
141
|
+
this.getFacade(),
|
|
55
142
|
this.config.proverId,
|
|
143
|
+
chonkCache,
|
|
144
|
+
epochNumber,
|
|
56
145
|
this.config.cancelJobsOnStop,
|
|
57
|
-
this.
|
|
146
|
+
this.getDeferredJobQueue(),
|
|
147
|
+
checkpointConstants,
|
|
148
|
+
l1ToL2Messages,
|
|
149
|
+
totalNumBlocks,
|
|
150
|
+
headerOfLastBlockInPreviousCheckpoint,
|
|
58
151
|
this.telemetry,
|
|
59
|
-
|
|
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
|
-
|
|
230
|
-
|
|
231
|
-
const
|
|
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
|
-
|
|
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
|
-
|
|
356
|
-
|
|
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
|
-
|
|
77
|
+
...optionalNumberConfigHelper(),
|
|
77
78
|
description: "The size of the prover broker's database. Will override the dataStoreMapSizeKb if set.",
|
|
78
79
|
},
|
|
79
80
|
proverBrokerDebugReplayEnabled: {
|
|
@@ -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
|
|
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 (
|
|
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.
|
|
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.
|
|
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(
|
|
32
|
-
getProvingJobStatus: z.function(
|
|
33
|
-
cancelProvingJob: z.function(
|
|
34
|
-
getCompletedJobs: z.function(
|
|
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(
|
|
39
|
-
|
|
40
|
-
.
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
.
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
.
|
|
49
|
-
|
|
50
|
-
|
|
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
|
-
.
|
|
61
|
-
|
|
62
|
-
|
|
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(
|
|
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(
|
|
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(
|
|
109
|
+
fetch = makeTracedFetch(proverBrokerBackoff, false),
|
|
98
110
|
): ProvingJobConsumer {
|
|
99
111
|
return createSafeJsonRpcClient(url, ProvingJobConsumerSchema, {
|
|
100
112
|
namespaceMethods: 'provingJobConsumer',
|