@aztec/ethereum 0.0.1-commit.03f7ef2 → 0.0.1-commit.0b941701

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 (81) hide show
  1. package/dest/config.d.ts +17 -27
  2. package/dest/config.d.ts.map +1 -1
  3. package/dest/config.js +50 -53
  4. package/dest/contracts/fee_asset_handler.d.ts +6 -5
  5. package/dest/contracts/fee_asset_handler.d.ts.map +1 -1
  6. package/dest/contracts/fee_asset_handler.js +9 -9
  7. package/dest/contracts/governance.d.ts +3 -1
  8. package/dest/contracts/governance.d.ts.map +1 -1
  9. package/dest/contracts/governance.js +9 -1
  10. package/dest/contracts/governance_proposer.js +382 -8
  11. package/dest/contracts/inbox.d.ts +22 -1
  12. package/dest/contracts/inbox.d.ts.map +1 -1
  13. package/dest/contracts/inbox.js +36 -1
  14. package/dest/contracts/index.d.ts +3 -1
  15. package/dest/contracts/index.d.ts.map +1 -1
  16. package/dest/contracts/index.js +2 -0
  17. package/dest/contracts/log.d.ts +13 -0
  18. package/dest/contracts/log.d.ts.map +1 -0
  19. package/dest/contracts/log.js +1 -0
  20. package/dest/contracts/outbox.d.ts +41 -0
  21. package/dest/contracts/outbox.d.ts.map +1 -0
  22. package/dest/contracts/outbox.js +86 -0
  23. package/dest/contracts/rollup.d.ts +160 -96
  24. package/dest/contracts/rollup.d.ts.map +1 -1
  25. package/dest/contracts/rollup.js +668 -129
  26. package/dest/deploy_aztec_l1_contracts.d.ts +17 -2
  27. package/dest/deploy_aztec_l1_contracts.d.ts.map +1 -1
  28. package/dest/deploy_aztec_l1_contracts.js +75 -12
  29. package/dest/generated/l1-contracts-defaults.d.ts +30 -0
  30. package/dest/generated/l1-contracts-defaults.d.ts.map +1 -0
  31. package/dest/generated/l1-contracts-defaults.js +30 -0
  32. package/dest/l1_artifacts.d.ts +4904 -1533
  33. package/dest/l1_artifacts.d.ts.map +1 -1
  34. package/dest/l1_tx_utils/fee-strategies/index.d.ts +3 -2
  35. package/dest/l1_tx_utils/fee-strategies/index.d.ts.map +1 -1
  36. package/dest/l1_tx_utils/fee-strategies/index.js +2 -1
  37. package/dest/l1_tx_utils/fee-strategies/p75_competitive.d.ts +2 -12
  38. package/dest/l1_tx_utils/fee-strategies/p75_competitive.d.ts.map +1 -1
  39. package/dest/l1_tx_utils/fee-strategies/p75_competitive.js +35 -17
  40. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.d.ts +2 -11
  41. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.d.ts.map +1 -1
  42. package/dest/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.js +36 -18
  43. package/dest/l1_tx_utils/fee-strategies/types.d.ts +14 -27
  44. package/dest/l1_tx_utils/fee-strategies/types.d.ts.map +1 -1
  45. package/dest/l1_tx_utils/fee-strategies/types.js +0 -21
  46. package/dest/l1_tx_utils/l1_fee_analyzer.d.ts +2 -2
  47. package/dest/l1_tx_utils/l1_fee_analyzer.d.ts.map +1 -1
  48. package/dest/l1_tx_utils/l1_fee_analyzer.js +3 -3
  49. package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts +1 -5
  50. package/dest/l1_tx_utils/readonly_l1_tx_utils.d.ts.map +1 -1
  51. package/dest/l1_tx_utils/readonly_l1_tx_utils.js +14 -51
  52. package/dest/queries.d.ts +2 -2
  53. package/dest/queries.d.ts.map +1 -1
  54. package/dest/queries.js +12 -4
  55. package/dest/test/chain_monitor.js +1 -2
  56. package/dest/test/eth_cheat_codes.d.ts +13 -1
  57. package/dest/test/eth_cheat_codes.d.ts.map +1 -1
  58. package/dest/test/rollup_cheat_codes.d.ts +3 -2
  59. package/dest/test/rollup_cheat_codes.d.ts.map +1 -1
  60. package/dest/test/rollup_cheat_codes.js +10 -2
  61. package/package.json +8 -7
  62. package/src/config.ts +61 -52
  63. package/src/contracts/README.md +157 -0
  64. package/src/contracts/fee_asset_handler.ts +8 -7
  65. package/src/contracts/governance.ts +8 -1
  66. package/src/contracts/inbox.ts +53 -1
  67. package/src/contracts/index.ts +2 -0
  68. package/src/contracts/log.ts +13 -0
  69. package/src/contracts/outbox.ts +98 -0
  70. package/src/contracts/rollup.ts +333 -93
  71. package/src/deploy_aztec_l1_contracts.ts +77 -14
  72. package/src/generated/l1-contracts-defaults.ts +32 -0
  73. package/src/l1_tx_utils/fee-strategies/index.ts +1 -1
  74. package/src/l1_tx_utils/fee-strategies/p75_competitive.ts +45 -41
  75. package/src/l1_tx_utils/fee-strategies/p75_competitive_blob_txs_only.ts +48 -44
  76. package/src/l1_tx_utils/fee-strategies/types.ts +14 -46
  77. package/src/l1_tx_utils/l1_fee_analyzer.ts +2 -3
  78. package/src/l1_tx_utils/readonly_l1_tx_utils.ts +20 -59
  79. package/src/queries.ts +11 -3
  80. package/src/test/chain_monitor.ts +1 -1
  81. package/src/test/rollup_cheat_codes.ts +12 -3
