@aztec/sequencer-client 0.0.1-commit.24de95ac → 0.0.1-commit.2606882

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 (153) hide show
  1. package/README.md +281 -21
  2. package/dest/client/index.d.ts +1 -1
  3. package/dest/client/sequencer-client.d.ts +26 -16
  4. package/dest/client/sequencer-client.d.ts.map +1 -1
  5. package/dest/client/sequencer-client.js +78 -37
  6. package/dest/config.d.ts +37 -8
  7. package/dest/config.d.ts.map +1 -1
  8. package/dest/config.js +139 -48
  9. package/dest/global_variable_builder/fee_predictor.d.ts +37 -0
  10. package/dest/global_variable_builder/fee_predictor.d.ts.map +1 -0
  11. package/dest/global_variable_builder/fee_predictor.js +128 -0
  12. package/dest/global_variable_builder/fee_provider.d.ts +21 -0
  13. package/dest/global_variable_builder/fee_provider.d.ts.map +1 -0
  14. package/dest/global_variable_builder/fee_provider.js +58 -0
  15. package/dest/global_variable_builder/global_builder.d.ts +24 -20
  16. package/dest/global_variable_builder/global_builder.d.ts.map +1 -1
  17. package/dest/global_variable_builder/global_builder.js +44 -65
  18. package/dest/global_variable_builder/index.d.ts +4 -2
  19. package/dest/global_variable_builder/index.d.ts.map +1 -1
  20. package/dest/global_variable_builder/index.js +2 -0
  21. package/dest/index.d.ts +2 -3
  22. package/dest/index.d.ts.map +1 -1
  23. package/dest/index.js +1 -2
  24. package/dest/publisher/config.d.ts +55 -20
  25. package/dest/publisher/config.d.ts.map +1 -1
  26. package/dest/publisher/config.js +124 -34
  27. package/dest/publisher/index.d.ts +2 -1
  28. package/dest/publisher/index.d.ts.map +1 -1
  29. package/dest/publisher/l1_tx_failed_store/factory.d.ts +11 -0
  30. package/dest/publisher/l1_tx_failed_store/factory.d.ts.map +1 -0
  31. package/dest/publisher/l1_tx_failed_store/factory.js +22 -0
  32. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts +58 -0
  33. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts.map +1 -0
  34. package/dest/publisher/l1_tx_failed_store/failed_tx_store.js +1 -0
  35. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts +15 -0
  36. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts.map +1 -0
  37. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.js +34 -0
  38. package/dest/publisher/l1_tx_failed_store/index.d.ts +4 -0
  39. package/dest/publisher/l1_tx_failed_store/index.d.ts.map +1 -0
  40. package/dest/publisher/l1_tx_failed_store/index.js +2 -0
  41. package/dest/publisher/sequencer-bundle-simulator.d.ts +96 -0
  42. package/dest/publisher/sequencer-bundle-simulator.d.ts.map +1 -0
  43. package/dest/publisher/sequencer-bundle-simulator.js +198 -0
  44. package/dest/publisher/sequencer-publisher-factory.d.ts +15 -8
  45. package/dest/publisher/sequencer-publisher-factory.d.ts.map +1 -1
  46. package/dest/publisher/sequencer-publisher-factory.js +28 -4
  47. package/dest/publisher/sequencer-publisher-metrics.d.ts +3 -3
  48. package/dest/publisher/sequencer-publisher-metrics.d.ts.map +1 -1
  49. package/dest/publisher/sequencer-publisher-metrics.js +23 -86
  50. package/dest/publisher/sequencer-publisher.d.ts +137 -97
  51. package/dest/publisher/sequencer-publisher.d.ts.map +1 -1
  52. package/dest/publisher/sequencer-publisher.js +1001 -416
  53. package/dest/sequencer/automine/automine_factory.d.ts +54 -0
  54. package/dest/sequencer/automine/automine_factory.d.ts.map +1 -0
  55. package/dest/sequencer/automine/automine_factory.js +84 -0
  56. package/dest/sequencer/automine/automine_sequencer.d.ts +151 -0
  57. package/dest/sequencer/automine/automine_sequencer.d.ts.map +1 -0
  58. package/dest/sequencer/automine/automine_sequencer.js +509 -0
  59. package/dest/sequencer/chain_state_overrides.d.ts +61 -0
  60. package/dest/sequencer/chain_state_overrides.d.ts.map +1 -0
  61. package/dest/sequencer/chain_state_overrides.js +98 -0
  62. package/dest/sequencer/checkpoint_proposal_job.d.ts +150 -0
  63. package/dest/sequencer/checkpoint_proposal_job.d.ts.map +1 -0
  64. package/dest/sequencer/checkpoint_proposal_job.js +1792 -0
  65. package/dest/sequencer/checkpoint_proposal_job_metrics.d.ts +34 -0
  66. package/dest/sequencer/checkpoint_proposal_job_metrics.d.ts.map +1 -0
  67. package/dest/sequencer/checkpoint_proposal_job_metrics.js +72 -0
  68. package/dest/sequencer/checkpoint_voter.d.ts +34 -0
  69. package/dest/sequencer/checkpoint_voter.d.ts.map +1 -0
  70. package/dest/sequencer/checkpoint_voter.js +106 -0
  71. package/dest/sequencer/config.d.ts +3 -2
  72. package/dest/sequencer/config.d.ts.map +1 -1
  73. package/dest/sequencer/errors.d.ts +1 -1
  74. package/dest/sequencer/errors.d.ts.map +1 -1
  75. package/dest/sequencer/events.d.ts +92 -0
  76. package/dest/sequencer/events.d.ts.map +1 -0
  77. package/dest/sequencer/events.js +1 -0
  78. package/dest/sequencer/index.d.ts +6 -2
  79. package/dest/sequencer/index.d.ts.map +1 -1
  80. package/dest/sequencer/index.js +5 -1
  81. package/dest/sequencer/metrics.d.ts +48 -4
  82. package/dest/sequencer/metrics.d.ts.map +1 -1
  83. package/dest/sequencer/metrics.js +257 -50
  84. package/dest/sequencer/sequencer.d.ts +175 -144
  85. package/dest/sequencer/sequencer.d.ts.map +1 -1
  86. package/dest/sequencer/sequencer.js +1022 -567
  87. package/dest/sequencer/timetable.d.ts +64 -16
  88. package/dest/sequencer/timetable.d.ts.map +1 -1
  89. package/dest/sequencer/timetable.js +154 -64
  90. package/dest/sequencer/types.d.ts +3 -0
  91. package/dest/sequencer/types.d.ts.map +1 -0
  92. package/dest/sequencer/types.js +1 -0
  93. package/dest/sequencer/utils.d.ts +14 -8
  94. package/dest/sequencer/utils.d.ts.map +1 -1
  95. package/dest/sequencer/utils.js +7 -4
  96. package/dest/test/index.d.ts +6 -7
  97. package/dest/test/index.d.ts.map +1 -1
  98. package/dest/test/mock_checkpoint_builder.d.ts +95 -0
  99. package/dest/test/mock_checkpoint_builder.d.ts.map +1 -0
  100. package/dest/test/mock_checkpoint_builder.js +231 -0
  101. package/dest/test/utils.d.ts +53 -0
  102. package/dest/test/utils.d.ts.map +1 -0
  103. package/dest/test/utils.js +105 -0
  104. package/package.json +32 -30
  105. package/src/client/sequencer-client.ts +105 -60
  106. package/src/config.ts +163 -57
  107. package/src/global_variable_builder/README.md +44 -0
  108. package/src/global_variable_builder/fee_predictor.ts +172 -0
  109. package/src/global_variable_builder/fee_provider.ts +75 -0
  110. package/src/global_variable_builder/global_builder.ts +63 -92
  111. package/src/global_variable_builder/index.ts +3 -1
  112. package/src/index.ts +5 -2
  113. package/src/publisher/config.ts +174 -51
  114. package/src/publisher/index.ts +3 -0
  115. package/src/publisher/l1_tx_failed_store/factory.ts +32 -0
  116. package/src/publisher/l1_tx_failed_store/failed_tx_store.ts +57 -0
  117. package/src/publisher/l1_tx_failed_store/file_store_failed_tx_store.ts +46 -0
  118. package/src/publisher/l1_tx_failed_store/index.ts +3 -0
  119. package/src/publisher/sequencer-bundle-simulator.ts +254 -0
  120. package/src/publisher/sequencer-publisher-factory.ts +45 -14
  121. package/src/publisher/sequencer-publisher-metrics.ts +19 -71
  122. package/src/publisher/sequencer-publisher.ts +795 -538
  123. package/src/sequencer/README.md +243 -0
  124. package/src/sequencer/automine/README.md +46 -0
  125. package/src/sequencer/automine/automine_factory.ts +145 -0
  126. package/src/sequencer/automine/automine_sequencer.ts +595 -0
  127. package/src/sequencer/chain_state_overrides.ts +162 -0
  128. package/src/sequencer/checkpoint_proposal_job.ts +1632 -0
  129. package/src/sequencer/checkpoint_proposal_job_metrics.ts +128 -0
  130. package/src/sequencer/checkpoint_voter.ts +119 -0
  131. package/src/sequencer/config.ts +2 -1
  132. package/src/sequencer/events.ts +76 -0
  133. package/src/sequencer/index.ts +5 -1
  134. package/src/sequencer/metrics.ts +330 -62
  135. package/src/sequencer/sequencer.ts +831 -748
  136. package/src/sequencer/timetable.ts +181 -81
  137. package/src/sequencer/types.ts +6 -0
  138. package/src/sequencer/utils.ts +18 -9
  139. package/src/test/index.ts +5 -6
  140. package/src/test/mock_checkpoint_builder.ts +323 -0
  141. package/src/test/utils.ts +185 -0
  142. package/dest/sequencer/block_builder.d.ts +0 -27
  143. package/dest/sequencer/block_builder.d.ts.map +0 -1
  144. package/dest/sequencer/block_builder.js +0 -130
  145. package/dest/tx_validator/nullifier_cache.d.ts +0 -14
  146. package/dest/tx_validator/nullifier_cache.d.ts.map +0 -1
  147. package/dest/tx_validator/nullifier_cache.js +0 -24
  148. package/dest/tx_validator/tx_validator_factory.d.ts +0 -17
  149. package/dest/tx_validator/tx_validator_factory.d.ts.map +0 -1
  150. package/dest/tx_validator/tx_validator_factory.js +0 -53
  151. package/src/sequencer/block_builder.ts +0 -218
  152. package/src/tx_validator/nullifier_cache.ts +0 -30
  153. package/src/tx_validator/tx_validator_factory.ts +0 -132
