@aztec/ethereum 0.0.0-test.0 → 0.0.1-commit.001888fc

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 (289) hide show
  1. package/dest/account.d.ts +2 -0
  2. package/dest/account.d.ts.map +1 -0
  3. package/dest/account.js +4 -0
  4. package/dest/chain.d.ts +1 -1
  5. package/dest/client.d.ts +14 -4
  6. package/dest/client.d.ts.map +1 -1
  7. package/dest/client.js +27 -3
  8. package/dest/config.d.ts +70 -23
  9. package/dest/config.d.ts.map +1 -1
  10. package/dest/config.js +155 -34
  11. package/dest/constants.d.ts +1 -1
  12. package/dest/contracts/empire_base.d.ts +27 -8
  13. package/dest/contracts/empire_base.d.ts.map +1 -1
  14. package/dest/contracts/empire_base.js +75 -2
  15. package/dest/contracts/empire_slashing_proposer.d.ts +69 -0
  16. package/dest/contracts/empire_slashing_proposer.d.ts.map +1 -0
  17. package/dest/contracts/empire_slashing_proposer.js +216 -0
  18. package/dest/contracts/errors.d.ts +7 -0
  19. package/dest/contracts/errors.d.ts.map +1 -0
  20. package/dest/contracts/errors.js +12 -0
  21. package/dest/contracts/fee_asset_handler.d.ts +20 -0
  22. package/dest/contracts/fee_asset_handler.d.ts.map +1 -0
  23. package/dest/contracts/fee_asset_handler.js +59 -0
  24. package/dest/contracts/fee_asset_price_oracle.d.ts +101 -0
  25. package/dest/contracts/fee_asset_price_oracle.d.ts.map +1 -0
  26. package/dest/contracts/fee_asset_price_oracle.js +651 -0
  27. package/dest/contracts/fee_juice.d.ts +6 -7
  28. package/dest/contracts/fee_juice.d.ts.map +1 -1
  29. package/dest/contracts/fee_juice.js +27 -20
  30. package/dest/contracts/governance.d.ts +45 -32
  31. package/dest/contracts/governance.d.ts.map +1 -1
  32. package/dest/contracts/governance.js +98 -85
  33. package/dest/contracts/governance_proposer.d.ts +19 -13
  34. package/dest/contracts/governance_proposer.d.ts.map +1 -1
  35. package/dest/contracts/governance_proposer.js +441 -26
  36. package/dest/contracts/gse.d.ts +32 -0
  37. package/dest/contracts/gse.d.ts.map +1 -0
  38. package/dest/contracts/gse.js +72 -0
  39. package/dest/contracts/inbox.d.ts +47 -0
  40. package/dest/contracts/inbox.d.ts.map +1 -0
  41. package/dest/contracts/inbox.js +80 -0
  42. package/dest/contracts/index.d.ts +12 -3
  43. package/dest/contracts/index.d.ts.map +1 -1
  44. package/dest/contracts/index.js +11 -2
  45. package/dest/contracts/log.d.ts +13 -0
  46. package/dest/contracts/log.d.ts.map +1 -0
  47. package/dest/contracts/log.js +1 -0
  48. package/dest/contracts/multicall.d.ts +21 -0
  49. package/dest/contracts/multicall.d.ts.map +1 -0
  50. package/dest/contracts/multicall.js +157 -0
  51. package/dest/contracts/outbox.d.ts +41 -0
  52. package/dest/contracts/outbox.d.ts.map +1 -0
  53. package/dest/contracts/outbox.js +86 -0
  54. package/dest/contracts/registry.d.ts +12 -5
  55. package/dest/contracts/registry.d.ts.map +1 -1
  56. package/dest/contracts/registry.js +74 -17
  57. package/dest/contracts/rollup.d.ts +311 -53
  58. package/dest/contracts/rollup.d.ts.map +1 -1
  59. package/dest/contracts/rollup.js +1180 -116
  60. package/dest/contracts/slasher_contract.d.ts +44 -0
  61. package/dest/contracts/slasher_contract.d.ts.map +1 -0
  62. package/dest/contracts/slasher_contract.js +75 -0
  63. package/dest/contracts/tally_slashing_proposer.d.ts +140 -0
  64. package/dest/contracts/tally_slashing_proposer.d.ts.map +1 -0
  65. package/dest/contracts/tally_slashing_proposer.js +320 -0
  66. package/dest/contracts/utils.d.ts +3 -0
  67. package/dest/contracts/utils.d.ts.map +1 -0
  68. package/dest/contracts/utils.js +11 -0
  69. package/dest/deploy_aztec_l1_contracts.d.ts +259 -0
  70. package/dest/deploy_aztec_l1_contracts.d.ts.map +1 -0
  71. package/dest/deploy_aztec_l1_contracts.js +413 -0
  72. package/dest/deploy_l1_contract.d.ts +68 -0
  73. package/dest/deploy_l1_contract.d.ts.map +1 -0
  74. package/dest/deploy_l1_contract.js +312 -0
  75. package/dest/eth-signer/eth-signer.d.ts +21 -0
  76. package/dest/eth-signer/eth-signer.d.ts.map +1 -0
  77. package/dest/eth-signer/eth-signer.js +5 -0
  78. package/dest/eth-signer/index.d.ts +2 -0
  79. package/dest/eth-signer/index.d.ts.map +1 -0
  80. package/dest/eth-signer/index.js +1 -0
  81. package/dest/forwarder_proxy.d.ts +32 -0
  82. package/dest/forwarder_proxy.d.ts.map +1 -0
  83. package/dest/forwarder_proxy.js +93 -0
  84. package/dest/generated/l1-contracts-defaults.d.ts +30 -0
  85. package/dest/generated/l1-contracts-defaults.d.ts.map +1 -0
  86. package/dest/generated/l1-contracts-defaults.js +30 -0
  87. package/dest/l1_artifacts.d.ts +81744 -0
  88. package/dest/l1_artifacts.d.ts.map +1 -0
  89. package/dest/l1_artifacts.js +166 -0
  90. package/dest/l1_contract_addresses.d.ts +24 -4
  91. package/dest/l1_contract_addresses.d.ts.map +1 -1
  92. package/dest/l1_contract_addresses.js +25 -21
  93. package/dest/l1_reader.d.ts +6 -2
  94. package/dest/l1_reader.d.ts.map +1 -1
  95. package/dest/l1_reader.js +20 -9
  96. package/dest/l1_tx_utils/config.d.ts +65 -0
  97. package/dest/l1_tx_utils/config.d.ts.map +1 -0
  98. package/dest/l1_tx_utils/config.js +109 -0
  99. package/dest/l1_tx_utils/constants.d.ts +12 -0
  100. package/dest/l1_tx_utils/constants.d.ts.map +1 -0
  101. package/dest/l1_tx_utils/constants.js +39 -0
  102. package/dest/l1_tx_utils/factory.d.ts +32 -0
  103. package/dest/l1_tx_utils/factory.d.ts.map +1 -0
  104. package/dest/l1_tx_utils/factory.js +22 -0
  105. package/dest/l1_tx_utils/fee-strategies/index.d.ts +10 -0
  106. package/dest/l1_tx_utils/fee-strategies/index.d.ts.map +1 -0
  107. package/dest/l1_tx_utils/fee-strategies/index.js +12 -0
  108. package/dest/l1_tx_utils/fee-strategies/p75_competitive.d.ts +8 -0
  109. package/dest/l1_tx_utils/fee-strategies/p75_competitive.d.ts.map +1 -0
  110. package/dest/l1_tx_utils/fee-strategies/p75_competitive.js +129 -0
  111. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.d.ts +23 -0
  112. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.d.ts.map +1 -0
  113. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.js +191 -0
  114. package/dest/l1_tx_utils/fee-strategies/types.d.ts +51 -0
  115. package/dest/l1_tx_utils/fee-strategies/types.d.ts.map +1 -0
  116. package/dest/l1_tx_utils/fee-strategies/types.js +3 -0
  117. package/dest/l1_tx_utils/forwarder_l1_tx_utils.d.ts +41 -0
  118. package/dest/l1_tx_utils/forwarder_l1_tx_utils.d.ts.map +1 -0
  119. package/dest/l1_tx_utils/forwarder_l1_tx_utils.js +42 -0
  120. package/dest/l1_tx_utils/index-blobs.d.ts +3 -0
  121. package/dest/l1_tx_utils/index-blobs.d.ts.map +1 -0
  122. package/dest/l1_tx_utils/index-blobs.js +2 -0
  123. package/dest/l1_tx_utils/index.d.ts +13 -0
  124. package/dest/l1_tx_utils/index.d.ts.map +1 -0
  125. package/dest/l1_tx_utils/index.js +13 -0
  126. package/dest/l1_tx_utils/interfaces.d.ts +76 -0
  127. package/dest/l1_tx_utils/interfaces.d.ts.map +1 -0
  128. package/dest/l1_tx_utils/interfaces.js +4 -0
  129. package/dest/l1_tx_utils/l1_fee_analyzer.d.ts +233 -0
  130. package/dest/l1_tx_utils/l1_fee_analyzer.d.ts.map +1 -0
  131. package/dest/l1_tx_utils/l1_fee_analyzer.js +506 -0
  132. package/dest/l1_tx_utils/l1_tx_utils.d.ts +105 -0
  133. package/dest/l1_tx_utils/l1_tx_utils.d.ts.map +1 -0
  134. package/dest/l1_tx_utils/l1_tx_utils.js +639 -0
  135. package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts +83 -0
  136. package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts.map +1 -0
  137. package/dest/l1_tx_utils/readonly_l1_tx_utils.js +327 -0
  138. package/dest/l1_tx_utils/signer.d.ts +4 -0
  139. package/dest/l1_tx_utils/signer.d.ts.map +1 -0
  140. package/dest/l1_tx_utils/signer.js +16 -0
  141. package/dest/l1_tx_utils/tx_delayer.d.ts +56 -0
  142. package/dest/l1_tx_utils/tx_delayer.d.ts.map +1 -0
  143. package/dest/l1_tx_utils/tx_delayer.js +221 -0
  144. package/dest/l1_tx_utils/types.d.ts +67 -0
  145. package/dest/l1_tx_utils/types.d.ts.map +1 -0
  146. package/dest/l1_tx_utils/types.js +26 -0
  147. package/dest/l1_tx_utils/utils.d.ts +4 -0
  148. package/dest/l1_tx_utils/utils.d.ts.map +1 -0
  149. package/dest/l1_tx_utils/utils.js +14 -0
  150. package/dest/l1_types.d.ts +6 -0
  151. package/dest/l1_types.d.ts.map +1 -0
  152. package/dest/l1_types.js +1 -0
  153. package/dest/publisher_manager.d.ts +16 -0
  154. package/dest/publisher_manager.d.ts.map +1 -0
  155. package/dest/publisher_manager.js +88 -0
  156. package/dest/queries.d.ts +5 -3
  157. package/dest/queries.d.ts.map +1 -1
  158. package/dest/queries.js +61 -12
  159. package/dest/test/chain_monitor.d.ts +94 -0
  160. package/dest/test/chain_monitor.d.ts.map +1 -0
  161. package/dest/test/chain_monitor.js +244 -0
  162. package/dest/test/eth_cheat_codes.d.ts +229 -0
  163. package/dest/test/eth_cheat_codes.d.ts.map +1 -0
  164. package/dest/test/eth_cheat_codes.js +560 -0
  165. package/dest/test/eth_cheat_codes_with_state.d.ts +2 -2
  166. package/dest/test/eth_cheat_codes_with_state.d.ts.map +1 -1
  167. package/dest/test/eth_cheat_codes_with_state.js +1 -1
  168. package/dest/test/index.d.ts +4 -3
  169. package/dest/test/index.d.ts.map +1 -1
  170. package/dest/test/index.js +3 -2
  171. package/dest/test/rollup_cheat_codes.d.ts +90 -0
  172. package/dest/test/rollup_cheat_codes.d.ts.map +1 -0
  173. package/dest/test/rollup_cheat_codes.js +292 -0
  174. package/dest/test/start_anvil.d.ts +23 -2
  175. package/dest/test/start_anvil.d.ts.map +1 -1
  176. package/dest/test/start_anvil.js +133 -24
  177. package/dest/test/upgrade_utils.d.ts +6 -5
  178. package/dest/test/upgrade_utils.d.ts.map +1 -1
  179. package/dest/test/upgrade_utils.js +23 -16
  180. package/dest/types.d.ts +62 -8
  181. package/dest/types.d.ts.map +1 -1
  182. package/dest/types.js +3 -1
  183. package/dest/utils.d.ts +17 -3
  184. package/dest/utils.d.ts.map +1 -1
  185. package/dest/utils.js +111 -88
  186. package/dest/zkPassportVerifierAddress.d.ts +15 -0
  187. package/dest/zkPassportVerifierAddress.d.ts.map +1 -0
  188. package/dest/zkPassportVerifierAddress.js +11 -0
  189. package/package.json +51 -25
  190. package/src/account.ts +5 -0
  191. package/src/client.ts +51 -5
  192. package/src/config.ts +222 -43
  193. package/src/contracts/README.md +157 -0
  194. package/src/contracts/empire_base.ts +79 -7
  195. package/src/contracts/empire_slashing_proposer.ts +265 -0
  196. package/src/contracts/errors.ts +13 -0
  197. package/src/contracts/fee_asset_handler.ts +66 -0
  198. package/src/contracts/fee_asset_price_oracle.ts +280 -0
  199. package/src/contracts/fee_juice.ts +29 -15
  200. package/src/contracts/governance.ts +90 -78
  201. package/src/contracts/governance_proposer.ts +81 -25
  202. package/src/contracts/gse.ts +88 -0
  203. package/src/contracts/inbox.ts +115 -0
  204. package/src/contracts/index.ts +11 -2
  205. package/src/contracts/log.ts +13 -0
  206. package/src/contracts/multicall.ts +158 -0
  207. package/src/contracts/outbox.ts +98 -0
  208. package/src/contracts/registry.ts +81 -26
  209. package/src/contracts/rollup.ts +940 -89
  210. package/src/contracts/slasher_contract.ts +89 -0
  211. package/src/contracts/tally_slashing_proposer.ts +322 -0
  212. package/src/contracts/utils.ts +14 -0
  213. package/src/deploy_aztec_l1_contracts.ts +650 -0
  214. package/src/deploy_l1_contract.ts +362 -0
  215. package/src/eth-signer/eth-signer.ts +25 -0
  216. package/src/eth-signer/index.ts +1 -0
  217. package/src/forwarder_proxy.ts +108 -0
  218. package/src/generated/l1-contracts-defaults.ts +32 -0
  219. package/src/l1_artifacts.ts +254 -0
  220. package/src/l1_contract_addresses.ts +49 -34
  221. package/src/l1_reader.ts +30 -10
  222. package/src/l1_tx_utils/README.md +177 -0
  223. package/src/l1_tx_utils/config.ts +181 -0
  224. package/src/l1_tx_utils/constants.ts +29 -0
  225. package/src/l1_tx_utils/factory.ts +64 -0
  226. package/src/l1_tx_utils/fee-strategies/index.ts +22 -0
  227. package/src/l1_tx_utils/fee-strategies/p75_competitive.ts +163 -0
  228. package/src/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.ts +245 -0
  229. package/src/l1_tx_utils/fee-strategies/types.ts +56 -0
  230. package/src/l1_tx_utils/forwarder_l1_tx_utils.ts +108 -0
  231. package/src/l1_tx_utils/index-blobs.ts +2 -0
  232. package/src/l1_tx_utils/index.ts +15 -0
  233. package/src/l1_tx_utils/interfaces.ts +86 -0
  234. package/src/l1_tx_utils/l1_fee_analyzer.ts +803 -0
  235. package/src/l1_tx_utils/l1_tx_utils.ts +766 -0
  236. package/src/l1_tx_utils/readonly_l1_tx_utils.ts +423 -0
  237. package/src/l1_tx_utils/signer.ts +28 -0
  238. package/src/l1_tx_utils/tx_delayer.ts +294 -0
  239. package/src/l1_tx_utils/types.ts +85 -0
  240. package/src/l1_tx_utils/utils.ts +16 -0
  241. package/src/l1_types.ts +6 -0
  242. package/src/publisher_manager.ts +108 -0
  243. package/src/queries.ts +82 -16
  244. package/src/test/chain_monitor.ts +302 -0
  245. package/src/test/eth_cheat_codes.ts +588 -0
  246. package/src/test/eth_cheat_codes_with_state.ts +1 -1
  247. package/src/test/index.ts +3 -2
  248. package/src/test/rollup_cheat_codes.ts +330 -0
  249. package/src/test/start_anvil.ts +166 -22
  250. package/src/test/upgrade_utils.ts +30 -21
  251. package/src/types.ts +71 -7
  252. package/src/utils.ts +137 -93
  253. package/src/zkPassportVerifierAddress.ts +15 -0
  254. package/dest/contracts/forwarder.d.ts +0 -24
  255. package/dest/contracts/forwarder.d.ts.map +0 -1
  256. package/dest/contracts/forwarder.js +0 -101
  257. package/dest/contracts/slashing_proposer.d.ts +0 -21
  258. package/dest/contracts/slashing_proposer.d.ts.map +0 -1
  259. package/dest/contracts/slashing_proposer.js +0 -47
  260. package/dest/deploy_l1_contracts.d.ts +0 -21210
  261. package/dest/deploy_l1_contracts.d.ts.map +0 -1
  262. package/dest/deploy_l1_contracts.js +0 -687
  263. package/dest/eth_cheat_codes.d.ts +0 -147
  264. package/dest/eth_cheat_codes.d.ts.map +0 -1
  265. package/dest/eth_cheat_codes.js +0 -303
  266. package/dest/index.d.ts +0 -14
  267. package/dest/index.d.ts.map +0 -1
  268. package/dest/index.js +0 -13
  269. package/dest/l1_tx_utils.d.ts +0 -192
  270. package/dest/l1_tx_utils.d.ts.map +0 -1
  271. package/dest/l1_tx_utils.js +0 -641
  272. package/dest/l1_tx_utils_with_blobs.d.ts +0 -12
  273. package/dest/l1_tx_utils_with_blobs.d.ts.map +0 -1
  274. package/dest/l1_tx_utils_with_blobs.js +0 -64
  275. package/dest/test/delayed_tx_utils.d.ts +0 -8
  276. package/dest/test/delayed_tx_utils.d.ts.map +0 -1
  277. package/dest/test/delayed_tx_utils.js +0 -21
  278. package/dest/test/tx_delayer.d.ts +0 -25
  279. package/dest/test/tx_delayer.d.ts.map +0 -1
  280. package/dest/test/tx_delayer.js +0 -116
  281. package/src/contracts/forwarder.ts +0 -132
  282. package/src/contracts/slashing_proposer.ts +0 -51
  283. package/src/deploy_l1_contracts.ts +0 -948
  284. package/src/eth_cheat_codes.ts +0 -314
  285. package/src/index.ts +0 -13
  286. package/src/l1_tx_utils.ts +0 -847
  287. package/src/l1_tx_utils_with_blobs.ts +0 -86
  288. package/src/test/delayed_tx_utils.ts +0 -24
  289. package/src/test/tx_delayer.ts +0 -163
