@aztec/ethereum 0.0.1-commit.fce3e4f → 0.0.1-commit.fffb133c

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 (166) hide show
  1. package/dest/client.js +6 -2
  2. package/dest/config.d.ts +19 -68
  3. package/dest/config.d.ts.map +1 -1
  4. package/dest/config.js +51 -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.d.ts +3 -1
  14. package/dest/contracts/governance.d.ts.map +1 -1
  15. package/dest/contracts/governance.js +9 -1
  16. package/dest/contracts/governance_proposer.d.ts +2 -1
  17. package/dest/contracts/governance_proposer.d.ts.map +1 -1
  18. package/dest/contracts/governance_proposer.js +391 -8
  19. package/dest/contracts/inbox.d.ts +24 -3
  20. package/dest/contracts/inbox.d.ts.map +1 -1
  21. package/dest/contracts/inbox.js +36 -1
  22. package/dest/contracts/index.d.ts +3 -1
  23. package/dest/contracts/index.d.ts.map +1 -1
  24. package/dest/contracts/index.js +2 -0
  25. package/dest/contracts/log.d.ts +13 -0
  26. package/dest/contracts/log.d.ts.map +1 -0
  27. package/dest/contracts/log.js +1 -0
  28. package/dest/contracts/outbox.d.ts +41 -0
  29. package/dest/contracts/outbox.d.ts.map +1 -0
  30. package/dest/contracts/outbox.js +86 -0
  31. package/dest/contracts/rollup.d.ts +176 -96
  32. package/dest/contracts/rollup.d.ts.map +1 -1
  33. package/dest/contracts/rollup.js +698 -141
  34. package/dest/contracts/tally_slashing_proposer.d.ts +3 -2
  35. package/dest/contracts/tally_slashing_proposer.d.ts.map +1 -1
  36. package/dest/contracts/tally_slashing_proposer.js +1 -1
  37. package/dest/deploy_aztec_l1_contracts.d.ts +260 -0
  38. package/dest/deploy_aztec_l1_contracts.d.ts.map +1 -0
  39. package/dest/deploy_aztec_l1_contracts.js +398 -0
  40. package/dest/deploy_l1_contract.d.ts +68 -0
  41. package/dest/deploy_l1_contract.d.ts.map +1 -0
  42. package/dest/deploy_l1_contract.js +312 -0
  43. package/dest/forwarder_proxy.d.ts +32 -0
  44. package/dest/forwarder_proxy.d.ts.map +1 -0
  45. package/dest/forwarder_proxy.js +93 -0
  46. package/dest/generated/l1-contracts-defaults.d.ts +30 -0
  47. package/dest/generated/l1-contracts-defaults.d.ts.map +1 -0
  48. package/dest/generated/l1-contracts-defaults.js +30 -0
  49. package/dest/l1_artifacts.d.ts +4964 -1573
  50. package/dest/l1_artifacts.d.ts.map +1 -1
  51. package/dest/l1_contract_addresses.d.ts +1 -1
  52. package/dest/l1_contract_addresses.d.ts.map +1 -1
  53. package/dest/l1_contract_addresses.js +3 -3
  54. package/dest/l1_reader.d.ts +3 -1
  55. package/dest/l1_reader.d.ts.map +1 -1
  56. package/dest/l1_reader.js +6 -0
  57. package/dest/l1_tx_utils/config.d.ts +3 -3
  58. package/dest/l1_tx_utils/config.d.ts.map +1 -1
  59. package/dest/l1_tx_utils/config.js +17 -3
  60. package/dest/l1_tx_utils/constants.d.ts +7 -1
  61. package/dest/l1_tx_utils/constants.d.ts.map +1 -1
  62. package/dest/l1_tx_utils/constants.js +25 -0
  63. package/dest/l1_tx_utils/fee-strategies/index.d.ts +10 -0
  64. package/dest/l1_tx_utils/fee-strategies/index.d.ts.map +1 -0
  65. package/dest/l1_tx_utils/fee-strategies/index.js +12 -0
  66. package/dest/l1_tx_utils/fee-strategies/p75_competitive.d.ts +8 -0
  67. package/dest/l1_tx_utils/fee-strategies/p75_competitive.d.ts.map +1 -0
  68. package/dest/l1_tx_utils/fee-strategies/p75_competitive.js +129 -0
  69. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.d.ts +23 -0
  70. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.d.ts.map +1 -0
  71. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.js +191 -0
  72. package/dest/l1_tx_utils/fee-strategies/types.d.ts +51 -0
  73. package/dest/l1_tx_utils/fee-strategies/types.d.ts.map +1 -0
  74. package/dest/l1_tx_utils/fee-strategies/types.js +3 -0
  75. package/dest/l1_tx_utils/forwarder_l1_tx_utils.d.ts +41 -0
  76. package/dest/l1_tx_utils/forwarder_l1_tx_utils.d.ts.map +1 -0
  77. package/dest/l1_tx_utils/forwarder_l1_tx_utils.js +48 -0
  78. package/dest/l1_tx_utils/index-blobs.d.ts +3 -0
  79. package/dest/l1_tx_utils/index-blobs.d.ts.map +1 -0
  80. package/dest/l1_tx_utils/index-blobs.js +2 -0
  81. package/dest/l1_tx_utils/index.d.ts +3 -1
  82. package/dest/l1_tx_utils/index.d.ts.map +1 -1
  83. package/dest/l1_tx_utils/index.js +2 -0
  84. package/dest/l1_tx_utils/interfaces.d.ts +2 -2
  85. package/dest/l1_tx_utils/interfaces.d.ts.map +1 -1
  86. package/dest/l1_tx_utils/l1_fee_analyzer.d.ts +233 -0
  87. package/dest/l1_tx_utils/l1_fee_analyzer.d.ts.map +1 -0
  88. package/dest/l1_tx_utils/l1_fee_analyzer.js +506 -0
  89. package/dest/l1_tx_utils/l1_tx_utils.d.ts +1 -1
  90. package/dest/l1_tx_utils/l1_tx_utils.d.ts.map +1 -1
  91. package/dest/l1_tx_utils/l1_tx_utils.js +17 -4
  92. package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts +4 -15
  93. package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts.map +1 -1
  94. package/dest/l1_tx_utils/readonly_l1_tx_utils.js +52 -159
  95. package/dest/queries.d.ts +2 -2
  96. package/dest/queries.d.ts.map +1 -1
  97. package/dest/queries.js +12 -4
  98. package/dest/test/chain_monitor.d.ts +15 -13
  99. package/dest/test/chain_monitor.d.ts.map +1 -1
  100. package/dest/test/chain_monitor.js +7 -9
  101. package/dest/test/eth_cheat_codes.d.ts +13 -1
  102. package/dest/test/eth_cheat_codes.d.ts.map +1 -1
  103. package/dest/test/eth_cheat_codes.js +4 -2
  104. package/dest/test/rollup_cheat_codes.d.ts +7 -6
  105. package/dest/test/rollup_cheat_codes.d.ts.map +1 -1
  106. package/dest/test/rollup_cheat_codes.js +23 -6
  107. package/dest/test/start_anvil.d.ts +3 -1
  108. package/dest/test/start_anvil.d.ts.map +1 -1
  109. package/dest/test/tx_delayer.d.ts +1 -1
  110. package/dest/test/tx_delayer.d.ts.map +1 -1
  111. package/dest/test/tx_delayer.js +4 -3
  112. package/dest/types.d.ts +57 -2
  113. package/dest/types.d.ts.map +1 -1
  114. package/dest/utils.d.ts +15 -3
  115. package/dest/utils.d.ts.map +1 -1
  116. package/dest/utils.js +18 -0
  117. package/package.json +33 -14
  118. package/src/client.ts +2 -2
  119. package/src/config.ts +62 -457
  120. package/src/contracts/README.md +157 -0
  121. package/src/contracts/empire_base.ts +1 -1
  122. package/src/contracts/empire_slashing_proposer.ts +6 -1
  123. package/src/contracts/fee_asset_handler.ts +8 -7
  124. package/src/contracts/governance.ts +8 -1
  125. package/src/contracts/governance_proposer.ts +6 -1
  126. package/src/contracts/inbox.ts +55 -3
  127. package/src/contracts/index.ts +2 -0
  128. package/src/contracts/log.ts +13 -0
  129. package/src/contracts/outbox.ts +98 -0
  130. package/src/contracts/rollup.ts +375 -111
  131. package/src/contracts/tally_slashing_proposer.ts +3 -1
  132. package/src/deploy_aztec_l1_contracts.ts +619 -0
  133. package/src/deploy_l1_contract.ts +362 -0
  134. package/src/forwarder_proxy.ts +108 -0
  135. package/src/generated/l1-contracts-defaults.ts +32 -0
  136. package/src/l1_contract_addresses.ts +22 -20
  137. package/src/l1_reader.ts +8 -0
  138. package/src/l1_tx_utils/config.ts +24 -6
  139. package/src/l1_tx_utils/constants.ts +11 -0
  140. package/src/l1_tx_utils/fee-strategies/index.ts +22 -0
  141. package/src/l1_tx_utils/fee-strategies/p75_competitive.ts +163 -0
  142. package/src/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.ts +245 -0
  143. package/src/l1_tx_utils/fee-strategies/types.ts +56 -0
  144. package/src/l1_tx_utils/forwarder_l1_tx_utils.ts +119 -0
  145. package/src/l1_tx_utils/index-blobs.ts +2 -0
  146. package/src/l1_tx_utils/index.ts +2 -0
  147. package/src/l1_tx_utils/interfaces.ts +1 -1
  148. package/src/l1_tx_utils/l1_fee_analyzer.ts +803 -0
  149. package/src/l1_tx_utils/l1_tx_utils.ts +24 -4
  150. package/src/l1_tx_utils/readonly_l1_tx_utils.ts +65 -204
  151. package/src/queries.ts +11 -3
  152. package/src/test/chain_monitor.ts +18 -16
  153. package/src/test/eth_cheat_codes.ts +2 -2
  154. package/src/test/rollup_cheat_codes.ts +23 -9
  155. package/src/test/start_anvil.ts +2 -0
  156. package/src/test/tx_delayer.ts +5 -3
  157. package/src/types.ts +62 -0
  158. package/src/utils.ts +30 -1
  159. package/dest/deploy_l1_contracts.d.ts +0 -673
  160. package/dest/deploy_l1_contracts.d.ts.map +0 -1
  161. package/dest/deploy_l1_contracts.js +0 -1491
  162. package/dest/index.d.ts +0 -18
  163. package/dest/index.d.ts.map +0 -1
  164. package/dest/index.js +0 -17
  165. package/src/deploy_l1_contracts.ts +0 -1869
  166. 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,320 +69,108 @@ 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 */
