@aztec/aztec-node 0.0.0-test.1 → 0.0.1-commit.017a351

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 (57) hide show
  1. package/dest/aztec-node/block_response_helpers.d.ts +25 -0
  2. package/dest/aztec-node/block_response_helpers.d.ts.map +1 -0
  3. package/dest/aztec-node/block_response_helpers.js +112 -0
  4. package/dest/aztec-node/config.d.ts +25 -11
  5. package/dest/aztec-node/config.d.ts.map +1 -1
  6. package/dest/aztec-node/config.js +90 -15
  7. package/dest/aztec-node/node_metrics.d.ts +5 -1
  8. package/dest/aztec-node/node_metrics.d.ts.map +1 -1
  9. package/dest/aztec-node/node_metrics.js +20 -6
  10. package/dest/aztec-node/public_data_overrides.d.ts +13 -0
  11. package/dest/aztec-node/public_data_overrides.d.ts.map +1 -0
  12. package/dest/aztec-node/public_data_overrides.js +21 -0
  13. package/dest/aztec-node/server.d.ts +139 -189
  14. package/dest/aztec-node/server.d.ts.map +1 -1
  15. package/dest/aztec-node/server.js +1842 -438
  16. package/dest/bin/index.d.ts +1 -1
  17. package/dest/bin/index.js +4 -2
  18. package/dest/index.d.ts +1 -2
  19. package/dest/index.d.ts.map +1 -1
  20. package/dest/index.js +0 -1
  21. package/dest/sentinel/config.d.ts +9 -0
  22. package/dest/sentinel/config.d.ts.map +1 -0
  23. package/dest/sentinel/config.js +39 -0
  24. package/dest/sentinel/factory.d.ts +11 -0
  25. package/dest/sentinel/factory.d.ts.map +1 -0
  26. package/dest/sentinel/factory.js +17 -0
  27. package/dest/sentinel/index.d.ts +3 -0
  28. package/dest/sentinel/index.d.ts.map +1 -0
  29. package/dest/sentinel/index.js +1 -0
  30. package/dest/sentinel/sentinel.d.ts +217 -0
  31. package/dest/sentinel/sentinel.d.ts.map +1 -0
  32. package/dest/sentinel/sentinel.js +571 -0
  33. package/dest/sentinel/store.d.ts +35 -0
  34. package/dest/sentinel/store.d.ts.map +1 -0
  35. package/dest/sentinel/store.js +182 -0
  36. package/dest/test/index.d.ts +31 -0
  37. package/dest/test/index.d.ts.map +1 -0
  38. package/dest/test/index.js +1 -0
  39. package/package.json +48 -35
  40. package/src/aztec-node/block_response_helpers.ts +161 -0
  41. package/src/aztec-node/config.ts +153 -26
  42. package/src/aztec-node/node_metrics.ts +23 -6
  43. package/src/aztec-node/public_data_overrides.ts +35 -0
  44. package/src/aztec-node/server.ts +1724 -573
  45. package/src/bin/index.ts +4 -2
  46. package/src/index.ts +0 -1
  47. package/src/sentinel/README.md +103 -0
  48. package/src/sentinel/config.ts +49 -0
  49. package/src/sentinel/factory.ts +34 -0
  50. package/src/sentinel/index.ts +8 -0
  51. package/src/sentinel/sentinel.ts +728 -0
  52. package/src/sentinel/store.ts +193 -0
  53. package/src/test/index.ts +32 -0
  54. package/dest/aztec-node/http_rpc_server.d.ts +0 -8
  55. package/dest/aztec-node/http_rpc_server.d.ts.map +0 -1
  56. package/dest/aztec-node/http_rpc_server.js +0 -9
  57. package/src/aztec-node/http_rpc_server.ts +0 -11
@@ -1,3 +1,3 @@
1
1
  #!/usr/bin/env -S node --no-warnings
2
2
  export {};
3
- //# sourceMappingURL=index.d.ts.map
3
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9iaW4vaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9
package/dest/bin/index.js CHANGED
@@ -1,7 +1,9 @@
1
1
  #!/usr/bin/env -S node --no-warnings
