@aztec/prover-node 0.0.0-test.0 → 0.0.1-commit.0208eb9

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 (82) hide show
  1. package/dest/actions/download-epoch-proving-job.d.ts +18 -0
  2. package/dest/actions/download-epoch-proving-job.d.ts.map +1 -0
  3. package/dest/actions/download-epoch-proving-job.js +37 -0
  4. package/dest/actions/index.d.ts +3 -0
  5. package/dest/actions/index.d.ts.map +1 -0
  6. package/dest/actions/index.js +2 -0
  7. package/dest/actions/rerun-epoch-proving-job.d.ts +12 -0
  8. package/dest/actions/rerun-epoch-proving-job.d.ts.map +1 -0
  9. package/dest/actions/rerun-epoch-proving-job.js +42 -0
  10. package/dest/actions/upload-epoch-proof-failure.d.ts +15 -0
  11. package/dest/actions/upload-epoch-proof-failure.d.ts.map +1 -0
  12. package/dest/actions/upload-epoch-proof-failure.js +78 -0
  13. package/dest/bin/run-failed-epoch.d.ts +2 -0
  14. package/dest/bin/run-failed-epoch.d.ts.map +1 -0
  15. package/dest/bin/run-failed-epoch.js +67 -0
  16. package/dest/config.d.ts +15 -11
  17. package/dest/config.d.ts.map +1 -1
  18. package/dest/config.js +83 -15
  19. package/dest/factory.d.ts +14 -12
  20. package/dest/factory.d.ts.map +1 -1
  21. package/dest/factory.js +106 -37
  22. package/dest/index.d.ts +3 -2
  23. package/dest/index.d.ts.map +1 -1
  24. package/dest/index.js +2 -1
  25. package/dest/job/epoch-proving-job-data.d.ts +18 -0
  26. package/dest/job/epoch-proving-job-data.d.ts.map +1 -0
  27. package/dest/job/epoch-proving-job-data.js +59 -0
  28. package/dest/job/epoch-proving-job.d.ts +27 -18
  29. package/dest/job/epoch-proving-job.d.ts.map +1 -1
  30. package/dest/job/epoch-proving-job.js +583 -97
  31. package/dest/metrics.d.ts +30 -5
  32. package/dest/metrics.d.ts.map +1 -1
  33. package/dest/metrics.js +111 -73
  34. package/dest/monitors/epoch-monitor.d.ts +5 -2
  35. package/dest/monitors/epoch-monitor.d.ts.map +1 -1
  36. package/dest/monitors/epoch-monitor.js +18 -13
  37. package/dest/monitors/index.d.ts +1 -1
  38. package/dest/prover-node-publisher.d.ts +17 -17
  39. package/dest/prover-node-publisher.d.ts.map +1 -1
  40. package/dest/prover-node-publisher.js +89 -83
  41. package/dest/prover-node.d.ts +49 -44
  42. package/dest/prover-node.d.ts.map +1 -1
  43. package/dest/prover-node.js +582 -130
  44. package/dest/prover-publisher-factory.d.ts +25 -0
  45. package/dest/prover-publisher-factory.d.ts.map +1 -0
  46. package/dest/prover-publisher-factory.js +28 -0
  47. package/dest/test/index.d.ts +5 -3
  48. package/dest/test/index.d.ts.map +1 -1
  49. package/dest/test/index.js +1 -3
  50. package/package.json +39 -33
  51. package/src/actions/download-epoch-proving-job.ts +44 -0
  52. package/src/actions/index.ts +2 -0
  53. package/src/actions/rerun-epoch-proving-job.ts +63 -0
  54. package/src/actions/upload-epoch-proof-failure.ts +88 -0
  55. package/src/bin/run-failed-epoch.ts +77 -0
  56. package/src/config.ts +111 -25
  57. package/src/factory.ts +177 -46
  58. package/src/index.ts +2 -1
  59. package/src/job/epoch-proving-job-data.ts +82 -0
  60. package/src/job/epoch-proving-job.ts +264 -84
  61. package/src/metrics.ts +119 -72
  62. package/src/monitors/epoch-monitor.ts +20 -15
  63. package/src/prover-node-publisher.ts +137 -117
  64. package/src/prover-node.ts +225 -142
  65. package/src/prover-publisher-factory.ts +45 -0
  66. package/src/test/index.ts +7 -4
  67. package/dest/http.d.ts +0 -8
  68. package/dest/http.d.ts.map +0 -1
  69. package/dest/http.js +0 -9
  70. package/dest/prover-coordination/config.d.ts +0 -7
  71. package/dest/prover-coordination/config.d.ts.map +0 -1
  72. package/dest/prover-coordination/config.js +0 -11
  73. package/dest/prover-coordination/factory.d.ts +0 -22
  74. package/dest/prover-coordination/factory.d.ts.map +0 -1
  75. package/dest/prover-coordination/factory.js +0 -42
  76. package/dest/prover-coordination/index.d.ts +0 -3
  77. package/dest/prover-coordination/index.d.ts.map +0 -1
  78. package/dest/prover-coordination/index.js +0 -2
  79. package/src/http.ts +0 -13
  80. package/src/prover-coordination/config.ts +0 -17
  81. package/src/prover-coordination/factory.ts +0 -72
  82. package/src/prover-coordination/index.ts +0 -2