@@ -56,12 +56,13 @@ export declare class RollupCheatCodes {
56
56
  * Marks the specified checkpoint (or latest if none) as proven
57
57
  * @param maybeCheckpointNumber - The checkpoint number to mark as proven (defaults to latest pending)
58
58
  */
59
- markAsProven(maybeCheckpointNumber?: number | bigint): Promise<void>;
59
+ markAsProven(maybeCheckpointNumber?: CheckpointNumber): Promise<void>;
60
60
  /**
61
61
  * Overrides the inProgress field of the Inbox contract state
62
62
  * @param howMuch - How many checkpoints to move it forward
63
63
  */
64
64
  advanceInboxInProgress(howMuch: number | bigint): Promise<bigint>;
65
+ insertOutbox(epoch: EpochNumber, outHash: bigint): Promise<void>;
65
66
  /**
66
67
  * Executes an action impersonated as the owner of the Rollup contract.
67
68
  * @param action - The action to execute
@@ -84,4 +85,4 @@ export declare class RollupCheatCodes {
84
85
  */
85
86
  setProvingCostPerMana(ethValue: bigint): Promise<void>;
86
87
  }
87
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicm9sbHVwX2NoZWF0X2NvZGVzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdGVzdC9yb2xsdXBfY2hlYXRfY29kZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSx1Q0FBdUMsQ0FBQztBQUNqRixPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQzlELE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxXQUFXLEVBQUUsVUFBVSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFHNUYsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFDNUQsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBRTFELE9BQU8sRUFDTCxLQUFLLHFCQUFxQixFQUMxQixLQUFLLEdBQUcsRUFNVCxNQUFNLE1BQU0sQ0FBQztBQUVkLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUVyRCw4Q0FBOEM7QUFDOUMscUJBQWEsZ0JBQWdCO0lBT3pCLE9BQU8sQ0FBQyxhQUFhO0lBTnZCLE9BQU8sQ0FBQyxNQUFNLENBQW1CO0lBQ2pDLE9BQU8sQ0FBQyxNQUFNLENBQTREO0lBRTFFLE9BQU8sQ0FBQyxNQUFNLENBQXVDO0lBRXJELFlBQ1UsYUFBYSxFQUFFLGFBQWEsRUFDcEMsU0FBUyxFQUFFLElBQUksQ0FBQyxtQkFBbUIsRUFBRSxlQUFlLENBQUMsRUFXdEQ7SUFFRCxNQUFNLENBQUMsTUFBTSxDQUNYLE9BQU8sRUFBRSxNQUFNLEVBQUUsRUFDakIsU0FBUyxFQUFFLElBQUksQ0FBQyxtQkFBbUIsRUFBRSxlQUFlLENBQUMsRUFDckQsWUFBWSxFQUFFLFlBQVksR0FDekIsZ0JBQWdCLENBR2xCO0lBRUQsK0JBQStCO0lBQ2xCLE9BQU8sSUFBSSxPQUFPLENBQUMsVUFBVSxDQUFDLENBRzFDO0lBRUQsZ0NBQWdDO0lBQ25CLFFBQVEsSUFBSSxPQUFPLENBQUMsV0FBVyxDQUFDLENBRzVDO0lBRUQ7OztPQUdHO0lBQ1UsT0FBTyxJQUFJLE9BQU8sQ0FBQztRQUM5Qiw0QkFBNEIsQ0FBQyxPQUFPLEVBQUUsZ0JBQWdCLENBQUM7UUFDdkQsMkJBQTJCLENBQUMsTUFBTSxFQUFFLGdCQUFnQixDQUFDO0tBQ3RELENBQUMsQ0FNRDtJQUVEOztPQUVHO0lBQ1UsV0FBVyxrQkFpQnZCO0lBRUQsMEVBQTBFO0lBQzdELFNBQVMsSUFBSSxPQUFPLENBQUM7UUFDaEMscUJBQXFCLENBQUMsYUFBYSxFQUFFLE1BQU0sQ0FBQztRQUM1QyxvQkFBb0IsQ0FBQyxZQUFZLEVBQUUsTUFBTSxDQUFDO0tBQzNDLENBQUMsQ0FNRDtJQUVEOzs7O09BSUc7SUFDVSxjQUFjLENBQ3pCLEtBQUssRUFBRSxXQUFXLEVBQ2xCLElBQUksR0FBRTtRQUNKLHdCQUF3QjtRQUN4QixNQUFNLENBQUMsRUFBRSxNQUFNLENBQUM7S0FDWixtQkFZUDtJQUVELDRDQUE0QztJQUMvQixrQkFBa0Isa0JBVzlCO0lBRUQsNkRBQTZEO0lBQ2hELGlCQUFpQixxQ0FPN0I7SUFFRDs7O09BR0c7SUFDVSxZQUFZLENBQUMsT0FBTyxFQUFFLE1BQU0saUJBT3hDO0lBRUQ7OztPQUdHO0lBQ0ksWUFBWSxDQUFDLHFCQUFxQixDQUFDLEVBQUUsTUFBTSxHQUFHLE1BQU0saUJBK0IxRDtJQUVEOzs7T0FHRztJQUNJLHNCQUFzQixDQUFDLE9BQU8sRUFBRSxNQUFNLEdBQUcsTUFBTSxHQUFHLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FtQ3ZFO0lBRUQ7OztPQUdHO0lBQ1UsT0FBTyxDQUNsQixNQUFNLEVBQUUsQ0FBQyxLQUFLLEVBQUUsR0FBRyxFQUFFLE1BQU0sRUFBRSxxQkFBcUIsQ0FBQyxPQUFPLFNBQVMsRUFBRSxnQkFBZ0IsQ0FBQyxLQUFLLE9BQU8sQ0FBQyxJQUFJLENBQUMsaUJBTXpHO0lBRUQ7O09BRUc7SUFDVSxVQUFVLGtCQU90QjtJQUVELDRDQUE0QztJQUMvQixvQkFBb0Isa0JBTWhDO0lBRUQ7OztPQUdHO0lBQ1Usc0JBQXNCLENBQUMsTUFBTSxFQUFFLENBQUMsTUFBTSxFQUFFLE1BQU0sS0FBSyxNQUFNLGlCQUlyRTtJQUVEOzs7T0FHRztJQUNVLHFCQUFxQixDQUFDLFFBQVEsRUFBRSxNQUFNLGlCQVVsRDtDQUNGIn0=
88
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicm9sbHVwX2NoZWF0X2NvZGVzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdGVzdC9yb2xsdXBfY2hlYXRfY29kZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSx1Q0FBdUMsQ0FBQztBQUNqRixPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQzlELE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxXQUFXLEVBQUUsVUFBVSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFHNUYsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFDNUQsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBRTFELE9BQU8sRUFDTCxLQUFLLHFCQUFxQixFQUMxQixLQUFLLEdBQUcsRUFNVCxNQUFNLE1BQU0sQ0FBQztBQUVkLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUVyRCw4Q0FBOEM7QUFDOUMscUJBQWEsZ0JBQWdCO0lBT3pCLE9BQU8sQ0FBQyxhQUFhO0lBTnZCLE9BQU8sQ0FBQyxNQUFNLENBQW1CO0lBQ2pDLE9BQU8sQ0FBQyxNQUFNLENBQTREO0lBRTFFLE9BQU8sQ0FBQyxNQUFNLENBQXVDO0lBRXJELFlBQ1UsYUFBYSxFQUFFLGFBQWEsRUFDcEMsU0FBUyxFQUFFLElBQUksQ0FBQyxtQkFBbUIsRUFBRSxlQUFlLENBQUMsRUFXdEQ7SUFFRCxNQUFNLENBQUMsTUFBTSxDQUNYLE9BQU8sRUFBRSxNQUFNLEVBQUUsRUFDakIsU0FBUyxFQUFFLElBQUksQ0FBQyxtQkFBbUIsRUFBRSxlQUFlLENBQUMsRUFDckQsWUFBWSxFQUFFLFlBQVksR0FDekIsZ0JBQWdCLENBR2xCO0lBRUQsK0JBQStCO0lBQ2xCLE9BQU8sSUFBSSxPQUFPLENBQUMsVUFBVSxDQUFDLENBRzFDO0lBRUQsZ0NBQWdDO0lBQ25CLFFBQVEsSUFBSSxPQUFPLENBQUMsV0FBVyxDQUFDLENBRzVDO0lBRUQ7OztPQUdHO0lBQ1UsT0FBTyxJQUFJLE9BQU8sQ0FBQztRQUM5Qiw0QkFBNEIsQ0FBQyxPQUFPLEVBQUUsZ0JBQWdCLENBQUM7UUFDdkQsMkJBQTJCLENBQUMsTUFBTSxFQUFFLGdCQUFnQixDQUFDO0tBQ3RELENBQUMsQ0FNRDtJQUVEOztPQUVHO0lBQ1UsV0FBVyxrQkFpQnZCO0lBRUQsMEVBQTBFO0lBQzdELFNBQVMsSUFBSSxPQUFPLENBQUM7UUFDaEMscUJBQXFCLENBQUMsYUFBYSxFQUFFLE1BQU0sQ0FBQztRQUM1QyxvQkFBb0IsQ0FBQyxZQUFZLEVBQUUsTUFBTSxDQUFDO0tBQzNDLENBQUMsQ0FNRDtJQUVEOzs7O09BSUc7SUFDVSxjQUFjLENBQ3pCLEtBQUssRUFBRSxXQUFXLEVBQ2xCLElBQUksR0FBRTtRQUNKLHdCQUF3QjtRQUN4QixNQUFNLENBQUMsRUFBRSxNQUFNLENBQUM7S0FDWixtQkFZUDtJQUVELDRDQUE0QztJQUMvQixrQkFBa0Isa0JBVzlCO0lBRUQsNkRBQTZEO0lBQ2hELGlCQUFpQixxQ0FPN0I7SUFFRDs7O09BR0c7SUFDVSxZQUFZLENBQUMsT0FBTyxFQUFFLE1BQU0saUJBT3hDO0lBRUQ7OztPQUdHO0lBQ0ksWUFBWSxDQUFDLHFCQUFxQixDQUFDLEVBQUUsZ0JBQWdCLGlCQStCM0Q7SUFFRDs7O09BR0c7SUFDSSxzQkFBc0IsQ0FBQyxPQUFPLEVBQUUsTUFBTSxHQUFHLE1BQU0sR0FBRyxPQUFPLENBQUMsTUFBTSxDQUFDLENBbUN2RTtJQUVNLFlBQVksQ0FBQyxLQUFLLEVBQUUsV0FBVyxFQUFFLE9BQU8sRUFBRSxNQUFNLGlCQU90RDtJQUVEOzs7T0FHRztJQUNVLE9BQU8sQ0FDbEIsTUFBTSxFQUFFLENBQUMsS0FBSyxFQUFFLEdBQUcsRUFBRSxNQUFNLEVBQUUscUJBQXFCLENBQUMsT0FBTyxTQUFTLEVBQUUsZ0JBQWdCLENBQUMsS0FBSyxPQUFPLENBQUMsSUFBSSxDQUFDLGlCQU16RztJQUVEOztPQUVHO0lBQ1UsVUFBVSxrQkFPdEI7SUFFRCw0Q0FBNEM7SUFDL0Isb0JBQW9CLGtCQU1oQztJQUVEOzs7T0FHRztJQUNVLHNCQUFzQixDQUFDLE1BQU0sRUFBRSxDQUFDLE1BQU0sRUFBRSxNQUFNLEtBQUssTUFBTSxpQkFJckU7SUFFRDs7O09BR0c7SUFDVSxxQkFBcUIsQ0FBQyxRQUFRLEVBQUUsTUFBTSxpQkFVbEQ7Q0FDRiJ9
@@ -1 +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,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,MAAM,GAAG,MAAM,iBA+B1D;IAED;;;OAGG;IACI,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCvE;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"}
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,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"}
@@ -1,4 +1,4 @@
1
- import { RollupContract } from '@aztec/ethereum/contracts';
1
+ import { OutboxContract, RollupContract } from '@aztec/ethereum/contracts';
2
2
  import { CheckpointNumber, EpochNumber, SlotNumber } from '@aztec/foundation/branded-types';
