@aztec/prover-client 0.0.1-commit.b9865e97 → 0.0.1-commit.be03c316

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 (78) hide show
  1. package/dest/light/lightweight_checkpoint_builder.d.ts +1 -1
  2. package/dest/light/lightweight_checkpoint_builder.d.ts.map +1 -1
  3. package/dest/light/lightweight_checkpoint_builder.js +3 -1
  4. package/dest/mocks/test_context.d.ts +9 -11
  5. package/dest/mocks/test_context.d.ts.map +1 -1
  6. package/dest/mocks/test_context.js +13 -22
  7. package/dest/orchestrator/block-building-helpers.d.ts +1 -1
  8. package/dest/orchestrator/checkpoint-proving-state.d.ts +13 -36
  9. package/dest/orchestrator/checkpoint-proving-state.d.ts.map +1 -1
  10. package/dest/orchestrator/checkpoint-proving-state.js +18 -125
  11. package/dest/orchestrator/checkpoint-sub-tree-orchestrator.d.ts +116 -62
  12. package/dest/orchestrator/checkpoint-sub-tree-orchestrator.d.ts.map +1 -1
  13. package/dest/orchestrator/checkpoint-sub-tree-orchestrator.js +1005 -90
  14. package/dest/orchestrator/chonk-cache.d.ts +39 -0
  15. package/dest/orchestrator/chonk-cache.d.ts.map +1 -0
  16. package/dest/orchestrator/chonk-cache.js +80 -0
  17. package/dest/orchestrator/index.d.ts +2 -3
  18. package/dest/orchestrator/index.d.ts.map +1 -1
  19. package/dest/orchestrator/index.js +1 -2
  20. package/dest/orchestrator/proving-scheduler.d.ts +26 -17
  21. package/dest/orchestrator/proving-scheduler.d.ts.map +1 -1
  22. package/dest/orchestrator/proving-scheduler.js +28 -25
  23. package/dest/orchestrator/top-tree-orchestrator.d.ts +11 -6
  24. package/dest/orchestrator/top-tree-orchestrator.d.ts.map +1 -1
  25. package/dest/orchestrator/top-tree-orchestrator.js +71 -21
  26. package/dest/orchestrator/top-tree-proving-state.d.ts +1 -1
  27. package/dest/orchestrator/top-tree-proving-state.d.ts.map +1 -1
  28. package/dest/orchestrator/tx-proving-state.d.ts +3 -3
  29. package/dest/orchestrator/tx-proving-state.d.ts.map +1 -1
  30. package/dest/prover-client/prover-client.d.ts +17 -19
  31. package/dest/prover-client/prover-client.d.ts.map +1 -1
  32. package/dest/prover-client/prover-client.js +24 -25
  33. package/dest/proving_broker/broker_prover_facade.d.ts +3 -3
  34. package/dest/proving_broker/broker_prover_facade.d.ts.map +1 -1
  35. package/dest/test/epoch_settlement.d.ts +36 -0
  36. package/dest/test/epoch_settlement.d.ts.map +1 -0
  37. package/dest/test/epoch_settlement.js +52 -0
  38. package/dest/test/index.d.ts +2 -0
  39. package/dest/test/index.d.ts.map +1 -0
  40. package/dest/test/index.js +1 -0
  41. package/dest/test/mock_prover.d.ts +1 -1
  42. package/dest/test/mock_prover.js +2 -2
  43. package/package.json +17 -16
  44. package/src/light/lightweight_checkpoint_builder.ts +2 -0
  45. package/src/mocks/test_context.ts +14 -34
  46. package/src/orchestrator/checkpoint-proving-state.ts +14 -168
  47. package/src/orchestrator/checkpoint-sub-tree-orchestrator.ts +902 -129
  48. package/src/orchestrator/chonk-cache.ts +99 -0
  49. package/src/orchestrator/index.ts +1 -2
  50. package/src/orchestrator/proving-scheduler.ts +29 -25
  51. package/src/orchestrator/top-tree-orchestrator.ts +114 -44
  52. package/src/orchestrator/top-tree-proving-state.ts +0 -1
  53. package/src/orchestrator/tx-proving-state.ts +3 -3
  54. package/src/prover-client/prover-client.ts +35 -49
  55. package/src/proving_broker/broker_prover_facade.ts +2 -2
  56. package/src/test/epoch_settlement.ts +82 -0
  57. package/src/test/index.ts +1 -0
  58. package/src/test/mock_prover.ts +2 -2
  59. package/dest/orchestrator/epoch-proving-context.d.ts +0 -51
  60. package/dest/orchestrator/epoch-proving-context.d.ts.map +0 -1
  61. package/dest/orchestrator/epoch-proving-context.js +0 -81
  62. package/dest/orchestrator/epoch-proving-state.d.ts +0 -75
  63. package/dest/orchestrator/epoch-proving-state.d.ts.map +0 -1
  64. package/dest/orchestrator/epoch-proving-state.js +0 -269
  65. package/dest/orchestrator/orchestrator.d.ts +0 -118
  66. package/dest/orchestrator/orchestrator.d.ts.map +0 -1
  67. package/dest/orchestrator/orchestrator.js +0 -1113
  68. package/dest/orchestrator/top-tree-proving-scheduler.d.ts +0 -62
  69. package/dest/orchestrator/top-tree-proving-scheduler.d.ts.map +0 -1
  70. package/dest/orchestrator/top-tree-proving-scheduler.js +0 -73
  71. package/dest/prover-client/server-epoch-prover.d.ts +0 -32
  72. package/dest/prover-client/server-epoch-prover.d.ts.map +0 -1
  73. package/dest/prover-client/server-epoch-prover.js +0 -40
  74. package/src/orchestrator/epoch-proving-context.ts +0 -101
  75. package/src/orchestrator/epoch-proving-state.ts +0 -380
  76. package/src/orchestrator/orchestrator.ts +0 -1111
  77. package/src/orchestrator/top-tree-proving-scheduler.ts +0 -154
  78. package/src/prover-client/server-epoch-prover.ts +0 -69