72
77
  provingCostPerMana: bigint;
78
+ /** The initial ETH per fee asset price (with 1e12 precision) */
79
+ initialEthPerFeeAsset: bigint;
73
80
  /** The number of seconds to wait for an exit */
74
81
  exitDelaySeconds: number;
75
82
  } & L1TxUtilsConfig;
76
83
 
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
-
84
+ /**
85
+ * Config mappings for L1ContractsConfig.
86
+ * Default values come from generated l1-contracts-defaults.json (source: defaults.yml).
87
+ * Real deployments use forge scripts which require explicit env vars (vm.envUint).
88
+ */
306
89
  export const l1ContractsConfigMappings: ConfigMappingsType<L1ContractsConfig> = {
307
90
  ethereumSlotDuration: {
308
91
  env: 'ETHEREUM_SLOT_DURATION',
309
92
  description: 'How many seconds an L1 slot lasts.',
310
- ...numberConfigHelper(DefaultL1ContractsConfig.ethereumSlotDuration),
93
+ ...numberConfigHelper(l1ContractsDefaultEnv.ETHEREUM_SLOT_DURATION),
311
94
  },
312
95
  aztecSlotDuration: {
313
96
  env: 'AZTEC_SLOT_DURATION',
314
97
  description: 'How many seconds an L2 slots lasts (must be multiple of ethereum slot duration).',
315
- ...numberConfigHelper(DefaultL1ContractsConfig.aztecSlotDuration),
98
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLOT_DURATION),
316
99
  },