3
3
  import { EthAddress } from '@aztec/foundation/eth-address';
4
4
  import { createLogger } from '@aztec/foundation/log';
@@ -86,7 +86,7 @@ import { EthCheatCodes } from './eth_cheat_codes.js';
86
86
  * @param opts - Options
87
87
  */ async advanceToEpoch(epoch, opts = {}) {
88
88
  const { epochDuration: slotsInEpoch } = await this.getConfig();
89
- const slotNumber = SlotNumber(epoch * Number(slotsInEpoch));
89
+ const slotNumber = SlotNumber(Number(epoch) * Number(slotsInEpoch));
90
90
  const timestamp = await this.rollup.read.getTimestampForSlot([
91
91
  BigInt(slotNumber)
92
92
  ]) + BigInt(opts.offset ?? 0);
@@ -211,6 +211,14 @@ import { EthCheatCodes } from './eth_cheat_codes.js';
211
211
  return newInProgress;
212
212
  });
213
213
  }
214
+ insertOutbox(epoch, outHash) {
215
+ return this.ethCheatCodes.execWithPausedAnvil(async ()=>{
216
+ const outboxAddress = await this.rollup.read.getOutbox();
217
+ const epochRootSlot = OutboxContract.getEpochRootStorageSlot(epoch);
218
+ await this.ethCheatCodes.store(EthAddress.fromString(outboxAddress), epochRootSlot, outHash);
219
+ this.logger.warn(`Advanced outbox to epoch ${epoch} with out hash ${outHash}`);
220
+ });
221
+ }
214
222
  /**
215
223
  * Executes an action impersonated as the owner of the Rollup contract.
216
224
  * @param action - The action to execute
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aztec/ethereum",
3
- "version": "0.0.1-commit.03f7ef2",
3
+ "version": "0.0.1-commit.0b941701",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  "./account": "./dest/account.js",
@@ -40,7 +40,8 @@
40
40
  "build": "yarn clean && ../scripts/tsc.sh",
41
41
  "build:dev": "../scripts/tsc.sh --watch",
42
42
  "clean": "rm -rf ./dest .tsbuildinfo",
43
- "start:dev": "concurrently -k \"tsgo -b -w\" \"nodemon --watch dest --exec yarn start\"",
43
+ "generate": "./scripts/generate.sh",
44
+ "start:dev": "concurrently -k \"../scripts/tsc.sh --watch\" \"nodemon --watch dest --exec yarn start\"",
44
45
  "start": "node ./dest/index.js",
45
46
  "test": "NODE_NO_WARNINGS=1 node --experimental-vm-modules ../node_modules/.bin/jest --passWithNoTests --maxWorkers=${JEST_MAX_WORKERS:-8}",
46
47
  "proposer-address": "node ./dest/cli/forwarder_address.js"
@@ -49,10 +50,10 @@
49
50
  "../package.common.json"
50
51
  ],
51
52
  "dependencies": {
52
- "@aztec/blob-lib": "0.0.1-commit.03f7ef2",
53
- "@aztec/constants": "0.0.1-commit.03f7ef2",
54
- "@aztec/foundation": "0.0.1-commit.03f7ef2",
55
- "@aztec/l1-artifacts": "0.0.1-commit.03f7ef2",
53
+ "@aztec/blob-lib": "0.0.1-commit.0b941701",
54
+ "@aztec/constants": "0.0.1-commit.0b941701",
55
+ "@aztec/foundation": "0.0.1-commit.0b941701",
56
+ "@aztec/l1-artifacts": "0.0.1-commit.0b941701",
56
57
  "@viem/anvil": "^0.0.10",
57
58
  "dotenv": "^16.0.3",
58
59
  "lodash.chunk": "^4.2.0",
@@ -67,7 +68,7 @@
67
68
  "@types/jest": "^30.0.0",
68
69
  "@types/lodash.pickby": "^4",
69
70
  "@types/node": "^22.15.17",
70
- "@typescript/native-preview": "7.0.0-dev.20251126.1",
71
+ "@typescript/native-preview": "7.0.0-dev.20260113.1",
71
72
  "@viem/anvil": "^0.0.10",
72
73
  "get-port": "^7.1.0",
73
74
  "jest": "^30.0.0",
package/src/config.ts CHANGED
@@ -1,15 +1,16 @@
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 { l1ContractsDefaultEnv } from './generated/l1-contracts-defaults.js';
13
14
  import { type L1TxUtilsConfig, l1TxUtilsConfigMappings } from './l1_tx_utils/config.js';
14
15
 
15
16
  export type GenesisStateConfig = {
@@ -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,118 +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
-
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
+ */
104
89
  export const l1ContractsConfigMappings: ConfigMappingsType<L1ContractsConfig> = {
105
90
  ethereumSlotDuration: {
106
91
  env: 'ETHEREUM_SLOT_DURATION',
107
92
  description: 'How many seconds an L1 slot lasts.',
108
- ...numberConfigHelper(DefaultL1ContractsConfig.ethereumSlotDuration),
93
+ ...numberConfigHelper(l1ContractsDefaultEnv.ETHEREUM_SLOT_DURATION),
109
94
  },
110
95
  aztecSlotDuration: {
111
96
  env: 'AZTEC_SLOT_DURATION',
112
97
  description: 'How many seconds an L2 slots lasts (must be multiple of ethereum slot duration).',
113
- ...numberConfigHelper(DefaultL1ContractsConfig.aztecSlotDuration),
98
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLOT_DURATION),
114
99
  },
