@aztec/ethereum 0.0.1-commit.d3ec352c → 0.0.1-commit.f295ac2

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 (162) hide show
  1. package/dest/client.js +6 -2
  2. package/dest/config.d.ts +17 -68
  3. package/dest/config.d.ts.map +1 -1
  4. package/dest/config.js +46 -378
  5. package/dest/contracts/empire_base.d.ts +2 -1
  6. package/dest/contracts/empire_base.d.ts.map +1 -1
  7. package/dest/contracts/empire_slashing_proposer.d.ts +2 -1
  8. package/dest/contracts/empire_slashing_proposer.d.ts.map +1 -1
  9. package/dest/contracts/empire_slashing_proposer.js +9 -0
  10. package/dest/contracts/fee_asset_handler.d.ts +6 -5
  11. package/dest/contracts/fee_asset_handler.d.ts.map +1 -1
  12. package/dest/contracts/fee_asset_handler.js +9 -9
  13. package/dest/contracts/governance_proposer.d.ts +2 -1
  14. package/dest/contracts/governance_proposer.d.ts.map +1 -1
  15. package/dest/contracts/governance_proposer.js +391 -8
  16. package/dest/contracts/inbox.d.ts +24 -3
  17. package/dest/contracts/inbox.d.ts.map +1 -1
  18. package/dest/contracts/inbox.js +36 -1
  19. package/dest/contracts/index.d.ts +3 -1
  20. package/dest/contracts/index.d.ts.map +1 -1
  21. package/dest/contracts/index.js +2 -0
  22. package/dest/contracts/log.d.ts +13 -0
  23. package/dest/contracts/log.d.ts.map +1 -0
  24. package/dest/contracts/log.js +1 -0
  25. package/dest/contracts/outbox.d.ts +41 -0
  26. package/dest/contracts/outbox.d.ts.map +1 -0
  27. package/dest/contracts/outbox.js +86 -0
  28. package/dest/contracts/rollup.d.ts +162 -82
  29. package/dest/contracts/rollup.d.ts.map +1 -1
  30. package/dest/contracts/rollup.js +680 -127
  31. package/dest/contracts/tally_slashing_proposer.d.ts +3 -2
  32. package/dest/contracts/tally_slashing_proposer.d.ts.map +1 -1
  33. package/dest/contracts/tally_slashing_proposer.js +1 -1
  34. package/dest/deploy_aztec_l1_contracts.d.ts +258 -0
  35. package/dest/deploy_aztec_l1_contracts.d.ts.map +1 -0
  36. package/dest/deploy_aztec_l1_contracts.js +397 -0
  37. package/dest/deploy_l1_contract.d.ts +68 -0
  38. package/dest/deploy_l1_contract.d.ts.map +1 -0
  39. package/dest/deploy_l1_contract.js +312 -0
  40. package/dest/forwarder_proxy.d.ts +32 -0
  41. package/dest/forwarder_proxy.d.ts.map +1 -0
  42. package/dest/forwarder_proxy.js +93 -0
  43. package/dest/generated/l1-contracts-defaults.d.ts +29 -0
  44. package/dest/generated/l1-contracts-defaults.d.ts.map +1 -0
  45. package/dest/generated/l1-contracts-defaults.js +29 -0
  46. package/dest/l1_artifacts.d.ts +4158 -1563
  47. package/dest/l1_artifacts.d.ts.map +1 -1
  48. package/dest/l1_contract_addresses.d.ts +1 -1
  49. package/dest/l1_contract_addresses.d.ts.map +1 -1
  50. package/dest/l1_contract_addresses.js +3 -3
  51. package/dest/l1_reader.d.ts +3 -1
  52. package/dest/l1_reader.d.ts.map +1 -1
  53. package/dest/l1_reader.js +6 -0
  54. package/dest/l1_tx_utils/config.d.ts +3 -3
  55. package/dest/l1_tx_utils/config.d.ts.map +1 -1
  56. package/dest/l1_tx_utils/config.js +17 -3
  57. package/dest/l1_tx_utils/constants.d.ts +7 -1
  58. package/dest/l1_tx_utils/constants.d.ts.map +1 -1
  59. package/dest/l1_tx_utils/constants.js +25 -0
  60. package/dest/l1_tx_utils/fee-strategies/index.d.ts +10 -0
  61. package/dest/l1_tx_utils/fee-strategies/index.d.ts.map +1 -0
  62. package/dest/l1_tx_utils/fee-strategies/index.js +12 -0
  63. package/dest/l1_tx_utils/fee-strategies/p75_competitive.d.ts +8 -0
  64. package/dest/l1_tx_utils/fee-strategies/p75_competitive.d.ts.map +1 -0
  65. package/dest/l1_tx_utils/fee-strategies/p75_competitive.js +129 -0
  66. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.d.ts +23 -0
  67. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.d.ts.map +1 -0
  68. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.js +191 -0
  69. package/dest/l1_tx_utils/fee-strategies/types.d.ts +51 -0
  70. package/dest/l1_tx_utils/fee-strategies/types.d.ts.map +1 -0
  71. package/dest/l1_tx_utils/fee-strategies/types.js +3 -0
  72. package/dest/l1_tx_utils/forwarder_l1_tx_utils.d.ts +41 -0
  73. package/dest/l1_tx_utils/forwarder_l1_tx_utils.d.ts.map +1 -0
  74. package/dest/l1_tx_utils/forwarder_l1_tx_utils.js +48 -0
  75. package/dest/l1_tx_utils/index-blobs.d.ts +3 -0
  76. package/dest/l1_tx_utils/index-blobs.d.ts.map +1 -0
  77. package/dest/l1_tx_utils/index-blobs.js +2 -0
  78. package/dest/l1_tx_utils/index.d.ts +3 -1
  79. package/dest/l1_tx_utils/index.d.ts.map +1 -1
  80. package/dest/l1_tx_utils/index.js +2 -0
  81. package/dest/l1_tx_utils/interfaces.d.ts +2 -2
  82. package/dest/l1_tx_utils/interfaces.d.ts.map +1 -1
  83. package/dest/l1_tx_utils/l1_fee_analyzer.d.ts +233 -0
  84. package/dest/l1_tx_utils/l1_fee_analyzer.d.ts.map +1 -0
  85. package/dest/l1_tx_utils/l1_fee_analyzer.js +506 -0
  86. package/dest/l1_tx_utils/l1_tx_utils.d.ts +1 -1
  87. package/dest/l1_tx_utils/l1_tx_utils.d.ts.map +1 -1
  88. package/dest/l1_tx_utils/l1_tx_utils.js +17 -4
  89. package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts +4 -15
  90. package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts.map +1 -1
  91. package/dest/l1_tx_utils/readonly_l1_tx_utils.js +52 -159
  92. package/dest/queries.d.ts +2 -2
  93. package/dest/queries.d.ts.map +1 -1
  94. package/dest/queries.js +10 -3
  95. package/dest/test/chain_monitor.d.ts +2 -2
  96. package/dest/test/chain_monitor.d.ts.map +1 -1
  97. package/dest/test/chain_monitor.js +1 -2
  98. package/dest/test/eth_cheat_codes.d.ts +13 -1
  99. package/dest/test/eth_cheat_codes.d.ts.map +1 -1
  100. package/dest/test/eth_cheat_codes.js +4 -2
  101. package/dest/test/rollup_cheat_codes.d.ts +3 -2
  102. package/dest/test/rollup_cheat_codes.d.ts.map +1 -1
  103. package/dest/test/rollup_cheat_codes.js +16 -3
  104. package/dest/test/start_anvil.d.ts +3 -1
  105. package/dest/test/start_anvil.d.ts.map +1 -1
  106. package/dest/test/tx_delayer.d.ts +1 -1
  107. package/dest/test/tx_delayer.d.ts.map +1 -1
  108. package/dest/test/tx_delayer.js +4 -3
  109. package/dest/types.d.ts +57 -2
  110. package/dest/types.d.ts.map +1 -1
  111. package/dest/utils.d.ts +15 -3
  112. package/dest/utils.d.ts.map +1 -1
  113. package/dest/utils.js +18 -0
  114. package/package.json +31 -12
  115. package/src/client.ts +2 -2
  116. package/src/config.ts +55 -457
  117. package/src/contracts/README.md +157 -0
  118. package/src/contracts/empire_base.ts +1 -1
  119. package/src/contracts/empire_slashing_proposer.ts +6 -1
  120. package/src/contracts/fee_asset_handler.ts +8 -7
  121. package/src/contracts/governance_proposer.ts +6 -1
  122. package/src/contracts/inbox.ts +55 -3
  123. package/src/contracts/index.ts +2 -0
  124. package/src/contracts/log.ts +13 -0
  125. package/src/contracts/outbox.ts +98 -0
  126. package/src/contracts/rollup.ts +350 -94
  127. package/src/contracts/tally_slashing_proposer.ts +3 -1
  128. package/src/deploy_aztec_l1_contracts.ts +618 -0
  129. package/src/deploy_l1_contract.ts +362 -0
  130. package/src/forwarder_proxy.ts +108 -0
  131. package/src/generated/l1-contracts-defaults.ts +31 -0
  132. package/src/l1_contract_addresses.ts +22 -20
  133. package/src/l1_reader.ts +8 -0
  134. package/src/l1_tx_utils/config.ts +24 -6
  135. package/src/l1_tx_utils/constants.ts +11 -0
  136. package/src/l1_tx_utils/fee-strategies/index.ts +22 -0
  137. package/src/l1_tx_utils/fee-strategies/p75_competitive.ts +163 -0
  138. package/src/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.ts +245 -0
  139. package/src/l1_tx_utils/fee-strategies/types.ts +56 -0
  140. package/src/l1_tx_utils/forwarder_l1_tx_utils.ts +119 -0
  141. package/src/l1_tx_utils/index-blobs.ts +2 -0
  142. package/src/l1_tx_utils/index.ts +2 -0
  143. package/src/l1_tx_utils/interfaces.ts +1 -1
  144. package/src/l1_tx_utils/l1_fee_analyzer.ts +803 -0
  145. package/src/l1_tx_utils/l1_tx_utils.ts +24 -4
  146. package/src/l1_tx_utils/readonly_l1_tx_utils.ts +65 -204
  147. package/src/queries.ts +10 -3
  148. package/src/test/chain_monitor.ts +3 -2
  149. package/src/test/eth_cheat_codes.ts +2 -2
  150. package/src/test/rollup_cheat_codes.ts +13 -3
  151. package/src/test/start_anvil.ts +2 -0
  152. package/src/test/tx_delayer.ts +5 -3
  153. package/src/types.ts +62 -0
  154. package/src/utils.ts +30 -1
  155. package/dest/deploy_l1_contracts.d.ts +0 -673
  156. package/dest/deploy_l1_contracts.d.ts.map +0 -1
  157. package/dest/deploy_l1_contracts.js +0 -1491
  158. package/dest/index.d.ts +0 -18
  159. package/dest/index.d.ts.map +0 -1
  160. package/dest/index.js +0 -17
  161. package/src/deploy_l1_contracts.ts +0 -1869
  162. package/src/index.ts +0 -17
