@aztec/slasher 0.0.1-commit.96bb3f7 → 0.0.1-commit.993d240

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 (92) hide show
  1. package/README.md +83 -76
  2. package/dest/config.d.ts +1 -1
  3. package/dest/config.d.ts.map +1 -1
  4. package/dest/config.js +53 -41
  5. package/dest/factory/create_facade.d.ts +3 -3
  6. package/dest/factory/create_facade.d.ts.map +1 -1
  7. package/dest/factory/create_facade.js +26 -3
  8. package/dest/factory/create_implementation.d.ts +6 -7
  9. package/dest/factory/create_implementation.d.ts.map +1 -1
  10. package/dest/factory/create_implementation.js +8 -56
  11. package/dest/factory/get_settings.d.ts +4 -4
  12. package/dest/factory/get_settings.d.ts.map +1 -1
  13. package/dest/factory/get_settings.js +3 -3
  14. package/dest/factory/index.d.ts +2 -2
  15. package/dest/factory/index.d.ts.map +1 -1
  16. package/dest/factory/index.js +1 -1
  17. package/dest/generated/slasher-defaults.d.ts +21 -0
  18. package/dest/generated/slasher-defaults.d.ts.map +1 -0
  19. package/dest/generated/slasher-defaults.js +21 -0
  20. package/dest/index.d.ts +6 -4
  21. package/dest/index.d.ts.map +1 -1
  22. package/dest/index.js +5 -3
  23. package/dest/null_slasher_client.d.ts +3 -4
  24. package/dest/null_slasher_client.d.ts.map +1 -1
  25. package/dest/null_slasher_client.js +1 -4
  26. package/dest/slash_offenses_collector.d.ts +10 -9
  27. package/dest/slash_offenses_collector.d.ts.map +1 -1
  28. package/dest/slash_offenses_collector.js +50 -30
  29. package/dest/slasher_client.d.ts +112 -0
  30. package/dest/slasher_client.d.ts.map +1 -0
  31. package/dest/{tally_slasher_client.js → slasher_client.js} +50 -45
  32. package/dest/slasher_client_facade.d.ts +6 -8
  33. package/dest/slasher_client_facade.d.ts.map +1 -1
  34. package/dest/slasher_client_facade.js +6 -9
  35. package/dest/slasher_client_interface.d.ts +7 -21
  36. package/dest/slasher_client_interface.d.ts.map +1 -1
  37. package/dest/slasher_client_interface.js +1 -4
  38. package/dest/stores/offenses_store.d.ts +12 -12
  39. package/dest/stores/offenses_store.d.ts.map +1 -1
  40. package/dest/stores/offenses_store.js +64 -39
  41. package/dest/watcher.d.ts +8 -1
  42. package/dest/watcher.d.ts.map +1 -1
  43. package/dest/watcher.js +1 -0
  44. package/dest/watchers/attestations_block_watcher.d.ts +28 -14
  45. package/dest/watchers/attestations_block_watcher.d.ts.map +1 -1
  46. package/dest/watchers/attestations_block_watcher.js +80 -64
  47. package/dest/watchers/attested_invalid_proposal_watcher.d.ts +42 -0
  48. package/dest/watchers/attested_invalid_proposal_watcher.d.ts.map +1 -0
  49. package/dest/watchers/attested_invalid_proposal_watcher.js +117 -0
  50. package/dest/watchers/broadcasted_invalid_checkpoint_proposal_watcher.d.ts +38 -0
  51. package/dest/watchers/broadcasted_invalid_checkpoint_proposal_watcher.d.ts.map +1 -0
  52. package/dest/watchers/broadcasted_invalid_checkpoint_proposal_watcher.js +138 -0
  53. package/dest/watchers/checkpoint_equivocation_watcher.d.ts +30 -0
  54. package/dest/watchers/checkpoint_equivocation_watcher.d.ts.map +1 -0
  55. package/dest/watchers/checkpoint_equivocation_watcher.js +69 -0
  56. package/dest/watchers/data_withholding_watcher.d.ts +63 -0
  57. package/dest/watchers/data_withholding_watcher.d.ts.map +1 -0
  58. package/dest/watchers/data_withholding_watcher.js +193 -0
  59. package/package.json +15 -13
  60. package/src/config.ts +61 -41
  61. package/src/factory/create_facade.ts +33 -5
  62. package/src/factory/create_implementation.ts +24 -105
  63. package/src/factory/get_settings.ts +8 -8
  64. package/src/factory/index.ts +1 -1
  65. package/src/generated/slasher-defaults.ts +23 -0
  66. package/src/index.ts +5 -3
  67. package/src/null_slasher_client.ts +2 -6
  68. package/src/slash_offenses_collector.ts +70 -32
  69. package/src/{tally_slasher_client.ts → slasher_client.ts} +68 -54
  70. package/src/slasher_client_facade.ts +6 -11
  71. package/src/slasher_client_interface.ts +6 -21
  72. package/src/stores/offenses_store.ts +76 -48
  73. package/src/watcher.ts +8 -0
  74. package/src/watchers/attestations_block_watcher.ts +95 -84
  75. package/src/watchers/attested_invalid_proposal_watcher.ts +168 -0
  76. package/src/watchers/broadcasted_invalid_checkpoint_proposal_watcher.ts +192 -0
  77. package/src/watchers/checkpoint_equivocation_watcher.ts +96 -0
  78. package/src/watchers/data_withholding_watcher.ts +225 -0
  79. package/dest/empire_slasher_client.d.ts +0 -190
  80. package/dest/empire_slasher_client.d.ts.map +0 -1
  81. package/dest/empire_slasher_client.js +0 -572
  82. package/dest/stores/payloads_store.d.ts +0 -29
  83. package/dest/stores/payloads_store.d.ts.map +0 -1
  84. package/dest/stores/payloads_store.js +0 -125
  85. package/dest/tally_slasher_client.d.ts +0 -125
  86. package/dest/tally_slasher_client.d.ts.map +0 -1
  87. package/dest/watchers/epoch_prune_watcher.d.ts +0 -37
  88. package/dest/watchers/epoch_prune_watcher.d.ts.map +0 -1
  89. package/dest/watchers/epoch_prune_watcher.js +0 -137
  90. package/src/empire_slasher_client.ts +0 -657
  91. package/src/stores/payloads_store.ts +0 -146
  92. package/src/watchers/epoch_prune_watcher.ts +0 -194