2
2
  import { createLogger } from '@aztec/foundation/log';
3
+ import { AztecNodeApiSchema } from '@aztec/stdlib/interfaces/client';
4
+ import { createTracedJsonRpcServer } from '@aztec/telemetry-client';
3
5
  import http from 'http';
4
- import { AztecNodeService, createAztecNodeRpcServer, getConfigEnvVars } from '../index.js';
6
+ import { AztecNodeService, getConfigEnvVars } from '../index.js';
5
7
  const { AZTEC_NODE_PORT = 8081, API_PREFIX = '' } = process.env;
6
8
  const logger = createLogger('node');
7
9
  /**
@@ -26,7 +28,7 @@ const logger = createLogger('node');
26
28
  process.once('SIGINT', shutdown);
27
29
  // eslint-disable-next-line @typescript-eslint/no-misused-promises
28
30
  process.once('SIGTERM', shutdown);
29
- const rpcServer = createAztecNodeRpcServer(aztecNode);
31
+ const rpcServer = createTracedJsonRpcServer(aztecNode, AztecNodeApiSchema);
30
32
  const app = rpcServer.getApp(API_PREFIX);
31
33
  // eslint-disable-next-line @typescript-eslint/no-misused-promises
32
34
  const httpServer = http.createServer(app.callback());
package/dest/index.d.ts CHANGED
@@ -1,4 +1,3 @@
1
1
  export * from './aztec-node/config.js';
2
2
  export * from './aztec-node/server.js';
3
- export * from './aztec-node/http_rpc_server.js';
4
- //# sourceMappingURL=index.d.ts.map
3
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLHdCQUF3QixDQUFDO0FBQ3ZDLGNBQWMsd0JBQXdCLENBQUMifQ==
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC"}
package/dest/index.js CHANGED
@@ -1,3 +1,2 @@
1
1
  export * from './aztec-node/config.js';
2
2
  export * from './aztec-node/server.js';
3
- export * from './aztec-node/http_rpc_server.js';
@@ -0,0 +1,9 @@
1
+ import { type ConfigMappingsType } from '@aztec/foundation/config';
2
+ export type SentinelConfig = {
3
+ sentinelHistoryLengthInEpochs: number;
4
+ sentinelHistoricEpochPerformanceLengthInEpochs: number;
5
+ sentinelEnabled: boolean;
6
+ sentinelEpochEndBufferSlots: number;
7
+ };
8
+ export declare const sentinelConfigMappings: ConfigMappingsType<SentinelConfig>;
9
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc2VudGluZWwvY29uZmlnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxLQUFLLGtCQUFrQixFQUEyQyxNQUFNLDBCQUEwQixDQUFDO0FBRTVHLE1BQU0sTUFBTSxjQUFjLEdBQUc7SUFDM0IsNkJBQTZCLEVBQUUsTUFBTSxDQUFDO0lBQ3RDLDhDQUE4QyxFQUFFLE1BQU0sQ0FBQztJQUN2RCxlQUFlLEVBQUUsT0FBTyxDQUFDO0lBQ3pCLDJCQUEyQixFQUFFLE1BQU0sQ0FBQztDQUNyQyxDQUFDO0FBRUYsZUFBTyxNQUFNLHNCQUFzQixFQUFFLGtCQUFrQixDQUFDLGNBQWMsQ0F1Q3JFLENBQUMifQ==
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/sentinel/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAA2C,MAAM,0BAA0B,CAAC;AAE5G,MAAM,MAAM,cAAc,GAAG;IAC3B,6BAA6B,EAAE,MAAM,CAAC;IACtC,8CAA8C,EAAE,MAAM,CAAC;IACvD,eAAe,EAAE,OAAO,CAAC;IACzB,2BAA2B,EAAE,MAAM,CAAC;CACrC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,kBAAkB,CAAC,cAAc,CAuCrE,CAAC"}
@@ -0,0 +1,39 @@
1
+ import { booleanConfigHelper, numberConfigHelper } from '@aztec/foundation/config';
2
+ export const sentinelConfigMappings = {
3
+ sentinelHistoryLengthInEpochs: {
4
+ description: 'The number of L2 epochs kept of history for each validator for computing their stats.',
5
+ env: 'SENTINEL_HISTORY_LENGTH_IN_EPOCHS',
6
+ ...numberConfigHelper(24)
7
+ },
8
+ /**
9
+ * The number of L2 epochs kept of per-epoch performance history for each validator. End-of-epoch
10
+ * activity is recorded here and used to decide consecutive-epoch inactivity slashing.
11
+ * This value must be large enough so that we have epoch performance for every validator
12
+ * for at least slashInactivityConsecutiveEpochThreshold. Assuming this value is 3,
13
+ * and the committee size is 48, and we have 10k validators, then we pick 48 out of 10k each draw.
14
+ * For any fixed element, per-draw prob = 48/10000 = 0.0048.
15
+ * After n draws, count ~ Binomial(n, 0.0048). We want P(X >= 3).
16
+ * Results (exact binomial):
17
+ * - 90% chance: n = 1108
18
+ * - 95% chance: n = 1310
19
+ * - 99% chance: n = 1749
20
+ */ sentinelHistoricEpochPerformanceLengthInEpochs: {
21
+ description: 'The number of L2 epochs kept of per-epoch performance history for each validator.',
22
+ env: 'SENTINEL_HISTORIC_EPOCH_PERFORMANCE_LENGTH_IN_EPOCHS',
23
+ ...numberConfigHelper(2000)
24
+ },
25
+ sentinelEnabled: {
26
+ description: 'Whether the sentinel is enabled or not.',
27
+ env: 'SENTINEL_ENABLED',
28
+ ...booleanConfigHelper(false)
29
+ },
30
+ /**
31
+ * Number of L2 slots to wait after the end of an epoch before computing the epoch's performance.
32
+ * The buffer allows P2P attestations and the local archiver to settle. Higher values reduce the
33
+ * risk of misjudging late-arriving activity at the cost of delayed slashing.
34
+ */ sentinelEpochEndBufferSlots: {
35
+ description: 'Number of L2 slots after the end of an epoch before the sentinel evaluates it.',
36
+ env: 'SENTINEL_EPOCH_END_BUFFER_SLOTS',
37
+ ...numberConfigHelper(2)
38
+ }
39
+ };
@@ -0,0 +1,11 @@
1
+ import type { EpochCache } from '@aztec/epoch-cache';
2
+ import type { P2PClient } from '@aztec/p2p';
3
+ import type { L2BlockSource } from '@aztec/stdlib/block';
4
+ import type { CheckpointReexecutionTracker } from '@aztec/stdlib/checkpoint';
5
+ import type { ChainConfig } from '@aztec/stdlib/config';
6
+ import type { SlasherConfig } from '@aztec/stdlib/interfaces/server';
7
+ import type { DataStoreConfig } from '@aztec/stdlib/kv-store';
8
+ import type { SentinelConfig } from './config.js';
9
+ import { Sentinel } from './sentinel.js';
10
+ export declare function createSentinel(epochCache: EpochCache, archiver: L2BlockSource, p2p: P2PClient, reexecutionTracker: CheckpointReexecutionTracker, config: SentinelConfig & DataStoreConfig & SlasherConfig & Pick<ChainConfig, 'l1ChainId' | 'rollupAddress'>, logger?: import("@aztec/foundation/log").Logger): Promise<Sentinel | undefined>;
11
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFjdG9yeS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3NlbnRpbmVsL2ZhY3RvcnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFHckQsT0FBTyxLQUFLLEVBQUUsU0FBUyxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBQzVDLE9BQU8sS0FBSyxFQUFFLGFBQWEsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBQ3pELE9BQU8sS0FBSyxFQUFFLDRCQUE0QixFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDN0UsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFDeEQsT0FBTyxLQUFLLEVBQUUsYUFBYSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDckUsT0FBTyxLQUFLLEVBQUUsZUFBZSxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFFOUQsT0FBTyxLQUFLLEVBQUUsY0FBYyxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBQ2xELE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFHekMsd0JBQXNCLGNBQWMsQ0FDbEMsVUFBVSxFQUFFLFVBQVUsRUFDdEIsUUFBUSxFQUFFLGFBQWEsRUFDdkIsR0FBRyxFQUFFLFNBQVMsRUFDZCxrQkFBa0IsRUFBRSw0QkFBNEIsRUFDaEQsTUFBTSxFQUFFLGNBQWMsR0FBRyxlQUFlLEdBQUcsYUFBYSxHQUFHLElBQUksQ0FBQyxXQUFXLEVBQUUsV0FBVyxHQUFHLGVBQWUsQ0FBQyxFQUMzRyxNQUFNLHlDQUFnQyxHQUNyQyxPQUFPLENBQUMsUUFBUSxHQUFHLFNBQVMsQ0FBQyxDQVkvQiJ9
@@ -0,0 +1 @@
1
+ {"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/sentinel/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,wBAAsB,cAAc,CAClC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,SAAS,EACd,kBAAkB,EAAE,4BAA4B,EAChD,MAAM,EAAE,cAAc,GAAG,eAAe,GAAG,aAAa,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,eAAe,CAAC,EAC3G,MAAM,yCAAgC,GACrC,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAY/B"}
@@ -0,0 +1,17 @@
1
+ import { createLogger } from '@aztec/foundation/log';
2
+ import { createStore } from '@aztec/kv-store/lmdb-v2';
3
+ import { Sentinel } from './sentinel.js';
4
+ import { SentinelStore } from './store.js';
5
+ export async function createSentinel(epochCache, archiver, p2p, reexecutionTracker, config, logger = createLogger('node:sentinel')) {
6
+ if (!config.sentinelEnabled) {
7
+ return undefined;
8
+ }
9
+ const kvStore = await createStore('sentinel', SentinelStore.SCHEMA_VERSION, config, logger.getBindings());
10
+ const storeHistoryLength = config.sentinelHistoryLengthInEpochs * epochCache.getL1Constants().epochDuration;
11
+ const storeHistoricEpochPerformanceLength = config.sentinelHistoricEpochPerformanceLengthInEpochs;
12
+ const sentinelStore = new SentinelStore(kvStore, {
13
+ historyLength: storeHistoryLength,
14
+ historicEpochPerformanceLength: storeHistoricEpochPerformanceLength
15
+ });
16
+ return new Sentinel(epochCache, archiver, p2p, sentinelStore, reexecutionTracker, config, logger);
17
+ }
@@ -0,0 +1,3 @@
1
+ export { Sentinel } from './sentinel.js';
2
+ export type { ValidatorsStats, ValidatorStats, ValidatorStatusHistory, ValidatorStatusInSlot, } from '@aztec/stdlib/validators';
3
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zZW50aW5lbC9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sZUFBZSxDQUFDO0FBRXpDLFlBQVksRUFDVixlQUFlLEVBQ2YsY0FBYyxFQUNkLHNCQUFzQixFQUN0QixxQkFBcUIsR0FDdEIsTUFBTSwwQkFBMEIsQ0FBQyJ9
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sentinel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,YAAY,EACV,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC"}
@@ -0,0 +1 @@
1
+ export { Sentinel } from './sentinel.js';
@@ -0,0 +1,217 @@
1
+ import type { EpochCache } from '@aztec/epoch-cache';
2
+ import { CheckpointNumber, CheckpointProposalHash, EpochNumber, SlotNumber } from '@aztec/foundation/branded-types';
3
+ import { EthAddress } from '@aztec/foundation/eth-address';
4
+ import { RunningPromise } from '@aztec/foundation/running-promise';
5
+ import { type L2TipsStore } from '@aztec/kv-store/stores';
6
+ import type { P2PClient } from '@aztec/p2p';
7
+ import { type Watcher, type WatcherEmitter } from '@aztec/slasher';
8
+ import type { SlasherConfig } from '@aztec/slasher/config';
9
+ import { type L2BlockSource, L2BlockStream, type L2BlockStreamEvent, type L2BlockStreamEventHandler } from '@aztec/stdlib/block';
10
+ import type { CheckpointReexecutionTracker } from '@aztec/stdlib/checkpoint';
11
+ import type { ChainConfig } from '@aztec/stdlib/config';
12
+ import type { SingleValidatorStats, ValidatorStats, ValidatorStatusHistory, ValidatorStatusInSlot, ValidatorStatusType, ValidatorsEpochPerformance, ValidatorsStats } from '@aztec/stdlib/validators';
13
+ import type { SentinelConfig } from './config.js';
14
+ import { SentinelStore } from './store.js';
15
+ export type SentinelRuntimeConfig = Pick<SlasherConfig, 'slashInactivityTargetPercentage' | 'slashInactivityPenalty' | 'slashInactivityConsecutiveEpochThreshold'> & Pick<SentinelConfig, 'sentinelEpochEndBufferSlots'> & Pick<ChainConfig, 'l1ChainId' | 'rollupAddress'>;
16
+ declare const Sentinel_base: new () => WatcherEmitter;
17
+ /**
18
+ * The Sentinel observes validator behaviour every L2 slot, classifies it into a per-slot status,
19
+ * aggregates those statuses into per-epoch performance once each epoch is fully observed, and
20
+ * emits inactivity slash payloads when a validator has been inactive for the configured number
21
+ * of consecutive epochs.
22
+ *
23
+ * ## Two cadences
24
+ *
25
+ * The sentinel runs `work()` every quarter L2 slot and drives two independent pipelines:
26
+ *
27
+ * 1. **Per-slot activity recording.** `processSlot(currentSlot - 2)` runs once per slot, with a
28
+ * two-slot lag to let P2P attestations settle and the archiver catch up. It classifies each
29
+ * committee member's behaviour for that slot via `getSlotActivity` and persists the result to
30
+ * `SentinelStore.historyMap` (sliding window of `sentinelHistoryLengthInEpochs * epochDuration`
31
+ * slots, default 24 epochs).
32
+ *
33
+ * 2. **Per-epoch evaluation.** `processEpochEnds(currentSlot)` runs every tick too. Once
34
+ * `sentinelEpochEndBufferSlots` (default 2) has elapsed past an epoch's last slot AND the
35
+ * per-slot recorder has covered that last slot, the sentinel calls `handleEpochEnd(epoch)`.
36
+ * That aggregates the slot-level statuses for the epoch into per-validator `{missed, total}`,
37
+ * persists it to `SentinelStore.epochMap` (default 2000-epoch window), and runs the slashing
38
+ * decision.
39
+ *
40
+ * Triggering per-epoch evaluation off local L2 state — rather than waiting for L1 proof
41
+ * publication — decouples slashing from prover availability.
42
+ *
43
+ * ## Six-case taxonomy in `getSlotActivity`
44
+ *
45
+ * For each slot, the sentinel assigns the proposer one of six statuses, ranked highest-confidence
46
+ * first:
47
+ *
48
+ * - `checkpoint-mined` — a checkpoint covering this slot has landed on L1
49
+ * (`slotNumberToCheckpoint` populated from `chain-checkpointed`).
50
+ * - `checkpoint-valid` — the local node re-executed a checkpoint proposal for this slot
51
+ * successfully (consulted via `CheckpointReexecutionTracker`).
52
+ * - `checkpoint-invalid` — the local node re-executed a checkpoint proposal for this slot
53
+ * and rejected it (e.g. header/archive/out-hash mismatch, limit
54
+ * breach). Proposer-fault.
55
+ * - `checkpoint-unvalidated` — the local node observed a checkpoint proposal but could not
56
+ * validate it (missing blocks/txs, timeouts). Treated as
57
+ * proposer-fault for slashing.
58
+ * - `checkpoint-missed` — block proposals seen on P2P but no checkpoint proposal at all.
59
+ * - `blocks-missed` — no block proposals seen for this slot.
60
+ *
61
+ * Missing-attestor faults are recorded only in `checkpoint-mined` and `checkpoint-valid`, where
62
+ * the local node has positive evidence the checkpoint was canonical or valid. In the other four
63
+ * cases the proposer is at fault and no attestor penalty applies.
64
+ *
65
+ * ## Re-execution tracker
66
+ *
67
+ * `CheckpointReexecutionTracker` is populated by the validator client's checkpoint proposal
68
+ * handler. Every early return in `validateCheckpointProposal` records an outcome
69
+ * (`valid` / `invalid` / `unvalidated`) keyed by slot.
70
+ *
71
+ * ## Inactivity slashing
72
+ *
73
+ * `handleEpochPerformance` filters the epoch's per-validator stats by
74
+ * `slashInactivityTargetPercentage` and then calls `checkPastInactivity` to require
75
+ * `slashInactivityConsecutiveEpochThreshold` consecutive past epochs over the same threshold
76
+ * (read from `SentinelStore.epochMap`). Only validators meeting both conditions are emitted as
77
+ * `WANT_TO_SLASH_EVENT` with `OffenseType.INACTIVITY`. The slot-level counters that feed this —
78
+ * `missedProposals` and `missedAttestations` — include the four proposer-fault statuses plus
79
+ * `attestation-missed`.
80
+ *
81
+ * ## Escape hatch
82
+ *
83
+ * If `epochCache.getCommittee(slot)` reports `isEscapeHatchOpen`, per-slot recording is skipped
84
+ * (no history entries for that slot) and per-epoch evaluation writes an empty performance map
85
+ * (no slashing).
86
+ */
87
+ export declare class Sentinel extends Sentinel_base implements L2BlockStreamEventHandler, Watcher {
88
+ protected epochCache: EpochCache;
89
+ protected archiver: L2BlockSource;
90
+ protected p2p: P2PClient;
91
+ protected store: SentinelStore;
92
+ protected reexecutionTracker: CheckpointReexecutionTracker;
93
+ protected config: SentinelRuntimeConfig;
94
+ protected logger: import("@aztec/foundation/log").Logger;
95
+ protected runningPromise: RunningPromise;
96
+ protected blockStream: L2BlockStream;
97
+ protected l2TipsStore: L2TipsStore;
98
+ protected initialSlot: SlotNumber | undefined;
99
+ protected lastProcessedSlot: SlotNumber | undefined;
100
+ /** Largest epoch number for which the end-of-epoch aggregator has run. */
101
+ protected lastEvaluatedEpoch: EpochNumber | undefined;
102
+ protected slotNumberToCheckpoint: Map<SlotNumber, {
103
+ checkpointNumber: CheckpointNumber;
104
+ archive: string;
105
+ /** Hex keccak256 of the consensus payload bytes; used to fetch matching p2p attestations. */
106
+ proposalPayloadHash: CheckpointProposalHash;
107
+ attestors: EthAddress[];
108
+ }>;
109
+ constructor(epochCache: EpochCache, archiver: L2BlockSource, p2p: P2PClient, store: SentinelStore, reexecutionTracker: CheckpointReexecutionTracker, config: SentinelRuntimeConfig, logger?: import("@aztec/foundation/log").Logger);
110
+ private getSignatureContext;
111
+ updateConfig(config: Partial<SlasherConfig>): void;
112
+ start(): Promise<void>;
113
+ /**
114
+ * Loads initial slot and initializes blockstream. We will not process anything at or before
115
+ * the initial slot. Floors at the archiver's synced L2 slot so the sentinel keeps making
116
+ * forward progress when L1 is advancing but L2 has no activity (the synced slot is driven by
117
+ * L1 sync, not by L2 blocks). Falls back to the wallclock if the archiver isn't ready yet
118
+ * (cold start).
119
+ */
120
+ protected init(): Promise<void>;
121
+ /**
122
+ * Returns the L2 slot the sentinel should treat as "current": the archiver's last fully
123
+ * synced L2 slot, falling back to the wallclock slot when the archiver isn't ready yet
124
+ * (cold start). Anchoring to the synced slot keeps timing arithmetic (initial floor,
125
+ * per-slot lag, end-of-epoch buffer, stats-range fallback) from speculating ahead of where
126
+ * L1 actually is.
127
+ */
128
+ protected getCurrentSlot(): Promise<SlotNumber>;
129
+ stop(): Promise<void>;
130
+ handleBlockStreamEvent(event: L2BlockStreamEvent): Promise<void>;
131
+ protected handleCheckpoint(event: L2BlockStreamEvent): void;
132
+ /**
133
+ * Called once per epoch, after the configured end-of-epoch buffer has elapsed beyond the
134
+ * epoch's last slot. Computes per-epoch performance from the slot-level history collected
135
+ * by `processSlot` and emits any inactivity slash payloads.
136
+ */
137
+ protected handleEpochEnd(epoch: EpochNumber): Promise<void>;
138
+ protected computeEpochPerformance(epoch: EpochNumber): Promise<ValidatorsEpochPerformance>;
139
+ /**
140
+ * Checks if a validator has been inactive for the specified number of consecutive epochs for which we have data on it.
141
+ * @param validator The validator address to check
142
+ * @param currentEpoch Epochs strictly before the current one are evaluated only
143
+ * @param requiredConsecutiveEpochs Number of consecutive epochs required for slashing
144
+ */
145
+ protected checkPastInactivity(validator: EthAddress, currentEpoch: EpochNumber, requiredConsecutiveEpochs: number): Promise<boolean>;
146
+ protected handleEpochPerformance(epoch: EpochNumber, performance: ValidatorsEpochPerformance): Promise<void>;
147
+ /**
148
+ * Process data for two L2 slots ago.
149
+ * Note that we do not process historical data, since we rely on p2p data for processing,
150
+ * and we don't have that data if we were offline during the period.
151
+ *
152
+ * `currentSlot` is anchored to the archiver's last synced L2 slot rather than the wallclock,
153
+ * so the per-slot lag (`isReadyToProcess`) and the end-of-epoch buffer (`processEpochEnds`)
154
+ * advance with archiver.
155
+ */
156
+ work(): Promise<void>;
157
+ /**
158
+ * After the configured buffer has elapsed past an epoch's last slot, runs the end-of-epoch
159
+ * aggregator for that epoch. Catches up if multiple epochs become eligible at once.
160
+ */
161
+ protected processEpochEnds(currentSlot: SlotNumber): Promise<void>;
162
+ /**
163
+ * Check if we are ready to process data for two L2 slots ago, so we allow plenty of time for p2p to process all in-flight attestations.
164
+ * We also don't move past the archiver last synced L2 slot, as we don't want to process data that is not yet available.
165
+ * Last, we check the p2p is synced with the archiver, so it has pulled all attestations from it.
166
+ */
167
+ protected isReadyToProcess(currentSlot: SlotNumber): Promise<SlotNumber | false>;
168
+ /**
169
+ * Gathers committee and proposer data for a given slot, computes slot stats,
170
+ * and updates overall stats.
171
+ */
172
+ protected processSlot(slot: SlotNumber): Promise<void>;
173
+ /**
174
+ * Computes activity for a given slot using the six-case taxonomy.
175
+ *
176
+ * Proposer status:
177
+ * - case 6 `checkpoint-mined` — a checkpoint covering this slot has landed on L1.
178
+ * - case 5 `checkpoint-valid` — the local node re-executed a checkpoint proposal for this
179
+ * slot successfully.
180
+ * - case 4 `checkpoint-invalid` — the local node re-executed a checkpoint proposal for this
181
+ * slot and rejected it.
182
+ * - case 3 `checkpoint-unvalidated` — the local node observed a checkpoint proposal for this
183
+ * slot but could not validate it (missing data, timeouts).
184
+ * - case 2 `checkpoint-missed` — block proposals seen on P2P but no checkpoint proposal.
185
+ * - case 1 `blocks-missed` — no block proposals seen for this slot.
186
+ *
187
+ * Missing-attestor penalties apply only in cases 5 and 6, where the local node has positive
188
+ * evidence the checkpoint was valid or has been canonicalised on L1.
189
+ */
190
+ protected getSlotActivity(slot: SlotNumber, epoch: EpochNumber, proposer: EthAddress, committee: EthAddress[]): Promise<{
191
+ [k: string]: ValidatorStatusInSlot | undefined;
192
+ }>;
193
+ /** Push the status for each slot for each validator. */
194
+ protected updateValidators(slot: SlotNumber, stats: Record<`0x${string}`, ValidatorStatusInSlot | undefined>): Promise<void>;
195
+ /** Computes stats to be returned based on stored data. */
196
+ computeStats({ fromSlot, toSlot, validators }?: {
197
+ fromSlot?: SlotNumber;
198
+ toSlot?: SlotNumber;
199
+ validators?: EthAddress[];
200
+ }): Promise<ValidatorsStats>;
201
+ /** Computes stats for a single validator. */
202
+ getValidatorStats(validatorAddress: EthAddress, fromSlot?: SlotNumber, toSlot?: SlotNumber): Promise<SingleValidatorStats | undefined>;
203
+ protected computeStatsForValidator(address: `0x${string}`, allHistory: ValidatorStatusHistory, fromSlot?: SlotNumber, toSlot?: SlotNumber): ValidatorStats;
204
+ protected computeMissed(history: ValidatorStatusHistory, computeOverCategory: ValidatorStatusType | undefined, filter: ValidatorStatusInSlot[]): {
205
+ currentStreak: number;
206
+ rate: number | undefined;
207
+ count: number;
208
+ total: number;
209
+ };
210
+ protected computeFromSlot(slot: SlotNumber | undefined): {
211
+ timestamp: bigint;
212
+ slot: SlotNumber;
213
+ date: string;
214
+ } | undefined;
215
+ }
216
+ export {};
217
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VudGluZWwuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zZW50aW5lbC9zZW50aW5lbC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxVQUFVLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUNyRCxPQUFPLEVBRUwsZ0JBQWdCLEVBQ2hCLHNCQUFzQixFQUN0QixXQUFXLEVBQ1gsVUFBVSxFQUNYLE1BQU0saUNBQWlDLENBQUM7QUFFekMsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBRTNELE9BQU8sRUFBRSxjQUFjLEVBQUUsTUFBTSxtQ0FBbUMsQ0FBQztBQUNuRSxPQUFPLEVBQXFCLEtBQUssV0FBVyxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDN0UsT0FBTyxLQUFLLEVBQUUsU0FBUyxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBQzVDLE9BQU8sRUFJTCxLQUFLLE9BQU8sRUFDWixLQUFLLGNBQWMsRUFFcEIsTUFBTSxnQkFBZ0IsQ0FBQztBQUN4QixPQUFPLEtBQUssRUFBRSxhQUFhLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUMzRCxPQUFPLEVBQ0wsS0FBSyxhQUFhLEVBQ2xCLGFBQWEsRUFDYixLQUFLLGtCQUFrQixFQUN2QixLQUFLLHlCQUF5QixFQUUvQixNQUFNLHFCQUFxQixDQUFDO0FBQzdCLE9BQU8sS0FBSyxFQUFFLDRCQUE0QixFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDN0UsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFHeEQsT0FBTyxLQUFLLEVBQ1Ysb0JBQW9CLEVBQ3BCLGNBQWMsRUFDZCxzQkFBc0IsRUFDdEIscUJBQXFCLEVBQ3JCLG1CQUFtQixFQUNuQiwwQkFBMEIsRUFDMUIsZUFBZSxFQUNoQixNQUFNLDBCQUEwQixDQUFDO0FBSWxDLE9BQU8sS0FBSyxFQUFFLGNBQWMsRUFBRSxNQUFNLGFBQWEsQ0FB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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sentinel.d.ts","sourceRoot":"","sources":["../../src/sentinel/sentinel.ts"],"names":[],"mappings":"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"}