feat: introduce hardhat-deploy-config

.changeset/cyan-months-kneel.md

@@ -0,0 +1,5 @@
+---
+'@eth-optimism/contracts': patch
+---
+
+Use hardhat-deploy-config for deployments

.changeset/giant-cobras-heal.md

@@ -0,0 +1,5 @@
+---
+'@eth-optimism/hardhat-deploy-config': minor
+---
+
+Initial release of hardhat-deploy-config

ops/docker/Dockerfile.packages

@@ -24,6 +24,7 @@ COPY packages/contracts-bedrock/package.json ./packages/contracts-bedrock/packag
 COPY packages/contracts-periphery/package.json ./packages/contracts-periphery/package.json
 COPY packages/contracts-governance/package.json ./packages/contracts-governance/package.json
 COPY packages/data-transport-layer/package.json ./packages/data-transport-layer/package.json
+COPY packages/hardhat-deploy-config/package.json ./packages/hardhat-deploy-config/package.json
 COPY packages/message-relayer/package.json ./packages/message-relayer/package.json
 COPY packages/fault-detector/package.json ./packages/fault-detector/package.json
 COPY packages/replica-healthcheck/package.json ./packages/replica-healthcheck/package.json

packages/contracts-bedrock/README.md

@@ -43,3 +43,16 @@ To run only solidity tests:
 ```shell
 yarn test:forge
 ```
+
+## Deployment
+
+Create a file that corresponds to the network name in the `deploy-config`
+directory and then run the command:
+
+```shell
+npx hardhat deploy --network <network-name>
+```
+
+In the `hardhat.config.ts`, there is a `deployConfigSpec` field that validates that the types
+are correct, be sure to export an object in the `deploy-config/<network-name>.ts` file that
+has a key for each property in the `deployConfigSpec`.

packages/contracts-bedrock/deploy-config/devnetL1.ts

@@ -0,0 +1,13 @@
+import { ethers } from 'ethers'
+
+const config = {
+  submissionInterval: 6,
+  l2BlockTime: 2,
+  genesisOutput: ethers.constants.HashZero,
+  historicalBlocks: 0,
+  startingBlockTimestamp:
+    parseInt(process.env.L2OO_STARTING_BLOCK_TIMESTAMP, 10) || Date.now(),
+  sequencerAddress: '0x70997970C51812dc3A010C7d01b50e0d17dc79C8',
+}
+
+export default config

packages/contracts-bedrock/deploy-config/hardhat.ts

@@ -0,0 +1,13 @@
+import { ethers } from 'ethers'
+
+const config = {
+  submissionInterval: 6,
+  l2BlockTime: 2,
+  genesisOutput: ethers.constants.HashZero,
+  historicalBlocks: 0,
+  startingBlockTimestamp:
+    parseInt(process.env.L2OO_STARTING_BLOCK_TIMESTAMP, 10) || Date.now(),
+  sequencerAddress: '0x70997970C51812dc3A010C7d01b50e0d17dc79C8',
+}
+
+export default config

packages/contracts-bedrock/deploy/000-L2OutputOracle.deploy.ts