@@ -1,4 +1,4 @@
1
- import { Attributes, Metrics, ValueType } from '@aztec/telemetry-client';
1
+ import { Attributes, Metrics, createUpDownCounterWithDefault } from '@aztec/telemetry-client';
2
2
  import { formatUnits } from 'viem';
3
3
  export class SequencerMetrics {
4
4
  rollup;
@@ -8,6 +8,7 @@ export class SequencerMetrics {
8
8
  blockBuildDuration;
9
9
  blockBuildManaPerSecond;
10
10
  stateTransitionBufferDuration;
11
+ stateDuration;
11
12
  // these are gauges because for individual sequencers building a block is not something that happens often enough to warrant a histogram
12
13
  timeToCollectAttestations;
13
14
  allowanceToCollectAttestations;
@@ -16,67 +17,113 @@ export class SequencerMetrics {
16
17
  rewards;
17
18
  slots;
18
19
  filledSlots;
20
+ blockProposalFailed;
21
+ checkpointProposalSuccess;
22
+ checkpointPrecheckFailed;
23
+ checkpointProposalFailed;
24
+ checkpointSuccess;
25
+ slashingAttempts;
26
+ pipelineDepth;
27
+ pipelineDiscards;
28
+ pipelineParentCheckpointMismatches;
29
+ // Fisherman fee analysis metrics
30
+ fishermanWouldBeIncluded;
31
+ fishermanTimeBeforeBlock;
32
+ fishermanPendingBlobTxCount;
33
+ fishermanIncludedBlobTxCount;
34
+ fishermanPendingBlobCount;
35
+ fishermanIncludedBlobCount;
36
+ fishermanBlockBlobsFull;
37
+ fishermanMaxBlobCapacity;
38
+ fishermanCalculatedPriorityFee;
39
+ fishermanPriorityFeeDelta;
40
+ fishermanEstimatedCost;
41
+ fishermanEstimatedOverpayment;
42
+ fishermanMinedBlobTxPriorityFee;
43
+ fishermanMinedBlobTxTotalCost;
44
+ blockInterBlockTime;
45
+ lastBlockBuiltTimestamp;
46
+ lastBlockBuiltSlot;
19
47
  lastSeenSlot;
20
48
  constructor(client, rollup, name = 'Sequencer'){
21
49
  this.rollup = rollup;
22
50
  this.meter = client.getMeter(name);
23
51
  this.tracer = client.getTracer(name);
24
- this.blockCounter = this.meter.createUpDownCounter(Metrics.SEQUENCER_BLOCK_COUNT);
25
- this.blockBuildDuration = this.meter.createHistogram(Metrics.SEQUENCER_BLOCK_BUILD_DURATION, {
26
- unit: 'ms',
27
- description: 'Duration to build a block',
28
- valueType: ValueType.INT
29
- });
30
- this.blockBuildManaPerSecond = this.meter.createGauge(Metrics.SEQUENCER_BLOCK_BUILD_MANA_PER_SECOND, {
31
- unit: 'mana/s',
32
- description: 'Mana per second when building a block',
33
- valueType: ValueType.INT
34
- });
35
- this.stateTransitionBufferDuration = this.meter.createHistogram(Metrics.SEQUENCER_STATE_TRANSITION_BUFFER_DURATION, {
36
- unit: 'ms',
37
- description: 'The time difference between when the sequencer needed to transition to a new state and when it actually did.',
38
- valueType: ValueType.INT
39
- });
40
- // Init gauges and counters
41
- this.blockCounter.add(0, {
42
- [Attributes.STATUS]: 'failed'
43
- });
44
- this.blockCounter.add(0, {
45
- [Attributes.STATUS]: 'built'
46
- });
47
- this.rewards = this.meter.createGauge(Metrics.SEQUENCER_CURRENT_BLOCK_REWARDS, {
48
- valueType: ValueType.DOUBLE,
49
- description: 'The rewards earned'
50
- });
51
- this.slots = this.meter.createUpDownCounter(Metrics.SEQUENCER_SLOT_COUNT, {
52
- valueType: ValueType.INT,
53
- description: 'The number of slots this sequencer was selected for'
52
+ this.blockCounter = createUpDownCounterWithDefault(this.meter, Metrics.SEQUENCER_BLOCK_COUNT, {
53
+ [Attributes.STATUS]: [
54
+ 'failed',
55
+ 'built'
56
+ ]
54
57
  });
58
+ this.blockBuildDuration = this.meter.createHistogram(Metrics.SEQUENCER_BLOCK_BUILD_DURATION);
59
+ this.blockBuildManaPerSecond = this.meter.createGauge(Metrics.SEQUENCER_BLOCK_BUILD_MANA_PER_SECOND);
60
+ this.blockInterBlockTime = this.meter.createHistogram(Metrics.SEQUENCER_BLOCK_INTER_BLOCK_TIME);
61
+ this.stateTransitionBufferDuration = this.meter.createHistogram(Metrics.SEQUENCER_STATE_TRANSITION_BUFFER_DURATION);
62
+ this.stateDuration = this.meter.createHistogram(Metrics.SEQUENCER_STATE_DURATION);
63
+ this.rewards = this.meter.createGauge(Metrics.SEQUENCER_CURRENT_SLOT_REWARDS);
64
+ this.slots = createUpDownCounterWithDefault(this.meter, Metrics.SEQUENCER_SLOT_COUNT);
55
65
  /**
56
66
  * NOTE: we do not track missed slots as a separate metric. That would be difficult to determine
57
67
  * Instead, use a computed metric, `slots - filledSlots` to get the number of slots a sequencer has missed.
58
- */ this.filledSlots = this.meter.createUpDownCounter(Metrics.SEQUENCER_FILLED_SLOT_COUNT, {
59
- valueType: ValueType.INT,
60
- description: 'The number of slots this sequencer has filled'
61
- });
62
- this.timeToCollectAttestations = this.meter.createGauge(Metrics.SEQUENCER_COLLECT_ATTESTATIONS_DURATION, {
63
- description: 'The time spent collecting attestations from committee members',
64
- unit: 'ms',
65
- valueType: ValueType.INT
68
+ */ this.filledSlots = createUpDownCounterWithDefault(this.meter, Metrics.SEQUENCER_FILLED_SLOT_COUNT);
69
+ this.timeToCollectAttestations = this.meter.createGauge(Metrics.SEQUENCER_COLLECT_ATTESTATIONS_DURATION);
70
+ this.allowanceToCollectAttestations = this.meter.createGauge(Metrics.SEQUENCER_COLLECT_ATTESTATIONS_TIME_ALLOWANCE);
71
+ this.requiredAttestions = this.meter.createGauge(Metrics.SEQUENCER_REQUIRED_ATTESTATIONS_COUNT);
72
+ this.collectedAttestions = this.meter.createGauge(Metrics.SEQUENCER_COLLECTED_ATTESTATIONS_COUNT);
73
+ this.blockProposalFailed = createUpDownCounterWithDefault(this.meter, Metrics.SEQUENCER_BLOCK_PROPOSAL_FAILED_COUNT);
74
+ this.checkpointProposalSuccess = createUpDownCounterWithDefault(this.meter, Metrics.SEQUENCER_CHECKPOINT_PROPOSAL_SUCCESS_COUNT);
75
+ this.checkpointSuccess = createUpDownCounterWithDefault(this.meter, Metrics.SEQUENCER_CHECKPOINT_SUCCESS_COUNT);
76
+ this.checkpointPrecheckFailed = createUpDownCounterWithDefault(this.meter, Metrics.SEQUENCER_CHECKPOINT_PRECHECK_FAILED_COUNT, {
77
+ [Attributes.ERROR_TYPE]: [
78
+ 'slot_already_taken',
79
+ 'rollup_contract_check_failed',
80
+ 'slot_mismatch',
81
+ 'block_number_mismatch'
82
+ ]
66
83
  });
67
- this.allowanceToCollectAttestations = this.meter.createGauge(Metrics.SEQUENCER_COLLECT_ATTESTATIONS_TIME_ALLOWANCE, {
68
- description: 'Maximum amount of time to collect attestations',
69
- unit: 'ms',
70
- valueType: ValueType.INT
84
+ this.checkpointProposalFailed = createUpDownCounterWithDefault(this.meter, Metrics.SEQUENCER_CHECKPOINT_PROPOSAL_FAILED_COUNT);
85
+ this.slashingAttempts = createUpDownCounterWithDefault(this.meter, Metrics.SEQUENCER_SLASHING_ATTEMPTS_COUNT);
86
+ this.pipelineDepth = this.meter.createGauge(Metrics.SEQUENCER_PIPELINE_DEPTH);
87
+ this.pipelineDiscards = createUpDownCounterWithDefault(this.meter, Metrics.SEQUENCER_PIPELINE_DISCARDS_COUNT);
88
+ this.pipelineParentCheckpointMismatches = createUpDownCounterWithDefault(this.meter, Metrics.SEQUENCER_PIPELINE_PARENT_CHECKPOINT_MISMATCH_COUNT, {
89
+ [Attributes.ERROR_TYPE]: [
90
+ 'archiver-sync-timeout',
91
+ 'parent-not-on-l1',
92
+ 'parent-hash-mismatch',
93
+ 'parent-invalid-attestations',
94
+ 'unexpected-parent-appeared'
95
+ ]
71
96
  });
72
- this.requiredAttestions = this.meter.createGauge(Metrics.SEQUENCER_REQUIRED_ATTESTATIONS_COUNT, {
73
- valueType: ValueType.INT,
74
- description: 'The minimum number of attestations required to publish a block'
97
+ this.pipelineDepth.record(0);
98
+ // Fisherman fee analysis metrics
99
+ this.fishermanWouldBeIncluded = createUpDownCounterWithDefault(this.meter, Metrics.FISHERMAN_FEE_ANALYSIS_WOULD_BE_INCLUDED, {
100
+ [Attributes.OK]: [
101
+ true,
102
+ false
103
+ ],
104
+ [Attributes.BLOCK_FULL]: [
105
+ 'true',
106
+ 'false'
107
+ ]
75
108
  });
76
- this.collectedAttestions = this.meter.createGauge(Metrics.SEQUENCER_COLLECTED_ATTESTATIONS_COUNT, {
77
- valueType: ValueType.INT,
78
- description: 'The minimum number of attestations required to publish a block'
109
+ this.fishermanTimeBeforeBlock = this.meter.createHistogram(Metrics.FISHERMAN_FEE_ANALYSIS_TIME_BEFORE_BLOCK);
110
+ this.fishermanPendingBlobTxCount = this.meter.createHistogram(Metrics.FISHERMAN_FEE_ANALYSIS_PENDING_BLOB_TX_COUNT);
111
+ this.fishermanIncludedBlobTxCount = this.meter.createHistogram(Metrics.FISHERMAN_FEE_ANALYSIS_INCLUDED_BLOB_TX_COUNT);
112
+ this.fishermanCalculatedPriorityFee = this.meter.createHistogram(Metrics.FISHERMAN_FEE_ANALYSIS_CALCULATED_PRIORITY_FEE);
113
+ this.fishermanPriorityFeeDelta = this.meter.createHistogram(Metrics.FISHERMAN_FEE_ANALYSIS_PRIORITY_FEE_DELTA);
114
+ this.fishermanEstimatedCost = this.meter.createHistogram(Metrics.FISHERMAN_FEE_ANALYSIS_ESTIMATED_COST);
115
+ this.fishermanEstimatedOverpayment = this.meter.createHistogram(Metrics.FISHERMAN_FEE_ANALYSIS_ESTIMATED_OVERPAYMENT);
116
+ this.fishermanMinedBlobTxPriorityFee = this.meter.createHistogram(Metrics.FISHERMAN_FEE_ANALYSIS_MINED_BLOB_TX_PRIORITY_FEE);
117
+ this.fishermanMinedBlobTxTotalCost = this.meter.createHistogram(Metrics.FISHERMAN_FEE_ANALYSIS_MINED_BLOB_TX_TOTAL_COST);
118
+ this.fishermanPendingBlobCount = this.meter.createHistogram(Metrics.FISHERMAN_FEE_ANALYSIS_PENDING_BLOB_COUNT);
119
+ this.fishermanIncludedBlobCount = this.meter.createHistogram(Metrics.FISHERMAN_FEE_ANALYSIS_INCLUDED_BLOB_COUNT);
120
+ this.fishermanBlockBlobsFull = createUpDownCounterWithDefault(this.meter, Metrics.FISHERMAN_FEE_ANALYSIS_BLOCK_BLOBS_FULL, {
121
+ [Attributes.OK]: [
122
+ true,
123
+ false
124
+ ]
79
125
  });
126
+ this.fishermanMaxBlobCapacity = this.meter.createHistogram(Metrics.FISHERMAN_FEE_ANALYSIS_MAX_BLOB_CAPACITY);
80
127
  }
81
128
  recordRequiredAttestations(requiredAttestationsCount, allowanceMs) {
82
129
  this.requiredAttestions.record(requiredAttestationsCount);
@@ -89,12 +136,19 @@ export class SequencerMetrics {
89
136
  this.collectedAttestions.record(count);
90
137
  this.timeToCollectAttestations.record(Math.ceil(durationMs));
91
138
  }
92
- recordBuiltBlock(buildDurationMs, totalMana) {
139
+ recordBuiltBlock(buildDurationMs, totalMana, slot) {
93
140
  this.blockCounter.add(1, {
94
141
  [Attributes.STATUS]: 'built'
95
142
  });
96
143
  this.blockBuildDuration.record(Math.ceil(buildDurationMs));
97
144
  this.blockBuildManaPerSecond.record(Math.ceil(totalMana * 1000 / buildDurationMs));
145
+ // Only record inter-block time between blocks built within the same slot.
146
+ const now = Date.now();
147
+ if (this.lastBlockBuiltTimestamp !== undefined && this.lastBlockBuiltSlot === slot) {
148
+ this.blockInterBlockTime.record(now - this.lastBlockBuiltTimestamp);
149
+ }
150
+ this.lastBlockBuiltTimestamp = now;
151
+ this.lastBlockBuiltSlot = slot;
98
152
  }
99
153
  recordFailedBlock() {
100
154
  this.blockCounter.add(1, {
@@ -106,6 +160,22 @@ export class SequencerMetrics {
106
160
  [Attributes.SEQUENCER_STATE]: state
107
161
  });
108
162
  }
163
+ recordStateDuration(durationMs, state) {
164
+ this.stateDuration.record(Math.ceil(durationMs), {
165
+ [Attributes.SEQUENCER_STATE]: state
166
+ });
167
+ }
168
+ recordPipelineDepth(depth) {
169
+ this.pipelineDepth.record(depth);
170
+ }
171
+ recordPipelineDiscard(count = 1) {
172
+ this.pipelineDiscards.add(count);
173
+ }
174
+ recordPipelineParentCheckpointMismatch(reason) {
175
+ this.pipelineParentCheckpointMismatches.add(1, {
176
+ [Attributes.ERROR_TYPE]: reason
177
+ });
178
+ }
109
179
  incOpenSlot(slot, proposer) {
110
180
  // sequencer went through the loop a second time. Noop
111
181
  if (slot === this.lastSeenSlot) {
@@ -133,4 +203,141 @@ export class SequencerMetrics {
133
203
  }
134
204
  }
135
205
  }
206
+ recordCheckpointSuccess() {
207
+ this.checkpointSuccess.add(1);
208
+ }
209
+ recordBlockProposalFailed(reason) {
210
+ this.blockProposalFailed.add(1, {
211
+ ...reason && {
212
+ [Attributes.ERROR_TYPE]: reason
213
+ }
214
+ });
215
+ }
216
+ recordCheckpointProposalSuccess() {
217
+ this.checkpointProposalSuccess.add(1);
218
+ }
219
+ recordCheckpointPrecheckFailed(checkType) {
220
+ this.checkpointPrecheckFailed.add(1, {
221
+ [Attributes.ERROR_TYPE]: checkType
222
+ });
223
+ }
224
+ recordCheckpointProposalFailed(reason) {
225
+ this.checkpointProposalFailed.add(1, {
226
+ ...reason && {
227
+ [Attributes.ERROR_TYPE]: reason
228
+ }
229
+ });
230
+ }
231
+ recordSlashingAttempt(actionCount) {
232
+ this.slashingAttempts.add(actionCount);
233
+ }
234
+ /**
235
+ * Records metrics for a completed fisherman fee analysis
236
+ * @param analysis - The completed fee analysis result
237
+ */ recordFishermanFeeAnalysis(analysis) {
238
+ // In fisherman mode, we should always have strategy results
239
+ if (!analysis.computedPrices.strategyResults || analysis.computedPrices.strategyResults.length === 0) {
240
+ // This should never happen in fisherman mode - log an error
241
+ // We don't record metrics without strategy IDs as that defeats the purpose
242
+ throw new Error(`No strategy results found in fisherman fee analysis ${analysis.id}. This indicates a bug in the fee analysis.`);
243
+ }
244
+ // Record metrics for each strategy separately
245
+ for (const strategyResult of analysis.computedPrices.strategyResults){
246
+ const strategyAttributes = {
247
+ [Attributes.FISHERMAN_FEE_STRATEGY_ID]: strategyResult.strategyId
248
+ };
249
+ // Record pending block snapshot data (once per strategy for comparison)
250
+ this.fishermanPendingBlobTxCount.record(analysis.pendingSnapshot.pendingBlobTxCount, strategyAttributes);
251
+ this.fishermanPendingBlobCount.record(analysis.pendingSnapshot.pendingBlobCount, strategyAttributes);
252
+ // Record mined block data if available
253
+ if (analysis.minedBlock) {
254
+ this.fishermanIncludedBlobTxCount.record(analysis.minedBlock.includedBlobTxCount, strategyAttributes);
255
+ this.fishermanIncludedBlobCount.record(analysis.minedBlock.includedBlobCount, strategyAttributes);
256
+ // Record actual fees from blob transactions in the mined block
257
+ for (const blobTx of analysis.minedBlock.includedBlobTxs){
258
+ // Record priority fee per gas in Gwei
259
+ const priorityFeeGwei = Number(blobTx.maxPriorityFeePerGas) / 1e9;
260
+ this.fishermanMinedBlobTxPriorityFee.record(priorityFeeGwei, strategyAttributes);
261
+ // Calculate total cost in ETH
262
+ // Cost = (gas * (baseFee + priorityFee)) + (blobCount * blobGasPerBlob * blobBaseFee)
263
+ const baseFee = analysis.minedBlock.baseFeePerGas;
264
+ const effectiveGasPrice = baseFee + blobTx.maxPriorityFeePerGas;
265
+ // Calculate execution cost using actual gas limit from the transaction
266
+ const executionCost = blobTx.gas * effectiveGasPrice;
267
+ // Calculate blob cost using maxFeePerBlobGas * blobCount * GAS_PER_BLOB
268
+ const blobCost = blobTx.maxFeePerBlobGas * BigInt(blobTx.blobCount) * 131072n; // 128KB per blob
269
+ const totalCostWei = executionCost + blobCost;
270
+ const totalCostEth = Number(totalCostWei) / 1e18;
271
+ this.fishermanMinedBlobTxTotalCost.record(totalCostEth, strategyAttributes);
272
+ }
273
+ }
274
+ // Record the calculated priority fee for this strategy
275
+ const calculatedPriorityFeeGwei = Number(strategyResult.calculatedPriorityFee) / 1e9;
276
+ this.fishermanCalculatedPriorityFee.record(calculatedPriorityFeeGwei, strategyAttributes);
277
+ // Record analysis results if available
278
+ if (analysis.analysis) {
279
+ this.fishermanTimeBeforeBlock.record(Math.ceil(analysis.analysis.timeBeforeBlockMs), strategyAttributes);
280
+ // Record whether the block reached 100% blob capacity
281
+ if (analysis.analysis.blockBlobsFull) {
282
+ this.fishermanBlockBlobsFull.add(1, {
283
+ ...strategyAttributes,
284
+ [Attributes.OK]: true
285
+ });
286
+ } else {
287
+ this.fishermanBlockBlobsFull.add(1, {
288
+ ...strategyAttributes,
289
+ [Attributes.OK]: false
290
+ });
291
+ }
292
+ // Record the max blob capacity for this block
293
+ this.fishermanMaxBlobCapacity.record(analysis.analysis.maxBlobCapacity, strategyAttributes);
294
+ // Record strategy-specific inclusion result
295
+ if (strategyResult.wouldBeIncluded !== undefined) {
296
+ const inclusionAttributes = {
297
+ ...strategyAttributes,
298
+ [Attributes.BLOCK_FULL]: analysis.analysis.blockBlobsFull ? 'true' : 'false'
299
+ };
300
+ if (strategyResult.wouldBeIncluded) {
301
+ this.fishermanWouldBeIncluded.add(1, {
302
+ ...inclusionAttributes,
303
+ [Attributes.OK]: true
304
+ });
305
+ } else {
306
+ this.fishermanWouldBeIncluded.add(1, {
307
+ ...inclusionAttributes,
308
+ [Attributes.OK]: false,
309
+ ...strategyResult.exclusionReason && {
310
+ [Attributes.ERROR_TYPE]: strategyResult.exclusionReason
311
+ }
312
+ });
313
+ }
314
+ }
315
+ // Record strategy-specific priority fee delta
316
+ if (strategyResult.priorityFeeDelta !== undefined) {
317
+ const priorityFeeDeltaGwei = Number(strategyResult.priorityFeeDelta) / 1e9;
318
+ const deltaAttributes = {
319
+ ...strategyAttributes,
320
+ [Attributes.BLOCK_FULL]: analysis.analysis.blockBlobsFull ? 'true' : 'false'
321
+ };
322
+ this.fishermanPriorityFeeDelta.record(priorityFeeDeltaGwei, deltaAttributes);
323
+ }
324
+ // Record estimated cost if available
325
+ if (strategyResult.estimatedCostEth !== undefined) {
326
+ const costAttributes = {
327
+ ...strategyAttributes,
328
+ [Attributes.BLOCK_FULL]: analysis.analysis.blockBlobsFull ? 'true' : 'false'
329
+ };
330
+ this.fishermanEstimatedCost.record(strategyResult.estimatedCostEth, costAttributes);
331
+ }
332
+ // Record estimated overpayment if available
333
+ if (strategyResult.estimatedOverpaymentEth !== undefined) {
334
+ const overpaymentAttributes = {
335
+ ...strategyAttributes,
336
+ [Attributes.BLOCK_FULL]: analysis.analysis.blockBlobsFull ? 'true' : 'false'
337
+ };
338
+ this.fishermanEstimatedOverpayment.record(strategyResult.estimatedOverpaymentEth, overpaymentAttributes);
339
+ }
340
+ }
341
+ }
342
+ }
136
343
  }