@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
|
@@ -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 {
|
|
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
|
|
88
|
-
|
|
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.
|
|
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.
|
|
190
|
+
this.onReject(reason);
|
|
341
191
|
}
|
|
342
192
|
|
|
343
|
-
|
|
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
|
}
|