115
100
  aztecEpochDuration: {
116
101
  env: 'AZTEC_EPOCH_DURATION',
117
102
  description: `How many L2 slots an epoch lasts (maximum AZTEC_MAX_EPOCH_DURATION).`,
118
- ...numberConfigHelper(DefaultL1ContractsConfig.aztecEpochDuration),
103
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_EPOCH_DURATION),
119
104
  },
120
105
  aztecTargetCommitteeSize: {
121
106
  env: 'AZTEC_TARGET_COMMITTEE_SIZE',
122
107
  description: 'The target validator committee size.',
123
- ...numberConfigHelper(DefaultL1ContractsConfig.aztecTargetCommitteeSize),
108
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_TARGET_COMMITTEE_SIZE),
124
109
  },
125
110
  lagInEpochsForValidatorSet: {
126
111
  env: 'AZTEC_LAG_IN_EPOCHS_FOR_VALIDATOR_SET',
127
112
  description: 'The number of epochs to lag behind the current epoch for validator selection.',
128
- ...numberConfigHelper(DefaultL1ContractsConfig.lagInEpochsForValidatorSet),
113
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_LAG_IN_EPOCHS_FOR_VALIDATOR_SET),
129
114
  },
130
115
  lagInEpochsForRandao: {
131
116
  env: 'AZTEC_LAG_IN_EPOCHS_FOR_RANDAO',
132
117
  description: 'The number of epochs to lag behind the current epoch for randao selection.',
133
- ...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),
134
124
  },