317
100
  aztecEpochDuration: {
318
101
  env: 'AZTEC_EPOCH_DURATION',
319
102
  description: `How many L2 slots an epoch lasts (maximum AZTEC_MAX_EPOCH_DURATION).`,
320
- ...numberConfigHelper(DefaultL1ContractsConfig.aztecEpochDuration),
103
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_EPOCH_DURATION),
321
104
  },
322
105
  aztecTargetCommitteeSize: {
323
106
  env: 'AZTEC_TARGET_COMMITTEE_SIZE',
324
107
  description: 'The target validator committee size.',
325
- ...numberConfigHelper(DefaultL1ContractsConfig.aztecTargetCommitteeSize),
108
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_TARGET_COMMITTEE_SIZE),
326
109
  },
327
110
  lagInEpochsForValidatorSet: {
328
111
  env: 'AZTEC_LAG_IN_EPOCHS_FOR_VALIDATOR_SET',
329
112
  description: 'The number of epochs to lag behind the current epoch for validator selection.',
330
- ...numberConfigHelper(DefaultL1ContractsConfig.lagInEpochsForValidatorSet),
113
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_LAG_IN_EPOCHS_FOR_VALIDATOR_SET),
331
114
  },
332
115
  lagInEpochsForRandao: {
333
116
  env: 'AZTEC_LAG_IN_EPOCHS_FOR_RANDAO',
334
117
  description: 'The number of epochs to lag behind the current epoch for randao selection.',
335
- ...numberConfigHelper(DefaultL1ContractsConfig.lagInEpochsForRandao),
118
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_LAG_IN_EPOCHS_FOR_RANDAO),
119
+ },
120
+ inboxLag: {
121
+ env: 'AZTEC_INBOX_LAG',
122
+ description: 'The number of checkpoints to lag in the inbox (prevents sequencer DOS attacks).',
123
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_INBOX_LAG),
336
124
  },