package/src/config.ts CHANGED
@@ -1,4 +1,3 @@
1
- import { DefaultL1ContractsConfig } from '@aztec/ethereum/config';
2
1
  import type { ConfigMappingsType } from '@aztec/foundation/config';
3
2
  import {
4
3
  bigintConfigHelper,
@@ -9,27 +8,35 @@ import {
9
8
  import { EthAddress } from '@aztec/foundation/eth-address';
10
9
  import type { SlasherConfig } from '@aztec/stdlib/interfaces/server';
11
10
 
11
+ import { slasherDefaultEnv } from './generated/slasher-defaults.js';
12
+
12
13
  export type { SlasherConfig };
13
14
 
14
15
  export const DefaultSlasherConfig: SlasherConfig = {
15
16
  slashOverridePayload: undefined,
16
- slashMinPenaltyPercentage: 0.5, // 50% of penalty
17
- slashMaxPenaltyPercentage: 2.0, //2x of penalty
18
17
  slashValidatorsAlways: [], // Empty by default
19
18
  slashValidatorsNever: [], // Empty by default
20
- slashPrunePenalty: DefaultL1ContractsConfig.slashAmountSmall,
21
- slashDataWithholdingPenalty: DefaultL1ContractsConfig.slashAmountSmall,
22
- slashInactivityTargetPercentage: 0.9,
23
- slashInactivityConsecutiveEpochThreshold: 1, // Default to 1 for backward compatibility
24
- slashBroadcastedInvalidBlockPenalty: DefaultL1ContractsConfig.slashAmountSmall,
25
- slashInactivityPenalty: DefaultL1ContractsConfig.slashAmountSmall,
26
- slashProposeInvalidAttestationsPenalty: DefaultL1ContractsConfig.slashAmountSmall,
27
- slashAttestDescendantOfInvalidPenalty: DefaultL1ContractsConfig.slashAmountSmall,
28
- slashUnknownPenalty: DefaultL1ContractsConfig.slashAmountSmall,
29
- slashOffenseExpirationRounds: 4,
30
- slashMaxPayloadSize: 50,
31
- slashGracePeriodL2Slots: 0,
32
- slashExecuteRoundsLookBack: 4,
19
+ slashDataWithholdingPenalty: BigInt(slasherDefaultEnv.SLASH_DATA_WITHHOLDING_PENALTY),
20
+ slashDataWithholdingToleranceSlots: slasherDefaultEnv.SLASH_DATA_WITHHOLDING_TOLERANCE_SLOTS,
21
+ slashInactivityTargetPercentage: slasherDefaultEnv.SLASH_INACTIVITY_TARGET_PERCENTAGE,
22
+ slashInactivityConsecutiveEpochThreshold: slasherDefaultEnv.SLASH_INACTIVITY_CONSECUTIVE_EPOCH_THRESHOLD,
23
+ slashBroadcastedInvalidBlockPenalty: BigInt(slasherDefaultEnv.SLASH_INVALID_BLOCK_PENALTY),
24
+ slashBroadcastedInvalidCheckpointProposalPenalty: BigInt(slasherDefaultEnv.SLASH_INVALID_CHECKPOINT_PROPOSAL_PENALTY),
25
+ slashDuplicateProposalPenalty: BigInt(slasherDefaultEnv.SLASH_DUPLICATE_PROPOSAL_PENALTY),
26
+ slashDuplicateAttestationPenalty: BigInt(slasherDefaultEnv.SLASH_DUPLICATE_ATTESTATION_PENALTY),
27
+ slashInactivityPenalty: BigInt(slasherDefaultEnv.SLASH_INACTIVITY_PENALTY),
28
+ slashProposeInvalidAttestationsPenalty: BigInt(slasherDefaultEnv.SLASH_PROPOSE_INVALID_ATTESTATIONS_PENALTY),
29
+ slashProposeDescendantOfCheckpointWithInvalidAttestationsPenalty: BigInt(
30
+ slasherDefaultEnv.SLASH_PROPOSE_DESCENDANT_OF_CHECKPOINT_WITH_INVALID_ATTESTATIONS_PENALTY,
31
+ ),
32
+ slashAttestInvalidCheckpointProposalPenalty: BigInt(
33
+ slasherDefaultEnv.SLASH_ATTEST_INVALID_CHECKPOINT_PROPOSAL_PENALTY,
34
+ ),
35
+ slashUnknownPenalty: BigInt(slasherDefaultEnv.SLASH_UNKNOWN_PENALTY),
36
+ slashOffenseExpirationRounds: slasherDefaultEnv.SLASH_OFFENSE_EXPIRATION_ROUNDS,
37
+ slashMaxPayloadSize: slasherDefaultEnv.SLASH_MAX_PAYLOAD_SIZE,
38
+ slashGracePeriodL2Slots: slasherDefaultEnv.SLASH_GRACE_PERIOD_L2_SLOTS,
39
+ slashExecuteRoundsLookBack: slasherDefaultEnv.SLASH_EXECUTE_ROUNDS_LOOK_BACK,
33
40
  slashSelfAllowed: false,
34
41
  };
35
42
 
@@ -37,19 +44,9 @@ export const slasherConfigMappings: ConfigMappingsType<SlasherConfig> = {
37
44
  slashOverridePayload: {
38
45
  env: 'SLASH_OVERRIDE_PAYLOAD',
39
46
  description: 'An Ethereum address for a slash payload to vote for unconditionally.',
40
- parseEnv: (val: string) => (val ? EthAddress.fromString(val) : undefined),
47
+ parseEnv: (val: string) => EthAddress.fromString(val),
41
48
  defaultValue: DefaultSlasherConfig.slashOverridePayload,
42
49
  },
43
- slashMinPenaltyPercentage: {
44
- env: 'SLASH_MIN_PENALTY_PERCENTAGE',
45
- description: 'Minimum penalty percentage for slashing offenses (0.1 is 10%).',
46
- ...floatConfigHelper(DefaultSlasherConfig.slashMinPenaltyPercentage),
47
- },
48
- slashMaxPenaltyPercentage: {
49
- env: 'SLASH_MAX_PENALTY_PERCENTAGE',
50
- description: 'Maximum penalty percentage for slashing offenses (2.0 is 200%).',
51
- ...floatConfigHelper(DefaultSlasherConfig.slashMaxPenaltyPercentage),
52
- },
53
50
  slashValidatorsAlways: {
54
51
  env: 'SLASH_VALIDATORS_ALWAYS',
55
52
  description: 'Comma-separated list of validator addresses that should always be slashed.',
@@ -72,21 +69,38 @@ export const slasherConfigMappings: ConfigMappingsType<SlasherConfig> = {
72
69
  .map(addr => EthAddress.fromString(addr)),
73
70
  defaultValue: DefaultSlasherConfig.slashValidatorsNever,
74
71
  },
75
- slashPrunePenalty: {
76
- env: 'SLASH_PRUNE_PENALTY',
77
- description: 'Penalty amount for slashing validators of a valid pruned epoch (set to 0 to disable).',
78
- ...bigintConfigHelper(DefaultSlasherConfig.slashPrunePenalty),
79
- },
80
72
  slashDataWithholdingPenalty: {
81
73
  env: 'SLASH_DATA_WITHHOLDING_PENALTY',
82
- description: 'Penalty amount for slashing validators for data withholding (set to 0 to disable).',
74
+ description: 'Penalty for data withholding (0 records offenses without slash votes).',
83
75
  ...bigintConfigHelper(DefaultSlasherConfig.slashDataWithholdingPenalty),
84
76
  },
77
+ slashDataWithholdingToleranceSlots: {
78
+ env: 'SLASH_DATA_WITHHOLDING_TOLERANCE_SLOTS',
79
+ description:
80
+ 'Number of full L2 slots that must elapse after a checkpoint slot before declaring its txs missing and slashing its attesters for data withholding.',
81
+ ...numberConfigHelper(DefaultSlasherConfig.slashDataWithholdingToleranceSlots),
82
+ },
85
83
  slashBroadcastedInvalidBlockPenalty: {
86
84
  env: 'SLASH_INVALID_BLOCK_PENALTY',
87
85
  description: 'Penalty amount for slashing a validator for an invalid block proposed via p2p.',
88
86
  ...bigintConfigHelper(DefaultSlasherConfig.slashBroadcastedInvalidBlockPenalty),
89
87
  },
88
+ slashBroadcastedInvalidCheckpointProposalPenalty: {
89
+ env: 'SLASH_INVALID_CHECKPOINT_PROPOSAL_PENALTY',
90
+ description: 'Penalty amount for slashing a validator for an invalid checkpoint proposal proposed via p2p.',
91
+ ...bigintConfigHelper(DefaultSlasherConfig.slashBroadcastedInvalidCheckpointProposalPenalty),
92
+ },
93
+ slashDuplicateProposalPenalty: {
94
+ env: 'SLASH_DUPLICATE_PROPOSAL_PENALTY',
95
+ description: 'Penalty amount for slashing a validator for sending duplicate proposals.',
96
+ ...bigintConfigHelper(DefaultSlasherConfig.slashDuplicateProposalPenalty),
97
+ },
98
+ slashDuplicateAttestationPenalty: {
99
+ env: 'SLASH_DUPLICATE_ATTESTATION_PENALTY',
100
+ description:
101
+ 'Penalty amount for slashing a validator for signing attestations for different proposals at the same slot.',
102
+ ...bigintConfigHelper(DefaultSlasherConfig.slashDuplicateAttestationPenalty),
103
+ },
90
104
  slashInactivityTargetPercentage: {
91
105
  env: 'SLASH_INACTIVITY_TARGET_PERCENTAGE',
92
106
  description:
@@ -111,23 +125,28 @@ export const slasherConfigMappings: ConfigMappingsType<SlasherConfig> = {
111
125
  },
112
126
  slashInactivityPenalty: {
113
127
  env: 'SLASH_INACTIVITY_PENALTY',
114
- description: 'Penalty amount for slashing an inactive validator (set to 0 to disable).',
128
+ description: 'Penalty for an inactive validator (0 records offenses without slash votes).',
115
129
  ...bigintConfigHelper(DefaultSlasherConfig.slashInactivityPenalty),
116
130
  },
117
131
  slashProposeInvalidAttestationsPenalty: {
118
132
  env: 'SLASH_PROPOSE_INVALID_ATTESTATIONS_PENALTY',
119
- description: 'Penalty amount for slashing a proposer that proposed invalid attestations (set to 0 to disable).',
133
+ description: 'Penalty for proposing invalid attestations (0 records offenses without slash votes).',
120
134
  ...bigintConfigHelper(DefaultSlasherConfig.slashProposeInvalidAttestationsPenalty),
121
135
  },
122
- slashAttestDescendantOfInvalidPenalty: {
123
- env: 'SLASH_ATTEST_DESCENDANT_OF_INVALID_PENALTY',
136
+ slashProposeDescendantOfCheckpointWithInvalidAttestationsPenalty: {
137
+ env: 'SLASH_PROPOSE_DESCENDANT_OF_CHECKPOINT_WITH_INVALID_ATTESTATIONS_PENALTY',
124
138
  description:
125
- 'Penalty amount for slashing a validator that attested to a descendant of an invalid block (set to 0 to disable).',
126
- ...bigintConfigHelper(DefaultSlasherConfig.slashAttestDescendantOfInvalidPenalty),
139
+ 'Penalty for publishing a checkpoint building on an invalid checkpoint (0 records offenses without slash votes).',
140
+ ...bigintConfigHelper(DefaultSlasherConfig.slashProposeDescendantOfCheckpointWithInvalidAttestationsPenalty),
141
+ },
142
+ slashAttestInvalidCheckpointProposalPenalty: {
143
+ env: 'SLASH_ATTEST_INVALID_CHECKPOINT_PROPOSAL_PENALTY',
144
+ description: 'Penalty for attesting to an invalid checkpoint proposal (0 records offenses without slash votes).',
145
+ ...bigintConfigHelper(DefaultSlasherConfig.slashAttestInvalidCheckpointProposalPenalty),
127
146
  },
128
147
  slashUnknownPenalty: {
129
148
  env: 'SLASH_UNKNOWN_PENALTY',
130
- description: 'Penalty amount for slashing a validator for an unknown offense (set to 0 to disable).',
149
+ description: 'Penalty for an unknown offense (0 records offenses without slash votes).',
131
150
  ...bigintConfigHelper(DefaultSlasherConfig.slashUnknownPenalty),
132
151
  },
133
152
  slashOffenseExpirationRounds: {
@@ -141,7 +160,8 @@ export const slasherConfigMappings: ConfigMappingsType<SlasherConfig> = {
141
160
  ...numberConfigHelper(DefaultSlasherConfig.slashMaxPayloadSize),
142
161
  },
143
162
  slashGracePeriodL2Slots: {
144
- description: 'Number of L2 slots to wait before considering a slashing offense expired.',
163
+ description:
164
+ 'Number of L2 slots after the network upgrade during which slashing offenses are ignored. The upgrade time is determined from the CanonicalRollupUpdated event.',
145
165
  env: 'SLASH_GRACE_PERIOD_L2_SLOTS',
146
166
  ...numberConfigHelper(DefaultSlasherConfig.slashGracePeriodL2Slots),
147
167
  },
@@ -1,14 +1,16 @@
1
1
  import { EpochCache } from '@aztec/epoch-cache';
2
- import { RollupContract } from '@aztec/ethereum/contracts';
2
+ import { RegistryContract, RollupContract } from '@aztec/ethereum/contracts';
3
3
  import type { L1ReaderConfig } from '@aztec/ethereum/l1-reader';
4
4
  import type { ViemClient } from '@aztec/ethereum/types';
5
+ import { SlotNumber } from '@aztec/foundation/branded-types';
5
6
  import { unique } from '@aztec/foundation/collection';
6
7
  import { EthAddress } from '@aztec/foundation/eth-address';
7
8
  import { createLogger } from '@aztec/foundation/log';
8
9
  import { DateProvider } from '@aztec/foundation/timer';
9
- import type { DataStoreConfig } from '@aztec/kv-store/config';
10
10
  import { createStore } from '@aztec/kv-store/lmdb-v2';
11
+ import { getSlotAtTimestamp } from '@aztec/stdlib/epoch-helpers';
11
12
  import type { SlasherConfig } from '@aztec/stdlib/interfaces/server';
13
+ import type { DataStoreConfig } from '@aztec/stdlib/kv-store';
12
14
 
13
15
  import { SlasherClientFacade } from '../slasher_client_facade.js';
14
16
  import type { SlasherClientInterface } from '../slasher_client_interface.js';
@@ -18,7 +20,7 @@ import type { Watcher } from '../watcher.js';
18
20
  /** Creates a slasher client facade that updates itself whenever the rollup slasher changes */
19
21
  export async function createSlasherFacade(
20
22
  config: SlasherConfig & DataStoreConfig & { ethereumSlotDuration: number },
21
- l1Contracts: Pick<L1ReaderConfig['l1Contracts'], 'rollupAddress' | 'slashFactoryAddress'>,
23
+ l1Contracts: Pick<L1ReaderConfig, 'rollupAddress' | 'registryAddress'>,
22
24
  l1Client: ViemClient,
23
25
  watchers: Watcher[],
24
26
  dateProvider: DateProvider,
@@ -31,9 +33,35 @@ export async function createSlasherFacade(
31
33
  throw new Error('Cannot initialize SlasherClient without a Rollup address');
32
34
  }
33
35
 
34
- const kvStore = await createStore('slasher', SCHEMA_VERSION, config, createLogger('slasher:lmdb'));
36
+ const kvStore = await createStore('slasher', SCHEMA_VERSION, config, logger.getBindings());
35
37
  const rollup = new RollupContract(l1Client, l1Contracts.rollupAddress);
36
38
 
39
+ // Compute and cache the L2 slot at which the rollup was registered as canonical
40
+ const settingsMap = kvStore.openMap<string, number>('slasher-settings');
41
+ const cacheKey = `registeredSlot:${l1Contracts.rollupAddress}`;
42
+ let rollupRegisteredAtL2Slot = (await settingsMap.getAsync(cacheKey)) as SlotNumber | undefined;
43
+
44
+ if (rollupRegisteredAtL2Slot === undefined) {
45
+ const registry = new RegistryContract(l1Client, l1Contracts.registryAddress);
46
+ const l1StartBlock = await rollup.getL1StartBlock();
47
+ const registrationTimestamp = await registry.getCanonicalRollupRegistrationTimestamp(
48
+ l1Contracts.rollupAddress,
49
+ l1StartBlock,
50
+ );
51
+ if (registrationTimestamp !== undefined) {
52
+ const l1GenesisTime = await rollup.getL1GenesisTime();
53
+ const slotDuration = await rollup.getSlotDuration();
54
+ rollupRegisteredAtL2Slot = getSlotAtTimestamp(registrationTimestamp, {
55
+ l1GenesisTime,
56
+ slotDuration: Number(slotDuration),
57
+ });
58
+ } else {
59
+ rollupRegisteredAtL2Slot = SlotNumber(0);
60
+ }
61
+ await settingsMap.set(cacheKey, rollupRegisteredAtL2Slot);
62
+ logger.info(`Canonical rollup registered at L2 slot ${rollupRegisteredAtL2Slot}`);
63
+ }
64
+
37
65
  const slashValidatorsNever = config.slashSelfAllowed
38
66
  ? config.slashValidatorsNever
39
67
  : unique([...config.slashValidatorsNever, ...validatorAddresses].map(a => a.toString())).map(EthAddress.fromString);
@@ -43,11 +71,11 @@ export async function createSlasherFacade(
43
71
  updatedConfig,
44
72
  rollup,
45
73
  l1Client,
46
- l1Contracts.slashFactoryAddress,
47
74
  watchers,
48
75
  epochCache,
49
76
  dateProvider,
50
77
  kvStore,
78
+ rollupRegisteredAtL2Slot,
51
79
  logger,
52
80
  );
53
81
  }
@@ -1,142 +1,61 @@
1
1
  import { EpochCache } from '@aztec/epoch-cache';
2
- import {
3
- EmpireSlashingProposerContract,
4
- RollupContract,
5
- TallySlashingProposerContract,
6
- } from '@aztec/ethereum/contracts';
2
+ import { RollupContract, SlashingProposerContract } from '@aztec/ethereum/contracts';
7
3
  import type { ViemClient } from '@aztec/ethereum/types';
8
- import { EthAddress } from '@aztec/foundation/eth-address';
4
+ import type { SlotNumber } from '@aztec/foundation/branded-types';
9
5
  import { createLogger } from '@aztec/foundation/log';
10
6
  import { DateProvider } from '@aztec/foundation/timer';
11
- import type { DataStoreConfig } from '@aztec/kv-store/config';
12
7
  import { AztecLMDBStoreV2 } from '@aztec/kv-store/lmdb-v2';
13
8
  import type { SlasherConfig } from '@aztec/stdlib/interfaces/server';
14
- import { SlashFactoryContract } from '@aztec/stdlib/l1-contracts';
9
+ import type { DataStoreConfig } from '@aztec/stdlib/kv-store';
15
10
 
16
- import { EmpireSlasherClient, type EmpireSlasherSettings } from '../empire_slasher_client.js';
17
11
  import { NullSlasherClient } from '../null_slasher_client.js';
12
+ import { SlasherClient } from '../slasher_client.js';
18
13
  import { SlasherOffensesStore } from '../stores/offenses_store.js';
19
- import { SlasherPayloadsStore } from '../stores/payloads_store.js';
20
- import { TallySlasherClient } from '../tally_slasher_client.js';
21
14
  import type { Watcher } from '../watcher.js';
22
- import { getTallySlasherSettings } from './get_settings.js';
15
+ import { getSlasherSettings } from './get_settings.js';
23
16
 
24
- /** Creates a slasher client implementation (either tally or empire) based on the slasher proposer type in the rollup */
17
+ /** Creates a slasher client implementation based on the slasher proposer type in the rollup */
25
18
  export async function createSlasherImplementation(
26
19
  config: SlasherConfig & DataStoreConfig & { ethereumSlotDuration: number },
27
20
  rollup: RollupContract,
28
21
  l1Client: ViemClient,
29
- slashFactoryAddress: EthAddress | undefined,
30
22
  watchers: Watcher[],
31
23
  epochCache: EpochCache,
32
24
  dateProvider: DateProvider,
33
25
  kvStore: AztecLMDBStoreV2,
26
+ rollupRegisteredAtL2Slot: SlotNumber,
34
27
  logger = createLogger('slasher'),
35
28
  ) {
36
29
  const proposer = await rollup.getSlashingProposer();
37
30
  if (!proposer) {
38
31
  return new NullSlasherClient(config);
39
- } else if (proposer.type === 'tally') {
40
- return createTallySlasher(config, rollup, proposer, watchers, dateProvider, epochCache, kvStore, logger);
41
32
  } else {
42
- if (!slashFactoryAddress || slashFactoryAddress.equals(EthAddress.ZERO)) {
43
- throw new Error('Cannot initialize an empire-based SlasherClient without a SlashFactory address');
44
- }
45
- const slashFactory = new SlashFactoryContract(l1Client, slashFactoryAddress.toString());
46
- return createEmpireSlasher(config, rollup, proposer, slashFactory, watchers, dateProvider, kvStore, logger);
33
+ return createSlasher(
34
+ config,
35
+ rollup,
36
+ proposer,
37
+ watchers,
38
+ dateProvider,
39
+ epochCache,
40
+ kvStore,
41
+ rollupRegisteredAtL2Slot,
42
+ logger,
43
+ );
47
44
  }
48
45
  }
49
46
 
50
- async function createEmpireSlasher(
51
- config: SlasherConfig & DataStoreConfig & { ethereumSlotDuration: number },
52
- rollup: RollupContract,
53
- slashingProposer: EmpireSlashingProposerContract,
54
- slashFactoryContract: SlashFactoryContract,
55
- watchers: Watcher[],
56
- dateProvider: DateProvider,
57
- kvStore: AztecLMDBStoreV2,
58
- logger = createLogger('slasher'),
59
- ): Promise<EmpireSlasherClient> {
60
- if (slashingProposer.type !== 'empire') {
61
- throw new Error('Slashing proposer contract is not of type Empire');
62
- }
63
-
64
- const [
65
- slashingExecutionDelayInRounds,
66
- slashingPayloadLifetimeInRounds,
67
- slashingRoundSize,
68
- slashingQuorumSize,
69
- epochDuration,
70
- proofSubmissionEpochs,
71
- l1GenesisTime,
72
- slotDuration,
73
- l1StartBlock,
74
- slasher,
75
- ] = await Promise.all([
76
- slashingProposer.getExecutionDelayInRounds(),
77
- slashingProposer.getLifetimeInRounds(),
78
- slashingProposer.getRoundSize(),
79
- slashingProposer.getQuorumSize(),
80
- rollup.getEpochDuration(),
81
- rollup.getProofSubmissionEpochs(),
82
- rollup.getL1GenesisTime(),
83
- rollup.getSlotDuration(),
84
- rollup.getL1StartBlock(),
85
- rollup.getSlasherContract(),
86
- ]);
87
-
88
- const settings: EmpireSlasherSettings = {
89
- slashingExecutionDelayInRounds: Number(slashingExecutionDelayInRounds),
90
- slashingPayloadLifetimeInRounds: Number(slashingPayloadLifetimeInRounds),
91
- slashingRoundSize: Number(slashingRoundSize),
92
- slashingQuorumSize: Number(slashingQuorumSize),
93
- epochDuration: Number(epochDuration),
94
- proofSubmissionEpochs: Number(proofSubmissionEpochs),
95
- l1GenesisTime: l1GenesisTime,
96
- slotDuration: Number(slotDuration),
97
- l1StartBlock,
98
- ethereumSlotDuration: config.ethereumSlotDuration,
99
- slashingAmounts: undefined,
100
- };
101
-
102
- const payloadsStore = new SlasherPayloadsStore(kvStore, {
103
- slashingPayloadLifetimeInRounds: settings.slashingPayloadLifetimeInRounds,
104
- });
105
- const offensesStore = new SlasherOffensesStore(kvStore, {
106
- ...settings,
107
- slashOffenseExpirationRounds: config.slashOffenseExpirationRounds,
108
- });
109
-
110
- return new EmpireSlasherClient(
111
- config,
112
- settings,
113
- slashFactoryContract,
114
- slashingProposer,
115
- slasher!,
116
- rollup,
117
- watchers,
118
- dateProvider,
119
- offensesStore,
120
- payloadsStore,
121
- logger,
122
- );
123
- }
124
-
125
- async function createTallySlasher(
47
+ async function createSlasher(
126
48
  config: SlasherConfig & DataStoreConfig,
127
49
  rollup: RollupContract,
128
- slashingProposer: TallySlashingProposerContract,
50
+ slashingProposer: SlashingProposerContract,
129
51
  watchers: Watcher[],
130
52
  dateProvider: DateProvider,
131
53
  epochCache: EpochCache,
132
54
  kvStore: AztecLMDBStoreV2,
55
+ rollupRegisteredAtL2Slot: SlotNumber,
133
56
  logger = createLogger('slasher'),
134
- ): Promise<TallySlasherClient> {
135
- if (slashingProposer.type !== 'tally') {
136
- throw new Error('Slashing proposer contract is not of type tally');
137
- }
138
-
139
- const settings = await getTallySlasherSettings(rollup, slashingProposer);
57
+ ): Promise<SlasherClient> {
58
+ const settings = { ...(await getSlasherSettings(rollup, slashingProposer)), rollupRegisteredAtL2Slot };
140
59
  const slasher = await rollup.getSlasherContract();
141
60
 
142
61
  const offensesStore = new SlasherOffensesStore(kvStore, {
@@ -144,7 +63,7 @@ async function createTallySlasher(
144
63
  slashOffenseExpirationRounds: config.slashOffenseExpirationRounds,
145
64
  });
146
65
 
147
- return new TallySlasherClient(
66
+ return new SlasherClient(
148
67
  config,
149
68
  settings,
150
69
  slashingProposer,
@@ -1,15 +1,15 @@
1
- import type { RollupContract, TallySlashingProposerContract } from '@aztec/ethereum/contracts';
1
+ import type { RollupContract, SlashingProposerContract } from '@aztec/ethereum/contracts';
2
2
 
3
- import type { TallySlasherSettings } from '../tally_slasher_client.js';
3
+ import type { SlasherSettings } from '../slasher_client.js';
4
4
 
5
- export async function getTallySlasherSettings(
5
+ export async function getSlasherSettings(
6
6
  rollup: RollupContract,
7
- slashingProposer?: TallySlashingProposerContract,
8
- ): Promise<TallySlasherSettings> {
7
+ slashingProposer?: SlashingProposerContract,
8
+ ): Promise<Omit<SlasherSettings, 'rollupRegisteredAtL2Slot'>> {
9
9
  if (!slashingProposer) {
10
10
  const rollupSlashingProposer = await rollup.getSlashingProposer();
11
- if (!rollupSlashingProposer || rollupSlashingProposer.type !== 'tally') {
12
- throw new Error('Rollup slashing proposer is not of type tally');
11
+ if (!rollupSlashingProposer) {
12
+ throw new Error('Rollup slashing proposer not found');
13
13
  }
14
14
  slashingProposer = rollupSlashingProposer;
15
15
  }
@@ -40,7 +40,7 @@ export async function getTallySlasherSettings(
40
40
  rollup.getTargetCommitteeSize(),
41
41
  ]);
42
42
 
43
- const settings: TallySlasherSettings = {
43
+ const settings: Omit<SlasherSettings, 'rollupRegisteredAtL2Slot'> = {
44
44
  slashingExecutionDelayInRounds: Number(slashingExecutionDelayInRounds),
45
45
  slashingRoundSize: Number(slashingRoundSize),
46
46
  slashingRoundSizeInEpochs: Number(slashingRoundSizeInEpochs),
@@ -1,2 +1,2 @@
1
1
  export { createSlasherFacade as createSlasher } from './create_facade.js';
2
- export { getTallySlasherSettings } from './get_settings.js';
2
+ export { getSlasherSettings } from './get_settings.js';
@@ -0,0 +1,23 @@
1
+ // Auto-generated from spartan/environments/network-defaults.yml
2
+ // Do not edit manually - run yarn generate to regenerate
3
+
4
+ /** Default slasher configuration values from network-defaults.yml */
5
+ export const slasherDefaultEnv = {
6
+ SLASH_OFFENSE_EXPIRATION_ROUNDS: 4,
7
+ SLASH_MAX_PAYLOAD_SIZE: 80,
8
+ SLASH_EXECUTE_ROUNDS_LOOK_BACK: 4,
9
+ SLASH_DATA_WITHHOLDING_PENALTY: 10000000000000000000,
10
+ SLASH_DATA_WITHHOLDING_TOLERANCE_SLOTS: 3,
11
+ SLASH_INACTIVITY_TARGET_PERCENTAGE: 0.9,
12
+ SLASH_INACTIVITY_CONSECUTIVE_EPOCH_THRESHOLD: 1,
13
+ SLASH_INACTIVITY_PENALTY: 10000000000000000000,
14
+ SLASH_PROPOSE_INVALID_ATTESTATIONS_PENALTY: 10000000000000000000,
15
+ SLASH_PROPOSE_DESCENDANT_OF_CHECKPOINT_WITH_INVALID_ATTESTATIONS_PENALTY: 10000000000000000000,
16
+ SLASH_ATTEST_INVALID_CHECKPOINT_PROPOSAL_PENALTY: 10000000000000000000,
17
+ SLASH_DUPLICATE_PROPOSAL_PENALTY: 0,
18
+ SLASH_DUPLICATE_ATTESTATION_PENALTY: 0,
19
+ SLASH_UNKNOWN_PENALTY: 10000000000000000000,
20
+ SLASH_INVALID_BLOCK_PENALTY: 10000000000000000000,
21
+ SLASH_INVALID_CHECKPOINT_PROPOSAL_PENALTY: 0,
22
+ SLASH_GRACE_PERIOD_L2_SLOTS: 0,
23
+ } as const;
package/src/index.ts CHANGED
@@ -1,8 +1,10 @@
1
1
  export * from './config.js';
2
- export * from './watchers/epoch_prune_watcher.js';
2
+ export * from './watchers/data_withholding_watcher.js';
3
3
  export * from './watchers/attestations_block_watcher.js';
4
- export * from './empire_slasher_client.js';
5
- export * from './tally_slasher_client.js';
4
+ export * from './watchers/attested_invalid_proposal_watcher.js';
5
+ export * from './watchers/broadcasted_invalid_checkpoint_proposal_watcher.js';
6
+ export * from './watchers/checkpoint_equivocation_watcher.js';
7
+ export * from './slasher_client.js';
6
8
  export * from './slash_offenses_collector.js';
7
9
  export * from './slasher_client_interface.js';
8
10
  export * from './factory/index.js';
@@ -1,5 +1,5 @@
1
1
  import type { SlotNumber } from '@aztec/foundation/branded-types';
2
- import type { Offense, ProposerSlashAction, SlashPayloadRound } from '@aztec/stdlib/slashing';
2
+ import type { Offense, ProposerSlashAction } from '@aztec/stdlib/slashing';
3
3
 
4
4
  import type { SlasherConfig } from './config.js';
5
5
  import type { SlasherClientInterface } from './slasher_client_interface.js';
@@ -15,15 +15,11 @@ export class NullSlasherClient implements SlasherClientInterface {
15
15
  return Promise.resolve();
16
16
  }
17
17
 
18
- public getSlashPayloads(): Promise<SlashPayloadRound[]> {
19
- return Promise.resolve([]);
20
- }
21
-
22
18
  public gatherOffensesForRound(_round?: bigint): Promise<Offense[]> {
23
19
  return Promise.resolve([]);
24
20
  }
25
21
 
26
- public getPendingOffenses(): Promise<Offense[]> {
22
+ public getOffenses(): Promise<Offense[]> {
27
23
  return Promise.resolve([]);
28
24
  }
29
25