135
125
  aztecProofSubmissionEpochs: {
136
126
  env: 'AZTEC_PROOF_SUBMISSION_EPOCHS',
137
127
  description: 'The number of epochs after an epoch ends that proofs are still accepted.',
138
- ...numberConfigHelper(DefaultL1ContractsConfig.aztecProofSubmissionEpochs),
128
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_PROOF_SUBMISSION_EPOCHS),
139
129
  },
140
130
  activationThreshold: {
141
131
  env: 'AZTEC_ACTIVATION_THRESHOLD',
142
132
  description: 'The deposit amount for a validator',
143
- ...bigintConfigHelper(DefaultL1ContractsConfig.activationThreshold),
133
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_ACTIVATION_THRESHOLD)),
144
134
  },
145
135
  ejectionThreshold: {
146
136
  env: 'AZTEC_EJECTION_THRESHOLD',
147
137
  description: 'The minimum stake for a validator.',
148
- ...bigintConfigHelper(DefaultL1ContractsConfig.ejectionThreshold),
138
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_EJECTION_THRESHOLD)),
149
139
  },
150
140
  localEjectionThreshold: {
151
141
  env: 'AZTEC_LOCAL_EJECTION_THRESHOLD',
152
142
  description:
153
143
  'The local ejection threshold for a validator. Stricter than ejectionThreshold but local to a specific rollup',
154
- ...bigintConfigHelper(DefaultL1ContractsConfig.localEjectionThreshold),
144
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_LOCAL_EJECTION_THRESHOLD)),
155
145
  },