package/src/config.ts CHANGED
@@ -1,16 +1,17 @@
1
1
  import {
2
2
  type ConfigMappingsType,
3
- type NetworkNames,
4
3
  bigintConfigHelper,
5
4
  booleanConfigHelper,
6
5
  enumConfigHelper,
7
6
  getConfigFromMappings,
7
+ getDefaultConfig,
8
8
  numberConfigHelper,
9
9
  optionalNumberConfigHelper,
10
10
  } from '@aztec/foundation/config';
11
11
  import { EthAddress } from '@aztec/foundation/eth-address';
12
12
 
13
- import { type L1TxUtilsConfig, l1TxUtilsConfigMappings } from './l1_tx_utils/index.js';
13
+ import { l1ContractsDefaultEnv } from './generated/l1-contracts-defaults.js';
14
+ import { type L1TxUtilsConfig, l1TxUtilsConfigMappings } from './l1_tx_utils/config.js';
14
15
 
15
16
  export type GenesisStateConfig = {
16
17
  /** Whether to populate the genesis state with initial fee juice for the test accounts */
@@ -32,6 +33,8 @@ export type L1ContractsConfig = {
32
33
  lagInEpochsForValidatorSet: number;
33
34
  /** The number of epochs to lag behind the current epoch for randao selection. */
34
35
  lagInEpochsForRandao: number;
36
+ /** The number of checkpoints to lag in the inbox (prevents sequencer DOS attacks). */
37
+ inboxLag: number;
35
38
  /** The number of epochs after an epoch ends that proofs are still accepted. */
36
39
  aztecProofSubmissionEpochs: number;
37
40
  /** The deposit amount for a validator */
@@ -66,6 +69,8 @@ export type L1ContractsConfig = {
66
69
  governanceProposerQuorum?: number;
67
70
  /** Governance proposing round size */
68
71
  governanceProposerRoundSize: number;
72
+ /** Governance voting duration in seconds (only for local/devnet/next-net, default 3600) */
73
+ governanceVotingDuration?: number;
69
74
  /** The mana target for the rollup */
70
75
  manaTarget: bigint;
71
76
  /** The proving cost per mana */
@@ -74,312 +79,96 @@ export type L1ContractsConfig = {
74
79
  exitDelaySeconds: number;
75
80
  } & L1TxUtilsConfig;
76
81
 
77
- export const DefaultL1ContractsConfig = {
78
- ethereumSlotDuration: 12,
79
- aztecSlotDuration: 36,
80
- aztecEpochDuration: 32,
81
- aztecTargetCommitteeSize: 48,
82
- lagInEpochsForValidatorSet: 2,
83
- lagInEpochsForRandao: 2, // For PROD, this value should be > lagInEpochsForValidatorSet
84
- aztecProofSubmissionEpochs: 1, // you have a full epoch to submit a proof after the epoch to prove ends
85
- activationThreshold: 100n * 10n ** 18n,
86
- ejectionThreshold: 50n * 10n ** 18n,
87
- localEjectionThreshold: 98n * 10n ** 18n,
88
- slashAmountSmall: 10n * 10n ** 18n,
89
- slashAmountMedium: 20n * 10n ** 18n,
90
- slashAmountLarge: 50n * 10n ** 18n,
91
- slashingRoundSizeInEpochs: 4,
92
- slashingLifetimeInRounds: 5,
93
- slashingExecutionDelayInRounds: 0, // round N may be submitted in round N + 1
94
- slashingVetoer: EthAddress.ZERO,
95
- governanceProposerRoundSize: 300,
96
- manaTarget: BigInt(100e6),
97
- provingCostPerMana: BigInt(100),
98
- exitDelaySeconds: 2 * 24 * 60 * 60,
99
- slasherFlavor: 'tally' as const,
100
- slashingOffsetInRounds: 2,
101
- slashingDisableDuration: 5 * 24 * 60 * 60, // 5 days in seconds
102
- } satisfies L1ContractsConfig;
103
-
104
- const LocalGovernanceConfiguration = {
105
- proposeConfig: {
106
- lockDelay: 60n * 60n * 24n * 30n,
107
- lockAmount: 1n * 10n ** 24n,
108
- },
109
- votingDelay: 60n,
110
- votingDuration: 60n * 60n,
111
- executionDelay: 60n,
112
- gracePeriod: 60n * 60n * 24n * 7n,
113
- quorum: 1n * 10n ** 17n, // 10%
114
- requiredYeaMargin: 4n * 10n ** 16n, // 4%
115
- minimumVotes: 400n * 10n ** 18n,
116
- };
117
-
118
- const StagingPublicGovernanceConfiguration = {
119
- proposeConfig: {
120
- lockDelay: 60n * 60n * 24n * 30n,
121
- lockAmount: DefaultL1ContractsConfig.activationThreshold * 100n,
122
- },
123
- votingDelay: 60n,
124
- votingDuration: 60n * 60n,
125
- executionDelay: 60n,
126
- gracePeriod: 60n * 60n * 24n * 7n,
127
- quorum: 3n * 10n ** 17n, // 30%
128
- requiredYeaMargin: 4n * 10n ** 16n, // 4%
129
- minimumVotes: DefaultL1ContractsConfig.ejectionThreshold * 200n, // >= 200 validators must vote
130
- };
131
-
132
- const TestnetGovernanceConfiguration = {
133
- proposeConfig: {
134
- lockDelay: 10n * 365n * 24n * 60n * 60n,
135
- lockAmount: 1250n * 200_000n * 10n ** 18n,
136
- },
137
-
138
- votingDelay: 12n * 60n * 60n, // 12 hours
139
- votingDuration: 1n * 24n * 60n * 60n, // 1 day
140
- executionDelay: 12n * 60n * 60n, // 12 hours
141
- gracePeriod: 1n * 24n * 60n * 60n, // 1 day
142
- quorum: 2n * 10n ** 17n, // 20%
143
- requiredYeaMargin: 1n * 10n ** 17n, // 10%
144
- minimumVotes: 100n * 200_000n * 10n ** 18n,
145
- };
146
-
147
- const StagingIgnitionGovernanceConfiguration = {
148
- proposeConfig: {
149
- lockDelay: 10n * 365n * 24n * 60n * 60n,
150
- lockAmount: 1250n * 200_000n * 10n ** 18n,
151
- },
152
-
153
- votingDelay: 7n * 24n * 60n * 60n,
154
- votingDuration: 7n * 24n * 60n * 60n,
155
- executionDelay: 30n * 24n * 60n * 60n,
156
- gracePeriod: 7n * 24n * 60n * 60n,
157
- quorum: 2n * 10n ** 17n, // 20%
158
- requiredYeaMargin: 1n * 10n ** 17n, // 10%
159
- minimumVotes: 1250n * 200_000n * 10n ** 18n,
160
- };
161
-
162
- const MainnetGovernanceConfiguration = {
163
- proposeConfig: {
164
- lockDelay: 90n * 24n * 60n * 60n,
165
- lockAmount: 258_750_000n * 10n ** 18n,
166
- },
167
-
168
- votingDelay: 3n * 24n * 60n * 60n,
169
- votingDuration: 7n * 24n * 60n * 60n,
170
- executionDelay: 7n * 24n * 60n * 60n,
171
- gracePeriod: 7n * 24n * 60n * 60n,
172
- quorum: 2n * 10n ** 17n, // 20%
173
- requiredYeaMargin: 33n * 10n ** 16n, // 33%
174
- minimumVotes: 1000n * 200_000n * 10n ** 18n,
175
- };
176
-
177
- export const getGovernanceConfiguration = (networkName: NetworkNames) => {
178
- switch (networkName) {
179
- case 'local':
180
- return LocalGovernanceConfiguration;
181
- case 'next-net':
182
- return LocalGovernanceConfiguration;
183
- case 'devnet':
184
- return LocalGovernanceConfiguration;
185
- case 'staging-public':
186
- return StagingPublicGovernanceConfiguration;
187
- case 'testnet':
188
- return TestnetGovernanceConfiguration;
189
- case 'staging-ignition':
190
- return StagingIgnitionGovernanceConfiguration;
191
- case 'mainnet':
192
- return MainnetGovernanceConfiguration;
193
- default:
194
- throw new Error(`Unrecognized network name: ${networkName}`);
195
- }
196
- };
197
-
198
- // Making a default config here as we are only using it thought the deployment
199
- // and do not expect to be using different setups, so having environment variables
200
- // for it seems overkill
201
-
202
- const DefaultRewardConfig = {
203
- sequencerBps: 8000,
204
- rewardDistributor: EthAddress.ZERO.toString(),
205
- booster: EthAddress.ZERO.toString(),
206
- checkpointReward: 500n * 10n ** 18n,
207
- };
208
-
209
- const MainnetRewardConfig = {
210
- sequencerBps: 7_000,
211
- rewardDistributor: EthAddress.ZERO.toString(),
212
- booster: EthAddress.ZERO.toString(),
213
- checkpointReward: 400n * 10n ** 18n,
214
- };
215
-
216
- export const getRewardConfig = (networkName: NetworkNames) => {
217
- switch (networkName) {
218
- case 'local':
219
- case 'devnet':
220
- case 'next-net':
221
- case 'staging-public':
222
- case 'testnet':
223
- case 'staging-ignition':
224
- return DefaultRewardConfig;
225
- case 'mainnet':
226
- return MainnetRewardConfig;
227
- default:
228
- throw new Error(`Unrecognized network name: ${networkName}`);
229
- }
230
- };
231
-
232
- export const getRewardBoostConfig = () => {
233
- // The reward configuration is specified with a precision of 1e5, and we use the same across
234
- // all networks.
235
- return {
236
- increment: 125_000, // 1.25
237
- maxScore: 15_000_000, // 150
238
- a: 1_000, // 0.01
239
- k: 1_000_000, // 10
240
- minimum: 100_000, // 1
241
- };
242
- };
243
-
244
- // Similar to the above, no need for environment variables for this.
245
- const LocalEntryQueueConfig = {
246
- bootstrapValidatorSetSize: 0n,
247
- bootstrapFlushSize: 0n,
248
- normalFlushSizeMin: 48n,
249
- normalFlushSizeQuotient: 2n,
250
- maxQueueFlushSize: 48n,
251
- };
252
-
253
- const StagingPublicEntryQueueConfig = {
254
- bootstrapValidatorSetSize: 48n,
255
- bootstrapFlushSize: 48n,
256
- normalFlushSizeMin: 1n,
257
- normalFlushSizeQuotient: 2475n,
258
- maxQueueFlushSize: 32n, // Limited to 32 so flush cost are kept below 15M gas.
259
- };
260
-
261
- const TestnetEntryQueueConfig = {
262
- bootstrapValidatorSetSize: 256n,
263
- bootstrapFlushSize: 256n,
264
- normalFlushSizeMin: 4n,
265
- normalFlushSizeQuotient: 2048n,
266
- maxQueueFlushSize: 8n,
267
- };
268
-
269
- const StagingIgnitionEntryQueueConfig = {
270
- bootstrapValidatorSetSize: 48n,
271
- bootstrapFlushSize: 48n,
272
- normalFlushSizeMin: 1n,
273
- normalFlushSizeQuotient: 2048n,
274
- maxQueueFlushSize: 24n,
275
- };
276
-
277
- const MainnetEntryQueueConfig = {
278
- bootstrapValidatorSetSize: 1_000n,
279
- bootstrapFlushSize: 1_000n,
280
- normalFlushSizeMin: 1n,
281
- normalFlushSizeQuotient: 2_048n,
282
- maxQueueFlushSize: 8n,
283
- };
284
-
285
- export const getEntryQueueConfig = (networkName: NetworkNames) => {
286
- switch (networkName) {
287
- case 'local':
288
- return LocalEntryQueueConfig;
289
- case 'next-net':
290
- return LocalEntryQueueConfig;
291
- case 'devnet':
292
- return LocalEntryQueueConfig;
293
- case 'staging-public':
294
- return StagingPublicEntryQueueConfig;
295
- case 'testnet':
296
- return TestnetEntryQueueConfig;
297
- case 'staging-ignition':
298
- return StagingIgnitionEntryQueueConfig;
299
- case 'mainnet':
300
- return MainnetEntryQueueConfig;
301
- default:
302
- throw new Error(`Unrecognized network name: ${networkName}`);
303
- }
304
- };
305
-
82
+ /**
83
+ * Config mappings for L1ContractsConfig.
84
+ * Default values come from generated l1-contracts-defaults.json (source: defaults.yml).
85
+ * Real deployments use forge scripts which require explicit env vars (vm.envUint).
86
+ */
306
87
  export const l1ContractsConfigMappings: ConfigMappingsType<L1ContractsConfig> = {
307
88
  ethereumSlotDuration: {
308
89
  env: 'ETHEREUM_SLOT_DURATION',
309
90
  description: 'How many seconds an L1 slot lasts.',
310
- ...numberConfigHelper(DefaultL1ContractsConfig.ethereumSlotDuration),
91
+ ...numberConfigHelper(l1ContractsDefaultEnv.ETHEREUM_SLOT_DURATION),
311
92
  },
312
93
  aztecSlotDuration: {
313
94
  env: 'AZTEC_SLOT_DURATION',
314
95
  description: 'How many seconds an L2 slots lasts (must be multiple of ethereum slot duration).',
315
- ...numberConfigHelper(DefaultL1ContractsConfig.aztecSlotDuration),
96
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLOT_DURATION),
316
97
  },
317
98
  aztecEpochDuration: {
318
99
  env: 'AZTEC_EPOCH_DURATION',
319
100
  description: `How many L2 slots an epoch lasts (maximum AZTEC_MAX_EPOCH_DURATION).`,
320
- ...numberConfigHelper(DefaultL1ContractsConfig.aztecEpochDuration),
101
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_EPOCH_DURATION),
321
102
  },
322
103
  aztecTargetCommitteeSize: {
323
104
  env: 'AZTEC_TARGET_COMMITTEE_SIZE',
324
105
  description: 'The target validator committee size.',
325
- ...numberConfigHelper(DefaultL1ContractsConfig.aztecTargetCommitteeSize),
106
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_TARGET_COMMITTEE_SIZE),
326
107
  },
327
108
  lagInEpochsForValidatorSet: {
328
109
  env: 'AZTEC_LAG_IN_EPOCHS_FOR_VALIDATOR_SET',
329
110
  description: 'The number of epochs to lag behind the current epoch for validator selection.',
330
- ...numberConfigHelper(DefaultL1ContractsConfig.lagInEpochsForValidatorSet),
111
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_LAG_IN_EPOCHS_FOR_VALIDATOR_SET),
331
112
  },
