Skip to content

Update bootstrap command docs in op-deployer docs #1368

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Feb 17, 2025
Merged

Update bootstrap command docs in op-deployer docs #1368

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
598a38e
updated bootstrap command docs
krofax Feb 14, 2025
1dc12fb
update the callout
krofax Feb 14, 2025
0b8736c
fix merge conflict
krofax Feb 17, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 16 additions & 8 deletions pages/operators/chain-operators/tools/op-deployer.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -129,19 +129,27 @@ op-deployer inspect l2-semvers --workdir .deployer <l2-chain-id> # outputs the s

## Bootstrap usage

You can also use `op-deployer` to deploy the contracts needed to run the `init`... `apply` flow on new chains. This process, called 'bootstrapping,' is useful when you want to use `op-deployer` with L3s, new testnets, or other custom settlement chains.
The bootstrap commands are specialized tools primarily used for initializing a new superchain on an L1 network that hasn't previously hosted one.

### OPCM bootstrap

To deploy OPCM to a new chain, run the following command:
### Available commands

```bash
op-deployer bootstrap opcm \
--l1-rpc-url <mainnet-rpc-url> \
--private-key <deployer-private-key> \
--artifacts-locator tag://op-contracts/v1.6.0
op-deployer bootstrap superchain
op-deployer bootstrap implementations
op-deployer bootstrap proxy
```

### Use cases

The bootstrap commands are specifically designed for scenarios such as:
* Setting up a superchain on a new EVM-compatible L1.
* Initializing superchain contracts on a new Ethereum testnet (e.g., an alternative to Sepolia).
* Creating the foundational infrastructure for a brand new superchain deployment.

<Callout type="info">
For standard chain deployments, use the [op-deployer `apply`](/operators/chain-operators/tools/op-deployer#apply) command.
</Callout>

## Next steps

* For more details, check out the tool and documentation in the [op-deployer repository](https://github.com/ethereum-optimism/optimism/tree/develop/op-deployer/cmd/op-deployer).
Expand Down