@aztec/prover-node 0.0.0-test.1 → 0.0.1-commit.0b941701

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 +26 -18
  29. package/dest/job/epoch-proving-job.d.ts.map +1 -1
  30. package/dest/job/epoch-proving-job.js +579 -96
  31. package/dest/metrics.d.ts +30 -5
  32. package/dest/metrics.d.ts.map +1 -1
  33. package/dest/metrics.js +103 -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 +14 -15
  39. package/dest/prover-node-publisher.d.ts.map +1 -1
  40. package/dest/prover-node-publisher.js +86 -81
  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 +581 -129
  44. package/dest/prover-publisher-factory.d.ts +23 -0
  45. package/dest/prover-publisher-factory.d.ts.map +1 -0
  46. package/dest/prover-publisher-factory.js +26 -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 +62 -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 +257 -82
  61. package/src/metrics.ts +116 -73
  62. package/src/monitors/epoch-monitor.ts +20 -15
  63. package/src/prover-node-publisher.ts +133 -115
  64. package/src/prover-node.ts +223 -142
  65. package/src/prover-publisher-factory.ts +39 -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,111 @@
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,
11
16
  } from '@aztec/telemetry-client';
12
17
 
13
- import { formatEther } from 'viem';
18
+ import { formatEther, formatUnits } from 'viem';
14
19
 
15
- export class ProverNodeMetrics {
20
+ export class ProverNodeJobMetrics {
16
21
  proverEpochExecutionDuration: Histogram;
17
22
  provingJobDuration: Histogram;
23
+ provingJobCheckpoints: Gauge;
18
24
  provingJobBlocks: Gauge;
19
25
  provingJobTransactions: Gauge;
20
26
 
27
+ constructor(
28
+ private meter: Meter,
29
+ public readonly tracer: Tracer,
30
+ private logger = createLogger('prover-node:publisher:metrics'),
31
+ ) {
32
+ this.proverEpochExecutionDuration = this.meter.createHistogram(Metrics.PROVER_NODE_EXECUTION_DURATION);
33
+ this.provingJobDuration = this.meter.createHistogram(Metrics.PROVER_NODE_JOB_DURATION);
34
+ this.provingJobCheckpoints = this.meter.createGauge(Metrics.PROVER_NODE_JOB_CHECKPOINTS);
35
+ this.provingJobBlocks = this.meter.createGauge(Metrics.PROVER_NODE_JOB_BLOCKS);
36
+ this.provingJobTransactions = this.meter.createGauge(Metrics.PROVER_NODE_JOB_TRANSACTIONS);
37
+ }
38
+
39
+ public recordProvingJob(
40
+ executionTimeMs: number,
41
+ totalTimeMs: number,
42
+ numCheckpoints: number,
43
+ numBlocks: number,
44
+ numTxs: number,
45
+ ) {
46
+ this.proverEpochExecutionDuration.record(Math.ceil(executionTimeMs));
47
+ this.provingJobDuration.record(totalTimeMs / 1000);
48
+ this.provingJobCheckpoints.record(Math.floor(numCheckpoints));
49
+ this.provingJobBlocks.record(Math.floor(numBlocks));
50
+ this.provingJobTransactions.record(Math.floor(numTxs));
51
+ }
52
+ }
53
+
54
+ export class ProverNodeRewardsMetrics {
55
+ private rewards: ObservableGauge;
56
+ private accumulatedRewards: UpDownCounter;
57
+ private prevEpoch = -1n;
58
+ private proofSubmissionEpochs = 0;
59
+
60
+ constructor(
61
+ private meter: Meter,
62
+ private coinbase: EthAddress,
63
+ private rollup: RollupContract,
64
+ private logger = createLogger('prover-node:publisher:metrics'),
65
+ ) {
66
+ this.rewards = this.meter.createObservableGauge(Metrics.PROVER_NODE_REWARDS_PER_EPOCH);
67
+
68
+ this.accumulatedRewards = this.meter.createUpDownCounter(Metrics.PROVER_NODE_REWARDS_TOTAL);
69
+ }
70
+
71
+ public async start() {
72
+ const proofSubmissionEpochs = await this.rollup.getProofSubmissionEpochs();
73
+ this.proofSubmissionEpochs = Number(proofSubmissionEpochs);
74
+ this.meter.addBatchObservableCallback(this.observe, [this.rewards]);
75
+ }
76
+
77
+ public stop() {
78
+ this.meter.removeBatchObservableCallback(this.observe, [this.rewards]);
79
+ }
80
+
81
+ private observe = async (observer: BatchObservableResult): Promise<void> => {
82
+ const epoch = await this.rollup.getCurrentEpochNumber();
83
+
84
+ if (epoch > this.proofSubmissionEpochs) {
85
+ // look at the prev epoch so that we get an accurate value, after proof submission window has closed
86
+ // For example, if proof submission window is 1 epoch, and we are in epoch 2, we should be looking at epoch 0.
87
+ // Similarly, if the proof submission window is 0, and we are in epoch 1, we should be looking at epoch 0.
88
+ const closedEpoch = BigInt(epoch) - BigInt(this.proofSubmissionEpochs) - 1n;
89
+ const rewards = await this.rollup.getSpecificProverRewardsForEpoch(closedEpoch, this.coinbase);
90
+
91
+ const fmt = parseFloat(formatUnits(rewards, 18));
92
+
93
+ observer.observe(this.rewards, fmt, {
94
+ [Attributes.COINBASE]: this.coinbase.toString(),
95
+ });
96
+
97
+ // only accumulate once per epoch
98
+ if (closedEpoch > this.prevEpoch) {
99
+ this.prevEpoch = closedEpoch;
100
+ this.accumulatedRewards.add(fmt, {
101
+ [Attributes.COINBASE]: this.coinbase.toString(),
102
+ });
103
+ }
104
+ }
105
+ };
106
+ }
107
+
108
+ export class ProverNodePublisherMetrics {
21
109
  gasPrice: Histogram;
22
110
  txCount: UpDownCounter;
23
111
  txDuration: Histogram;
@@ -26,85 +114,37 @@ export class ProverNodeMetrics {
26
114
  txCalldataGas: Histogram;
27
115
  txBlobDataGasUsed: Histogram;
28
116
  txBlobDataGasCost: Histogram;
117
+ txTotalFee: Histogram;
29
118
 
30
119
  private senderBalance: Gauge;
120
+ private meter: Meter;
31
121
 
32
122
  constructor(
33
123
  public readonly client: TelemetryClient,
34
124
  name = 'ProverNode',
35
125
  private logger = createLogger('prover-node:publisher:metrics'),
36
126
  ) {
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
- });
127
+ this.meter = client.getMeter(name);
56
128
 
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
- });
129
+ this.gasPrice = this.meter.createHistogram(Metrics.L1_PUBLISHER_GAS_PRICE);
62
130
 