332
113
  lagInEpochsForRandao: {
333
114
  env: 'AZTEC_LAG_IN_EPOCHS_FOR_RANDAO',
334
115
  description: 'The number of epochs to lag behind the current epoch for randao selection.',
335
- ...numberConfigHelper(DefaultL1ContractsConfig.lagInEpochsForRandao),
116
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_LAG_IN_EPOCHS_FOR_RANDAO),
117
+ },
118
+ inboxLag: {
119
+ env: 'AZTEC_INBOX_LAG',
120
+ description: 'The number of checkpoints to lag in the inbox (prevents sequencer DOS attacks).',
121
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_INBOX_LAG),
336
122
  },
337
123
  aztecProofSubmissionEpochs: {
338
124
  env: 'AZTEC_PROOF_SUBMISSION_EPOCHS',
339
125
  description: 'The number of epochs after an epoch ends that proofs are still accepted.',
340
- ...numberConfigHelper(DefaultL1ContractsConfig.aztecProofSubmissionEpochs),
126
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_PROOF_SUBMISSION_EPOCHS),
341
127
  },
342
128
  activationThreshold: {
343
129
  env: 'AZTEC_ACTIVATION_THRESHOLD',
344
130
  description: 'The deposit amount for a validator',
345
- ...bigintConfigHelper(DefaultL1ContractsConfig.activationThreshold),
131
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_ACTIVATION_THRESHOLD)),
346
132
  },
