@aztec/stdlib 5.0.0-nightly.20260409 → 5.0.0-nightly.20260411

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 (83) hide show
  1. package/dest/config/sequencer-config.d.ts +2 -2
  2. package/dest/config/sequencer-config.d.ts.map +1 -1
  3. package/dest/config/sequencer-config.js +7 -0
  4. package/dest/gas/gas_fees.d.ts +1 -1
  5. package/dest/gas/gas_fees.d.ts.map +1 -1
  6. package/dest/gas/gas_fees.js +10 -1
  7. package/dest/interfaces/aztec-node-admin.d.ts +3 -11
  8. package/dest/interfaces/aztec-node-admin.d.ts.map +1 -1
  9. package/dest/interfaces/aztec-node-admin.js +1 -2
  10. package/dest/interfaces/aztec-node-debug.d.ts +21 -0
  11. package/dest/interfaces/aztec-node-debug.d.ts.map +1 -0
  12. package/dest/interfaces/aztec-node-debug.js +18 -0
  13. package/dest/interfaces/client.d.ts +2 -1
  14. package/dest/interfaces/client.d.ts.map +1 -1
  15. package/dest/interfaces/client.js +1 -0
  16. package/dest/interfaces/proving-job.d.ts +166 -166
  17. package/dest/interfaces/slasher.d.ts +1 -10
  18. package/dest/interfaces/slasher.d.ts.map +1 -1
  19. package/dest/interfaces/slasher.js +0 -2
  20. package/dest/interfaces/validator.d.ts +3 -6
  21. package/dest/interfaces/validator.d.ts.map +1 -1
  22. package/dest/l1-contracts/index.d.ts +2 -2
  23. package/dest/l1-contracts/index.d.ts.map +1 -1
  24. package/dest/l1-contracts/index.js +1 -1
  25. package/dest/p2p/checkpoint_proposal.d.ts +2 -2
  26. package/dest/p2p/checkpoint_proposal.d.ts.map +1 -1
  27. package/dest/p2p/checkpoint_proposal.js +3 -15
  28. package/dest/slashing/index.d.ts +2 -3
  29. package/dest/slashing/index.d.ts.map +1 -1
  30. package/dest/slashing/index.js +1 -2
  31. package/dest/slashing/serialization.d.ts +2 -6
  32. package/dest/slashing/serialization.d.ts.map +1 -1
  33. package/dest/slashing/serialization.js +0 -60
  34. package/dest/slashing/types.d.ts +4 -90
  35. package/dest/slashing/types.d.ts.map +1 -1
  36. package/dest/slashing/types.js +0 -14
  37. package/dest/slashing/{tally.d.ts → votes.d.ts} +1 -1
  38. package/dest/slashing/{tally.d.ts.map → votes.d.ts.map} +1 -1
  39. package/dest/slashing/{tally.js → votes.js} +1 -1
  40. package/dest/tests/mocks.d.ts +1 -1
  41. package/dest/tests/mocks.d.ts.map +1 -1
  42. package/dest/tests/mocks.js +11 -16
  43. package/dest/timetable/index.d.ts +51 -1
  44. package/dest/timetable/index.d.ts.map +1 -1
  45. package/dest/timetable/index.js +204 -14
  46. package/dest/tx/global_variable_builder.d.ts +3 -14
  47. package/dest/tx/global_variable_builder.d.ts.map +1 -1
  48. package/dest/tx/simulated_tx.d.ts +1 -1
  49. package/dest/tx/simulated_tx.js +1 -1
  50. package/dest/world-state/genesis_data.d.ts +11 -0
  51. package/dest/world-state/genesis_data.d.ts.map +1 -0
  52. package/dest/world-state/genesis_data.js +4 -0
  53. package/dest/world-state/index.d.ts +2 -1
  54. package/dest/world-state/index.d.ts.map +1 -1
  55. package/dest/world-state/index.js +1 -0
  56. package/package.json +8 -8
  57. package/src/config/sequencer-config.ts +11 -1
  58. package/src/gas/gas_fees.ts +12 -4
  59. package/src/interfaces/aztec-node-admin.ts +3 -6
  60. package/src/interfaces/aztec-node-debug.ts +40 -0
  61. package/src/interfaces/client.ts +1 -0
  62. package/src/interfaces/slasher.ts +0 -6
  63. package/src/interfaces/validator.ts +1 -4
  64. package/src/l1-contracts/index.ts +1 -1
  65. package/src/p2p/checkpoint_proposal.ts +10 -26
  66. package/src/slashing/index.ts +1 -2
  67. package/src/slashing/serialization.ts +1 -81
  68. package/src/slashing/types.ts +3 -35
  69. package/src/slashing/{tally.ts → votes.ts} +1 -1
  70. package/src/tests/mocks.ts +12 -10
  71. package/src/timetable/index.ts +293 -13
  72. package/src/tx/global_variable_builder.ts +2 -15
  73. package/src/tx/simulated_tx.ts +1 -1
  74. package/src/world-state/genesis_data.ts +15 -0
  75. package/src/world-state/index.ts +1 -0
  76. package/dest/l1-contracts/slash_factory.d.ts +0 -45
  77. package/dest/l1-contracts/slash_factory.d.ts.map +0 -1
  78. package/dest/l1-contracts/slash_factory.js +0 -158
  79. package/dest/slashing/empire.d.ts +0 -31
  80. package/dest/slashing/empire.d.ts.map +0 -1
  81. package/dest/slashing/empire.js +0 -87
  82. package/src/l1-contracts/slash_factory.ts +0 -180
  83. package/src/slashing/empire.ts +0 -104