63
- this.txCount = meter.createUpDownCounter(Metrics.L1_PUBLISHER_TX_COUNT, {
64
- description: 'The number of transactions processed',
65
- });
131
+ this.txCount = this.meter.createUpDownCounter(Metrics.L1_PUBLISHER_TX_COUNT);
66
132
 
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
- });
133
+ this.txDuration = this.meter.createHistogram(Metrics.L1_PUBLISHER_TX_DURATION);
72
134
 
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
- });
135
+ this.txGas = this.meter.createHistogram(Metrics.L1_PUBLISHER_TX_GAS);
78
136
 
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
- });
137
+ this.txCalldataSize = this.meter.createHistogram(Metrics.L1_PUBLISHER_TX_CALLDATA_SIZE);
84
138
 
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
- });
139
+ this.txCalldataGas = this.meter.createHistogram(Metrics.L1_PUBLISHER_TX_CALLDATA_GAS);
90
140
 
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
- });
141
+ this.txBlobDataGasUsed = this.meter.createHistogram(Metrics.L1_PUBLISHER_TX_BLOBDATA_GAS_USED);
96
142
 
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
- });
143
+ this.txBlobDataGasCost = this.meter.createHistogram(Metrics.L1_PUBLISHER_TX_BLOBDATA_GAS_COST);
102
144
 
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
- });
145
+ this.txTotalFee = this.meter.createHistogram(Metrics.L1_PUBLISHER_TX_TOTAL_FEE);
146
+
147
+ this.senderBalance = this.meter.createGauge(Metrics.L1_PUBLISHER_BALANCE);
108
148
  }
109
149
 
110
150
  recordFailedTx() {
@@ -118,13 +158,6 @@ export class ProverNodeMetrics {
118
158
  this.recordTx(durationMs, stats);
119
159
  }
120
160
 
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
161
  public recordSenderBalance(wei: bigint, senderAddress: string) {
129
162
  const eth = parseFloat(formatEther(wei, 'wei'));
130
163
  this.senderBalance.record(eth, {
@@ -157,7 +190,17 @@ export class ProverNodeMetrics {
157
190
 
158
191
  try {
159
192
  this.gasPrice.record(parseInt(formatEther(stats.gasPrice, 'gwei'), 10));
160
- } catch (e) {
193
+ } catch {
194
+ // ignore
195
+ }
196
+
197
+ const executionFee = stats.gasUsed * stats.gasPrice;
198
+ const blobFee = stats.blobGasUsed * stats.blobDataGas;
199
+ const totalFee = executionFee + blobFee;
200
+
201
+ try {
202
+ this.txTotalFee.record(parseFloat(formatEther(totalFee)));
203
+ } catch {
161
204
  // ignore
162
205
  }
163
206
  }
@@ -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 };