347
133
  ejectionThreshold: {
348
134
  env: 'AZTEC_EJECTION_THRESHOLD',
349
135
  description: 'The minimum stake for a validator.',
350
- ...bigintConfigHelper(DefaultL1ContractsConfig.ejectionThreshold),
136
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_EJECTION_THRESHOLD)),
351
137
  },
352
138
  localEjectionThreshold: {
353
139
  env: 'AZTEC_LOCAL_EJECTION_THRESHOLD',
354
140
  description:
355
141
  'The local ejection threshold for a validator. Stricter than ejectionThreshold but local to a specific rollup',
356
- ...bigintConfigHelper(DefaultL1ContractsConfig.localEjectionThreshold),
142
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_LOCAL_EJECTION_THRESHOLD)),
357
143
  },
358
144
  slashingOffsetInRounds: {
359
145
  env: 'AZTEC_SLASHING_OFFSET_IN_ROUNDS',
360
146
  description:
361
147
  'How many slashing rounds back we slash (ie when slashing in round N, we slash for offenses committed during epochs of round N-offset)',
362
- ...numberConfigHelper(DefaultL1ContractsConfig.slashingOffsetInRounds),
148
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_OFFSET_IN_ROUNDS),
363
149
  },
364
150
  slasherFlavor: {
365
151
  env: 'AZTEC_SLASHER_FLAVOR',
366
152
  description: 'Type of slasher proposer (empire, tally, or none)',
367
- ...enumConfigHelper(['empire', 'tally', 'none'] as const, DefaultL1ContractsConfig.slasherFlavor),
153
+ ...enumConfigHelper(
154
+ ['empire', 'tally', 'none'] as const,
155
+ l1ContractsDefaultEnv.AZTEC_SLASHER_FLAVOR as 'empire' | 'tally' | 'none',
156
+ ),
368
157
  },