156
146
  slashingOffsetInRounds: {
157
147
  env: 'AZTEC_SLASHING_OFFSET_IN_ROUNDS',
158
148
  description:
159
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)',
160
- ...numberConfigHelper(DefaultL1ContractsConfig.slashingOffsetInRounds),
150
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_OFFSET_IN_ROUNDS),
161
151
  },
162
152
  slasherFlavor: {
163
153
  env: 'AZTEC_SLASHER_FLAVOR',
164
154
  description: 'Type of slasher proposer (empire, tally, or none)',
165
- ...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
+ ),
166
159
  },
167
160
  slashAmountSmall: {
168
161
  env: 'AZTEC_SLASH_AMOUNT_SMALL',
169
162
  description: 'Small slashing amount for light offenses',
170
- ...bigintConfigHelper(DefaultL1ContractsConfig.slashAmountSmall),
163
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_SLASH_AMOUNT_SMALL)),
171
164
  },
172
165
  slashAmountMedium: {
173
166
  env: 'AZTEC_SLASH_AMOUNT_MEDIUM',
174
167
  description: 'Medium slashing amount for moderate offenses',
175
- ...bigintConfigHelper(DefaultL1ContractsConfig.slashAmountMedium),
168
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_SLASH_AMOUNT_MEDIUM)),
176
169
  },
177
170
  slashAmountLarge: {
178
171
  env: 'AZTEC_SLASH_AMOUNT_LARGE',
179
172
  description: 'Large slashing amount for severe offenses',
180
- ...bigintConfigHelper(DefaultL1ContractsConfig.slashAmountLarge),
173
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_SLASH_AMOUNT_LARGE)),
181
174
  },
182
175
  slashingQuorum: {
183
176
  env: 'AZTEC_SLASHING_QUORUM',
@@ -187,28 +180,28 @@ export const l1ContractsConfigMappings: ConfigMappingsType<L1ContractsConfig> =
187
180
  slashingRoundSizeInEpochs: {
188
181
  env: 'AZTEC_SLASHING_ROUND_SIZE_IN_EPOCHS',
189
182
  description: 'The slashing round size',
190
- ...numberConfigHelper(DefaultL1ContractsConfig.slashingRoundSizeInEpochs),
183
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_ROUND_SIZE_IN_EPOCHS),
191
184
  },
192
185
  slashingLifetimeInRounds: {
193
186
  env: 'AZTEC_SLASHING_LIFETIME_IN_ROUNDS',
194
187
  description: 'The slashing lifetime in rounds',
195
- ...numberConfigHelper(DefaultL1ContractsConfig.slashingLifetimeInRounds),
188
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_LIFETIME_IN_ROUNDS),
196
189
  },
197
190
  slashingExecutionDelayInRounds: {
198
191
  env: 'AZTEC_SLASHING_EXECUTION_DELAY_IN_ROUNDS',
199
192
  description: 'The slashing execution delay in rounds',
200
- ...numberConfigHelper(DefaultL1ContractsConfig.slashingExecutionDelayInRounds),
193
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_EXECUTION_DELAY_IN_ROUNDS),
201
194
  },
202
195
  slashingVetoer: {
203
196
  env: 'AZTEC_SLASHING_VETOER',
204
197
  description: 'The slashing vetoer',
205
198
  parseEnv: (val: string) => EthAddress.fromString(val),
206
- defaultValue: DefaultL1ContractsConfig.slashingVetoer,
199
+ defaultValue: EthAddress.fromString(l1ContractsDefaultEnv.AZTEC_SLASHING_VETOER),
207
200
  },
208
201
  slashingDisableDuration: {
209
202
  env: 'AZTEC_SLASHING_DISABLE_DURATION',
210
203
  description: 'How long slashing can be disabled for in seconds when vetoer disables it',
211
- ...numberConfigHelper(DefaultL1ContractsConfig.slashingDisableDuration),
204
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_DISABLE_DURATION),
212
205
  },
213
206
  governanceProposerQuorum: {
214
207
  env: 'AZTEC_GOVERNANCE_PROPOSER_QUORUM',
@@ -218,26 +211,42 @@ export const l1ContractsConfigMappings: ConfigMappingsType<L1ContractsConfig> =
218
211
  governanceProposerRoundSize: {
219
212
  env: 'AZTEC_GOVERNANCE_PROPOSER_ROUND_SIZE',
220
213
  description: 'The governance proposing round size',
221
- ...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
222
220
  },
223
221
  manaTarget: {
224
222
  env: 'AZTEC_MANA_TARGET',
225
223
  description: 'The mana target for the rollup',
226
- ...bigintConfigHelper(DefaultL1ContractsConfig.manaTarget),
224
+ ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_MANA_TARGET)),
227
225
  },
228
226
  provingCostPerMana: {
229
227
  env: 'AZTEC_PROVING_COST_PER_MANA',
230
228
  description: 'The proving cost per mana',
231
- ...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)),
232
235
  },
233
236
  exitDelaySeconds: {
234
237
  env: 'AZTEC_EXIT_DELAY_SECONDS',
235
238
  description: 'The delay before a validator can exit the set',
236
- ...numberConfigHelper(DefaultL1ContractsConfig.exitDelaySeconds),
239
+ ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_EXIT_DELAY_SECONDS),
237
240
  },