@@ -7,23 +7,23 @@ const deployFn: DeployFunction = async (hre) => {
   const { deployer } = await hre.getNamedAccounts()
 
   if (
-    !process.env.L2OO_STARTING_BLOCK_TIMESTAMP ||
-    isNaN(Number(process.env.L2OO_STARTING_BLOCK_TIMESTAMP))
+    typeof hre.deployConfig.startingBlockTimestamp !== 'number' ||
+    isNaN(hre.deployConfig.startingBlockTimestamp)
   ) {
     throw new Error(
-      'Cannot deploy L2OutputOracle without specifying a valid L2OO_STARTING_BLOCK_TIMESTAMP.'
+      'Cannot deploy L2OutputOracle without specifying a valid startingBlockTimestamp.'
     )
   }
 
   await deploy('L2OutputOracle', {
     from: deployer,
     args: [
-      6, // submission interval
-      2, // l2 block time
-      `0x${'00'.repeat(32)}`, // genesis output
-      0, // historical blocks
-      process.env.L2OO_STARTING_BLOCK_TIMESTAMP,
-      '0x70997970C51812dc3A010C7d01b50e0d17dc79C8', // sequencer
+      hre.deployConfig.submissionInterval,
+      hre.deployConfig.l2BlockTime,
+      hre.deployConfig.genesisOutput,
+      hre.deployConfig.historicalBlocks,
+      hre.deployConfig.startingBlockTimestamp,
+      hre.deployConfig.sequencerAddress,
     ],
     log: true,
     waitConfirmations: 1,

packages/contracts-bedrock/hardhat.config.ts

@@ -1,10 +1,12 @@
+import { ethers } from 'ethers'
 import { HardhatUserConfig, task, subtask } from 'hardhat/config'
 import { TASK_COMPILE_SOLIDITY_GET_SOURCE_PATHS } from 'hardhat/builtin-tasks/task-names'
 import '@nomiclabs/hardhat-waffle'
 import '@typechain/hardhat'
 import 'solidity-coverage'
 import 'hardhat-deploy'
 import '@foundry-rs/hardhat-forge'
+import '@eth-optimism/hardhat-deploy-config'
 
 import './tasks/deposits'
 
@@ -33,6 +35,11 @@ const config: HardhatUserConfig = {
       ],
     },
   },
+  paths: {
+    deploy: './deploy',
+    deployments: './deployments',
+    deployConfig: './deploy-config',
+  },
   typechain: {
     outDir: 'dist/types',
     target: 'ethers-v5',
@@ -42,6 +49,27 @@ const config: HardhatUserConfig = {
       default: 0,
     },
   },
+  deployConfigSpec: {
+    submissionInterval: {
+      type: 'number',
+    },
+    l2BlockTime: {
+      type: 'number',
+    },
+    genesisOutput: {
+      type: 'string',
+      default: ethers.constants.HashZero,
+    },
+    historicalBlocks: {
+      type: 'number',
+    },
+    startingBlockTimestamp: {
+      type: 'number',
+    },
+    sequencerAddress: {
+      type: 'address',
+    },
+  },
   solidity: {
     compilers: [
       {

packages/contracts-bedrock/package.json

@@ -42,6 +42,7 @@
   },
   "devDependencies": {
     "@foundry-rs/hardhat-forge": "^0.1.5",
+    "@eth-optimism/hardhat-deploy-config": "^0.1.0",
     "@nomiclabs/hardhat-ethers": "^2.0.0",
     "@nomiclabs/hardhat-etherscan": "^2.1.3",
     "@nomiclabs/hardhat-waffle": "^2.0.0",

packages/contracts/deploy-config/goerli-nightly.ts

@@ -1,6 +1,4 @@
-import { DeployConfig } from '../src/deploy-config'
-
-const config: DeployConfig = {
+const config = {
   l1BlockTimeSeconds: 15,
   l2BlockGasLimit: 15_000_000,
   l2ChainId: 421,

packages/contracts/deploy-config/goerli.ts

@@ -1,6 +1,4 @@
-import { DeployConfig } from '../src/deploy-config'
-
-const config: DeployConfig = {
+const config = {
   numDeployConfirmations: 1,
   l1BlockTimeSeconds: 15,
   l2BlockGasLimit: 15_000_000,

packages/contracts/deploy-config/hardhat.ts

@@ -0,0 +1,17 @@
+const config = {
+  l1BlockTimeSeconds: 15,
+  l2BlockGasLimit: 15_000_000,
+  l2ChainId: 17,
+  ctcL2GasDiscountDivisor: 32,
+  ctcEnqueueGasCost: 60_000,
+  sccFaultProofWindowSeconds: 0,
+  sccSequencerPublishWindowSeconds: 12592000,
+  ovmSequencerAddress: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+  ovmProposerAddress: '0x3c44cdddb6a900fa2b585dd299e03d12fa4293bc',
+  ovmBlockSignerAddress: '0x00000398232E2064F896018496b4b44b3D62751F',
+  ovmFeeWalletAddress: '0x391716d440c151c42cdf1c95c1d83a5427bca52c',
+  ovmAddressManagerOwner: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
+  ovmGasPriceOracleOwner: '0x9965507d1a55bcc2695c58ba16fb37d819b0a4dc',
+}
+
+export default config

packages/contracts/deploy-config/kovan.ts

@@ -1,6 +1,4 @@
-import { DeployConfig } from '../src/deploy-config'
-
-const config: DeployConfig = {
+const config = {
   numDeployConfirmations: 1,
   gasPrice: 5_000_000_000,
   l1BlockTimeSeconds: 15,

packages/contracts/deploy-config/local.ts

@@ -1,6 +1,4 @@
-import { DeployConfig } from '../src/deploy-config'
-
-const config: DeployConfig = {
+const config = {
   l1BlockTimeSeconds: 15,
   l2BlockGasLimit: 15_000_000,
   l2ChainId: 17,

packages/contracts/deploy-config/mainnet.ts

@@ -1,6 +1,4 @@
-import { DeployConfig } from '../src/deploy-config'
-
-const config: DeployConfig = {
+const config = {
   numDeployConfirmations: 4,
   gasPrice: 150_000_000_000,
   l1BlockTimeSeconds: 15,

packages/contracts/deploy/000-hardhat-setup.ts

@@ -9,12 +9,10 @@ import {
   sendImpersonatedTx,
   BIG_BALANCE,
 } from '../src/deploy-utils'
-import { getDeployConfig } from '../src/deploy-config'
 import { names } from '../src/address-names'
 
 const deployFn: DeployFunction = async (hre) => {
-  const deployConfig = getDeployConfig(hre.network.name)
-  if (!deployConfig.isForkedNetwork) {
+  if (!hre.deployConfig.isForkedNetwork) {
     return
   }
 

packages/contracts/deploy/001-Lib_AddressManager.deploy.ts

@@ -2,20 +2,18 @@
 import { DeployFunction } from 'hardhat-deploy/dist/types'
 
 import { names } from '../src/address-names'
-import { getDeployConfig } from '../src/deploy-config'
 
 /* Imports: External */
 
 const deployFn: DeployFunction = async (hre) => {
   const { deploy } = hre.deployments
   const { deployer } = await hre.getNamedAccounts()
-  const deployConfig = getDeployConfig(hre.network.name)
 
   await deploy(names.unmanaged.Lib_AddressManager, {
     from: deployer,
     args: [],
     log: true,
-    waitConfirmations: deployConfig.numDeployConfirmations,
+    waitConfirmations: hre.deployConfig.numDeployConfirmations,
   })
 }
 

packages/contracts/deploy/004-OVM_CanonicalTransactionChain.deploy.ts

@@ -6,12 +6,9 @@ import {
   deployAndVerifyAndThen,
   getContractFromArtifact,
 } from '../src/deploy-utils'
-import { getDeployConfig } from '../src/deploy-config'
 import { names } from '../src/address-names'
 
 const deployFn: DeployFunction = async (hre) => {
-  const deployConfig = getDeployConfig(hre.network.name)
-
   const Lib_AddressManager = await getContractFromArtifact(
     hre,
     names.unmanaged.Lib_AddressManager
@@ -22,9 +19,9 @@ const deployFn: DeployFunction = async (hre) => {
     name: names.managed.contracts.CanonicalTransactionChain,
     args: [
       Lib_AddressManager.address,
-      deployConfig.l2BlockGasLimit,
-      deployConfig.ctcL2GasDiscountDivisor,
-      deployConfig.ctcEnqueueGasCost,
+      hre.deployConfig.l2BlockGasLimit,
+      hre.deployConfig.ctcL2GasDiscountDivisor,
+      hre.deployConfig.ctcEnqueueGasCost,
     ],
   })
 }

packages/contracts/deploy/005-OVM_StateCommitmentChain.deploy.ts

@@ -6,12 +6,9 @@ import {
   deployAndVerifyAndThen,
   getContractFromArtifact,
 } from '../src/deploy-utils'
-import { getDeployConfig } from '../src/deploy-config'
 import { names } from '../src/address-names'
 
 const deployFn: DeployFunction = async (hre) => {
-  const deployConfig = getDeployConfig(hre.network.name)
-
   const Lib_AddressManager = await getContractFromArtifact(
     hre,
     names.unmanaged.Lib_AddressManager
@@ -22,8 +19,8 @@ const deployFn: DeployFunction = async (hre) => {
     name: names.managed.contracts.StateCommitmentChain,
     args: [
       Lib_AddressManager.address,
-      deployConfig.sccFaultProofWindowSeconds,
-      deployConfig.sccSequencerPublishWindowSeconds,
+      hre.deployConfig.sccFaultProofWindowSeconds,
+      hre.deployConfig.sccSequencerPublishWindowSeconds,
     ],
   })
 }

packages/contracts/deploy/007-OVM_L1CrossDomainMessenger.deploy.ts

@@ -7,12 +7,9 @@ import {
   deployAndVerifyAndThen,
   getContractFromArtifact,
 } from '../src/deploy-utils'
-import { getDeployConfig } from '../src/deploy-config'
 import { names } from '../src/address-names'
 
 const deployFn: DeployFunction = async (hre) => {
-  const deployConfig = getDeployConfig(hre.network.name)
-
   const Lib_AddressManager = await getContractFromArtifact(
     hre,
     names.unmanaged.Lib_AddressManager
@@ -48,7 +45,7 @@ const deployFn: DeployFunction = async (hre) => {
       console.log(
         `Transferring ownership of L1CrossDomainMessenger (implementation)...`
       )
-      const owner = deployConfig.ovmAddressManagerOwner
+      const owner = hre.deployConfig.ovmAddressManagerOwner
       await contract.transferOwnership(owner)
 
       console.log(`Checking that contract owner was correctly set...`)

packages/contracts/deploy/010-AddressDictator.deploy.ts

@@ -7,13 +7,10 @@ import {
   deployAndVerifyAndThen,
   getContractFromArtifact,
 } from '../src/deploy-utils'
-import { getDeployConfig } from '../src/deploy-config'
 import { names } from '../src/address-names'
 import { predeploys } from '../src/predeploys'
 
 const deployFn: DeployFunction = async (hre) => {
-  const deployConfig = getDeployConfig(hre.network.name)
-
   const Lib_AddressManager = await getContractFromArtifact(
     hre,
     names.unmanaged.Lib_AddressManager
@@ -45,13 +42,13 @@ const deployFn: DeployFunction = async (hre) => {
     // CanonicalTransactionChain.
     {
       name: names.managed.accounts.OVM_Sequencer,
-      address: deployConfig.ovmSequencerAddress,
+      address: hre.deployConfig.ovmSequencerAddress,
     },
     // OVM_Proposer is the address allowed to submit state roots (transaction results) to the
     // StateCommitmentChain.
     {
       name: names.managed.accounts.OVM_Proposer,
-      address: deployConfig.ovmProposerAddress,
+      address: hre.deployConfig.ovmProposerAddress,
     },
   ]
 
@@ -72,7 +69,7 @@ const deployFn: DeployFunction = async (hre) => {
     name: names.unmanaged.AddressDictator,
     args: [
       Lib_AddressManager.address,
-      deployConfig.ovmAddressManagerOwner,
+      hre.deployConfig.ovmAddressManagerOwner,
       namesAndAddresses.map((pair) => {
         return pair.name
       }),

packages/contracts/deploy/012-initialize-Proxy__L1CrossDomainMessenger.ts

@@ -4,11 +4,9 @@ import { hexStringEquals, awaitCondition } from '@eth-optimism/core-utils'
 
 /* Imports: Internal */
 import { getContractFromArtifact } from '../src/deploy-utils'
-import { getDeployConfig } from '../src/deploy-config'
 import { names } from '../src/address-names'
 
 const deployFn: DeployFunction = async (hre) => {
-  const deployConfig = getDeployConfig(hre.network.name)
   const { deployer } = await hre.getNamedAccounts()
 
   // There's a risk that we could get front-run during a fresh deployment, which would brick this
@@ -45,7 +43,7 @@ const deployFn: DeployFunction = async (hre) => {
   )
 
   console.log(`Setting Proxy__OVM_L1CrossDomainMessenger owner...`)
-  const owner = deployConfig.ovmAddressManagerOwner
+  const owner = hre.deployConfig.ovmAddressManagerOwner
   await Proxy__OVM_L1CrossDomainMessenger.transferOwnership(owner)
 
   console.log(`Checking that the contract owner was correctly set...`)