337
125
  aztecProofSubmissionEpochs: {
338
126
  env: 'AZTEC_PROOF_SUBMISSION_EPOCHS',
339
127
  description: 'The number of epochs after an epoch ends that proofs are still accepted.',
340
- ...numberConfigHelper(DefaultL1ContractsConfig.aztecProofSubmissionEpochs),
128
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_PROOF_SUBMISSION_EPOCHS),
341
129
  },
342
130
  activationThreshold: {
343
131
  env: 'AZTEC_ACTIVATION_THRESHOLD',
344
132
  description: 'The deposit amount for a validator',
345
- ...bigintConfigHelper(DefaultL1ContractsConfig.activationThreshold),
133
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_ACTIVATION_THRESHOLD)),
346
134
  },
347
135
  ejectionThreshold: {
348
136
  env: 'AZTEC_EJECTION_THRESHOLD',
349
137
  description: 'The minimum stake for a validator.',
350
- ...bigintConfigHelper(DefaultL1ContractsConfig.ejectionThreshold),
138
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_EJECTION_THRESHOLD)),
351
139
  },
352
140
  localEjectionThreshold: {
353
141
  env: 'AZTEC_LOCAL_EJECTION_THRESHOLD',
354
142
  description:
355
143
  'The local ejection threshold for a validator. Stricter than ejectionThreshold but local to a specific rollup',
356
- ...bigintConfigHelper(DefaultL1ContractsConfig.localEjectionThreshold),
144
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_LOCAL_EJECTION_THRESHOLD)),
357
145
  },