@@ -0,0 +1,82 @@
1
+ import type { RollupCheatCodes } from '@aztec/ethereum/test';
2
+ import type { CheckpointNumber, EpochNumber, SlotNumber } from '@aztec/foundation/branded-types';
3
+ import type { Fr } from '@aztec/foundation/curves/bn254';
4
+ import type { Logger } from '@aztec/foundation/log';
5
+ import type { L2BlockSource } from '@aztec/stdlib/block';
6
+ import { computeEpochOutHash } from '@aztec/stdlib/messaging';
7
+
8
+ /** Arguments for {@link settleEpochOutbox}. */
9
+ export type SettleEpochOutboxArgs = {
10
+ /** Cheat codes used to write the computed out hash directly into the L1 Outbox storage. */
11
+ rollupCheatCodes: RollupCheatCodes;
12
+ /** Source of checkpointed L2 blocks for the epoch being settled. */
13
+ l2BlockSource: L2BlockSource;
14
+ /** Epoch to settle. */
15
+ epoch: EpochNumber;
16
+ /**
17
+ * When set, only checkpoints up to and including this number are covered. Used to settle a partial
18
+ * epoch (the AZIP-14 Outbox keeps one root per `numCheckpointsInEpoch`, so a prefix of an epoch can
19
+ * be settled and consumed before the epoch completes). When omitted, every checkpointed block in the
20
+ * epoch is covered.
21
+ */
22
+ maxCheckpoint?: CheckpointNumber;
23
+ log: Logger;
24
+ };
25
+
26
+ /**
27
+ * Computes the epoch out hash over the checkpointed blocks of an epoch (optionally only up to
28
+ * `maxCheckpoint`) and writes it into the L1 Outbox via cheat codes. This is the synthetic,
29
+ * no-prover equivalent of an epoch root proof landing on L1: it makes the L2-to-L1 messages in the
30
+ * covered checkpoints consumable. It does NOT advance the rollup's proven tip — callers
31
+ * `markAsProven` separately so a single prove call can settle multiple epochs before marking proven.
32
+ *
33
+ * Used by the test-only proving drivers: the `AutomineSequencer`'s auto-settle loop and the standalone
34
+ * `EpochTestSettler`. Lives here (rather than in either consumer) so both share one implementation.
35
+ *
36
+ * @returns The last checkpoint number covered by the settled range, or `undefined` if the epoch has
37
+ * no checkpointed blocks (within the `maxCheckpoint` bound).
38
+ */
39
+ export async function settleEpochOutbox({
40
+ rollupCheatCodes,
41
+ l2BlockSource,
42
+ epoch,
43
+ maxCheckpoint,
44
+ log,
45
+ }: SettleEpochOutboxArgs): Promise<CheckpointNumber | undefined> {
46
+ let blocks = await l2BlockSource.getBlocks({ epoch, onlyCheckpointed: true });
47
+ if (maxCheckpoint !== undefined) {
48
+ blocks = blocks.filter(block => block.checkpointNumber <= maxCheckpoint);
49
+ }
50
+ if (blocks.length === 0) {
51
+ return undefined;
52
+ }
53
+
54
+ log.info(
55
+ `Settling epoch ${epoch}${maxCheckpoint !== undefined ? ` up to checkpoint ${maxCheckpoint}` : ''} with blocks ${blocks[0]?.header.getBlockNumber()} to ${blocks.at(-1)?.header.getBlockNumber()}`,
56
+ { epoch, maxCheckpoint, blocks: blocks.map(block => block.toBlockInfo()) },
57
+ );
58
+
59
+ const messagesInEpoch: Fr[][][][] = [];
60
+ // Undefined (not SlotNumber.ZERO) so a first checkpointed block at slot 0 still opens checkpoint 0.
61
+ let previousSlotNumber: SlotNumber | undefined;
62
+ let checkpointIndex = -1;
63
+
64
+ for (const block of blocks) {
65
+ const slotNumber = block.header.globalVariables.slotNumber;
66
+ if (slotNumber !== previousSlotNumber) {
67
+ checkpointIndex++;
68
+ messagesInEpoch[checkpointIndex] = [];
69
+ previousSlotNumber = slotNumber;
70
+ }
71
+ messagesInEpoch[checkpointIndex].push(block.body.txEffects.map(txEffect => txEffect.l2ToL1Msgs));
72
+ }
73
+
74
+ const outHash = computeEpochOutHash(messagesInEpoch);
75
+ if (!outHash.isZero()) {
76
+ await rollupCheatCodes.insertOutbox(epoch, messagesInEpoch.length, outHash.toBigInt());
77
+ } else {
78
+ log.info(`No L2 to L1 messages in epoch ${epoch}`, { epoch });
79
+ }
80
+
81
+ return blocks.at(-1)?.checkpointNumber;
82
+ }
@@ -0,0 +1 @@
1
+ export { settleEpochOutbox, type SettleEpochOutboxArgs } from './epoch_settlement.js';
@@ -1,5 +1,5 @@
1
1
  import {
2
- AVM_V2_PROOF_LENGTH_IN_FIELDS_PADDED,
2
+ AVM_V2_PROOF_LENGTH_IN_FIELDS,
3
3
  NESTED_RECURSIVE_PROOF_LENGTH,
4
4
  NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH,
5
5
  RECURSIVE_PROOF_LENGTH,
@@ -104,7 +104,7 @@ export class MockProver implements ServerCircuitProver {
104
104
  constructor() {}
105
105
 
106
106
  getAvmProof(_inputs: AvmCircuitInputs, _signal?: AbortSignal, _epochNumber?: number) {
107
- return Promise.resolve(makeEmptyRecursiveProof(AVM_V2_PROOF_LENGTH_IN_FIELDS_PADDED));
107
+ return Promise.resolve(makeEmptyRecursiveProof(AVM_V2_PROOF_LENGTH_IN_FIELDS));
108
108
  }
109
109
 
110
110
  getBaseParityProof(_inputs: ParityBasePrivateInputs, _signal?: AbortSignal, _epochNumber?: number) {
@@ -1,51 +0,0 @@
1
- import type { NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH } from '@aztec/constants';
2
- import type { EpochNumber } from '@aztec/foundation/branded-types';
3
- import { type LoggerBindings } from '@aztec/foundation/log';
4
- import type { PublicInputsAndRecursiveProof, ServerCircuitProver } from '@aztec/stdlib/interfaces/server';
5
- import type { PublicChonkVerifierPrivateInputs, PublicChonkVerifierPublicInputs } from '@aztec/stdlib/rollup';
6
- /**
7
- * Result of a chonk-verifier proof, cached per tx hash on `EpochProvingContext`.
8
- */
9
- export type ChonkVerifierProofResult = PublicInputsAndRecursiveProof<PublicChonkVerifierPublicInputs, typeof NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH>;
10
- /**
11
- * Per-epoch state shared across every `CheckpointSubTreeOrchestrator` constructed for
12
- * the same epoch. Owns the chonk-verifier proof cache so a tx whose checkpoint is
13
- * reorged out and re-appears in a replacement checkpoint does not have to re-prove
14
- * its chonk circuit.
15
- *
16
- * The context's chonk-verifier broker jobs are deliberately submitted **outside** the
17
- * sub-tree's deferred-proving queue. The sub-tree's `cancel()` therefore does not abort
18
- * them — by design, because their result is tx-scoped, not sub-tree-scoped, and a
19
- * replacement sub-tree should be able to consume the cached proof.
20
- *
21
- * Callers (`EpochProvingJob`, or unit tests) construct one context per epoch and pass
22
- * it into every sub-tree they create. `stop()` aborts every in-flight chonk job.
23
- */
24
- export declare class EpochProvingContext {
25
- private readonly prover;
26
- readonly epochNumber: EpochNumber;
27
- private readonly cache;
28
- /** Abort controllers for in-flight chonk jobs, keyed by tx hash. */
29
- private readonly pending;
30
- private readonly log;
31
- private stopped;
32
- constructor(prover: ServerCircuitProver, epochNumber: EpochNumber, bindings?: LoggerBindings);
33
- /**
34
- * Returns the cached chonk-verifier proof promise for the given tx hash, or
35
- * `undefined` if none has been enqueued yet. Non-mutating.
36
- */
37
- getCached(txHash: string): Promise<ChonkVerifierProofResult> | undefined;
38
- /**
39
- * Enqueues a chonk-verifier proof for the given tx hash, returning the promise (or
40
- * the already-cached one if already enqueued). The promise resolves when the broker
41
- * delivers the result; on rejection (including `stop()`), the cache entry is removed
42
- * so a subsequent caller can re-enqueue.
43
- */
44
- enqueue(txHash: string, inputs: PublicChonkVerifierPrivateInputs): Promise<ChonkVerifierProofResult>;
45
- /**
46
- * Aborts every in-flight chonk-verifier broker job and clears the cache. Called by
47
- * the owning `EpochProvingJob` when the job stops.
48
- */
49
- stop(): void;
50
- }
51
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXBvY2gtcHJvdmluZy1jb250ZXh0LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvb3JjaGVzdHJhdG9yL2Vwb2NoLXByb3ZpbmctY29udGV4dC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSx5Q0FBeUMsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQ2xGLE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQ25FLE9BQU8sRUFBZSxLQUFLLGNBQWMsRUFBZ0IsTUFBTSx1QkFBdUIsQ0FBQztBQUN2RixPQUFPLEtBQUssRUFBRSw2QkFBNkIsRUFBRSxtQkFBbUIsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQzFHLE9BQU8sS0FBSyxFQUFFLGdDQUFnQyxFQUFFLCtCQUErQixFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFFOUc7O0dBRUc7QUFDSCxNQUFNLE1BQU0sd0JBQXdCLEdBQUcsNkJBQTZCLENBQ2xFLCtCQUErQixFQUMvQixPQUFPLHlDQUF5QyxDQUNqRCxDQUFDO0FBRUY7Ozs7Ozs7Ozs7Ozs7R0FhRztBQUNILHFCQUFhLG1CQUFtQjtJQVE1QixPQUFPLENBQUMsUUFBUSxDQUFDLE1BQU07YUFDUCxXQUFXLEVBQUUsV0FBVztJQVIxQyxPQUFPLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FBd0Q7SUFDOUUsb0VBQW9FO0lBQ3BFLE9BQU8sQ0FBQyxRQUFRLENBQUMsT0FBTyxDQUFzQztJQUM5RCxPQUFPLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBUztJQUM3QixPQUFPLENBQUMsT0FBTyxDQUFTO0lBRXhCLFlBQ21CLE1BQU0sRUFBRSxtQkFBbUIsRUFDNUIsV0FBVyxFQUFFLFdBQVcsRUFDeEMsUUFBUSxDQUFDLEVBQUUsY0FBYyxFQUcxQjtJQUVEOzs7T0FHRztJQUNJLFNBQVMsQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyx3QkFBd0IsQ0FBQyxHQUFHLFNBQVMsQ0FFOUU7SUFFRDs7Ozs7T0FLRztJQUNJLE9BQU8sQ0FBQyxNQUFNLEVBQUUsTUFBTSxFQUFFLE1BQU0sRUFBRSxnQ0FBZ0MsR0FBRyxPQUFPLENBQUMsd0JBQXdCLENBQUMsQ0E2QjFHO0lBRUQ7OztPQUdHO0lBQ0ksSUFBSSxTQU9WO0NBQ0YifQ==
@@ -1 +0,0 @@
1
- {"version":3,"file":"epoch-proving-context.d.ts","sourceRoot":"","sources":["../../src/orchestrator/epoch-proving-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yCAAyC,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAe,KAAK,cAAc,EAAgB,MAAM,uBAAuB,CAAC;AACvF,OAAO,KAAK,EAAE,6BAA6B,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC1G,OAAO,KAAK,EAAE,gCAAgC,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;AAE9G;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,6BAA6B,CAClE,+BAA+B,EAC/B,OAAO,yCAAyC,CACjD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAmB;IAQ5B,OAAO,CAAC,QAAQ,CAAC,MAAM;aACP,WAAW,EAAE,WAAW;IAR1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwD;IAC9E,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IAExB,YACmB,MAAM,EAAE,mBAAmB,EAC5B,WAAW,EAAE,WAAW,EACxC,QAAQ,CAAC,EAAE,cAAc,EAG1B;IAED;;;OAGG;IACI,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,GAAG,SAAS,CAE9E;IAED;;;;;OAKG;IACI,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gCAAgC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA6B1G;IAED;;;OAGG;IACI,IAAI,SAOV;CACF"}
@@ -1,81 +0,0 @@
1
- import { createLogger } from '@aztec/foundation/log';
2
- /**
3
- * Per-epoch state shared across every `CheckpointSubTreeOrchestrator` constructed for
4
- * the same epoch. Owns the chonk-verifier proof cache so a tx whose checkpoint is
5
- * reorged out and re-appears in a replacement checkpoint does not have to re-prove
6
- * its chonk circuit.
7
- *
8
- * The context's chonk-verifier broker jobs are deliberately submitted **outside** the
9
- * sub-tree's deferred-proving queue. The sub-tree's `cancel()` therefore does not abort
10
- * them — by design, because their result is tx-scoped, not sub-tree-scoped, and a
11
- * replacement sub-tree should be able to consume the cached proof.
12
- *
13
- * Callers (`EpochProvingJob`, or unit tests) construct one context per epoch and pass
14
- * it into every sub-tree they create. `stop()` aborts every in-flight chonk job.
15
- */ export class EpochProvingContext {
16
- prover;
17
- epochNumber;
18
- cache;
19
- /** Abort controllers for in-flight chonk jobs, keyed by tx hash. */ pending;
20
- log;
21
- stopped;
22
- constructor(prover, epochNumber, bindings){
23
- this.prover = prover;
24
- this.epochNumber = epochNumber;
25
- this.cache = new Map();
26
- this.pending = new Map();
27
- this.stopped = false;
28
- this.log = createLogger('prover-client:epoch-proving-context', bindings);
29
- }
30
- /**
31
- * Returns the cached chonk-verifier proof promise for the given tx hash, or
32
- * `undefined` if none has been enqueued yet. Non-mutating.
33
- */ getCached(txHash) {
34
- return this.cache.get(txHash);
35
- }
36
- /**
37
- * Enqueues a chonk-verifier proof for the given tx hash, returning the promise (or
38
- * the already-cached one if already enqueued). The promise resolves when the broker
39
- * delivers the result; on rejection (including `stop()`), the cache entry is removed
40
- * so a subsequent caller can re-enqueue.
41
- */ enqueue(txHash, inputs) {
42
- if (this.stopped) {
43
- return Promise.reject(new Error('EpochProvingContext is stopped'));
44
- }
45
- const cached = this.cache.get(txHash);
46
- if (cached) {
47
- return cached;
48
- }
49
- const controller = new AbortController();
50
- this.pending.set(txHash, controller);
51
- this.log.debug(`Enqueueing chonk-verifier circuit`, {
52
- txHash,
53
- epochNumber: this.epochNumber
54
- });
55
- const promise = this.prover.getPublicChonkVerifierProof(inputs, controller.signal, this.epochNumber).finally(()=>this.pending.delete(txHash));
56
- // Self-clean on rejection so a future caller can re-enqueue. Mark the rejection
57
- // path as observed to silence unhandled-rejection warnings when no consumer
58
- // awaits the promise (e.g. when the only `.then` chain belonged to a cancelled
59
- // sub-tree's tx-proving state).
60
- promise.catch((err)=>{
61
- this.cache.delete(txHash);
62
- this.log.debug(`Chonk-verifier proof failed; evicted from cache`, {
63
- txHash,
64
- error: `${err}`
65
- });
66
- });
67
- this.cache.set(txHash, promise);
68
- return promise;
69
- }
70
- /**
71
- * Aborts every in-flight chonk-verifier broker job and clears the cache. Called by
72
- * the owning `EpochProvingJob` when the job stops.
73
- */ stop() {
74
- this.stopped = true;
75
- for (const controller of this.pending.values()){
76
- controller.abort();
77
- }
78
- this.pending.clear();
79
- this.cache.clear();
80
- }
81
- }
@@ -1,75 +0,0 @@
1
- import { BatchedBlob, type FinalBlobBatchingChallenges } from '@aztec/blob-lib';
2
- import { type ARCHIVE_HEIGHT, type L1_TO_L2_MSG_SUBTREE_ROOT_SIBLING_PATH_LENGTH, type NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH } from '@aztec/constants';
3
- import { BlockNumber, EpochNumber } from '@aztec/foundation/branded-types';
4
- import { Fr } from '@aztec/foundation/curves/bn254';
5
- import type { Tuple } from '@aztec/foundation/serialize';
6
- import { type TreeNodeLocation } from '@aztec/foundation/trees';
7
- import type { PublicInputsAndRecursiveProof } from '@aztec/stdlib/interfaces/server';
8
- import type { Proof } from '@aztec/stdlib/proofs';
9
- import { CheckpointConstantData, CheckpointMergeRollupPrivateInputs, CheckpointPaddingRollupPrivateInputs, CheckpointRollupPublicInputs, PublicChonkVerifierPublicInputs, RootRollupPrivateInputs, type RootRollupPublicInputs } from '@aztec/stdlib/rollup';
10
- import { AppendOnlyTreeSnapshot, type MerkleTreeId } from '@aztec/stdlib/trees';
11
- import type { BlockHeader } from '@aztec/stdlib/tx';
12
- import { CheckpointProvingState } from './checkpoint-proving-state.js';
13
- export type TreeSnapshots = Map<MerkleTreeId, AppendOnlyTreeSnapshot>;
14
- export type ProvingResult = {
15
- status: 'success';
16
- } | {
17
- status: 'failure';
18
- reason: string;
19
- };
20
- /**
21
- * The current state of the proving schedule for an epoch.
22
- * Contains the raw inputs and intermediate state to generate every constituent proof in the tree.
23
- * Carries an identifier so we can identify if the proving state is discarded and a new one started.
24
- * Captures resolve and reject callbacks to provide a promise base interface to the consumer of our proving.
25
- */
26
- export declare class EpochProvingState {
27
- #private;
28
- readonly epochNumber: EpochNumber;
29
- readonly totalNumCheckpoints: number;
30
- private readonly finalBlobBatchingChallenges;
31
- private onCheckpointBlobAccumulatorSet;
32
- private completionCallback;
33
- private rejectionCallback;
34
- private checkpointProofs;
35
- private checkpointPaddingProof;
36
- private rootRollupProof;
37
- private checkpoints;
38
- private startBlobAccumulator;
39
- private endBlobAccumulator;
40
- private finalBatchedBlob;
41
- private provingStateLifecycle;
42
- readonly cachedChonkVerifierProofs: Map<string, Promise<PublicInputsAndRecursiveProof<PublicChonkVerifierPublicInputs, 480>>>;
43
- constructor(epochNumber: EpochNumber, totalNumCheckpoints: number, finalBlobBatchingChallenges: FinalBlobBatchingChallenges, onCheckpointBlobAccumulatorSet: (checkpoint: CheckpointProvingState) => Promise<void>, completionCallback: (result: ProvingResult) => void, rejectionCallback: (reason: string) => void);
44
- startNewCheckpoint(checkpointIndex: number, constants: CheckpointConstantData, totalNumBlocks: number, previousBlockHeader: BlockHeader, lastArchiveSiblingPath: Tuple<Fr, typeof ARCHIVE_HEIGHT>, l1ToL2Messages: Fr[], lastL1ToL2MessageTreeSnapshot: AppendOnlyTreeSnapshot, lastL1ToL2MessageSubtreeRootSiblingPath: Tuple<Fr, typeof L1_TO_L2_MSG_SUBTREE_ROOT_SIBLING_PATH_LENGTH>, newL1ToL2MessageTreeSnapshot: AppendOnlyTreeSnapshot, newL1ToL2MessageSubtreeRootSiblingPath: Tuple<Fr, typeof L1_TO_L2_MSG_SUBTREE_ROOT_SIBLING_PATH_LENGTH>): CheckpointProvingState;
45
- getCheckpointProvingState(index: number): CheckpointProvingState | undefined;
46
- getCheckpointProvingStateByBlockNumber(blockNumber: BlockNumber): CheckpointProvingState | undefined;
47
- getBlockProvingStateByBlockNumber(blockNumber: BlockNumber): import("./block-proving-state.js").BlockProvingState | undefined;
48
- verifyState(): boolean;
49
- isAcceptingCheckpoints(): boolean;
50
- setCheckpointRootRollupProof(checkpointIndex: number, provingOutput: PublicInputsAndRecursiveProof<CheckpointRollupPublicInputs, typeof NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH>): TreeNodeLocation;
51
- tryStartProvingCheckpointMerge(location: TreeNodeLocation): boolean;
52
- setCheckpointMergeRollupProof(location: TreeNodeLocation, provingOutput: PublicInputsAndRecursiveProof<CheckpointRollupPublicInputs, typeof NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH>): void;
53
- tryStartProvingRootRollup(): boolean;
54
- setRootRollupProof(provingOutput: PublicInputsAndRecursiveProof<RootRollupPublicInputs>): void;
55
- tryStartProvingPaddingCheckpoint(): boolean;
56
- setCheckpointPaddingProof(provingOutput: PublicInputsAndRecursiveProof<CheckpointRollupPublicInputs, typeof NESTED_RECURSIVE_ROLLUP_HONK_PROOF_LENGTH>): void;
57
- accumulateCheckpointOutHashes(): Promise<void>;
58
- setBlobAccumulators(): Promise<void>;
59
- finalizeBatchedBlob(): Promise<void>;
60
- getParentLocation(location: TreeNodeLocation): TreeNodeLocation;
61
- getCheckpointMergeRollupInputs(mergeLocation: TreeNodeLocation): CheckpointMergeRollupPrivateInputs;
62
- getRootRollupInputs(): RootRollupPrivateInputs;
63
- getPaddingCheckpointInputs(): CheckpointPaddingRollupPrivateInputs;
64
- getEpochProofResult(): {
65
- proof: Proof;
66
- publicInputs: RootRollupPublicInputs;
67
- batchedBlobInputs: BatchedBlob;
68
- };
69
- isReadyForCheckpointMerge(location: TreeNodeLocation): boolean;
70
- isReadyForRootRollup(): boolean;
71
- cancel(): void;
72
- reject(reason: string): void;
73
- resolve(result: ProvingResult): void;
74
- }
75
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXBvY2gtcHJvdmluZy1zdGF0ZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL29yY2hlc3RyYXRvci9lcG9jaC1wcm92aW5nLXN0YXRlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxXQUFXLEVBQTBCLEtBQUssMkJBQTJCLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUN4RyxPQUFPLEVBQ0wsS0FBSyxjQUFjLEVBQ25CLEtBQUssNkNBQTZDLEVBRWxELEtBQUsseUNBQXlDLEVBRS9DLE1BQU0sa0JBQWtCLENBQUM7QUFDMUIsT0FBTyxFQUFFLFdBQVcsRUFBRSxXQUFXLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUMzRSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDcEQsT0FBTyxLQUFLLEVBQUUsS0FBSyxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFDekQsT0FBTyxFQUVMLEtBQUssZ0JBQWdCLEVBR3RCLE1BQU0seUJBQXlCLENBQUM7QUFDakMsT0FBTyxLQUFLLEVBQUUsNkJBQTZCLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNyRixPQUFPLEtBQUssRUFBRSxLQUFLLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUNsRCxPQUFPLEVBQ0wsc0JBQXNCLEVBQ3RCLGtDQUFrQyxFQUNsQyxvQ0FBb0MsRUFDcEMsNEJBQTRCLEVBQzVCLCtCQUErQixFQUMvQix1QkFBdUIsRUFDdkIsS0FBSyxzQkFBc0IsRUFDNUIsTUFBTSxzQkFBc0IsQ0FBQztBQUM5QixPQUFPLEVBQUUsc0JBQXNCLEVBQUUsS0FBSyxZQUFZLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUNoRixPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUlwRCxPQUFPLEVBQUUsc0JBQXNCLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUV2RSxNQUFNLE1BQU0sYUFBYSxHQUFHLEdBQUcsQ0FB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
@@ -1 +0,0 @@
1
- {"version":3,"file":"epoch-proving-state.d.ts","sourceRoot":"","sources":["../../src/orchestrator/epoch-proving-state.ts"],"names":[],"mappings":"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"}
@@ -1,269 +0,0 @@
1
- import { BatchedBlobAccumulator } from '@aztec/blob-lib';
2
- import { OUT_HASH_TREE_HEIGHT } from '@aztec/constants';
3
- import { Fr } from '@aztec/foundation/curves/bn254';
4
- import { MerkleTreeCalculator, UnbalancedTreeStore, shaMerkleHash } from '@aztec/foundation/trees';
5
- import { CheckpointMergeRollupPrivateInputs, CheckpointPaddingRollupPrivateInputs, RootRollupPrivateInputs } from '@aztec/stdlib/rollup';
6
- import { AppendOnlyTreeSnapshot } from '@aztec/stdlib/trees';
7
- import { toProofData } from './block-building-helpers.js';
8
- import { CheckpointProvingState } from './checkpoint-proving-state.js';
9
- var PROVING_STATE_LIFECYCLE = /*#__PURE__*/ function(PROVING_STATE_LIFECYCLE) {
10
- PROVING_STATE_LIFECYCLE[PROVING_STATE_LIFECYCLE["PROVING_STATE_CREATED"] = 0] = "PROVING_STATE_CREATED";
11
- PROVING_STATE_LIFECYCLE[PROVING_STATE_LIFECYCLE["PROVING_STATE_FULL"] = 1] = "PROVING_STATE_FULL";
12
- PROVING_STATE_LIFECYCLE[PROVING_STATE_LIFECYCLE["PROVING_STATE_RESOLVED"] = 2] = "PROVING_STATE_RESOLVED";
13
- PROVING_STATE_LIFECYCLE[PROVING_STATE_LIFECYCLE["PROVING_STATE_REJECTED"] = 3] = "PROVING_STATE_REJECTED";
14
- return PROVING_STATE_LIFECYCLE;
15
- }(PROVING_STATE_LIFECYCLE || {});
16
- /**
17
- * The current state of the proving schedule for an epoch.
18
- * Contains the raw inputs and intermediate state to generate every constituent proof in the tree.
19
- * Carries an identifier so we can identify if the proving state is discarded and a new one started.
20
- * Captures resolve and reject callbacks to provide a promise base interface to the consumer of our proving.
21
- */ export class EpochProvingState {
22
- epochNumber;
23
- totalNumCheckpoints;
24
- finalBlobBatchingChallenges;
25
- onCheckpointBlobAccumulatorSet;
26
- completionCallback;
27
- rejectionCallback;
28
- checkpointProofs;
29
- checkpointPaddingProof;
30
- rootRollupProof;
31
- checkpoints;
32
- startBlobAccumulator;
33
- endBlobAccumulator;
34
- finalBatchedBlob;
35
- provingStateLifecycle;
36
- // Map from tx hash to chonk verifier proof promise. Used when kickstarting chonk verifier proofs before tx processing.
37
- cachedChonkVerifierProofs;
38
- constructor(epochNumber, totalNumCheckpoints, finalBlobBatchingChallenges, onCheckpointBlobAccumulatorSet, completionCallback, rejectionCallback){
39
- this.epochNumber = epochNumber;
40
- this.totalNumCheckpoints = totalNumCheckpoints;
41
- this.finalBlobBatchingChallenges = finalBlobBatchingChallenges;
42
- this.onCheckpointBlobAccumulatorSet = onCheckpointBlobAccumulatorSet;
43
- this.completionCallback = completionCallback;
44
- this.rejectionCallback = rejectionCallback;
45
- this.checkpoints = [];
46
- this.provingStateLifecycle = 0;
47
- this.cachedChonkVerifierProofs = new Map();
48
- this.checkpointProofs = new UnbalancedTreeStore(totalNumCheckpoints);
49
- this.startBlobAccumulator = BatchedBlobAccumulator.newWithChallenges(finalBlobBatchingChallenges);
50
- }
51
- // Adds a block to the proving state, returns its index
52
- // Will update the proving life cycle if this is the last block
53
- startNewCheckpoint(checkpointIndex, constants, totalNumBlocks, previousBlockHeader, lastArchiveSiblingPath, l1ToL2Messages, lastL1ToL2MessageTreeSnapshot, lastL1ToL2MessageSubtreeRootSiblingPath, newL1ToL2MessageTreeSnapshot, newL1ToL2MessageSubtreeRootSiblingPath) {
54
- if (checkpointIndex >= this.totalNumCheckpoints) {
55
- throw new Error(`Unable to start a new checkpoint at index ${checkpointIndex}. Expected at most ${this.totalNumCheckpoints} checkpoints.`);
56
- }
57
- const checkpoint = new CheckpointProvingState(checkpointIndex, constants, totalNumBlocks, this.finalBlobBatchingChallenges, previousBlockHeader, lastArchiveSiblingPath, l1ToL2Messages, lastL1ToL2MessageTreeSnapshot, lastL1ToL2MessageSubtreeRootSiblingPath, newL1ToL2MessageTreeSnapshot, newL1ToL2MessageSubtreeRootSiblingPath, this, this.onCheckpointBlobAccumulatorSet);
58
- this.checkpoints[checkpointIndex] = checkpoint;
59
- if (this.checkpoints.filter((c)=>!!c).length === this.totalNumCheckpoints) {
60
- this.provingStateLifecycle = 1;
61
- }
62
- return checkpoint;
63
- }
64
- getCheckpointProvingState(index) {
65
- return this.checkpoints[index];
66
- }
67
- getCheckpointProvingStateByBlockNumber(blockNumber) {
68
- return this.checkpoints.find((c)=>c && Number(blockNumber) >= Number(c.firstBlockNumber) && Number(blockNumber) < Number(c.firstBlockNumber) + c.totalNumBlocks);
69
- }
70
- getBlockProvingStateByBlockNumber(blockNumber) {
71
- return this.getCheckpointProvingStateByBlockNumber(blockNumber)?.getBlockProvingStateByBlockNumber(blockNumber);
72
- }
73
- // Returns true if this proving state is still valid, false otherwise
74
- verifyState() {
75
- return this.provingStateLifecycle === 0 || this.provingStateLifecycle === 1;
76
- }
77
- // Returns true if we are still able to accept checkpoints, false otherwise.
78
- isAcceptingCheckpoints() {
79
- return this.checkpoints.filter((c)=>!!c).length < this.totalNumCheckpoints;
80
- }
81
- setCheckpointRootRollupProof(checkpointIndex, provingOutput) {
82
- return this.checkpointProofs.setLeaf(checkpointIndex, {
83
- provingOutput
84
- });
85
- }
86
- tryStartProvingCheckpointMerge(location) {
87
- if (this.checkpointProofs.getNode(location)?.isProving) {
88
- return false;
89
- } else {
90
- this.checkpointProofs.setNode(location, {
91
- isProving: true
92
- });
93
- return true;
94
- }
95
- }
96
- setCheckpointMergeRollupProof(location, provingOutput) {
97
- this.checkpointProofs.setNode(location, {
98
- provingOutput
99
- });
100
- }
101
- tryStartProvingRootRollup() {
102
- if (this.rootRollupProof?.isProving) {
103
- return false;
104
- } else {
105
- this.rootRollupProof = {
106
- isProving: true
107
- };
108
- return true;
109
- }
110
- }
111
- setRootRollupProof(provingOutput) {
112
- this.rootRollupProof = {
113
- provingOutput
114
- };
115
- }
116
- tryStartProvingPaddingCheckpoint() {
117
- if (this.checkpointPaddingProof?.isProving) {
118
- return false;
119
- } else {
120
- this.checkpointPaddingProof = {
121
- isProving: true
122
- };
123
- return true;
124
- }
125
- }
126
- setCheckpointPaddingProof(provingOutput) {
127
- this.checkpointPaddingProof = {
128
- provingOutput
129
- };
130
- }
131
- async accumulateCheckpointOutHashes() {
132
- const treeCalculator = await MerkleTreeCalculator.create(OUT_HASH_TREE_HEIGHT, undefined, (left, right)=>Promise.resolve(shaMerkleHash(left, right)));
133
- const computeOutHashHint = async (leaves)=>{
134
- const tree = await treeCalculator.computeTree(leaves.map((l)=>l.toBuffer()));
135
- const nextAvailableLeafIndex = leaves.length;
136
- return {
137
- treeSnapshot: new AppendOnlyTreeSnapshot(Fr.fromBuffer(tree.root), nextAvailableLeafIndex),
138
- siblingPath: tree.getSiblingPath(nextAvailableLeafIndex).map(Fr.fromBuffer)
139
- };
140
- };
141
- let hint = this.checkpoints[0]?.getOutHashHint();
142
- const outHashes = [];
143
- for(let i = 0; i < this.totalNumCheckpoints; i++){
144
- const checkpoint = this.checkpoints[i];
145
- if (!checkpoint) {
146
- break;
147
- }
148
- // If hints are not set yet, it must be the first checkpoint. Compute the hints with an empty tree.
149
- hint ??= await computeOutHashHint([]);
150
- checkpoint.setOutHashHint(hint);
151
- // Get the out hash for this checkpoint.
152
- const outHash = checkpoint.accumulateBlockOutHashes();
153
- if (!outHash) {
154
- break;
155
- }
156
- outHashes.push(outHash);
157
- // If this is NOT the last checkpoint, get or create the hint for the next checkpoint.
158
- if (i !== this.totalNumCheckpoints - 1) {
159
- hint = checkpoint.getOutHashHintForNextCheckpoint() ?? await computeOutHashHint(outHashes);
160
- checkpoint.setOutHashHintForNextCheckpoint(hint);
161
- }
162
- }
163
- }
164
- async setBlobAccumulators() {
165
- let previousAccumulator = this.startBlobAccumulator;
166
- // Accumulate blobs as far as we can for this epoch.
167
- for(let i = 0; i < this.totalNumCheckpoints; i++){
168
- const checkpoint = this.checkpoints[i];
169
- if (!checkpoint) {
170
- break;
171
- }
172
- const endAccumulator = checkpoint.getEndBlobAccumulator() || await checkpoint.accumulateBlobs(previousAccumulator);
173
- if (!endAccumulator) {
174
- break;
175
- }
176
- previousAccumulator = endAccumulator;
177
- // If this is the last checkpoint, set the end blob accumulator.
178
- if (i === this.totalNumCheckpoints - 1) {
179
- this.endBlobAccumulator = endAccumulator;
180
- }
181
- }
182
- }
183
- async finalizeBatchedBlob() {
184
- if (!this.endBlobAccumulator) {
185
- throw new Error('End blob accumulator not ready.');
186
- }
187
- this.finalBatchedBlob = await this.endBlobAccumulator.finalize(true);
188
- }
189
- getParentLocation(location) {
190
- return this.checkpointProofs.getParentLocation(location);
191
- }
192
- getCheckpointMergeRollupInputs(mergeLocation) {
193
- const [left, right] = this.checkpointProofs.getChildren(mergeLocation).map((c)=>c?.provingOutput);
194
- if (!left || !right) {
195
- throw new Error('At least one child is not ready for the checkpoint merge rollup.');
196
- }
197
- return new CheckpointMergeRollupPrivateInputs([
198
- toProofData(left),
199
- toProofData(right)
200
- ]);
201
- }
202
- getRootRollupInputs() {
203
- const [left, right] = this.#getChildProofsForRoot();
204
- if (!left || !right) {
205
- throw new Error('At least one child is not ready for the root rollup.');
206
- }
207
- return RootRollupPrivateInputs.from({
208
- previousRollups: [
209
- toProofData(left),
210
- toProofData(right)
211
- ]
212
- });
213
- }
214
- getPaddingCheckpointInputs() {
215
- return new CheckpointPaddingRollupPrivateInputs();
216
- }
217
- getEpochProofResult() {
218
- const provingOutput = this.rootRollupProof?.provingOutput;
219
- if (!provingOutput || !this.finalBatchedBlob) {
220
- throw new Error('Unable to get epoch proof result. Root rollup is not ready.');
221
- }
222
- return {
223
- proof: provingOutput.proof.binaryProof,
224
- publicInputs: provingOutput.inputs,
225
- batchedBlobInputs: this.finalBatchedBlob
226
- };
227
- }
228
- isReadyForCheckpointMerge(location) {
229
- return !!this.checkpointProofs.getSibling(location)?.provingOutput;
230
- }
231
- // Returns true if we have sufficient inputs to execute the block root rollup
232
- isReadyForRootRollup() {
233
- const childProofs = this.#getChildProofsForRoot();
234
- return childProofs.every((p)=>!!p);
235
- }
236
- // Attempts to reject the proving state promise with a reason of 'cancelled'
237
- cancel() {
238
- this.reject('Proving cancelled');
239
- }
240
- // Attempts to reject the proving state promise with the given reason
241
- // Does nothing if not in a valid state
242
- reject(reason) {
243
- if (!this.verifyState()) {
244
- return;
245
- }
246
- this.provingStateLifecycle = 3;
247
- this.rejectionCallback(reason);
248
- }
249
- // Attempts to resolve the proving state promise with the given result
250
- // Does nothing if not in a valid state
251
- resolve(result) {
252
- if (!this.verifyState()) {
253
- return;
254
- }
255
- this.provingStateLifecycle = 2;
256
- this.completionCallback(result);
257
- }
258
- #getChildProofsForRoot() {
259
- const rootLocation = {
260
- level: 0,
261
- index: 0
262
- };
263
- // If there's only 1 block, its block root proof will be stored at the root.
264
- return this.totalNumCheckpoints === 1 ? [
265
- this.checkpointProofs.getNode(rootLocation)?.provingOutput,
266
- this.checkpointPaddingProof?.provingOutput
267
- ] : this.checkpointProofs.getChildren(rootLocation).map((c)=>c?.provingOutput);
268
- }
269
- }