@@ -1,45 +0,0 @@
1
- import type { L1TxRequest } from '@aztec/ethereum/l1-tx-utils';
2
- import type { ViemClient } from '@aztec/ethereum/types';
3
- import { EthAddress } from '@aztec/foundation/eth-address';
4
- import { type Hex, type Log } from 'viem';
5
- import type { L1RollupConstants } from '../epoch-helpers/index.js';
6
- import { type SlashPayload, type ValidatorSlash, type ValidatorSlashOffense } from '../slashing/index.js';
7
- export declare class SlashFactoryContract {
8
- readonly client: ViemClient;
9
- private readonly logger;
10
- private readonly contract;
11
- constructor(client: ViemClient, address: Hex | EthAddress);
12
- get address(): EthAddress;
13
- buildCreatePayloadRequest(slashes: ValidatorSlash[]): L1TxRequest;
14
- /** Tries to extract a SlashPayloadCreated event from the given logs. */
15
- tryExtractSlashPayloadCreatedEvent(logs: Log[]): {
16
- eventName: "SlashPayloadCreated";
17
- args: {
18
- amounts: readonly bigint[];
19
- offenses: readonly (readonly bigint[])[];
20
- payloadAddress: `0x${string}`;
21
- validators: readonly `0x${string}`[];
22
- };
23
- } | undefined;
24
- getSlashPayloadCreatedEvents(): Promise<SlashPayload[]>;
25
- /**
26
- * Searches for a slash payload in the events emitted by the contract.
27
- * This method cannot query for historical payload events, it queries for payloads that have not yet expired.
28
- * @param payloadAddress The address of the payload to search for.
29
- * @param constants The L1 rollup constants needed for time calculations.
30
- */
31
- getSlashPayloadFromEvents(payloadAddress: EthAddress, settings: {
32
- logsBatchSize?: number;
33
- slashingRoundSize: number;
34
- slashingPayloadLifetimeInRounds: number;
35
- } & Pick<L1RollupConstants, 'slotDuration' | 'ethereumSlotDuration'>): Promise<Omit<SlashPayload, 'votes'> | undefined>;
36
- getAddressAndIsDeployed(slashes: ValidatorSlash[]): Promise<{
37
- address: EthAddress;
38
- salt: Hex;
39
- isDeployed: boolean;
40
- }>;
41
- private sortSlashes;
42
- }
43
- export declare function packValidatorSlashOffense(offense: ValidatorSlashOffense): bigint;
44
- export declare function unpackValidatorSlashOffense(packed: bigint): ValidatorSlashOffense;
45
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2xhc2hfZmFjdG9yeS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2wxLWNvbnRyYWN0cy9zbGFzaF9mYWN0b3J5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBQy9ELE9BQU8sS0FBSyxFQUFFLFVBQVUsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBR3hELE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUkzRCxPQUFPLEVBQThCLEtBQUssR0FBRyxFQUFFLEtBQUssR0FBRyxFQUFtQyxNQUFNLE1BQU0sQ0FBQztBQUV2RyxPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQ25FLE9BQU8sRUFFTCxLQUFLLFlBQVksRUFDakIsS0FBSyxjQUFjLEVBQ25CLEtBQUsscUJBQXFCLEVBRTNCLE1BQU0sc0JBQXNCLENBQUM7QUFFOUIscUJBQWEsb0JBQW9CO2FBS2IsTUFBTSxFQUFFLFVBQVU7SUFKcEMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQTJDO0lBQ2xFLE9BQU8sQ0FBQyxRQUFRLENBQUMsUUFBUSxDQUE0RDtJQUVyRixZQUNrQixNQUFNLEVBQUUsVUFBVSxFQUNsQyxPQUFPLEVBQUUsR0FBRyxHQUFHLFVBQVUsRUFPMUI7SUFFRCxJQUFXLE9BQU8sZUFFakI7SUFFTSx5QkFBeUIsQ0FBQyxPQUFPLEVBQUUsY0FBYyxFQUFFLEdBQUcsV0FBVyxDQWdCdkU7SUFFRCx3RUFBd0U7SUFDakUsa0NBQWtDLENBQUMsSUFBSSxFQUFFLEdBQUcsRUFBRTs7Ozs7Ozs7a0JBRXBEO0lBRVksNEJBQTRCLElBQUksT0FBTyxDQUFDLFlBQVksRUFBRSxDQUFDLENBZW5FO0lBRUQ7Ozs7O09BS0c7SUFDVSx5QkFBeUIsQ0FDcEMsY0FBYyxFQUFFLFVBQVUsRUFDMUIsUUFBUSxFQUFFO1FBQ1IsYUFBYSxDQUFDLEVBQUUsTUFBTSxDQUFDO1FBQ3ZCLGlCQUFpQixFQUFFLE1BQU0sQ0FBQztRQUMxQiwrQkFBK0IsRUFBRSxNQUFNLENBQUM7S0FDekMsR0FBRyxJQUFJLENBQUMsaUJBQWlCLEVBQUUsY0FBYyxHQUFHLHNCQUFzQixDQUFDLEdBQ25FLE9BQU8sQ0FBQyxJQUFJLENBQUMsWUFBWSxFQUFFLE9BQU8sQ0FBQyxHQUFHLFNBQVMsQ0FBQyxDQW1EbEQ7SUFFWSx1QkFBdUIsQ0FDbEMsT0FBTyxFQUFFLGNBQWMsRUFBRSxHQUN4QixPQUFPLENBQUM7UUFBRSxPQUFPLEVBQUUsVUFBVSxDQUFDO1FBQUMsSUFBSSxFQUFFLEdBQUcsQ0FBQztRQUFDLFVBQVUsRUFBRSxPQUFPLENBQUE7S0FBRSxDQUFDLENBUWxFO0lBRUQsT0FBTyxDQUFDLFdBQVc7Q0FRcEI7QUFFRCx3QkFBZ0IseUJBQXlCLENBQUMsT0FBTyxFQUFFLHFCQUFxQixHQUFHLE1BQU0sQ0FNaEY7QUFFRCx3QkFBZ0IsMkJBQTJCLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxxQkFBcUIsQ0FLakYifQ==
@@ -1 +0,0 @@
1
- {"version":3,"file":"slash_factory.d.ts","sourceRoot":"","sources":["../../src/l1-contracts/slash_factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAI3D,OAAO,EAA8B,KAAK,GAAG,EAAE,KAAK,GAAG,EAAmC,MAAM,MAAM,CAAC;AAEvG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAE3B,MAAM,sBAAsB,CAAC;AAE9B,qBAAa,oBAAoB;aAKb,MAAM,EAAE,UAAU;IAJpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAClE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4D;IAErF,YACkB,MAAM,EAAE,UAAU,EAClC,OAAO,EAAE,GAAG,GAAG,UAAU,EAO1B;IAED,IAAW,OAAO,eAEjB;IAEM,yBAAyB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,WAAW,CAgBvE;IAED,wEAAwE;IACjE,kCAAkC,CAAC,IAAI,EAAE,GAAG,EAAE;;;;;;;;kBAEpD;IAEY,4BAA4B,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAenE;IAED;;;;;OAKG;IACU,yBAAyB,CACpC,cAAc,EAAE,UAAU,EAC1B,QAAQ,EAAE;QACR,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,+BAA+B,EAAE,MAAM,CAAC;KACzC,GAAG,IAAI,CAAC,iBAAiB,EAAE,cAAc,GAAG,sBAAsB,CAAC,GACnE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAmDlD;IAEY,uBAAuB,CAClC,OAAO,EAAE,cAAc,EAAE,GACxB,OAAO,CAAC;QAAE,OAAO,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,GAAG,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC,CAQlE;IAED,OAAO,CAAC,WAAW;CAQpB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAMhF;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAKjF"}
@@ -1,158 +0,0 @@
1
- import { tryExtractEvent } from '@aztec/ethereum/utils';
2
- import { maxBigint } from '@aztec/foundation/bigint';
3
- import { EthAddress } from '@aztec/foundation/eth-address';
4
- import { createLogger } from '@aztec/foundation/log';
5
- import { SlashFactoryAbi } from '@aztec/l1-artifacts/SlashFactoryAbi';
6
- import { encodeFunctionData, getContract } from 'viem';
7
- import { OffenseToBigInt, bigIntToOffense } from '../slashing/index.js';
8
- export class SlashFactoryContract {
9
- client;
10
- logger;
11
- contract;
12
- constructor(client, address){
13
- this.client = client;
14
- this.logger = createLogger('contracts:slash_factory');
15
- this.contract = getContract({
16
- address: typeof address === 'string' ? address : address.toString(),
17
- abi: SlashFactoryAbi,
18
- client
19
- });
20
- }
21
- get address() {
22
- return EthAddress.fromString(this.contract.address);
23
- }
24
- buildCreatePayloadRequest(slashes) {
25
- const sorted = this.sortSlashes(slashes);
26
- return {
27
- to: this.contract.address,
28
- abi: SlashFactoryAbi,
29
- data: encodeFunctionData({
30
- abi: SlashFactoryAbi,
31
- functionName: 'createSlashPayload',
32
- args: [
33
- sorted.map((d)=>d.validator.toString()),
34
- sorted.map((d)=>d.amount),
35
- sorted.map((d)=>d.offenses.map(packValidatorSlashOffense))
36
- ]
37
- })
38
- };
39
- }
40
- /** Tries to extract a SlashPayloadCreated event from the given logs. */ tryExtractSlashPayloadCreatedEvent(logs) {
41
- return tryExtractEvent(logs, this.address.toString(), SlashFactoryAbi, 'SlashPayloadCreated');
42
- }
43
- async getSlashPayloadCreatedEvents() {
44
- const events = await this.contract.getEvents.SlashPayloadCreated();
45
- return Promise.all(events.map(async (event)=>{
46
- const { validators, amounts, offenses } = event.args;
47
- const slashes = validators.map((validator, i)=>({
48
- validator: EthAddress.fromString(validator),
49
- amount: amounts[i],
50
- offenses: offenses[i].map(unpackValidatorSlashOffense)
51
- }));
52
- const block = await this.client.getBlock({
53
- blockNumber: event.blockNumber,
54
- includeTransactions: false
55
- });
56
- return {
57
- address: EthAddress.fromString(event.args.payloadAddress),
58
- slashes,
59
- timestamp: block.timestamp
60
- };
61
- }));
62
- }
63
- /**
64
- * Searches for a slash payload in the events emitted by the contract.
65
- * This method cannot query for historical payload events, it queries for payloads that have not yet expired.
66
- * @param payloadAddress The address of the payload to search for.
67
- * @param constants The L1 rollup constants needed for time calculations.
68
- */ async getSlashPayloadFromEvents(payloadAddress, settings) {
69
- // We query for the log where the payload was emitted walking backwards until we go past payload expiration time
70
- // Note that all log queries require a block range, and RPC providers cap the max range (eg quicknode is 10k blocks).
71
- const { slashingRoundSize, slashingPayloadLifetimeInRounds, slotDuration, ethereumSlotDuration } = settings;
72
- const currentBlockNumber = await this.client.getBlockNumber({
73
- cacheTime: 0
74
- });
75
- // Why the +1 below? Just for good measure. Better err on the safe side.
76
- const earliestBlockNumber = maxBigint(0n, currentBlockNumber - (BigInt(slashingPayloadLifetimeInRounds) + 1n) * BigInt(slashingRoundSize) * BigInt(slotDuration) / BigInt(ethereumSlotDuration));
77
- this.logger.trace(`Starting search for slash payload ${payloadAddress} from block ${currentBlockNumber} with earliest block ${earliestBlockNumber}`);
78
- const batchSize = BigInt(settings.logsBatchSize ?? 10000);
79
- let toBlock = currentBlockNumber;
80
- do {
81
- const fromBlock = maxBigint(earliestBlockNumber, toBlock - batchSize);
82
- this.logger.trace(`Searching for slash payload ${payloadAddress} in blocks ${fromBlock} to ${toBlock}`);
83
- const logs = await this.contract.getEvents.SlashPayloadCreated({
84
- payloadAddress: payloadAddress.toString()
85
- }, {
86
- fromBlock,
87
- toBlock,
88
- strict: true
89
- });
90
- // We found the payload, return it
91
- if (logs.length > 0) {
92
- const log = logs[0];
93
- const { validators, amounts, offenses } = log.args;
94
- // Convert the data to our internal types
95
- const slashes = validators.map((validator, i)=>({
96
- validator: EthAddress.fromString(validator),
97
- amount: amounts[i],
98
- offenses: offenses[i].map(unpackValidatorSlashOffense)
99
- }));
100
- // Get the timestamp from the block
101
- const block = await this.client.getBlock({
102
- blockNumber: log.blockNumber,
103
- includeTransactions: false
104
- });
105
- return {
106
- address: payloadAddress,
107
- slashes,
108
- timestamp: block.timestamp
109
- };
110
- }
111
- // If not found, we go back one batch
112
- toBlock -= batchSize;
113
- }while (toBlock > earliestBlockNumber)
114
- return undefined;
115
- }
116
- async getAddressAndIsDeployed(slashes) {
117
- const sortedSlashes = this.sortSlashes(slashes);
118
- const [address, salt, isDeployed] = await this.contract.read.getAddressAndIsDeployed([
119
- sortedSlashes.map((s)=>s.validator.toString()),
120
- sortedSlashes.map((s)=>s.amount),
121
- sortedSlashes.map((s)=>s.offenses.map(packValidatorSlashOffense))
122
- ]);
123
- return {
124
- address: EthAddress.fromString(address),
125
- salt,
126
- isDeployed
127
- };
128
- }
129
- sortSlashes(slashes) {
130
- const offenseSorter = (a, b)=>{
131
- return a.epochOrSlot === b.epochOrSlot ? a.offenseType - b.offenseType : Number(a.epochOrSlot - b.epochOrSlot);
132
- };
133
- return [
134
- ...slashes
135
- ].map((slash)=>({
136
- ...slash,
137
- offenses: [
138
- ...slash.offenses
139
- ].sort(offenseSorter)
140
- })).sort((a, b)=>a.validator.toString().localeCompare(b.validator.toString()));
141
- }
142
- }
143
- export function packValidatorSlashOffense(offense) {
144
- const offenseId = OffenseToBigInt[offense.offenseType];
145
- if (offenseId > (1 << 8) - 1) {
146
- throw new Error(`Offense type ${offense.offenseType} cannot be packed into 8 bits`);
147
- }
148
- return (offenseId << 120n) + offense.epochOrSlot;
149
- }
150
- export function unpackValidatorSlashOffense(packed) {
151
- const offenseId = packed >> 120n & 0xffn;
152
- const epochOrSlot = packed & (1n << 120n) - 1n;
153
- const offenseType = bigIntToOffense(offenseId);
154
- return {
155
- epochOrSlot,
156
- offenseType
157
- };
158
- }
@@ -1,31 +0,0 @@
1
- import type { Offense, OffenseIdentifier, SlashPayload, SlashPayloadRound, ValidatorSlash } from './types.js';
2
- import { OffenseType } from './types.js';
3
- /**
4
- * Returns true if the offense is uncontroversial as in it can be verified via L1 data alone,
5
- * and does not depend on the local view of the node of the L2 p2p network.
6
- * @param offense - The offense type to check
7
- */
8
- export declare function isOffenseUncontroversial(offense: OffenseType): boolean;
9
- /** Extracts offense identifiers (validator, epoch, offense type) from an Empire-based SlashPayload */
10
- export declare function getOffenseIdentifiersFromPayload(payload: SlashPayload | SlashPayloadRound): OffenseIdentifier[];
11
- /** Creates ValidatorSlashes used to create an Empire-based SlashPayload from a set of Offenses */
12
- export declare function offensesToValidatorSlash(offenses: Offense[]): ValidatorSlash[];
13
- /**
14
- * Sorts offense data by:
15
- * - Uncontroversial offenses first
16
- * - Slash amount (descending)
17
- * - Epoch or slot (ascending, ie oldest first)
18
- * - Validator address (ascending)
19
- * - Offense type (descending)
20
- */
21
- export declare function offenseDataComparator(a: Offense, b: Offense): number;
22
- /**
23
- * Returns the first round in which the offense is eligible for being included in an Empire-based slash payload.
24
- * Should be equal to to the first round that starts strictly after the offense becomes detectable.
25
- */
26
- export declare function getFirstEligibleRoundForOffense(offense: OffenseIdentifier, constants: {
27
- slashingRoundSize: number;
28
- epochDuration: number;
29
- proofSubmissionEpochs: number;
30
- }): bigint;
31
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW1waXJlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc2xhc2hpbmcvZW1waXJlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUdBLE9BQU8sS0FBSyxFQUFFLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxZQUFZLEVBQUUsaUJBQWlCLEVBQUUsY0FBYyxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBQzlHLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFFekM7Ozs7R0FJRztBQUNILHdCQUFnQix3QkFBd0IsQ0FBQyxPQUFPLEVBQUUsV0FBVyxHQUFHLE9BQU8sQ0FNdEU7QUFFRCxzR0FBc0c7QUFDdEcsd0JBQWdCLGdDQUFnQyxDQUFDLE9BQU8sRUFBRSxZQUFZLEdBQUcsaUJBQWlCLEdBQUcsaUJBQWlCLEVBQUUsQ0FRL0c7QUFFRCxrR0FBa0c7QUFDbEcsd0JBQWdCLHdCQUF3QixDQUFDLFFBQVEsRUFBRSxPQUFPLEVBQUUsR0FBRyxjQUFjLEVBQUUsQ0FNOUU7QUFFRDs7Ozs7OztHQU9HO0FBQ0gsd0JBQWdCLHFCQUFxQixDQUFDLENBQUMsRUFBRSxPQUFPLEVBQUUsQ0FBQyxFQUFFLE9BQU8sR0FBRyxNQUFNLENBUXBFO0FBRUQ7OztHQUdHO0FBQ0gsd0JBQWdCLCtCQUErQixDQUM3QyxPQUFPLEVBQUUsaUJBQWlCLEVBQzFCLFNBQVMsRUFBRTtJQUFFLGlCQUFpQixFQUFFLE1BQU0sQ0FBQztJQUFDLGFBQWEsRUFBRSxNQUFNLENBQUM7SUFBQyxxQkFBcUIsRUFBRSxNQUFNLENBQUE7Q0FBRSxHQUM3RixNQUFNLENBdUNSIn0=
@@ -1 +0,0 @@
1
- {"version":3,"file":"empire.d.ts","sourceRoot":"","sources":["../../src/slashing/empire.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC9G,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAMtE;AAED,sGAAsG;AACtG,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,YAAY,GAAG,iBAAiB,GAAG,iBAAiB,EAAE,CAQ/G;AAED,kGAAkG;AAClG,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAM9E;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,CAQpE;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,iBAAiB,EAC1B,SAAS,EAAE;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,qBAAqB,EAAE,MAAM,CAAA;CAAE,GAC7F,MAAM,CAuCR"}
@@ -1,87 +0,0 @@
1
- import { EpochNumber, SlotNumber } from '@aztec/foundation/branded-types';
2
- import { getRoundForSlot, getRoundsForEpoch } from './helpers.js';
3
- import { OffenseType } from './types.js';
4
- /**
5
- * Returns true if the offense is uncontroversial as in it can be verified via L1 data alone,
6
- * and does not depend on the local view of the node of the L2 p2p network.
7
- * @param offense - The offense type to check
8
- */ export function isOffenseUncontroversial(offense) {
9
- return offense === OffenseType.PROPOSED_INSUFFICIENT_ATTESTATIONS || offense === OffenseType.PROPOSED_INCORRECT_ATTESTATIONS || offense === OffenseType.ATTESTED_DESCENDANT_OF_INVALID;
10
- }
11
- /** Extracts offense identifiers (validator, epoch, offense type) from an Empire-based SlashPayload */ export function getOffenseIdentifiersFromPayload(payload) {
12
- return payload.slashes.flatMap((slash)=>slash.offenses.map((o)=>({
13
- validator: slash.validator,
14
- offenseType: o.offenseType,
15
- epochOrSlot: o.epochOrSlot
16
- })));
17
- }
18
- /** Creates ValidatorSlashes used to create an Empire-based SlashPayload from a set of Offenses */ export function offensesToValidatorSlash(offenses) {
19
- return offenses.map((offense)=>({
20
- validator: offense.validator,
21
- amount: offense.amount,
22
- offenses: [
23
- {
24
- epochOrSlot: offense.epochOrSlot,
25
- offenseType: offense.offenseType
26
- }
27
- ]
28
- }));
29
- }
30
- /**
31
- * Sorts offense data by:
32
- * - Uncontroversial offenses first
33
- * - Slash amount (descending)
34
- * - Epoch or slot (ascending, ie oldest first)
35
- * - Validator address (ascending)
36
- * - Offense type (descending)
37
- */ export function offenseDataComparator(a, b) {
38
- return Number(isOffenseUncontroversial(b.offenseType)) - Number(isOffenseUncontroversial(a.offenseType)) || Number(b.amount - a.amount) || Number(a.epochOrSlot - b.epochOrSlot) || a.validator.toString().localeCompare(b.validator.toString()) || Number(b.offenseType) - Number(a.offenseType);
39
- }
40
- /**
41
- * Returns the first round in which the offense is eligible for being included in an Empire-based slash payload.
42
- * Should be equal to to the first round that starts strictly after the offense becomes detectable.
43
- */ export function getFirstEligibleRoundForOffense(offense, constants) {
44
- // TODO(palla/slash): Check for off-by-ones
45
- switch(offense.offenseType){
46
- // Inactivity is detected at the end of the epoch, so we flag it as detected in the first fresh round for the next epoch
47
- case OffenseType.INACTIVITY:
48
- {
49
- const epoch = offense.epochOrSlot;
50
- const detectedEpoch = EpochNumber.fromBigInt(epoch + 1n);
51
- return getRoundsForEpoch(detectedEpoch, constants)[0] + 1n;
52
- }
53
- // These offenses are detected once an epoch is pruned, which happens after the proof submission window
54
- case OffenseType.VALID_EPOCH_PRUNED:
55
- case OffenseType.DATA_WITHHOLDING:
56
- {
57
- // TODO(palla/slash): Check for off-by-ones especially here
58
- const epoch = offense.epochOrSlot;
59
- const detectedEpoch = EpochNumber.fromBigInt(epoch + BigInt(constants.proofSubmissionEpochs));
60
- return getRoundsForEpoch(detectedEpoch, constants)[0] + 1n;
61
- }
62
- // These offenses are detected immediately in the slot they occur, so we assume they are detected in the first round for the following slot
63
- case OffenseType.PROPOSED_INSUFFICIENT_ATTESTATIONS:
64
- case OffenseType.PROPOSED_INCORRECT_ATTESTATIONS:
65
- case OffenseType.ATTESTED_DESCENDANT_OF_INVALID:
66
- case OffenseType.BROADCASTED_INVALID_BLOCK_PROPOSAL:
67
- case OffenseType.DUPLICATE_PROPOSAL:
68
- case OffenseType.DUPLICATE_ATTESTATION:
69
- {
70
- const slot = offense.epochOrSlot;
71
- const detectedSlot = SlotNumber.fromBigInt(slot + 1n);
72
- return getRoundForSlot(detectedSlot, constants).round + 1n;
73
- }
74
- // Assume these are epoch-based offenses, even though we should never have to process these
75
- case OffenseType.UNKNOWN:
76
- {
77
- const epoch = offense.epochOrSlot;
78
- const detectedEpoch = EpochNumber.fromBigInt(epoch + 1n);
79
- return getRoundsForEpoch(detectedEpoch, constants)[0] + 1n;
80
- }
81
- default:
82
- {
83
- const _ = offense.offenseType;
84
- throw new Error(`Unknown offense type: ${offense.offenseType}`);
85
- }
86
- }
87
- }
@@ -1,180 +0,0 @@
1
- import type { L1TxRequest } from '@aztec/ethereum/l1-tx-utils';
2
- import type { ViemClient } from '@aztec/ethereum/types';
3
- import { tryExtractEvent } from '@aztec/ethereum/utils';
4
- import { maxBigint } from '@aztec/foundation/bigint';
5
- import { EthAddress } from '@aztec/foundation/eth-address';
6
- import { createLogger } from '@aztec/foundation/log';
7
- import { SlashFactoryAbi } from '@aztec/l1-artifacts/SlashFactoryAbi';
8
-
9
- import { type GetContractReturnType, type Hex, type Log, encodeFunctionData, getContract } from 'viem';
10
-
11
- import type { L1RollupConstants } from '../epoch-helpers/index.js';
12
- import {
13
- OffenseToBigInt,
14
- type SlashPayload,
15
- type ValidatorSlash,
16
- type ValidatorSlashOffense,
17
- bigIntToOffense,
18
- } from '../slashing/index.js';
19
-
20
- export class SlashFactoryContract {
21
- private readonly logger = createLogger('contracts:slash_factory');
22
- private readonly contract: GetContractReturnType<typeof SlashFactoryAbi, ViemClient>;
23
-
24
- constructor(
25
- public readonly client: ViemClient,
26
- address: Hex | EthAddress,
27
- ) {
28
- this.contract = getContract({
29
- address: typeof address === 'string' ? address : address.toString(),
30
- abi: SlashFactoryAbi,
31
- client,
32
- });
33
- }
34
-
35
- public get address() {
36
- return EthAddress.fromString(this.contract.address);
37
- }
38
-
39
- public buildCreatePayloadRequest(slashes: ValidatorSlash[]): L1TxRequest {
40
- const sorted = this.sortSlashes(slashes);
41
-
42
- return {
43
- to: this.contract.address,
44
- abi: SlashFactoryAbi,
45
- data: encodeFunctionData({
46
- abi: SlashFactoryAbi,
47
- functionName: 'createSlashPayload',
48
- args: [
49
- sorted.map(d => d.validator.toString()),
50
- sorted.map(d => d.amount),
51
- sorted.map(d => d.offenses.map(packValidatorSlashOffense)),
52
- ],
53
- }),
54
- };
55
- }
56
-
57
- /** Tries to extract a SlashPayloadCreated event from the given logs. */
58
- public tryExtractSlashPayloadCreatedEvent(logs: Log[]) {
59
- return tryExtractEvent(logs, this.address.toString(), SlashFactoryAbi, 'SlashPayloadCreated');
60
- }
61
-
62
- public async getSlashPayloadCreatedEvents(): Promise<SlashPayload[]> {
63
- const events = await this.contract.getEvents.SlashPayloadCreated();
64
- return Promise.all(
65
- events.map(async event => {
66
- const { validators, amounts, offenses } = event.args;
67
- const slashes: ValidatorSlash[] = validators!.map((validator, i) => ({
68
- validator: EthAddress.fromString(validator),
69
- amount: amounts![i],
70
- offenses: offenses![i].map(unpackValidatorSlashOffense),
71
- }));
72
-
73
- const block = await this.client.getBlock({ blockNumber: event.blockNumber, includeTransactions: false });
74
- return { address: EthAddress.fromString(event.args.payloadAddress!), slashes, timestamp: block.timestamp };
75
- }),
76
- );
77
- }
78
-
79
- /**
80
- * Searches for a slash payload in the events emitted by the contract.
81
- * This method cannot query for historical payload events, it queries for payloads that have not yet expired.
82
- * @param payloadAddress The address of the payload to search for.
83
- * @param constants The L1 rollup constants needed for time calculations.
84
- */
85
- public async getSlashPayloadFromEvents(
86
- payloadAddress: EthAddress,
87
- settings: {
88
- logsBatchSize?: number;
89
- slashingRoundSize: number;
90
- slashingPayloadLifetimeInRounds: number;
91
- } & Pick<L1RollupConstants, 'slotDuration' | 'ethereumSlotDuration'>,
92
- ): Promise<Omit<SlashPayload, 'votes'> | undefined> {
93
- // We query for the log where the payload was emitted walking backwards until we go past payload expiration time
94
- // Note that all log queries require a block range, and RPC providers cap the max range (eg quicknode is 10k blocks).
95
- const { slashingRoundSize, slashingPayloadLifetimeInRounds, slotDuration, ethereumSlotDuration } = settings;
96
- const currentBlockNumber = await this.client.getBlockNumber({ cacheTime: 0 });
97
-
98
- // Why the +1 below? Just for good measure. Better err on the safe side.
99
- const earliestBlockNumber = maxBigint(
100
- 0n,
101
- currentBlockNumber -
102
- ((BigInt(slashingPayloadLifetimeInRounds) + 1n) * BigInt(slashingRoundSize) * BigInt(slotDuration)) /
103
- BigInt(ethereumSlotDuration),
104
- );
105
-
106
- this.logger.trace(
107
- `Starting search for slash payload ${payloadAddress} from block ${currentBlockNumber} with earliest block ${earliestBlockNumber}`,
108
- );
109
- const batchSize = BigInt(settings.logsBatchSize ?? 10000);
110
- let toBlock = currentBlockNumber;
111
-
112
- do {
113
- const fromBlock = maxBigint(earliestBlockNumber, toBlock - batchSize);
114
- this.logger.trace(`Searching for slash payload ${payloadAddress} in blocks ${fromBlock} to ${toBlock}`);
115
- const logs = await this.contract.getEvents.SlashPayloadCreated(
116
- { payloadAddress: payloadAddress.toString() },
117
- { fromBlock, toBlock, strict: true },
118
- );
119
-
120
- // We found the payload, return it
121
- if (logs.length > 0) {
122
- const log = logs[0];
123
- const { validators, amounts, offenses } = log.args;
124
-
125
- // Convert the data to our internal types
126
- const slashes: ValidatorSlash[] = validators!.map((validator, i) => ({
127
- validator: EthAddress.fromString(validator),
128
- amount: amounts![i],
129
- offenses: offenses![i].map(unpackValidatorSlashOffense),
130
- }));
131
-
132
- // Get the timestamp from the block
133
- const block = await this.client.getBlock({ blockNumber: log.blockNumber, includeTransactions: false });
134
-
135
- return { address: payloadAddress, slashes, timestamp: block.timestamp };
136
- }
137
-
138
- // If not found, we go back one batch
139
- toBlock -= batchSize;
140
- } while (toBlock > earliestBlockNumber);
141
-
142
- return undefined;
143
- }
144
-
145
- public async getAddressAndIsDeployed(
146
- slashes: ValidatorSlash[],
147
- ): Promise<{ address: EthAddress; salt: Hex; isDeployed: boolean }> {
148
- const sortedSlashes = this.sortSlashes(slashes);
149
- const [address, salt, isDeployed] = await this.contract.read.getAddressAndIsDeployed([
150
- sortedSlashes.map(s => s.validator.toString()),
151
- sortedSlashes.map(s => s.amount),
152
- sortedSlashes.map(s => s.offenses.map(packValidatorSlashOffense)),
153
- ]);
154
- return { address: EthAddress.fromString(address), salt, isDeployed };
155
- }
156
-
157
- private sortSlashes(slashes: ValidatorSlash[]): ValidatorSlash[] {
158
- const offenseSorter = (a: ValidatorSlashOffense, b: ValidatorSlashOffense) => {
159
- return a.epochOrSlot === b.epochOrSlot ? a.offenseType - b.offenseType : Number(a.epochOrSlot - b.epochOrSlot);
160
- };
161
- return [...slashes]
162
- .map(slash => ({ ...slash, offenses: [...slash.offenses].sort(offenseSorter) }))
163
- .sort((a, b) => a.validator.toString().localeCompare(b.validator.toString()));
164
- }
165
- }
166
-
167
- export function packValidatorSlashOffense(offense: ValidatorSlashOffense): bigint {
168
- const offenseId = OffenseToBigInt[offense.offenseType];
169
- if (offenseId > (1 << 8) - 1) {
170
- throw new Error(`Offense type ${offense.offenseType} cannot be packed into 8 bits`);
171
- }
172
- return (offenseId << 120n) + offense.epochOrSlot;
173
- }
174
-
175
- export function unpackValidatorSlashOffense(packed: bigint): ValidatorSlashOffense {
176
- const offenseId = (packed >> 120n) & 0xffn;
177
- const epochOrSlot = packed & ((1n << 120n) - 1n);
178
- const offenseType = bigIntToOffense(offenseId);
179
- return { epochOrSlot, offenseType };
180
- }
@@ -1,104 +0,0 @@
1
- import { EpochNumber, SlotNumber } from '@aztec/foundation/branded-types';
2
-
3
- import { getRoundForSlot, getRoundsForEpoch } from './helpers.js';
4
- import type { Offense, OffenseIdentifier, SlashPayload, SlashPayloadRound, ValidatorSlash } from './types.js';
5
- import { OffenseType } from './types.js';
6
-
7
- /**
8
- * Returns true if the offense is uncontroversial as in it can be verified via L1 data alone,
9
- * and does not depend on the local view of the node of the L2 p2p network.
10
- * @param offense - The offense type to check
11
- */
12
- export function isOffenseUncontroversial(offense: OffenseType): boolean {
13
- return (
14
- offense === OffenseType.PROPOSED_INSUFFICIENT_ATTESTATIONS ||
15
- offense === OffenseType.PROPOSED_INCORRECT_ATTESTATIONS ||
16
- offense === OffenseType.ATTESTED_DESCENDANT_OF_INVALID
17
- );
18
- }
19
-
20
- /** Extracts offense identifiers (validator, epoch, offense type) from an Empire-based SlashPayload */
21
- export function getOffenseIdentifiersFromPayload(payload: SlashPayload | SlashPayloadRound): OffenseIdentifier[] {
22
- return payload.slashes.flatMap((slash: ValidatorSlash) =>
23
- slash.offenses.map(o => ({
24
- validator: slash.validator,
25
- offenseType: o.offenseType,
26
- epochOrSlot: o.epochOrSlot,
27
- })),
28
- );
29
- }
30
-
31
- /** Creates ValidatorSlashes used to create an Empire-based SlashPayload from a set of Offenses */
32
- export function offensesToValidatorSlash(offenses: Offense[]): ValidatorSlash[] {
33
- return offenses.map(offense => ({
34
- validator: offense.validator,
35
- amount: offense.amount,
36
- offenses: [{ epochOrSlot: offense.epochOrSlot, offenseType: offense.offenseType }],
37
- }));
38
- }
39
-
40
- /**
41
- * Sorts offense data by:
42
- * - Uncontroversial offenses first
43
- * - Slash amount (descending)
44
- * - Epoch or slot (ascending, ie oldest first)
45
- * - Validator address (ascending)
46
- * - Offense type (descending)
47
- */
48
- export function offenseDataComparator(a: Offense, b: Offense): number {
49
- return (
50
- Number(isOffenseUncontroversial(b.offenseType)) - Number(isOffenseUncontroversial(a.offenseType)) ||
51
- Number(b.amount - a.amount) ||
52
- Number(a.epochOrSlot - b.epochOrSlot) ||
53
- a.validator.toString().localeCompare(b.validator.toString()) ||
54
- Number(b.offenseType) - Number(a.offenseType)
55
- );
56
- }
57
-
58
- /**
59
- * Returns the first round in which the offense is eligible for being included in an Empire-based slash payload.
60
- * Should be equal to to the first round that starts strictly after the offense becomes detectable.
61
- */
62
- export function getFirstEligibleRoundForOffense(
63
- offense: OffenseIdentifier,
64
- constants: { slashingRoundSize: number; epochDuration: number; proofSubmissionEpochs: number },
65
- ): bigint {
66
- // TODO(palla/slash): Check for off-by-ones
67
- switch (offense.offenseType) {
68
- // Inactivity is detected at the end of the epoch, so we flag it as detected in the first fresh round for the next epoch
69
- case OffenseType.INACTIVITY: {
70
- const epoch = offense.epochOrSlot;
71
- const detectedEpoch = EpochNumber.fromBigInt(epoch + 1n);
72
- return getRoundsForEpoch(detectedEpoch, constants)[0] + 1n;
73
- }
74
- // These offenses are detected once an epoch is pruned, which happens after the proof submission window
75
- case OffenseType.VALID_EPOCH_PRUNED:
76
- case OffenseType.DATA_WITHHOLDING: {
77
- // TODO(palla/slash): Check for off-by-ones especially here
78
- const epoch = offense.epochOrSlot;
79
- const detectedEpoch = EpochNumber.fromBigInt(epoch + BigInt(constants.proofSubmissionEpochs));
80
- return getRoundsForEpoch(detectedEpoch, constants)[0] + 1n;
81
- }
82
- // These offenses are detected immediately in the slot they occur, so we assume they are detected in the first round for the following slot
83
- case OffenseType.PROPOSED_INSUFFICIENT_ATTESTATIONS:
84
- case OffenseType.PROPOSED_INCORRECT_ATTESTATIONS:
85
- case OffenseType.ATTESTED_DESCENDANT_OF_INVALID:
86
- case OffenseType.BROADCASTED_INVALID_BLOCK_PROPOSAL:
87
- case OffenseType.DUPLICATE_PROPOSAL:
88
- case OffenseType.DUPLICATE_ATTESTATION: {
89
- const slot = offense.epochOrSlot;
90
- const detectedSlot = SlotNumber.fromBigInt(slot + 1n);
91
- return getRoundForSlot(detectedSlot, constants).round + 1n;
92
- }
93
- // Assume these are epoch-based offenses, even though we should never have to process these
94
- case OffenseType.UNKNOWN: {
95
- const epoch = offense.epochOrSlot;
96
- const detectedEpoch = EpochNumber.fromBigInt(epoch + 1n);
97
- return getRoundsForEpoch(detectedEpoch, constants)[0] + 1n;
98
- }
99
- default: {
100
- const _: never = offense.offenseType;
101
- throw new Error(`Unknown offense type: ${offense.offenseType}`);
102
- }
103
- }
104
- }