358
146
  slashingOffsetInRounds: {
359
147
  env: 'AZTEC_SLASHING_OFFSET_IN_ROUNDS',
360
148
  description:
361
149
  '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),
150
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_OFFSET_IN_ROUNDS),
363
151
  },
364
152
  slasherFlavor: {
365
153
  env: 'AZTEC_SLASHER_FLAVOR',
366
154
  description: 'Type of slasher proposer (empire, tally, or none)',
367
- ...enumConfigHelper(['empire', 'tally', 'none'] as const, DefaultL1ContractsConfig.slasherFlavor),
155
+ ...enumConfigHelper(
156
+ ['empire', 'tally', 'none'] as const,
157
+ l1ContractsDefaultEnv.AZTEC_SLASHER_FLAVOR as 'empire' | 'tally' | 'none',
158
+ ),
368
159
  },
369
160
  slashAmountSmall: {
370
161
  env: 'AZTEC_SLASH_AMOUNT_SMALL',
371
162
  description: 'Small slashing amount for light offenses',
372
- ...bigintConfigHelper(DefaultL1ContractsConfig.slashAmountSmall),
163
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_SLASH_AMOUNT_SMALL)),
373
164
  },
374
165
  slashAmountMedium: {
375
166
  env: 'AZTEC_SLASH_AMOUNT_MEDIUM',
376
167
  description: 'Medium slashing amount for moderate offenses',
377
- ...bigintConfigHelper(DefaultL1ContractsConfig.slashAmountMedium),
168
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_SLASH_AMOUNT_MEDIUM)),
378
169
  },
379
170
  slashAmountLarge: {
380
171
  env: 'AZTEC_SLASH_AMOUNT_LARGE',
381
172
  description: 'Large slashing amount for severe offenses',
382
- ...bigintConfigHelper(DefaultL1ContractsConfig.slashAmountLarge),
173
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_SLASH_AMOUNT_LARGE)),
383
174
  },
384
175
  slashingQuorum: {
385
176
  env: 'AZTEC_SLASHING_QUORUM',
@@ -389,28 +180,28 @@ export const l1ContractsConfigMappings: ConfigMappingsType<L1ContractsConfig> =
389
180
  slashingRoundSizeInEpochs: {
390
181
  env: 'AZTEC_SLASHING_ROUND_SIZE_IN_EPOCHS',
391
182
  description: 'The slashing round size',
392
- ...numberConfigHelper(DefaultL1ContractsConfig.slashingRoundSizeInEpochs),
183
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_ROUND_SIZE_IN_EPOCHS),
393
184
  },
394
185
  slashingLifetimeInRounds: {
395
186
  env: 'AZTEC_SLASHING_LIFETIME_IN_ROUNDS',
396
187
  description: 'The slashing lifetime in rounds',
397
- ...numberConfigHelper(DefaultL1ContractsConfig.slashingLifetimeInRounds),
188
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_LIFETIME_IN_ROUNDS),
398
189
  },
399
190
  slashingExecutionDelayInRounds: {
400
191
  env: 'AZTEC_SLASHING_EXECUTION_DELAY_IN_ROUNDS',
401
192
  description: 'The slashing execution delay in rounds',
402
- ...numberConfigHelper(DefaultL1ContractsConfig.slashingExecutionDelayInRounds),
193
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_EXECUTION_DELAY_IN_ROUNDS),
403
194
  },