369
158
  slashAmountSmall: {
370
159
  env: 'AZTEC_SLASH_AMOUNT_SMALL',
371
160
  description: 'Small slashing amount for light offenses',
372
- ...bigintConfigHelper(DefaultL1ContractsConfig.slashAmountSmall),
161
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_SLASH_AMOUNT_SMALL)),
373
162
  },
374
163
  slashAmountMedium: {
375
164
  env: 'AZTEC_SLASH_AMOUNT_MEDIUM',
376
165
  description: 'Medium slashing amount for moderate offenses',
377
- ...bigintConfigHelper(DefaultL1ContractsConfig.slashAmountMedium),
166
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_SLASH_AMOUNT_MEDIUM)),
378
167
  },
379
168
  slashAmountLarge: {
380
169
  env: 'AZTEC_SLASH_AMOUNT_LARGE',
381
170
  description: 'Large slashing amount for severe offenses',
382
- ...bigintConfigHelper(DefaultL1ContractsConfig.slashAmountLarge),
171
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_SLASH_AMOUNT_LARGE)),
383
172
  },
384
173
  slashingQuorum: {
385
174
  env: 'AZTEC_SLASHING_QUORUM',
@@ -389,28 +178,28 @@ export const l1ContractsConfigMappings: ConfigMappingsType<L1ContractsConfig> =
389
178
  slashingRoundSizeInEpochs: {
390
179
  env: 'AZTEC_SLASHING_ROUND_SIZE_IN_EPOCHS',
391
180
  description: 'The slashing round size',
392
- ...numberConfigHelper(DefaultL1ContractsConfig.slashingRoundSizeInEpochs),
181
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_ROUND_SIZE_IN_EPOCHS),
393
182
  },