package/src/metrics.ts CHANGED
@@ -1,23 +1,112 @@
1
+ import type { RollupContract } from '@aztec/ethereum/contracts';
2
+ import type { EthAddress } from '@aztec/foundation/eth-address';
1
3
  import { createLogger } from '@aztec/foundation/log';
2
4
  import type { L1PublishProofStats, L1PublishStats } from '@aztec/stdlib/stats';
3
5
  import {
4
6
  Attributes,
7
+ type BatchObservableResult,
5
8
  type Gauge,
6
9
  type Histogram,
10
+ type Meter,
7
11
  Metrics,
12
+ type ObservableGauge,
8
13
  type TelemetryClient,
14
+ type Tracer,
9
15
  type UpDownCounter,
10
- ValueType,
16
+ createUpDownCounterWithDefault,
11
17
  } from '@aztec/telemetry-client';
12
18
 
13
- import { formatEther } from 'viem';
19
+ import { formatEther, formatUnits } from 'viem';
14
20
 
15
- export class ProverNodeMetrics {
21
+ export class ProverNodeJobMetrics {
16
22
  proverEpochExecutionDuration: Histogram;
17
23
  provingJobDuration: Histogram;
24
+ provingJobCheckpoints: Gauge;
18
25
  provingJobBlocks: Gauge;
19
26
  provingJobTransactions: Gauge;
20
27
 
28
+ constructor(
29
+ private meter: Meter,
30
+ public readonly tracer: Tracer,
31
+ private logger = createLogger('prover-node:publisher:metrics'),
32
+ ) {
33
+ this.proverEpochExecutionDuration = this.meter.createHistogram(Metrics.PROVER_NODE_EXECUTION_DURATION);
34
+ this.provingJobDuration = this.meter.createHistogram(Metrics.PROVER_NODE_JOB_DURATION);
35
+ this.provingJobCheckpoints = this.meter.createGauge(Metrics.PROVER_NODE_JOB_CHECKPOINTS);
36
+ this.provingJobBlocks = this.meter.createGauge(Metrics.PROVER_NODE_JOB_BLOCKS);
37
+ this.provingJobTransactions = this.meter.createGauge(Metrics.PROVER_NODE_JOB_TRANSACTIONS);
38
+ }
39
+
40
+ public recordProvingJob(
41
+ executionTimeMs: number,
42
+ totalTimeMs: number,
43
+ numCheckpoints: number,
44
+ numBlocks: number,
45
+ numTxs: number,
46
+ ) {
47
+ this.proverEpochExecutionDuration.record(Math.ceil(executionTimeMs));
48
+ this.provingJobDuration.record(totalTimeMs / 1000);
49
+ this.provingJobCheckpoints.record(Math.floor(numCheckpoints));
50
+ this.provingJobBlocks.record(Math.floor(numBlocks));
51
+ this.provingJobTransactions.record(Math.floor(numTxs));
52
+ }
53
+ }
54
+
55
+ export class ProverNodeRewardsMetrics {
56
+ private rewards: ObservableGauge;
57
+ private accumulatedRewards: UpDownCounter;
58
+ private prevEpoch = -1n;
59
+ private proofSubmissionEpochs = 0;
60
+
61
+ constructor(
62
+ private meter: Meter,
63
+ private coinbase: EthAddress,
64
+ private rollup: RollupContract,
65
+ private logger = createLogger('prover-node:publisher:metrics'),
66
+ ) {
67
+ this.rewards = this.meter.createObservableGauge(Metrics.PROVER_NODE_REWARDS_PER_EPOCH);
68
+
69
+ this.accumulatedRewards = createUpDownCounterWithDefault(this.meter, Metrics.PROVER_NODE_REWARDS_TOTAL);
70
+ }
71
+
72
+ public async start() {
73
+ const proofSubmissionEpochs = await this.rollup.getProofSubmissionEpochs();
74
+ this.proofSubmissionEpochs = Number(proofSubmissionEpochs);
75
+ this.meter.addBatchObservableCallback(this.observe, [this.rewards]);
76
+ }
77
+
78
+ public stop() {
79
+ this.meter.removeBatchObservableCallback(this.observe, [this.rewards]);
80
+ }
81
+
82
+ private observe = async (observer: BatchObservableResult): Promise<void> => {
83
+ const epoch = await this.rollup.getCurrentEpochNumber();
84
+
85
+ if (epoch > this.proofSubmissionEpochs) {
86
+ // look at the prev epoch so that we get an accurate value, after proof submission window has closed
87
+ // For example, if proof submission window is 1 epoch, and we are in epoch 2, we should be looking at epoch 0.
88
+ // Similarly, if the proof submission window is 0, and we are in epoch 1, we should be looking at epoch 0.
89
+ const closedEpoch = BigInt(epoch) - BigInt(this.proofSubmissionEpochs) - 1n;
90
+ const rewards = await this.rollup.getSpecificProverRewardsForEpoch(closedEpoch, this.coinbase);
91
+
92
+ const fmt = parseFloat(formatUnits(rewards, 18));
93
+
94
+ observer.observe(this.rewards, fmt, {
95
+ [Attributes.COINBASE]: this.coinbase.toString(),
96
+ });
97
+
98
+ // only accumulate once per epoch
99
+ if (closedEpoch > this.prevEpoch) {
100
+ this.prevEpoch = closedEpoch;
101
+ this.accumulatedRewards.add(fmt, {
102
+ [Attributes.COINBASE]: this.coinbase.toString(),
103
+ });
104
+ }
105
+ }
106
+ };
107
+ }
108
+
109
+ export class ProverNodePublisherMetrics {
21
110
  gasPrice: Histogram;
22
111
  txCount: UpDownCounter;
23
112
  txDuration: Histogram;
@@ -26,85 +115,40 @@ export class ProverNodeMetrics {
26
115
  txCalldataGas: Histogram;
27
116
  txBlobDataGasUsed: Histogram;
28
117
  txBlobDataGasCost: Histogram;
118
+ txTotalFee: Histogram;
29
119
 
30
120
  private senderBalance: Gauge;
121
+ private meter: Meter;
31
122
 
32
123
  constructor(
33
124
  public readonly client: TelemetryClient,
34
125
  name = 'ProverNode',
35
126
  private logger = createLogger('prover-node:publisher:metrics'),
36
127
  ) {
37
- const meter = client.getMeter(name);
38
- this.proverEpochExecutionDuration = meter.createHistogram(Metrics.PROVER_NODE_EXECUTION_DURATION, {
39
- description: 'Duration of execution of an epoch by the prover',
40
- unit: 'ms',
41
- valueType: ValueType.INT,
42
- });
43
- this.provingJobDuration = meter.createHistogram(Metrics.PROVER_NODE_JOB_DURATION, {
44
- description: 'Duration of proving job',
45
- unit: 's',
46
- valueType: ValueType.DOUBLE,
47
- });
48
- this.provingJobBlocks = meter.createGauge(Metrics.PROVER_NODE_JOB_BLOCKS, {
49
- description: 'Number of blocks in a proven epoch',
50
- valueType: ValueType.INT,
51
- });
52
- this.provingJobTransactions = meter.createGauge(Metrics.PROVER_NODE_JOB_TRANSACTIONS, {
53
- description: 'Number of transactions in a proven epoch',
54
- valueType: ValueType.INT,
55
- });
128
+ this.meter = client.getMeter(name);
56
129
 
57
- this.gasPrice = meter.createHistogram(Metrics.L1_PUBLISHER_GAS_PRICE, {
58
- description: 'The gas price used for transactions',
59
- unit: 'gwei',
60
- valueType: ValueType.DOUBLE,
61
- });
130
+ this.gasPrice = this.meter.createHistogram(Metrics.L1_PUBLISHER_GAS_PRICE);
62
131
 
63
- this.txCount = meter.createUpDownCounter(Metrics.L1_PUBLISHER_TX_COUNT, {
64
- description: 'The number of transactions processed',
132
+ this.txCount = createUpDownCounterWithDefault(this.meter, Metrics.L1_PUBLISHER_TX_COUNT, {
133
+ [Attributes.L1_TX_TYPE]: ['submitProof'],
134
+ [Attributes.OK]: [true, false],
65
135
  });
66
136
 
67
- this.txDuration = meter.createHistogram(Metrics.L1_PUBLISHER_TX_DURATION, {
68
- description: 'The duration of transaction processing',
69
- unit: 'ms',
70
- valueType: ValueType.INT,
71
- });
137
+ this.txDuration = this.meter.createHistogram(Metrics.L1_PUBLISHER_TX_DURATION);
72
138
 
73
- this.txGas = meter.createHistogram(Metrics.L1_PUBLISHER_TX_GAS, {
74
- description: 'The gas consumed by transactions',
75
- unit: 'gas',
76
- valueType: ValueType.INT,
77
- });
139
+ this.txGas = this.meter.createHistogram(Metrics.L1_PUBLISHER_TX_GAS);
78
140
 
79
- this.txCalldataSize = meter.createHistogram(Metrics.L1_PUBLISHER_TX_CALLDATA_SIZE, {
80
- description: 'The size of the calldata in transactions',
81
- unit: 'By',
82
- valueType: ValueType.INT,
83
- });
141
+ this.txCalldataSize = this.meter.createHistogram(Metrics.L1_PUBLISHER_TX_CALLDATA_SIZE);
84
142
 
85
- this.txCalldataGas = meter.createHistogram(Metrics.L1_PUBLISHER_TX_CALLDATA_GAS, {
86
- description: 'The gas consumed by the calldata in transactions',
87
- unit: 'gas',
88
- valueType: ValueType.INT,
89
- });
143
+ this.txCalldataGas = this.meter.createHistogram(Metrics.L1_PUBLISHER_TX_CALLDATA_GAS);
90
144
 
91
- this.txBlobDataGasUsed = meter.createHistogram(Metrics.L1_PUBLISHER_TX_BLOBDATA_GAS_USED, {
92
- description: 'The amount of blob gas used in transactions',
93
- unit: 'gas',
94
- valueType: ValueType.INT,
95
- });
145
+ this.txBlobDataGasUsed = this.meter.createHistogram(Metrics.L1_PUBLISHER_TX_BLOBDATA_GAS_USED);
96
146
 
97
- this.txBlobDataGasCost = meter.createHistogram(Metrics.L1_PUBLISHER_TX_BLOBDATA_GAS_COST, {
98
- description: 'The gas cost of blobs in transactions',
99
- unit: 'gwei',
100
- valueType: ValueType.INT,
101
- });
147
+ this.txBlobDataGasCost = this.meter.createHistogram(Metrics.L1_PUBLISHER_TX_BLOBDATA_GAS_COST);
102
148
 
103
- this.senderBalance = meter.createGauge(Metrics.L1_PUBLISHER_BALANCE, {
104
- unit: 'eth',
105
- description: 'The balance of the sender address',
106
- valueType: ValueType.DOUBLE,
107
- });
149
+ this.txTotalFee = this.meter.createHistogram(Metrics.L1_PUBLISHER_TX_TOTAL_FEE);
150
+
151
+ this.senderBalance = this.meter.createGauge(Metrics.L1_PUBLISHER_BALANCE);
108
152
  }
109
153
 
110
154
  recordFailedTx() {
@@ -118,13 +162,6 @@ export class ProverNodeMetrics {
118
162
  this.recordTx(durationMs, stats);
119
163
  }
120
164
 
121
- public recordProvingJob(executionTimeMs: number, totalTimeMs: number, numBlocks: number, numTxs: number) {
122
- this.proverEpochExecutionDuration.record(Math.ceil(executionTimeMs));
123
- this.provingJobDuration.record(totalTimeMs / 1000);
124
- this.provingJobBlocks.record(Math.floor(numBlocks));
125
- this.provingJobTransactions.record(Math.floor(numTxs));
126
- }
127
-
128
165
  public recordSenderBalance(wei: bigint, senderAddress: string) {
129
166
  const eth = parseFloat(formatEther(wei, 'wei'));
130
167
  this.senderBalance.record(eth, {
@@ -157,7 +194,17 @@ export class ProverNodeMetrics {
157
194
 
158
195
  try {
159
196
  this.gasPrice.record(parseInt(formatEther(stats.gasPrice, 'gwei'), 10));
160
- } catch (e) {
197
+ } catch {
198
+ // ignore
199
+ }
200
+
201
+ const executionFee = stats.gasUsed * stats.gasPrice;
202
+ const blobFee = stats.blobGasUsed * stats.blobDataGas;
203
+ const totalFee = executionFee + blobFee;
204
+
205
+ try {
206
+ this.txTotalFee.record(parseFloat(formatEther(totalFee)));
207
+ } catch {
161
208
  // ignore
162
209
  }
163
210
  }
@@ -1,17 +1,13 @@
1
+ import { BlockNumber, EpochNumber } from '@aztec/foundation/branded-types';
1
2
  import { createLogger } from '@aztec/foundation/log';
2
3
  import { RunningPromise } from '@aztec/foundation/running-promise';
4
+ import { sleep } from '@aztec/foundation/sleep';
3
5
  import type { L2BlockSource } from '@aztec/stdlib/block';
4
6
  import { type L1RollupConstants, getEpochAtSlot } from '@aztec/stdlib/epoch-helpers';
5
- import {
6
- type TelemetryClient,
7
- type Traceable,
8
- type Tracer,
9
- getTelemetryClient,
10
- trackSpan,
11
- } from '@aztec/telemetry-client';
7
+ import { type TelemetryClient, type Traceable, type Tracer, getTelemetryClient } from '@aztec/telemetry-client';
12
8
 
13
9
  export interface EpochMonitorHandler {
14
- handleEpochReadyToProve(epochNumber: bigint): Promise<void>;
10
+ handleEpochReadyToProve(epochNumber: EpochNumber): Promise<boolean>;
15
11
  }
16
12
 
17
13
  /**
@@ -31,21 +27,24 @@ export class EpochMonitor implements Traceable {
31
27
  public readonly tracer: Tracer;
32
28
 
33
29
  private handler: EpochMonitorHandler | undefined;
34
- private latestEpochNumber: bigint | undefined;
30
+ private latestEpochNumber: EpochNumber | undefined;
35
31
 
36
32
  constructor(
37
33
  private readonly l2BlockSource: L2BlockSource,
38
34
  private readonly l1Constants: Pick<L1RollupConstants, 'epochDuration'>,
39
- private options: { pollingIntervalMs: number },
35
+ private options: { pollingIntervalMs: number; provingDelayMs?: number },
40
36
  telemetry: TelemetryClient = getTelemetryClient(),
41
37
  ) {
42
38
  this.tracer = telemetry.getTracer('EpochMonitor');
43
39
  this.runningPromise = new RunningPromise(this.work.bind(this), this.log, this.options.pollingIntervalMs);
40
+ if (this.options.provingDelayMs) {
41
+ this.log.warn(`Prover node epoch monitor running with delay of ${this.options.provingDelayMs}ms`);
42
+ }
44
43
  }
45
44
 
46
45
  public static async create(
47
46
  l2BlockSource: L2BlockSource,
48
- options: { pollingIntervalMs: number },
47
+ options: { pollingIntervalMs: number; provingDelayMs?: number },
49
48
  telemetry: TelemetryClient = getTelemetryClient(),
50
49
  ): Promise<EpochMonitor> {
51
50
  const l1Constants = await l2BlockSource.getL1Constants();
@@ -68,9 +67,9 @@ export class EpochMonitor implements Traceable {
68
67
  this.log.info('Stopped EpochMonitor');
69
68
  }
70
69
 
71
- @trackSpan('EpochMonitor.work')
72
70
  public async work() {
73
71
  const { epochToProve, blockNumber, slotNumber } = await this.getEpochNumberToProve();
72
+ this.log.debug(`Epoch to prove: ${epochToProve}`, { blockNumber, slotNumber });
74
73
  if (epochToProve === undefined) {
75
74
  this.log.trace(`Next block to prove ${blockNumber} not yet mined`, { blockNumber });
76
75
  return;
@@ -86,14 +85,20 @@ export class EpochMonitor implements Traceable {
86
85
  return;
87
86
  }
88
87
 
88
+ if (this.options.provingDelayMs) {
89
+ this.log.debug(`Waiting ${this.options.provingDelayMs}ms before proving epoch ${epochToProve}`);
90
+ await sleep(this.options.provingDelayMs);
91
+ }
92
+
89
93
  this.log.debug(`Epoch ${epochToProve} is ready to be proven`);
90
- await this.handler?.handleEpochReadyToProve(epochToProve);
91
- this.latestEpochNumber = epochToProve;
94
+ if (await this.handler?.handleEpochReadyToProve(epochToProve)) {
95
+ this.latestEpochNumber = epochToProve;
96
+ }
92
97
  }
93
98
 
94
99
  private async getEpochNumberToProve() {
95
100
  const lastBlockProven = await this.l2BlockSource.getProvenBlockNumber();
96
- const firstBlockToProve = lastBlockProven + 1;
101
+ const firstBlockToProve = BlockNumber(lastBlockProven + 1);
97
102
  const firstBlockHeaderToProve = await this.l2BlockSource.getBlockHeader(firstBlockToProve);
98
103
  if (!firstBlockHeaderToProve) {
99
104
  return { epochToProve: undefined, blockNumber: firstBlockToProve };