404
195
  slashingVetoer: {
405
196
  env: 'AZTEC_SLASHING_VETOER',
406
197
  description: 'The slashing vetoer',
407
198
  parseEnv: (val: string) => EthAddress.fromString(val),
408
- defaultValue: DefaultL1ContractsConfig.slashingVetoer,
199
+ defaultValue: EthAddress.fromString(l1ContractsDefaultEnv.AZTEC_SLASHING_VETOER),
409
200
  },
410
201
  slashingDisableDuration: {
411
202
  env: 'AZTEC_SLASHING_DISABLE_DURATION',
412
203
  description: 'How long slashing can be disabled for in seconds when vetoer disables it',
413
- ...numberConfigHelper(DefaultL1ContractsConfig.slashingDisableDuration),
204
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_DISABLE_DURATION),
414
205
  },
415
206
  governanceProposerQuorum: {
416
207
  env: 'AZTEC_GOVERNANCE_PROPOSER_QUORUM',
@@ -420,26 +211,42 @@ export const l1ContractsConfigMappings: ConfigMappingsType<L1ContractsConfig> =
420
211
  governanceProposerRoundSize: {
421
212
  env: 'AZTEC_GOVERNANCE_PROPOSER_ROUND_SIZE',
422
213
  description: 'The governance proposing round size',
423
- ...numberConfigHelper(DefaultL1ContractsConfig.governanceProposerRoundSize),
214
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_GOVERNANCE_PROPOSER_ROUND_SIZE),
215
+ },
216
+ governanceVotingDuration: {
217
+ env: 'AZTEC_GOVERNANCE_VOTING_DURATION',
218
+ description: 'Governance voting duration in seconds (only for local/devnet/next-net)',
219
+ ...numberConfigHelper(3600), // 1 hour default, not in generated defaults as it's deployment-time only
424
220
  },
425
221
  manaTarget: {
426
222
  env: 'AZTEC_MANA_TARGET',
427
223
  description: 'The mana target for the rollup',
428
- ...bigintConfigHelper(DefaultL1ContractsConfig.manaTarget),
224
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_MANA_TARGET)),
429
225
  },
430
226
  provingCostPerMana: {
431
227
  env: 'AZTEC_PROVING_COST_PER_MANA',
432
228
  description: 'The proving cost per mana',
433
- ...bigintConfigHelper(DefaultL1ContractsConfig.provingCostPerMana),
229
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_PROVING_COST_PER_MANA)),
230
+ },
231
+ initialEthPerFeeAsset: {
232
+ env: 'AZTEC_INITIAL_ETH_PER_FEE_ASSET',
233
+ description: 'The initial ETH per fee asset price (with 1e12 precision)',
234
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_INITIAL_ETH_PER_FEE_ASSET)),
434
235
  },
435
236
  exitDelaySeconds: {
436
237
  env: 'AZTEC_EXIT_DELAY_SECONDS',
437
238
  description: 'The delay before a validator can exit the set',
438
- ...numberConfigHelper(DefaultL1ContractsConfig.exitDelaySeconds),
239
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_EXIT_DELAY_SECONDS),
439
240
  },
440
241
  ...l1TxUtilsConfigMappings,
441
242
  };
442
243
 
244
+ /**
245
+ * Default L1 contracts configuration derived from l1ContractsConfigMappings.
246
+ * Source of truth: spartan/environments/defaults.yml -> defaults.l1-contracts
247
+ */
248
+ export const DefaultL1ContractsConfig = getDefaultConfig(l1ContractsConfigMappings);
249
+
443
250
  export const genesisStateConfigMappings: ConfigMappingsType<GenesisStateConfig> = {
444
251
  testAccounts: {
445
252
  env: 'TEST_ACCOUNTS',
@@ -460,205 +267,3 @@ export function getL1ContractsConfigEnvVars(): L1ContractsConfig {
460
267
  export function getGenesisStateConfigEnvVars(): GenesisStateConfig {
461
268
  return getConfigFromMappings(genesisStateConfigMappings);
462
269
  }
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
- }