394
183
  slashingLifetimeInRounds: {
395
184
  env: 'AZTEC_SLASHING_LIFETIME_IN_ROUNDS',
396
185
  description: 'The slashing lifetime in rounds',
397
- ...numberConfigHelper(DefaultL1ContractsConfig.slashingLifetimeInRounds),
186
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_LIFETIME_IN_ROUNDS),
398
187
  },
399
188
  slashingExecutionDelayInRounds: {
400
189
  env: 'AZTEC_SLASHING_EXECUTION_DELAY_IN_ROUNDS',
401
190
  description: 'The slashing execution delay in rounds',
402
- ...numberConfigHelper(DefaultL1ContractsConfig.slashingExecutionDelayInRounds),
191
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_EXECUTION_DELAY_IN_ROUNDS),
403
192
  },
404
193
  slashingVetoer: {
405
194
  env: 'AZTEC_SLASHING_VETOER',
406
195
  description: 'The slashing vetoer',
407
196
  parseEnv: (val: string) => EthAddress.fromString(val),
408
- defaultValue: DefaultL1ContractsConfig.slashingVetoer,
197
+ defaultValue: EthAddress.fromString(l1ContractsDefaultEnv.AZTEC_SLASHING_VETOER),
409
198
  },
410
199
  slashingDisableDuration: {
411
200
  env: 'AZTEC_SLASHING_DISABLE_DURATION',
412
201
  description: 'How long slashing can be disabled for in seconds when vetoer disables it',
413
- ...numberConfigHelper(DefaultL1ContractsConfig.slashingDisableDuration),
202
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_DISABLE_DURATION),
414
203
  },
415
204
  governanceProposerQuorum: {
416
205
  env: 'AZTEC_GOVERNANCE_PROPOSER_QUORUM',
@@ -420,26 +209,37 @@ export const l1ContractsConfigMappings: ConfigMappingsType<L1ContractsConfig> =
420
209
  governanceProposerRoundSize: {
421
210
  env: 'AZTEC_GOVERNANCE_PROPOSER_ROUND_SIZE',
422
211
  description: 'The governance proposing round size',
423
- ...numberConfigHelper(DefaultL1ContractsConfig.governanceProposerRoundSize),
212
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_GOVERNANCE_PROPOSER_ROUND_SIZE),
213
+ },
214
+ governanceVotingDuration: {
215
+ env: 'AZTEC_GOVERNANCE_VOTING_DURATION',
216
+ description: 'Governance voting duration in seconds (only for local/devnet/next-net)',
217
+ ...numberConfigHelper(3600), // 1 hour default, not in generated defaults as it's deployment-time only
424
218
  },
425
219
  manaTarget: {
426
220
  env: 'AZTEC_MANA_TARGET',
427
221
  description: 'The mana target for the rollup',
428
- ...bigintConfigHelper(DefaultL1ContractsConfig.manaTarget),
222
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_MANA_TARGET)),
429
223
  },
430
224
  provingCostPerMana: {
431
225
  env: 'AZTEC_PROVING_COST_PER_MANA',
432
226
  description: 'The proving cost per mana',
433
- ...bigintConfigHelper(DefaultL1ContractsConfig.provingCostPerMana),
227
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_PROVING_COST_PER_MANA)),
434
228
  },
435
229
  exitDelaySeconds: {
436
230
  env: 'AZTEC_EXIT_DELAY_SECONDS',
437
231
  description: 'The delay before a validator can exit the set',
438
- ...numberConfigHelper(DefaultL1ContractsConfig.exitDelaySeconds),
232
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_EXIT_DELAY_SECONDS),
439
233
  },
440
234
  ...l1TxUtilsConfigMappings,
441
235
  };
442
236
 