@@ -0,0 +1,90 @@
1
+ import type { L1ContractAddresses } from '@aztec/ethereum/l1-contract-addresses';
2
+ import type { ViemPublicClient } from '@aztec/ethereum/types';
3
+ import { CheckpointNumber, EpochNumber, SlotNumber } from '@aztec/foundation/branded-types';
4
+ import type { DateProvider } from '@aztec/foundation/timer';
5
+ import { RollupAbi } from '@aztec/l1-artifacts/RollupAbi';
6
+ import { type GetContractReturnType, type Hex } from 'viem';
7
+ import { EthCheatCodes } from './eth_cheat_codes.js';
8
+ /** Cheat codes for the L1 rollup contract. */
9
+ export declare class RollupCheatCodes {
10
+ private ethCheatCodes;
11
+ private client;
12
+ private rollup;
13
+ private logger;
14
+ constructor(ethCheatCodes: EthCheatCodes, addresses: Pick<L1ContractAddresses, 'rollupAddress'>);
15
+ static create(rpcUrls: string[], addresses: Pick<L1ContractAddresses, 'rollupAddress'>, dateProvider: DateProvider): RollupCheatCodes;
16
+ /** Returns the current slot */
17
+ getSlot(): Promise<SlotNumber>;
18
+ /** Returns the number of seconds until the start of the given slot based on L1 block timestamp. */
19
+ getSecondsUntilSlot(slot: SlotNumber): Promise<number>;
20
+ /** Returns the current epoch */
21
+ getEpoch(): Promise<EpochNumber>;
22
+ /**
23
+ * Returns the pending and proven chain tips
24
+ * @returns The pending and proven chain tips
25
+ */
26
+ getTips(): Promise<{
27
+ /** The pending chain tip */ pending: CheckpointNumber;
28
+ /** The proven chain tip */ proven: CheckpointNumber;
29
+ }>;
30
+ /**
31
+ * Logs the current state of the rollup contract.
32
+ */
33
+ debugRollup(): Promise<void>;
34
+ /** Fetches the epoch and slot duration config from the rollup contract */
35
+ getConfig(): Promise<{
36
+ /** Epoch duration */ epochDuration: bigint;
37
+ /** Slot duration */ slotDuration: number;
38
+ }>;
39
+ /**
40
+ * Advances time to the beginning of the given epoch
41
+ * @param epoch - The epoch to advance to
42
+ * @param opts - Options
43
+ */
44
+ advanceToEpoch(epoch: EpochNumber, opts?: {
45
+ /** Offset in seconds */
46
+ offset?: number;
47
+ }): Promise<bigint>;
48
+ /** Warps time in L1 until the next epoch */
49
+ advanceToNextEpoch(): Promise<void>;
50
+ /** Warps time in L1 until the beginning of the next slot. */
51
+ advanceToNextSlot(): Promise<(bigint | SlotNumber)[]>;
52
+ /**
53
+ * Warps time in L1 equivalent to however many slots.
54
+ * @param howMany - The number of slots to advance.
55
+ */
56
+ advanceSlots(howMany: number): Promise<void>;
57
+ /**
58
+ * Marks the specified checkpoint (or latest if none) as proven
59
+ * @param maybeCheckpointNumber - The checkpoint number to mark as proven (defaults to latest pending)
60
+ */
61
+ markAsProven(maybeCheckpointNumber?: CheckpointNumber): Promise<void>;
62
+ /**
63
+ * Overrides the inProgress field of the Inbox contract state
64
+ * @param howMuch - How many checkpoints to move it forward
65
+ */
66
+ advanceInboxInProgress(howMuch: number | bigint): Promise<bigint>;
67
+ insertOutbox(epoch: EpochNumber, outHash: bigint): Promise<void>;
68
+ /**
69
+ * Executes an action impersonated as the owner of the Rollup contract.
70
+ * @param action - The action to execute
71
+ */
72
+ asOwner(action: (owner: Hex, rollup: GetContractReturnType<typeof RollupAbi, ViemPublicClient>) => Promise<void>): Promise<void>;
73
+ /**
74
+ * Sets up the epoch.
75
+ */
76
+ setupEpoch(): Promise<void>;
77
+ /** Directly calls the L1 gas fee oracle. */
78
+ updateL1GasFeeOracle(): Promise<void>;
79
+ /**
80
+ * Bumps proving cost per mana.
81
+ * @param bumper - Callback to calculate the new proving cost per mana based on current value.
82
+ */
83
+ bumpProvingCostPerMana(bumper: (before: bigint) => bigint): Promise<void>;
84
+ /**
85
+ * Directly updates proving cost per mana.
86
+ * @param ethValue - The new proving cost per mana in ETH
87
+ */
88
+ setProvingCostPerMana(ethValue: bigint): Promise<void>;
89
+ }
90
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicm9sbHVwX2NoZWF0X2NvZGVzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdGVzdC9yb2xsdXBfY2hlYXRfY29kZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSx1Q0FBdUMsQ0FBQztBQUNqRixPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQzlELE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxXQUFXLEVBQUUsVUFBVSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFHNUYsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFDNUQsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBRTFELE9BQU8sRUFDTCxLQUFLLHFCQUFxQixFQUMxQixLQUFLLEdBQUcsRUFNVCxNQUFNLE1BQU0sQ0FBQztBQUVkLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUVyRCw4Q0FBOEM7QUFDOUMscUJBQWEsZ0JBQWdCO0lBT3pCLE9BQU8sQ0FBQyxhQUFhO0lBTnZCLE9BQU8sQ0FBQyxNQUFNLENBQW1CO0lBQ2pDLE9BQU8sQ0FBQyxNQUFNLENBQTREO0lBRTFFLE9BQU8sQ0FBQyxNQUFNLENBQXVDO0lBRXJELFlBQ1UsYUFBYSxFQUFFLGFBQWEsRUFDcEMsU0FBUyxFQUFFLElBQUksQ0FBQyxtQkFBbUIsRUFBRSxlQUFlLENBQUMsRUFXdEQ7SUFFRCxNQUFNLENBQUMsTUFBTSxDQUNYLE9BQU8sRUFBRSxNQUFNLEVBQUUsRUFDakIsU0FBUyxFQUFFLElBQUksQ0FBQyxtQkFBbUIsRUFBRSxlQUFlLENBQUMsRUFDckQsWUFBWSxFQUFFLFlBQVksR0FDekIsZ0JBQWdCLENBR2xCO0lBRUQsK0JBQStCO0lBQ2xCLE9BQU8sSUFBSSxPQUFPLENBQUMsVUFBVSxDQUFDLENBRzFDO0lBRUQsbUdBQW1HO0lBQ3RGLG1CQUFtQixDQUFDLElBQUksRUFBRSxVQUFVLEdBQUcsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQU1sRTtJQUVELGdDQUFnQztJQUNuQixRQUFRLElBQUksT0FBTyxDQUFDLFdBQVcsQ0FBQyxDQUc1QztJQUVEOzs7T0FHRztJQUNVLE9BQU8sSUFBSSxPQUFPLENBQUM7UUFDOUIsNEJBQTRCLENBQUMsT0FBTyxFQUFFLGdCQUFnQixDQUFDO1FBQ3ZELDJCQUEyQixDQUFDLE1BQU0sRUFBRSxnQkFBZ0IsQ0FBQztLQUN0RCxDQUFDLENBTUQ7SUFFRDs7T0FFRztJQUNVLFdBQVcsa0JBaUJ2QjtJQUVELDBFQUEwRTtJQUM3RCxTQUFTLElBQUksT0FBTyxDQUFDO1FBQ2hDLHFCQUFxQixDQUFDLGFBQWEsRUFBRSxNQUFNLENBQUM7UUFDNUMsb0JBQW9CLENBQUMsWUFBWSxFQUFFLE1BQU0sQ0FBQztLQUMzQyxDQUFDLENBTUQ7SUFFRDs7OztPQUlHO0lBQ1UsY0FBYyxDQUN6QixLQUFLLEVBQUUsV0FBVyxFQUNsQixJQUFJLEdBQUU7UUFDSix3QkFBd0I7UUFDeEIsTUFBTSxDQUFDLEVBQUUsTUFBTSxDQUFDO0tBQ1osbUJBWVA7SUFFRCw0Q0FBNEM7SUFDL0Isa0JBQWtCLGtCQVc5QjtJQUVELDZEQUE2RDtJQUNoRCxpQkFBaUIscUNBTzdCO0lBRUQ7OztPQUdHO0lBQ1UsWUFBWSxDQUFDLE9BQU8sRUFBRSxNQUFNLGlCQU94QztJQUVEOzs7T0FHRztJQUNJLFlBQVksQ0FBQyxxQkFBcUIsQ0FBQyxFQUFFLGdCQUFnQixpQkErQjNEO0lBRUQ7OztPQUdHO0lBQ0ksc0JBQXNCLENBQUMsT0FBTyxFQUFFLE1BQU0sR0FBRyxNQUFNLEdBQUcsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQW1DdkU7SUFFTSxZQUFZLENBQUMsS0FBSyxFQUFFLFdBQVcsRUFBRSxPQUFPLEVBQUUsTUFBTSxpQkFPdEQ7SUFFRDs7O09BR0c7SUFDVSxPQUFPLENBQ2xCLE1BQU0sRUFBRSxDQUFDLEtBQUssRUFBRSxHQUFHLEVBQUUsTUFBTSxFQUFFLHFCQUFxQixDQUFDLE9BQU8sU0FBUyxFQUFFLGdCQUFnQixDQUFDLEtBQUssT0FBTyxDQUFDLElBQUksQ0FBQyxpQkFNekc7SUFFRDs7T0FFRztJQUNVLFVBQVUsa0JBT3RCO0lBRUQsNENBQTRDO0lBQy9CLG9CQUFvQixrQkFNaEM7SUFFRDs7O09BR0c7SUFDVSxzQkFBc0IsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxNQUFNLEVBQUUsTUFBTSxLQUFLLE1BQU0saUJBSXJFO0lBRUQ7OztPQUdHO0lBQ1UscUJBQXFCLENBQUMsUUFBUSxFQUFFLE1BQU0saUJBVWxEO0NBQ0YifQ==
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rollup_cheat_codes.d.ts","sourceRoot":"","sources":["../../src/test/rollup_cheat_codes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAG5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,GAAG,EAMT,MAAM,MAAM,CAAC;AAEd,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,8CAA8C;AAC9C,qBAAa,gBAAgB;IAOzB,OAAO,CAAC,aAAa;IANvB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,MAAM,CAA4D;IAE1E,OAAO,CAAC,MAAM,CAAuC;IAErD,YACU,aAAa,EAAE,aAAa,EACpC,SAAS,EAAE,IAAI,CAAC,mBAAmB,EAAE,eAAe,CAAC,EAWtD;IAED,MAAM,CAAC,MAAM,CACX,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,IAAI,CAAC,mBAAmB,EAAE,eAAe,CAAC,EACrD,YAAY,EAAE,YAAY,GACzB,gBAAgB,CAGlB;IAED,+BAA+B;IAClB,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,CAG1C;IAED,mGAAmG;IACtF,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAMlE;IAED,gCAAgC;IACnB,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC,CAG5C;IAED;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC;QAC9B,4BAA4B,CAAC,OAAO,EAAE,gBAAgB,CAAC;QACvD,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,CAAC;KACtD,CAAC,CAMD;IAED;;OAEG;IACU,WAAW,kBAiBvB;IAED,0EAA0E;IAC7D,SAAS,IAAI,OAAO,CAAC;QAChC,qBAAqB,CAAC,aAAa,EAAE,MAAM,CAAC;QAC5C,oBAAoB,CAAC,YAAY,EAAE,MAAM,CAAC;KAC3C,CAAC,CAMD;IAED;;;;OAIG;IACU,cAAc,CACzB,KAAK,EAAE,WAAW,EAClB,IAAI,GAAE;QACJ,wBAAwB;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ,mBAYP;IAED,4CAA4C;IAC/B,kBAAkB,kBAW9B;IAED,6DAA6D;IAChD,iBAAiB,qCAO7B;IAED;;;OAGG;IACU,YAAY,CAAC,OAAO,EAAE,MAAM,iBAOxC;IAED;;;OAGG;IACI,YAAY,CAAC,qBAAqB,CAAC,EAAE,gBAAgB,iBA+B3D;IAED;;;OAGG;IACI,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCvE;IAEM,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,iBAOtD;IAED;;;OAGG;IACU,OAAO,CAClB,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,qBAAqB,CAAC,OAAO,SAAS,EAAE,gBAAgB,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,iBAMzG;IAED;;OAEG;IACU,UAAU,kBAOtB;IAED,4CAA4C;IAC/B,oBAAoB,kBAMhC;IAED;;;OAGG;IACU,sBAAsB,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,iBAIrE;IAED;;;OAGG;IACU,qBAAqB,CAAC,QAAQ,EAAE,MAAM,iBAUlD;CACF"}
@@ -0,0 +1,292 @@
1
+ import { OutboxContract, RollupContract } from '@aztec/ethereum/contracts';
2
+ import { CheckpointNumber, EpochNumber, SlotNumber } from '@aztec/foundation/branded-types';
3
+ import { EthAddress } from '@aztec/foundation/eth-address';
4
+ import { createLogger } from '@aztec/foundation/log';
5
+ import { RollupAbi } from '@aztec/l1-artifacts/RollupAbi';
6
+ import { createPublicClient, fallback, getContract, hexToBigInt, http } from 'viem';
7
+ import { EthCheatCodes } from './eth_cheat_codes.js';
8
+ /** Cheat codes for the L1 rollup contract. */ export class RollupCheatCodes {
9
+ ethCheatCodes;
10
+ client;
11
+ rollup;
12
+ logger;
13
+ constructor(ethCheatCodes, addresses){
14
+ this.ethCheatCodes = ethCheatCodes;
15
+ this.logger = createLogger('aztecjs:cheat_codes');
16
+ this.client = createPublicClient({
17
+ chain: ethCheatCodes.chain,
18
+ transport: fallback(ethCheatCodes.rpcUrls.map((url)=>http(url, {
19
+ batch: false
20
+ })))
21
+ });
22
+ this.rollup = getContract({
23
+ abi: RollupAbi,
24
+ address: addresses.rollupAddress.toString(),
25
+ client: this.client
26
+ });
27
+ }
28
+ static create(rpcUrls, addresses, dateProvider) {
29
+ const ethCheatCodes = new EthCheatCodes(rpcUrls, dateProvider);
30
+ return new RollupCheatCodes(ethCheatCodes, addresses);
31
+ }
32
+ /** Returns the current slot */ async getSlot() {
33
+ const ts = BigInt((await this.client.getBlock()).timestamp);
34
+ return SlotNumber.fromBigInt(await this.rollup.read.getSlotAt([
35
+ ts
36
+ ]));
37
+ }
38
+ /** Returns the number of seconds until the start of the given slot based on L1 block timestamp. */ async getSecondsUntilSlot(slot) {
39
+ const [currentTimestamp, targetTimestamp] = await Promise.all([
40
+ this.client.getBlock().then((b)=>BigInt(b.timestamp)),
41
+ this.rollup.read.getTimestampForSlot([
42
+ BigInt(slot)
43
+ ])
44
+ ]);
45
+ return Math.max(0, Number(targetTimestamp - currentTimestamp));
46
+ }
47
+ /** Returns the current epoch */ async getEpoch() {
48
+ const slotNumber = await this.getSlot();
49
+ return EpochNumber.fromBigInt(await this.rollup.read.getEpochAtSlot([
50
+ BigInt(slotNumber)
51
+ ]));
52
+ }
53
+ /**
54
+ * Returns the pending and proven chain tips
55
+ * @returns The pending and proven chain tips
56
+ */ async getTips() {
57
+ const { pending, proven } = await this.rollup.read.getTips();
58
+ return {
59
+ pending: CheckpointNumber.fromBigInt(pending),
60
+ proven: CheckpointNumber.fromBigInt(proven)
61
+ };
62
+ }
63
+ /**
64
+ * Logs the current state of the rollup contract.
65
+ */ async debugRollup() {
66
+ const rollup = new RollupContract(this.client, this.rollup.address);
67
+ const pendingNum = await rollup.getCheckpointNumber();
68
+ const provenNum = await rollup.getProvenCheckpointNumber();
69
+ const validators = await rollup.getAttesters();
70
+ const committee = await rollup.getCurrentEpochCommittee();
71
+ const archive = await rollup.archive();
72
+ const slot = await this.getSlot();
73
+ const epochNum = await rollup.getEpochNumberForSlotNumber(slot);
74
+ this.logger.info(`Pending checkpoint num: ${pendingNum}`);
75
+ this.logger.info(`Proven checkpoint num: ${provenNum}`);
76
+ this.logger.info(`Validators: ${validators.map((v)=>v.toString()).join(', ')}`);
77
+ this.logger.info(`Committee: ${committee?.map((v)=>v.toString()).join(', ')}`);
78
+ this.logger.info(`Archive: ${archive}`);
79
+ this.logger.info(`Epoch num: ${epochNum}`);
80
+ this.logger.info(`Slot: ${slot}`);
81
+ }
82
+ /** Fetches the epoch and slot duration config from the rollup contract */ async getConfig() {
83
+ const [epochDuration, slotDuration] = await Promise.all([
84
+ this.rollup.read.getEpochDuration(),
85
+ this.rollup.read.getSlotDuration()
86
+ ]);
87
+ return {
88
+ epochDuration,
89
+ slotDuration: Number(slotDuration)
90
+ };
91
+ }
92
+ /**
93
+ * Advances time to the beginning of the given epoch
94
+ * @param epoch - The epoch to advance to
95
+ * @param opts - Options
96
+ */ async advanceToEpoch(epoch, opts = {}) {
97
+ const { epochDuration: slotsInEpoch } = await this.getConfig();
98
+ const slotNumber = SlotNumber(Number(epoch) * Number(slotsInEpoch));
99
+ const timestamp = await this.rollup.read.getTimestampForSlot([
100
+ BigInt(slotNumber)
101
+ ]) + BigInt(opts.offset ?? 0);
102
+ try {
103
+ await this.ethCheatCodes.warp(Number(timestamp), {
104
+ ...opts,
105
+ silent: true,
106
+ resetBlockInterval: true
107
+ });
108
+ this.logger.warn(`Warped to epoch ${epoch}`, {
109
+ offset: opts.offset,
110
+ timestamp
111
+ });
112
+ } catch (err) {
113
+ this.logger.warn(`Warp to epoch ${epoch} failed: ${err}`);
114
+ }
115
+ return timestamp;
116
+ }
117
+ /** Warps time in L1 until the next epoch */ async advanceToNextEpoch() {
118
+ const slot = await this.getSlot();
119
+ const { epochDuration, slotDuration } = await this.getConfig();
120
+ const slotsUntilNextEpoch = epochDuration - BigInt(slot) % epochDuration + 1n;
121
+ const timeToNextEpoch = slotsUntilNextEpoch * BigInt(slotDuration);
122
+ const l1Timestamp = BigInt((await this.client.getBlock()).timestamp);
123
+ await this.ethCheatCodes.warp(Number(l1Timestamp + timeToNextEpoch), {
124
+ silent: true,
125
+ resetBlockInterval: true
126
+ });
127
+ this.logger.warn(`Advanced to next epoch`);
128
+ }
129
+ /** Warps time in L1 until the beginning of the next slot. */ async advanceToNextSlot() {
130
+ const currentSlot = await this.getSlot();
131
+ const nextSlot = SlotNumber(currentSlot + 1);
132
+ const timestamp = await this.rollup.read.getTimestampForSlot([
133
+ BigInt(nextSlot)
134
+ ]);
135
+ await this.ethCheatCodes.warp(Number(timestamp), {
136
+ silent: true,
137
+ resetBlockInterval: true
138
+ });
139
+ this.logger.warn(`Advanced to slot ${nextSlot}`);
140
+ return [
141
+ timestamp,
142
+ nextSlot
143
+ ];
144
+ }
145
+ /**
146
+ * Warps time in L1 equivalent to however many slots.
147
+ * @param howMany - The number of slots to advance.
148
+ */ async advanceSlots(howMany) {
149
+ const l1Timestamp = (await this.client.getBlock()).timestamp;
150
+ const slotDuration = Number(await this.rollup.read.getSlotDuration());
151
+ const timeToWarp = BigInt(howMany) * BigInt(slotDuration);
152
+ await this.ethCheatCodes.warp(l1Timestamp + timeToWarp, {
153
+ silent: true,
154
+ resetBlockInterval: true
155
+ });
156
+ const [slot, epoch] = await Promise.all([
157
+ this.getSlot(),
158
+ this.getEpoch()
159
+ ]);
160
+ this.logger.warn(`Advanced ${howMany} slots up to slot ${slot} in epoch ${epoch}`);
161
+ }
162
+ /**
163
+ * Marks the specified checkpoint (or latest if none) as proven
164
+ * @param maybeCheckpointNumber - The checkpoint number to mark as proven (defaults to latest pending)
165
+ */ markAsProven(maybeCheckpointNumber) {
166
+ return this.ethCheatCodes.execWithPausedAnvil(async ()=>{
167
+ const tipsBefore = await this.getTips();
168
+ const { pending, proven } = tipsBefore;
169
+ let checkpointNumber = maybeCheckpointNumber;
170
+ if (checkpointNumber === undefined || checkpointNumber > pending) {
171
+ checkpointNumber = pending;
172
+ }
173
+ if (checkpointNumber <= proven) {
174
+ this.logger.debug(`Checkpoint ${checkpointNumber} is already proven`);
175
+ return;
176
+ }
177
+ // @note @LHerskind this is heavily dependent on the storage layout and size of values
178
+ // The rollupStore is a struct and if the size of elements or the struct changes, this can break
179
+ const provenCheckpointNumberSlot = hexToBigInt(RollupContract.stfStorageSlot);
180
+ // Need to pack it as a single 32 byte word
181
+ const newValue = BigInt(tipsBefore.pending) << 128n | BigInt(checkpointNumber);
182
+ await this.ethCheatCodes.store(EthAddress.fromString(this.rollup.address), provenCheckpointNumberSlot, newValue);
183
+ const tipsAfter = await this.getTips();
184
+ if (tipsAfter.pending < tipsAfter.proven) {
185
+ throw new Error('Overwrote pending tip to a checkpoint in the past');
186
+ }
187
+ this.logger.info(`Proven tip moved: ${tipsBefore.proven} -> ${tipsAfter.proven}. Pending tip: ${tipsAfter.pending}.`);
188
+ });
189
+ }
190
+ /**
191
+ * Overrides the inProgress field of the Inbox contract state
192
+ * @param howMuch - How many checkpoints to move it forward
193
+ */ advanceInboxInProgress(howMuch) {
194
+ return this.ethCheatCodes.execWithPausedAnvil(async ()=>{
195
+ // Storage slot 2 contains the InboxState struct
196
+ const inboxStateSlot = 2n;
197
+ // Get inbox and its current state values
198
+ const inboxAddress = await this.rollup.read.getInbox();
199
+ const currentStateValue = await this.ethCheatCodes.load(EthAddress.fromString(inboxAddress), inboxStateSlot);
200
+ // Extract current values from the packed storage slot
201
+ // Storage layout: rollingHash (128 bits) | totalMessagesInserted (64 bits) | inProgress (64 bits)
202
+ const currentRollingHash = currentStateValue & (1n << 128n) - 1n;
203
+ const currentTotalMessages = currentStateValue >> 128n & (1n << 64n) - 1n;
204
+ const currentInProgress = currentStateValue >> 192n;
205
+ const newInProgress = currentInProgress + BigInt(howMuch);
206
+ // Pack new values: rollingHash (low 128 bits) | totalMessages (middle 64 bits) | inProgress (high 64 bits)
207
+ const newValue = BigInt(newInProgress) << 192n | currentTotalMessages << 128n | currentRollingHash;
208
+ await this.ethCheatCodes.store(EthAddress.fromString(inboxAddress), inboxStateSlot, newValue, {
209
+ silent: true
210
+ });
211
+ this.logger.warn(`Inbox inProgress advanced from ${currentInProgress} to ${newInProgress}`, {
212
+ inbox: inboxAddress,
213
+ oldValue: '0x' + currentStateValue.toString(16),
214
+ newValue: '0x' + newValue.toString(16),
215
+ rollingHash: currentRollingHash,
216
+ totalMessages: currentTotalMessages,
217
+ oldInProgress: currentInProgress,
218
+ newInProgress
219
+ });
220
+ return newInProgress;
221
+ });
222
+ }
223
+ insertOutbox(epoch, outHash) {
224
+ return this.ethCheatCodes.execWithPausedAnvil(async ()=>{
225
+ const outboxAddress = await this.rollup.read.getOutbox();
226
+ const epochRootSlot = OutboxContract.getEpochRootStorageSlot(epoch);
227
+ await this.ethCheatCodes.store(EthAddress.fromString(outboxAddress), epochRootSlot, outHash);
228
+ this.logger.warn(`Advanced outbox to epoch ${epoch} with out hash ${outHash}`);
229
+ });
230
+ }
231
+ /**
232
+ * Executes an action impersonated as the owner of the Rollup contract.
233
+ * @param action - The action to execute
234
+ */ async asOwner(action) {
235
+ const owner = await this.rollup.read.owner();
236
+ await this.ethCheatCodes.startImpersonating(owner);
237
+ await action(owner, this.rollup);
238
+ await this.ethCheatCodes.stopImpersonating(owner);
239
+ }
240
+ /**
241
+ * Sets up the epoch.
242
+ */ async setupEpoch() {
243
+ // Doesn't need to be done as owner, but the functionality is here...
244
+ await this.asOwner(async (account, rollup)=>{
245
+ const hash = await rollup.write.setupEpoch({
246
+ account
247
+ });
248
+ await this.client.waitForTransactionReceipt({
249
+ hash
250
+ });
251
+ this.logger.warn(`Setup epoch`);
252
+ });
253
+ }
254
+ /** Directly calls the L1 gas fee oracle. */ async updateL1GasFeeOracle() {
255
+ await this.asOwner(async (account, rollup)=>{
256
+ const hash = await rollup.write.updateL1GasFeeOracle({
257
+ account,
258
+ chain: this.client.chain
259
+ });
260
+ await this.client.waitForTransactionReceipt({
261
+ hash
262
+ });
263
+ this.logger.warn(`Updated L1 gas fee oracle`);
264
+ });
265
+ }
266
+ /**
267
+ * Bumps proving cost per mana.
268
+ * @param bumper - Callback to calculate the new proving cost per mana based on current value.
269
+ */ async bumpProvingCostPerMana(bumper) {
270
+ const currentCost = await this.rollup.read.getProvingCostPerManaInEth();
271
+ const newCost = bumper(currentCost);
272
+ await this.setProvingCostPerMana(newCost);
273
+ }
274
+ /**
275
+ * Directly updates proving cost per mana.
276
+ * @param ethValue - The new proving cost per mana in ETH
277
+ */ async setProvingCostPerMana(ethValue) {
278
+ await this.asOwner(async (account, rollup)=>{
279
+ const hash = await rollup.write.setProvingCostPerMana([
280
+ ethValue
281
+ ], {
282
+ account,
283
+ chain: this.client.chain,
284
+ gasLimit: 1000000n
285
+ });
286
+ await this.client.waitForTransactionReceipt({
287
+ hash
288
+ });
289
+ this.logger.warn(`Updated proving cost per mana to ${ethValue}`);
290
+ });
291
+ }
292
+ }
@@ -1,12 +1,33 @@
1
- import { type Anvil } from '@viem/anvil';
1
+ /** Minimal interface matching the @viem/anvil Anvil shape used by callers. */
2
+ export interface Anvil {
3
+ readonly port: number;
4
+ readonly host: string;
5
+ readonly status: 'listening' | 'idle';
6
+ stop(): Promise<void>;
7
+ }
2
8
  /**
3
9
  * Ensures there's a running Anvil instance and returns the RPC URL.
4
10
  */
