chore: Improve flow for custom artifacts (#1115)

* chore: Allow op-deployer version overrides for just create-config

* chore: A bit of docs

* fix: Link versions.json file

Author: janjakubnanista

docs/ops.md

@@ -46,6 +46,13 @@ just create-config <shortname> <path to your state file>
 
 Where  `shortname` is your chain's name (e.g. `op`) and the path to the state file points to the `state.json` file generated by `op-deployer`.
 
+> If using custom contracts, `op-deployer` version needs to be specified as the third CLI argument to the `just` command above:
+> ```
+> just create-config <shortname> <path to your state file> <op deployer version>
+> ```
+>
+> Supported values for the `op-deployer` versions can be found in the <a href="/ops/internal/deployer/versions.json">`versions.json`</a> file.
+
 This will put two files in the `.staging` directory - `<shortname>.toml` and `<shortname>.json.zst`
 
 ### 4. Update generated config

justfile

@@ -50,8 +50,8 @@ check-genesis-integrity: (_run_ops_bin 'check_genesis_integrity')
 codegen L1_RPC_URLS SUPERCHAINS="":
   @just _run_ops_bin "codegen" "--l1-rpc-urls {{L1_RPC_URLS}} --superchains={{SUPERCHAINS}}"
 
-create-config SHORTNAME FILENAME: build-deployer-binaries
-	@just _run_ops_bin "create_config" "--shortname {{SHORTNAME}} --state-filename $(realpath {{FILENAME}})"
+create-config SHORTNAME FILENAME OPDEPLOYERVERSION="": build-deployer-binaries
+	@just _run_ops_bin "create_config" "--shortname {{SHORTNAME}} --state-filename $(realpath {{FILENAME}}) --op-deployer-version={{OPDEPLOYERVERSION}}"
 
 import-devnet STATEFILE MANIFESTFILE OPDEPLOYERVERSION="":  build-deployer-binaries
 	@just _run_ops_bin "import_devnet" "--state-filename $(realpath {{STATEFILE}}) --manifest-path $(realpath {{MANIFESTFILE}}) --op-deployer-version={{OPDEPLOYERVERSION}}"

ops/cmd/create_config/main.go

@@ -30,6 +30,12 @@ var (
 		EnvVars: []string{"DEPLOYER_CACHE_DIR"},
 		Value:   defaultBinDir(),
 	}
+	OpDeployerVersion = &cli.StringFlag{
+		Name:    "op-deployer-version",
+		Usage:   "Version of the op-deployer binary to use.",
+		EnvVars: []string{"DEPLOYER_VERSION"},
+		Value:   "",
+	}
 )
 
 func main() {
@@ -40,6 +46,7 @@ func main() {
 			StateFilename,
 			Shortname,
 			OpDeployerBinDir,
+			OpDeployerVersion,
 		},
 		Action: action,
 	}
@@ -57,11 +64,12 @@ func action(cliCtx *cli.Context) error {
 
 	statePath := cliCtx.String(StateFilename.Name)
 	opDeployerBinDir := cliCtx.String(OpDeployerBinDir.Name)
+	opDeployerVersion := cliCtx.String(OpDeployerVersion.Name)
 
 	output.WriteWarn("⚠️  Config generation behavior has changed: now generates only essential addresses by default.")
 	output.WriteWarn("📄 All addresses are still available in addresses.json")
 
-	err = manage.GenerateChainArtifacts(statePath, wd, cliCtx.String(Shortname.Name), nil, nil, 0, "", opDeployerBinDir)
+	err = manage.GenerateChainArtifacts(statePath, wd, cliCtx.String(Shortname.Name), nil, nil, 0, opDeployerVersion, opDeployerBinDir)
 	if err != nil {
 		return fmt.Errorf("failed to generate chain config: %w", err)
 	}