237
+ /**
238
+ * Default L1 contracts configuration derived from l1ContractsConfigMappings.
239
+ * Source of truth: spartan/environments/defaults.yml -> defaults.l1-contracts
240
+ */
241
+ export const DefaultL1ContractsConfig = getDefaultConfig(l1ContractsConfigMappings);
242
+
443
243
  export const genesisStateConfigMappings: ConfigMappingsType<GenesisStateConfig> = {
444
244
  testAccounts: {
445
245
  env: 'TEST_ACCOUNTS',
@@ -460,205 +260,3 @@ export function getL1ContractsConfigEnvVars(): L1ContractsConfig {
460
260
  export function getGenesisStateConfigEnvVars(): GenesisStateConfig {
461
261
  return getConfigFromMappings(genesisStateConfigMappings);
462
262
  }
463
-
464
- /**
465
- * Validates the L1 contracts configuration to ensure all requirements enforced by L1 contracts
466
- * during construction are satisfied before deployment.
467
- * Accumulates all validation errors and throws an exception listing them all if any are found.
468
- */
469
- export function validateConfig(config: Omit<L1ContractsConfig, keyof L1TxUtilsConfig>): void {
470
- const errors: string[] = [];
471
-
472
- // RollupCore constructor validation: normalFlushSizeMin > 0
473
- // From: require(_config.stakingQueueConfig.normalFlushSizeMin > 0, Errors.Staking__InvalidStakingQueueConfig());
474
- const entryQueueConfig = getEntryQueueConfig('testnet'); // Get config to check normalFlushSizeMin
475
- if (entryQueueConfig.normalFlushSizeMin <= 0n) {
476
- errors.push('normalFlushSizeMin must be greater than 0');
477
- }
478
-
479
- // TimeLib initialization validation: aztecSlotDuration should be a multiple of ethereumSlotDuration
480
- // While not explicitly required in constructor, this is a common validation for time-based systems
481
- if (config.aztecSlotDuration % config.ethereumSlotDuration !== 0) {
482
- errors.push(
483
- `aztecSlotDuration (${config.aztecSlotDuration}) must be a multiple of ethereumSlotDuration (${config.ethereumSlotDuration})`,
484
- );
485
- }
486
-
487
- // EmpireBase constructor validations for governance/slashing proposers
488
- // From: require(QUORUM_SIZE > ROUND_SIZE / 2, Errors.EmpireBase__InvalidQuorumAndRoundSize(QUORUM_SIZE, ROUND_SIZE));
489
- const { governanceProposerQuorum, governanceProposerRoundSize } = config;
490
- if (
491
- governanceProposerQuorum !== undefined &&
492
- governanceProposerQuorum <= Math.floor(governanceProposerRoundSize / 2)
493
- ) {
494
- errors.push(
495
- `governanceProposerQuorum (${governanceProposerQuorum}) must be greater than half of governanceProposerRoundSize (${Math.floor(governanceProposerRoundSize / 2)})`,
496
- );
497
- }
498
-
499
- // From: require(QUORUM_SIZE <= ROUND_SIZE, Errors.EmpireBase__QuorumCannotBeLargerThanRoundSize(QUORUM_SIZE, ROUND_SIZE));
500
- if (governanceProposerQuorum !== undefined && governanceProposerQuorum > governanceProposerRoundSize) {
501
- errors.push(
502
- `governanceProposerQuorum (${governanceProposerQuorum}) cannot be larger than governanceProposerRoundSize (${governanceProposerRoundSize})`,
503
- );
504
- }
505
-
506
- // Slashing quorum validations (similar to governance quorum)
507
- const slashingRoundSize = config.slashingRoundSizeInEpochs * config.aztecEpochDuration;
508
- const { slashingQuorum } = config;
509
- if (slashingQuorum !== undefined && slashingQuorum <= Math.floor(slashingRoundSize / 2)) {
510
- errors.push(
511
- `slashingQuorum (${slashingQuorum}) must be greater than half of slashingRoundSizeInEpochs (${Math.floor(slashingRoundSize / 2)})`,
512
- );
513
- }
514
-
515
- if (slashingQuorum !== undefined && slashingQuorum > slashingRoundSize) {
516
- errors.push(
517
- `slashingQuorum (${slashingQuorum}) cannot be larger than slashingRoundSizeInEpochs (${slashingRoundSize})`,
518
- );
519
- }
520
-
521
- // EmpireBase and TallySlashingProposer lifetime and execution delay validation
522
- // From: require(LIFETIME_IN_ROUNDS > EXECUTION_DELAY_IN_ROUNDS);
523
- if (config.slashingLifetimeInRounds <= config.slashingExecutionDelayInRounds) {
524
- errors.push(
525
- `slashingLifetimeInRounds (${config.slashingLifetimeInRounds}) must be greater than slashingExecutionDelayInRounds (${config.slashingExecutionDelayInRounds})`,
526
- );
527
- }
528
-
529
- // Staking asset validation: activationThreshold > ejectionThreshold
530
- if (config.activationThreshold < config.ejectionThreshold) {
531
- errors.push(
532
- `activationThreshold (${config.activationThreshold}) must be greater than ejectionThreshold (${config.ejectionThreshold})`,
533
- );
534
- }
535
-
536
- // TallySlashingProposer constructor validations
537
- if (config.slasherFlavor === 'tally') {
538
- validateTallySlasherConfig(config, errors);
539
- }
540
-
541
- // Epoch and slot duration validations
542
- if (config.aztecSlotDuration <= 0) {
543
- errors.push('aztecSlotDuration must be greater than 0');
544
- }
545
-
546
- if (config.ethereumSlotDuration <= 0) {
547
- errors.push('ethereumSlotDuration must be greater than 0');
548
- }
549
-
550
- if (config.aztecEpochDuration <= 0) {
551
- errors.push('aztecEpochDuration must be greater than 0');
552
- }
553
-
554
- // Committee size validation
555
- if (config.aztecTargetCommitteeSize < 0) {
556
- errors.push('aztecTargetCommitteeSize cannot be negative');
557
- }
558
-
559
- // Proof submission epochs validation
560
- if (config.aztecProofSubmissionEpochs < 0) {
561
- errors.push('aztecProofSubmissionEpochs cannot be negative');
562
- }
563
-
564
- // Exit delay validation
565
- if (config.exitDelaySeconds < 0) {
566
- errors.push('exitDelaySeconds cannot be negative');
567
- }
568
-
569
- // Mana validation
570
- if (config.manaTarget < 0n) {
571
- errors.push('manaTarget cannot be negative');
572
- }
573
-
574
- if (config.provingCostPerMana < 0n) {
575
- errors.push('provingCostPerMana cannot be negative');
576
- }
577
-
578
- // If any errors were found, throw an exception with all of them
579
- if (errors.length > 0) {
580
- throw new Error(
581
- `L1 contracts configuration validation failed with ${errors.length} error(s):\n${errors.map((error, index) => `${index + 1}. ${error}`).join('\n')}`,
582
- );
583
- }
584
- }
585
-
586
- function validateTallySlasherConfig(config: L1ContractsConfig, errors: string[]) {
587
- if (config.slasherFlavor !== 'tally') {
588
- return;
589
- }
590
-
591
- // From: require(SLASH_OFFSET_IN_ROUNDS > 0, Errors.TallySlashingProposer__SlashOffsetMustBeGreaterThanZero(...));
592
- if (config.slashingOffsetInRounds <= 0) {
593
- errors.push(`slashingOffsetInRounds (${config.slashingOffsetInRounds}) must be greater than 0`);
594
- }
595
-
596
- // From: require(ROUND_SIZE_IN_EPOCHS * _epochDuration == ROUND_SIZE, Errors.TallySlashingProposer__RoundSizeMustBeMultipleOfEpochDuration(...));
597
- const roundSizeInSlots = config.slashingRoundSizeInEpochs * config.aztecEpochDuration;
598
-
599
- // From: require(QUORUM > 0, Errors.TallySlashingProposer__QuorumMustBeGreaterThanZero());
600
- const { slashingQuorum } = config;
601
- if (slashingQuorum !== undefined && slashingQuorum <= 0) {
602
- errors.push(`slashingQuorum (${slashingQuorum}) must be greater than 0`);
603
- }
604
-
605
- // From: require(ROUND_SIZE > 1, Errors.TallySlashingProposer__InvalidQuorumAndRoundSize(QUORUM, ROUND_SIZE));
606
- if (roundSizeInSlots <= 1) {
607
- errors.push(`slashing round size in slots (${roundSizeInSlots}) must be greater than 1`);
608
- }
609
-
610
- // From: require(_slashAmounts[0] <= _slashAmounts[1], Errors.TallySlashingProposer__InvalidSlashAmounts(_slashAmounts));
611
- if (config.slashAmountSmall > config.slashAmountMedium) {
612
- errors.push(
613
- `slashAmountSmall (${config.slashAmountSmall}) must be less than or equal to slashAmountMedium (${config.slashAmountMedium})`,
614
- );
615
- }
616
-
617
- // From: require(_slashAmounts[1] <= _slashAmounts[2], Errors.TallySlashingProposer__InvalidSlashAmounts(_slashAmounts));
618
- if (config.slashAmountMedium > config.slashAmountLarge) {
619
- errors.push(
620
- `slashAmountMedium (${config.slashAmountMedium}) must be less than or equal to slashAmountLarge (${config.slashAmountLarge})`,
621
- );
622
- }
623
-
624
- // From: require(LIFETIME_IN_ROUNDS < ROUNDABOUT_SIZE, Errors.TallySlashingProposer__LifetimeMustBeLessThanRoundabout(...));
625
- const ROUNDABOUT_SIZE = 128; // Constant from TallySlashingProposer
626
- if (config.slashingLifetimeInRounds >= ROUNDABOUT_SIZE) {
627
- errors.push(`slashingLifetimeInRounds (${config.slashingLifetimeInRounds}) must be less than ${ROUNDABOUT_SIZE}`);
628
- }
629
-
630
- // From: require(ROUND_SIZE_IN_EPOCHS > 0, Errors.TallySlashingProposer__RoundSizeInEpochsMustBeGreaterThanZero(...));
631
- if (config.slashingRoundSizeInEpochs <= 0) {
632
- errors.push(`slashingRoundSizeInEpochs (${config.slashingRoundSizeInEpochs}) must be greater than 0`);
633
- }
634
-
635
- // From: require(ROUND_SIZE < MAX_ROUND_SIZE, Errors.TallySlashingProposer__RoundSizeTooLarge(ROUND_SIZE, MAX_ROUND_SIZE));
636
- const MAX_ROUND_SIZE = 1024; // Constant from TallySlashingProposer
637
- if (roundSizeInSlots >= MAX_ROUND_SIZE) {
638
- errors.push(`slashing round size in slots (${roundSizeInSlots}) must be less than ${MAX_ROUND_SIZE}`);
639
- }
640
-
641
- // From: require(COMMITTEE_SIZE > 0, Errors.TallySlashingProposer__CommitteeSizeMustBeGreaterThanZero(COMMITTEE_SIZE));
642
- if (config.aztecTargetCommitteeSize <= 0) {
643
- errors.push(`aztecTargetCommitteeSize (${config.aztecTargetCommitteeSize}) must be greater than 0`);
644
- }
645
-
646
- // From: require(voteSize <= 128, Errors.TallySlashingProposer__VoteSizeTooBig(voteSize, 128));
647
- // voteSize = COMMITTEE_SIZE * ROUND_SIZE_IN_EPOCHS / 4
648
- const voteSize = (config.aztecTargetCommitteeSize * config.slashingRoundSizeInEpochs) / 4;
649
- if (voteSize > 128) {
650
- errors.push(`vote size (${voteSize}) must be <= 128 (committee size * round size in epochs / 4)`);
651
- }
652
-
653
- // From: require(COMMITTEE_SIZE * ROUND_SIZE_IN_EPOCHS % 4 == 0, Errors.TallySlashingProposer__InvalidCommitteeAndRoundSize(...));
654
- if ((config.aztecTargetCommitteeSize * config.slashingRoundSizeInEpochs) % 4 !== 0) {
655
- errors.push(
656
- `aztecTargetCommitteeSize * slashingRoundSizeInEpochs (${config.aztecTargetCommitteeSize * config.slashingRoundSizeInEpochs}) must be divisible by 4`,
657
- );
658
- }
659
-
660
- // Slashing offset validation: should be positive to allow proper slashing timing
661
- if (config.slashingOffsetInRounds < 0) {
662
- errors.push('slashingOffsetInRounds cannot be negative');
663
- }
664
- }