5
11
  export declare function startAnvil(opts?: {
12
+ port?: number;
6
13
  l1BlockTime?: number;
14
+ log?: boolean;
15
+ captureMethodCalls?: boolean;
16
+ accounts?: number;
17
+ chainId?: number;
18
+ /** The hardfork to use (e.g. 'cancun', 'latest'). */
19
+ hardfork?: string;
20
+ /**
21
+ * Number of slots per epoch used by anvil to compute the 'finalized' and 'safe' block tags.
22
+ * Anvil reports `finalized = latest - slotsInAnEpoch * 2`.
23
+ * Defaults to 1 so the finalized block advances immediately, making tests that check
24
+ * L1-finality-based logic work without needing hundreds of mined blocks.
25
+ */
26
+ slotsInAnEpoch?: number;
7
27
  }): Promise<{
8
28
  anvil: Anvil;
29
+ methodCalls?: string[];
9
30
  rpcUrl: string;
10
31
  stop: () => Promise<void>;
11
32
  }>;
12
- //# sourceMappingURL=start_anvil.d.ts.map
33
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RhcnRfYW52aWwuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90ZXN0L3N0YXJ0X2FudmlsLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQU9BLDhFQUE4RTtBQUM5RSxNQUFNLFdBQVcsS0FBSztJQUNwQixRQUFRLENBQUMsSUFBSSxFQUFFLE1BQU0sQ0FBQztJQUN0QixRQUFRLENBQUMsSUFBSSxFQUFFLE1BQU0sQ0FBQztJQUN0QixRQUFRLENBQUMsTUFBTSxFQUFFLFdBQVcsR0FBRyxNQUFNLENBQUM7SUFDdEMsSUFBSSxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztDQUN2QjtBQUVEOztHQUVHO0FBQ0gsd0JBQXNCLFVBQVUsQ0FDOUIsSUFBSSxHQUFFO0lBQ0osSUFBSSxDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ2QsV0FBVyxDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ3JCLEdBQUcsQ0FBQyxFQUFFLE9BQU8sQ0FBQztJQUNkLGtCQUFrQixDQUFDLEVBQUUsT0FBTyxDQUFDO0lBQzdCLFFBQVEsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUNsQixPQUFPLENBQUMsRUFBRSxNQUFNLENBQUM7SUFDakIscURBQXFEO0lBQ3JELFFBQVEsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUNsQjs7Ozs7T0FLRztJQUNILGNBQWMsQ0FBQyxFQUFFLE1BQU0sQ0FBQztDQUNwQixHQUNMLE9BQU8sQ0FBQztJQUFFLEtBQUssRUFBRSxLQUFLLENBQUM7SUFBQyxXQUFXLENBQUMsRUFBRSxNQUFNLEVBQUUsQ0FBQztJQUFDLE1BQU0sRUFBRSxNQUFNLENBQUM7SUFBQyxJQUFJLEVBQUUsTUFBTSxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUE7Q0FBRSxDQUFDLENBNEg5RiJ9
@@ -1 +1 @@
1
- {"version":3,"file":"start_anvil.d.ts","sourceRoot":"","sources":["../../src/test/start_anvil.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,KAAK,EAAe,MAAM,aAAa,CAAC;AAGtD;;GAEG;AACH,wBAAsB,UAAU,CAC9B,IAAI,GAAE;IACJ,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GACL,OAAO,CAAC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAsCtE"}
1
+ {"version":3,"file":"start_anvil.d.ts","sourceRoot":"","sources":["../../src/test/start_anvil.ts"],"names":[],"mappings":"AAOA,8EAA8E;AAC9E,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC;IACtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,IAAI,GAAE;IACJ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACpB,GACL,OAAO,CAAC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CA4H9F"}
@@ -1,46 +1,155 @@
1
+ import { createLogger } from '@aztec/foundation/log';
1
2
  import { makeBackoff, retry } from '@aztec/foundation/retry';
2
3
  import { fileURLToPath } from '@aztec/foundation/url';
3
- import { createAnvil } from '@viem/anvil';
4
+ import { spawn } from 'child_process';
4
5
  import { dirname, resolve } from 'path';
5
6
  /**
6
7
  * Ensures there's a running Anvil instance and returns the RPC URL.
7
8
  */ export async function startAnvil(opts = {}) {
8
9
  const anvilBinary = resolve(dirname(fileURLToPath(import.meta.url)), '../../', 'scripts/anvil_kill_wrapper.sh');
9
- let port;
10
- // Start anvil.
11
- // We go via a wrapper script to ensure if the parent dies, anvil dies.
10
+ const logger = opts.log ? createLogger('ethereum:anvil') : undefined;
11
+ const methodCalls = opts.captureMethodCalls ? [] : undefined;
12
+ let detectedPort;
12
13
  const anvil = await retry(async ()=>{
13
- const anvil = createAnvil({
14
- anvilBinary,
15
- port: 0,
16
- blockTime: opts.l1BlockTime,
17
- stopTimeout: 1000
18
- });
19
- // Listen to the anvil output to get the port.
20
- const removeHandler = anvil.on('message', (message)=>{
21
- if (port === undefined && message.includes('Listening on')) {
22
- port = parseInt(message.match(/Listening on ([^:]+):(\d+)/)[2]);
14
+ const port = opts.port ?? (process.env.ANVIL_PORT ? parseInt(process.env.ANVIL_PORT) : 8545);
15
+ const args = [
16
+ '--host',
17
+ '127.0.0.1',
18
+ '--port',
19
+ String(port),
20
+ '--accounts',
21
+ String(opts.accounts ?? 20),
22
+ '--gas-limit',
23
+ String(45_000_000),
24
+ '--chain-id',
25
+ String(opts.chainId ?? 31337)
26
+ ];
27
+ if (opts.l1BlockTime !== undefined) {
28
+ args.push('--block-time', String(opts.l1BlockTime));
29
+ }
30
+ if (opts.hardfork !== undefined) {
31
+ args.push('--hardfork', opts.hardfork);
32
+ }
33
+ args.push('--slots-in-an-epoch', String(opts.slotsInAnEpoch ?? 1));
34
+ const child = spawn(anvilBinary, args, {
35
+ stdio: [
36
+ 'ignore',
37
+ 'pipe',
38
+ 'pipe'
39
+ ],
40
+ env: {
41
+ ...process.env,
42
+ RAYON_NUM_THREADS: '1'
23
43
  }
24
44
  });
25
- await anvil.start();
26
- removeHandler();
27
- return anvil;
45
+ // Wait for "Listening on" or an early exit.
46
+ await new Promise((resolve, reject)=>{
47
+ let stderr = '';
48
+ const onStdout = (data)=>{
49
+ const text = data.toString();
50
+ logger?.debug(text.trim());
51
+ methodCalls?.push(...text.match(/eth_[^\s]+/g) || []);
52
+ if (detectedPort === undefined && text.includes('Listening on')) {
53
+ const match = text.match(/Listening on ([^:]+):(\d+)/);
54
+ if (match) {
55
+ detectedPort = parseInt(match[2]);
56
+ }
57
+ }
58
+ if (detectedPort !== undefined) {
59
+ child.stdout?.removeListener('data', onStdout);
60
+ child.stderr?.removeListener('data', onStderr);
61
+ child.removeListener('close', onClose);
62
+ resolve();
63
+ }
64
+ };
65
+ const onStderr = (data)=>{
66
+ stderr += data.toString();
67
+ logger?.debug(data.toString().trim());
68
+ };
69
+ const onClose = (code)=>{
70
+ child.stdout?.removeListener('data', onStdout);
71
+ child.stderr?.removeListener('data', onStderr);
72
+ reject(new Error(`Anvil exited with code ${code} before listening. stderr: ${stderr}`));
73
+ };
74
+ child.stdout?.on('data', onStdout);
75
+ child.stderr?.on('data', onStderr);
76
+ child.once('close', onClose);
77
+ });
78
+ // Continue piping for logging / method-call capture after startup.
79
+ if (logger || opts.captureMethodCalls) {
80
+ child.stdout?.on('data', (data)=>{
81
+ const text = data.toString();
82
+ logger?.debug(text.trim());
83
+ methodCalls?.push(...text.match(/eth_[^\s]+/g) || []);
84
+ });
85
+ child.stderr?.on('data', (data)=>{
86
+ logger?.debug(data.toString().trim());
87
+ });
88
+ } else {
89
+ // Consume streams so the child process doesn't block on full pipe buffers.
90
+ child.stdout?.resume();
91
+ child.stderr?.resume();
92
+ }
93
+ return child;
28
94
  }, 'Start anvil', makeBackoff([
29
95
  5,
30
96
  5,
31
97
  5
32
98
  ]));
33
- if (!port) {
99
+ if (!detectedPort) {
34
100
  throw new Error('Failed to start anvil');
35
101
  }
36
- // Monkeypatch the anvil instance to include the actually assigned port
37
- Object.defineProperty(anvil, 'port', {
38
- value: port,
39
- writable: false
102
+ const port = detectedPort;
103
+ let status = 'listening';
104
+ anvil.once('close', ()=>{
105
+ status = 'idle';
40
106
  });
107
+ const stop = async ()=>{
108
+ if (status === 'idle') {
109
+ return;
110
+ }
111
+ await killChild(anvil);
112
+ };
113
+ const anvilObj = {
114
+ port,
115
+ host: '127.0.0.1',
116
+ get status () {
117
+ return status;
118
+ },
119
+ stop
120
+ };
41
121
  return {
42
- anvil,
43
- stop: ()=>anvil.stop(),
122
+ anvil: anvilObj,
123
+ methodCalls,
124
+ stop,
44
125
  rpcUrl: `http://127.0.0.1:${port}`
45
126
  };
46
127
  }
128
+ /** Send SIGTERM, wait up to 5 s, then SIGKILL. All timers are always cleared. */ function killChild(child) {
129
+ return new Promise((resolve)=>{
130
+ if (child.exitCode !== null || child.killed) {
131
+ child.stdout?.destroy();
132
+ child.stderr?.destroy();
133
+ resolve();
134
+ return;
135
+ }
136
+ let killTimer;
137
+ const onClose = ()=>{
138
+ if (killTimer !== undefined) {
139
+ clearTimeout(killTimer);
140
+ }
141
+ // Destroy stdio streams so their PipeWrap handles don't keep the event loop alive.
142
+ child.stdout?.destroy();
143
+ child.stderr?.destroy();
144
+ resolve();
145
+ };
146
+ child.once('close', onClose);
147
+ child.kill('SIGTERM');
148
+ killTimer = setTimeout(()=>{
149
+ killTimer = undefined;
150
+ child.kill('SIGKILL');
151
+ }, 5000);
152
+ // Ensure the timer does not prevent Node from exiting.
153
+ killTimer.unref();
154
+ });
155
+ }
@@ -2,10 +2,11 @@ import type { Logger } from '@aztec/foundation/log';
2
2
  import { GovernanceAbi } from '@aztec/l1-artifacts/GovernanceAbi';
3
3
  import { type GetContractReturnType, type PrivateKeyAccount } from 'viem';
4
4
  import type { L1ContractAddresses } from '../l1_contract_addresses.js';
5
- import type { L1Clients } from '../types.js';
6
- export declare function executeGovernanceProposal(proposalId: bigint, governance: GetContractReturnType<typeof GovernanceAbi, L1Clients['publicClient']>, voteAmount: bigint, privateKey: PrivateKeyAccount, publicClient: L1Clients['publicClient'], walletClient: L1Clients['walletClient'], rpcUrls: string[], logger: Logger): Promise<void>;
7
- export declare function createGovernanceProposal(payloadAddress: `0x${string}`, addresses: L1ContractAddresses, privateKey: PrivateKeyAccount, publicClient: L1Clients['publicClient'], logger: Logger): Promise<{
8
- governance: GetContractReturnType<typeof GovernanceAbi, L1Clients['publicClient']>;
5
+ import type { ExtendedViemWalletClient, ViemPublicClient } from '../types.js';
6
+ export declare function executeGovernanceProposal(proposalId: bigint, governance: GetContractReturnType<typeof GovernanceAbi, ViemPublicClient>, voteAmount: bigint, privateKey: PrivateKeyAccount, l1Client: ExtendedViemWalletClient, rpcUrls: string[], logger: Logger): Promise<void>;
7
+ export declare function createGovernanceProposal(payloadAddress: `0x${string}`, addresses: L1ContractAddresses, privateKey: PrivateKeyAccount, publicClient: ViemPublicClient, logger: Logger): Promise<{
8
+ governance: GetContractReturnType<typeof GovernanceAbi, ViemPublicClient>;
9
9
  voteAmount: bigint;
10
+ proposalId: bigint;
10
11
  }>;
11
- //# sourceMappingURL=upgrade_utils.d.ts.map
12
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXBncmFkZV91dGlscy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3Rlc3QvdXBncmFkZV91dGlscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUVwRCxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sbUNBQW1DLENBQUM7QUFHbEUsT0FBTyxFQUFFLEtBQUsscUJBQXFCLEVBQUUsS0FBSyxpQkFBaUIsRUFBZSxNQUFNLE1BQU0sQ0FBQztBQUd2RixPQUFPLEtBQUssRUFBRSxtQkFBbUIsRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBRXZFLE9BQU8sS0FBSyxFQUFFLHdCQUF3QixFQUFFLGdCQUFnQixFQUFFLE1BQU0sYUFBYSxDQUFDO0FBRzlFLHdCQUFzQix5QkFBeUIsQ0FDN0MsVUFBVSxFQUFFLE1BQU0sRUFDbEIsVUFBVSxFQUFFLHFCQUFxQixDQUFDLE9BQU8sYUFBYSxFQUFFLGdCQUFnQixDQUFDLEVBQ3pFLFVBQVUsRUFBRSxNQUFNLEVBQ2xCLFVBQVUsRUFBRSxpQkFBaUIsRUFDN0IsUUFBUSxFQUFFLHdCQUF3QixFQUNsQyxPQUFPLEVBQUUsTUFBTSxFQUFFLEVBQ2pCLE1BQU0sRUFBRSxNQUFNLGlCQW1DZjtBQUVELHdCQUFzQix3QkFBd0IsQ0FDNUMsY0FBYyxFQUFFLEtBQUssTUFBTSxFQUFFLEVBQzdCLFNBQVMsRUFBRSxtQkFBbUIsRUFDOUIsVUFBVSxFQUFFLGlCQUFpQixFQUM3QixZQUFZLEVBQUUsZ0JBQWdCLEVBQzlCLE1BQU0sRUFBRSxNQUFNLEdBQ2IsT0FBTyxDQUFDO0lBQ1QsVUFBVSxFQUFFLHFCQUFxQixDQUFDLE9BQU8sYUFBYSxFQUFFLGdCQUFnQixDQUFDLENBQUM7SUFDMUUsVUFBVSxFQUFFLE1BQU0sQ0FBQztJQUNuQixVQUFVLEVBQUUsTUFBTSxDQUFDO0NBQ3BCLENBQUMsQ0F5Q0QifQ==
@@ -1 +1 @@
1
- {"version":3,"file":"upgrade_utils.d.ts","sourceRoot":"","sources":["../../src/test/upgrade_utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAElE,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAe,MAAM,MAAM,CAAC;AAGvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,qBAAqB,CAAC,OAAO,aAAa,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC,EAClF,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,iBAAiB,EAC7B,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC,EACvC,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC,EACvC,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,MAAM,iBAoCf;AAED,wBAAsB,wBAAwB,CAC5C,cAAc,EAAE,KAAK,MAAM,EAAE,EAC7B,SAAS,EAAE,mBAAmB,EAC9B,UAAU,EAAE,iBAAiB,EAC7B,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC,EACvC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,UAAU,EAAE,qBAAqB,CAAC,OAAO,aAAa,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAqCrH"}
1
+ {"version":3,"file":"upgrade_utils.d.ts","sourceRoot":"","sources":["../../src/test/upgrade_utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAGlE,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAe,MAAM,MAAM,CAAC;AAGvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,OAAO,KAAK,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG9E,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,qBAAqB,CAAC,OAAO,aAAa,EAAE,gBAAgB,CAAC,EACzE,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,iBAAiB,EAC7B,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,MAAM,iBAmCf;AAED,wBAAsB,wBAAwB,CAC5C,cAAc,EAAE,KAAK,MAAM,EAAE,EAC7B,SAAS,EAAE,mBAAmB,EAC9B,UAAU,EAAE,iBAAiB,EAC7B,YAAY,EAAE,gBAAgB,EAC9B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IACT,UAAU,EAAE,qBAAqB,CAAC,OAAO,aAAa,EAAE,gBAAgB,CAAC,CAAC;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CAyCD"}