238
241
  ...l1TxUtilsConfigMappings,
239
242
  };
240
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
+
241
250
  export const genesisStateConfigMappings: ConfigMappingsType<GenesisStateConfig> = {
242
251
  testAccounts: {
243
252
  env: 'TEST_ACCOUNTS',
@@ -0,0 +1,157 @@
1
+ # L1 Contract Wrappers
2
+
3
+ This folder contains TypeScript wrappers for L1 contracts defined in `l1-contracts/`. These wrappers are used by the node client to interact with the rollup and related contracts on Ethereum.
4
+
5
+ ## Purpose
6
+
7
+ The goal of wrapping is to shield consumers from L1-specific and viem-specific details. Clients using these wrappers interact with domain types and branded types native to the Aztec codebase, without needing to understand viem's ABI type system or deal with raw types like `Hex` and `bigint`.
8
+
9
+ ## Type Safety
10
+
11
+ ### Explicit Return Types
12
+
13
+ Every function in the contract wrappers must declare its return type explicitly. This is critical because viem's type inference over ABI types is slow and significantly impacts IDE performance.
14
+
15
+ ```typescript
16
+ // Good: Explicit return type
17
+ async getSlotNumber(): Promise<SlotNumber> {
18
+ return SlotNumber.fromBigInt(await this.rollup.read.getCurrentSlot());
19
+ }
20
+
21
+ // Bad: Inferred return type (slow)
22
+ async getSlotNumber() {
23
+ return SlotNumber.fromBigInt(await this.rollup.read.getCurrentSlot());
24
+ }
25
+ ```
26
+
27
+ ### Branded and Domain Types
28
+
29
+ Use branded types and domain-specific types instead of viem's autogenerated types for both arguments and return values:
30
+
31
+ - `CheckpointNumber`, `EpochNumber`, `SlotNumber` instead of `bigint`
32
+ - `EthAddress` instead of `` `0x${string}` `` or `Hex`
33
+ - `Fr`, `Buffer32` instead of `Hex` for hashes and field elements
34
+ - Custom domain types (e.g., `CheckpointLog`, `AttesterView`) instead of raw tuples
35
+
36
+ Type conversions happen inside wrapper methods, not at the call site:
37
+
38
+ ```typescript
39
+ async getCheckpoint(checkpointNumber: CheckpointNumber): Promise<CheckpointLog> {
40
+ const result = await this.rollup.read.getCheckpoint([BigInt(checkpointNumber)]);
41
+ return {
42
+ archive: Fr.fromString(result.archive),
43
+ headerHash: Buffer32.fromString(result.headerHash),
44
+ blockCount: result.blockCount,
45
+ };
46
+ }
47
+ ```
48
+
49
+ ## Wrapper Pattern
50
+
51
+ ### Basic Structure
52
+
53
+ Each wrapper follows a consistent structure:
54
+
55
+ ```typescript
56
+ export class FooContract {
57
+ private readonly foo: GetContractReturnType<typeof FooAbi, ViemClient>;
58
+
59
+ constructor(
60
+ public readonly client: ViemClient,
61
+ address: Hex | EthAddress,
62
+ ) {
63
+ if (address instanceof EthAddress) {
64
+ address = address.toString();
65
+ }
66
+ this.foo = getContract({ address, abi: FooAbi, client });
67
+ }
68
+
69
+ public get address(): Hex {
70
+ return this.foo.address;
71
+ }
72
+
73
+ public getContract(): GetContractReturnType<typeof FooAbi, ViemClient> {
74
+ return this.foo;
75
+ }
76
+ }
77
+ ```
78
+
79
+ The raw contract is exposed via `getContract()` for cases where direct access is needed, but most consumers should use the typed wrapper methods. Relying on `getContract()` is a code smell and should be avoided.
80
+
81
+ ### Static Factory Methods
82
+
83
+ Wrappers may provide static factory methods for common initialization patterns:
84
+
85
+ - `getFromConfig(config)` - construct from configuration object
86
+ - `getFromL1ContractsValues(deployResult)` - construct from deployment result
87
+
88
+ ### Wallet Assertions
89
+
90
+ For write operations that require a wallet, use an assertion helper:
91
+
92
+ ```typescript
93
+ private assertWallet(): GetContractReturnType<typeof FooAbi, ExtendedViemWalletClient> {
94
+ if (!isExtendedClient(this.client)) {
95
+ throw new Error('Wallet client is required for this operation');
96
+ }
97
+ return this.foo as GetContractReturnType<typeof FooAbi, ExtendedViemWalletClient>;
98
+ }
99
+ ```
100
+
101
+ ## Event Handling
102
+
103
+ ### Event Log Types
104
+
105
+ Event logs are wrapped in `L1EventLog<T>` to include L1 block context:
106
+
107
+ ```typescript
108
+ type L1EventLog<T> = {
109
+ l1BlockNumber: bigint;
110
+ l1BlockHash: Buffer32;
111
+ l1TransactionHash: Hex;
112
+ args: T;
113
+ };
114
+ ```
115
+
116
+ ### Event Fetching
117
+
118
+ Methods that fetch events convert viem's raw logs to domain types:
119
+
120
+ ```typescript
121
+ async getCheckpointProposedEvents(fromBlock: bigint, toBlock: bigint): Promise<CheckpointProposedLog[]> {
122
+ const logs = await this.rollup.getEvents.CheckpointProposed({}, { fromBlock, toBlock });
123
+ return logs.map(log => ({
124
+ l1BlockNumber: log.blockNumber!,
125
+ l1BlockHash: Buffer32.fromString(log.blockHash!),
126
+ l1TransactionHash: log.transactionHash!,
127
+ args: {
128
+ checkpointNumber: CheckpointNumber.fromBigInt(log.args.checkpointNumber!),
129
+ // ... convert other fields
130
+ },
131
+ }));
132
+ }
133
+ ```
134
+
135
+ ### Event Listeners
136
+
137
+ For reactive event handling, wrapper methods convert arguments before invoking callbacks:
138
+
139
+ ```typescript
140
+ public listenToCheckpointInvalidated(
141
+ callback: (args: { checkpointNumber: CheckpointNumber }) => unknown,
142
+ ): WatchContractEventReturnType {
143
+ return this.rollup.watchEvent.CheckpointInvalidated({}, {
144
+ onLogs: logs => {
145
+ for (const log of logs) {
146
+ if (log.args.checkpointNumber !== undefined) {
147
+ callback({ checkpointNumber: CheckpointNumber.fromBigInt(log.args.checkpointNumber) });
148
+ }
149
+ }
150
+ },
151
+ });
152
+ }
153
+ ```
154
+
155
+ ## Error Handling
156
+
157
+ Custom error classes in `errors.ts` extend `Error` and set `this.name` for proper error identification. Include relevant context as public readonly properties.
@@ -4,13 +4,14 @@ import { FeeAssetHandlerAbi } from '@aztec/l1-artifacts/FeeAssetHandlerAbi';
4
4
  import { type Hex, encodeFunctionData, getContract } from 'viem';
5
5
 
6
6
  import type { L1TxUtils } from '../l1_tx_utils/index.js';
7
+ import type { ViemClient } from '../types.js';
7
8
 
8
9
  export class FeeAssetHandlerContract {
9
10
  public address: EthAddress;
10
11
 
11
12
  constructor(
13
+ public readonly client: ViemClient,
12
14
  address: Hex | EthAddress,
13
- public readonly txUtils: L1TxUtils,
14
15
  ) {
15
16
  if (address instanceof EthAddress) {
16
17
  address = address.toString();
@@ -22,7 +23,7 @@ export class FeeAssetHandlerContract {
22
23
  const contract = getContract({
23
24
  abi: FeeAssetHandlerAbi,
24
25
  address: this.address.toString(),
25
- client: this.txUtils.client,
26
+ client: this.client,
26
27
  });
27
28
  return EthAddress.fromString(await contract.read.owner());
28
29
  }
@@ -31,16 +32,16 @@ export class FeeAssetHandlerContract {
31
32
  const contract = getContract({
32
33
  abi: FeeAssetHandlerAbi,
33
34
  address: this.address.toString(),
34
- client: this.txUtils.client,
35
+ client: this.client,
35
36
  });
36
37
  return contract.read.mintAmount();
37
38
  }
38
39
 
39
- public mint(recipient: Hex | EthAddress) {
40
+ public mint(txUtils: L1TxUtils, recipient: Hex | EthAddress) {
40
41
  if (recipient instanceof EthAddress) {
41
42
  recipient = recipient.toString();
42
43
  }
43
- return this.txUtils.sendAndMonitorTransaction({
44
+ return txUtils.sendAndMonitorTransaction({
44
45
  to: this.address.toString(),
45
46
  data: encodeFunctionData({
46
47
  abi: FeeAssetHandlerAbi,
@@ -50,8 +51,8 @@ export class FeeAssetHandlerContract {
50
51
  });
51
52
  }
52
53
 
53
- public setMintAmount(amount: bigint) {
54
- return this.txUtils.sendAndMonitorTransaction({
54
+ public setMintAmount(txUtils: L1TxUtils, amount: bigint) {
55
+ return txUtils.sendAndMonitorTransaction({
55
56
  to: this.address.toString(),
56
57
  data: encodeFunctionData({
57
58
  abi: FeeAssetHandlerAbi,
@@ -174,6 +174,13 @@ export class GovernanceContract extends ReadOnlyGovernanceContract {
174
174
  return this.governanceContract.read.powerAt([this.client.account.address, now.timestamp]);
175
175
  }
176
176
 
177
+ /** Returns the user's voting power for a specific proposal, checked at pendingThrough timestamp. */
178
+ public async getPowerForProposal(proposalId: bigint): Promise<bigint> {
179
+ const proposal = await this.getProposal(proposalId);
180
+ const pendingThrough = proposal.creation + proposal.config.votingDelay;
181
+ return this.governanceContract.read.powerAt([this.client.account.address, pendingThrough]);
182
+ }
183
+
177
184
  public async vote({
178
185
  proposalId,
179
186
  voteAmount,
@@ -190,7 +197,7 @@ export class GovernanceContract extends ReadOnlyGovernanceContract {
190
197
  const l1TxUtils = createL1TxUtilsFromViemWallet(this.client, { logger });
191
198
  const retryDelaySeconds = 12;
192
199
 
193
- voteAmount = voteAmount ?? (await this.getPower());
200
+ voteAmount = voteAmount ?? (await this.getPowerForProposal(proposalId));
194
201
 
195
202
  let success = false;
196
203
  for (let i = 0; i < retries; i++) {